Support stock serial MQTT bridges on Full Companion
This commit is contained in:
1 parent
ea3fbcb277
commit
eb80ebafbc
11 files changed
+369
-65
No files matched your search
@@ -111,7 +111,7 @@ getters; relaying a command over LoRa keeps its remote restrictions.
|
||||
| ESP32 MQTT observer or ESP-NOW bridge | Always uses the expanded FULL partition profile. The build never substitutes a reduced CLI to fit the legacy application slot. |
|
||||
| FULL ESP32 USB + WiFi | Uses the matching MQTT target with packet logging, USB debug defaulting off, and the complete command surface supported by that role and hardware. Debug verbosity can be enabled only for diagnostics compiled into that image. `get/set logging.output off\|usb\|wifi\|both` selects and persists the active output paths; `get/set usb.debug` separately saves USB verbosity. |
|
||||
| FULL ESP32 logging fallback | Uses the matching non-MQTT target only when no WiFi MQTT sibling exists, with debug and packet support compiled and the complete command surface supported by that role and hardware. USB debug defaults off; `get/set usb.debug` selects verbose output independently of packet capture. Its persistent USB master also covers output-off operation, avoiding a second FULL ESP-NOW image. |
|
||||
| nRF52 dual-CDC Full Companion | Fresh installs expose only interface `00`; it starts as an ASCII terminal and automatically hands a complete `<` frame to framed Companion. The same interface also carries exclusive serial mOTA traffic. Enabling logging and rebooting adds output-only interface `02` for ASCII RAW/RX/TX records and optional debug. BLE and source-only LoRa OTA remain available. `get/set usb.logging` persistently controls whether the logging interface is present; `get/set usb.debug` changes verbosity without a reboot. Send CLI/control queries to interface `00`, not the log endpoint. |
|
||||
| nRF52 dual-CDC Full Companion | Fresh installs expose only interface `00`; it starts as an ASCII terminal and automatically hands a complete `<` frame to framed Companion. The same interface also carries exclusive serial mOTA traffic. `set usb.logging on reboot` adds output-only interface `02` for ASCII RAW/RX/TX records and optional debug. Alternatively, `set usb.logging stream reboot` keeps CLI replies and packet records on interface `00` for unmodified one-port serial bridges; Binary Companion and serial mOTA require logging off on that port. BLE and source-only LoRa OTA remain available. `get/set usb.logging` persistently controls whether the logging interface is present; `get/set usb.debug` changes verbosity without a reboot. Send CLI/control queries to interface `00`, not the log endpoint. |
|
||||
| ESP32 single-TTY Full Companion | Every ESP32 Full image starts with the ASCII terminal on its one USB TTY and automatically hands a complete `<` frame to framed Companion. On 1.17.1.5, run `set powersaving off` first. `set usb.logging on` switches that TTY to an input-capable plaintext RAW/RX/TX logging terminal and makes framed Companion unavailable on USB; `set usb.logging off` stops logging but leaves the TTY in normal ASCII mode. `get/set usb.debug` separately controls saved verbose diagnostics, defaulting off. The terminal stop token or a valid incoming framed probe then performs the ordinary switch to Binary Companion. A saved logging-on setting starts directly in that logging terminal and disables automatic frame detection. BLE, WiFi, and source-only LoRa OTA remain available. ESP32 Full uses Arduino-ESP32 2.x where supported; RC32 and ESP32-C6 keep their board-required Arduino 3.x platform but still expose only one TTY. |
|
||||
| `no_external_sensors` | Trims selected optional environmental/ranging drivers and their settings; it does not remove generic I2C, core repeater discovery, routing, or runtime RS-232 commands. RAK3401 and RAK4631 profiles retain the four common INA I2C voltage/current monitors. GPS-preserving RAK nRF52 OTA profiles retain their GPS commands and provider; RAK4631 defaults the bridge to UART 2 because RAK12501/L76K GPS uses UART 1. Legacy target suffixes remain stable for OTA identity compatibility. |
|
||||
|
||||
|
||||
@@ -724,7 +724,17 @@ that a reboot is required. Use `set usb.logging on reboot` to save it and have
|
||||
the node reboot automatically after the reply. The second interface appears
|
||||
after that reboot. Likewise, `set usb.logging off reboot` removes interface
|
||||
`02`. The optional `reboot` word is accepted only in these exact command forms
|
||||
and triggers a reboot only when the descriptor actually needs to change.
|
||||
and triggers a reboot only when the USB logging mode or descriptor needs to change.
|
||||
|
||||
For serial bridges that use one port for both commands and packets, including
|
||||
unmodified Cisien/meshcoretomqtt, use `set usb.logging stream reboot` instead.
|
||||
This saved packet-stream mode keeps only interface `00` and emits plaintext
|
||||
RAW/RX/TX records together with repeater-style ` -> ` CLI replies. Configure
|
||||
the bridge with the stable `*-if00` path. Binary Companion and serial mOTA are
|
||||
unavailable on that port while logging is enabled; `set usb.logging off` stops
|
||||
the stream and leaves the ASCII terminal active. BLE remains available.
|
||||
`get usb.logging` reports `stream` and the primary port after reboot. To return
|
||||
to separate logging, use `set usb.logging on reboot`.
|
||||
|
||||
These are Full Companion **text-terminal** commands. The superficially similar
|
||||
`meshcli ... get usb.logging` command uses the Binary Companion parameter
|
||||
|
||||
@@ -51,6 +51,7 @@ editor does not necessarily forward them.
|
||||
| External FEM TX gain | `set radio.fem.txgain on` | `set radio.fem.txgain off` | Immediately; saved; controllable PA only |
|
||||
| ESP32 USB packet/debug logging | For 1.17.1.5: `set powersaving off`, then `set usb.logging on` | `set usb.logging off` | Immediately; saved; logging owns the USB terminal |
|
||||
| nRF52 separate USB logging port | `set usb.logging on reboot` | `set usb.logging off reboot` | Saves and reboots to add/remove the second USB port |
|
||||
| nRF52 one-port packet stream | `set usb.logging stream reboot` | `set usb.logging off` | Saved; CLI and packets share the primary port for stock serial bridges |
|
||||
| ESP32 browser settings | `set webui on` | `set webui off` | Saved; starts/stops WebConfig |
|
||||
| ESP32 temporary setup portal | `start webconfig ap` | `stop webconfig` | This session; opens a setup network/QR where available |
|
||||
| ESP32 WiFi firmware uploader | `start ota` or `start ota ap` | `stop ota` | This session; only usable with two application slots |
|
||||
|
||||
Reference in new issue
Block a user