TI OMAP High-Speed MMC

OMAP·66AK2G High-Speed MMC

TI OMAP 및 66AK2G 계열의 High-Speed MMC Host Controller는 MMC, SD, SDIO memory card interface를 제공합니다. 이 문서는 `mmc.txt`의 core 속성과 `omap_hsmmc` driver 전용 속성의 차이를 설명합니다.

Controller별 compatible

`compatible`은 OMAP2에 `ti,omap2-hsmmc`, OMAP3에 `ti,omap3-hsmmc`, ES3.0 이전 OMAP3에 `ti,omap3-pre-es3-hsmmc`, OMAP4에 `ti,omap4-hsmmc`, AM335x에 `ti,am33xx-hsmmc`를 사용합니다. 66AK2G는 `ti,k2g-hsmmc`와 fallback `ti,omap4-hsmmc`를 함께 사용합니다.

SoC별 hwmod·power domain·clock

OMAP, AM33xx, AM43xx SoC에서는 `ti,hwmods`가 필수이며 1부터 시작하는 controller instance를 넣은 `mmc<n>`이어야 합니다.

66AK2G에서만 `power-domains`가 필수이며 PM domain provider node의 phandle과 MMC device ID argument를 포함합니다. 형식은 `Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml`을 따릅니다.

66AK2G의 `clocks`는 `clock-names`의 각 항목에 대응하는 entry를 포함하고 `Documentation/devicetree/bindings/clock/ti,sci-clk.yaml`의 consumer 형식을 따라야 합니다. `clock-names`는 functional clock인 `fck`와 debounce clock인 `mmchsdb_fck`입니다.

전압·reset·high-speed·DMA

선택 boolean `ti,dual-volt`는 dual-voltage card 지원을 뜻합니다. `<supply-name>-supply`는 regulator node의 phandle이며 이름의 예는 `vmmc`, deprecated `vmmc_aux`, 그리고 그 대체인 `vqmmc`입니다. `ti,non-removable`은 eMMC처럼 제거할 수 없는 slot을 나타냅니다.

`ti,needs-special-reset`은 특별한 soft-reset sequence가 필요함을, `ti,needs-special-hs-handling`은 HSMMC IP가 High Speed 처리를 위한 특별한 설정을 필요로 함을 나타냅니다.

`dmas`에는 generic DMA client binding의 controller별 형식으로 TX와 RX specifier를 넣습니다. `dma-names`는 각 specifier와 1:1로 대응하며 RX와 TX request의 이름은 각각 `rx`, `tx`입니다.

hwmod가 채운 DMA resource

첫 예제는 DMA resource를 hwmod가 채우는 구성입니다. OMAP4 `mmc1`에 dual-voltage, 4-bit bus, VMMC regulator와 non-removable slot을 설정하며 DTS에 `dmas`를 직접 쓰지 않습니다.

[hwmod populated DMA resources]

        mmc1: mmc@4809c000 {
                compatible = "ti,omap4-hsmmc";
                reg = <0x4809c000 0x400>;
                ti,hwmods = "mmc1";
                ti,dual-volt;
                bus-width = <4>;
                vmmc-supply = <&vmmc>; /* phandle to regulator node */
                ti,non-removable;
        };

Generic DMA request 예제

두 번째 예제는 같은 controller에 EDMA request 24와 25를 직접 지정하고 이름을 `tx`, `rx`로 연결합니다.

[generic DMA request binding]

        mmc1: mmc@4809c000 {
                compatible = "ti,omap4-hsmmc";
                reg = <0x4809c000 0x400>;
                ti,hwmods = "mmc1";
                ti,dual-volt;
                bus-width = <4>;
                vmmc-supply = <&vmmc>; /* phandle to regulator node */
                ti,non-removable;
                dmas = <&edma 24
                        &edma 25>;
                dma-names = "tx", "rx";
        };

AM33xx swakeup 누락 우회

AM33xx SoC에는 `swakeup` line이 없으므로 suspend 중 SDIO IRQ를 감지하지 못합니다. 정상 구조에서는 card의 CIRQ가 HSMMC로 들어오고 HSMMC가 CPU에 IRQ를 보내며, HSMMC와 PRCM 사이에는 wake 요청인 `swakeup`과 functional clock인 `fclk`가 오갑니다.

Suspend 중에는 `fclk`가 꺼져 module이 동작하지 않고 register read도 실패합니다. 정상 host의 작은 logic은 외부 event를 감지하면 `fclk` 복원을 요청하고, clock이 돌아오면 event를 일반 방식으로 감지합니다. AM33xx에는 이 요청 line이 없기 때문에 suspend에서 깨어나지 못합니다.

우회 방법은 suspend 때 DAT1 line을 GPIO로 재구성하는 것입니다. `default`와 `idle`이라는 pinctrl state를 정의하고, `idle`에서는 DAT1을 GPIO로 remux하며 `default`에서는 SDIO DAT1로 되돌립니다. MMC driver는 runtime 중 두 state를 전환합니다.

구성 순서는 1) 아래 예제와 일치하는 `compatible` section을 선택하고, 2) `default`와 `idle` pinctrl state를 지정하며 선택적으로 `sleep`을 추가하고, 3) suspend 중 SDIO IRQ를 감지할 GPIO IRQ를 지정하는 것입니다.

구성이 불완전하면 `falling back to polling` 경고가 출력됩니다. `/sys/kernel/debug/mmc0/regs`의 `sdio irq mode`도 확인할 수 있습니다. MMC card처럼 모든 응용이 SDIO IRQ를 필요로 하는 것은 아닙니다.

DAT1 GPIO remux 예제

예제는 AM33xx `mmc1`에 `default`, `idle`, `sleep` pinctrl state를 연결하고, controller interrupt 64와 GPIO2_28의 level-low interrupt를 `interrupts-extended`로 함께 지정합니다. `mmc1_idle` state에서는 offset `0x0f8`을 GPIO2_28 mode로 설정합니다.

mmc1: mmc@48060100 {
        compatible = "ti,am33xx-hsmmc";
        ...
        pinctrl-names = "default", "idle", "sleep"
        pinctrl-0 = <&mmc1_pins>;
        pinctrl-1 = <&mmc1_idle>;
        pinctrl-2 = <&mmc1_sleep>;
        ...
        interrupts-extended = <&intc 64 &gpio2 28 IRQ_TYPE_LEVEL_LOW>;
};

mmc1_idle : pinmux_cirq_pin {
        pinctrl-single,pins = <
                0x0f8 0x3f      /* GPIO2_28 */
        >;
};