🛠 Premier boot du Lichee RV Dock avec Ubuntu 24.04 RISC-V

Objetivos

Arrancar por primera vez la Sipeed Lichee RV Dock (módulo Lichee RV + placa hija Dock, SoC Allwinner D1 RISC-V) con la imagen oficial de Ubuntu 24.04 Server para esta placa — una de las primeras imágenes RISC-V publicadas por Canonical. Aprenderás a grabar la imagen en una tarjeta microSD, a alimentar correctamente la placa (la trampa del cable USB-C está documentada por el propio Sipeed) y a seguir el proceso de arranque en la consola serie. Al final, tendrás un indicador de comandos y sabrás leer la información de la placa.

Material

• Kit Lichee RV Dock: módulo Lichee RV (Allwinner D1, 512 MB DDR3) + placa hija Dock (65 × 40 mm)
• Cable USB-A a USB-C: los cables C-a-C NO FUNCIONAN por defecto — el puerto Type-C del módulo utiliza el pin CC para la identificación OTG automática (aviso oficial del wiki de Sipeed); se necesita un adaptador A-a-C, o soldar resistencias de 5,1 kΩ en R30/R31 y retirar los diodos D3/D4
• Tarjeta microSD (la ranura está debajo del módulo, no en la placa Dock)
• Adaptador USB-UART de 3,3 V para la consola serie en UART0 (pines PB8/PB9 del conector 2×20), 115200 8N1
• Fuente de alimentación de 5 V/1 A mínimo en el puerto USB-C del módulo (la placa Dock no tiene conector DC)

Código completo

# 1) Télécharger l'image Ubuntu 24.04 Server pour Sipeed LicheeRV Dock
#    (liste des images officielles Canonical ; alternative : images Debian du
#    wiki Sipeed, ou image ArchLinux communautaire root/archriscv)
#    Décompresser puis écrire sur la microSD (VÉRIFIER le périphérique !) :
unxz -c ubuntu-24.04-preinstalled-server-riscv64+lichee-rv-dock.img.xz \
    | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync   # sdX = votre carte !

# 2) Brancher l'adaptateur série : TX->RX, RX->TX, GND->GND (ne pas câbler le VCC)
#    sur les broches UART0 (PB8 TX / PB9 RX) du connecteur 2x20
picocom -b 115200 /dev/ttyUSB0        # ou: sudo minicom -b 115200 -D /dev/ttyUSB0

# 3) Insérer la microSD sous le module, alimenter en USB-C (câble A-vers-C)
#    -> U-Boot puis kernel Linux défilent sur la série

# 4) Après le prompt de login (ubuntu/ubuntu au premier boot), vérifier la carte :
uname -a            # riscv64 + version du noyau
head -1 /proc/cpuinfo
free -h             # 512 MB de RAM (DDR3 in-package du D1)
cat /proc/device-tree/compatible   # sipeed,lichee-rv-dock + allwinner,sun20i-d1

Verificación esperada

En la consola serie a 115200 8N1, verás U-Boot y luego el núcleo iniciándose, seguido de un indicador ubuntu login:. uname -a muestra riscv64, free -h indica aproximadamente 460-500 MB utilizables de los 512 MB, y /proc/device-tree/compatible contiene sipeed,lichee-rv-dock. La salida HDMI (hasta 4Kp30) no muestra nada bajo Server: es normal, la imagen no incluye interfaz gráfica (Canonical especifica que el soporte gráfico para RISC-V no está completo).

Errores frecuentes

• Cable USB-C a USB-C: no se enciende nada, la placa Dock permanece apagada — causa n.º 1 de «placa muerta»; usar un cable USB-A a USB-C (limitación de hardware documentada por Sipeed, evitable mediante modificación de R30/R31 + D3/D4).
• Buscar el puerto microSD en la placa Dock: está DEBAJO del módulo Lichee RV.
• Velocidad de serie incorrecta: la consola es a 115200 (no 1 500 000 como en algunas placas Rockchip); TX/RX invertidos = pantalla negra.
• Escribir la imagen en la memoria USB equivocada con dd: verificar siempre con lsblk antes; la microSD debe ser de calidad (las tarjetas de gama baja provocan sistemas de archivos ext4 corruptos).
• Esperar Wi-Fi sin módulo: solo la versión SKU con opción RTL8723DS tiene Wi-Fi/BT; la placa Dock sin accesorios no tiene ni red cableada ni inalámbrica.