xref: /linux/Documentation/devicetree/bindings/sound/ti,tlv320dac3100.yaml (revision 2fe3c78a2c26dd5ee811024a1b7d6cfb4d654319) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/sound/ti,tlv320dac3100.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Texas Instruments - tlv320aic31xx Codec module
8
9maintainers:
10  - Shenghao Ding <shenghao-ding@ti.com>
11
12description: |
13  CODEC output pins:
14    * HPL
15    * HPR
16    * SPL, devices with stereo speaker amp
17    * SPR, devices with stereo speaker amp
18    * SPK, devices with mono speaker amp
19    * MICBIAS
20
21  CODEC input pins:
22    * MIC1LP, devices with ADC
23    * MIC1RP, devices with ADC
24    * MIC1LM, devices with ADC
25    * AIN1, devices without ADC
26    * AIN2, devices without ADC
27
28  The pins can be used in referring sound node's audio-routing property.
29
30properties:
31  compatible:
32    enum:
33      - ti,tlv320aic310x # - Generic TLV320AIC31xx with mono speaker amp
34      - ti,tlv320aic311x # - Generic TLV320AIC31xx with stereo speaker amp
35      - ti,tlv320aic3100 # - TLV320AIC3100 (mono speaker amp, no MiniDSP)
36      - ti,tlv320aic3110 # - TLV320AIC3110 (stereo speaker amp, no MiniDSP)
37      - ti,tlv320aic3120 # - TLV320AIC3120 (mono speaker amp, MiniDSP)
38      - ti,tlv320aic3111 # - TLV320AIC3111 (stereo speaker amp, MiniDSP)
39      - ti,tlv320dac3100 # - TLV320DAC3100 (no ADC, mono speaker amp, no MiniDSP)
40      - ti,tlv320dac3101 # - TLV320DAC3101 (no ADC, stereo speaker amp, no MiniDSP)
41
42  reg:
43    maxItems: 1
44
45  '#sound-dai-cells':
46    const: 0
47
48  HPVDD-supply: true
49
50  SPRVDD-supply: true
51
52  SPLVDD-supply: true
53
54  AVDD-supply: true
55
56  IOVDD-supply: true
57
58  DVDD-supply: true
59
60  reset-gpios:
61    description: GPIO specification for the active low RESET input.
62
63  ai31xx-micbias-vg:
64    $ref: /schemas/types.yaml#/definitions/uint32
65    default: 1
66    enum: [1, 2, 3]
67    description: |
68      MicBias Voltage setting
69        1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
70        2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
71        3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
72
73  ai31xx-ocmv:
74    $ref: /schemas/types.yaml#/definitions/uint32
75    enum: [0, 1, 2, 3]
76    description: |
77      output common-mode voltage setting
78        0 - 1.35V,
79        1 - 1.5V,
80        2 - 1.65V,
81        3 - 1.8V
82
83  gpio-reset:
84    description: gpio pin number used for codec reset
85    deprecated: true
86
87
88required:
89  - compatible
90  - reg
91  - HPVDD-supply
92  - SPRVDD-supply
93  - SPLVDD-supply
94  - AVDD-supply
95  - IOVDD-supply
96  - DVDD-supply
97
98allOf:
99  - $ref: dai-common.yaml#
100
101unevaluatedProperties: false
102
103examples:
104  - |
105    #include <dt-bindings/gpio/gpio.h>
106    #include <dt-bindings/sound/tlv320aic31xx.h>
107
108    i2c {
109        #address-cells = <1>;
110        #size-cells = <0>;
111
112        sound@18 {
113            compatible = "ti,tlv320aic311x";
114            reg = <0x18>;
115
116            ai31xx-micbias-vg = <MICBIAS_2_0V>;
117            reset-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>;
118
119            HPVDD-supply = <&regulator>;
120            SPRVDD-supply = <&regulator>;
121            SPLVDD-supply = <&regulator>;
122            AVDD-supply = <&regulator>;
123            IOVDD-supply = <&regulator>;
124            DVDD-supply = <&regulator>;
125       };
126    };
127
128