简介这是一份基于STM32F407的USB主机程序工程包面向嵌入式开发者和单片机学习者解决外接U盘并进行文件读写等实际应用需求。程序借助STM32F407内置USB主机库与HAL抽象层实现设备识别、配置和数据传输并支持FAT32、exFAT等文件系统可直接用于移动存储、数据采集等场景。包内共1223个文件以614个C源文件、303个H头文件为主并包含启动文件、链接脚本、库文件及编译中间文件等压缩包大小48.38MB目录与工程结构完整。代码遵循模块化设计将USB主机、文件系统、U盘通信协议等拆分为高内聚低耦合的独立模块且关键步骤注释清晰便于阅读和二次开发。目前已有590人学习参考适合想在STM32平台上快速掌握USB主机与文件系统开发的中高级嵌入式工程师。1. stm32f407 做 USB 主机读写 U 盘为什么常用却并不省心调试一块 stm32f407 板子时最常被的一句话是“把 U 盘插上读一下里面配置文件跑完后把日志写回去”。听起来像是把 W25Q64 的 SPI 读写换成 U 盘实际上要打通 USB_HOST 协议栈、MSC 类、FATFS 文件系统三层。F407 带 OTG 外设做主机并不缺硬件但工程配置、VBUS 供电、时钟 48MHz、U 盘兼容性这些点随便踩一个就让枚举卡死。下面要讲的是从零把 stm32f407 接到 U 盘上读写的落地路径包括协议栈选型、最小代码、参数调整和排错经验适合接过 USB Device、现在要切到 Host 一侧的工程师。2. USB 主机方案的选型从 USB_HOST 协议栈到 FATFSU 盘在 USB 世界里属于 Mass Storage Class主机侧要做的事分两层USB 协议栈负责枚举分配地址、读描述符、选择配置MSC 类驱动负责 Bulk-Only 传输CBW/CSW/Data而文件系统解析由 FATFS 完成。这三层是独立的USB_HOST 栈跑通不代表能打开文件只有把 MSC 的扇区读写函数挂到 FATFS 的 diskio 接口上f_open才能真正工作。2.1 先认清 F407 的 OTGFS/HS 与内置 PHYstm32f407 有 OTG_FS 和 OTG_HS 两组外设但只有 OTG_FS 内置 12MHz PHY可以直接接 U 盘的 D/D-OTG_HS 的内置 PHY 只支持 FS 速度要想跑 480Mbps 必须外接 ULPI 收发器。绝大多数 U 盘在 FS 模式12Mbps下都能正常枚举读写配置文件、固件升级包已经够用所以常见做法是用 OTG_FS省去 ULPI 成本和布板麻烦。这里有一个容易误判的点F407 的 OTG_FS 最高工作在 FS 模式不是 HS 模式。如果以为“Host 就是高速”硬把 OTG_HS 当高速用会发现没有外置 PHY 时 U 盘根本不枚举。原理图上要确认 U 盘接口的 D/D- 接到 PA11/PA12OTG_FS而不是 PH0/PH1ULPI 数据线。2.2 USB_HOST 软件栈选型标准库、HAL 库与 RT-ThreadSTM32 的 USB Host 软件栈有三条常见路线。老一点的标准外设库发布过USB_HOST库文件结构是usbh_core.c、usbh_hcd.c加usb_conf.h很多 F407 老例程还在用它HAL 库官方提供USBH Core和USBH MSC ClassAPI 叫USBH_Init/USBH_Process新工程建议用这个第三类是用 RT-Thread 的 USBHost 组件适合跑 OS 的产品但遇到复合设备或劣质 U 盘时排查链路比官方栈多一层变量。软件栈适用工程常用 API坑点ST 标准库 USB_HOST老产品、参考代码多USBH_Init/ USBH_Process与 HAL 库混用时要特别注意中断优先级HAL 库 USBH新工程 / CubeMX 生成USBH_HandleTypeDef用户回调里不能做长时间操作RT-Thread USBHost已跑 RTOSusb_os系列接口对多 LUN 和部分 U 盘兼容性反复选型建议如果项目还要维护三年以上直接用 HAL 库。CubeMX 可以重新生成外设初始化USBH 类驱动也能单独替换标准库停留在 F1/F4 时代后面换芯片迁移成本更高。2.3 硬件连接VBUS 供电与 DP/DM 信号F407 的 OTG_FS 内置 PHY 对外信号很简单PA11/PA12 接 USB 座的 D-/DPA9 是 VBUS 检测脚PA10 是 ID 脚。使用标准 A 型插座的板子通常没有 ID 引脚需要在代码里强制主机模式而不是依赖 ID 检测。U 盘工作电流常在 100mA 到 500mA不能靠 MCU 的 LDO 直接带必须由 5V 电源供电。信号引脚连接对象关键注意USB_DMPA11U 盘 D-走线尽量短远离晶振USB_DPPA12U 盘 D内置 PHY 处理上拉不需外接 1.5k 电阻VBUSPA9USB 座 VBUSPA9 是 5V 容忍脚建议串 10kΩ 电阻防热插拔毛刺IDPA10A 型座悬空用 Micro-OTG 座时必须把 ID 接地GND—共地电流回路必须回到电源地不能只靠信号地如果板子由外部 5V 给 USB 座供电PA9 没接USBH 栈会一直等 VBUS 有效才继续枚举。我一般会给 PA9 串一个 10kΩ 电阻后接 USB 座 VBUS 采样点这样既能检测到插入又不给模拟前端引入太大负载。2.4 端口连接正确后U 盘为什么还要“挂载”USB 主机枚举完成后U 盘对 MCU 来说只是一个“块设备”可以按扇区读写但不知道文件目录在哪簇。FATFS 的作用就是把扇区映射成文件和目录f_mount做的就是这件事。它需要底层提供disk_read/disk_write而 USBH 的 MSC 类已经提供了扇区读写的USBH_MSC_Read/USBH_MSC_Write。// 伪代码USBH 让 U 盘变成扇区设备FATFS 再挂成卷 if (USBH_MSC_GetMaxLUN(hUsbHostFS) 0) { f_mount(fs, 0:, 1); // 立即挂载到逻辑卷 0: }这里USBH_MSC_GetMaxLUN返回 U 盘逻辑单元数量普通 U 盘是 0f_mount的第二个参数是卷名第三个参数1表示挂载后立即检查文件系统结构。如果 U 盘的 MBR 或 FAT 表损坏这个调用会返回FR_NO_FILESYSTEM但 USB 枚举本身是成功的。很多人把这一步误判成 USB 不识别其实要看的是返回码。3. 在 stm32f407 上移植 USB_HOST 并完成 U 盘最小读写有了选型和硬件下面是能跑通的最小工程骨架。以 HAL 库 USBH FATFS 为例只保留直接参与 U 盘读写的部分。3.1 状态机初始化与主循环轮询USB_HOST 和 USB Device 最大的区别在于Device 模式常由中断驱动Host 模式必须由主循环持续调用USBH_Process推进状态机。枚举是一个有限状态机从等待 VBUS 开始经过端口复位、地址分配、配置、获取 MSC 信息到CLASS_ACTIVE才表示 U 盘可用。枚举阶段实际观察点常见卡住原因等待 VBUSUSBH_GetState停在 IDLEVBUS 脚电压不对未强制 Host 模式端口复位D 信号上有脉冲时钟不对D 上拉驱动能力不足地址分配无PA11/PA12 接反读取 MSC 容量用户回调收到 CLASS_ACTIVEU 盘兼容性、LUN 数量读取超时主循环代码如下#include usbh_core.h #include usbh_msc.h #include ff.h USBH_HandleTypeDef hUsbHostFS; FATFS uDiskFs; static volatile uint8_t uDiskReady 0; void USBH_UserProcess(USBH_HandleTypeDef *phost, uint8_t event) { switch (event) { case HOST_USER_DISCONNECTION: uDiskReady 0; f_mount(NULL, 0:, 1); // 拔出后卸载卷 break; case HOST_USER_CLASS_ACTIVE: uDiskReady 1; break; default: break; } } int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); // CubeMX 生成的 MX_USB_OTG_FS_HCD_Init() 要在这之前执行 USBH_Init(hUsbHostFS, USBH_MSC_CLASS, USBH_UserProcess); while (1) { USBH_Process(hUsbHostFS); if (uDiskReady) { if (f_mount(uDiskFs, 0:, 1) FR_OK) { // 挂载成功可以开始读写文件 } uDiskReady 0; } } }USBH_Init的第二个参数传入USBH_MSC_CLASS主机栈会只处理 Mass Storage 类设备。USBH_Process必须高频调用一般放在while(1)主循环也可以通过定时器切片但不要放进 USB 中断服务函数里因为它会等待设备响应阻塞中断会造成 U 盘超时。uDiskReady是用户回调里的状态标志避免每次循环都执行f_mount因为f_mount在文件系统完好时也会做一些读取操作。3.2 把扇区读写函数注册成 FATFS 的 diskioFATFS 的底层接口定义在diskio.c最核心的是disk_read和disk_write。disk_status、disk_initialize、get_fattime可以返回固定值但读写函数必须真正对接 MSC 驱动。DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { // pdrv 对应磁盘编号这里只有一个 U 盘卷忽略 if (USBH_MSC_Read(hUsbHostFS, 0, sector, buff, count) USBH_OK) return RES_OK; return RES_ERROR; } DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) { if (USBH_MSC_Write(hUsbHostFS, 0, sector, (BYTE *)buff, count) USBH_OK) return RES_OK; return RES_ERROR; }USBH_MSC_Read的参数含义是第一个0是 LUN 编号第二个是起始扇区第三个是数据缓冲区第四个是扇区数。这里的关键是count必须按扇区数传而不是字节数。FATFS 在写入大量数据时会按FF_MAX_SS拆分请求有些 F407 例程把 count 按字节传导致读写出现大量错误扇区。LBA_t在较新 FATFS 里是 64 位但 MSC 驱动内部是 32 位128GB 以下的 U 盘不会碰到边界。3.3 写入一个文本文件挂载完成后文件操作和电脑上一样。写入日志文件FIL fd; UINT cnt; FRESULT res f_open(fd, 0:/app.log, FA_OPEN_ALWAYS | FA_WRITE); if (res FR_OK) { char line[] boot ok, uptime10s\r\n; f_write(fd, line, strlen(line), cnt); f_close(fd); }路径里带0:前缀是因为卷号是0/表示根目录FA_OPEN_ALWAYS表示文件不存在就创建存在则不清空配合f_lseek(fd, fd.fsize)可以在每次上电时追加内容到文件末尾。f_write的第四个参数返回实际写入字节数如果cnt小于传入长度要先检查磁盘剩余空间再查 USB 连接是否在写入期间中断。3.4 读回文件内容读取时通常用大缓冲区分块避免 MCU 内存不够。使用适合 F407 内部 SRAM 的 4KB 块读取方式FIL fd; UINT br; BYTE buf[4096]; FRESULT res f_open(fd, 0:/config.bin, FA_READ); while (res FR_OK) { res f_read(fd, buf, sizeof(buf), br); if (br 0) break; // 对 buf 做解析或转发 } f_close(fd);f_read返回后br表示真正读到的字节数最后一次小于sizeof(buf)是正常的看到br为 0 才表示到达文件末尾。注意不要直接把 4096 当成有效数据长度最后一次缓冲区里可能有上一次残留数据必须用br截断。4. 读写 U 盘遇上枚举失败、掉线与兼容性问题的排错参数无论移植做得多顺U 盘兼容性总会冒出来。这一章把最常见的失败表象和参数调整逻辑列清楚。4.1 时钟配置48MHz 必须来自 PLL Q 输出USB OTG_FS 的 PHY 需要精确的 48MHz来源是 PLL Q 输出。F407 系统时钟 168MHz 对应 PLL_N336、PLL_P2此时 PLL_Q7 得到 48MHz。如果从其他工程模板直接抄一个 Q8USB 枚举会失败但串口外设正常很误导人。RCC_OscInitTypeDef RCC_OscInitStruct {0}; RCC_OscInitStruct.OscillatorType RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLM 8; RCC_OscInitStruct.PLL.PLLN 336; RCC_OscInitStruct.PLL.PLLP RCC_PLLP_DIV2; RCC_OscInitStruct.PLL.PLLQ 7; // USB 时钟关键参数 if (HAL_RCC_OscConfig(RCC_OscInitStruct) ! HAL_OK) { Error_Handler(); }如果换过时钟树Q 值要先算USB 时钟 HSE/M × N / Q结果必须等于 48MHz。最容易疏忽的是 PLL_Q 只在 HSE 作为源时有效如果用内部 HSIUSB 时钟源要切换到内部 48MHz 时钟路径不能沿用这套配置。4.2 VBUS 供电不足与 USB 电流保护区枚举失败的另一个高发区是 VBUS。主机栈在检测到插入后会等 VBUS 有效如果板子的 5V 电源能力不足U 盘电容一充就跌落D 上拉被拉低主机就会反复做端口复位。现象可能原因处理建议插上后 U 盘灯不亮VBUS 无 5V检查 USB 座 VBUS 与电源网络连没连灯亮但枚举到一半变慢供电跌落在 VBUS 到地加 100uF 电解电容拔插一次后第二次识别失败限流开关自恢复换可控限流芯片如 TPS20514.3 FATFS 宏参数长文件名、卷数量与扇区安全FATFS 的ffconf.h里几个宏直接影响 U 盘读写的成功率。长文件名默认关闭时f_open(0:/扩展固件_V2.bin)会返回FR_NO_FILE但文件其实存在因为 FAT 短目录项被截断成 DOS 8.3 格式。宏建议值说明FF_USE_LFN1开启长文件名F407 建议用 1静态数组2 是动态内存占用FF_VOLUMES1只有一个 USB 卷节省内存FF_MAX_SS4096兼容 4K 扇区 U 盘代价是 FATFS 缓冲区变大FF_MULTI_PARTITION0不启用多分区避免带多个分区时挂载错乱另外注意FF_FS_READONLY必须为 0否则f_open带FA_WRITE会直接返回FR_WRITE_PROTECTED。4.4 MSC 超时与读写失败的重试USBH 的 MSC 驱动对设备响应有内部超时初始化阶段默认较长但读写阶段有些 U 盘在空闲后会进入省电模式第一次f_read要重新启动磁盘容易超时。常见做法是在disk_read外层做重试DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { for (uint8_t retry 0; retry 3; retry) { if (USBH_MSC_Read(hUsbHostFS, 0, sector, buff, count) USBH_OK) return RES_OK; HAL_Delay(10); } return RES_ERROR; }重试间隔 10ms 足够让低速 U 盘完成内部复位但不应加大到 100ms否则USBH_Process状态机被长时间阻塞主机栈会把慢响应误判成拔插。如果连续三次失败还出现在同一扇区大概率是劣质 U 盘在 CSW 阶段就出错只能换盘验证。4.5 常见日志表现与排查方向HAL 库 USBH 会把错误打印到串口常见日志表现如下日志表现含义排查方向USBH_FAILED / HAL_BUSY状态机内部错误检查USBH_Process是否被中断长时间打断USBH_NOT_SUPPORTED设备不是 MSC 类确认USBH_Init注册的类正确反复 Reset端口复位失败核对 PA11/PA12 是否接反时钟 48MHzCBW 方向错误MSC 协议错误U 盘兼容性换一个品牌 U 盘验证5. 让 U 盘读写更快更稳分块、缓冲与一致性验证当 U 盘能稳定读写后真正需要打磨的是大文件传输和掉电安全问题。5.1 大文件分块传输直接f_read/f_write一次性读写几十 MB 会耗尽内存F407 片内也只有 192KB SRAM。一般做法是固定 4KB 块循环处理。在写固件升级时我会把ota.bin分段写入 Flash每处理完 16 个扇区翻转一次缓冲区让 USB 传输和 Flash 擦写时间重叠。5.2 双缓冲与传输速率USB FS 模式下理论带宽约 1.2MB/s实际带 FATFS 文件头和数据边界能跑 700KB/s 以上就算正常。想再快可以把USBH_MSC_Read的单次请求扇区数从 4 提到 64一次传输 32KB减少协议切换次数。但双缓冲在裸机下比较麻烦USBH 的 MSC 读写是同步调用建议只把块大小调大而不是强行做乒乓。5.3 一致性验证与卸载时机写完文件后不要立刻拔 U 盘直接断电可能丢掉 FAT 表缓存。要在f_close之后额外执行f_mount(NULL, 0:, 1)这个调用会让 FATFS 释放卷句柄并完成内部状态清理。验证写盘是否成功时不能只看f_write返回值要重新以FA_READ打开文件把读到的字节数和写入长度对比更严格的做法是按 4KB 块对原数据和 U 盘文件各算一次 CRC32两边一致再认为成功。拔出事件回调里不要做大量计算建议只置一个pullout_request标志等主循环USBH_Process跑完当前事务后再去校验文件和卸载这样 U 盘主控收到的是干净的停止指令日志落盘就不会被系统截断。本文还有配套的精品资源点击获取 STM32F407作为USB主机读写U盘：协议栈、移植与常见坑
简介这是一份基于STM32F407的USB主机程序工程包面向嵌入式开发者和单片机学习者解决外接U盘并进行文件读写等实际应用需求。程序借助STM32F407内置USB主机库与HAL抽象层实现设备识别、配置和数据传输并支持FAT32、exFAT等文件系统可直接用于移动存储、数据采集等场景。包内共1223个文件以614个C源文件、303个H头文件为主并包含启动文件、链接脚本、库文件及编译中间文件等压缩包大小48.38MB目录与工程结构完整。代码遵循模块化设计将USB主机、文件系统、U盘通信协议等拆分为高内聚低耦合的独立模块且关键步骤注释清晰便于阅读和二次开发。目前已有590人学习参考适合想在STM32平台上快速掌握USB主机与文件系统开发的中高级嵌入式工程师。1. stm32f407 做 USB 主机读写 U 盘为什么常用却并不省心调试一块 stm32f407 板子时最常被的一句话是“把 U 盘插上读一下里面配置文件跑完后把日志写回去”。听起来像是把 W25Q64 的 SPI 读写换成 U 盘实际上要打通 USB_HOST 协议栈、MSC 类、FATFS 文件系统三层。F407 带 OTG 外设做主机并不缺硬件但工程配置、VBUS 供电、时钟 48MHz、U 盘兼容性这些点随便踩一个就让枚举卡死。下面要讲的是从零把 stm32f407 接到 U 盘上读写的落地路径包括协议栈选型、最小代码、参数调整和排错经验适合接过 USB Device、现在要切到 Host 一侧的工程师。2. USB 主机方案的选型从 USB_HOST 协议栈到 FATFSU 盘在 USB 世界里属于 Mass Storage Class主机侧要做的事分两层USB 协议栈负责枚举分配地址、读描述符、选择配置MSC 类驱动负责 Bulk-Only 传输CBW/CSW/Data而文件系统解析由 FATFS 完成。这三层是独立的USB_HOST 栈跑通不代表能打开文件只有把 MSC 的扇区读写函数挂到 FATFS 的 diskio 接口上f_open才能真正工作。2.1 先认清 F407 的 OTGFS/HS 与内置 PHYstm32f407 有 OTG_FS 和 OTG_HS 两组外设但只有 OTG_FS 内置 12MHz PHY可以直接接 U 盘的 D/D-OTG_HS 的内置 PHY 只支持 FS 速度要想跑 480Mbps 必须外接 ULPI 收发器。绝大多数 U 盘在 FS 模式12Mbps下都能正常枚举读写配置文件、固件升级包已经够用所以常见做法是用 OTG_FS省去 ULPI 成本和布板麻烦。这里有一个容易误判的点F407 的 OTG_FS 最高工作在 FS 模式不是 HS 模式。如果以为“Host 就是高速”硬把 OTG_HS 当高速用会发现没有外置 PHY 时 U 盘根本不枚举。原理图上要确认 U 盘接口的 D/D- 接到 PA11/PA12OTG_FS而不是 PH0/PH1ULPI 数据线。2.2 USB_HOST 软件栈选型标准库、HAL 库与 RT-ThreadSTM32 的 USB Host 软件栈有三条常见路线。老一点的标准外设库发布过USB_HOST库文件结构是usbh_core.c、usbh_hcd.c加usb_conf.h很多 F407 老例程还在用它HAL 库官方提供USBH Core和USBH MSC ClassAPI 叫USBH_Init/USBH_Process新工程建议用这个第三类是用 RT-Thread 的 USBHost 组件适合跑 OS 的产品但遇到复合设备或劣质 U 盘时排查链路比官方栈多一层变量。软件栈适用工程常用 API坑点ST 标准库 USB_HOST老产品、参考代码多USBH_Init/ USBH_Process与 HAL 库混用时要特别注意中断优先级HAL 库 USBH新工程 / CubeMX 生成USBH_HandleTypeDef用户回调里不能做长时间操作RT-Thread USBHost已跑 RTOSusb_os系列接口对多 LUN 和部分 U 盘兼容性反复选型建议如果项目还要维护三年以上直接用 HAL 库。CubeMX 可以重新生成外设初始化USBH 类驱动也能单独替换标准库停留在 F1/F4 时代后面换芯片迁移成本更高。2.3 硬件连接VBUS 供电与 DP/DM 信号F407 的 OTG_FS 内置 PHY 对外信号很简单PA11/PA12 接 USB 座的 D-/DPA9 是 VBUS 检测脚PA10 是 ID 脚。使用标准 A 型插座的板子通常没有 ID 引脚需要在代码里强制主机模式而不是依赖 ID 检测。U 盘工作电流常在 100mA 到 500mA不能靠 MCU 的 LDO 直接带必须由 5V 电源供电。信号引脚连接对象关键注意USB_DMPA11U 盘 D-走线尽量短远离晶振USB_DPPA12U 盘 D内置 PHY 处理上拉不需外接 1.5k 电阻VBUSPA9USB 座 VBUSPA9 是 5V 容忍脚建议串 10kΩ 电阻防热插拔毛刺IDPA10A 型座悬空用 Micro-OTG 座时必须把 ID 接地GND—共地电流回路必须回到电源地不能只靠信号地如果板子由外部 5V 给 USB 座供电PA9 没接USBH 栈会一直等 VBUS 有效才继续枚举。我一般会给 PA9 串一个 10kΩ 电阻后接 USB 座 VBUS 采样点这样既能检测到插入又不给模拟前端引入太大负载。2.4 端口连接正确后U 盘为什么还要“挂载”USB 主机枚举完成后U 盘对 MCU 来说只是一个“块设备”可以按扇区读写但不知道文件目录在哪簇。FATFS 的作用就是把扇区映射成文件和目录f_mount做的就是这件事。它需要底层提供disk_read/disk_write而 USBH 的 MSC 类已经提供了扇区读写的USBH_MSC_Read/USBH_MSC_Write。// 伪代码USBH 让 U 盘变成扇区设备FATFS 再挂成卷 if (USBH_MSC_GetMaxLUN(hUsbHostFS) 0) { f_mount(fs, 0:, 1); // 立即挂载到逻辑卷 0: }这里USBH_MSC_GetMaxLUN返回 U 盘逻辑单元数量普通 U 盘是 0f_mount的第二个参数是卷名第三个参数1表示挂载后立即检查文件系统结构。如果 U 盘的 MBR 或 FAT 表损坏这个调用会返回FR_NO_FILESYSTEM但 USB 枚举本身是成功的。很多人把这一步误判成 USB 不识别其实要看的是返回码。3. 在 stm32f407 上移植 USB_HOST 并完成 U 盘最小读写有了选型和硬件下面是能跑通的最小工程骨架。以 HAL 库 USBH FATFS 为例只保留直接参与 U 盘读写的部分。3.1 状态机初始化与主循环轮询USB_HOST 和 USB Device 最大的区别在于Device 模式常由中断驱动Host 模式必须由主循环持续调用USBH_Process推进状态机。枚举是一个有限状态机从等待 VBUS 开始经过端口复位、地址分配、配置、获取 MSC 信息到CLASS_ACTIVE才表示 U 盘可用。枚举阶段实际观察点常见卡住原因等待 VBUSUSBH_GetState停在 IDLEVBUS 脚电压不对未强制 Host 模式端口复位D 信号上有脉冲时钟不对D 上拉驱动能力不足地址分配无PA11/PA12 接反读取 MSC 容量用户回调收到 CLASS_ACTIVEU 盘兼容性、LUN 数量读取超时主循环代码如下#include usbh_core.h #include usbh_msc.h #include ff.h USBH_HandleTypeDef hUsbHostFS; FATFS uDiskFs; static volatile uint8_t uDiskReady 0; void USBH_UserProcess(USBH_HandleTypeDef *phost, uint8_t event) { switch (event) { case HOST_USER_DISCONNECTION: uDiskReady 0; f_mount(NULL, 0:, 1); // 拔出后卸载卷 break; case HOST_USER_CLASS_ACTIVE: uDiskReady 1; break; default: break; } } int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); // CubeMX 生成的 MX_USB_OTG_FS_HCD_Init() 要在这之前执行 USBH_Init(hUsbHostFS, USBH_MSC_CLASS, USBH_UserProcess); while (1) { USBH_Process(hUsbHostFS); if (uDiskReady) { if (f_mount(uDiskFs, 0:, 1) FR_OK) { // 挂载成功可以开始读写文件 } uDiskReady 0; } } }USBH_Init的第二个参数传入USBH_MSC_CLASS主机栈会只处理 Mass Storage 类设备。USBH_Process必须高频调用一般放在while(1)主循环也可以通过定时器切片但不要放进 USB 中断服务函数里因为它会等待设备响应阻塞中断会造成 U 盘超时。uDiskReady是用户回调里的状态标志避免每次循环都执行f_mount因为f_mount在文件系统完好时也会做一些读取操作。3.2 把扇区读写函数注册成 FATFS 的 diskioFATFS 的底层接口定义在diskio.c最核心的是disk_read和disk_write。disk_status、disk_initialize、get_fattime可以返回固定值但读写函数必须真正对接 MSC 驱动。DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { // pdrv 对应磁盘编号这里只有一个 U 盘卷忽略 if (USBH_MSC_Read(hUsbHostFS, 0, sector, buff, count) USBH_OK) return RES_OK; return RES_ERROR; } DRESULT disk_write(BYTE pdrv, const BYTE *buff, LBA_t sector, UINT count) { if (USBH_MSC_Write(hUsbHostFS, 0, sector, (BYTE *)buff, count) USBH_OK) return RES_OK; return RES_ERROR; }USBH_MSC_Read的参数含义是第一个0是 LUN 编号第二个是起始扇区第三个是数据缓冲区第四个是扇区数。这里的关键是count必须按扇区数传而不是字节数。FATFS 在写入大量数据时会按FF_MAX_SS拆分请求有些 F407 例程把 count 按字节传导致读写出现大量错误扇区。LBA_t在较新 FATFS 里是 64 位但 MSC 驱动内部是 32 位128GB 以下的 U 盘不会碰到边界。3.3 写入一个文本文件挂载完成后文件操作和电脑上一样。写入日志文件FIL fd; UINT cnt; FRESULT res f_open(fd, 0:/app.log, FA_OPEN_ALWAYS | FA_WRITE); if (res FR_OK) { char line[] boot ok, uptime10s\r\n; f_write(fd, line, strlen(line), cnt); f_close(fd); }路径里带0:前缀是因为卷号是0/表示根目录FA_OPEN_ALWAYS表示文件不存在就创建存在则不清空配合f_lseek(fd, fd.fsize)可以在每次上电时追加内容到文件末尾。f_write的第四个参数返回实际写入字节数如果cnt小于传入长度要先检查磁盘剩余空间再查 USB 连接是否在写入期间中断。3.4 读回文件内容读取时通常用大缓冲区分块避免 MCU 内存不够。使用适合 F407 内部 SRAM 的 4KB 块读取方式FIL fd; UINT br; BYTE buf[4096]; FRESULT res f_open(fd, 0:/config.bin, FA_READ); while (res FR_OK) { res f_read(fd, buf, sizeof(buf), br); if (br 0) break; // 对 buf 做解析或转发 } f_close(fd);f_read返回后br表示真正读到的字节数最后一次小于sizeof(buf)是正常的看到br为 0 才表示到达文件末尾。注意不要直接把 4096 当成有效数据长度最后一次缓冲区里可能有上一次残留数据必须用br截断。4. 读写 U 盘遇上枚举失败、掉线与兼容性问题的排错参数无论移植做得多顺U 盘兼容性总会冒出来。这一章把最常见的失败表象和参数调整逻辑列清楚。4.1 时钟配置48MHz 必须来自 PLL Q 输出USB OTG_FS 的 PHY 需要精确的 48MHz来源是 PLL Q 输出。F407 系统时钟 168MHz 对应 PLL_N336、PLL_P2此时 PLL_Q7 得到 48MHz。如果从其他工程模板直接抄一个 Q8USB 枚举会失败但串口外设正常很误导人。RCC_OscInitTypeDef RCC_OscInitStruct {0}; RCC_OscInitStruct.OscillatorType RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLM 8; RCC_OscInitStruct.PLL.PLLN 336; RCC_OscInitStruct.PLL.PLLP RCC_PLLP_DIV2; RCC_OscInitStruct.PLL.PLLQ 7; // USB 时钟关键参数 if (HAL_RCC_OscConfig(RCC_OscInitStruct) ! HAL_OK) { Error_Handler(); }如果换过时钟树Q 值要先算USB 时钟 HSE/M × N / Q结果必须等于 48MHz。最容易疏忽的是 PLL_Q 只在 HSE 作为源时有效如果用内部 HSIUSB 时钟源要切换到内部 48MHz 时钟路径不能沿用这套配置。4.2 VBUS 供电不足与 USB 电流保护区枚举失败的另一个高发区是 VBUS。主机栈在检测到插入后会等 VBUS 有效如果板子的 5V 电源能力不足U 盘电容一充就跌落D 上拉被拉低主机就会反复做端口复位。现象可能原因处理建议插上后 U 盘灯不亮VBUS 无 5V检查 USB 座 VBUS 与电源网络连没连灯亮但枚举到一半变慢供电跌落在 VBUS 到地加 100uF 电解电容拔插一次后第二次识别失败限流开关自恢复换可控限流芯片如 TPS20514.3 FATFS 宏参数长文件名、卷数量与扇区安全FATFS 的ffconf.h里几个宏直接影响 U 盘读写的成功率。长文件名默认关闭时f_open(0:/扩展固件_V2.bin)会返回FR_NO_FILE但文件其实存在因为 FAT 短目录项被截断成 DOS 8.3 格式。宏建议值说明FF_USE_LFN1开启长文件名F407 建议用 1静态数组2 是动态内存占用FF_VOLUMES1只有一个 USB 卷节省内存FF_MAX_SS4096兼容 4K 扇区 U 盘代价是 FATFS 缓冲区变大FF_MULTI_PARTITION0不启用多分区避免带多个分区时挂载错乱另外注意FF_FS_READONLY必须为 0否则f_open带FA_WRITE会直接返回FR_WRITE_PROTECTED。4.4 MSC 超时与读写失败的重试USBH 的 MSC 驱动对设备响应有内部超时初始化阶段默认较长但读写阶段有些 U 盘在空闲后会进入省电模式第一次f_read要重新启动磁盘容易超时。常见做法是在disk_read外层做重试DRESULT disk_read(BYTE pdrv, BYTE *buff, LBA_t sector, UINT count) { for (uint8_t retry 0; retry 3; retry) { if (USBH_MSC_Read(hUsbHostFS, 0, sector, buff, count) USBH_OK) return RES_OK; HAL_Delay(10); } return RES_ERROR; }重试间隔 10ms 足够让低速 U 盘完成内部复位但不应加大到 100ms否则USBH_Process状态机被长时间阻塞主机栈会把慢响应误判成拔插。如果连续三次失败还出现在同一扇区大概率是劣质 U 盘在 CSW 阶段就出错只能换盘验证。4.5 常见日志表现与排查方向HAL 库 USBH 会把错误打印到串口常见日志表现如下日志表现含义排查方向USBH_FAILED / HAL_BUSY状态机内部错误检查USBH_Process是否被中断长时间打断USBH_NOT_SUPPORTED设备不是 MSC 类确认USBH_Init注册的类正确反复 Reset端口复位失败核对 PA11/PA12 是否接反时钟 48MHzCBW 方向错误MSC 协议错误U 盘兼容性换一个品牌 U 盘验证5. 让 U 盘读写更快更稳分块、缓冲与一致性验证当 U 盘能稳定读写后真正需要打磨的是大文件传输和掉电安全问题。5.1 大文件分块传输直接f_read/f_write一次性读写几十 MB 会耗尽内存F407 片内也只有 192KB SRAM。一般做法是固定 4KB 块循环处理。在写固件升级时我会把ota.bin分段写入 Flash每处理完 16 个扇区翻转一次缓冲区让 USB 传输和 Flash 擦写时间重叠。5.2 双缓冲与传输速率USB FS 模式下理论带宽约 1.2MB/s实际带 FATFS 文件头和数据边界能跑 700KB/s 以上就算正常。想再快可以把USBH_MSC_Read的单次请求扇区数从 4 提到 64一次传输 32KB减少协议切换次数。但双缓冲在裸机下比较麻烦USBH 的 MSC 读写是同步调用建议只把块大小调大而不是强行做乒乓。5.3 一致性验证与卸载时机写完文件后不要立刻拔 U 盘直接断电可能丢掉 FAT 表缓存。要在f_close之后额外执行f_mount(NULL, 0:, 1)这个调用会让 FATFS 释放卷句柄并完成内部状态清理。验证写盘是否成功时不能只看f_write返回值要重新以FA_READ打开文件把读到的字节数和写入长度对比更严格的做法是按 4KB 块对原数据和 U 盘文件各算一次 CRC32两边一致再认为成功。拔出事件回调里不要做大量计算建议只置一个pullout_request标志等主循环USBH_Process跑完当前事务后再去校验文件和卸载这样 U 盘主控收到的是干净的停止指令日志落盘就不会被系统截断。本文还有配套的精品资源点击获取