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