Unverified Commit a9c8ca5d authored by Neil Armstrong's avatar Neil Armstrong Committed by Mark Brown
Browse files

ASoC: dt-bindings: convert tas571x.txt to dt-schema



Convert the text bindings for the Texas Instruments
TAS5711/TAS5717/TAS5719/TAS5721 stereo power amplifiers to
dt-schema.

Signed-off-by: default avatarNeil Armstrong <neil.armstrong@linaro.org>
Reviewed-by: default avatarRob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20240611-topic-amlogic-upstream-bindings-convert-tas57xx-v2-1-38269edc1d95@linaro.org


Signed-off-by: default avatarMark Brown <broonie@kernel.org>
parent fe833e43
Loading
Loading
Loading
Loading
+0 −49
Original line number Diff line number Diff line
Texas Instruments TAS5711/TAS5717/TAS5719/TAS5721 stereo power amplifiers

The codec is controlled through an I2C interface.  It also has two other
signals that can be wired up to GPIOs: reset (strongly recommended), and
powerdown (optional).

Required properties:

- compatible: should be one of the following:
  - "ti,tas5707"
  - "ti,tas5711",
  - "ti,tas5717",
  - "ti,tas5719",
  - "ti,tas5721"
  - "ti,tas5733"
- reg: The I2C address of the device
- #sound-dai-cells: must be equal to 0

Optional properties:

- reset-gpios: GPIO specifier for the TAS571x's active low reset line
- pdn-gpios: GPIO specifier for the TAS571x's active low powerdown line
- clocks: clock phandle for the MCLK input
- clock-names: should be "mclk"
- AVDD-supply: regulator phandle for the AVDD supply (all chips)
- DVDD-supply: regulator phandle for the DVDD supply (all chips)
- HPVDD-supply: regulator phandle for the HPVDD supply (5717/5719)
- PVDD_AB-supply: regulator phandle for the PVDD_AB supply (5717/5719)
- PVDD_CD-supply: regulator phandle for the PVDD_CD supply (5717/5719)
- PVDD_A-supply: regulator phandle for the PVDD_A supply (5711)
- PVDD_B-supply: regulator phandle for the PVDD_B supply (5711)
- PVDD_C-supply: regulator phandle for the PVDD_C supply (5711)
- PVDD_D-supply: regulator phandle for the PVDD_D supply (5711)
- DRVDD-supply: regulator phandle for the DRVDD supply (5721)
- PVDD-supply: regulator phandle for the PVDD supply (5721)

Example:

	tas5717: audio-codec@2a {
		compatible = "ti,tas5717";
		reg = <0x2a>;
		#sound-dai-cells = <0>;

		reset-gpios = <&gpio5 1 GPIO_ACTIVE_LOW>;
		pdn-gpios = <&gpio5 2 GPIO_ACTIVE_LOW>;

		clocks = <&clk_core CLK_I2S>;
		clock-names = "mclk";
	};
+133 −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/ti,tas57xx.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Texas Instruments TAS5711/TAS5717/TAS5719/TAS5721 stereo power amplifiers

maintainers:
  - Neil Armstrong <neil.armstrong@linaro.org>

properties:
  compatible:
    enum:
      - ti,tas5707
      - ti,tas5711
      - ti,tas5717
      - ti,tas5719
      - ti,tas5721
      - ti,tas5733

  reg:
    maxItems: 1

  reset-gpios:
    maxItems: 1
    description: GPIO for the active low reset line

  pdn-gpios:
    maxItems: 1
    description: GPIO for the active low powerdown line

  clocks:
    maxItems: 1

  clock-names:
    const: mclk

  AVDD-supply: true
  DVDD-supply: true
  HPVDD-supply: true
  PVDD_AB-supply: true
  PVDD_CD-supply: true
  PVDD_A-supply: true
  PVDD_B-supply: true
  PVDD_C-supply: true
  PVDD_D-supply: true
  DRVDD-supply: true
  PVDD-supply: true

  '#sound-dai-cells':
    const: 0

  port:
    $ref: audio-graph-port.yaml#
    unevaluatedProperties: false

required:
  - compatible
  - reg
  - '#sound-dai-cells'

allOf:
  - $ref: dai-common.yaml#
  - if:
      properties:
        compatible:
          contains:
            enum:
              - ti,tas5717
              - ti,tas5719
    then:
      properties:
        PVDD_A-supply: false
        PVDD_B-supply: false
        PVDD_C-supply: false
        PVDD_D-supply: false
        DRVDD-supply: false
        PVDD-supply: false

  - if:
      properties:
        compatible:
          contains:
            enum:
              - ti,tas5711
    then:
      properties:
        HPVDD-supply: false
        PVDD_AB-supply: false
        PVDD_CD-supply: false
        DRVDD-supply: false
        PVDD-supply: false

  - if:
      properties:
        compatible:
          contains:
            enum:
              - ti,tas5721
    then:
      properties:
        HPVDD-supply: false
        PVDD_AB-supply: false
        PVDD_CD-supply: false
        PVDD_A-supply: false
        PVDD_B-supply: false
        PVDD_C-supply: false
        PVDD_D-supply: false

unevaluatedProperties: false

examples:
  - |
   i2c {
     #address-cells = <1>;
     #size-cells = <0>;

     codec@2a {
       compatible = "ti,tas5717";
       reg = <0x2a>;
       #sound-dai-cells = <0>;
       reset-gpios = <&gpio1 15 0>;
       pdn-gpios = <&gpio1 15 0>;
       AVDD-supply = <&avdd_supply>;
       DVDD-supply = <&dvdd_supply>;
       HPVDD-supply = <&hpvdd_supply>;
       PVDD_AB-supply = <&pvdd_ab_supply>;
       PVDD_CD-supply = <&pvdd_cd_supply>;
     };
   };

...