dfu-rs

Crates.iodfu-rs
lib.rsdfu-rs
version0.1.1
created_at2025-10-19 08:51:08.638515+00
updated_at2025-10-20 17:40:17.068866+00
descriptionDevice Firmware Update crate for hosts, using rusb and exposing a simple API.
homepagehttps://github.com/piersfinlayson/dfu-rs
repositoryhttps://github.com/piersfinlayson/dfu-rs
max_upload_size
id1890223
size50,221
Piers Finlayson (piersfinlayson)

documentation

https://docs.rs/dfu-rs

README

dfu-rs

Implements DFU operations for USB devices.

Based on rusb for USB communication, this crate provides a simple interface for discovering DFU-capable devices and performing DFU operations.

It is designed for use in host applications that need to update firmware on embedded devices via USB DFU.

It is intended to work on Windows, Linux, and macOS.

Features

  • Upload (read) data from DFU devices
  • Download (write) data to DFU devices
  • Erase flash memory (page-wise and mass erase)
  • Device discovery with filtering by DFU type (e.g. internal flash)
  • Error handling with detailed DFU and USB errors
  • Uses blocking calls via rusb - wrap in tokio::task::spawn_blocking for async runtimes
  • Customizable USB timeout

Usage

use dfu_rs::{Device, DfuType};

if let Some(device) = Device::search(None).unwrap().first() {
   let mut buffer = vec![0u32; 4096]; // 16KB
  device.upload(0x08000000, &mut buffer).unwrap();
  println!("Uploaded data: {:X?}", &buffer[..16]); // Print first 16 words
}

See the docs for more examples.

Commit count: 0

cargo fmt