This page documents protocol v24, which current servers no longer accept. See
SimTX API for v25.
TxUpdateAck
| Packet ID
|
23(0x17)
|
| Direction
|
Server → client
|
| Session
|
Transmitter
|
| Body size
|
1 + 6 × n bytes
|
| Permission
|
None
|
| Answered by
|
|
| Answers
|
TxUpdate
|
TxUpdateAck reports the outcome of a TxUpdate, one result per field, in the order the fields were sent.
| Field |
Type |
Description
|
packetId |
u8 |
Always 23.
|
n |
u8 |
Number of results.
|
results |
n × { u8 fieldId, bool accepted, f32 appliedValue } |
One entry per field of the update.
|
| Situation |
accepted |
appliedValue
|
| Applied |
true |
The value now in effect, after any clamping or power limit.
|
| Value already in effect |
true |
The current value.
|
| Refused (out of range or too soon) |
false |
The current, unchanged value.
|
| Not a live field |
false |
The requested value, echoed.
|
Always update the user interface from appliedValue, not from the value that was requested. A power request of 1,500 W on an account limited to 400 W is accepted with appliedValue = 400.
