# adom-usb-stub-esp32

**adom-usb firmware device-test pack — Espressif.** esptool-flash TinyUSB stubs to an ESP32-S2/S3 so it enumerates as CDC, HID, MSC, or MIDI — validate native-USB host support.

```bash
adompkg install adom-usb-stub-esp32
```

## Personas

| id | flashes | enumerates as |
|---|---|---|
| `cdc-serial` | CDC serial (console) | CDC serial |
| `hid-keyboard` | HID keyboard | HID keyboard |
| `hid-mouse` | HID mouse | HID mouse |
| `msc-disk` | Mass storage | Mass storage |
| `midi` | USB-MIDI | Audio/MIDI |

Chips: esp32s2, esp32s3 · flash method: `esptool`.

Once installed, `adom-usb` shows a **Flash ▾** persona picker on matching devices. Pick a persona, the pack flashes the stub, and the device re-enumerates as that USB class so you can mount / test / sniff it. This package ships the flash **contract** (a reference template) — drop your real signed firmware artifacts in `firmware/<persona>.<ext>` and publish your own version. See the adom-usb wiki page → *Writing a packet-sniffer plugin* (firmware packs share the same lifecycle).


---

*Hero image: device photograph sourced from [Wikimedia Commons](https://commons.wikimedia.org) under its respective Creative Commons license. This is an open-source reference plugin for [adom-usb](https://wiki.adom.inc/john/adom-usb); manufacturers shipping their own device-test pack should supply their own product imagery.*