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 Frequency Setting over Serial

Frequency Setting over Serial

Edit on GitHub

Set the beacon's desired frequency with the FREQ serial command, verify it, and persist it without the dashboard.

Frequency Setting over Serial

The fastest way to put the beacon on a specific frequency is the FREQ serial command from v5.5. No dashboard, no button dance: one line, persisted.

The command

CODE
FREQ 433.500

Rules:

  • Range is 410-525 MHz, matching the SX1262’s coverage (see SX1262 Frequency Ranges).
  • The value is written to the beacon’s primary frequency slot (freqs[0]) and saved to NVS, so it survives deep sleep and reboot.
  • Out-of-range values are rejected with AEGIS:ERR:....

Verify

CODE
FREQ?

prints every configured frequency:

CODE
AEGIS:FREQ:0=433.500

Or use STATUS to see the active frequency in the state line.

Where to type it

Typical use

GoalCommand
Primary channelFREQ 433.500
Channel with known activityFREQ 433.775
PMR safety channel inside rangeFREQ 446.08125 (see Frequency Compatibility)
Back to defaultFREQ 433.500

What the beacon does with it

The first configured frequency is used for the next beacon cycle, and the hop sequence still cycles all configured frequencies in order. To transmit on only the new frequency, configure a single-frequency list in the dashboard.