[PATCH v2 01/12] dt-bindings: arm: coresight: Add 'qcom,cpu-bound-components' property

Yuanfang Zhang
2025-12-18T08:10:44Z

Introduce the `qcom,cpu-bound-components` boolean property for CoreSight
components (TMC, Funnel, and Replicator).

This property indicates that the component is physically located within a
CPU cluster power domain. Such components share the power state of the
cluster and may require special handling (e.g., cross-CPU register
access) compared to system-wide components.

Signed-off-by: Yuanfang Zhang <yuanfang.zhang@oss.qualcomm.com>
---
.../devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml | 5 +++++
.../devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml | 5 +++++
Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml | 5 +++++
3 files changed, 15 insertions(+)

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml
index b74db15e5f8af2226b817f6af5f533b1bfc74736..a4c7333e8359da9035a9fed999ec99159e00a1d9 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml
@@ -57,6 +57,11 @@ properties:
power-domains:
maxItems: 1

+ qcom,cpu-bound-components:
+ type: boolean
+ description:
+ Indicates whether the funnel is located physically within cpu cluster.
+
label:
description:
Description of a coresight device.
diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml
index 17ea936b796fd42bb885e539201276a11e91028c..2c6e78f02ed84d95bb4366e4c4bbd1b3953efa32 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml
@@ -67,6 +67,11 @@ properties:
Indicates that the replicator will lose register context when AMBA clock
is removed which is observed in some replicator designs.

+ qcom,cpu-bound-components:
+ type: boolean
+ description:
+ Indicates whether the replicator is located physically within cpu cluster.
+
in-ports:
$ref: /schemas/graph.yaml#/properties/ports
additionalProperties: false
diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml
index 96dd5b5f771a39138df9adde0c9c9a6f5583d9da..8c4f2244a5c74dc8654892305025a4e6bccbce07 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml
@@ -86,6 +86,11 @@ properties:
$ref: /schemas/types.yaml#/definitions/uint32
maximum: 15

+ qcom,cpu-bound-components:
+ type: boolean
+ description:
+ indicates whether the TMC-ETF is located physically within cpu cluster.
+
in-ports:
$ref: /schemas/graph.yaml#/properties/ports
additionalProperties: false

--
2.34.1