Give Full builds exclusive USB mOTA ownership

This commit is contained in:
mikecarper committed 2026-09-03 02:33:23 -07:00
1 parent 529a4fa3a3
commit 942df304ca
6 files changed
+49 -14

No files matched your search

+8 -6
View File
@@ -595,17 +595,19 @@ able to report this event. A different baud rate, including 57600, does not
select ASCII mode.
On an ESP32 Full Companion built with `OTA_FOLDER_SERIAL`, `motatool` can keep
the shared serial console open as an mOTA folder source when WiFi is
unavailable:
the USB serial port open as an mOTA folder source when WiFi is unavailable:
```sh
motatool serve --serial /dev/ttyACM0 --dir ./motas -v
```
The tool sends `ota folder on` through the text CLI, then uses the shared
serial mOTA framing. This is separate from the nRF52 exclusive USB ownership
mode described below. TCP port 5001 remains the preferred unattended source
transport.
The tool sends the exact completed `ota folder on` line when it opens the port.
Firmware recognizes it in startup ASCII or idle Binary Companion mode, then
transfers the port to exclusive USB mOTA ownership before binary request/reply
frames begin. The text terminal and Binary Companion are unavailable on that
TTY until `motatool` detaches the folder. This matches the nRF52 ownership
behavior described below. TCP port 5001 remains the preferred unattended
source transport.
## nRF52 USB mOTA mode
+4 -2
View File
@@ -63,8 +63,10 @@ and is not a controller or source port. With default logging off, interface
`02` is not enumerated. BLE remains available.
ESP32 Full Companion normally uses its dedicated TCP seeder on port 5001.
ESP32 builds that also retain serial folder support use the shared-console
mOTA framing rather than the nRF52 exclusive USB ownership state.
ESP32 builds that also retain serial folder support use the same exclusive USB
mOTA ownership state as nRF52. The exact `ota folder on` line transfers the USB
port from startup ASCII or idle Binary Companion mode before binary mOTA frames
begin; neither console mode shares that port until the folder detaches.
## Destination requirements