基于QT（Windows）实现STM32 USB DFU自定义固件烧录技术问询

算力阿峰

2026-6-23

从零实现Windows QT下STM32 USB DFU Bootloader烧录功能

核心思路

STM32内置的USB Bootloader遵循USB DFU 1.1规范，同时ST在AN3156文档中定义了针对STM32的扩展命令（擦除、读写内存等）。实现时无需依赖CubeProgrammer_API.dll，直接通过USB控制传输与设备交互即可，推荐用libusb库简化Windows平台的USB操作（QT集成方便，且支持跨平台）。

分步实现指南

1. 环境准备与设备识别

驱动配置：Windows下STM32 BOOTLOADER默认可能绑定系统自带驱动，需用工具（如Zadig）将其替换为WinUSB驱动，确保libusb能正常访问设备。
设备枚举：STM32 DFU Bootloader的标准VID是0x0483，PID是0xdf11。用libusb枚举USB设备，匹配这对VID/PID找到目标设备。
QT集成libusb：在QT项目中引入libusb的头文件和库文件，编译时链接libusb-1.0.lib（Windows平台）。

2. 设备初始化流程

打开设备后需完成以下步骤：

断开设备绑定的内核驱动（如果存在）：调用libusb_detach_kernel_driver
声明DFU接口：STM32 DFU使用接口0，调用libusb_claim_interface获取接口控制权
检查设备状态：发送DFU GET_STATUS请求，确认设备处于DFU_IDLE状态（bState=0x02）

3. 核心DFU命令实现

所有操作通过USB控制传输完成，以下是关键命令的实现要点：

3.1 状态查询（GET_STATUS）

用于获取设备当前状态和操作结果，每次操作后必须轮询此命令直到设备回到IDLE状态：

uint8_t status_buf[6]; // 格式：bStatus, bPollTimeout[3], bState, iString
int rc = libusb_control_transfer(
    dev_handle,
    LIBUSB_REQUEST_TYPE_CLASS | LIBUSB_RECIPIENT_INTERFACE | LIBUSB_ENDPOINT_IN,
    0x03, // GET_STATUS请求码
    0,
    0,    // 接口号
    status_buf,
    sizeof(status_buf),
    5000  // 超时5秒
);
if (rc == sizeof(status_buf)) {
    uint8_t bStatus = status_buf[0];
    uint8_t bState = status_buf[4];
    if (bStatus == 0 && bState == 0x02) {
        // 设备就绪
    }
}

3.2 STM32扩展命令（基于DFU DNLOAD）

AN3156定义的所有操作都通过DFU DNLOAD请求发送，块号wValue设为0时代表命令：

擦除扇区：命令码0x41，后面跟4字节扇区号（小端）

uint8_t erase_cmd[5] = {0x41, 0x00, 0x00, 0x00, 0x00}; // 擦除扇区0
libusb_control_transfer(
    dev_handle,
    LIBUSB_REQUEST_TYPE_CLASS | LIBUSB_RECIPIENT_INTERFACE | LIBUSB_ENDPOINT_OUT,
    0x01, // DNLOAD请求码
    0x0000, // 块号0表示命令
    0,
    erase_cmd,
    sizeof(erase_cmd),
    5000
);
// 发送后轮询GET_STATUS直到完成

写入固件块：命令码0x31，先发送地址（4字节小端），后续块号从1开始发送固件数据（块大小由设备的wTransferSize决定，默认1024字节）

// 先发送写地址命令
uint8_t write_addr_cmd[5] = {0x31, 0x00, 0x08, 0x00, 0x00}; // 写入地址0x08000000
libusb_control_transfer(dev_handle, ..., 0x01, 0x0000, 0, write_addr_cmd, 5, 5000);

// 发送固件块（块号1）
uint8_t firmware_block[1024];
// 从固件文件读取数据到firmware_block
libusb_control_transfer(dev_handle, ..., 0x01, 0x0001, 0, firmware_block, 1024, 5000);

4. 关键注意事项

线程隔离：所有USB操作必须放在QT的工作线程中，避免阻塞UI线程
超时处理：擦除、写入等操作耗时较长，需设置合理的超时时间（如5秒），并轮询状态直到完成
错误恢复：若GET_STATUS返回错误（bStatus≠0），需发送CLEAR_STATUS请求（0x04）后重试或终止操作
固件格式：支持.bin格式直接按块发送，.hex格式需先转换为字节流（可通过QT的QHexFile或自行解析）

内容的提问来源于stack exchange，提问作者Mirco