[PATCH v3] ASoC: dt-bindings: img,spdif-in: Convert to dtschema

From: Javier García
Date: Tue Feb 27 2024 - 12:04:37 EST


Convert the Imagination Technologies SPDIF Input Controllerto DT schema.

Signed-off-by: Javier García <javier.garcia.ta@xxxxxxxx>
---
Changes since v1 and v2:
- re-written the subject inline to include relevant prefix

- Node name changed to spdif@18100e00 to be more generic

- Added maintainers from Documentation/devicetree/bindings/sound/ who
should be added to the maintainers list?

- Drop reg description

- Drop resets description

- Added $ref for dai-common.yaml

- Removed unused dt-bindigs/gpio/gpio.h include

- Added reset and reset-names in the example

- changed example hex to be lowercase

.../bindings/sound/img,spdif-in.txt | 41 ----------
.../bindings/sound/img,spdif-in.yaml | 81 +++++++++++++++++++
2 files changed, 81 insertions(+), 41 deletions(-)
delete mode 100644 Documentation/devicetree/bindings/sound/img,spdif-in.txt
create mode 100644 Documentation/devicetree/bindings/sound/img,spdif-in.yaml

diff --git a/Documentation/devicetree/bindings/sound/img,spdif-in.txt b/Documentation/devicetree/bindings/sound/img,spdif-in.txt
deleted file mode 100644
index f7ea8c87bf34..000000000000
--- a/Documentation/devicetree/bindings/sound/img,spdif-in.txt
+++ /dev/null
@@ -1,41 +0,0 @@
-Imagination Technologies SPDIF Input Controller
-
-Required Properties:
-
- - compatible : Compatible list, must contain "img,spdif-in"
-
- - #sound-dai-cells : Must be equal to 0
-
- - reg : Offset and length of the register set for the device
-
- - dmas: Contains an entry for each entry in dma-names.
-
- - dma-names: Must include the following entry:
- "rx"
-
- - clocks : Contains an entry for each entry in clock-names
-
- - clock-names : Includes the following entries:
- "sys" The system clock
-
-Optional Properties:
-
- - resets: Should contain a phandle to the spdif in reset signal, if any
-
- - reset-names: Should contain the reset signal name "rst", if a
- reset phandle is given
-
- - interrupts : Contains the spdif in interrupt, if present
-
-Example:
-
-spdif_in: spdif-in@18100e00 {
- compatible = "img,spdif-in";
- reg = <0x18100E00 0x100>;
- interrupts = <GIC_SHARED 20 IRQ_TYPE_LEVEL_HIGH>;
- dmas = <&mdc 15 0xffffffff 0>;
- dma-names = "rx";
- clocks = <&cr_periph SYS_CLK_SPDIF_IN>;
- clock-names = "sys";
- #sound-dai-cells = <0>;
-};
diff --git a/Documentation/devicetree/bindings/sound/img,spdif-in.yaml b/Documentation/devicetree/bindings/sound/img,spdif-in.yaml
new file mode 100644
index 000000000000..ab8f96cc37cd
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/img,spdif-in.yaml
@@ -0,0 +1,81 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/sound/img,spdif-in.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Imagination Technologies SPDIF Input Controller
+
+maintainers:
+ - Liam Girdwood <lgirdwood@xxxxxxxxx>
+ - Mark Brown <broonie@xxxxxxxxxx>
+
+allOf:
+ - $ref: dai-common.yaml#
+
+properties:
+ compatible:
+ enum:
+ - img,spdif-in
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ dmas:
+ maxItems: 1
+
+ dma-names:
+ items:
+ - const: rx
+
+ clocks:
+ items:
+ - description: The system clock
+
+ clock-names:
+ items:
+ - const: sys
+
+ '#sound-dai-cells':
+ const: 0
+
+ resets:
+ maxItems: 1
+
+ reset-names:
+ items:
+ - const: rst
+
+required:
+ - compatible
+ - reg
+ - dmas
+ - dma-names
+ - clocks
+ - clock-names
+ - '#sound-dai-cells'
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/clock/pistachio-clk.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+ #include <dt-bindings/interrupt-controller/mips-gic.h>
+ #include <dt-bindings/reset/pistachio-resets.h>
+ spdif_in: spdif@18100e00 {
+ compatible = "img,spdif-in";
+ reg = <0x18100e00 0x100>;
+ interrupts = <GIC_SHARED 20 IRQ_TYPE_LEVEL_HIGH>;
+ dmas = <&mdc 15 0xffffffff 0>;
+ dma-names = "rx";
+ clocks = <&cr_periph SYS_CLK_SPDIF_IN>;
+ clock-names = "sys";
+ resets = <&pistachio_reset PISTACHIO_RESET_SPDIF_IN>;
+ reset-names = "rst";
+
+ #sound-dai-cells = <0>;
+ };
--
2.43.0