Commit | Line | Data |
---|---|---|
b29759ee AT |
1 | Dialog Semiconductor DA7219 Audio Codec bindings |
2 | ||
3 | DA7219 is an audio codec with advanced accessory detect features. | |
4 | ||
5 | ====== | |
6 | ||
7 | Required properties: | |
8 | - compatible : Should be "dlg,da7219" | |
9 | - reg: Specifies the I2C slave address | |
10 | ||
11 | - interrupt-parent : Specifies the phandle of the interrupt controller to which | |
12 | the IRQs from DA7219 are delivered to. | |
13 | - interrupts : IRQ line info for DA7219. | |
14 | (See Documentation/devicetree/bindings/interrupt-controller/interrupts.txt for | |
15 | further information relating to interrupt properties) | |
16 | ||
17 | - VDD-supply: VDD power supply for the device | |
18 | - VDDMIC-supply: VDDMIC power supply for the device | |
19 | - VDDIO-supply: VDDIO power supply for the device | |
20 | (See Documentation/devicetree/bindings/regulator/regulator.txt for further | |
21 | information relating to regulators) | |
22 | ||
23 | Optional properties: | |
24 | - interrupt-names : Name associated with interrupt line. Should be "wakeup" if | |
25 | interrupt is to be used to wake system, otherwise "irq" should be used. | |
26 | - wakeup-source: Flag to indicate this device can wake system (suspend/resume). | |
27 | ||
28 | - clocks : phandle and clock specifier for codec MCLK. | |
29 | - clock-names : Clock name string for 'clocks' attribute, should be "mclk". | |
30 | ||
b29759ee | 31 | - dlg,micbias-lvl : Voltage (mV) for Mic Bias |
0aed64c1 | 32 | [<1600>, <1800>, <2000>, <2200>, <2400>, <2600>] |
b29759ee AT |
33 | - dlg,mic-amp-in-sel : Mic input source type |
34 | ["diff", "se_p", "se_n"] | |
35 | ||
d8ef140d AT |
36 | Deprecated properties: |
37 | - dlg,ldo-lvl : Required internal LDO voltage (mV) level for digital engine | |
38 | (LDO unavailable in production HW so property no longer required). | |
39 | ||
b29759ee AT |
40 | ====== |
41 | ||
42 | Child node - 'da7219_aad': | |
43 | ||
44 | Optional properties: | |
45 | - dlg,micbias-pulse-lvl : Mic bias higher voltage pulse level (mV). | |
46 | [<2800>, <2900>] | |
47 | - dlg,micbias-pulse-time : Mic bias higher voltage pulse duration (ms) | |
48 | - dlg,btn-cfg : Periodic button press measurements for 4-pole jack (ms) | |
49 | [<2>, <5>, <10>, <50>, <100>, <200>, <500>] | |
50 | - dlg,mic-det-thr : Impedance threshold for mic detection measurement (Ohms) | |
51 | [<200>, <500>, <750>, <1000>] | |
52 | - dlg,jack-ins-deb : Debounce time for jack insertion (ms) | |
53 | [<5>, <10>, <20>, <50>, <100>, <200>, <500>, <1000>] | |
54 | - dlg,jack-det-rate: Jack type detection latency (3/4 pole) | |
55 | ["32ms_64ms", "64ms_128ms", "128ms_256ms", "256ms_512ms"] | |
56 | - dlg,jack-rem-deb : Debounce time for jack removal (ms) | |
57 | [<1>, <5>, <10>, <20>] | |
58 | - dlg,a-d-btn-thr : Impedance threshold between buttons A and D | |
59 | [0x0 - 0xFF] | |
60 | - dlg,d-b-btn-thr : Impedance threshold between buttons D and B | |
61 | [0x0 - 0xFF] | |
62 | - dlg,b-c-btn-thr : Impedance threshold between buttons B and C | |
63 | [0x0 - 0xFF] | |
64 | - dlg,c-mic-btn-thr : Impedance threshold between button C and Mic | |
65 | [0x0 - 0xFF] | |
66 | - dlg,btn-avg : Number of 8-bit readings for averaged button measurement | |
67 | [<1>, <2>, <4>, <8>] | |
68 | - dlg,adc-1bit-rpt : Repeat count for 1-bit button measurement | |
69 | [<1>, <2>, <4>, <8>] | |
70 | ||
71 | ====== | |
72 | ||
73 | Example: | |
74 | ||
75 | codec: da7219@1a { | |
76 | compatible = "dlg,da7219"; | |
77 | reg = <0x1a>; | |
78 | ||
79 | interrupt-parent = <&gpio6>; | |
80 | interrupts = <11 IRQ_TYPE_LEVEL_HIGH>; | |
81 | ||
82 | VDD-supply = <®_audio>; | |
83 | VDDMIC-supply = <®_audio>; | |
84 | VDDIO-supply = <®_audio>; | |
85 | ||
86 | clocks = <&clks 201>; | |
87 | clock-names = "mclk"; | |
88 | ||
89 | dlg,ldo-lvl = <1200>; | |
90 | dlg,micbias-lvl = <2600>; | |
91 | dlg,mic-amp-in-sel = "diff"; | |
92 | ||
93 | da7219_aad { | |
94 | dlg,btn-cfg = <50>; | |
95 | dlg,mic-det-thr = <500>; | |
96 | dlg,jack-ins-deb = <20>; | |
97 | dlg,jack-det-rate = "32ms_64ms"; | |
98 | dlg,jack-rem-deb = <1>; | |
99 | ||
100 | dlg,a-d-btn-thr = <0xa>; | |
101 | dlg,d-b-btn-thr = <0x16>; | |
102 | dlg,b-c-btn-thr = <0x21>; | |
103 | dlg,c-mic-btn-thr = <0x3E>; | |
104 | ||
105 | dlg,btn-avg = <4>; | |
106 | dlg,adc-1bit-rpt = <1>; | |
107 | }; | |
108 | }; |