Apply saved TX power automatically across firmware roles
This commit is contained in:
1 parent
31e5d54074
commit
65928aae95
51 files changed
+3838
-2728
No files matched your search
@@ -166,7 +166,7 @@ should use command `0x42`. See [Companion radio binary protocol](companion_proto
|
||||
| Logging | [`get/set usb.watchdog off\|on\|auto`](usb_logging_watchdog.md) | Current source; recovery requires native USB, live logging, and durable storage; Auto qualifies from USB stats polling | Yes | Yes | Feature |
|
||||
| Logging | [`get usb.watchdog.last`](usb_logging_watchdog.md#last-event-review) | Current source; latest USB watchdog event with advisory timestamp, uptime, action, reasons, and durability; native USB required | Yes | Yes | Feature |
|
||||
| Radio | [`get radio`; `set radio ...`](cli_commands.md#view-or-change-this-nodes-radio-parameters) | All text CLI roles | Yes | Yes | Yes |
|
||||
| Radio | [`get tx`; `set tx <dbm>`](cli_commands.md#view-or-change-this-nodes-transmit-power) | Board TX-power limits apply | Yes | Yes | Yes |
|
||||
| Radio | [`get tx`; `set tx <dbm>`](cli_commands.md#view-or-change-this-nodes-transmit-power) | Board TX-power limits apply; busy changes apply automatically | Yes | Yes | Yes |
|
||||
| Radio | [`tempradio ...`; `normalradio`](cli_commands.md#change-the-radio-parameters-for-a-set-duration) | Full parser | Yes | Yes | Yes |
|
||||
| Radio | [`get/set/del radioat`; `get/set/del tempradioat`](cli_commands.md#schedule-radio-parameter-changes) | Full parser | Yes | Yes | Yes |
|
||||
| Radio | [`get freq`; `set freq <mhz>`](cli_commands.md#view-or-change-this-nodes-frequency) | Local or authorized LoRa CLI | Yes | Yes | Yes |
|
||||
@@ -342,7 +342,7 @@ should use command `0x42`. See [Companion radio binary protocol](companion_proto
|
||||
| Logging | [`get/set usb.watchdog off\|on\|auto`](usb_logging_watchdog.md) | Current source; recovery requires native USB, live logging, and durable storage; Auto qualifies from USB stats polling | Yes | Yes | Feature | Yes | Yes |
|
||||
| Logging | [`get usb.watchdog.last`](usb_logging_watchdog.md#last-event-review) | Current source; latest USB watchdog event with advisory timestamp, uptime, action, reasons, and durability; native USB required | Yes | Yes | Feature | Yes | Yes |
|
||||
| Radio | [`get radio`; `set radio ...`](cli_commands.md#view-or-change-this-nodes-radio-parameters) | All text CLI roles | Yes | Yes | Yes | Yes | Yes |
|
||||
| Radio | [`get tx`; `set tx <dbm>`](cli_commands.md#view-or-change-this-nodes-transmit-power) | Board TX-power limits apply | Yes | Yes | Yes | Yes | Yes |
|
||||
| Radio | [`get tx`; `set tx <dbm>`](cli_commands.md#view-or-change-this-nodes-transmit-power) | Board TX-power limits apply; busy changes apply automatically | Yes | Yes | Yes | Yes | Yes |
|
||||
| Radio | [`tempradio ...`; `normalradio`](cli_commands.md#change-the-radio-parameters-for-a-set-duration) | Full parser | Yes | Yes | Yes | Yes | Yes |
|
||||
| Radio | [`get/set/del radioat`; `get/set/del tempradioat`](cli_commands.md#schedule-radio-parameter-changes) | Full parser | Yes | Yes | Yes | Yes | Yes |
|
||||
| Radio | [`get freq`; `set freq <mhz>`](cli_commands.md#view-or-change-this-nodes-frequency) | Local or authorized LoRa CLI | Yes | Yes | Yes | Yes | Yes |
|
||||
|
||||
@@ -1878,8 +1878,15 @@ minimum and return to it exactly when it is safe.
|
||||
|
||||
**Notes:** This setting only controls the power level of the LoRa chip. Some nodes have an additional power amplifier stage which increases the total output. Refer to the node's manual for the correct setting to use. **Setting a value too high may violate the laws in your country.**
|
||||
|
||||
The command strictly rejects malformed values and saves the new preference
|
||||
only after the active radio driver accepts it. On LR2021, the chip range is
|
||||
The command strictly rejects malformed values. It applies power immediately
|
||||
when the radio is free. A busy radio returns `OK - saved; pending`; firmware
|
||||
then applies the saved value automatically, without another command or reboot.
|
||||
A newer successful change replaces the pending value. A failed save is reported
|
||||
as an error and does not replace the previous runtime intent. Radio 2 and
|
||||
temporary radio profiles do not require a manual retry. Background application
|
||||
waits for active Morse, beacons and carrier-wave tests to finish.
|
||||
|
||||
On LR2021, the chip range is
|
||||
`-9` to `22` dBm below 1500 MHz and `-19` to `12` dBm above 1500 MHz. A lower
|
||||
board-specific external-PA limit still takes precedence. A saved profile is
|
||||
clamped to the applicable limit when its frequency changes; temporary radio
|
||||
|
||||
@@ -246,11 +246,13 @@ catalog; bytes `0x2C`-`0x31` are parked and `0x35` is unused.
|
||||
The sections below detail the most common frames. Refer to the source named
|
||||
above for command bodies that are not expanded here.
|
||||
|
||||
Radio changes (`0x0B`, `0x0C`) can wait briefly for a safe radio window before
|
||||
replying. TX power waits up to three seconds when reception or transmission is
|
||||
busy. Its OK response confirms both hardware acceptance and a saved setting;
|
||||
timeout or disconnect discards a waiting power change. Successful settings
|
||||
commands are saved independently, so an error does not undo earlier commands.
|
||||
Radio parameter changes (`0x0B`) can wait briefly for a safe radio window before
|
||||
replying. TX power (`0x0C`) returns OK once the requested setting is saved. If
|
||||
the radio is busy, firmware applies that saved power automatically when it is
|
||||
free; disconnecting does not cancel the change. A newer successful power save
|
||||
replaces the pending value. No follow-up command or reconnect is needed.
|
||||
Successful settings commands are saved independently, so an error does not undo
|
||||
earlier commands.
|
||||
|
||||
### Private text when only the sender knows the recipient
|
||||
|
||||
|
||||
Reference in new issue
Block a user