🛠 Stockage : déborder des 16 Go d'eMMC (microSD, NVMe M.2, migration)

Objetivos

La eMMC integrada solo tiene 16 GB y la pila TI Edge AI (SDK, modelos, datasets) la consume rápidamente. Aprenderá a arrancar desde la microSD, migrar un rootfs existente y utilizar una SSD NVMe en el conector M.2 E-key, conociendo las trampas de la cadena de arranque K3 y la limitación de PCIe de 2,4 Gbps documentada.

Material

• 1 BeagleBone AI-64
• 1 microSD de calidad (A2/V30) de 64 GB a 256 GB
• Opcional: SSD NVMe formato M.2 E-key (atención: el conector está limitado a 2,4 Gbps mediante una solución alternativa en el DTS, issue #28)

Código completo

# 1. État des lieux
df -h / ; lsblk ; findmnt -no SOURCE /

# 2. Graver la MÊME image sur la grosse microSD, booter dessus :
#    maintenir BOOT enfoncé pendant la mise sous tension.
sudo bmaptool copy BBAI-64-Debian-xxx.img /dev/sdX

# 3. Migrer les données de l'eMMC vers la microSD (booté sur eMMC, SD insérée)
sudo mkdir -p /mnt/sd && sudo mount /dev/mmcblk1p2 /mnt/sd
sudo rsync -aHAXx --info=progress2 / /mnt/sd/   # hors fichiers virtuels /proc /sys /dev
sudo umount /mnt/sd

# 4. NVMe sur M.2 E-key (carte éteinte, puis boot)
sudo nvme list
sudo mkfs.ext4 /dev/nvme0n1
sudo mkdir /opt/datasets && sudo mount /dev/nvme0n1 /opt/datasets
echo '/dev/nvme0n1 /opt/datasets ext4 defaults,noatime 0 2' | sudo tee -a /etc/fstab

# 5. Désigner le stockage racine retenu : reflasher/graver puis valider
sudo reboot   # avec BOOT enfoncé pour forcer la microSD

Verificación esperada

findmnt -no SOURCE / muestra el nuevo soporte, df -h muestra la capacidad esperada y la instalación del SDK Edge AI finaliza sin errores de espacio. La NVMe aparece en nvme list y se vuelve a montar automáticamente tras reiniciar (sin panic «cannot mount root»).

Errores frecuentes

• Olvidar pulsar el botón BOOT en el momento adecuado: si no se pulsa durante el ciclo de alimentación, la tarjeta reinicia en la eMMC.
• MicroSD de baja calidad: las escrituras intensivas del SDK las destruyen en pocas semanas; utilice A2/V30.
• Esperar 5 Gbps del M.2: la solución alternativa del DTS limita la velocidad a 2,4 Gbps — un rendimiento NVMe «decepcionante» es el comportamiento documentado.
• Editar el /etc/fstab incorrecto tras la migración: edite el de la raíz ACTUAL (verifique primero con findmnt), de lo contrario la tarjeta no montará /opt al arrancar.
• El botón RESET no tiene efecto en algunas imágenes cuando se arranca desde la eMMC (issue #29): utilice reboot o el ciclo de alimentación.