WiFi

В: Как подключить WiFi-модуль на чипе RTL8821CS к SoM через интерфейс SDMMC2?

О: В DTS для &sdmmc2 необходимо:

добавить vqmmc-supply (питание сигнальных линий);
добавить no-mmc и no-sd для принудительного режима SDIO;
убрать пин определения карты (det);
оставить только дочерний узел слота:

&sdmmc2 {
    no-mmc;
    no-sd;
    non-removable;
    bus-width = <4>;
    vqmmc-supply = <&vccio_sd>;
    vmmc-supply = <&vcc3v3_sd>;
    keep-power-in-suspend;
    pinctrl-names = "default";
    pinctrl-0 = <&sdmmc2m0_bus4 &sdmmc2m0_cmd &sdmmc2m0_clk>;
    status = "okay";

    wifi: wifi@1 {
        reg = <1>;
    };
};

Для прерывания WiFi-чипа — добавить interrupts в узел wifi согласно схеме подключения.

В: Драйвер `rtw88_8821cs` загружается, интерфейс появляется, но CLK и CMD линии SDMMC2 молчат после загрузки ОС (сигнал есть только в barebox).

О: Порт не инициализируется в режиме SDIO. Убедитесь, что в DTS присутствуют no-mmc, no-sd, non-removable. Проверьте уровень сигнала CMD — необходима внешняя или встроенная притяжка к питанию (отсутствие притяжки фиксируется как постоянный низкий уровень). Также убедитесь, что прерывание подключено корректно.

Важно: использовать встроенный в ядро драйвер rtw88_8821cs (модуль rtw88_8821cs.ko из состава ядра). Внешние репозитории (например, github.com/alireza-tabatabaee/RTL8821CS) не рекомендуются.

В: Ошибка при загрузке драйвера: `Direct firmware load for rtw88/rtw8821c_fw.bin failed with error -2`.

О: Отсутствует бинарный файл прошивки чипа. Установите пакет realtek-firmware — он содержит rtw8821c_fw.bin. После установки драйвер инициализируется штатно.

Ethernet

I2C