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