Sessions and Queueing: Difference between revisions
Add and update user documentation for Lua extensions and the catalog |
Simplify user guides and use the cleaned transmitter illustration |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{Documentation navigation}} | |||
Every transmission is a session between the transmitter client and the server. The server decides whether a new session is admitted immediately, queued or rejected. | Every transmission is a session between the transmitter client and the server. The server decides whether a new session is admitted immediately, queued or rejected. | ||
== Operate one session == | |||
# Press Start TX once and select the new row. | |||
# Wait while it is Queued; check the reason if it is Failed or Kicked. | |||
# When Running, use Listen to Own TX to check the signal before propagation. | |||
# Use Stop Selected to stop that row. Stop All ends every session in this app. | |||
Changing the ordinary setup form prepares another transmission. To change an existing running session, select it and enable '''Live Edit'''. Only the supported fields listed below are editable in place. Clear Finished removes old rows; it does not start or stop a transmission. | |||
== Session lifecycle == | == Session lifecycle == | ||
| Line 12: | Line 23: | ||
== Server limits == | == Server limits == | ||
Servers can limit the total number of sessions, the number of transmit sessions, and the number of sessions per user. | Servers can limit the total number of sessions, the number of transmit sessions, and the number of sessions per user. Your transmission allowance depends on your account and the server’s rules. When a transmit limit is reached new sessions are queued in order; when a policy forbids the session outright it is rejected with a reason. | ||
== Multiple sessions == | == Multiple sessions == | ||
| Line 23: | Line 34: | ||
== Disconnects == | == Disconnects == | ||
If the control connection drops, the client reconnects automatically every 3 seconds. When '''Auto Reconnect''' is selected, a session interrupted by a connection error is started again after the connection returns. Sessions that were kicked or rejected show the | If the control connection drops, the client reconnects automatically every 3 seconds. When '''Auto Reconnect''' is selected, a session interrupted by a connection error is started again after the connection returns. Sessions that were kicked or rejected show the reason. | ||
[[Category:SimTX]] | [[Category:SimTX]] | ||
Latest revision as of 22:13, 13 September 2026
Every transmission is a session between the transmitter client and the server. The server decides whether a new session is admitted immediately, queued or rejected.
Operate one session[edit | edit source]
- Press Start TX once and select the new row.
- Wait while it is Queued; check the reason if it is Failed or Kicked.
- When Running, use Listen to Own TX to check the signal before propagation.
- Use Stop Selected to stop that row. Stop All ends every session in this app.
Changing the ordinary setup form prepares another transmission. To change an existing running session, select it and enable Live Edit. Only the supported fields listed below are editable in place. Clear Finished removes old rows; it does not start or stop a transmission.
Session lifecycle[edit | edit source]
A session created with Start TX passes through these states:
- Starting: the client is contacting the server.
- Queued: the server is full for now; the list shows how many sessions are ahead. The session starts automatically when a slot frees up.
- Running: the transmission is on the air and telemetry updates the Radio Deck.
- Stopping / Stopped: the operator ended the session.
- Finished: the source completed (for example the audio file ended).
- Failed: the server rejected the session; the reason is shown.
- Kicked: the server operator ended the session remotely; a dialog shows the reason.
Server limits[edit | edit source]
Servers can limit the total number of sessions, the number of transmit sessions, and the number of sessions per user. Your transmission allowance depends on your account and the server’s rules. When a transmit limit is reached new sessions are queued in order; when a policy forbids the session outright it is rejected with a reason.
Multiple sessions[edit | edit source]
The client can run several sessions at once (subject to server limits). The Active Sessions list shows each with its own state, and Stop Selected / Stop All control them individually or together.
Monitoring and live editing[edit | edit source]
Listen to Own TX monitors the selected running transmission as the server receives it, before propagation. It is intended for checking the transmitted signal rather than reception conditions.
Live Edit loads selected parameters from a running session into the form. Frequency, power, bandwidth, low cut, final drive, PA headroom, and compression can be changed in place. Frequency is committed by pressing Enter. Other supported values apply after a short pause. Leaving Live Edit restores the unfinished form that was present before editing.
Disconnects[edit | edit source]
If the control connection drops, the client reconnects automatically every 3 seconds. When Auto Reconnect is selected, a session interrupted by a connection error is started again after the connection returns. Sessions that were kicked or rejected show the reason.