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 - 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
  31 - dlg,micbias-lvl : Voltage (mV) for Mic Bias
  32         [<1600>, <1800>, <2000>, <2200>, <2400>, <2600>]
  33 - dlg,mic-amp-in-sel : Mic input source type
  34         ["diff", "se_p", "se_n"]
  35
  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
  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 = <&reg_audio>;
  83                 VDDMIC-supply = <&reg_audio>;
  84                 VDDIO-supply = <&reg_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         };