mirror of https://github.com/embassy-rs/embassy.git synced 2025-10-02 14:44:32 +00:00

History

Gerhard de Clercq 3c73b49790 [embassy-usb-dfu] support function level WinUSB GUIDs

This commit makes it possible to provide function level msos GUIDs to usb_dfu. This helps to ensure that composite DFU devices automatically get assigned the WinUSB driver on Windows.

2025-05-12 15:55:11 +02:00

src

[embassy-usb-dfu] support function level WinUSB GUIDs

2025-05-12 15:55:11 +02:00

build.rs

Address reviews

2023-12-14 09:36:22 -05:00

Cargo.toml

chore: bump embassy-sync version

2025-01-15 16:12:36 +01:00

memory.x

Adjust stm32wb-dfu example memory maps to fix linker errors

2023-12-14 10:56:16 -05:00

README.md

docs: improve stm32 embassy-usb-dfu example

2024-12-05 18:47:33 +01:00

README.md

Bootloader for STM32

This bootloader implementation uses embassy-boot and embassy-usb-dfu to manage firmware updates and interact with the flash memory on STM32WB55 devices.

Prerequisites

Rust toolchain with cargo installed
cargo-flash for flashing the bootloader
dfu-util for firmware updates
cargo-binutils for binary generation

Usage

1. Flash the Bootloader

First, flash the bootloader to your device:

cargo flash --features embassy-stm32/stm32wb55rg --release --chip STM32WB55RGVx

2. Build and Flash Application

Generate your application binary and flash it using DFU:

cargo objcopy --release -- -O binary fw.bin
dfu-util -d c0de:cafe -w -D fw.bin

Troubleshooting

Make sure your device is in DFU mode before flashing
Verify the USB VID:PID matches your device (c0de:cafe)
Check USB connections if the device is not detected
Make sure the transfer size option of dfu-util matches the bootloader configuration. By default, dfu-util will use the transfer size reported by the device, but you can override it with the -t option if needed.
Make sure control_buf size is larger than or equal to the usb_dfu BLOCK_SIZE parameter (in this example, both are set to 4096 bytes).