[PATCH] dt-bindings: timer: Convert csky,mptimer to DT schema

[PATCH] dt-bindings: timer: Convert csky,mptimer to DT schema

[Rob Herring (Arm)]

Convert the C-SKY Multi-processor timer binding to DT schema format.
It's a straight-forward conversion.

Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
---
 .../bindings/timer/csky,mptimer.txt           | 42 -----------------
 .../bindings/timer/csky,mptimer.yaml          | 46 +++++++++++++++++++
 2 files changed, 46 insertions(+), 42 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/timer/csky,mptimer.txt
 create mode 100644 Documentation/devicetree/bindings/timer/csky,mptimer.yaml

diff --git a/Documentation/devicetree/bindings/timer/csky,mptimer.txt b/Documentation/devicetree/bindings/timer/csky,mptimer.txt
deleted file mode 100644
index f5c7e99cf52b..000000000000
--- a/Documentation/devicetree/bindings/timer/csky,mptimer.txt
+++ /dev/null
@@ -1,42 +0,0 @@
-============================
-C-SKY Multi-processors Timer
-============================
-
-C-SKY multi-processors timer is designed for C-SKY SMP system and the
-regs is accessed by cpu co-processor 4 registers with mtcr/mfcr.
-
- - PTIM_CTLR "cr<0, 14>" Control reg to start reset timer.
- - PTIM_TSR  "cr<1, 14>" Interrupt cleanup status reg.
- - PTIM_CCVR "cr<3, 14>" Current counter value reg.
- - PTIM_LVR  "cr<6, 14>" Window value reg to trigger next event.
-
-==============================
-timer node bindings definition
-==============================
-
-	Description: Describes SMP timer
-
-	PROPERTIES
-
-	- compatible
-		Usage: required
-		Value type: <string>
-		Definition: must be "csky,mptimer"
-	- clocks
-		Usage: required
-		Value type: <node>
-		Definition: must be input clk node
-	- interrupts
-		Usage: required
-		Value type: <u32>
-		Definition: must be timer irq num defined by soc
-
-Examples:
----------
-
-	timer: timer {
-		compatible = "csky,mptimer";
-		clocks = <&dummy_apb_clk>;
-		interrupts = <16>;
-		interrupt-parent = <&intc>;
-	};
diff --git a/Documentation/devicetree/bindings/timer/csky,mptimer.yaml b/Documentation/devicetree/bindings/timer/csky,mptimer.yaml
new file mode 100644
index 000000000000..12cc5282c8f8
--- /dev/null
+++ b/Documentation/devicetree/bindings/timer/csky,mptimer.yaml
@@ -0,0 +1,46 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/timer/csky,mptimer.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: C-SKY Multi-processors Timer
+
+maintainers:
+  - Flavio Suligoi <f.suligoi@asem.it>
+  - Guo Ren <guoren@kernel.org>
+
+description: |
+  C-SKY multi-processors timer is designed for C-SKY SMP system and the regs are
+  accessed by cpu co-processor 4 registers with mtcr/mfcr.
+
+   - PTIM_CTLR "cr<0, 14>" Control reg to start reset timer.
+   - PTIM_TSR  "cr<1, 14>" Interrupt cleanup status reg.
+   - PTIM_CCVR "cr<3, 14>" Current counter value reg.
+   - PTIM_LVR  "cr<6, 14>" Window value reg to trigger next event.
+
+properties:
+  compatible:
+    items:
+      - const: csky,mptimer
+
+  clocks:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+required:
+  - compatible
+  - clocks
+  - interrupts
+
+additionalProperties: false
+
+examples:
+  - |
+    timer {
+        compatible = "csky,mptimer";
+        clocks = <&dummy_apb_clk>;
+        interrupts = <16>;
+    };
-- 
2.47.2

Re: [PATCH] dt-bindings: timer: Convert csky,mptimer to DT schema

[Guo Ren]

Acked-by: Guo Ren <guoren@kernel.org>

