SimTX API v24/Packets/TxUpdateAck: Difference between revisions
m Clanker moved page SimTX API/Packets/TxUpdateAck to SimTX API v24/Packets/TxUpdateAck: Archive the v24 protocol reference |
Archive the v24 protocol reference: use the v24 templates, links and categories |
||
| Line 1: | Line 1: | ||
{{SimTX API navigation}} | {{SimTX API v24 navigation}} | ||
{{SimTX packet | {{SimTX packet v24 | ||
| name = TxUpdateAck | | name = TxUpdateAck | ||
| id = 23 | | id = 23 | ||
| hex = 0x17 | | hex = 0x17 | ||
| direction = s2c | | direction = s2c | ||
| session = [[SimTX API/Transmitter session|Transmitter]] | | session = [[SimTX API v24/Transmitter session|Transmitter]] | ||
| size = 1 + 6 × n bytes | | size = 1 + 6 × n bytes | ||
| permission = None | | permission = None | ||
| answers = [[SimTX API/Packets/TxUpdate|TxUpdate]] | | answers = [[SimTX API v24/Packets/TxUpdate|TxUpdate]] | ||
| group = transmitter | | group = transmitter | ||
}} | }} | ||
'''TxUpdateAck''' reports the outcome of a [[SimTX API/Packets/TxUpdate|TxUpdate]], one result per field, in the order the fields were sent. | '''TxUpdateAck''' reports the outcome of a [[SimTX API v24/Packets/TxUpdate|TxUpdate]], one result per field, in the order the fields were sent. | ||
== Layout == | == Layout == | ||
| Line 39: | Line 39: | ||
Always update the user interface from <code>appliedValue</code>, not from the value that was requested. A power request of 1,500 W on an account limited to 400 W is accepted with <code>appliedValue = 400</code>. | Always update the user interface from <code>appliedValue</code>, not from the value that was requested. A power request of 1,500 W on an account limited to 400 W is accepted with <code>appliedValue = 400</code>. | ||
{{SimTX API navbox}} | {{SimTX API v24 navbox}} | ||
[[Category:SimTX API]] | [[Category:SimTX API v24]] | ||
Latest revision as of 16:27, 24 October 2026
| Packet ID | 23(0x17)
|
|---|---|
| Direction | Server → client |
| Session | Transmitter |
| Body size | 1 + 6 × n bytes |
| Permission | None |
| Answers | TxUpdate |
TxUpdateAck reports the outcome of a TxUpdate, one result per field, in the order the fields were sent.
Layout[edit | edit source]
| 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. |
Interpreting results[edit | edit source]
| 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.