Board-aware firmware, recovery tooling, documentation, and browser flasher for the Heltec WiFi LoRa 32 V3.
This is a non-flashable foundation. It has no Meshtastic source, radio drivers, OTA support, or hardware validation. The first board image will be serial-only, versioned, checksummed, and recovery-tested.
The recovery-safe Huginn serial bring-up implementation is in
firmware/esp-idf/. It produces base and recovery artifacts only through the
pinned container contract. It does not authorize a browser or automatic flash;
see docs/serial-bringup.md.
The Heltec executes only declared board-native capabilities. Remote systems such as Ragnar consume typed results; they do not receive generic radio, shell, or adapter control. External hardware appears unavailable unless verified.
Huginn owns the device-side product boundary:
- Device firmware - board-aware Rust-first firmware for the Heltec WiFi LoRa 32 V3. It owns only verified onboard capabilities, local state, recovery, and the narrow protocol boundary.
- Browser flasher - the static GitHub Pages application in
web/flasher. It presents releases, recovery instructions, and a user-authorized Web Serial path. It never silently selects or flashes a device, and it refuses incomplete release metadata. - Product documentation - board evidence, recovery policy, installation, and the human-facing onboarding contract.
The separate Muninn repository owns the optional desktop companion. Muninn may use a declared, verified local transport to a Huginn device, but USB presence or device proximity alone never grants a capability.