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
7 title: Arm CoreSight Programmable Trace Bus Funnel
8
9 maintainers:
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
15 description: |
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
27 select:
28 properties:
29 compatible:
30 contains:
31 const: arm,coresight-dynamic-funnel
32 required:
33 - compatible
34
35 allOf:
36 - $ref: /schemas/arm/primecell.yaml#
37
38 properties:
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 power-domains:
58 maxItems: 1
59
60 in-ports:
61 $ref: /schemas/graph.yaml#/properties/ports
62
63 patternProperties:
64 '^port(@[0-7])?$':
65 description: Input connections from CoreSight Trace bus
66 $ref: /schemas/graph.yaml#/properties/port
67
68 out-ports:
69 $ref: /schemas/graph.yaml#/properties/ports
70 additionalProperties: false
71
72 properties:
73 port:
74 description: Output connection to CoreSight Trace bus
75 $ref: /schemas/graph.yaml#/properties/port
76
77 required:
78 - compatible
79 - reg
80 - clocks
81 - clock-names
82 - in-ports
83 - out-ports
84
85 unevaluatedProperties: false
86
87 examples:
88 - |
89 funnel@20040000 {
90 compatible = "arm,coresight-dynamic-funnel", "arm,primecell";
91 reg = <0x20040000 0x1000>;
92
93 clocks = <&oscclk6a>;
94 clock-names = "apb_pclk";
95 out-ports {
96 port {
97 funnel_out_port0: endpoint {
98 remote-endpoint = <&replicator_in_port0>;
99 };
100 };
101 };
102
103 in-ports {
104 #address-cells = <1>;
105 #size-cells = <0>;
106
107 port@0 {
108 reg = <0>;
109 funnel_in_port0: endpoint {
110 remote-endpoint = <&ptm0_out_port>;
111 };
112 };
113
114 port@1 {
115 reg = <1>;
116 funnel_in_port1: endpoint {
117 remote-endpoint = <&ptm1_out_port>;
118 };
119 };
120
121 port@2 {
122 reg = <2>;
123 funnel_in_port2: endpoint {
124 remote-endpoint = <&etm0_out_port>;
125 };
126 };
127 };
128 };
129 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.