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-dummy-source.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ARM Coresight Dummy source component
8
9description: |
10  CoreSight components are compliant with the ARM CoreSight architecture
11  specification and can be connected in various topologies to suit a particular
12  SoCs tracing needs. These trace components can generally be classified as
13  sinks, links and sources. Trace data produced by one or more sources flows
14  through the intermediate links connecting the source to the currently selected
15  sink.
16
17  The Coresight dummy source component is for the specific coresight source
18  devices kernel don't have permission to access or configure. For some SOCs,
19  there would be Coresight source trace components on sub-processor which
20  are connected to AP processor via debug bus. For these devices, a dummy driver
21  is needed to register them as Coresight source devices, so that paths can be
22  created in the driver. It provides Coresight API for operations on dummy
23  source devices, such as enabling and disabling them. It also provides the
24  Coresight dummy source paths for debugging.
25
26  The primary use case of the coresight dummy source is to build path in kernel
27  side for dummy source component.
28
29maintainers:
30  - Mike Leach <[email protected]>
31  - Suzuki K Poulose <[email protected]>
32  - James Clark <[email protected]>
33  - Mao Jinlong <[email protected]>
34  - Hao Zhang <[email protected]>
35
36properties:
37  compatible:
38    enum:
39      - arm,coresight-dummy-source
40
41  arm,static-trace-id:
42    description: If dummy source needs static id support, use this to set trace id.
43    $ref: /schemas/types.yaml#/definitions/uint32
44    minimum: 1
45    maximum: 111
46
47  out-ports:
48    $ref: /schemas/graph.yaml#/properties/ports
49
50    properties:
51      port:
52        description: Output connection from the source to Coresight
53          Trace bus.
54        $ref: /schemas/graph.yaml#/properties/port
55
56required:
57  - compatible
58  - out-ports
59
60additionalProperties: false
61
62examples:
63  # Minimum dummy source definition. Dummy source connect to coresight funnel.
64  - |
65    source {
66      compatible = "arm,coresight-dummy-source";
67
68      out-ports {
69        port {
70          dummy_riscv_out_funnel_swao: endpoint {
71            remote-endpoint = <&funnel_swao_in_dummy_riscv>;
72          };
73        };
74      };
75    };
76
77...
78