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

Objectifs

L'eMMC embarquée ne fait que 16 Go et la pile TI Edge AI (SDK, modèles, datasets) les dévore. Vous allez apprendre à booter depuis la microSD, migrer un rootfs existant, et utiliser un SSD NVMe dans le connecteur M.2 E-key — en connaissant les pièges de chaîne de boot K3 et la limitation PCIe 2,4 Gbps documentée.

Matériel

• 1 BeagleBone AI-64
• 1 microSD de qualité (A2/V30) de 64 Go à 256 Go
• Optionnel : SSD NVMe format M.2 E-key (attention : le connecteur est bridé à 2,4 Gbps par contournement DTS, issue #28)

Code complet

# 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

Vérification attendue

findmnt -no SOURCE / montre le nouveau support, df -h affiche la capacité attendue, et l'installation du SDK Edge AI se termine sans erreur d'espace. Le NVMe apparaît dans nvme list et se remonte automatiquement après reboot (pas de panic « cannot mount root »).

Erreurs fréquentes

• Oublier le bouton BOOT au bon moment : sans lui pendant le cycle d'alimentation, la carte redémarre sur l'eMMC.
• MicroSD bas de gamme : les écritures intensives du SDK les tuent en quelques semaines ; prendre A2/V30.
• Attendre 5 Gbps du M.2 : le contournement DTS plafonne à 2,4 Gbps — débit NVMe « décevant » = comportement documenté.
• Éditer le mauvais /etc/fstab après migration : éditer celui de la racine COURANTE (vérifier findmnt d'abord), sinon la carte ne monte plus /opt au boot.
• Le bouton RESET reste sans effet sur certaines images quand on boote sur eMMC (issue #29) : passer par reboot ou le cycle d'alimentation.