From 7bf404135777f188b22a9466a9a57c12038ee480 Mon Sep 17 00:00:00 2001
From: Stephen Waits <steve@waits.net>
Date: Thu, 26 Mar 2026 17:44:52 -0600
Subject: [PATCH] docs: add README with board support matrix

Three tiers: supported now, next up (popular/straightforward), and
future (niche/contributions welcome). Board names follow MeshCore
flasher conventions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 README.md | 80 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..ed65602a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,80 @@
+# lora-dongle
+
+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.