Enable the TCI server for Log4OM / SunSDR clients¶
The TCI applet runs a WebSocket server that exposes radio control and audio to third-party software such as Log4OM and SunSDR tools. Enable it to let those clients connect to AetherSDR over the TCI protocol.
Before you start¶
- AetherSDR must be connected to the radio. The TCI server requires an active radio connection.
- Decide which port the server will listen on. The default is
50001. If another application already occupies that port, choose a different one in the range 1024–65535.
Steps¶
- Click the TCI tray button on the right sidebar. The TCI Server applet panel opens.
- Confirm the Port field shows the port you want. The default is
50001. To change it, click the field, type a new value (1024–65535), and press Enter. Values outside that range snap back to50001. - Click Enable. The button turns green when the server is running.
- Check the status indicator to the left of Enable. It shows
:<port> (0 clients)when the server is up and waiting, and updates the client count as software connects.
What each control does¶
| Control | Default | Range / States |
|---|---|---|
| Port text field | 50001 |
1024–65535; invalid values snap to 50001 |
| Enable toggle | Off | Off / On (green) |
| RX1–RX4 gain meter/slider | 0.5 |
0.0–1.0 |
| TX gain meter/slider | 0.5 |
0.0–1.0 |
| RX/TX slice-assignment labels | — |
— or Slice <letter> (may show HTML formatting) |
| Server status indicator | (stopped) |
(stopped), :<port> (N clients), (port in use) |
| TX overflow mode (right-click) | Right-click the TX gain meter/slider to open a context menu selecting the TX overflow handling mode. Emits tciTxOverflowModeChanged. |
Three choices: Clip (0) — Hard-clamp overshoots to ±1.0; defensive default that introduces harmonics but protects downstream int16 conversion. NaN guard (1) — Pass samples through bit-exact; only zero pathological NaN/Inf values; preserves digital-mode tone fidelity. Measure only (2) — Never mutate samples; count overshoots for telemetry; downstream int16 conversion still clamps in the radio-native DAX route. Persisted as TciTxOverflowMode. |
The RX1–RX4 rows show which slice drives each TCI channel. The label reads Slice A, Slice B, and so on, based on the DAX channel assignment of each slice. The TX row shows the currently active TX slice. Slice labels now use rich text formatting (#2606).
The status indicator now uses theme-aware colors for better visibility across light and dark UI themes (v26.6.1).
The gain meter/slider controls have accessibility names set for screen reader support. The RX controls are named "TCI RX 1 gain" through "TCI RX 4 gain", and the TX control is named "TCI TX gain".
Tips¶
- To start the TCI server automatically every time AetherSDR launches, go to
Settings > Autostart TCI with AetherSDRand enable that item. See Autostart TCI on launch. - The client count in the status indicator updates in real time as software connects or disconnects.
- Use the right-click menu on the TX gain meter/slider to select how out-of-range samples from digital-mode clients are handled. Clip is the default and protects against excessive drive; NaN guard and Measure only preserve bit-exact digital-mode tone fidelity.
Troubleshooting¶
- Enable snaps back to off and status shows
(port in use)— Another application is already bound to that port. Enter a different port number in the Port field and click Enable again. - Status stays
(stopped)after clicking Enable — Verify that AetherSDR is connected to the radio. The TCI server requires an active radio connection.