arm,coresight-static-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-static-replicator.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Arm CoreSight Static 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
 26properties:
 27  compatible:
 28    const: arm,coresight-static-replicator
 29
 30  power-domains:
 31    maxItems: 1
 32
 33  clocks:
 34    minItems: 1
 35    maxItems: 3
 36
 37  clock-names:
 38    oneOf:
 39      - items:
 40          - enum: [apb_pclk, atclk]
 41      - items: # Zynq-700
 42          - const: apb_pclk
 43          - const: dbg_trc
 44          - const: dbg_apb
 45
 46  label:
 47    description:
 48      Description of a coresight device.
 49
 50  in-ports:
 51    $ref: /schemas/graph.yaml#/properties/ports
 52    additionalProperties: false
 53
 54    properties:
 55      port:
 56        description: Input connection from CoreSight Trace bus
 57        $ref: /schemas/graph.yaml#/properties/port
 58
 59  out-ports:
 60    $ref: /schemas/graph.yaml#/properties/ports
 61
 62    patternProperties:
 63      '^port@[01]$':
 64        description: Output connections to CoreSight Trace bus
 65        $ref: /schemas/graph.yaml#/$defs/port-base
 66        unevaluatedProperties: false
 67
 68        properties:
 69          endpoint:
 70            $ref: /schemas/graph.yaml#/$defs/endpoint-base
 71            unevaluatedProperties: false
 72
 73            properties:
 74              filter-source:
 75                $ref: /schemas/types.yaml#/definitions/phandle
 76                description:
 77                  phandle to the coresight trace source device matching the
 78                  hard coded filtering for this port
 79
 80              remote-endpoint: true
 81
 82required:
 83  - compatible
 84  - in-ports
 85  - out-ports
 86
 87additionalProperties: false
 88
 89examples:
 90  - |
 91    replicator {
 92        /*
 93         * non-configurable replicators don't show up on the
 94         * AMBA bus.  As such no need to add "arm,primecell".
 95         */
 96        compatible = "arm,coresight-static-replicator";
 97
 98        out-ports {
 99            #address-cells = <1>;
100            #size-cells = <0>;
101
102            /* replicator output ports */
103            port@0 {
104                reg = <0>;
105                replicator_out_port0: endpoint {
106                    remote-endpoint = <&etb_in_port>;
107                    filter-source = <&tpdm_video>;
108                };
109            };
110
111            port@1 {
112                reg = <1>;
113                replicator_out_port1: endpoint {
114                    remote-endpoint = <&tpiu_in_port>;
115                    filter-source = <&tpdm_mdss>;
116                };
117            };
118        };
119
120        in-ports {
121            port {
122                replicator_in_port0: endpoint {
123                    remote-endpoint = <&funnel_out_port0>;
124                };
125            };
126        };
127    };
128...