adompkg install adom-usb-stub-nrf

# adom-usb-stub-nrf

**adom-usb firmware device-test pack — Nordic Semiconductor.** DFU-flash stub firmware to an nRF52840/nRF5340 to enumerate as CDC, HID, or MSC — exercise the USBD peripheral.

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

## Personas

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

Chips: nrf52840, nrf5340 · flash method: `nrfutil`.

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