SimTX API v24/Packets/StationList

StationList

Packet ID	9(0x09)
Direction	Server → client
Session	Control
Body size	Variable
Permission	None
Answered by
Answers	ListStations

StationList lists every station currently connected to the server, both transmitters and receivers, with their frequency, mode, power and position.

Layout

Field	Type	Description
packetId	u8	Always 9.
count	i32	Number of stations, at most 100,000.
stations	count × Station	See below.

Station

Field	Type	Description
stationUuid	UTF	Station UUID, unique for the session.
callsign	UTF	Callsign.
transmitting	bool	True for a transmitter, false for a receiver.
frequencyHz	f32	Transmitter: carrier frequency. Receiver: centre frequency.
modulation	UTF	Transmitter: Modulation name. Receiver: empty.
powerWatts	f32	Transmitter: requested power. Receiver: 0.
latitudeDeg	f64	Station latitude.
longitudeDeg	f64	Station longitude.
address	UTF	Client address. Always empty on a control session; filled in only for moderators.
declaredBandwidthHz	f32	Transmitter: occupied bandwidth as measured by the server. Receiver: filter bandwidth.

Usage

• The list is a snapshot. Poll ListStations to follow changes, every few seconds at most.
• A single server sorts the list by callsign. Through the public gateway, the lists of all server nodes are merged into one, so do not rely on the order.
• A station's UUID changes every time it reconnects. Callsigns are not unique.
• Positions are as the operator entered them.