Merge tag 'kbuild-misc-v4.15' of git://git.kernel.org/pub/scm/linux/kernel/git/masahi...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / sound / rt5663.txt
1 RT5663 audio CODEC
2
3 This device supports I2C only.
4
5 Required properties:
6
7 - compatible : "realtek,rt5663".
8
9 - reg : The I2C address of the device.
10
11 - interrupts : The CODEC's interrupt output.
12
13 Optional properties:
14
15 - "realtek,dc_offset_l_manual"
16 - "realtek,dc_offset_r_manual"
17 - "realtek,dc_offset_l_manual_mic"
18 - "realtek,dc_offset_r_manual_mic"
19   Based on the different PCB layout, add the manual offset value to
20   compensate the DC offset for each L and R channel, and they are different
21   between headphone and headset.
22 - "realtek,impedance_sensing_num"
23   The matrix row number of the impedance sensing table.
24   If the value is 0, it means the impedance sensing is not supported.
25 - "realtek,impedance_sensing_table"
26   The matrix rows of the impedance sensing table are consisted by impedance
27   minimum, impedance maximun, volume, DC offset w/o and w/ mic of each L and
28   R channel accordingly. Example is shown as following.
29   <   0    300  7  0xffd160  0xffd1c0  0xff8a10  0xff8ab0
30     301  65535  4  0xffe470  0xffe470  0xffb8e0  0xffb8e0>
31   The first and second column are defined for the impedance range. If the
32   detected impedance value is in the range, then the volume value of the
33   third column will be set to codec. In our codec design, each volume value
34   should compensate different DC offset to avoid the pop sound, and it is
35   also different between headphone and headset. In the example, the
36   "realtek,impedance_sensing_num" is 2. It means that there are 2 ranges of
37   impedance in the impedance sensing function.
38
39 Pins on the device (for linking into audio routes) for RT5663:
40
41   * IN1P
42   * IN1N
43   * IN2P
44   * IN2N
45   * HPOL
46   * HPOR
47
48 Example:
49
50 codec: rt5663@12 {
51         compatible = "realtek,rt5663";
52         reg = <0x12>;
53         interrupts = <7 IRQ_TYPE_EDGE_FALLING>;
54 };