xref: /linux/Documentation/devicetree/bindings/arm/arm,embedded-trace-extension.yaml (revision 58f6259b7a08f8d47d4629609703d358b042f0fd) 
1# SPDX-License-Identifier: GPL-2.0-only or BSD-2-Clause
2# Copyright 2021, Arm Ltd
3%YAML 1.2
4---
5$id: "http://devicetree.org/schemas/arm/arm,embedded-trace-extension.yaml#"
6$schema: "http://devicetree.org/meta-schemas/core.yaml#"
7
8title: ARM Embedded Trace Extensions
9
10maintainers:
11  - Suzuki K Poulose <suzuki.poulose@arm.com>
12  - Mathieu Poirier <mathieu.poirier@linaro.org>
13
14description: |
15  Arm Embedded Trace Extension(ETE) is a per CPU trace component that
16  allows tracing the CPU execution. It overlaps with the CoreSight ETMv4
17  architecture and has extended support for future architecture changes.
18  The trace generated by the ETE could be stored via legacy CoreSight
19  components (e.g, TMC-ETR) or other means (e.g, using a per CPU buffer
20  Arm Trace Buffer Extension (TRBE)). Since the ETE can be connected to
21  legacy CoreSight components, a node must be listed per instance, along
22  with any optional connection graph as per the coresight bindings.
23
24properties:
25  $nodename:
26    pattern: "^ete([0-9a-f]+)$"
27  compatible:
28    items:
29      - const: arm,embedded-trace-extension
30
31  cpu:
32    description: |
33      Handle to the cpu this ETE is bound to.
34    $ref: /schemas/types.yaml#/definitions/phandle
35
36  power-domains:
37    maxItems: 1
38
39  out-ports:
40    description: |
41      Output connections from the ETE to legacy CoreSight trace bus.
42    $ref: /schemas/graph.yaml#/properties/ports
43    properties:
44      port:
45        description: Output connection from the ETE to legacy CoreSight Trace bus.
46        $ref: /schemas/graph.yaml#/properties/port
47
48required:
49  - compatible
50  - cpu
51
52additionalProperties: false
53
54examples:
55
56# An ETE node without legacy CoreSight connections
57  - |
58    ete0 {
59      compatible = "arm,embedded-trace-extension";
60      cpu = <&cpu_0>;
61    };
62# An ETE node with legacy CoreSight connections
63  - |
64   ete1 {
65      compatible = "arm,embedded-trace-extension";
66      cpu = <&cpu_1>;
67
68      out-ports {        /* legacy coresight connection */
69         port {
70             ete1_out_port: endpoint {
71                remote-endpoint = <&funnel_in_port0>;
72             };
73         };
74      };
75   };
76
77...
78