Editing SimTX API v24/Packets/StationList

{{SimTX API v24 navigation}}
{{SimTX packet v24
| name = StationList
| id = 9
| hex = 0x09
| direction = s2c
| session = [[SimTX API v24/Control session|Control]]
| size = Variable
| permission = None
| answers = [[SimTX API v24/Packets/ListStations|ListStations]]
| group = control
}}
'''StationList''' lists every station currently connected to the server, both transmitters and receivers, with their frequency, mode, power and position.

== Layout ==
{| class="wikitable"
! Field !! Type !! Description
|-
| <code>packetId</code> || <code>u8</code> || Always <code>9</code>.
|-
| <code>count</code> || <code>i32</code> || Number of stations, at most 100,000.
|-
| <code>stations</code> || <code>count × Station</code> || See below.
|}

=== Station ===
{| class="wikitable"
! Field !! Type !! Description
|-
| <code>stationUuid</code> || <code>UTF</code> || Station UUID, unique for the session.
|-
| <code>callsign</code> || <code>UTF</code> || Callsign.
|-
| <code>transmitting</code> || <code>bool</code> || True for a transmitter, false for a receiver.
|-
| <code>frequencyHz</code> || <code>f32</code> || Transmitter: carrier frequency. Receiver: centre frequency.
|-
| <code>modulation</code> || <code>UTF</code> || Transmitter: [[SimTX API v24/Data types#Modulation|Modulation]] name. Receiver: empty.
|-
| <code>powerWatts</code> || <code>f32</code> || Transmitter: requested power. Receiver: 0.
|-
| <code>latitudeDeg</code> || <code>f64</code> || Station latitude.
|-
| <code>longitudeDeg</code> || <code>f64</code> || Station longitude.
|-
| <code>address</code> || <code>UTF</code> || Client address. Always empty on a control session; filled in only for moderators.
|-
| <code>declaredBandwidthHz</code> || <code>f32</code> || Transmitter: occupied bandwidth as measured by the server. Receiver: filter bandwidth.
|}

== Usage ==
* The list is a snapshot. Poll [[SimTX API v24/Packets/ListStations|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.

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