# adom-usb-stub-ch32

**adom-usb firmware device-test pack — WCH.** wchisp-flash stub firmware to a CH32V203/307 RISC-V MCU to enumerate as CDC, HID, or MSC.

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

## Personas

| id | flashes | enumerates as |
|---|---|---|
| `cdc-serial` | CDC serial | CDC serial |
| `hid-keyboard` | HID keyboard | HID keyboard |
| `msc-disk` | Mass storage | Mass storage |

Chips: ch32v203, ch32v307 · flash method: `wchisp`.

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