xref: /freebsd/sys/contrib/device-tree/Bindings/arm/arm,coresight-static-funnel.yaml (revision 7ef62cebc2f965b0f640263e179276928885e33d)
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  in-ports:
34    $ref: /schemas/graph.yaml#/properties/ports
35
36    patternProperties:
37      '^port@[0-7]$':
38        description: Input connections from CoreSight Trace bus
39        $ref: /schemas/graph.yaml#/properties/port
40
41  out-ports:
42    $ref: /schemas/graph.yaml#/properties/ports
43    additionalProperties: false
44
45    properties:
46      port:
47        description: Output connection to CoreSight Trace bus
48        $ref: /schemas/graph.yaml#/properties/port
49
50required:
51  - compatible
52  - in-ports
53  - out-ports
54
55additionalProperties: false
56
57examples:
58  - |
59    funnel {
60        /*
61         * non-configurable replicators don't show up on the
62         * AMBA bus.  As such no need to add "arm,primecell".
63         */
64        compatible = "arm,coresight-static-funnel";
65
66        out-ports {
67            port {
68                combo_funnel_out: endpoint {
69                    remote-endpoint = <&top_funnel_in>;
70                };
71            };
72        };
73
74        in-ports {
75            #address-cells = <1>;
76            #size-cells = <0>;
77
78            port@0 {
79                reg = <0>;
80                combo_funnel_in0: endpoint {
81                    remote-endpoint = <&cluster0_etf_out>;
82                };
83            };
84
85            port@1 {
86                reg = <1>;
87                combo_funnel_in1: endpoint {
88                    remote-endpoint = <&cluster1_etf_out>;
89                };
90            };
91        };
92    };
93...
94