Transmitter Interface: Difference between revisions
Rework documentation for new users: illustrated steps, clear navigation, preserved technical references, and current 0.3.6 behavior |
Simplify user guides and use the cleaned transmitter illustration |
||
| Line 5: | Line 5: | ||
== Read the window in this order == | == Read the window in this order == | ||
[[File:SimTX-0.3.6-first-transmission-guide.png|thumb|center|900px|alt=Transmitter window with annotated configuration and monitoring areas.|The 0.3.6 interface | [[File:SimTX-0.3.6-first-transmission-guide-clean.png|thumb|center|900px|alt=Transmitter window with annotated configuration and monitoring areas.|The 0.3.6 interface with the first-transmission example. On a smaller screen, scroll the left pane to reach the antenna and Start TX.]] | ||
# '''Station''': name and place the virtual station. | # '''Station''': name and place the virtual station. | ||
| Line 16: | Line 16: | ||
== Server selector == | == Server selector == | ||
After | After signing in, select a server and use '''Connect''' to open the main window. '''Disconnect''' returns to this selector. | ||
If the connection to the server drops while the application is running, the title area indicates that the client is reconnecting and retries every 3 seconds. | If the connection to the server drops while the application is running, the title area indicates that the client is reconnecting and retries every 3 seconds. | ||
| Line 73: | Line 71: | ||
| BUF || s || Audio buffer fill | | BUF || s || Audio buffer fill | ||
|} | |} | ||
Before | Before transmission, the deck shows an estimate. During transmission, it shows the selected session’s measurements. If the amplifier overheats the header shows a PA OVERHEATED warning, see [[Power Amplifier Behaviour]]. | ||
== Active Sessions == | == Active Sessions == | ||
Latest revision as of 22:13, 13 September 2026
This page is a reference for the SimTX Transmitter application window. The window is split into a configuration form on the left and a live monitoring area on the right, with a status bar at the bottom.
Read the window in this order[edit | edit source]

- Station: name and place the virtual station.
- RF Signal: choose the radio frequency, output power, and modulation.
- Transmission Source: choose the sound or data to send.
- Antenna: match the antenna to that frequency.
- Start TX: create a session, then select it in the list on the right.
The right-hand meters describe the selected session, or an estimate before transmission. A nonzero local estimate does not mean a transmission has started. The complete first-use sequence is in Getting Started.
Server selector[edit | edit source]
After signing in, select a server and use Connect to open the main window. Disconnect returns to this selector.
If the connection to the server drops while the application is running, the title area indicates that the client is reconnecting and retries every 3 seconds.
Station section[edit | edit source]
- Server row with a Disconnect button (returns to the server selector).
- Callsign: station identifier shown to the server and other users. Persisted between runs.
- Location: a clickable world map that fills the Lat and Lon fields. Coordinates can also be typed directly. Persisted between runs.
RF Signal section[edit | edit source]
- Frequency (Hz): carrier frequency. Default 4625000 (4625 kHz), chosen to match the default antenna, see Getting Started.
- Power (W): requested transmitter output power. Default 100.
- Radio Preset: selects a transmitter character, see Radio Presets. Selecting a preset overwrites the power field and all advanced settings.
- Modulation: the built-in or installed Lua modulation mode, see Modulation Modes and Lua extensions. Installed modes add their own controls and inputs below the standard fields.
- Bandwidth (Hz) with an Auto checkbox. Auto fills the typical bandwidth of the selected mode. Default 2700.
- Low-cut (Hz): audio low-frequency cutoff. Default 350. Editable only for modes where it applies.
- Show advanced transmitter settings: expands the fifteen fine-tuning fields, see Advanced Transmitter Settings.
Transmission Source section[edit | edit source]
- Source Type: see Transmission Sources.
- Audio Gain: input level, default 0.9.
- Microphone: device selector, visible only for the Microphone source.
- Tone (Hz): test tone frequency, default 1000. For the GNU Radio IQ source this field is relabelled IQ Port.
- Audio File row with Choose..., URL..., and Repeat. Local files can also be dragged onto the window (wav, mp3, aiff, aif, au). URL accepts HTTP and HTTPS audio streams. Repeat restarts a local file when it ends.
A hint line below the controls describes the currently selected source.
Antenna section[edit | edit source]
- Type: antenna selector, default EFHW + 49:1 unun. See Antenna System.
- Wire Length (m): main dimension of the antenna. The label adapts to the type (Circumference for the loop, Element Length for the vertical, Driven Element for the Yagis). A value of 0 selects the nominal type-specific template length; it does not guarantee low SWR. The EFHW template uses 32.5 m.
- Height (m): feedpoint or apex height above ground. Default 10.
- Azimuth (°): orientation, 0 is north. Disabled for the vertical, which is omnidirectional.
- Feedline Loss (dB): fixed loss between transmitter and antenna.
- Import NEC... and Use built-in: load or clear a custom antenna geometry, see NEC File Import.
Start row[edit | edit source]
- Start TX: starts a transmission session with the current configuration.
- Presets: applies installed presets, saves the current settings, or loads a
.stxpresetfile. A preset includes every field, the source selection, and any imported NEC deck.
Radio Deck[edit | edit source]
The right-hand panel shows six meters:
| Meter | Unit | Meaning |
|---|---|---|
| FWD | W | Forward output power |
| REF | W | Reflected power returning from the antenna |
| SWR | :1 | Standing wave ratio at the transmitter |
| ALC | dB | Automatic level control action |
| TEMP | °C | Power amplifier finals temperature |
| BUF | s | Audio buffer fill |
Before transmission, the deck shows an estimate. During transmission, it shows the selected session’s measurements. If the amplifier overheats the header shows a PA OVERHEATED warning, see Power Amplifier Behaviour.
Active Sessions[edit | edit source]
A list of the operator's sessions with id, callsign, frequency, modulation, power, status, source, SWR, bandwidth, and server address. Listen to Own TX monitors the selected running signal as received by the server before propagation. Live Edit changes its frequency, power, bandwidth, low cut, final drive, PA headroom, and compression without starting a new session. Frequency changes take effect on Enter, while the other fields apply after a short pause. Auto Reconnect restarts a session after a connection error. Other buttons are Stop Selected, Stop All, and Clear Finished. Session states are described in Sessions and Queueing.
[edit | edit source]
- Extensions: lists installed packages, runs tools, reports loading problems, and provides package creation and editing. See Lua extensions.
- Add-ons: enables, configures, and orders installed Lua audio processors.
- Catalog: browses, installs, and publishes shared extensions and presets. See Extension catalog.
- Theme: selects the system appearance or an installed Lua theme.