xref: /freebsd/sys/contrib/device-tree/Bindings/arm/arm,coresight-dynamic-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-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  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
77required:
78  - compatible
79  - reg
80  - clocks
81  - clock-names
82  - in-ports
83  - out-ports
84
85unevaluatedProperties: false
86
87examples:
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...
130