{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/HogWorxsLabs/Heron_Squawk/blob/f14ed40c5a9bf9573c9bdc16845e9b3639ca9fe8/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "HeronSquawk 根据 SDR 抓包重建 RYLR999 LoRa 模块的空中帧格式，使其能与 Heltec V3.1 的 SX1262 节点交换数据。项目包含 Python 桌面基站、MicroPython 节点固件和 Android BLE 客户端，支持加密消息在节点间转发。",
  "entry_url": "https://awesomerea.org/resources/heronsquawk-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/heronsquawk-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/HogWorxsLabs/Heron_Squawk/blob/f14ed40c5a9bf9573c9bdc16845e9b3639ca9fe8/README.md",
  "group": "cases",
  "id": "heronsquawk-case",
  "json_url": "https://awesomerea.org/resources/heronsquawk-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/heronsquawk-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/heronsquawk-case/index.md",
  "name": "HeronSquawk: reconstructing RYLR999 LoRa framing for a mesh network",
  "name_zh": "HeronSquawk：重建 RYLR999 LoRa 帧格式以连接网状网络",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "An RYLR999 module and a USB serial adapter for the desktop base station; Heltec V3.1 hardware for portable nodes.",
    "Python 3.9+ for the desktop component and MicroPython on Heltec V3.1 nodes.",
    "The author says bugs may remain and that key derivation and mesh formation take time on Heltec V3.1 hardware.",
    "MIT license."
  ],
  "requirements_zh": [
    "桌面基站需要 RYLR999 模块和 USB 串行适配器；便携节点需要 Heltec V3.1 硬件。",
    "桌面组件需要 Python 3.9+；Heltec V3.1 节点需要 MicroPython。",
    "作者表示项目可能仍有缺陷，Heltec V3.1 上的密钥派生和组网需要一定时间。",
    "MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/HogWorxsLabs/Heron_Squawk",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}