SimTX API v24/Packets/TxQueue - Revision history

Clanker: Archive the v24 protocol reference: use the v24 templates, links and categories

2026-10-24T16:18:54Z

Archive the v24 protocol reference: use the v24 templates, links and categories

← Older revision		Revision as of 16:18, 24 October 2026
Line 1:		Line 1:
	{{SimTX API navigation}}		{{SimTX API v24 navigation}}
	{{SimTX packet		{{SimTX packet v24
	\| name = TxQueue		\| name = TxQueue
	\| id = 4		\| id = 4
	\| hex = 0x04		\| hex = 0x04
	\| direction = s2c		\| direction = s2c
	\| session = [[SimTX API/Transmitter session\|Transmitter]]		\| session = [[SimTX API v24/Transmitter session\|Transmitter]]
	\| size = 8 bytes		\| size = 8 bytes
	\| permission = None		\| permission = None
	\| answers = [[SimTX API/Packets/TransmitterSessionRequest\|TransmitterSessionRequest]]		\| answers = [[SimTX API v24/Packets/TransmitterSessionRequest\|TransmitterSessionRequest]]
	\| group = transmitter		\| group = transmitter
	}}		}}
	'''TxQueue''' tells a transmitter client that every transmitter slot on the server is taken and that its request is waiting in line. The server sends it when the request enters the queue, and again whenever the position changes, at most about once a second, until it sends [[SimTX API/Packets/TxAccept\|TxAccept]].		'''TxQueue''' tells a transmitter client that every transmitter slot on the server is taken and that its request is waiting in line. The server sends it when the request enters the queue, and again whenever the position changes, at most about once a second, until it sends [[SimTX API v24/Packets/TxAccept\|TxAccept]].

	== Layout ==		== Layout ==
Line 27:		Line 27:
	* Keep the connection open and keep reading. Do not send samples until TxAccept.		* Keep the connection open and keep reading. Do not send samples until TxAccept.
	* Show the position to the user, for example ''Waiting for a transmitter slot: 2 ahead of you''.		* Show the position to the user, for example ''Waiting for a transmitter slot: 2 ahead of you''.
	* Accounts with the <code>session.queue_skip</code> permission are never queued. When the server is full they receive [[SimTX API/Packets/TxReject\|TxReject]] with ''Server transmitter capacity reached'' instead.		* Accounts with the <code>session.queue_skip</code> permission are never queued. When the server is full they receive [[SimTX API v24/Packets/TxReject\|TxReject]] with ''Server transmitter capacity reached'' instead.
	* Closing the connection leaves the queue.		* Closing the connection leaves the queue.

	{{SimTX API navbox}}		{{SimTX API v24 navbox}}
	[[Category:SimTX API]]		[[Category:SimTX API v24]]

Clanker: Clanker moved page SimTX API/Packets/TxQueue to SimTX API v24/Packets/TxQueue: Archive the v24 protocol reference

2026-10-24T16:18:51Z

Clanker moved page SimTX API/Packets/TxQueue to SimTX API v24/Packets/TxQueue: Archive the v24 protocol reference

← Older revision	Revision as of 16:18, 24 October 2026
(No difference)

Clanker: SimTX API documentation

2026-10-24T09:59:05Z

SimTX API documentation

New page

{{SimTX API navigation}}
{{SimTX packet
| name = TxQueue
| id = 4
| hex = 0x04
| direction = s2c
| session = [[SimTX API/Transmitter session|Transmitter]]
| size = 8 bytes
| permission = None
| answers = [[SimTX API/Packets/TransmitterSessionRequest|TransmitterSessionRequest]]
| group = transmitter
}}
'''TxQueue''' tells a transmitter client that every transmitter slot on the server is taken and that its request is waiting in line. The server sends it when the request enters the queue, and again whenever the position changes, at most about once a second, until it sends [[SimTX API/Packets/TxAccept|TxAccept]].

== Layout ==
{| class="wikitable"
! Field !! Type !! Description
|-
| <code>packetId</code> || <code>u8</code> || Always <code>4</code>.
|-
| <code>ahead</code> || <code>i32</code> || Number of requests ahead of this one. 0 means next in line.
|-
| <code>total</code> || <code>i32</code> || Total number of requests in the queue.
|}

== Usage ==
* Keep the connection open and keep reading. Do not send samples until TxAccept.
* Show the position to the user, for example ''Waiting for a transmitter slot: 2 ahead of you''.
* Accounts with the <code>session.queue_skip</code> permission are never queued. When the server is full they receive [[SimTX API/Packets/TxReject|TxReject]] with ''Server transmitter capacity reached'' instead.
* Closing the connection leaves the queue.

{{SimTX API navbox}}
[[Category:SimTX API]]