69 lines
1.7 KiB
Markdown
69 lines
1.7 KiB
Markdown
# 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 1 `EEPROM`.
|
|
- 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:
|
|
|
|
```c
|
|
#define CFG_TUD_DFU 1
|
|
#define CFG_TUD_DFU_XFER_BUFSIZE (TUD_OPT_HIGH_SPEED ? 512 : 64)
|
|
```
|
|
|
|
## Building
|
|
|
|
CMake:
|
|
|
|
```bash
|
|
mkdir build && cd build
|
|
cmake -DBOARD=raspberry_pi_pico ..
|
|
cmake --build .
|
|
```
|
|
|
|
Make:
|
|
|
|
```bash
|
|
make BOARD=raspberry_pi_pico all
|
|
```
|
|
|
|
## Try it
|
|
|
|
List the device in DFU mode:
|
|
|
|
```bash
|
|
dfu-util -l
|
|
```
|
|
|
|
Download firmware to a partition (a text file works well for this demo):
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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.
|