Unverified Commit 0a0ca8e9 authored by Maxime Ripard's avatar Maxime Ripard Committed by Mark Brown
Browse files

dt-bindings: sound: Convert Allwinner I2S binding to YAML 



The Allwinner SoCs feature an I2S controller across multiple SoC
generations.

However, earlier generations were a bit simpler than the subsequent ones,
and for example would always have RX and TX capabilities, and no reset
lines.

Signed-off-by: default avatarMaxime Ripard <maxime.ripard@bootlin.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent ec9025e5

Documentation/devicetree/bindings/sound/allwinner,sun4i-a10-i2s.yaml

0 → 100644
+100 −0
Original line number Original line Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/sound/allwinner,sun4i-a10-i2s.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: Allwinner A10 I2S Controller Device Tree Bindings



maintainers:

  - Chen-Yu Tsai <wens@csie.org>

  - Maxime Ripard <maxime.ripard@bootlin.com>



properties:

  "#sound-dai-cells":

    const: 0



  compatible:

    oneOf:

      - const: allwinner,sun4i-a10-i2s

      - const: allwinner,sun6i-a31-i2s

      - const: allwinner,sun8i-a83t-i2s

      - const: allwinner,sun8i-h3-i2s

      - const: allwinner,sun50i-a64-codec-i2s

      - items:

          - const: allwinner,sun50i-a64-i2s

          - const: allwinner,sun8i-h3-i2s



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  clocks:

    items:

      - description: Bus Clock

      - description: Module Clock



  clock-names:

    items:

      - const: apb

      - const: mod



  dmas:

    items:

      - description: RX DMA Channel

      - description: TX DMA Channel



  dma-names:

    items:

      - const: rx

      - const: tx



  # Even though it only applies to subschemas under the conditionals,

  # not listing them here will trigger a warning because of the

  # additionalsProperties set to false.

  resets:

    maxItems: 1



allOf:

  - if:

      properties:

        compatible:

          contains:

            enum:

              - allwinner,sun6i-a31-i2s

              - allwinner,sun8i-a83t-i2s

              - allwinner,sun8i-h3-i2s

              - allwinner,sun50i-a64-codec-i2s



    then:

      required:

        - resets



required:

  - "#sound-dai-cells"

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names

  - dmas

  - dma-names



additionalProperties: false



examples:

  - |

    i2s0: i2s@1c22400 {

        #sound-dai-cells = <0>;

        compatible = "allwinner,sun4i-a10-i2s";

        reg = <0x01c22400 0x400>;

        interrupts = <0 16 4>;

        clocks = <&apb0_gates 3>, <&i2s0_clk>;

        clock-names = "apb", "mod";

        dmas = <&dma 0 3>, <&dma 0 3>;

        dma-names = "rx", "tx";

    };



...

Documentation/devicetree/bindings/sound/sun4i-i2s.txt

deleted100644 → 0
+0 −45
Original line number Original line Diff line number Diff line 
* Allwinner A10 I2S controller



The I2S bus (Inter-IC sound bus) is a serial link for digital

audio data transfer between devices in the system.



Required properties:



- compatible: should be one of the following:

   - "allwinner,sun4i-a10-i2s"

   - "allwinner,sun6i-a31-i2s"

   - "allwinner,sun8i-a83t-i2s"

   - "allwinner,sun8i-h3-i2s"

   - "allwinner,sun50i-a64-codec-i2s"

- reg: physical base address of the controller and length of memory mapped

  region.

- interrupts: should contain the I2S interrupt.

- dmas: DMA specifiers for tx and rx dma. See the DMA client binding,

	Documentation/devicetree/bindings/dma/dma.txt

- dma-names: should include "tx" and "rx".

- clocks: a list of phandle + clock-specifer pairs, one for each entry in clock-names.

- clock-names: should contain the following:

   - "apb" : clock for the I2S bus interface

   - "mod" : module clock for the I2S controller

- #sound-dai-cells : Must be equal to 0



Required properties for the following compatibles:

	- "allwinner,sun6i-a31-i2s"

	- "allwinner,sun8i-a83t-i2s"

	- "allwinner,sun8i-h3-i2s"

	- "allwinner,sun50i-a64-codec-i2s"

- resets: phandle to the reset line for this codec



Example:



i2s0: i2s@1c22400 {

	#sound-dai-cells = <0>;

	compatible = "allwinner,sun4i-a10-i2s";

	reg = <0x01c22400 0x400>;

	interrupts = <GIC_SPI 16 IRQ_TYPE_LEVEL_HIGH>;

	clocks = <&apb0_gates 3>, <&i2s0_clk>;

	clock-names = "apb", "mod";

	dmas = <&dma SUN4I_DMA_NORMAL 3>,

	       <&dma SUN4I_DMA_NORMAL 3>;

	dma-names = "rx", "tx";

};