mirror of
https://github.com/mikecarper/MeshCore.git
synced 2026-09-16 18:12:36 +00:00
mikecarper
3b6c894ee2
Implement radio2, tempradio2, radioat2 and tempradioat2 across Mesh roles, with RX-only/RX+TX operation, optional preambles and persistent cross-TX policy. Keep temporary OTA traffic on its profile by default and maintain independent retry ownership and backoff for each profile. Use slow-first receive scanning with 4.8-symbol visits and automatic preambles rounded up in steps of eight. Preserve pending RX, restore power saving on exit, and discard work bound to changed or expired profiles. Restore the infrastructure path.hash.mode setter and report unsupported extra.sf settings consistently. Add CLI, scheduling, scan and retry tests, setup documentation, and the V4/XIAO hardware validation results. Validation: 1,422 native tests, eight KISS tests, 63 final focused profile tests, 18 checks from the staged source, sanitizer-enabled OTA transfers, and builds for V4 Mesh roles, Full XIAO Companion and nRF52 T1000-E. Hardware checks cover reception, cross-TX policy, expiry, reboot and OTA discovery while receiving main-channel adverts.
75 lines
4.3 KiB
Markdown
75 lines
4.3 KiB
Markdown
# CLI setting dispatch audit
|
|
|
|
The 1.17.1.5 source retained `get path.hash.mode` in `CommonCLI` but lost its
|
|
setter when radio preferences moved into `CommonRadioPrefs`. Infrastructure
|
|
roles call `CommonCLI` directly, so the shared parser's setter was unreachable.
|
|
The correction restores `set path.hash.mode 0|1|2` there, validates the value,
|
|
and saves accepted changes. Missing/invalid values report a value error and
|
|
leave the setting unchanged.
|
|
|
|
The other radio setters removed by the original refactor had already been
|
|
restored. A feature-guarded check found a second mismatch: `get extra.sf` exposed
|
|
stored data on non-LR2021 radios while its setter was compiled out. Both
|
|
commands now return `Error: extra.sf requires an LR2021 radio` there. Supported
|
|
LR2021 set/get behavior is preserved. These are source corrections; existing
|
|
release binaries need rebuilding/updating to receive them.
|
|
|
|
## Coverage
|
|
|
|
| Surface | Check |
|
|
| --- | --- |
|
|
| Common infrastructure CLI | 72 literal setter keys and 84 query keys; every query has a setter or an explicitly reviewed read-only/alternate-command exception |
|
|
| MQTT/observer CLI | 33 literal setter keys and 39 query keys, including Wi-Fi, timezone, alerts, display and watchdog settings |
|
|
| MQTT slots | All nine writable slot subkeys have query/set coverage; `diag` is intentionally read-only |
|
|
| Repeater, Room Server, Sensor | Shared CLI delegation and role-specific query/set coverage |
|
|
| Companion | Shared-radio allowlist and parser agreement, persistence wiring, terminal-specific setters, and role query exceptions |
|
|
| Radio settings moved by the refactor | All 13 shared setters remain present in infrastructure dispatch |
|
|
| Literal command comparisons | Checks key lengths so a setter cannot accidentally compare its value against the key's terminating NUL |
|
|
| Feature guards | Preprocesses common and observer handlers for minimal, nRF52 GPS/SD, ESP32 WebConfig, ESP32 MQTT, RS232/GPS, ESP-NOW, and LR2021 profiles before comparing query/set coverage |
|
|
|
|
Read-only exceptions include runtime connection status, diagnostics, firmware
|
|
role, bootloader identity and reset information. Alternate-command exceptions
|
|
include the password command and `set battery.alert on <region>`. These
|
|
exceptions are explicit in the test, rather than silently allowing all missing
|
|
setters. Dynamic/delegated command families and hardware-specific features
|
|
continue to use their dedicated tests; the inventory is not a claim that every
|
|
build has every feature enabled.
|
|
|
|
## Executed behavior tests
|
|
|
|
The native C++ fixture compiles the production get/set dispatch branches and
|
|
the real setting bodies for 14 radio-related settings: `radio`, `freq`, `af`,
|
|
`dutycycle`, `int.thresh`, `cad`, `radio.rxgain`, `tx`, `rxdelay`,
|
|
`agc.reset.interval`, `path.hash.mode`, `multi.acks`, `txdelay`, and
|
|
`direct.txdelay`. It runs local and authenticated on-air caller timestamps,
|
|
checks round-trip values and save calls, preserves AGC interval rounding, and
|
|
checks that rejected hardware applies do not save or change preferences.
|
|
Hardware callbacks are mocked; these are not live-radio or flash-durability
|
|
tests. The fixture also runs with and without `USE_LR2021`, checking supported
|
|
`extra.sf` set/query/clear behavior, invalid values, and the unsupported-radio
|
|
error.
|
|
|
|
The focused hash-mode test checks all valid modes, missing values, negative and
|
|
out-of-range values, overflow, malformed numbers, whitespace, and similarly
|
|
named unknown keys. Existing transport tests exercise Companion local/framed
|
|
and on-air dispatch, local-only secret reads, and browser/stream routing under
|
|
AddressSanitizer and UndefinedBehaviorSanitizer on Linux.
|
|
|
|
Run the CI checks locally with a host C++ compiler (Linux is required for the
|
|
existing sanitizer-enabled transport suite):
|
|
|
|
```text
|
|
python3 -B test/test_path_hash_cli.py
|
|
python3 -B test/test_cli_settings_contract.py
|
|
python3 -B test/test_local_cli_access.py
|
|
```
|
|
|
|
All 14 tests passed on the Linux VM. The workflow runs these commands on future
|
|
pushes and pull requests. The new inventory and native radio tests also passed
|
|
with the Windows host compiler.
|
|
|
|
`pio run -e heltec_v4_repeater` passed after both corrections, including the
|
|
firmware's flash-size and runtime-RAM checks. The initial audit used host tests
|
|
and build checks; subsequent hardware checks are recorded in the
|
|
[dual-profile validation](radio_profiles_validation.md).
|