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