swaitsandClaude Opus 4.6
f1df675363
Rebrand from lora-dongle to DongLoRa (portmanteau of dongle + LoRa). Lowercase donglora in Cargo package name, firmware filenames, and code. Splash screen shows "DongLoRa" in 9x15 bold. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
81 lines
2.7 KiB
Markdown
81 lines
2.7 KiB
Markdown
# DongLoRa
|
|
|
|
Transparent LoRa radio over USB. Plug in a board, talk LoRa from your host.
|
|
|
|
## Supported Boards
|
|
|
|
| Board | Status | MCU | Radio |
|
|
|---|---|---|---|
|
|
| Heltec v3 | builds | ESP32-S3 | SX1262 |
|
|
| Heltec v4 | builds | ESP32-S3 | SX1262 |
|
|
| RAK WisBlock / WisMesh (RAK 4631) | **firmware** | nRF52840 | SX1262 |
|
|
|
|
## Next Up
|
|
|
|
High-priority boards — popular, well-documented, should be straightforward:
|
|
|
|
| Board | MCU | Radio | Notes |
|
|
|---|---|---|---|
|
|
| Heltec v2 | ESP32 | SX1276 | Xtensa, older radio |
|
|
| Heltec Wireless Tracker (v1/v2) | ESP32-S3 | SX1262 | GPS + display |
|
|
| Heltec Vision Master E213 / E290 | ESP32-S3 | SX1262 | E-ink display |
|
|
| LilyGo T-Beam (SX1262) | ESP32 | SX1262 | GPS, popular |
|
|
| LilyGo T-Beam Supreme (SX1262) | ESP32-S3 | SX1262 | GPS, newer |
|
|
| LilyGo T-Echo | nRF52840 | SX1262 | E-ink, BLE |
|
|
| LilyGo T3 S3 (SX126x) | ESP32-S3 | SX1262 | Common dev board |
|
|
| RAK WisBlock 3112 | ? | SX1262 | RAK ecosystem |
|
|
| RAK WisMesh 1W Booster (3401 + 13302) | ? | SX1262 | High power |
|
|
| RAK WisMesh Tag | ? | SX1262 | Small form factor |
|
|
| Seeed Studio Xiao nRF52 WIO | nRF52840 | SX1262 | Tiny |
|
|
| Seeed Studio SenseCAP T1000-E | ? | SX1262 | Tracker |
|
|
|
|
## Future
|
|
|
|
Lower priority or niche — contributions welcome:
|
|
|
|
| Board | MCU | Radio |
|
|
|---|---|---|
|
|
| Elecrow ThinkNode M1 / M2 / M3 / M5 / M6 | various | various |
|
|
| GAT-IoT GAT562 30s / Tracker | ? | ? |
|
|
| Heltec Heltec Wireless Paper | ESP32-S3 | SX1262 |
|
|
| Heltec MeshPocket | ESP32-S3 | SX1262 |
|
|
| Heltec MeshSolar / MeshTower | ESP32-S3 | SX1262 |
|
|
| Heltec T114 | nRF52840 | SX1262 |
|
|
| Heltec WSL3 | ? | ? |
|
|
| Ikoka Nano / Stick | ? | ? |
|
|
| Keepteen LT1 | ? | ? |
|
|
| LilyGo T-Beam 1.2 (SX1276) | ESP32 | SX1276 |
|
|
| LilyGo T-Deck (community) | ESP32-S3 | SX1262 |
|
|
| LilyGo T-Echo Lite | nRF52840 | SX1262 |
|
|
| LilyGo T3 S3 (SX127x) | ESP32-S3 | SX1276 |
|
|
| LilyGo LoRa32 V2.1.1.6 | ESP32 | SX1276 |
|
|
| ProMicro nRF52 (faketec) | nRF52840 | SX1262 |
|
|
| RPI Pico 2040 + WaveShare SX1262 | RP2040 | SX1262 |
|
|
| Seeed Studio SenseCAP Solar | ? | SX1262 |
|
|
| Seeed Studio Wio Tracker L1 EINK / Pro | ? | SX1262 |
|
|
| Seeed Studio Xiao C3 | ESP32-C3 | SX1262 |
|
|
| Seeed Studio Xiao S3 WIO | ESP32-S3 | SX1262 |
|
|
| UnitEng Nano G2 Ultra / Station G2 | ? | ? |
|
|
|
|
## Building
|
|
|
|
```sh
|
|
just build-all # build firmware for all boards with available toolchains
|
|
just build heltec_v4 # build a specific board
|
|
just check-all # compile-check all boards (no firmware output)
|
|
just flash heltec_v4 # build + flash via probe-rs
|
|
```
|
|
|
|
### Xtensa (ESP32) boards
|
|
|
|
Requires the [esp toolchain](https://github.com/esp-rs/espup):
|
|
|
|
```sh
|
|
cargo install espup
|
|
espup install --toolchain-version 1.82.0.3
|
|
```
|
|
|
|
### ARM (nRF, STM32) boards
|
|
|
|
Stock Rust stable. Targets are installed automatically.
|