# adom-usb-stub-rp2040

**adom-usb firmware device-test pack — Raspberry Pi.** Flash stub firmware to an RP2040 (drag-drop UF2 in BOOTSEL) to enumerate it as a disk, keyboard, mouse, serial, or MIDI device — test USB host support end-to-end.

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

## Personas

| id | flashes | enumerates as |
|---|---|---|
| `msc-disk` | Mass-storage disk (RAM) | Mass storage |
| `hid-keyboard` | HID keyboard (types a test string) | HID keyboard |
| `hid-mouse` | HID mouse (jiggler) | HID mouse |
| `cdc-serial` | CDC serial echo | CDC serial |
| `midi` | USB-MIDI | Audio/MIDI |

Chips: rp2040 · flash method: `uf2-bootsel`.

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