arm,coresight-dynamic-replicator.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-replicator.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Arm Coresight Programmable Trace Bus Replicator
  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 replicator splits a single trace stream into two trace streams
 24  for systems that have more than one trace sink component.
 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-replicator
 32  required:
 33    - compatible
 34
 35allOf:
 36  - $ref: /schemas/arm/primecell.yaml#
 37
 38properties:
 39  compatible:
 40    items:
 41      - const: arm,coresight-dynamic-replicator
 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  label:
 58    description:
 59      Description of a coresight device.
 60
 61  power-domains:
 62    maxItems: 1
 63
 64  qcom,replicator-loses-context:
 65    type: boolean
 66    description:
 67      Indicates that the replicator will lose register context when AMBA clock
 68      is removed which is observed in some replicator designs.
 69
 70  in-ports:
 71    $ref: /schemas/graph.yaml#/properties/ports
 72    additionalProperties: false
 73
 74    properties:
 75      port:
 76        description: Input connection from CoreSight Trace bus
 77        $ref: /schemas/graph.yaml#/properties/port
 78
 79  out-ports:
 80    $ref: /schemas/graph.yaml#/properties/ports
 81
 82    patternProperties:
 83      '^port(@[01])?$':
 84        description: Output connections to CoreSight Trace bus
 85        $ref: /schemas/graph.yaml#/properties/port
 86
 87required:
 88  - compatible
 89  - reg
 90  - clocks
 91  - clock-names
 92  - in-ports
 93  - out-ports
 94
 95unevaluatedProperties: false
 96
 97examples:
 98  - |
 99    replicator@20120000 {
100        compatible = "arm,coresight-dynamic-replicator", "arm,primecell";
101        reg = <0x20120000 0x1000>;
102
103        clocks = <&soc_smc50mhz>;
104        clock-names = "apb_pclk";
105
106        out-ports {
107            #address-cells = <1>;
108            #size-cells = <0>;
109
110            /* replicator output ports */
111            port@0 {
112                reg = <0>;
113                replicator_out_port0: endpoint {
114                    remote-endpoint = <&tpiu_in_port>;
115                };
116            };
117
118            port@1 {
119                reg = <1>;
120                replicator_out_port1: endpoint {
121                    remote-endpoint = <&etr_in_port>;
122                };
123            };
124        };
125        in-ports {
126            port {
127                replicator_in_port0: endpoint {
128                    remote-endpoint = <&csys2_funnel_out_port>;
129                };
130            };
131        };
132    };
133...