Configuration

Configuration

The fully annotated reference config lives at example_config/config.toml. This page documents each section.

Mandatory

[phy_io.soapysdr]
tx_freq = 438025000   # Downlink frequency in Hz
rx_freq = 433025000   # Uplink frequency in Hz

[net_info]
mcc = 204             # Mobile Country Code
mnc = 1337            # Mobile Network Code

[cell_info]
freq_band = 4         # 4 = 400 MHz band
main_carrier = 1521
duplex_spacing = 4
location_area = 2
colour_code = 1

Timing

Parameter	Default	Description
hangtime_secs	5	Hold group call circuit after floor release (0–300s)
call_timeout_secs	120	Max call duration before forced D-RELEASE (0 = unlimited)
ul_inactivity_secs	3	UL silence before forced TX-CEASED (1–30s)
periodic_registration_secs	3600	T351 interval; 0 = disabled

Dashboard

[dashboard]
port = 8080

# Optional: HTTP Basic Auth
username = "admin"
password = "changeme"

# Optional: explicit git source path for OTA updates
# source_dir = "/opt/flowstation"

Home Mode Display (callsign on radio screen)

[cell_info.home_mode_display]
text = "YO6RZV"              # Shown on radio home screen
interval_multiframes = 96    # ≈ 96 seconds
protocol_id = 220
text_coding_scheme = "LATIN"

Access control

[security]
issi_whitelist = [2260571, 2260572]   # Only these ISSIs can register

See Remote Control for sds_command_control, and Brew Interconnect for the [brew] section.

Fallback config

If FlowStation fails to parse config.toml at startup (e.g. after a bad dashboard edit), it automatically tries config.toml.fallback. Create it once from a known-good config:

cp config.toml config.toml.fallback

When running on fallback, the dashboard shows a persistent red warning banner with the parse error, so you can fix the primary config remotely without losing access to the cell.