# adom-usb-stub-stm32

**adom-usb firmware device-test pack — STMicroelectronics.** Flash stub firmware over USB DFU (0483:df11) to make any STM32 enumerate as each supported USB class — MSC, HID, CDC, RNDIS, audio, MIDI, DFU.

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

## Personas

| id | flashes | enumerates as |
|---|---|---|
| `msc-disk` | Mass storage | Mass storage |
| `hid-keyboard` | HID keyboard | HID keyboard |
| `hid-mouse` | HID mouse | HID mouse |
| `cdc-serial` | CDC virtual COM | CDC serial |
| `cdc-rndis` | RNDIS/ECM ethernet | CDC ethernet |
| `audio` | USB Audio (UAC1) | Audio |
| `midi` | USB-MIDI | Audio/MIDI |
| `dfu` | DFU bootloader | DFU |

Chips: stm32f0, stm32f1, stm32f4, stm32f7, stm32h7, stm32l4 · flash method: `dfu-util`.

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.*