🛠 Wi-Fi et Bluetooth du module RTL8723DS sur le Lichee RV Dock

Objetivos

El SKU Wi-Fi del kit Lichee RV incorpora un Realtek RTL8723DS: Wi-Fi 4 (802.11b/g/n 2,4 GHz) + Bluetooth 4.2. En el lado D1, el chip está conectado vía SDIO de 4 bits al controlador mmc1 (con un GPIO de reset en PG12) y el Bluetooth en uart1 con flujo RTS/CTS y líneas de wake PG16-PG18 — el device tree mainline del Dock describe exactamente este cableado. Este tutorial: poner en servicio wlan0 en modo estación con wpa_supplicant, verificar la interfaz, y luego inicializar el HCI Bluetooth. Es real: el RTL8723DS requiere firmware + controlador del fabricante, a diferencia de un módulo USB clásico.

Hardware

• Lichee RV Dock con la opción Wi-Fi/BT RTL8723DS (el Dock sin opción NO tiene NINGUNA red, ni por cable ni inalámbrica)
• Imagen mainline con firmware Realtek: la defconfig de Buildroot sipeed_lichee_rv_dock incluye BR2_PACKAGE_RTL8723DS / RTL8723DS_BT + wpa_supplicant + bluez; en Ubuntu/Debian, instalar firmware-realtek
• Punto de acceso de 2,4 GHz únicamente (el chip no ve la banda de 5 GHz)

Código completo

# 1) Vérifier la présence matérielle
dmesg | grep -iE 'mmc1|rtl8723|bluetooth'
ip link          # wlan0 doit exister même non connecté

# 2) Wi-Fi station avec wpa_supplicant
rfkill unblock wifi
wpa_passphrase "MonSSID" "motdepasse" | sudo tee /etc/wpa_supplicant.conf >/dev/null
sudo wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf -C /var/run/wpa
sudo wpa_cli -p /var/run/wpa status state      # attendre COMPLETED
sudo udhcpc -i wlan0                           # ou dhclient wlan0 selon la distro
ping -c 3 1.1.1.1

# 3) Persister (Ubuntu : netplan + wpa_supplicant, ou NetworkManager)
sudo nmcli device wifi connect "MonSSID" password "motdepasse"   # si NetworkManager

# 4) Bluetooth 4.2 : le nœud « realtek,rtl8723ds-bt » de uart1 (ttyS1)
#    attend une initialisation HCI (service vendor ou hciattach) :
sudo systemctl start hciuart 2>/dev/null || \
  sudo hciattach /dev/ttyS1 rtl8723ds 1500000  # selon l'image
sudo hciconfig hci0 up && sudo hcitool scan

Verificación esperada

ip -br link muestra wlan0 UP con una dirección IP tras DHCP; wpa_cli status devuelve state=COMPLETED; ip route get 1.1.1.1 confirma que el tráfico sale por wlan0. dmesg registra la conexión del chip en mmc1 (el reset GPIO PG12 es gestionado por el controlador). En el lado BT, hciconfig hci0 muestra una dirección MAC y hcitool scan detecta los dispositivos cercanos. En la imagen Buildroot de la placa, todo está ya empaquetado: es el camino más corto para validar este tutorial.

Errores frecuentes

• Dock sin la opción Wi-Fi: wlan0 nunca existe en el SKU básico — verificar la compra (SKU Dock +3 $ con RTL8723DS en el lanzamiento).
• Firmware faltante: dmesg muestra « Direct firmware load for rtl8723d... failed »; instalar el firmware (linux-firmware o paquete Buildroot).
• SSID de 5 GHz: el chip es solo de 2,4 GHz; un escaneo vacío suele deberse a un AP solo de 5 GHz.
• Antena: el módulo tiene una antena de cerámica + conector IPEX; si el montaje prevé una antena externa no conectada, la señal es mínima.
• Dos gestores de red compitiendo (NetworkManager + wpa_supplicant manual): mantener solo uno, si no, « Device or resource busy ».
• Bluetooth esperado automáticamente: a diferencia del Wi-Fi, el BT del RTL8723DS requiere una inicialización HCI (hciattach/servicio del fabricante) antes de crear hci0.