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