Repository navigation
Releases
v0.7.0: settings in a flash file
Settings now live in a file on internal flash.
Settings storage
- Settings, saved Wi-Fi networks, paired hosts and LED effects are in
/thronectl/cfgon a LittleFS volume. The volume uses the 1.5 MBspiffspartition that the firmware already had, so the partition table does not change. - Each save writes a temporary file and then renames it. A power cut leaves the old or the new settings, never a half-written file.
- NVS keeps only the device key, so a reformatted volume does not make you pair again.
- Standalone install: the device formats the partition on first start. Under Launcher, it formats the partition only when it is blank, because the partition can hold another app's files. If a different file system is already there, settings stay in NVS.
- Factory reset clears both the flash folder and NVS.
- About shows where settings are kept and how much space is in use.
Upgrade note
Settings from 0.6.x are not copied over. After this update the device starts with default settings, so add your Wi-Fi network and pair with your host again. The device key stays the same.
Checks
Host checks passed: new storecheck (atomic saves, power-cut leftovers, wipe, Bluetooth boot check), daemon tests (40) and build, blecheck, linkcheck, ledcheck, keyfuzz seeds 1, 7, 42 and 1234 at 200000 steps, snapshots, firmware build.
Not tested on hardware yet: the LittleFS mount and format on the device, and the blank check under Launcher.
Install
Flash thronectl-cardputer-adv-v0.7.0.bin at offset 0x0, or update from the device. SHA-256:
f17b7646881827b45d3a86eeb2373f308473c9be7823663a8f87bb54422cf7c1 thronectl-cardputer-adv-v0.7.0.bin
v0.6.1: settings and Bluetooth fixes, LED colors
Fixes for settings and Bluetooth in v0.6.0, plus better LED colors and new effects.
Fixes
- Settings now save when you change them. Before, a change was lost if you left Settings with the Home shortcut instead of Back.
- Bluetooth: if you cancel the restart prompt, the switch now stays off. If you accept it, Bluetooth is saved as on before the restart.
- Pair over Bluetooth now keeps Bluetooth on after the 2-minute window. Before, the device stopped Bluetooth when the window closed, and it stayed off after a restart.
- Turning Bluetooth off now also cancels an open pairing window.
LED
- Colors are gamma corrected. The LED now shows the same hue as the screen, so orange and amber no longer look yellow.
- The primary colors are pure. Teal now differs from cyan, indigo from violet, and purple from magenta.
- 8 new colors: lime, mint, sky blue, violet, magenta, coral, warm white, ice white.
- 6 new effects: rainbow breath, color steps, sparkle, candle, triple blink, swell.
- Saved LED settings keep their colors and effects.
Checks
Host checks passed: daemon tests (40) and build, blecheck, linkcheck, ledcheck (new color and effect checks), keyfuzz seeds 1, 7, 42 and 1234 at 200000 steps (new settings and Bluetooth restart checks), snapshots, firmware build.
Not tested on hardware yet: LED colors on the device, BLE radio on both sides, BLE heap and throughput, macOS Bluetooth permission.
Install
Flash thronectl-cardputer-adv-v0.6.1.bin at offset 0x0, or update from the device. SHA-256:
96fdea5366af598b67c8f32ae9c11a75af74019ed6d331a5cb260898bb6b4e73 thronectl-cardputer-adv-v0.6.1.bin
v0.6.0: Bluetooth LE and LED output fix
Bluetooth LE now connects the Cardputer ADV to a paired daemon without a shared Wi-Fi network. Enable it in Settings > Network. Pair over Bluetooth opens a 2-minute pairing window. If Bluetooth was off at boot, the device asks to restart before enabling it.
The LED output now keeps its shared backlight supply steady while an effect runs, including dark phases. It sends complete RMT frames with WS2812B-2020 pulse timings and reset gaps. All existing effects, per-state and per-alert settings remain available. The display backlight stays at full brightness during active effects and returns to the selected brightness afterward. This uses more battery while an effect runs.
Bluetooth startup preserves early handshake packets. Reconnects remove old notification listeners, MTU changes keep byte offsets correct, and credit tracking handles counter rollover.
Validation:
- Daemon: 40 tests passed; TypeScript build passed.
- Bluetooth HAL: 30 checks passed under ASan and UBSan.
- LED output: power, retry, color order and waveform checks passed under ASan and UBSan.
- Keyfuzz: 200000 steps each on seeds 1, 7, 42 and 1234.
- Firmware linkcheck passed against a real daemon over TCP and a fragmented byte pipe.
- Screen snapshots rendered and inspected.
- Firmware built and merged: static RAM 59160 bytes, application flash 1531737 bytes.
Hardware verification is still missing for BLE radios on both sides, BLE heap use and throughput, macOS Bluetooth permission, LED behavior under radio traffic, deep sleep, codec power-down, mic gain and SD formatting.
Download the merged firmware image and its SHA-256 file below. Flash the merged image at offset 0x0, or use the existing device update flow.
v0.5.0
Local voice
The daemon can now do speech on the host, with the same models Paseo uses: Parakeet TDT 0.6B (speech to text) and Kokoro 82M (text to speech), run by sherpa-onnx. No API keys are needed.
- If Paseo's models are in
~/.paseo/models/local-speech, the daemon uses them. - Otherwise run
thronectl voice install(about 800 MB), or use Settings, Voice, Host speech on the device. autonow tries local voice first. "Use local voice" on the device turns it off or on.- Speech starts when the first sentence is ready, so long replies do not wait for the full text.
Host settings
Settings, Network, Host settings edits the daemon config from the device. API keys show masked. Harnesses can be turned off, renamed or added. Port and bind changes apply after "Restart daemon". With allowShell set to false, the device can read these settings but not change them.
Update
On the host: thronectl update. On the device: Settings, Device, Check for updates.
v0.4.0
What's new
- The LED works. M5Unified's LED driver is empty on ESP-IDF 4.4, so the firmware now drives the WS2812 on G21 itself. Settings > LED has an effect for each state (standby, working, waiting, offline, charging) and each alert (done, attention, error, info). Pick the effect, color, speed, level and length. The LED previews the effect while its page is open.
- Approvals and Simple mode. Opt+y (or
yon Home) opens one card per waiting request:yallows,ddenies,csends a comment. Simple mode (Settings > Agents) makes this the home screen. - No more restarts on large output. The daemon caps messages at 32 KB and agent output at 12 KB. The device decrypts in place and drops a reply it cannot hold.
- Keys for the real layout. Space talks on screens that do not type.
[and]page lists. Digits open agents and dashboard slides. - Three text sizes. Small, the new Medium, and Large (the old Normal).
- SD backup fixed. The card mounts at a safer clock, exFAT cards get a clear message and an optional FAT32 format, and a folder browser picks where to save or what to restore.
- Updates from the device. Settings > Device > Check for updates gets new firmware from the host, or updates thronectl on the host.
- Hardware fixes. Better battery percent, a charging guess, display sleep, IMU off, mic gain in the codec, no lost key events, and G0 wakes the device after Power off.
Install
- Daemon:
throne update(orcd thronectl && git pull && cd daemon && npm install && npm run build). - Firmware: from 0.2.0 or later,
throne flashor Settings > Device > Check for updates. First install: flashthronectl-cardputer-adv-v0.4.0.binat0x0, or copy it to the SD card for Launcher.
v0.3.0
Updates without cables.
throne update:throneis the new short alias forthronectl. The command updates the git checkout, rebuilds the daemon and restarts the login service. Then it offers new firmware to connected devices. Use--yesto skip questions or--no-firmwarefor the daemon only.throne flash: sends the newest firmware (latest GitHub release throughgh, or a local build) to connected devices. You can also give a file and--device <name>.- On the device: you confirm the update. A standalone install writes the spare app slot, checks the SHA-256 and restarts into the new firmware. Under Launcher, the device saves the image to the SD card instead, because Launcher owns the app slots. Then reboot, press any key on the Launcher screen, open SD and install the file.
- Settings > Device > Update from SD card installs a
.binfrom the card on a standalone install.
This is the first version that can take updates over Wi-Fi, so install it once by hand. Copy thronectl-cardputer-adv-v0.2.0.bin to the SD card and install it with Launcher, or flash it at 0x0 with esptool. A daemon older than 0.2.0 also needs one manual upgrade: git pull && cd daemon && npm install && npm run build && npm link.
v0.2.0: updates over Wi-Fi and SD
Updates without cables.
throne update:throneis the new short alias forthronectl. The command updates the git checkout, rebuilds the daemon and restarts the login service. Then it offers new firmware to connected devices. Use--yesto skip questions or--no-firmwarefor the daemon only.throne flash: sends the newest firmware (latest GitHub release throughgh, or a local build) to connected devices. You can also give a file and--device <name>.- On the device: you confirm the update. A standalone install writes the spare app slot, checks the SHA-256 and restarts into the new firmware. Under Launcher, the device saves the image to the SD card instead, because Launcher owns the app slots. Then reboot, press any key on the Launcher screen, open SD and install the file.
- Settings > Device > Update from SD card installs a
.binfrom the card on a standalone install.
This is the first version that can take updates over Wi-Fi, so install it once by hand. Copy thronectl-cardputer-adv-v0.2.0.bin to the SD card and install it with Launcher, or flash it at 0x0 with esptool. A daemon older than 0.2.0 also needs one manual upgrade: git pull && cd daemon && npm install && npm run build && npm link.
thronectl v0.1.2
Fixes the screen turning off after every key press.
- Screen went dark after each key: the dim and screen-off timers used an unsigned time difference that wrapped when a key handler stamped a newer time than the main loop had read. The same bug could fail Wi-Fi joins, link handshakes and voice recordings early. All elapsed-time checks now handle this.
- Wi-Fi list stayed empty: scan results that arrived while the boot splash was showing were never displayed.
- Re-joining a saved network read freed memory.
Install from SD with Launcher (pick the file, then Install), or flash thronectl-cardputer-adv-v0.1.2.bin at 0x0 with esptool.
thronectl v0.1.1
- Factory reset now clears only thronectl's own NVS namespace. When you run thronectl from Launcher, Launcher keeps its settings.
- The README has Launcher install steps: copy the
.binto the SD card, then pick SD, select the file and choose Install.
thronectl-cardputer-adv-v0.1.1.bin is one merged image. Flash it at 0x0 with esptool, or install it from SD with Launcher. Launcher reads the partition table and installs only the app.
thronectl v0.1.0
First release of thronectl for the M5Stack Cardputer ADV.
Flash: thronectl-cardputer-adv-v0.1.0.bin is one merged image for offset 0x0. Use the esptool-js web flasher, or run:
esptool.py --chip esp32s3 --baud 1500000 write_flash 0x0 thronectl-cardputer-adv-v0.1.0.binHost: install the daemon from source (daemon/, Node.js 20.10 or newer). Then run thronectl pair to confirm the device. The README has the full steps.
Checked: daemon tests, and the firmware link and crypto code built for the host against a live daemon (pairing, RPCs, terminal streaming, reconnect). Not yet tested on hardware: keyboard, audio, LED and display timing.