Cirrus CS35L33 speaker amplifier

CS35L33 필수 속성

CS35L33 스피커 증폭기의 `compatible` 값은 `cirrus,cs35l33`입니다. `reg`에는 I2C 장치 주소를 지정합니다.

`VA-supply`와 `VP-supply`는 장치 전원 공급 장치를 가리키며, `Documentation/devicetree/bindings/regulator/regulator.txt`의 규칙을 따릅니다.

Reset, IRQ와 boost 전압

선택 속성 `reset-gpios`는 증폭기를 reset하는 GPIO이고, `interrupts`는 CS35L33의 IRQ 선 정보입니다. Interrupt 속성에 관한 자세한 내용은 `Documentation/devicetree/bindings/interrupt-controller/interrupts.txt`를 참조합니다.

`cirrus,boost-ctl`은 증폭기에 공급할 booster 전압을 정합니다. 값이 0이면 `VBST = VP`이고, 0보다 크면 값 1에서 3300mV로 시작하여 단계마다 100mV씩 증가하며 최대 8000mV까지 설정됩니다.

Ramp 시간, boost 전류와 IMON 배치

`cirrus,ramp-rate`는 전원을 켤 때 power-up sequence 시작부터 audio가 full-scale output에 도달할 때까지의 시간과, 전원을 끌 때 power-down sequence 시작부터 증폭기가 PWM output을 비활성화할 때까지의 시간에 영향을 줍니다. 속성이 없으면 soft ramping이 비활성화되고 ramp time은 20ms입니다. 48KHz sample rate에서 값 0, 1, 2, 3은 각각 40ms, 60ms, 100ms, 175ms에 대응합니다.

`cirrus,boost-ipk`는 boost converter의 최대 허용 전류입니다. 범위는 1850000uA부터 3600000uA까지이고 단계 크기는 15625uA이며 기본값은 2500000uA입니다.

`cirrus,imon-adc-scale`은 IMON ADC data word에서 data bit의 배치를 정합니다. 값 0은 bit 15:0, 6은 21:6, 7은 22:7, 8은 23:8을 선택합니다.

Class H/G 알고리즘 하위 노드

CS35L33 노드에는 내부 H/G Algorithm을 활성화하는 `cirrus,hg-algo` 하위 노드를 하나 둘 수 있습니다. 이 하위 노드는 증폭기 전원 공급을 제어하는 내부 Class H/G algorithm을 나타냅니다.

H/G memory와 LDO 전환

`cirrus,mem-depth`는 LRCLK cycle 단위의 Class H/G algorithm memory depth입니다. 값 0, 1, 2, 3은 각각 1, 4, 8, 16 LRCLK cycle이고 기본값은 16 cycle입니다.

`cirrus,release-rate`는 release condition tracking update를 허용하기 전에 연속으로 지나야 하는 LRCLK period 수이며, 3부터 최대 255까지 설정합니다.

`cirrus,ldo-thld`는 PWM output stage가 LDO operation에 들어가는 signal threshold를 설정합니다. 값 1은 기본 50mV이고 단계마다 50mV씩 증가하여 값 `0xF`에서 최대 750mV가 됩니다.

Boolean 속성 `cirrus,ldo-path-disable`이 있으면 H/G algorithm은 max detection path를 사용하고, 없으면 LDO detection path를 사용합니다.

`cirrus,ldo-entry-delay`는 H/G algorithm이 LDO voltage로 전환하기 전의 millisecond 단위 지연입니다. 값 0~7은 5ms, 10ms, 50ms, 100ms, 200ms, 500ms, 1000ms 지연을 선택하며 기본값은 100ms입니다.

VPhg 자동 추적

Boolean 속성 `cirrus,vp-hg-auto`를 설정하면 Class H/G VPhg 자동 갱신이 활성화됩니다.

`cirrus,vp-hg`는 boosted VBST 생성을 시작할 VP voltage 기준을 제어합니다. 기준 전압은 값 `0x3`의 3000mV에서 시작해 단계마다 100mV씩 증가하며 최대 5500mV입니다.

`cirrus,vp-hg-rate`는 VPhg 자동 추적 중 더 높은 전압으로 올릴 수 있는 주기를 LRCLK period 수로 정합니다. 값 0~3은 각각 128, 2048, 32768, 524288 period이고 기본값은 32768 period입니다.

`cirrus,vp-hg-va`는 VPMON을 사용하는 자동 VPhg 추적의 VA 계산 기준입니다. 원문은 값 0~6이 1800mV에서 50mV 단계로 시작해 최대 1750mV라고 설명하며 기본값을 1800mV로 지정합니다.

CS35L33 예제

예제는 I2C 주소 `0x40`, VA·VP regulator, level-low interrupt와 reset GPIO를 지정합니다. Ramp, 8000mV VBST, 3600mA peak current와 IMON bit 배치를 설정하고 `cirrus,hg-algo` 하위 노드에서 memory depth, release rate, LDO와 VPhg 추적 값을 구성합니다.

cs35l33: cs35l33@40 {
        compatible = "cirrus,cs35l33";
        reg = <0x40>;

        VA-supply = <&ldo5_reg>;
        VP-supply = <&ldo5_reg>;

        interrupt-parent = <&gpio8>;
        interrupts = <3 IRQ_TYPE_LEVEL_LOW>;

        reset-gpios = <&cs47l91 34 0>;

        cirrus,ramp-rate = <0x0>;
        cirrus,boost-ctl = <0x30>;  /* VBST = 8000mV */
        cirrus,boost-ipk = <0xE0>; /* 3600mA */
        cirrus,imon-adc-scale = <0> /* Bits 15 down to 0 */

        cirrus,hg-algo {
                cirrus,mem-depth = <0x3>;
                cirrus,release-rate = <0x3>;
                cirrus,ldo-thld = <0x1>;
                cirrus,ldo-path-disable = <0x0>;
                cirrus,ldo-entry-delay=<0x4>;
                cirrus,vp-hg-auto;
                cirrus,vp-hg=<0xF>;
                cirrus,vp-hg-rate=<0x2>;
                cirrus,vp-hg-va=<0x0>;
        };
};