Module radio_task 

Macros

global_read 🔒

Read a global setting, propagating transport errors to trigger reconnect. Protocol/parse errors default to the provided fallback (non-fatal).

Enums

EnterAprsError 🔒

Error type for the APRS session helper — the radio is lost, reconnect required.

EnterDStarError 🔒

Error type for the D-STAR gateway session — the radio is lost, reconnect required.

PollError 🔒

Distinguishes transport errors (connection lost) from protocol errors (parse failures). Transport errors break out of the poll loop to the reconnect path. Protocol errors are non-fatal — the current poll cycle is skipped but the connection stays alive.

Constants

POLL_INTERVAL 🔒

Poll interval for reading radio state. ~10 commands per cycle (FQ, SQ, MD, PC, RA, FS per band + globals). SM and BY are NOT polled — they use AI push notifications instead.

RECONNECT_INTERVAL 🔒

Reconnect poll interval after disconnect.

Functions

classify_error 🔒

discover_and_open 🔒

discover_and_open_transport 🔒

Open a transport on the calling thread (must be main for BT).

enter_aprs_session 🔒

Enter APRS mode, run the event loop, and return the radio on clean exit.

enter_dstar_session 🔒

Enter D-STAR gateway mode, run the event loop, and return the radio on clean exit.

freq_down 🔒

Step frequency down by reading current freq + step size, subtracting, and tuning. DW (frequency down) exists but does not echo the resulting frequency, so we compute it manually for accurate TUI display.

poll_band 🔒

Poll per-band state: frequency, squelch setting, mode, power, attenuator, step size.

poll_once 🔒

run_aprs_loop 🔒

Run the APRS event loop until ExitAprs is received or a transport error occurs.

run_dstar_loop 🔒

Run the D-STAR gateway event loop until ExitDStar is received or a transport error occurs.

spawn_with_transport 🔒

Spawn the radio communication task with a pre-opened transport.