03 Configuration

All aspects of tetra-bluestation are configured through a single toml file. A template is present in the example_config folder.

Make a working copy:

cp example_config/config.toml config.toml

Open the config file with your favorite file editor:

nano config.toml

The configuration is split in multiple sections:

• Global configuration
• [phy_io]: PHY Layer configuration
• [net_info]: Network Information
• [cell_info]: Cell Information

Configuration Reminder

• Configuration files are TOML and therefore case-sensitive ("Bs" ≠ "bs").
• All frequencies are expressed in Hz, never in MHz.
• RF parameters in [phy_io] must be consistent with those derived from [cell_info].
• Only one SDR device configuration (iocfg_*) may be active at a time.
• Commented lines are not parsed and have no effect.
• Using incorrect MCC/MNC values or frequencies may violate local regulations.
• Debug logging and RF sample capture generate very large files and additional system load.
• When unsure, consult the relevant ETSI TS 100 392 specifications before changing values.

Global Configuration

Parameter	Default / Example	Possible Values	Notes
config_version	"0.5"(version dependent)	String (version identifier)	Must match the configuration format expected by the running BlueStation version.
stack_mode	"Bs"	String: "Bs", "Ms", "Mon"	Base Station, Mobile Station, or Monitor mode (the latter two aren't available yet). "Bs" required for cell operation.
debug_log	uncommented	String (File path)	Enables verbose logging; large files and additional system load.

[phy_io]: PHY Layer configuration

Parameter	Default / Example	Possible Values	Notes
backend	"SoapySdr"	String: "SoapySdr"	RF backend abstraction layer. Other backends may be added in the future.
dl_tx_file	disabled	String: File path	Dumps generated downlink baseband samples to file (debug only).
ul_rx_file	disabled	String: File path	Dumps received uplink baseband samples to file (debug only).

[phy_io.soapysdr]: SoapySDR Core Settings

Parameter	Default / Example	Possible Values	Notes
tx_freq	438025000	Integer (Hz)	Downlink transmit frequency. Must match cell_info parameters listed below.
rx_freq	433025000	Integer (Hz)	Uplink receive frequency. Must match duplex spacing and band rules.
ppm_err	0.0	Float	Frequency correction for SDR oscillator error.

[phy_io.soapysdr.iocfg_*]: Device-specific information

Uncomment the SDR you're using, comment out any others. Only one iocfg_* subsection should be enabled at a time.

The following table only lists generic settings, that will vary by device.

Parameter	Example	Possible Values	Notes
rx_ant	"TX/RX"	Device-specific strings	Selects RX antenna port.
tx_ant	"TX/RX"	Device-specific strings	Selects TX antenna port.
rx_gain_*	18.0 – 50.0	Float (dB)	RX gain stages depend on hardware.
tx_gain_*	3.0 – 35.0	Float (dB)	TX gain stages depend on hardware.