STi ASoC card

STi ASoC card 개요

STi ASoC sound card는 internal `sti-sas` codec 또는 external codec을 사용하는 모든 STi SoC에 적용할 수 있습니다. STi sound driver는 generic ASoC simple card로 SoC audio interface를 노출하며 선언 형식은 `Documentation/devicetree/bindings/sound/simple-card.yaml`을 따릅니다.

Uniperipheral DAI 필수 자원

`sti-uniperiph-dai` compatible은 HDMI·PCM output·DAC·SPDIF player와 PCM input·HDMI reader용 `st,stih407-*` 문자열 중 하나입니다. `st,syscfg`는 boot-device system configuration register phandle입니다.

`clock-names`, `reg`·`reg-names`, `interrupts`, `dma`는 CPU DAI property 순서와 일치해야 합니다. `dma-names`는 uniplayer에서 `tx`, unireader에서 `rx`입니다. Uniplayer compatible에서는 CPU DAI IP clock source인 `clocks`도 필수입니다.

I2S pinctrl과 TDM mode

External codec용 I2S PIO를 설명할 때 CPU_DAI@1·@4에 `pinctrl-0`을 두며 `pinctrl-names`는 `default` 하나입니다. `st,tdm-mode`는 external I2S/TDM bus 담당 unireader·uniplayer에서 codec에 맞춰 TDM mode를 선언합니다.

Player·reader 예제

예제는 HDMI TDM player1, PCM-out player2, SPDIF player3와 HDMI reader1을 정의합니다. 각 node는 syscfg, register, interrupt, FDMA request와 `tx` 또는 `rx` DMA name을 연결합니다.

sti_uni_player1: sti-uni-player@8d81000 {
        compatible = "st,stih407-uni-player-hdmi";
        #sound-dai-cells = <0>;
        st,syscfg = <&syscfg_core>;
        clocks = <&clk_s_d0_flexgen CLK_PCM_1>;
        reg = <0x8D81000 0x158>;
        interrupts = <GIC_SPI 85 IRQ_TYPE_NONE>;
        dmas = <&fdma0 3 0 1>;
        dma-names = "tx";
        st,tdm-mode = <1>;
};

sti_uni_player2: sti-uni-player@8d82000 {
        compatible = "st,stih407-uni-player-pcm-out";
        #sound-dai-cells = <0>;
        st,syscfg = <&syscfg_core>;
        clocks = <&clk_s_d0_flexgen CLK_PCM_2>;
        reg = <0x8D82000 0x158>;
        interrupts = <GIC_SPI 86 IRQ_TYPE_NONE>;
        dmas = <&fdma0 4 0 1>;
        dma-names = "tx";
};

sti_uni_player3: sti-uni-player@8d85000 {
        compatible = "st,stih407-uni-player-spdif";
        #sound-dai-cells = <0>;
        st,syscfg = <&syscfg_core>;
        clocks = <&clk_s_d0_flexgen CLK_SPDIFF>;
        reg = <0x8D85000 0x158>;
        interrupts = <GIC_SPI 89 IRQ_TYPE_NONE>;
        dmas = <&fdma0 7 0 1>;
        dma-names = "tx";
};

sti_uni_reader1: sti-uni-reader@8d84000 {
        compatible = "st,stih407-uni-reader-hdmi";
        #sound-dai-cells = <0>;
        st,syscfg = <&syscfg_core>;
        reg = <0x8D84000 0x158>;
        interrupts = <GIC_SPI 88 IRQ_TYPE_NONE>;
        dmas = <&fdma0 6 0 1>;
        dma-names = "rx";
};

Internal STI SAS codec

`sti-sas-codec`의 `compatible`은 `st,stih416-sas-codec` 또는 `st,stih407-sas-codec`입니다. `st,syscfg`는 boot-device system configuration phandle, `pinctrl-0`은 SPDIF PIO, `pinctrl-names`는 `default`입니다.

STIH407 SAS codec 예제

예제는 STIH407 SAS codec을 1-cell sound DAI로 선언하고 syscfg와 SPDIF pinctrl을 연결합니다. 원문 property는 앞의 `st,syscfg` 설명과 달리 `st,reg_audio`를 사용합니다.

sti_sas_codec: sti-sas-codec {
        compatible = "st,stih407-sas-codec";
        #sound-dai-cells = <1>;
        st,reg_audio = <&syscfg_core>;
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_spdif_out >;
};

Simple card DAI link topology

Simple card는 player2와 SAS codec DAI 1을 I2S DAC로, player3과 codec DAI 0을 left-justified SPDIF로, player1과 codec DAI 3을 16-slot TDM playback으로 연결합니다. TDM link는 16-bit slot과 explicit TX mask를 사용합니다.

sound {
        compatible = "simple-audio-card";
        simple-audio-card,name = "sti audio card";

        simple-audio-card,dai-link@0 {
                /* DAC */
                format = "i2s";
                dai-tdm-slot-width = <32>;
                cpu {
                        sound-dai = <&sti_uni_player2>;
                };

                codec {
                        sound-dai = <&sti_sasg_codec 1>;
                };
        };
        simple-audio-card,dai-link@1 {
                /* SPDIF */
                format = "left_j";
                cpu {
                        sound-dai = <&sti_uni_player3>;
                };

                codec {
                        sound-dai = <&sti_sasg_codec 0>;
                };
        };
        simple-audio-card,dai-link@2 {
                /* TDM playback  */
                format = "left_j";
                frame-inversion = <1>;
                cpu {
                        sound-dai = <&sti_uni_player1>;
                        dai-tdm-slot-num = <16>;
                        dai-tdm-slot-width = <16>;
                        dai-tdm-slot-tx-mask =
                                <1 1 1 1 0 0 0 0 0 0 1 1 0 0 1 1>;
                };

                codec {
                        sound-dai = <&sti_sasg_codec 3>;
                };
        };
};