Installation guide

Sagwa wakes up in a minute.

Flash a signed release to your M5Stack CoreS3. You do not need to build the firmware or install ESP-IDF for the quick installation.

Python 3.8+USB‑C data5 images

Before you connect her

An M5Stack CoreS3 with its USB‑C data cable.
Python 3.8 or later and the esptool.
Optional: a FAT32 microSD card for caching and background updates.

Install the dependency

pip install esptool

Quick flashing

Clone the repository and run the installer. It detects the port, downloads the latest release, verifies its five binaries and reboots the device.

macOS / Linux

git clone https://github.com/terrerovgh/sagwa.git
cd sagwa
./flash.sh

Windows / any system

git clone https://github.com/terrerovgh/sagwa.git
cd sagwa
python3 flash.py

1
Detects your CoreS3
Looks for usbmodem, ttyACM or COM.
2
Downloads the release
Binaries are not stored in the repository: they ship with each release.
3
Writes and reboots
Sagwa will appear on screen a few seconds after the reboot.

What gets written to flash

Offset	File	Contents	Size
0x000000	bootloader.bin	Second-stage bootloader	21 KB
0x010000	partition-table.bin	16 MB partition map	3 KB
0x01D000	ota_data_initial.bin	OTA slot selection	8 KB
0x020000	sagwa-cores3.bin	Signed Sagwa firmware	2.94 MB
0x830000	sagwa_clips.bin	22 animations	6.96 MB

Sizes from release v1.0.9. To install a specific version, use python3 flash.py --release v1.0.9. With --app-only or --clips-only you update a single image.

NextLearn to live with Sagwa

View interactions