如何使用STM32F401CCU6黑开发板实现U盘文件写入？

1. 硬件与Cube配置检查 #

• 确认开发板USB OTG引脚连接正确：STM32F401CCU6的OTG_FS引脚为PA9(VBUS)、PA10(ID)、PA11(DM)、PA12(DP)，需确保这些引脚未被复用为其他功能，且硬件上VBUS有稳定5V供电（部分黑板需通过跳线或外部电源提供）。
• 在STM32CubeMX中重新验证配置：
  • 启用USB_OTG_FS，模式设为Host Only，若硬件支持则勾选VBUS sensing选项。
  • 启用FATFS模块，选择USB Host作为底层存储介质，确保USBHPath定义为"0:"或"/"（不同Cube版本路径格式可能有差异）。
  • 确认USB_HOST中间件已添加，且启用了Mass Storage Class（MSC）支持。

2. 驱动链接与初始化顺序修正 #

• 确保FATFS_LinkDriver调用时机正确：必须在USB_HOST完成U盘枚举、挂载成功后调用，不能在系统初始化阶段直接执行。标准流程示例：

  // 全局标记U盘挂载状态
  uint8_t usb_mounted_flag = 0;
  
  // 初始化USB Host
  MX_USB_HOST_Init();
  
  while (1) {
      // 轮询USB Host任务
      USBH_Process(&hUsbHostFS);
      
      // 等待U盘挂载完成后执行驱动链接
      if (usb_mounted_flag == 1) {
          FRESULT res = FATFS_LinkDriver(&USBH_Driver, USBHPath);
          if (res != FR_OK) {
              // 此处可添加错误码打印，参考FATFS的FRESULT枚举定位问题
          }
          // 仅执行一次链接操作，避免重复调用
          usb_mounted_flag = 2;
      }
  }
  

• 检查USBH_Driver和USBHPath的定义：确保USBHPath是FATFS识别的合法路径（通常为"0:"），且USBH_Driver是Cube生成的默认驱动实例，未被错误修改。

3. 错误码针对性排查 #

• 捕获FATFS_LinkDriver返回的FRESULT枚举值，对照分析：
  • FR_NO_FILESYSTEM：U盘未格式化或文件系统不兼容（需确保U盘为FAT32/FAT16格式，NTFS不被FATFS原生支持）。
  • FR_INVALID_DRIVE：USBHPath路径格式错误，需确认字符串符合FATFS路径规范。
  • FR_NOT_READY：USB Host未完成U盘枚举，需等待USB回调触发挂载完成信号。

4. 调试与回调函数验证 #

• 在STM32CubeIDE中设置断点，查看USBH_Driver的disk_status等成员变量状态，确认U盘硬件是否被正确识别。
• 完善USB Host回调函数，标记挂载状态：

  void USBH_UserProcess(USBH_HandleTypeDef *phost, uint8_t id) {
      switch(id) {
          case HOST_USER_DISCONNECTION:
              usb_mounted_flag = 0;
              break;
          case HOST_USER_CLASS_ACTIVE:
              usb_mounted_flag = 1; // 标记U盘已完成挂载
              break;
          default:
              break;
      }
  }
  

5. 自动生成代码修正 #

• 检查Cube生成的MX_FATFS_Init()函数，若FATFS_LinkDriver被自动放在该初始化函数中，需将其移除，延迟到U盘挂载后执行，避免因USB未就绪导致链接失败。

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