xref: /linux/Documentation/devicetree/bindings/arm/arm,trace-buffer-extension.yaml (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
14fb13790SSuzuki K Poulose# SPDX-License-Identifier: GPL-2.0-only or BSD-2-Clause
24fb13790SSuzuki K Poulose# Copyright 2021, Arm Ltd
34fb13790SSuzuki K Poulose%YAML 1.2
44fb13790SSuzuki K Poulose---
5*92c2b1c1SRob Herring$id: "http://devicetree.org/schemas/arm/arm,trace-buffer-extension.yaml#"
64fb13790SSuzuki K Poulose$schema: "http://devicetree.org/meta-schemas/core.yaml#"
74fb13790SSuzuki K Poulose
84fb13790SSuzuki K Poulosetitle: ARM Trace Buffer Extensions
94fb13790SSuzuki K Poulose
104fb13790SSuzuki K Poulosemaintainers:
114fb13790SSuzuki K Poulose  - Anshuman Khandual <anshuman.khandual@arm.com>
124fb13790SSuzuki K Poulose
134fb13790SSuzuki K Poulosedescription: |
144fb13790SSuzuki K Poulose  Arm Trace Buffer Extension (TRBE) is a per CPU component
154fb13790SSuzuki K Poulose  for storing trace generated on the CPU to memory. It is
164fb13790SSuzuki K Poulose  accessed via CPU system registers. The software can verify
174fb13790SSuzuki K Poulose  if it is permitted to use the component by checking the
184fb13790SSuzuki K Poulose  TRBIDR register.
194fb13790SSuzuki K Poulose
204fb13790SSuzuki K Pouloseproperties:
214fb13790SSuzuki K Poulose  $nodename:
224fb13790SSuzuki K Poulose    const: "trbe"
234fb13790SSuzuki K Poulose  compatible:
244fb13790SSuzuki K Poulose    items:
254fb13790SSuzuki K Poulose      - const: arm,trace-buffer-extension
264fb13790SSuzuki K Poulose
274fb13790SSuzuki K Poulose  interrupts:
284fb13790SSuzuki K Poulose    description: |
294fb13790SSuzuki K Poulose       Exactly 1 PPI must be listed. For heterogeneous systems where
304fb13790SSuzuki K Poulose       TRBE is only supported on a subset of the CPUs, please consult
314fb13790SSuzuki K Poulose       the arm,gic-v3 binding for details on describing a PPI partition.
324fb13790SSuzuki K Poulose    maxItems: 1
334fb13790SSuzuki K Poulose
344fb13790SSuzuki K Pouloserequired:
354fb13790SSuzuki K Poulose  - compatible
364fb13790SSuzuki K Poulose  - interrupts
374fb13790SSuzuki K Poulose
384fb13790SSuzuki K PouloseadditionalProperties: false
394fb13790SSuzuki K Poulose
404fb13790SSuzuki K Pouloseexamples:
414fb13790SSuzuki K Poulose
424fb13790SSuzuki K Poulose  - |
434fb13790SSuzuki K Poulose   #include <dt-bindings/interrupt-controller/arm-gic.h>
444fb13790SSuzuki K Poulose
454fb13790SSuzuki K Poulose   trbe {
464fb13790SSuzuki K Poulose     compatible = "arm,trace-buffer-extension";
474fb13790SSuzuki K Poulose     interrupts = <GIC_PPI 15 IRQ_TYPE_LEVEL_HIGH>;
484fb13790SSuzuki K Poulose   };
494fb13790SSuzuki K Poulose...
50