xref: /linux/Documentation/devicetree/bindings/arm/arm,coresight-static-funnel.yaml (revision d8d2b1f81530988abe2e2bfaceec1c5d30b9a0b4) 
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/arm/arm,coresight-static-funnel.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Arm CoreSight Static Trace Bus Funnel
8
9maintainers:
10  - Mathieu Poirier <mathieu.poirier@linaro.org>
11  - Mike Leach <mike.leach@linaro.org>
12  - Leo Yan <leo.yan@linaro.org>
13  - Suzuki K Poulose <suzuki.poulose@arm.com>
14
15description: |
16  CoreSight components are compliant with the ARM CoreSight architecture
17  specification and can be connected in various topologies to suit a particular
18  SoCs tracing needs. These trace components can generally be classified as
19  sinks, links and sources. Trace data produced by one or more sources flows
20  through the intermediate links connecting the source to the currently selected
21  sink.
22
23  The Coresight static funnel merges 2-8 trace sources into a single trace
24  stream.
25
26properties:
27  compatible:
28    const: arm,coresight-static-funnel
29
30  power-domains:
31    maxItems: 1
32
33  label:
34    description:
35      Description of a coresight device.
36
37  in-ports:
38    $ref: /schemas/graph.yaml#/properties/ports
39
40    patternProperties:
41      '^port@[0-7]$':
42        description: Input connections from CoreSight Trace bus
43        $ref: /schemas/graph.yaml#/properties/port
44
45  out-ports:
46    $ref: /schemas/graph.yaml#/properties/ports
47    additionalProperties: false
48
49    properties:
50      port:
51        description: Output connection to CoreSight Trace bus
52        $ref: /schemas/graph.yaml#/properties/port
53
54required:
55  - compatible
56  - in-ports
57  - out-ports
58
59additionalProperties: false
60
61examples:
62  - |
63    funnel {
64        /*
65         * non-configurable replicators don't show up on the
66         * AMBA bus.  As such no need to add "arm,primecell".
67         */
68        compatible = "arm,coresight-static-funnel";
69
70        out-ports {
71            port {
72                combo_funnel_out: endpoint {
73                    remote-endpoint = <&top_funnel_in>;
74                };
75            };
76        };
77
78        in-ports {
79            #address-cells = <1>;
80            #size-cells = <0>;
81
82            port@0 {
83                reg = <0>;
84                combo_funnel_in0: endpoint {
85                    remote-endpoint = <&cluster0_etf_out>;
86                };
87            };
88
89            port@1 {
90                reg = <1>;
91                combo_funnel_in1: endpoint {
92                    remote-endpoint = <&cluster1_etf_out>;
93                };
94            };
95        };
96    };
97...
98