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-replicator.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Arm CoreSight Static Trace Bus Replicator
8
9maintainers:
10  - Mathieu Poirier <[email protected]>
11  - Mike Leach <[email protected]>
12  - Leo Yan <[email protected]>
13  - Suzuki K Poulose <[email protected]>
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 replicator splits a single trace stream into two trace streams
24  for systems that have more than one trace sink component.
25
26properties:
27  compatible:
28    const: arm,coresight-static-replicator
29
30  power-domains:
31    maxItems: 1
32
33  in-ports:
34    $ref: /schemas/graph.yaml#/properties/ports
35    additionalProperties: false
36
37    properties:
38      port:
39        description: Input connection from CoreSight Trace bus
40        $ref: /schemas/graph.yaml#/properties/port
41
42  out-ports:
43    $ref: /schemas/graph.yaml#/properties/ports
44
45    patternProperties:
46      '^port@[01]$':
47        description: Output connections to CoreSight Trace bus
48        $ref: /schemas/graph.yaml#/$defs/port-base
49        unevaluatedProperties: false
50
51        properties:
52          endpoint:
53            $ref: /schemas/graph.yaml#/$defs/endpoint-base
54            unevaluatedProperties: false
55
56            properties:
57              filter-source:
58                $ref: /schemas/types.yaml#/definitions/phandle
59                description:
60                  phandle to the coresight trace source device matching the
61                  hard coded filtering for this port
62
63              remote-endpoint: true
64
65required:
66  - compatible
67  - in-ports
68  - out-ports
69
70additionalProperties: false
71
72examples:
73  - |
74    replicator {
75        /*
76         * non-configurable replicators don't show up on the
77         * AMBA bus.  As such no need to add "arm,primecell".
78         */
79        compatible = "arm,coresight-static-replicator";
80
81        out-ports {
82            #address-cells = <1>;
83            #size-cells = <0>;
84
85            /* replicator output ports */
86            port@0 {
87                reg = <0>;
88                replicator_out_port0: endpoint {
89                    remote-endpoint = <&etb_in_port>;
90                    filter-source = <&tpdm_video>;
91                };
92            };
93
94            port@1 {
95                reg = <1>;
96                replicator_out_port1: endpoint {
97                    remote-endpoint = <&tpiu_in_port>;
98                    filter-source = <&tpdm_mdss>;
99                };
100            };
101        };
102
103        in-ports {
104            port {
105                replicator_in_port0: endpoint {
106                    remote-endpoint = <&funnel_out_port0>;
107                };
108            };
109        };
110    };
111...
112