# HeronSquawk: reconstructing RYLR999 LoRa framing for a mesh network

> HeronSquawk reconstructs the RYLR999 LoRa module's on-air framing from SDR captures so it can exchange packets with Heltec V3.1 SX1262 nodes. The resulting mesh system combines a Python desktop base station, MicroPython node firmware and an Android BLE client, with encrypted messages routed across nodes.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/HogWorxsLabs/Heron_Squawk>
- Primary source: <https://github.com/HogWorxsLabs/Heron_Squawk/blob/f14ed40c5a9bf9573c9bdc16845e9b3639ca9fe8/README.md>
- Catalog page: <https://awesomerea.org/resources/heronsquawk-case/>
- Record JSON: <https://awesomerea.org/resources/heronsquawk-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/heronsquawk-case/index.md)

## Requirements & limits

- **Prerequisites:** An RYLR999 module and a USB serial adapter for the desktop base station; Heltec V3.1 hardware for portable nodes.
- **Prerequisites:** Python 3.9+ for the desktop component and MicroPython on Heltec V3.1 nodes.
- **Limits:** The author says bugs may remain and that key derivation and mesh formation take time on Heltec V3.1 hardware.
- **License:** MIT license.

## Primary sources

1. <https://github.com/HogWorxsLabs/Heron_Squawk/blob/f14ed40c5a9bf9573c9bdc16845e9b3639ca9fe8/README.md>
2. <https://github.com/HogWorxsLabs/Heron_Squawk/blob/f14ed40c5a9bf9573c9bdc16845e9b3639ca9fe8/LICENSE>

## More in Protocols

- [TP-Link SG3428: reconstructing its USB console access](https://awesomerea.org/resources/tplink-sg3428-usb-reset-case/index.md) · Case study
- [ak820-linux: reconstructing AJAZZ AK820 Pro USB control](https://awesomerea.org/resources/ak820-linux-case/index.md) · Case study
- [LUMIX Remote: reconstructing Panasonic S5 camera communication](https://awesomerea.org/resources/lumix-remote-s5-case/index.md) · Case study
- [fix-whxm4-voice: reconstructing WH-1000XM4 voice-pack upload](https://awesomerea.org/resources/fix-whxm4-voice-case/index.md) · Case study
- [OrangeCar: reconstructing the wired CarPlay phone side](https://awesomerea.org/resources/orangecar-case/index.md) · Case study
- [AirDrop-for-Everything: reimplementing AirDrop file transfer](https://awesomerea.org/resources/airdrop-for-everything-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.