xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/arm/trbe.yaml (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun# SPDX-License-Identifier: GPL-2.0-only or BSD-2-Clause
2*4882a593Smuzhiyun# Copyright 2021, Arm Ltd
3*4882a593Smuzhiyun%YAML 1.2
4*4882a593Smuzhiyun---
5*4882a593Smuzhiyun$id: "http://devicetree.org/schemas/arm/trbe.yaml#"
6*4882a593Smuzhiyun$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7*4882a593Smuzhiyun
8*4882a593Smuzhiyuntitle: ARM Trace Buffer Extensions
9*4882a593Smuzhiyun
10*4882a593Smuzhiyunmaintainers:
11*4882a593Smuzhiyun  - Anshuman Khandual <anshuman.khandual@arm.com>
12*4882a593Smuzhiyun
13*4882a593Smuzhiyundescription: |
14*4882a593Smuzhiyun  Arm Trace Buffer Extension (TRBE) is a per CPU component
15*4882a593Smuzhiyun  for storing trace generated on the CPU to memory. It is
16*4882a593Smuzhiyun  accessed via CPU system registers. The software can verify
17*4882a593Smuzhiyun  if it is permitted to use the component by checking the
18*4882a593Smuzhiyun  TRBIDR register.
19*4882a593Smuzhiyun
20*4882a593Smuzhiyunproperties:
21*4882a593Smuzhiyun  $nodename:
22*4882a593Smuzhiyun    const: "trbe"
23*4882a593Smuzhiyun  compatible:
24*4882a593Smuzhiyun    items:
25*4882a593Smuzhiyun      - const: arm,trace-buffer-extension
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun  interrupts:
28*4882a593Smuzhiyun    description: |
29*4882a593Smuzhiyun       Exactly 1 PPI must be listed. For heterogeneous systems where
30*4882a593Smuzhiyun       TRBE is only supported on a subset of the CPUs, please consult
31*4882a593Smuzhiyun       the arm,gic-v3 binding for details on describing a PPI partition.
32*4882a593Smuzhiyun    maxItems: 1
33*4882a593Smuzhiyun
34*4882a593Smuzhiyunrequired:
35*4882a593Smuzhiyun  - compatible
36*4882a593Smuzhiyun  - interrupts
37*4882a593Smuzhiyun
38*4882a593SmuzhiyunadditionalProperties: false
39*4882a593Smuzhiyun
40*4882a593Smuzhiyunexamples:
41*4882a593Smuzhiyun
42*4882a593Smuzhiyun  - |
43*4882a593Smuzhiyun   #include <dt-bindings/interrupt-controller/arm-gic.h>
44*4882a593Smuzhiyun
45*4882a593Smuzhiyun   trbe {
46*4882a593Smuzhiyun     compatible = "arm,trace-buffer-extension";
47*4882a593Smuzhiyun     interrupts = <GIC_PPI 15 IRQ_TYPE_LEVEL_HIGH>;
48*4882a593Smuzhiyun   };
49*4882a593Smuzhiyun...
50