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-dynamic-funnel.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Arm CoreSight Programmable 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 funnel merges 2-8 trace sources into a single trace
24  stream with programmable enable and priority of input ports.
25
26# Need a custom select here or 'arm,primecell' will match on lots of nodes
27select:
28  properties:
29    compatible:
30      contains:
31        const: arm,coresight-dynamic-funnel
32  required:
33    - compatible
34
35allOf:
36  - $ref: /schemas/arm/primecell.yaml#
37
38properties:
39  compatible:
40    items:
41      - const: arm,coresight-dynamic-funnel
42      - const: arm,primecell
43
44  reg:
45    maxItems: 1
46
47  clocks:
48    minItems: 1
49    maxItems: 2
50
51  clock-names:
52    minItems: 1
53    items:
54      - const: apb_pclk
55      - const: atclk
56
57  in-ports:
58    $ref: /schemas/graph.yaml#/properties/ports
59
60    patternProperties:
61      '^port(@[0-7])?$':
62        description: Input connections from CoreSight Trace bus
63        $ref: /schemas/graph.yaml#/properties/port
64
65  out-ports:
66    $ref: /schemas/graph.yaml#/properties/ports
67    additionalProperties: false
68
69    properties:
70      port:
71        description: Output connection to CoreSight Trace bus
72        $ref: /schemas/graph.yaml#/properties/port
73
74required:
75  - compatible
76  - reg
77  - clocks
78  - clock-names
79  - in-ports
80  - out-ports
81
82unevaluatedProperties: false
83
84examples:
85  - |
86    funnel@20040000 {
87        compatible = "arm,coresight-dynamic-funnel", "arm,primecell";
88        reg = <0x20040000 0x1000>;
89
90        clocks = <&oscclk6a>;
91        clock-names = "apb_pclk";
92        out-ports {
93            port {
94                funnel_out_port0: endpoint {
95                    remote-endpoint = <&replicator_in_port0>;
96                };
97            };
98        };
99
100        in-ports {
101            #address-cells = <1>;
102            #size-cells = <0>;
103
104            port@0 {
105                reg = <0>;
106                funnel_in_port0: endpoint {
107                    remote-endpoint = <&ptm0_out_port>;
108                };
109            };
110
111            port@1 {
112                reg = <1>;
113                funnel_in_port1: endpoint {
114                    remote-endpoint = <&ptm1_out_port>;
115                };
116            };
117
118            port@2 {
119                reg = <2>;
120                funnel_in_port2: endpoint {
121                    remote-endpoint = <&etm0_out_port>;
122                };
123            };
124        };
125    };
126...
127