On Tue, May 6, 2025 at 10:22 AM Rob Herring (Arm) <robh@kernel.org> wrote:
>
> Convert the C-SKY Multi-processor timer binding to DT schema format.
> It's a straight-forward conversion.
>
> Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
> ---
>  .../bindings/timer/csky,mptimer.txt           | 42 -----------------
>  .../bindings/timer/csky,mptimer.yaml          | 46 +++++++++++++++++++
>  2 files changed, 46 insertions(+), 42 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/timer/csky,mptimer.txt
>  create mode 100644 Documentation/devicetree/bindings/timer/csky,mptimer.yaml
>
> diff --git a/Documentation/devicetree/bindings/timer/csky,mptimer.txt b/Documentation/devicetree/bindings/timer/csky,mptimer.txt
> deleted file mode 100644
> index f5c7e99cf52b..000000000000
> --- a/Documentation/devicetree/bindings/timer/csky,mptimer.txt
> +++ /dev/null
> @@ -1,42 +0,0 @@
> -============================
> -C-SKY Multi-processors Timer
> -============================
> -
> -C-SKY multi-processors timer is designed for C-SKY SMP system and the
> -regs is accessed by cpu co-processor 4 registers with mtcr/mfcr.
> -
> - - PTIM_CTLR "cr<0, 14>" Control reg to start reset timer.
> - - PTIM_TSR  "cr<1, 14>" Interrupt cleanup status reg.
> - - PTIM_CCVR "cr<3, 14>" Current counter value reg.
> - - PTIM_LVR  "cr<6, 14>" Window value reg to trigger next event.
> -
> -==============================
> -timer node bindings definition
> -==============================
> -
> -       Description: Describes SMP timer
> -
> -       PROPERTIES
> -
> -       - compatible
> -               Usage: required
> -               Value type: <string>
> -               Definition: must be "csky,mptimer"
> -       - clocks
> -               Usage: required
> -               Value type: <node>
> -               Definition: must be input clk node
> -       - interrupts
> -               Usage: required
> -               Value type: <u32>
> -               Definition: must be timer irq num defined by soc
> -
> -Examples:
> ----------
> -
> -       timer: timer {
> -               compatible = "csky,mptimer";
> -               clocks = <&dummy_apb_clk>;
> -               interrupts = <16>;
> -               interrupt-parent = <&intc>;
> -       };
> diff --git a/Documentation/devicetree/bindings/timer/csky,mptimer.yaml b/Documentation/devicetree/bindings/timer/csky,mptimer.yaml
> new file mode 100644
> index 000000000000..12cc5282c8f8
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/timer/csky,mptimer.yaml
> @@ -0,0 +1,46 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/timer/csky,mptimer.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: C-SKY Multi-processors Timer
> +
> +maintainers:
> +  - Flavio Suligoi <f.suligoi@asem.it>
> +  - Guo Ren <guoren@kernel.org>
> +
> +description: |
> +  C-SKY multi-processors timer is designed for C-SKY SMP system and the regs are
> +  accessed by cpu co-processor 4 registers with mtcr/mfcr.
> +
> +   - PTIM_CTLR "cr<0, 14>" Control reg to start reset timer.
> +   - PTIM_TSR  "cr<1, 14>" Interrupt cleanup status reg.
> +   - PTIM_CCVR "cr<3, 14>" Current counter value reg.
> +   - PTIM_LVR  "cr<6, 14>" Window value reg to trigger next event.
> +
> +properties:
> +  compatible:
> +    items:
> +      - const: csky,mptimer
> +
> +  clocks:
> +    maxItems: 1
> +
> +  interrupts:
> +    maxItems: 1
> +
> +required:
> +  - compatible
> +  - clocks
> +  - interrupts
> +
> +additionalProperties: false
> +
> +examples:
> +  - |
> +    timer {
> +        compatible = "csky,mptimer";
> +        clocks = <&dummy_apb_clk>;
> +        interrupts = <16>;
> +    };
> --
> 2.47.2
>


-- 
Best Regards
 Guo Ren

Re: [PATCH] dt-bindings: timer: Convert csky,mptimer to DT schema

[Daniel Lezcano]

On Mon, May 05, 2025 at 09:22:27PM -0500, Rob Herring wrote:
> Convert the C-SKY Multi-processor timer binding to DT schema format.
> It's a straight-forward conversion.
> 
> Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
> ---

Applied, thanks!

-- 

 <http://www.linaro.org/> Linaro.org │ Open source software for ARM SoCs

Follow Linaro:  <http://www.facebook.com/pages/Linaro> Facebook |
<http://twitter.com/#!/linaroorg> Twitter |
<http://www.linaro.org/linaro-blog/> Blog

[tip: timers/clocksource] dt-bindings: timer: Convert csky,mptimer to DT schema

[tip-bot2 for Rob Herring (Arm)]

