← Web interface, download and registration
Under Radio & Power, the extra section shows values active in the transmitter and the saved values for the next startup. Changes are only saved. Restart the transmitter explicitly from the overview; saving does not interrupt current radio operation.
Settings
| Value | Range | Meaning |
|---|---|---|
| Digital amplitude | 0.05 to 1.0 | Multiplier applied to I/Q samples supplied to the driver. |
| TX DC I | −0.05 to +0.05 | DC component of the I signal after scaling. |
| TX DC Q | −0.05 to +0.05 | DC component of the Q signal after scaling. |
A factor of 1.0 leaves the original amplitude unchanged. 0.35 means 35% of that amplitude, or −9.12 dB; it does not mean 35% of digital full scale or a specific output power in watts. I/Q offsets are relative to digital full scale. They are added only to active transmit samples, so gaps do not receive extra DC excitation. RF-switch decisions use the input signal.
Input peak, output peak and clipping counters describe roughly the first three seconds after transmitter startup. This is not continuous measurement and does not replace an RF power or spectrum measurement. Unclipped digital samples do not rule out analogue distortion in the transmit path.
Calibration
Digital amplitude and analogue DAC/mixer gain jointly affect RF output. First use an external receiver or spectrum analyser to find a level with sufficient linearity. Then adjust I and Q in small steps at that level to minimise the centre line. Save each step, restart the transmitter and verify the actual active values.
Calibration depends on hardware, frequency, analogue gain and operating conditions. Do not adopt another station’s values without checking. The package therefore supplies neutral defaults (1.0 / 0 / 0), not a personal DL7OLG profile. The interface has no automatic sweep.
Required changes
patches/sxxcvr-dashboard.patch contains all changes against sxxcvr commit 9705147dd8c189625071f3f163ea56119bda4a05:
- Startup with a fixed reference clock and RX/TX frequencies.
- Bounded amplitude scaling and TX I/Q DC correction.
- Robust conversion including limiting and non-finite sample handling.
- Digital measurement window and status report from the running driver.
- A C++ test program covering conversion, limits and RF switching.
patches/bluestation-dashboard.patch contains all changes against BlueStation commit 09d4e0d9a0b8cf6c881e77353db325df9a4715aa: additional group subscriptions, GPS LIP routing, local audio monitoring and CRC messages at INFO level. TX calibration itself is in the SoapySX driver; copying web files alone is insufficient. Attribution and licences are in NOTICE and licenses/; the new TxCalibration.hpp has its own MIT notice.
Saved and active values
/etc/tetra-bluestation/tx-calibration.env: saved settings./etc/systemd/system/bluestation-bs.service.d/40-tx-calibration.conf: loads these settings when the radio service starts./usr/local/share/soapysx/tx-calibration.json: registered driver path and checksum. Register usingscripts/register-tx-driver.py./var/lib/tetra-bluestation/tx-status.json: active values and startup measurement written by the driver. Only two writes per driver instance.
Status is matched using boot ID, PID and process start time. An old report or a stopped transmitter is not shown as current. Replacing a driver without matching registration disables the input fields. Registration starts no transmitter and preserves existing calibration values.
Backup and restore
Backup format version 2 adds tx_calibration with amplitude, I and Q. Restoring saves these values for the next startup. Version 1 and older TOML backups do not alter existing TX calibration. Runtime reports and binaries are not part of a configuration backup; back up drivers and sources separately.
Update an existing installation
-
Download a configuration backup. Also back up
/opt/tmo-dashboard, the SoapySX library, service drop-ins and any registration file. -
Build both patched radio components in fresh source trees, using the commits specified in
INSTALLATION.md. Inspect and preserve existing local modifications separately. Do not apply complete patches to already patched sources. -
Stop the transmitter. Install the new driver and, if required, BlueStation. Copy all Python modules and the entire
static/directory from the same package into/opt/tmo-dashboard. Preserve configuration, accounts, certificates and operating mode; do not overwrite them with an example configuration. -
Register the actual installed library path:
sudo python3 scripts/register-tx-driver.py --library /usr/local/lib/SoapySDR/modules0.8/libSXSupport.so sudo systemctl restart tmo-dashboard -
Reload the interface, check saved values and start the transmitter from the overview. Check active values and, after three seconds, the digital startup measurement. If problems occur, restore the backed-up programs and corresponding service files, then reload systemd.
The driver checksum format is version-specific. A later unpatched upstream update does not automatically replace this extension. The package provides source material for the setup described; publishing the package does not expose the personal administration interface.

