Skip to content

Commit b3759c8

Browse files
usb: document once normalization at boot
1 parent e2998f6 commit b3759c8

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

docs/frameworks/usb-manager.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ USB host support is opt-in and ESP32-S3-only (needs USB OTG):
1010
./scripts/build_mpos.sh esp32s3 --usb
1111
```
1212

13-
This compiles in the `usb` C module (`c_mpos/usb/`) alongside TinyUSB device mode. **CDC is the default**: the device boots with a USB-serial console and the OTG peripheral stays in device mode. Host mode starts only on explicit request — Settings → "USB Host Mode" (`On` persisted, `On until reboot` one-shot, `Off`), or `USBManager.activate()` — and while it is active USB-CDC is gone (console remains over UART REPL where exposed, or WebREPL over WiFi). Deactivating brings CDC back; the choice persists across reboots. Holding BOOT at boot forces CDC regardless of the persisted flag.
13+
This compiles in the `usb` C module (`c_mpos/usb/`) alongside TinyUSB device mode. **CDC is the default**: the device boots with a USB-serial console and the OTG peripheral stays in device mode. Host mode starts only on explicit request — Settings → "USB Host Mode" (`On` persisted, `On until reboot` one-shot, `Off`), or `USBManager.activate()` — and while it is active USB-CDC is gone (console remains over UART REPL where exposed, or WebREPL over WiFi). A stale `once` value is normalized to `Off` at the next boot, so the row never shows a stale selection. Deactivating brings CDC back; the choice persists across reboots. Holding BOOT at boot forces CDC regardless of the persisted flag.
1414

1515
USBManager centralizes all USB-host operations in a single class with class methods:
1616

0 commit comments

Comments
 (0)