The following commit has been merged into the timers/clocksource branch of tip:

Commit-ID:     157265afbdf257c99280511a3a557933d5b2e9f1
Gitweb:        https://git.kernel.org/tip/157265afbdf257c99280511a3a557933d5b2e9f1
Author:        Rob Herring (Arm) <robh@kernel.org>
AuthorDate:    Mon, 05 May 2025 21:22:27 -05:00
Committer:     Daniel Lezcano <daniel.lezcano@linaro.org>
CommitterDate: Fri, 16 May 2025 11:10:33 +02:00

dt-bindings: timer: Convert csky,mptimer to DT schema

Convert the C-SKY Multi-processor timer binding to DT schema format.
It's a straight-forward conversion.

Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Acked-by: Guo Ren <guoren@kernel.org>
Link: https://lore.kernel.org/r/20250506022228.2587029-1-robh@kernel.org
Signed-off-by: Daniel Lezcano <daniel.lezcano@linaro.org>
---
 Documentation/devicetree/bindings/timer/csky,mptimer.txt  | 42 +------
 Documentation/devicetree/bindings/timer/csky,mptimer.yaml | 46 +++++++-
 2 files changed, 46 insertions(+), 42 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/timer/csky,mptimer.txt
 create mode 100644 Documentation/devicetree/bindings/timer/csky,mptimer.yaml

diff --git a/Documentation/devicetree/bindings/timer/csky,mptimer.txt b/Documentation/devicetree/bindings/timer/csky,mptimer.txt
deleted file mode 100644
index f5c7e99..0000000
--- a/Documentation/devicetree/bindings/timer/csky,mptimer.txt
+++ /dev/null
@@ -1,42 +0,0 @@
-============================
-C-SKY Multi-processors Timer
-============================
-
-C-SKY multi-processors timer is designed for C-SKY SMP system and the
-regs is accessed by cpu co-processor 4 registers with mtcr/mfcr.
-
- - PTIM_CTLR "cr<0, 14>" Control reg to start reset timer.
- - PTIM_TSR  "cr<1, 14>" Interrupt cleanup status reg.
- - PTIM_CCVR "cr<3, 14>" Current counter value reg.
- - PTIM_LVR  "cr<6, 14>" Window value reg to trigger next event.
-
-==============================
-timer node bindings definition
-==============================
-
-	Description: Describes SMP timer
-
-	PROPERTIES
-
-	- compatible
-		Usage: required
-		Value type: <string>
-		Definition: must be "csky,mptimer"
-	- clocks
-		Usage: required
-		Value type: <node>
-		Definition: must be input clk node
-	- interrupts
-		Usage: required
-		Value type: <u32>
-		Definition: must be timer irq num defined by soc
-
-Examples:
----------
-
-	timer: timer {
-		compatible = "csky,mptimer";
-		clocks = <&dummy_apb_clk>;
-		interrupts = <16>;
-		interrupt-parent = <&intc>;
-	};
diff --git a/Documentation/devicetree/bindings/timer/csky,mptimer.yaml b/Documentation/devicetree/bindings/timer/csky,mptimer.yaml
new file mode 100644
index 0000000..12cc528
--- /dev/null
+++ b/Documentation/devicetree/bindings/timer/csky,mptimer.yaml
@@ -0,0 +1,46 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/timer/csky,mptimer.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: C-SKY Multi-processors Timer
+
+maintainers:
+  - Flavio Suligoi <f.suligoi@asem.it>
+  - Guo Ren <guoren@kernel.org>
+
+description: |
+  C-SKY multi-processors timer is designed for C-SKY SMP system and the regs are
+  accessed by cpu co-processor 4 registers with mtcr/mfcr.
+
+   - PTIM_CTLR "cr<0, 14>" Control reg to start reset timer.
+   - PTIM_TSR  "cr<1, 14>" Interrupt cleanup status reg.
+   - PTIM_CCVR "cr<3, 14>" Current counter value reg.
+   - PTIM_LVR  "cr<6, 14>" Window value reg to trigger next event.
+
+properties:
+  compatible:
+    items:
+      - const: csky,mptimer
+
+  clocks:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+required:
+  - compatible
+  - clocks
+  - interrupts
+
+additionalProperties: false
+
+examples:
+  - |
+    timer {
+        compatible = "csky,mptimer";
+        clocks = <&dummy_apb_clk>;
+        interrupts = <16>;
+    };