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