| 1 | Nuvoton NAU8825 audio codec |
| 2 | |
| 3 | This device supports I2C only. |
| 4 | |
| 5 | Required properties: |
| 6 | - compatible : Must be "nuvoton,nau8825" |
| 7 | |
| 8 | - reg : the I2C address of the device. This is either 0x1a (CSB=0) or 0x1b (CSB=1). |
| 9 | |
| 10 | Optional properties: |
| 11 | - nuvoton,jkdet-enable: Enable jack detection via JKDET pin. |
| 12 | - nuvoton,jkdet-pull-enable: Enable JKDET pin pull. If set - pin pull enabled, |
| 13 | otherwise pin in high impedance state. |
| 14 | - nuvoton,jkdet-pull-up: Pull-up JKDET pin. If set then JKDET pin is pull up, otherwise pull down. |
| 15 | - nuvoton,jkdet-polarity: JKDET pin polarity. 0 - active high, 1 - active low. |
| 16 | |
| 17 | - nuvoton,vref-impedance: VREF Impedance selection |
| 18 | 0 - Open |
| 19 | 1 - 25 kOhm |
| 20 | 2 - 125 kOhm |
| 21 | 3 - 2.5 kOhm |
| 22 | |
| 23 | - nuvoton,micbias-voltage: Micbias voltage level. |
| 24 | 0 - VDDA |
| 25 | 1 - VDDA |
| 26 | 2 - VDDA * 1.1 |
| 27 | 3 - VDDA * 1.2 |
| 28 | 4 - VDDA * 1.3 |
| 29 | 5 - VDDA * 1.4 |
| 30 | 6 - VDDA * 1.53 |
| 31 | 7 - VDDA * 1.53 |
| 32 | |
| 33 | - nuvoton,sar-threshold-num: Number of buttons supported |
| 34 | - nuvoton,sar-threshold: Impedance threshold for each button. Array that contains up to 8 buttons configuration. SAR value is calculated as |
| 35 | SAR = 255 * MICBIAS / SAR_VOLTAGE * R / (2000 + R) |
| 36 | where MICBIAS is configured by 'nuvoton,micbias-voltage', SAR_VOLTAGE is configured by 'nuvoton,sar-voltage', R - button impedance. |
| 37 | Refer datasheet section 10.2 for more information about threshold calculation. |
| 38 | |
| 39 | - nuvoton,sar-hysteresis: Button impedance measurement hysteresis. |
| 40 | |
| 41 | - nuvoton,sar-voltage: Reference voltage for button impedance measurement. |
| 42 | 0 - VDDA |
| 43 | 1 - VDDA |
| 44 | 2 - VDDA * 1.1 |
| 45 | 3 - VDDA * 1.2 |
| 46 | 4 - VDDA * 1.3 |
| 47 | 5 - VDDA * 1.4 |
| 48 | 6 - VDDA * 1.53 |
| 49 | 7 - VDDA * 1.53 |
| 50 | |
| 51 | - nuvoton,sar-compare-time: SAR compare time |
| 52 | 0 - 500 ns |
| 53 | 1 - 1 us |
| 54 | 2 - 2 us |
| 55 | 3 - 4 us |
| 56 | |
| 57 | - nuvoton,sar-sampling-time: SAR sampling time |
| 58 | 0 - 2 us |
| 59 | 1 - 4 us |
| 60 | 2 - 8 us |
| 61 | 3 - 16 us |
| 62 | |
| 63 | - nuvoton,short-key-debounce: Button short key press debounce time. |
| 64 | 0 - 30 ms |
| 65 | 1 - 50 ms |
| 66 | 2 - 100 ms |
| 67 | 3 - 30 ms |
| 68 | |
| 69 | - nuvoton,jack-insert-debounce: number from 0 to 7 that sets debounce time to 2^(n+2) ms |
| 70 | - nuvoton,jack-eject-debounce: number from 0 to 7 that sets debounce time to 2^(n+2) ms |
| 71 | |
| 72 | - clocks: list of phandle and clock specifier pairs according to common clock bindings for the |
| 73 | clocks described in clock-names |
| 74 | - clock-names: should include "mclk" for the MCLK master clock |
| 75 | |
| 76 | Example: |
| 77 | |
| 78 | headset: nau8825@1a { |
| 79 | compatible = "nuvoton,nau8825"; |
| 80 | reg = <0x1a>; |
| 81 | interrupt-parent = <&gpio>; |
| 82 | interrupts = <TEGRA_GPIO(E, 6) IRQ_TYPE_LEVEL_LOW>; |
| 83 | nuvoton,jkdet-enable; |
| 84 | nuvoton,jkdet-pull-enable; |
| 85 | nuvoton,jkdet-pull-up; |
| 86 | nuvoton,jkdet-polarity = <GPIO_ACTIVE_LOW>; |
| 87 | nuvoton,vref-impedance = <2>; |
| 88 | nuvoton,micbias-voltage = <6>; |
| 89 | // Setup 4 buttons impedance according to Android specification |
| 90 | nuvoton,sar-threshold-num = <4>; |
| 91 | nuvoton,sar-threshold = <0xc 0x1e 0x38 0x60>; |
| 92 | nuvoton,sar-hysteresis = <1>; |
| 93 | nuvoton,sar-voltage = <0>; |
| 94 | nuvoton,sar-compare-time = <0>; |
| 95 | nuvoton,sar-sampling-time = <0>; |
| 96 | nuvoton,short-key-debounce = <2>; |
| 97 | nuvoton,jack-insert-debounce = <7>; |
| 98 | nuvoton,jack-eject-debounce = <7>; |
| 99 | |
| 100 | clock-names = "mclk"; |
| 101 | clocks = <&tegra_car TEGRA210_CLK_CLK_OUT_2>; |
| 102 | }; |