Dialog DA7219 audio codec

DA7219 codec 개요

이 YAML binding은 GPL-2.0-only 또는 BSD-2-Clause로 배포되며 Dialog Semiconductor DA7219 audio codec을 정의합니다. Schema ID는 `http://devicetree.org/schemas/sound/dialog,da7219.yaml#`이고 core meta-schema를 사용하며 maintainer는 David Rau입니다.

DA7219는 mobile computing과 accessory application을 위한 advanced accessory detection(AAD)을 내장한 초저전력 audio codec입니다. 24-bit 해상도에서 최대 96 kHz sample rate를 지원합니다.

주소, 전원과 interrupt

`compatible`은 `dlg,da7219`로 고정되고 `reg`와 `interrupts`는 각각 최대 한 항목입니다. `VDD-supply`, `VDDMIC-supply`, `VDDIO-supply`는 각각 장치의 VDD, VDDMIC, VDDIO 전원 공급을 참조합니다.

`interrupt-names`는 interrupt로 system을 깨울 때 `wakeup`, 그 밖에는 `irq`를 사용합니다. Boolean `wakeup-source`는 이 장치가 suspend/resume 과정에서 system을 깨울 수 있음을 나타냅니다.

DAI clock 출력과 MCLK

`#clock-cells`는 1입니다. `clock-output-names`는 정확히 두 이름을 가지며 DAI WCLK와 BCLK 출력에 붙일 이름입니다.

`clocks`는 codec MCLK의 phandle과 clock specifier 한 항목을 가지며 `clock-names`는 `mclk`로 고정됩니다.

Mic bias와 입력 선택

`dlg,micbias-lvl`은 mic bias 전압을 mV로 지정하는 `uint32`이며 1600, 1800, 2000, 2200, 2400, 2600 중 하나입니다.

`dlg,mic-amp-in-sel`은 microphone 입력 source 유형을 지정하는 문자열입니다. `diff`는 differential 입력, `se_p`는 positive differential analog microphone input인 `MIC_P`, `se_n`은 negative differential analog microphone input인 `MIC_N`을 뜻합니다.

AAD와 mic bias pulse

`da7219_aad` 하위 object는 advanced accessory detection 설정이며 정의되지 않은 추가 속성을 허용하지 않습니다. `dlg,micbias-pulse-lvl`은 높은 mic bias pulse 전압으로 2800 또는 2900 mV입니다.

`dlg,micbias-pulse-time`은 높은 mic bias pulse 지속 시간(ms)을 나타내는 0 이상의 `uint32`입니다. `dlg,btn-cfg`는 4-pole jack의 주기적 button press 측정 간격(ms)으로 2, 5, 10, 50, 100, 200, 500 중 하나입니다.

Microphone과 jack 감지

`dlg,mic-det-thr`은 microphone 감지 측정의 impedance threshold(Ohms)이며 200, 500, 750, 1000 중 하나입니다. `dlg,jack-ins-deb`는 jack 삽입 debounce 시간(ms)으로 5, 10, 20, 50, 100, 200, 500, 1000 중 하나입니다.

`dlg,jack-ins-det-pty`는 jack insertion detection polarity로 `low` 또는 `high`입니다. `dlg,jack-det-rate`는 3-pole/4-pole jack type 감지 latency(ms)를 나타내며 `32_64`, `64_128`, `128_256`, `256_512` 중 하나입니다.

`dlg,jack-rem-deb`는 jack 제거 debounce 시간(ms)으로 1, 5, 10, 20 중 하나입니다.

Button impedance 경계와 평균

`dlg,a-d-btn-thr`, `dlg,d-b-btn-thr`, `dlg,b-c-btn-thr`, `dlg,c-mic-btn-thr`은 각각 button A-D, D-B, B-C, C-Mic 사이의 impedance threshold입니다. 네 값은 모두 0~255 범위의 `uint32`입니다.

`dlg,btn-avg`는 평균 button 측정에 사용할 8-bit reading 수이며 1, 2, 4, 8 중 하나입니다. `dlg,adc-1bit-rpt`는 1-bit button 측정의 repeat count이며 역시 1, 2, 4, 8 중 하나입니다.

필수 속성과 하위 노드 제한

최상위 필수 속성은 `compatible`, `reg`, `interrupts`, `VDD-supply`, `VDDMIC-supply`, `VDDIO-supply`입니다. `additionalProperties: false`이므로 이 binding에 정의되지 않은 최상위 속성은 허용하지 않습니다.

I2C codec과 AAD 구성 예제

예제는 I2C address `0x1a`의 DA7219에 GPIO6의 active-low interrupt, 세 전원 rail, DAI WCLK/BCLK 출력, `mclk`를 연결합니다. Mic bias는 2600 mV, microphone 입력은 differential로 설정합니다.

`da7219_aad` 하위 노드는 button 측정 주기, microphone threshold, jack 삽입·제거 debounce와 polarity, jack detection rate, 네 button impedance 경계, averaging과 1-bit repeat count를 구체적으로 설정합니다.

#include <dt-bindings/interrupt-controller/irq.h>
i2c {
  #address-cells = <1>;
  #size-cells = <0>;

  codec: da7219@1a {
      compatible = "dlg,da7219";
      reg = <0x1a>;

      interrupt-parent = <&gpio6>;
      interrupts = <11 IRQ_TYPE_LEVEL_LOW>;

      VDD-supply = <&vdd_reg>;
      VDDMIC-supply = <&vddmic_reg>;
      VDDIO-supply = <&vddio_reg>;

      #clock-cells = <1>;
      clock-output-names = "da7219-dai-wclk", "da7219-dai-bclk";

      clocks = <&clks 201>;
      clock-names = "mclk";

      dlg,micbias-lvl = <2600>;
      dlg,mic-amp-in-sel = "diff";

      da7219_aad {
          dlg,btn-cfg = <50>;
          dlg,mic-det-thr = <500>;
          dlg,jack-ins-deb = <20>;
          dlg,jack-ins-det-pty = "low";
          dlg,jack-det-rate = "32_64";
          dlg,jack-rem-deb = <1>;

          dlg,a-d-btn-thr = <0xa>;
          dlg,d-b-btn-thr = <0x16>;
          dlg,b-c-btn-thr = <0x21>;
          dlg,c-mic-btn-thr = <0x3E>;

          dlg,btn-avg = <4>;
          dlg,adc-1bit-rpt = <1>;
      };
  };
};