mirror of
https://github.com/hathach/tinyusb.git
synced 2026-08-22 21:11:21 +00:00
2a114013d4
Speed-switched desc_device_ss (bcdUSB 0x0320, bMaxPacketSize0 = 9), SuperSpeed config arrays from the TUD_*_SS_DESCRIPTOR templates, BOS, and EP0 / bulk buffer sizing for SuperSpeed across the device examples.
DFU
A USB Device Firmware Upgrade (DFU mode) device with two firmware partitions, demonstrating download, upload and manifestation.
What it does
- Exposes a DFU interface with two alternate settings, one per simulated partition: alt 0
FLASH, alt 1EEPROM. - Download (host to device): prints each received byte to stdout and immediately reports flashing complete.
- Upload (device to host): returns a fixed string per partition (
Hello world from TinyUSB DFU! - Partition 0/1), single block only. - Reports per-partition poll timeouts during download: 1 ms for FLASH (alt 0), 100 ms for EEPROM (alt 1).
- Logs manifestation, abort and detach events.
- Provides a BOS / Microsoft OS 2.0 descriptor so Windows binds the WinUSB driver.
- LED blink rate indicates bus state (not mounted / mounted / suspended).
USB Descriptors
| Interface | Class driver |
|---|---|
| 0 | DFU (two alternate settings) |
Configuration
Notable tusb_config.h settings:
#define CFG_TUD_DFU 1
#define CFG_TUD_DFU_XFER_BUFSIZE (TUD_OPT_HIGH_SPEED ? 512 : 64)
Building
CMake:
mkdir build && cd build
cmake -DBOARD=raspberry_pi_pico ..
cmake --build .
Make:
make BOARD=raspberry_pi_pico all
Try it
List the device in DFU mode:
dfu-util -l
Download firmware to a partition (a text file works well for this demo):
dfu-util -d cafe -a 0 -D firmware.bin # partition 0 (FLASH)
dfu-util -d cafe -a 1 -D firmware.bin # partition 1 (EEPROM)
Upload from a partition back to the host:
dfu-util -d cafe -a 0 -U readback.bin
dfu-util -d cafe -a 1 -U readback.bin
Downloaded bytes are echoed on the device's stdout; uploads return the partition's fixed string.