Files
lunarcore/README.md
STCisGOOD 218d49513d v1.1.0: standalone repeater mode, prebuilt binary, protocol hot-switching
Repeater mode: device auto-relays MeshCore packets when no app is
connected. Enabled by default, toggle with AT+REPEATER=0/1. Includes
deduplication ring and random jitter to prevent loops.

Prebuilt binary: added CI workflow that builds a merged .bin on tag
push so users can flash without installing the Xtensa toolchain.

Protocol hot-switching: auto-resets to detection mode on serial
inactivity (30s) or BLE disconnect. AT+SWITCH for manual reset.

Also: gated test beacons when app connected, updated README with
flash instructions and AT command reference.
2026-02-06 16:46:22 -05:00

42 lines
743 B
Markdown

# LunarCore
Multi-protocol mesh firmware for ESP32-S3 LoRa devices.
## Protocols
- MeshCore
- Meshtastic
- RNode/KISS (Reticulum)
Protocol is auto-detected from the first bytes over serial or BLE.
## Hardware
Heltec WiFi LoRa 32 V3 (ESP32-S3 + SX1262)
## Flash (prebuilt)
Download `lunarcore-esp32s3.bin` from [Releases](../../releases).
```bash
pip install esptool
esptool.py --chip esp32s3 -p PORT write_flash 0x0 lunarcore-esp32s3.bin
```
## Build from source
```bash
espup install
. ~/export-esp.sh
cargo build --release
espflash flash target/xtensa-esp32s3-espidf/release/lunarcore --monitor
```
## Repeater
Enabled by default. Relays MeshCore packets when no app is connected. Disable with `AT+REPEATER=0`.
## License
MIT