Cirrus CS35L35 boosted speaker amplifier

CS35L35 필수 속성

CS35L35 boosted speaker amplifier의 `compatible` 값은 `cirrus,cs35l35`이고, `reg`에는 I2C 장치 주소를 지정합니다.

`VA-supply`와 `VP-supply`는 `Documentation/devicetree/bindings/regulator/regulator.txt`에 정의된 장치 전원 공급 장치를 가리킵니다.

`interrupts`는 CS35L35 IRQ 선 정보이며 자세한 interrupt 속성 규칙은 `Documentation/devicetree/bindings/interrupt-controller/interrupts.txt`를 참조합니다.

`cirrus,boost-ind-nanohenry`는 boost converter inductor 값을 nH 단위로 정합니다. 허용값은 1000nH, 1200nH, 1500nH, 2200nH입니다.

Stereo channel과 boost 공유

선택 속성 `reset-gpios`는 증폭기를 reset하는 GPIO입니다. Boolean `cirrus,stereo-config`는 증폭기 두 개를 사용하는 stereo 구성을 나타냅니다.

`cirrus,audio-channel`은 serial port에서 audio signal의 위치를 정하며 0은 left I2S channel, 1은 right I2S channel에서 받은 data packet을 뜻합니다. `cirrus,advisory-channel`도 같은 값 체계로 advisory signal의 위치를 정합니다.

Boolean `cirrus,shared-boost`는 장치 두 개가 boost `BST_CTL`을 공유할 때 advisory signal을 Class H로 추적하도록 합니다.

Boolean `cirrus,external-boost`는 장치가 외부 boost supply를 사용함을 나타냅니다. 다른 CS35L35의 boost를 공유하는 slave 장치도 외부 supply를 사용하는 것으로 간주합니다.

Serial port와 boost 전기 설정

`cirrus,sp-drv-strength`는 serial port drive strength를 정합니다. Datasheet 표 3-10에 규격이 있으며 값 0은 기본 1x, 값 1은 0.5x입니다.

`cirrus,sp-drv-unused`는 serial port의 사용하지 않는 slot을 구동하는 방법입니다. 값 0은 Hi-Z, 기본값 2는 0을 출력하고 값 3은 1을 출력합니다.

Boolean `cirrus,bst-pdn-fet-on`은 boost PDN control이 전원을 끌 때 rectification FET를 켠 상태로 둘지 정합니다. VSPK가 외부에서 공급되면 FET는 꺼집니다.

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

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

Boolean `cirrus,amp-gain-zc`는 amplifier gain 변경에 zero-cross를 사용할지 정합니다.

내부 Class H 알고리즘 제어

CS35L35 노드에는 자동 내부 H/G algorithm 제어를 비활성화하는 `cirrus,classh-internal-algo` 하위 노드를 하나 둘 수 있습니다. 이 노드를 사용하지 않으면 장치가 Class H algorithm을 내부적으로 관리합니다.

속성을 직접 조정할 때는 Datasheet의 4.3절 Internal Class H Algorithm을 참조해야 합니다.

Class H 세부 속성

Datasheet 7.29절 Class H Control에는 Boolean `cirrus,classh-bst-overide`, `cirrus,classh-bst-max-limit`, `cirrus,classh-mem-depth`가 대응합니다.

7.30절 Class H Headroom Control에는 `cirrus,classh-headroom`, 7.31절 Class H Release Rate에는 `cirrus,classh-release-rate`가 대응합니다.

7.32절 Class H Weak FET Drive Control에는 `cirrus,classh-wk-fet-disable`, `cirrus,classh-wk-fet-delay`, `cirrus,classh-wk-fet-thld`가 대응합니다.

7.34절 Class H VP Control에는 `cirrus,classh-vpch-auto`, `cirrus,classh-vpch-rate`, `cirrus,classh-vpch-man`이 대응합니다.

Monitor signal format 하위 노드

CS35L35 노드에는 algorithm이 사용할 monitoring signal의 depth, location, frame을 조정하는 `cirrus,monitor-signal-format` 하위 노드를 하나 둘 수 있습니다. 자세한 serial-port control은 Datasheet 4.8.2~4.8.4절을 참조합니다.

`cirrus,monitor-signal-format`의 각 monitor 설정은 세 개의 8-bit 값으로 depth, location, frame을 나타냅니다. 이 노드를 사용하지 않으면 여섯 monitor signal의 기본값을 사용합니다.

각 monitoring signal의 depth, location, frame 값은 Datasheet 7.44~7.53절에 나열되어 있습니다.

여섯 monitor signal

`cirrus,imon`은 IMON monitor signal의 depth, location, frame과 ADC scale을 정하는 네 개의 8-bit 값입니다.

`cirrus,vmon`, `cirrus,vpmon`, `cirrus,vbstmon`, `cirrus,vpbrstat`은 각각 VMON, VPMON, VBSTMON, VPBRSTAT monitor signal의 depth, location, frame을 정하는 세 개의 8-bit 값입니다.

`cirrus,zerofill`은 monitor signal 안의 ZEROFILL packet에 사용할 depth, location, frame을 정하는 세 개의 8-bit 값입니다.

CS35L35와 Class H 예제

예제는 I2C 주소 `0x20`, VA·VP supply, reset GPIO, level-low interrupt와 9000mV boost를 지정합니다. Stereo mode에서 audio는 left, advisory는 right channel을 사용하고 boost를 공유합니다.

`cirrus,classh-internal-algo` 하위 노드는 boost override와 limit, memory depth, release rate, headroom, weak-FET 조건과 Vpch 자동 추적 값을 구성합니다.

cs35l35: cs35l35@20 {
        compatible = "cirrus,cs35l35";
        reg = <0x20>;
        VA-supply = <&dummy_vreg>;
        VP-supply = <&dummy_vreg>;
        reset-gpios = <&axi_gpio 54 0>;
        interrupt-parent = <&gpio8>;
        interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
        cirrus,boost-ctl-millivolt = <9000>;

        cirrus,stereo-config;
        cirrus,audio-channel = <0x00>;
        cirrus,advisory-channel = <0x01>;
        cirrus,shared-boost;

        cirrus,classh-internal-algo {
                cirrus,classh-bst-overide;
                cirrus,classh-bst-max-limit = <0x01>;
                cirrus,classh-mem-depth = <0x01>;
                cirrus,classh-release-rate = <0x08>;
                cirrus,classh-headroom-millivolt = <0x0B>;
                cirrus,classh-wk-fet-disable = <0x01>;
                cirrus,classh-wk-fet-delay = <0x04>;
                cirrus,classh-wk-fet-thld = <0x01>;
                cirrus,classh-vpch-auto = <0x01>;
                cirrus,classh-vpch-rate = <0x02>;
                cirrus,classh-vpch-man = <0x05>;
        };

Monitor format 예제

`cirrus,monitor-signal-format` 예제는 `/bits/ 8` 배열로 IMON, VMON, VPMON, VBSTMON, VPBRSTAT, ZEROFILL packet의 depth, location, frame을 배치합니다.

        /* Depth, Location, Frame */
        cirrus,monitor-signal-format {
                cirrus,imon = /bits/ 8 <0x03 0x00 0x01>;
                cirrus,vmon = /bits/ 8 <0x03 0x00 0x00>;
                cirrus,vpmon = /bits/ 8 <0x03 0x04 0x00>;
                cirrus,vbstmon = /bits/ 8 <0x03 0x04 0x01>;
                cirrus,vpbrstat = /bits/ 8 <0x00 0x04 0x00>;
                cirrus,zerofill = /bits/ 8 <0x00 0x00 0x00>;
        };

};