Cirrus CS35L36 speaker amplifier

CS35L36 필수 속성과 boost

CS35L36 speaker amplifier의 `compatible` 값은 `cirrus,cs35l36`이고 `reg`에는 I2C 장치 주소를 지정합니다. `VA-supply`와 `VP-supply`는 `Documentation/devicetree/bindings/regulator/regulator.txt`에 정의된 전원 공급 장치를 가리킵니다.

`cirrus,boost-ctl-millivolt`는 boost converter output voltage를 2550mV부터 12000mV까지 50mV 단위로 설정하며 기본값은 VP입니다.

`cirrus,boost-peak-milliamp`는 boost FET 전류를 감시해 peak current limit를 설정합니다. 1600mA부터 최대 4500mA까지 50mA 단위로 증가하며 기본값은 4.50A입니다.

`cirrus,boost-ind-nanohenry`는 digital boost converter의 inductor estimation block에 초기 inductance reference를 제공합니다. 값 1000은 기본 1uH, 값 1200은 1.2uH입니다.

Multi-amp와 boost control source

Boolean `cirrus,multi-amp-mode`는 시스템에 amplifier가 둘 이상 있음을 나타냅니다. 여러 장치가 있으면 output signal의 bus contention을 막기 위해 ASP port를 Hi-Z로 두는 것이 좋습니다.

`cirrus,boost-ctl-select`는 boost converter가 생성할 target VBST voltage의 제어 source를 선택합니다. 값 `0x00`은 Control Port Value, 기본값 `0x01`은 Class H Tracking, `0x10`은 MultiDevice Sync Value입니다.

Boolean `cirrus,amp-pcm-inv`는 들어오는 PCM data를 반전하고, `cirrus,imon-pol-inv`와 `cirrus,vmon-pol-inv`는 각각 외부로 보내는 IMON·VMON feedback data의 polarity를 반전합니다.

`cirrus,dcm-mode-enable`은 부하가 낮을 때 digital boost converter가 저전력 DCM(Discontinuous Conduction Mode)으로 자동 동작하도록 합니다.

Weak-FET 동작

Boolean `cirrus,weak-fet-disable`은 Weak-FET Drive Mode와 관련됩니다. 이 mode에서는 output driver strength가 줄어들므로 큰 부하를 구동하는 데 사용하면 안 됩니다.

`cirrus,classh-wk-fet-delay`는 audio가 `WKFET_AMP_THLD` 아래로 내려가 유지된 뒤 Class H algorithm이 weak-FET voltage로 전환하기 전의 지연입니다. 값 0~7은 각각 0ms, 5ms, 10ms, 50ms, 기본 100ms, 200ms, 500ms, 1000ms입니다.

`cirrus,classh-weak-fet-thld-millivolt`는 PWM output stage가 weak-FET operation에 들어가는 signal threshold이며 50mV부터 700mV까지 50mV 단위입니다.

온도 경고와 interrupt 출력

`cirrus,temp-warn-threshold`는 amplifier overtemperature warning threshold입니다. 임계값에 도달하면 attenuation이 적용되고 `TEMP_WARN_EINT` status bit가 설정되며, `TEMP_WARN_MASK = 0`이면 `INTb`가 assert됩니다. 값 0, 1, 2, 3은 각각 105C, 115C, 기본 125C, 135C입니다.

`cirrus,irq-drive-select`는 interrupt output driver type을 선택합니다. 값 0은 open-drain, 기본값 1은 push-pull입니다.

`cirrus,irq-gpio-select`는 programmable interrupt output으로 사용할 pin을 선택합니다. 기본값 0은 `PDM_DATA / SWIRE_SD / INT`, 값 1은 GPIO입니다.

VPBR brownout 방지

`cirrus,vpbr-config` 하위 노드의 `cirrus,vpbr-en`은 VBST brownout prevention algorithm을 켜거나 끕니다. 값 0은 비활성화이며 기본값이고, 값 1은 활성화입니다.

구성 선택지와 자세한 동작은 Datasheet 7.31.1절 VPBR Config를 참조합니다.

VPBR attack과 release 제어

`cirrus,vpbr-thld`는 초기 VPBR threshold, 즉 VP brownout threshold voltage를 설정합니다.

원문에 `cirrus,cirrus,vpbr-atk-rate`로 적힌 속성은 brownout condition이 있고 VPBR가 attack state일 때 연속 volume attenuation step 사이의 지연을 설정합니다.

`cirrus,vpbr-atk-vol`은 digital volume 또는 analog gain mode에서 attack attenuation step size를 정하고, `cirrus,vpbr-max-attn`은 VPBR가 audio signal에 적용할 수 있는 최대 attenuation을 정합니다.

`cirrus,vpbr-wait`는 brownout condition이 사라진 뒤 attenuation release state로 들어가기 전의 지연입니다. `cirrus,vpbr-rel-rate`는 brownout이 더 이상 없고 release state일 때 연속 volume attenuation release step 사이의 지연을 설정합니다.

`cirrus,vpbr-mute-en`이 설정된 상태에서 attack 중 `vpbr-max-attn`에 도달한 뒤에도 error condition이 남아 있으면 audio를 mute합니다.

CS35L36 기본 예제

예제는 I2C 주소 `0x40`, VA·VP supply, reset GPIO와 level-low interrupt를 지정합니다. 1uH inductor, 10000mV boost, 4500mA peak current, Control Port boost source와 multi-amp mode를 구성하고 온도 경고와 interrupt pin 동작을 선택합니다.

cs35l36: cs35l36@40 {
        compatible = "cirrus,cs35l36";
        reg = <0x40>;
        VA-supply = <&dummy_vreg>;
        VP-supply = <&dummy_vreg>;
        reset-gpios = <&gpio0 54 0>;
        interrupt-parent = <&gpio8>;
        interrupts = <3 IRQ_TYPE_LEVEL_LOW>;

        cirrus,boost-ind-nanohenry = <1000>;
        cirrus,boost-ctl-millivolt = <10000>;
        cirrus,boost-peak-milliamp = <4500>;
        cirrus,boost-ctl-select = <0x00>;
        cirrus,weak-fet-delay = <0x04>;
        cirrus,weak-fet-thld = <0x01>;
        cirrus,temp-warn-threshold = <0x01>;
        cirrus,multi-amp-mode;
        cirrus,irq-drive-select = <0x01>;
        cirrus,irq-gpio-select = <0x01>;

VPBR 하위 노드 예제

`cirrus,vpbr-config` 예제는 brownout prevention enable, threshold, attack rate와 step, 최대 attenuation, wait, release rate, mute enable 값을 지정합니다.

        cirrus,vpbr-config {
                cirrus,vpbr-en = <0x00>;
                cirrus,vpbr-thld = <0x05>;
                cirrus,vpbr-atk-rate = <0x02>;
                cirrus,vpbr-atk-vol = <0x01>;
                cirrus,vpbr-max-attn = <0x09>;
                cirrus,vpbr-wait = <0x01>;
                cirrus,vpbr-rel-rate = <0x05>;
                cirrus,vpbr-mute-en = <0x00>;
        };
};