[RFC PATCH] dt-bindings: arc: convert archs-pct.txt to yaml

[RFC PATCH] dt-bindings: arc: convert archs-pct.txt to yaml

[Aryabhatta Dey]

Convert dt-binding archs-pct from txt to yaml format.

Signed-off-by: Aryabhatta Dey <aryabhattadey35@gmail.com>
---
 .../devicetree/bindings/arc/archs-pct.txt     | 17 ----------
 .../bindings/arc/snps,archs-pct.yaml          | 33 +++++++++++++++++++
 2 files changed, 33 insertions(+), 17 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/arc/archs-pct.txt
 create mode 100644 Documentation/devicetree/bindings/arc/snps,archs-pct.yaml

diff --git a/Documentation/devicetree/bindings/arc/archs-pct.txt b/Documentation/devicetree/bindings/arc/archs-pct.txt
deleted file mode 100644
index e4b9dcee6d41..000000000000
--- a/Documentation/devicetree/bindings/arc/archs-pct.txt
+++ /dev/null
@@ -1,17 +0,0 @@
-* ARC HS Performance Counters
-
-The ARC HS can be configured with a pipeline performance monitor for counting
-CPU and cache events like cache misses and hits. Like conventional PCT there
-are 100+ hardware conditions dynamically mapped to up to 32 counters.
-It also supports overflow interrupts.
-
-Required properties:
-
-- compatible : should contain
-	"snps,archs-pct"
-
-Example:
-
-pmu {
-        compatible = "snps,archs-pct";
-};
diff --git a/Documentation/devicetree/bindings/arc/snps,archs-pct.yaml b/Documentation/devicetree/bindings/arc/snps,archs-pct.yaml
new file mode 100644
index 000000000000..532f7584f59f
--- /dev/null
+++ b/Documentation/devicetree/bindings/arc/snps,archs-pct.yaml
@@ -0,0 +1,33 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/arc/snps,archs-pct.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: ARC HS Performance Counters
+
+maintainers:
+  - Aryabhatta Dey <aryabhattadey35@gmail.com>
+
+description:
+  The ARC HS can be configured with a pipeline performance monitor for counting
+  CPU and cache events like cache misses and hits. Like conventional PCT there
+  are 100+ hardware conditions dynamically mapped to up to 32 counters.
+  It also supports overflow interrupts.
+
+properties:
+  compatible:
+    const: snps,archs-pct
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+  - clocks
+
+additionalProperties: false
-- 
2.46.0

Re: [RFC PATCH] dt-bindings: arc: convert archs-pct.txt to yaml

[Krzysztof Kozlowski]

On 17/08/2024 05:26, Aryabhatta Dey wrote:
> Convert dt-binding archs-pct from txt to yaml format.

Thanks for the work and sorry for asking, but what for? Is there anyone
who asked about it or shown interest in doing this?

My previous messages about topics of conversions are still valid:
https://social.kernel.org/notice/Ai9hYRUKo8suzX3zNY
and discussion on LKML.

Best regards,
Krzysztof

Re: [RFC PATCH] dt-bindings: arc: convert archs-pct.txt to yaml

[Rob Herring (Arm)]

On Sat, 17 Aug 2024 08:56:29 +0530, Aryabhatta Dey wrote:
> Convert dt-binding archs-pct from txt to yaml format.
> 
> Signed-off-by: Aryabhatta Dey <aryabhattadey35@gmail.com>
> ---
>  .../devicetree/bindings/arc/archs-pct.txt     | 17 ----------
>  .../bindings/arc/snps,archs-pct.yaml          | 33 +++++++++++++++++++
>  2 files changed, 33 insertions(+), 17 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/arc/archs-pct.txt
>  create mode 100644 Documentation/devicetree/bindings/arc/snps,archs-pct.yaml
> 

Applied, thanks!

However, if you are going to do more conversions, please pick ones more 
widely used first as Krzysztof pointed out.

Rob