🏠 Home → Software → RTLV → Commands (downlink) — DEVICE_MGMT (FPort 1)
🤖 Auto-generated from firmware (SSOT). Do not hand-edit — change the descriptor and regenerate. RTLV v3 ·
source_hash eb6b51128c1b
A downlink command = [cmd_id][len][params…] — no envelope, no prefix; multi-byte params are BE unless stated. Full command model on the Overview.
| Port.Cmd | Name | Kind | Params | Magic | Example (request) | Notes (verified) |
|---|---|---|---|---|---|---|
1.0xCE |
reboot | action | delay_sec:uint8 (opt) |
len0 / delay<10 / 0xFF = immediate reboot (no response); delay>=10 = ACK then scheduled reboot. src lorawan_commands.c:1946 | ||
1.0xE0 |
save_to_eeprom ⚠️ | action | — | defined but returns NOT_SUPPORTED(0x03). src lorawan_commands.c:2105 | ||
1.0xE1 |
factory_reset | action | magic:uint16 BE {0xFACE=soft (config only; keep stats/keys), 0xDEAD=full (config+stats+history+archive)} ==0xFACE |
0xFACE | E102DEAD |
len must be 2; 0xFACE=soft | 0xDEAD=full. status=REBOOT_PENDING(0x0A) on success. src lorawan_commands.c:2134 |
1.0xF0 |
ping_test | query | — | no params; response = [rssi int16 LE][snr int8] of this downlink. (0xF0 as a cmd_id is downlink-only; the 0xF0 UPLINK prefix is COMMAND_RESPONSE — different direction.) src lorawan_commands.c:2203 |
Response — 0xF0 COMMAND_RESPONSE 7-byte envelope, then echo-TLVs @ offset 7 (decoded in the response FPort's namespace):
| Offset | Byte | Field | Meaning |
|---|---|---|---|
| 0 | F0 |
prefix | COMMAND_RESPONSE |
| 1 | LEN |
length | bytes after [F0][LEN]; 0x05 for the bare 7-byte header |
| 2 | — | cmd_id | echoed command id |
| 3 | — | status | 0=OK |
| 4 | — | error_code | command error |
| 5 | — | flags | response flags |
| 6 | — | protocol_version | =0x03 (TLV_PROTOCOL_VERSION) |
| 7… | — | echo-TLVs | port-scoped [tag][len][value] |
The
[0xF0][3]…forms in firmware docstrings are stale shorthand — never mirror them.