Guía de instalación
Sagwa despierta en un minuto.
Flashea una release firmada en tu M5Stack CoreS3. No necesitas compilar el firmware ni instalar ESP-IDF para la instalación rápida.
Antes de conectarla
- Un M5Stack CoreS3 con su cable USB‑C de datos.
- Python 3.8 o posterior y la herramienta
esptool. - Opcional: una microSD FAT32 para caché y actualizaciones en segundo plano.
Instala la dependencia
pip install esptoolFlasheo rápido
Clona el repositorio y ejecuta el instalador. Detecta el puerto, descarga la última release, verifica sus cinco binarios y reinicia el dispositivo.
macOS / Linux
git clone https://github.com/terrerovgh/sagwa.git
cd sagwa
./flash.shWindows / cualquier sistema
git clone https://github.com/terrerovgh/sagwa.git
cd sagwa
python3 flash.py- 1Detecta tu CoreS3
Busca puertos
usbmodem,ttyACMoCOM. - 2Descarga la release
Los binarios no se guardan en el repositorio: viajan con cada release.
- 3Escribe y reinicia
Sagwa aparecerá en pantalla unos segundos después del reinicio.
Qué se escribe en la flash
| Offset | Archivo | Contenido | Tamaño |
|---|---|---|---|
| 0x000000 | bootloader.bin | Bootloader de segunda etapa | 21 KB |
| 0x010000 | partition-table.bin | Mapa de particiones de 16 MB | 3 KB |
| 0x01D000 | ota_data_initial.bin | Selección de ranura OTA | 8 KB |
| 0x020000 | sagwa-cores3.bin | Firmware firmado de Sagwa | 2,94 MB |
| 0x830000 | sagwa_clips.bin | 22 animaciones | 6,96 MB |
Tamaños de la release v1.0.9. Para instalar una versión concreta, usa python3 flash.py --release v1.0.9. Con --app-only o --clips-only actualizas una sola imagen.