72 lines · yaml
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause2%YAML 1.23---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 component8 9description: |10 CoreSight components are compliant with the ARM CoreSight architecture11 specification and can be connected in various topologies to suit a particular12 SoCs tracing needs. These trace components can generally be classified as13 sinks, links and sources. Trace data produced by one or more sources flows14 through the intermediate links connecting the source to the currently selected15 sink.16 17 The Coresight dummy source component is for the specific coresight source18 devices kernel don't have permission to access or configure. For some SOCs,19 there would be Coresight source trace components on sub-processor which20 are connected to AP processor via debug bus. For these devices, a dummy driver21 is needed to register them as Coresight source devices, so that paths can be22 created in the driver. It provides Coresight API for operations on dummy23 source devices, such as enabling and disabling them. It also provides the24 Coresight dummy source paths for debugging.25 26 The primary use case of the coresight dummy source is to build path in kernel27 side for dummy source component.28 29maintainers:30 - Mike Leach <mike.leach@linaro.org>31 - Suzuki K Poulose <suzuki.poulose@arm.com>32 - James Clark <james.clark@linaro.org>33 - Mao Jinlong <quic_jinlmao@quicinc.com>34 - Hao Zhang <quic_hazha@quicinc.com>35 36properties:37 compatible:38 enum:39 - arm,coresight-dummy-source40 41 out-ports:42 $ref: /schemas/graph.yaml#/properties/ports43 44 properties:45 port:46 description: Output connection from the source to Coresight47 Trace bus.48 $ref: /schemas/graph.yaml#/properties/port49 50required:51 - compatible52 - out-ports53 54additionalProperties: false55 56examples:57 # Minimum dummy source definition. Dummy source connect to coresight funnel.58 - |59 source {60 compatible = "arm,coresight-dummy-source";61 62 out-ports {63 port {64 dummy_riscv_out_funnel_swao: endpoint {65 remote-endpoint = <&funnel_swao_in_dummy_riscv>;66 };67 };68 };69 };70 71...72