Unverified Commit 00645b42 authored by Animesh Agarwal's avatar Animesh Agarwal Committed by Mark Brown
Browse files

ASoC: dt-bindings: fsl,imx-audio-es8328: Convert to dtschema 



Convert the Freescale i.MX audio complex with ES8328 codec bindings to
DT schema format.

Cc: Daniel Baluta <daniel.baluta@nxp.com>
Signed-off-by: default avatarAnimesh Agarwal <animeshagarwal28@gmail.com>
Reviewed-by: default avatarRob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20240722063657.23018-1-animeshagarwal28@gmail.com


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent 00425bf8

Documentation/devicetree/bindings/sound/fsl,imx-audio-es8328.yaml

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/sound/fsl,imx-audio-es8328.yaml#

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



title: Freescale i.MX audio complex with ES8328 codec



maintainers:

  - Shawn Guo <shawnguo@kernel.org>

  - Sascha Hauer <s.hauer@pengutronix.de>



allOf:

  - $ref: sound-card-common.yaml#



properties:

  compatible:

    const: fsl,imx-audio-es8328



  model:

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

    description: The user-visible name of this sound complex



  ssi-controller:

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

    description: The phandle of the i.MX SSI controller



  jack-gpio:

    description: Optional GPIO for headphone jack

    maxItems: 1



  audio-amp-supply:

    description: Power regulator for speaker amps



  audio-codec:

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

    description: The phandle to the ES8328 audio codec



  audio-routing:

    $ref: /schemas/types.yaml#/definitions/non-unique-string-array

    description: |

      A list of the connections between audio components. Each entry

      is a pair of strings, the first being the connection's sink, the second

      being the connection's source. Valid names could be power supplies,

      ES8328 pins, and the jacks on the board:



      Power supplies:

        * audio-amp



      ES8328 pins:

        * LOUT1

        * LOUT2

        * ROUT1

        * ROUT2

        * LINPUT1

        * LINPUT2

        * RINPUT1

        * RINPUT2

        * Mic PGA



      Board connectors:

        * Headphone

        * Speaker

        * Mic Jack



  mux-int-port:

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

    description: The internal port of the i.MX audio muxer (AUDMUX)

    enum: [1, 2, 7]

    default: 1



  mux-ext-port:

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

    description: The external port of the i.MX audio muxer (AUDMIX)

    enum: [3, 4, 5, 6]

    default: 3



required:

  - compatible

  - model

  - ssi-controller

  - jack-gpio

  - audio-amp-supply

  - audio-codec

  - audio-routing

  - mux-int-port

  - mux-ext-port



unevaluatedProperties: false



examples:

  - |

    sound {

        compatible = "fsl,imx-audio-es8328";

        model = "imx-audio-es8328";

        ssi-controller = <&ssi1>;

        audio-codec = <&codec>;

        jack-gpio = <&gpio5 15 0>;

        audio-amp-supply = <&reg_audio_amp>;

        audio-routing =

            "Speaker", "LOUT2",

            "Speaker", "ROUT2",

            "Speaker", "audio-amp",

            "Headphone", "ROUT1",

            "Headphone", "LOUT1",

            "LINPUT1", "Mic Jack",

            "RINPUT1", "Mic Jack",

            "Mic Jack", "Mic Bias";

        mux-int-port = <1>;

        mux-ext-port = <3>;

    };

Documentation/devicetree/bindings/sound/imx-audio-es8328.txt

deleted100644 → 0
+0 −60
Original line number Diff line number Diff line 
Freescale i.MX audio complex with ES8328 codec



Required properties:

- compatible       : "fsl,imx-audio-es8328"

- model            : The user-visible name of this sound complex

- ssi-controller   : The phandle of the i.MX SSI controller

- jack-gpio        : Optional GPIO for headphone jack

- audio-amp-supply : Power regulator for speaker amps

- audio-codec      : The phandle of the ES8328 audio codec

- audio-routing    : A list of the connections between audio components.

                     Each entry is a pair of strings, the first being the

		     connection's sink, the second being the connection's

		     source. Valid names could be power supplies, ES8328

		     pins, and the jacks on the board:



			Power supplies:

			   * audio-amp



			ES8328 pins:

			   * LOUT1

			   * LOUT2

			   * ROUT1

			   * ROUT2

			   * LINPUT1

			   * LINPUT2

			   * RINPUT1

			   * RINPUT2

			   * Mic PGA



			Board connectors:

			   * Headphone

			   * Speaker

			   * Mic Jack

- mux-int-port     : The internal port of the i.MX audio muxer (AUDMUX)

- mux-ext-port     : The external port of the i.MX audio muxer (AUDMIX)



Note: The AUDMUX port numbering should start at 1, which is consistent with

hardware manual.



Example:



sound {

	compatible = "fsl,imx-audio-es8328";

	model = "imx-audio-es8328";

	ssi-controller = <&ssi1>;

	audio-codec = <&codec>;

	jack-gpio = <&gpio5 15 0>;

	audio-amp-supply = <&reg_audio_amp>;

	audio-routing =

		"Speaker", "LOUT2",

		"Speaker", "ROUT2",

		"Speaker", "audio-amp",

		"Headphone", "ROUT1",

		"Headphone", "LOUT1",

		"LINPUT1", "Mic Jack",

		"RINPUT1", "Mic Jack",

		"Mic Jack", "Mic Bias";

	mux-int-port = <1>;

	mux-ext-port = <3>;

};