This repository has been archived on 2026-08-31. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
donglora/firmware
swaits 5728d57caf fix: display stuck on splash for UART boards (disconnected flag)
The display task started with disconnected=true, waiting for a
DisplayCommand::On that the USB task sends on DTR connect. The UART
task has no DTR, so the display never left the "disconnected" state
and ignored all radio status updates. Start connected instead — the
USB task will send Reset on actual disconnect.
2026-04-07 10:27:27 -06:00
..
2026-04-06 22:30:45 -06:00
2026-04-06 21:15:35 -06:00
2026-04-03 10:28:38 -06:00
2026-04-06 21:15:35 -06:00
2026-04-06 22:30:45 -06:00
2026-04-07 08:18:28 -06:00
2026-04-06 21:15:35 -06:00
2026-04-03 10:28:38 -06:00
2026-04-03 10:28:38 -06:00
2026-04-07 08:18:28 -06:00

DongLoRa Firmware

Embedded Rust firmware for DongLoRa boards. Exposes the LoRa radio over USB CDC-ACM using a COBS-framed binary protocol.

Building

just setup              # one-time toolchain install
just build heltec_v4    # build for a specific board
just flash heltec_v4    # build + flash
just check-all          # compile-check all boards
just clippy heltec_v4   # lint
just test               # host-side protocol unit tests

All commands are run from the firmware/ directory.

Supported Boards

Board MCU Radio Target
Heltec V3 ESP32-S3 SX1262 xtensa-esp32s3-none-elf
Heltec V4 ESP32-S3 SX1262 xtensa-esp32s3-none-elf
RAK WisBlock 4631 nRF52840 SX1262 thumbv7em-none-eabihf

Adding a Board

See src/board/PORTING.md.

Protocol

See PROTOCOL.md for the complete wire format specification.