xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/sound/tlv320aic31xx.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunTexas Instruments - tlv320aic31xx Codec module
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunThe tlv320aic31xx serial control bus communicates through I2C protocols
4*4882a593Smuzhiyun
5*4882a593SmuzhiyunRequired properties:
6*4882a593Smuzhiyun
7*4882a593Smuzhiyun- compatible - "string" - One of:
8*4882a593Smuzhiyun    "ti,tlv320aic310x" - Generic TLV320AIC31xx with mono speaker amp
9*4882a593Smuzhiyun    "ti,tlv320aic311x" - Generic TLV320AIC31xx with stereo speaker amp
10*4882a593Smuzhiyun    "ti,tlv320aic3100" - TLV320AIC3100 (mono speaker amp, no MiniDSP)
11*4882a593Smuzhiyun    "ti,tlv320aic3110" - TLV320AIC3110 (stereo speaker amp, no MiniDSP)
12*4882a593Smuzhiyun    "ti,tlv320aic3120" - TLV320AIC3120 (mono speaker amp, MiniDSP)
13*4882a593Smuzhiyun    "ti,tlv320aic3111" - TLV320AIC3111 (stereo speaker amp, MiniDSP)
14*4882a593Smuzhiyun    "ti,tlv320dac3100" - TLV320DAC3100 (no ADC, mono speaker amp, no MiniDSP)
15*4882a593Smuzhiyun    "ti,tlv320dac3101" - TLV320DAC3101 (no ADC, stereo speaker amp, no MiniDSP)
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun- reg - <int> -  I2C slave address
18*4882a593Smuzhiyun- HPVDD-supply, SPRVDD-supply, SPLVDD-supply, AVDD-supply, IOVDD-supply,
19*4882a593Smuzhiyun  DVDD-supply : power supplies for the device as covered in
20*4882a593Smuzhiyun  Documentation/devicetree/bindings/regulator/regulator.txt
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun
23*4882a593SmuzhiyunOptional properties:
24*4882a593Smuzhiyun
25*4882a593Smuzhiyun- reset-gpios - GPIO specification for the active low RESET input.
26*4882a593Smuzhiyun- ai31xx-micbias-vg - MicBias Voltage setting
27*4882a593Smuzhiyun        1 or MICBIAS_2_0V - MICBIAS output is powered to 2.0V
28*4882a593Smuzhiyun        2 or MICBIAS_2_5V - MICBIAS output is powered to 2.5V
29*4882a593Smuzhiyun        3 or MICBIAS_AVDD - MICBIAS output is connected to AVDD
30*4882a593Smuzhiyun	If this node is not mentioned or if the value is unknown, then
31*4882a593Smuzhiyun	micbias	is set to 2.0V.
32*4882a593Smuzhiyun- ai31xx-ocmv - output common-mode voltage setting
33*4882a593Smuzhiyun        0 - 1.35V,
34*4882a593Smuzhiyun        1 - 1.5V,
35*4882a593Smuzhiyun        2 - 1.65V,
36*4882a593Smuzhiyun        3 - 1.8V
37*4882a593Smuzhiyun
38*4882a593SmuzhiyunDeprecated properties:
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun- gpio-reset - gpio pin number used for codec reset
41*4882a593Smuzhiyun
42*4882a593SmuzhiyunCODEC output pins:
43*4882a593Smuzhiyun  * HPL
44*4882a593Smuzhiyun  * HPR
45*4882a593Smuzhiyun  * SPL, devices with stereo speaker amp
46*4882a593Smuzhiyun  * SPR, devices with stereo speaker amp
47*4882a593Smuzhiyun  * SPK, devices with mono speaker amp
48*4882a593Smuzhiyun  * MICBIAS
49*4882a593Smuzhiyun
50*4882a593SmuzhiyunCODEC input pins:
51*4882a593Smuzhiyun  * MIC1LP, devices with ADC
52*4882a593Smuzhiyun  * MIC1RP, devices with ADC
53*4882a593Smuzhiyun  * MIC1LM, devices with ADC
54*4882a593Smuzhiyun  * AIN1, devices without ADC
55*4882a593Smuzhiyun  * AIN2, devices without ADC
56*4882a593Smuzhiyun
57*4882a593SmuzhiyunThe pins can be used in referring sound node's audio-routing property.
58*4882a593Smuzhiyun
59*4882a593SmuzhiyunExample:
60*4882a593Smuzhiyun#include <dt-bindings/gpio/gpio.h>
61*4882a593Smuzhiyun#include <dt-bindings/sound/tlv320aic31xx-micbias.h>
62*4882a593Smuzhiyun
63*4882a593Smuzhiyuntlv320aic31xx: tlv320aic31xx@18 {
64*4882a593Smuzhiyun	compatible = "ti,tlv320aic311x";
65*4882a593Smuzhiyun	reg = <0x18>;
66*4882a593Smuzhiyun
67*4882a593Smuzhiyun	ai31xx-micbias-vg = <MICBIAS_OFF>;
68*4882a593Smuzhiyun
69*4882a593Smuzhiyun	reset-gpios = <&gpio1 17 GPIO_ACTIVE_LOW>;
70*4882a593Smuzhiyun
71*4882a593Smuzhiyun	HPVDD-supply = <&regulator>;
72*4882a593Smuzhiyun	SPRVDD-supply = <&regulator>;
73*4882a593Smuzhiyun	SPLVDD-supply = <&regulator>;
74*4882a593Smuzhiyun	AVDD-supply = <&regulator>;
75*4882a593Smuzhiyun	IOVDD-supply = <&regulator>;
76*4882a593Smuzhiyun	DVDD-supply = <&regulator>;
77*4882a593Smuzhiyun};
78