app

Adom USB - STM32 persona pack

Public Unreviewed

by John Lauer

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.

adom-usb-pluginfirmwareusb-stubstmicroelectronics
Overview Files Skills Packages Releases Dependencies Issues Breadcrumbs Pull Requests Activity
Propose a change
Name Last commit message Last updated
screenshots ADOM-USB family marker on every billboard 1mo ago
skills plugin source v0.1.0 1mo ago
adom-usb-stub-stm32 plugin source v0.1.0 1mo ago
install.sh plugin source v0.1.0 1mo ago
package.json plugin source v0.1.0 1mo ago
page.json normal hyphen in title (not em-dash) for consistency 1mo ago
plugin.json plugin source v0.1.0 1mo ago
README.md add image credit 1mo ago
uninstall.sh plugin source v0.1.0 1mo ago

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.

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 under its respective Creative Commons license. This is an open-source reference plugin for adom-usb; manufacturers shipping their own device-test pack should supply their own product imagery.