SimTX API v24/Packets/TxModeInfo: Difference between revisions
SimTX API documentation |
Archive the v24 protocol reference: use the v24 templates, links and categories |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{SimTX API navigation}} | {{SimTX API v24 navigation}} | ||
{{SimTX packet | {{SimTX packet v24 | ||
| name = TxModeInfo | | name = TxModeInfo | ||
| id = 14 | | id = 14 | ||
| hex = 0x0E | | hex = 0x0E | ||
| direction = c2s | | direction = c2s | ||
| session = [[SimTX API/Transmitter session|Transmitter]] | | session = [[SimTX API v24/Transmitter session|Transmitter]] | ||
| size = Variable | | size = Variable | ||
| permission = None | | permission = None | ||
| Line 26: | Line 26: | ||
== Behaviour == | == Behaviour == | ||
* Send it after [[SimTX API/Packets/TxAccept|TxAccept]]. It may be sent again to change the declaration. | * Send it after [[SimTX API v24/Packets/TxAccept|TxAccept]]. It may be sent again to change the declaration. | ||
* There is no reply. | * There is no reply. | ||
* The current server records the declaration but does not yet display it anywhere. In particular, [[SimTX API/Packets/StationList|StationList]] still reports the transmitter's modulation field and its measured occupied bandwidth. | * The current server records the declaration but does not yet display it anywhere. In particular, [[SimTX API v24/Packets/StationList|StationList]] still reports the transmitter's modulation field and its measured occupied bandwidth. | ||
* Invalid values close the connection. | * Invalid values close the connection. | ||
* Ignored on role 3 (<code>TX_GENERATED</code>) connections. | * Ignored on role 3 (<code>TX_GENERATED</code>) connections. | ||
{{SimTX API navbox}} | {{SimTX API v24 navbox}} | ||
[[Category:SimTX API]] | [[Category:SimTX API v24]] | ||
Latest revision as of 16:18, 24 October 2026
| Packet ID | 14(0x0E)
|
|---|---|
| Direction | Client → server |
| Session | Transmitter |
| Body size | Variable |
| Permission | None |
TxModeInfo declares a human-readable name and occupied bandwidth for the signal a transmitter is sending. It is intended for clients that generate their own modulation, typically with an IQ source, such as a digital mode that the server has no name for. Sending it is optional.
Layout[edit | edit source]
| Field | Type | Description |
|---|---|---|
packetId |
u8 |
Always 14.
|
modeName |
UTF |
1–64 printable characters after trimming, for example DRM or Hellschreiber.
|
description |
UTF |
At most 256 printable characters. May be empty. |
bandwidthHz |
f32 |
Occupied bandwidth in hertz, greater than 0 and at most 10,000,000. |
Behaviour[edit | edit source]
- Send it after TxAccept. It may be sent again to change the declaration.
- There is no reply.
- The current server records the declaration but does not yet display it anywhere. In particular, StationList still reports the transmitter's modulation field and its measured occupied bandwidth.
- Invalid values close the connection.
- Ignored on role 3 (
TX_GENERATED) connections.