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