Primero respira. Después revisa el cable.
Las incidencias más habituales tienen una ruta de comprobación corta. Empieza por la alimentación, el cable y el registro serie antes de reescribir la flash.
Problemas frecuentes
No aparece ningún puerto serie
Prueba otro cable USB‑C de datos. En macOS busca /dev/cu.usbmodem*; en Linux, /dev/ttyACM0 o /dev/ttyUSB0; en Windows, un puerto COM.
sudo usermod -aG dialout $USEREl flasheo no entra en modo descarga
- Desconecta el USB.
- Mantén pulsado RESET/POWER en la parte inferior.
- Conecta el USB, espera dos segundos y suelta.
- Ejecuta de nuevo
./flash.sh.
La pantalla queda negra al primer arranque
Comprueba que escribiste las cinco imágenes, especialmente sagwa_clips.bin en 0x830000. Sin ese paquete, el firmware vuelve al modo de poses anterior.
python3 -m serial.tools.miniterm <PORT> 115200Un arranque sano muestra Muse Gadget starting e inicializa LTR‑553 y BMI270.
La microSD no aparece o no actualiza
Formatea la tarjeta como FAT32; exFAT y NTFS no son compatibles con este flujo de ESP‑IDF. En Settings → Sagwa puedes ver el espacio libre o el aviso «Not FAT32».
Una actualización no termina de arrancar
La imagen debe confirmar que vuelve a alcanzar GitHub o la conexión de control de Muse. Si no lo hace en cinco minutos, el bootloader restaura la ranura anterior. Revisa Wi‑Fi, el repositorio configurado y la clave de firma antes de reintentar.
Volver a una release conocida
python3 flash.py --release v1.0.9
# Si solo quieres restaurar la aplicación
python3 flash.py --release v1.0.9 --app-only