Documentation
Onboarding
Getting Started
Power & Battery
Hardware & Components
Build & Assembly
Radio & RF Design
Frequencies & Regulations
Firmware & Software
USB & Connectivity
GPS & Navigation
Morse & Communication
Modes & Operation
Field Operations & Rescue
Building Effectively
Build Variants
Project & Reference
Docs Firmware & Software Factory Reset and Recovery

Factory Reset and Recovery

Edit on GitHub

Wipe NVS, clear a stuck EMERGENCY flag, and get the beacon back to known-good defaults

Factory Reset and Recovery

Overview

Three recovery procedures cover almost every “my beacon is doing something wrong” situation: a full NVS wipe, clearing a stuck EMERGENCY flag, and reflashing after a bad configuration.

Method 1: Hardware Factory Reset

Hold SW_MODE + SW_SEL together at boot for at least 5 seconds.

DetailValue
ButtonsMODE (GPIO 33) + SEL (GPIO 32)
Hold time>= 5000 ms
EffectErases the aegis NVS namespace
AfterReboots with hardcoded defaults

The RTC boot counter is not part of NVS and survives the reset, which is useful for tracking.

Method 2: Dashboard Factory Reset

From the CONFIG portal (http://192.168.4.1):

  1. Enter CONFIG mode (hold SEL 3 s).
  2. Open the dashboard.
  3. Press the factory reset button.
  4. The device POSTs to /factory, wipes NVS, and reboots.

Method 3: Clearing a Stuck EMERGENCY Flag

The EMERGENCY flag lives in RTC RAM and survives power cycles by design. To clear it:

  1. Enter CONFIG mode by holding SEL for 3 seconds.
  2. Save any setting from the dashboard (or press the emergency-clear action).
  3. The device reboots into the selected normal mode.

If the buttons do not respond because the beacon is transmitting:

  • Power off, wait 10 s, power on, and hold SEL immediately at boot.

After Recovery

StateAction
Defaults loadedReconfigure frequencies and identity
Frequencies lostRe-enter them via the portal
Name and GPS lostRe-enter identity and GPS settings
Boot counterCheck the serial log to confirm the reset