dt-bindings: sound: Convert jz47*-codec doc to YAML

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/sound/ingenic,codec.yaml#

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

title: Ingenic JZ47xx internal codec DT bindings

maintainers:

  - Paul Cercueil <paul@crapouillou.net>

properties:

  $nodename:

    pattern: '^audio-codec@.*'

  compatible:

    oneOf:

      - const: ingenic,jz4770-codec

      - const: ingenic,jz4725b-codec

      - const: ingenic,jz4740-codec

  reg:

    maxItems: 1

  clocks:

    maxItems: 1

  clock-names:

    items:

      - const: aic

  '#sound-dai-cells':

    const: 0

additionalProperties: false

required:

  - compatible

  - reg

  - clocks

  - clock-names

  - '#sound-dai-cells'

examples:

  - |

    #include <dt-bindings/clock/jz4740-cgu.h>

    codec: audio-codec@10020080 {

      compatible = "ingenic,jz4740-codec";

      reg = <0x10020080 0x8>;

      #sound-dai-cells = <0>;

      clocks = <&cgu JZ4740_CLK_AIC>;

      clock-names = "aic";

    };

...

Ingenic JZ4725B codec controller

Required properties:

- compatible : "ingenic,jz4725b-codec"

- reg : codec registers location and length

- clocks : phandle to the AIC clock.

- clock-names: must be set to "aic".

- #sound-dai-cells: Must be set to 0.

Example:

codec: audio-codec@100200a4 {

	compatible = "ingenic,jz4725b-codec";

	reg = <0x100200a4 0x8>;

	#sound-dai-cells = <0>;

	clocks = <&cgu JZ4725B_CLK_AIC>;

	clock-names = "aic";

};

Ingenic JZ4740 codec controller

Required properties:

- compatible : "ingenic,jz4740-codec"

- reg : codec registers location and length

- clocks : phandle to the AIC clock.

- clock-names: must be set to "aic".

- #sound-dai-cells: Must be set to 0.

Example:

codec: audio-codec@10020080 {

	compatible = "ingenic,jz4740-codec";

	reg = <0x10020080 0x8>;

	#sound-dai-cells = <0>;

	clocks = <&cgu JZ4740_CLK_AIC>;

	clock-names = "aic";

};