Documentation/devicetree/bindings/arm/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
   7 title: Arm CoreSight Static Trace Bus Replicator
   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 replicator splits a single trace stream into two trace streams
  24   for systems that have more than one trace sink component.
  25
  26 properties:
  27   compatible:
  28     const: arm,coresight-static-replicator
  29
  30   power-domains:
  31     maxItems: 1
  32
  33   in-ports:
  34     $ref: /schemas/graph.yaml#/properties/ports
  35     additionalProperties: false
  36
  37     properties:
  38       port:
  39         description: Input connection from CoreSight Trace bus
  40         $ref: /schemas/graph.yaml#/properties/port
  41
  42   out-ports:
  43     $ref: /schemas/graph.yaml#/properties/ports
  44
  45     patternProperties:
  46       '^port@[01]$':
  47         description: Output connections to CoreSight Trace bus
  48         $ref: /schemas/graph.yaml#/properties/port
  49
  50 required:
  51   - compatible
  52   - in-ports
  53   - out-ports
  54
  55 additionalProperties: false
  56
  57 examples:
  58   - |
  59     replicator {
  60         /*
  61          * non-configurable replicators don't show up on the
  62          * AMBA bus.  As such no need to add "arm,primecell".
  63          */
  64         compatible = "arm,coresight-static-replicator";
  65
  66         out-ports {
  67             #address-cells = <1>;
  68             #size-cells = <0>;
  69
  70             /* replicator output ports */
  71             port@0 {
  72                 reg = <0>;
  73                 replicator_out_port0: endpoint {
  74                     remote-endpoint = <&etb_in_port>;
  75                 };
  76             };
  77
  78             port@1 {
  79                 reg = <1>;
  80                 replicator_out_port1: endpoint {
  81                     remote-endpoint = <&tpiu_in_port>;
  82                 };
  83             };
  84         };
  85
  86         in-ports {
  87             port {
  88                 replicator_in_port0: endpoint {
  89                     remote-endpoint = <&funnel_out_port0>;
  90                 };
  91             };
  92         };
  93     };
  94 ...