dt-bindings: tegra: Convert HDA doc to json-schema

NVIDIA Tegra30 HDA controller

Required properties:

- compatible : For Tegra30, must contain "nvidia,tegra30-hda".  Otherwise,

  must contain '"nvidia,<chip>-hda", "nvidia,tegra30-hda"', where <chip> is

  tegra114, tegra124, or tegra132.

- reg : Should contain the HDA registers location and length.

- interrupts : The interrupt from the HDA controller.

- clocks : Must contain an entry for each required entry in clock-names.

  See ../clocks/clock-bindings.txt for details.

- clock-names : Must include the following entries: hda, hda2hdmi, hda2codec_2x

- resets : Must contain an entry for each entry in reset-names.

  See ../reset/reset.txt for details.

- reset-names : Must include the following entries: hda, hda2hdmi, hda2codec_2x

Optional properties:

- nvidia,model : The user-visible name of this sound complex. Since the property

  is optional, legacy boards can use default name provided in hda driver.

Example:

hda@70030000 {

	compatible = "nvidia,tegra124-hda", "nvidia,tegra30-hda";

	reg = <0x0 0x70030000 0x0 0x10000>;

	interrupts = <GIC_SPI 81 IRQ_TYPE_LEVEL_HIGH>;

	clocks = <&tegra_car TEGRA124_CLK_HDA>,

		 <&tegra_car TEGRA124_CLK_HDA2HDMI>,

		 <&tegra_car TEGRA124_CLK_HDA2CODEC_2X>;

	clock-names = "hda", "hda2hdmi", "hda2codec_2x";

	resets = <&tegra_car 125>, /* hda */

		 <&tegra_car 128>, /* hda2hdmi */

		 <&tegra_car 111>; /* hda2codec_2x */

	reset-names = "hda", "hda2hdmi", "hda2codec_2x";

	nvidia,model = "jetson-tk1-hda";

};

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/sound/nvidia,tegra30-hda.yaml#

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

title: NVIDIA Tegra HDA controller

description: |

  The High Definition Audio (HDA) block provides a serial interface to

  audio codec. It supports multiple input and output streams.

maintainers:

  - Thierry Reding <treding@nvidia.com>

  - Jon Hunter <jonathanh@nvidia.com>

properties:

  $nodename:

    pattern: "^hda@[0-9a-f]*$"

  compatible:

    oneOf:

      - const: nvidia,tegra30-hda

      - items:

          - enum:

              - nvidia,tegra194-hda

              - nvidia,tegra186-hda

              - nvidia,tegra210-hda

              - nvidia,tegra124-hda

          - const: nvidia,tegra30-hda

      - items:

          - const: nvidia,tegra132-hda

          - const: nvidia,tegra124-hda

          - const: nvidia,tegra30-hda

  reg:

    maxItems: 1

  interrupts:

    description: The interrupt from the HDA controller

    maxItems: 1

  clocks:

    maxItems: 3

  clock-names:

    maxItems: 3

    items:

      - const: hda

      - const: hda2hdmi

      - const: hda2codec_2x

  resets:

    maxItems: 3

  reset-names:

    maxItems: 3

    items:

      - const: hda

      - const: hda2hdmi

      - const: hda2codec_2x

  nvidia,model:

    $ref: /schemas/types.yaml#/definitions/string

    description: |

      The user-visible name of this sound complex. If this property is

      not specified then boards can use default name provided in hda driver.

required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names

additionalProperties: false

examples:

  - |

    #include<dt-bindings/clock/tegra124-car-common.h>

    #include<dt-bindings/interrupt-controller/arm-gic.h>

    hda@70030000 {

        compatible = "nvidia,tegra124-hda", "nvidia,tegra30-hda";

        reg = <0x70030000 0x10000>;

        interrupts = <GIC_SPI 81 IRQ_TYPE_LEVEL_HIGH>;

        clocks = <&tegra_car TEGRA124_CLK_HDA>,

                 <&tegra_car TEGRA124_CLK_HDA2HDMI>,

                 <&tegra_car TEGRA124_CLK_HDA2CODEC_2X>;

        clock-names = "hda", "hda2hdmi", "hda2codec_2x";

        resets = <&tegra_car 125>, /* hda */

                 <&tegra_car 128>, /* hda2hdmi */

                 <&tegra_car 111>; /* hda2codec_2x */

        reset-names = "hda", "hda2hdmi", "hda2codec_2x";

        nvidia,model = "jetson-tk1-hda";

    };

...