arm,coresight-dynamic-funnel.yaml

  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  label:
 61    description:
 62      Description of a coresight device.
 63
 64  in-ports:
 65    $ref: /schemas/graph.yaml#/properties/ports
 66
 67    patternProperties:
 68      '^port(@[0-7])?$':
 69        description: Input connections from CoreSight Trace bus
 70        $ref: /schemas/graph.yaml#/properties/port
 71
 72  out-ports:
 73    $ref: /schemas/graph.yaml#/properties/ports
 74    additionalProperties: false
 75
 76    properties:
 77      port:
 78        description: Output connection to CoreSight Trace bus
 79        $ref: /schemas/graph.yaml#/properties/port
 80
 81required:
 82  - compatible
 83  - reg
 84  - clocks
 85  - clock-names
 86  - in-ports
 87  - out-ports
 88
 89unevaluatedProperties: false
 90
 91examples:
 92  - |
 93    funnel@20040000 {
 94        compatible = "arm,coresight-dynamic-funnel", "arm,primecell";
 95        reg = <0x20040000 0x1000>;
 96
 97        clocks = <&oscclk6a>;
 98        clock-names = "apb_pclk";
 99        out-ports {
100            port {
101                funnel_out_port0: endpoint {
102                    remote-endpoint = <&replicator_in_port0>;
103                };
104            };
105        };
106
107        in-ports {
108            #address-cells = <1>;
109            #size-cells = <0>;
110
111            port@0 {
112                reg = <0>;
113                funnel_in_port0: endpoint {
114                    remote-endpoint = <&ptm0_out_port>;
115                };
116            };
117
118            port@1 {
119                reg = <1>;
120                funnel_in_port1: endpoint {
121                    remote-endpoint = <&ptm1_out_port>;
122                };
123            };
124
125            port@2 {
126                reg = <2>;
127                funnel_in_port2: endpoint {
128                    remote-endpoint = <&etm0_out_port>;
129                };
130            };
131        };
132    };
133...