[PATCH v6 1/2] dt-bindings: arm: Add label in the coresight components

Mao Jinlong
2024-12-17T06:36:15Z

Current name of coresight component's folder consists of prefix of
the device and the id in the device list. When run 'ls' command,
we can get the register address of the device. Take CTI for example,
if we want to set the config for modem CTI, but we can't know which
CTI is modem CTI from all current information.

cti_sys0 -> ../../../devices/platform/soc@0/138f0000.cti/cti_sys0
cti_sys1 -> ../../../devices/platform/soc@0/13900000.cti/cti_sys1

Add label to show hardware context information of each coresight
device. There will be a sysfs node label in each device folder.

cat /sys/bus/coresight/devices/cti_sys0/label

Signed-off-by: Mao Jinlong <quic_jinlmao@quicinc.com>
---
.../devicetree/bindings/arm/arm,coresight-cti.yaml | 6 ++++++
.../devicetree/bindings/arm/arm,coresight-dummy-sink.yaml | 6 ++++++
.../devicetree/bindings/arm/arm,coresight-dummy-source.yaml | 6 ++++++
.../bindings/arm/arm,coresight-dynamic-funnel.yaml | 6 ++++++
.../bindings/arm/arm,coresight-dynamic-replicator.yaml | 6 ++++++
.../bindings/arm/arm,coresight-static-funnel.yaml | 6 ++++++
.../bindings/arm/arm,coresight-static-replicator.yaml | 6 ++++++
.../devicetree/bindings/arm/arm,coresight-tmc.yaml | 6 ++++++
.../devicetree/bindings/arm/qcom,coresight-tpda.yaml | 6 ++++++
.../devicetree/bindings/arm/qcom,coresight-tpdm.yaml | 6 ++++++
10 files changed, 60 insertions(+)

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-cti.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-cti.yaml
index 2d5545a2b49c..5ca6d3d313a3 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-cti.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-cti.yaml
@@ -98,6 +98,12 @@ properties:
power-domains:
maxItems: 1

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
arm,cti-ctm-id:
$ref: /schemas/types.yaml#/definitions/uint32
description:
diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-dummy-sink.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-dummy-sink.yaml
index 08b89b62c505..bc82cd1f3595 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-dummy-sink.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-dummy-sink.yaml
@@ -39,6 +39,12 @@ properties:
enum:
- arm,coresight-dummy-sink

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
in-ports:
$ref: /schemas/graph.yaml#/properties/ports

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-dummy-source.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-dummy-source.yaml
index 04a8c37b4aff..245929c36357 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-dummy-source.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-dummy-source.yaml
@@ -38,6 +38,12 @@ properties:
enum:
- arm,coresight-dummy-source

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
out-ports:
$ref: /schemas/graph.yaml#/properties/ports

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml
index 44a1041cb0fc..30776610d4b4 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-funnel.yaml
@@ -57,6 +57,12 @@ properties:
power-domains:
maxItems: 1

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
in-ports:
$ref: /schemas/graph.yaml#/properties/ports

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml
index 03792e9bd97a..178a3861ee29 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-dynamic-replicator.yaml
@@ -54,6 +54,12 @@ properties:
- const: apb_pclk
- const: atclk

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
power-domains:
maxItems: 1

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-static-funnel.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-static-funnel.yaml
index cc8c3baa79b4..39b291909cc4 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-static-funnel.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-static-funnel.yaml
@@ -30,6 +30,12 @@ properties:
power-domains:
maxItems: 1

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
in-ports:
$ref: /schemas/graph.yaml#/properties/ports

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-static-replicator.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-static-replicator.yaml
index 1892a091ac35..ba10897043cf 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-static-replicator.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-static-replicator.yaml
@@ -39,6 +39,12 @@ properties:
description: Input connection from CoreSight Trace bus
$ref: /schemas/graph.yaml#/properties/port

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
out-ports:
$ref: /schemas/graph.yaml#/properties/ports

diff --git a/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml b/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml
index cb8dceaca70e..8d952150d7b9 100644
--- a/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml
+++ b/Documentation/devicetree/bindings/arm/arm,coresight-tmc.yaml
@@ -55,6 +55,12 @@ properties:
- const: apb_pclk
- const: atclk

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
iommus:
maxItems: 1

diff --git a/Documentation/devicetree/bindings/arm/qcom,coresight-tpda.yaml b/Documentation/devicetree/bindings/arm/qcom,coresight-tpda.yaml
index 76163abed655..986b9b4f360d 100644
--- a/Documentation/devicetree/bindings/arm/qcom,coresight-tpda.yaml
+++ b/Documentation/devicetree/bindings/arm/qcom,coresight-tpda.yaml
@@ -65,6 +65,12 @@ properties:
items:
- const: apb_pclk

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
in-ports:
description: |
Input connections from TPDM to TPDA
diff --git a/Documentation/devicetree/bindings/arm/qcom,coresight-tpdm.yaml b/Documentation/devicetree/bindings/arm/qcom,coresight-tpdm.yaml
index 8eec07d9d454..59e533720bdd 100644
--- a/Documentation/devicetree/bindings/arm/qcom,coresight-tpdm.yaml
+++ b/Documentation/devicetree/bindings/arm/qcom,coresight-tpdm.yaml
@@ -77,6 +77,12 @@ properties:
minimum: 0
maximum: 32

+ label:
+ $ref: /schemas/types.yaml#/definitions/string
+ description:
+ Define the label which can describe what kind of HW or system the
+ coresight device belongs to.
+
clocks:
maxItems: 1

--
2.17.1