-
Notifications
You must be signed in to change notification settings - Fork 3
Firmware Dongle v4
OneSeventyFour edited this page May 15, 2026
·
2 revisions
| Released | 2026-04 |
| Status | Superseded by v5 |
| Pairs with receiver | v9+ |
| Predecessor | v3 |
| Notable | ACK-payload protocol overhaul — major wire-protocol break. |
| File | Purpose | Download |
|---|---|---|
os4_dongle_v4.bin |
App partition. | Download |
os4_dongle_v4.bootloader.bin |
Chip bootloader. | Download |
os4_dongle_v4.partitions.bin |
Partition table. | Download |
os4_dongle_v4.boot_app0.bin |
OTA "next-app" pointer. | Download |
ACK-payload protocol overhaul.
- Status piggybacks in the auto-ACK (single round trip per command).
- Dynamic payloads enabled (smaller frames take less air time).
- Non-blocking dispatcher (no inner busy-wait, no per-cmd 150 ms stall).
- TDMA-style status polling cycle (round-robin every
clockSyncIntervalMs). - Soft recovery (
flush_tx/rx+ channel scrub instead ofpowerDown). - Payload bounds-checking on receive.
-
MAX_RECEIVERSbumped to 32, command queue to 128. - Packed
SHOW_LOADN(up to 6 cues per RF frame). - Configurable
rf_channelandrf_system_idat runtime.
- Hard wire-protocol break. Pair with receiver FW v9+; older receivers cannot communicate with this dongle.
- Worth upgrading the entire fleet at once.
-
MAX_RECEIVERS=32makes this the first dongle release that comfortably supports a fleet larger than the original 16-receiver design ceiling.
Getting started
- Overview
- Desktop installers (macOS / Windows)
- macOS
- Linux
- Windows
- Production vs Development
- Connecting the dongle
- Flash a receiver
- Flash a dongle
- OTA flashing
Raspberry Pi
System overview
Subsystems
Hardware
- Receiver firmware
- Dongle firmware
- RF protocol
- Contributor Portal — BOMs, schematics, and board resources
UI walkthrough
Reference
Downloads
- Firmware
- Installers
Module Build & User Guides
- Cue
- Receiver
- Dongle