Merge remote-tracking branches 'spi/fix/dw', 'spi/fix/lantiq' and 'spi/fix/pl022...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / sound / tlv320aic31xx.txt
1 Texas Instruments - tlv320aic31xx Codec module
2
3 The tlv320aic31xx serial control bus communicates through I2C protocols
4
5 Required properties:
6
7 - compatible - "string" - One of:
8     "ti,tlv320aic310x" - Generic TLV320AIC31xx with mono speaker amp
9     "ti,tlv320aic311x" - Generic TLV320AIC31xx with stereo speaker amp
10     "ti,tlv320aic3100" - TLV320AIC3100 (mono speaker amp, no MiniDSP)
11     "ti,tlv320aic3110" - TLV320AIC3110 (stereo speaker amp, no MiniDSP)
12     "ti,tlv320aic3120" - TLV320AIC3120 (mono speaker amp, MiniDSP)
13     "ti,tlv320aic3111" - TLV320AIC3111 (stereo speaker amp, MiniDSP)
14     "ti,tlv320dac3100" - TLV320DAC3100 (no ADC, mono speaker amp, no MiniDSP)
15     "ti,tlv320dac3101" - TLV320DAC3101 (no ADC, stereo speaker amp, no MiniDSP)
16
17 - reg - <int> -  I2C slave address
18 - HPVDD-supply, SPRVDD-supply, SPLVDD-supply, AVDD-supply, IOVDD-supply,
19   DVDD-supply : power supplies for the device as covered in
20   Documentation/devicetree/bindings/regulator/regulator.txt
21
22
23 Optional properties:
24
25 - gpio-reset - gpio pin number used for codec reset
26 - ai31xx-micbias-vg - MicBias Voltage setting
27         1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
28         2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
29         3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
30         If this node is not mentioned or if the value is unknown, then
31         micbias is set to 2.0V.
32
33 CODEC output pins:
34   * HPL
35   * HPR
36   * SPL, devices with stereo speaker amp
37   * SPR, devices with stereo speaker amp
38   * SPK, devices with mono speaker amp
39   * MICBIAS
40
41 CODEC input pins:
42   * MIC1LP, devices with ADC
43   * MIC1RP, devices with ADC
44   * MIC1LM, devices with ADC
45   * AIN1, devices without ADC
46   * AIN2, devices without ADC
47
48 The pins can be used in referring sound node's audio-routing property.
49
50 Example:
51 #include <dt-bindings/sound/tlv320aic31xx-micbias.h>
52
53 tlv320aic31xx: tlv320aic31xx@18 {
54         compatible = "ti,tlv320aic311x";
55         reg = <0x18>;
56
57         ai31xx-micbias-vg = <MICBIAS_OFF>;
58
59         HPVDD-supply = <&regulator>;
60         SPRVDD-supply = <&regulator>;
61         SPLVDD-supply = <&regulator>;
62         AVDD-supply = <&regulator>;
63         IOVDD-supply = <&regulator>;
64         DVDD-supply = <&regulator>;
65 };