Documentation/devicetree/bindings/arm/arm,coresight-static-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-static-funnel.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Arm CoreSight Static Trace Bus Funnel
   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 static funnel merges 2-8 trace sources into a single trace
  24   stream.
  25
  26 properties:
  27   compatible:
  28     const: arm,coresight-static-funnel
  29
  30   power-domains:
  31     maxItems: 1
  32
  33   in-ports:
  34     $ref: /schemas/graph.yaml#/properties/ports
  35
  36     patternProperties:
  37       '^port@[0-7]$':
  38         description: Input connections from CoreSight Trace bus
  39         $ref: /schemas/graph.yaml#/properties/port
  40
  41   out-ports:
  42     $ref: /schemas/graph.yaml#/properties/ports
  43     additionalProperties: false
  44
  45     properties:
  46       port:
  47         description: Output connection 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     funnel {
  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-funnel";
  65
  66         out-ports {
  67             port {
  68                 combo_funnel_out: endpoint {
  69                     remote-endpoint = <&top_funnel_in>;
  70                 };
  71             };
  72         };
  73
  74         in-ports {
  75             #address-cells = <1>;
  76             #size-cells = <0>;
  77
  78             port@0 {
  79                 reg = <0>;
  80                 combo_funnel_in0: endpoint {
  81                     remote-endpoint = <&cluster0_etf_out>;
  82                 };
  83             };
  84
  85             port@1 {
  86                 reg = <1>;
  87                 combo_funnel_in1: endpoint {
  88                     remote-endpoint = <&cluster1_etf_out>;
  89                 };
  90             };
  91         };
  92     };
  93 ...