Merge tag 'cris-for-4.9' of git://git.kernel.org/pub/scm/linux/kernel/git/jesper...
[cascardo/linux.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
16 - reg - <int> -  I2C slave address
17 - HPVDD-supply, SPRVDD-supply, SPLVDD-supply, AVDD-supply, IOVDD-supply,
18   DVDD-supply : power supplies for the device as covered in
19   Documentation/devicetree/bindings/regulator/regulator.txt
20
21
22 Optional properties:
23
24 - gpio-reset - gpio pin number used for codec reset
25 - ai31xx-micbias-vg - MicBias Voltage setting
26         1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
27         2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
28         3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
29         If this node is not mentioned or if the value is unknown, then
30         micbias is set to 2.0V.
31
32 CODEC output pins:
33   * HPL
34   * HPR
35   * SPL, devices with stereo speaker amp
36   * SPR, devices with stereo speaker amp
37   * SPK, devices with mono speaker amp
38   * MICBIAS
39
40 CODEC input pins:
41   * MIC1LP, devices with ADC
42   * MIC1RP, devices with ADC
43   * MIC1LM, devices with ADC
44   * AIN1, devices without ADC
45   * AIN2, devices without ADC
46
47 The pins can be used in referring sound node's audio-routing property.
48
49 Example:
50 #include <dt-bindings/sound/tlv320aic31xx-micbias.h>
51
52 tlv320aic31xx: tlv320aic31xx@18 {
53         compatible = "ti,tlv320aic311x";
54         reg = <0x18>;
55
56         ai31xx-micbias-vg = <MICBIAS_OFF>;
57
58         HPVDD-supply = <&regulator>;
59         SPRVDD-supply = <&regulator>;
60         SPLVDD-supply = <&regulator>;
61         AVDD-supply = <&regulator>;
62         IOVDD-supply = <&regulator>;
63         DVDD-supply = <&regulator>;
64 };