STM32H745I添加FreeRTOS后USB_OTG_FS MSC模式挂载触发HardFault求助

核心FreeRTOS配置修正 #

• 中断优先级统一配置
  STM32H7的中断优先级分组必须全局一致，且USB_OTG_FS、MSHC的中断优先级必须高于FreeRTOS的configMAX_SYSCALL_INTERRUPT_PRIORITY：

  1. 在FreeRTOSConfig.h中设置：
     • configKERNEL_INTERRUPT_PRIORITY = 0xF0（对应最低抢占优先级15，4位抢占优先级配置下）
     • configMAX_SYSCALL_INTERRUPT_PRIORITY = 0x50（假设USB/MSHC中断抢占优先级设为5，数值越小优先级越高）
  2. 在CubeMX中配置USB_OTG_FS和MSHC的中断抢占优先级为5或更低（数值更小），确保不触发系统调用优先级限制

• 栈空间扩容

  • 给USB MSC相关任务分配至少1024字节栈空间（STM32H7栈单位为4字节，对应configMINIMAL_STACK_SIZE * 4），避免栈溢出
  • 在启动文件startup_stm32h745xx.s中增大Stack_Size，从默认的0x400调整为0x800，预留足够系统栈空间

USB与FATFS的线程安全适配 #

• USB中断函数加锁
  修改stm32h7xx_it.c中的USB中断服务函数，用FreeRTOS中断保护宏包裹：

  void OTG_FS_IRQHandler(void)
  {
    portENTER_CRITICAL_ISR();
    HAL_HCD_IRQHandler(&hhcd_USB_OTG_FS);
    portEXIT_CRITICAL_ISR();
  }
  

• FATFS线程安全开启
  在ffconf.h中配置：

  • _FS_REENTRANT = 1
  • _MAX_LOCK = 2（匹配同时访问FATFS的任务数量）
  • 所有FATFS操作（f_mount、f_open、f_write等）前后加FreeRTOS互斥锁，比如：

    xSemaphoreTake(xFatfsMutex, portMAX_DELAY);
    f_open(&file, "test.txt", FA_CREATE_ALWAYS | FA_WRITE);
    xSemaphoreGive(xFatfsMutex);
    

硬件与Cache适配 #

• MSHC总线优先级调整
  在CubeMX的MSHC配置中，将AHB总线优先级设为高于USB，避免总线冲突导致HardFault

• Cache同步处理
  STM32H7的DCache会导致USB/MSHC缓冲区数据不一致，需在数据传输前后执行Cache同步：

  // 写入前清理Cache
  SCB_CleanDCache_by_Addr((uint32_t*)buf, buf_size);
  // 读取前失效Cache
  SCB_InvalidateDCache_by_Addr((uint32_t*)buf, buf_size);
  

调试定位技巧 #

• HardFault寄存器分析
  进入中断后读取SCB->HFSR、SCB->CFSR：

  • CFSR->MMFSR的IACCVIOL/DACCVIOL表示非法内存访问，检查指针或数组越界
  • CFSR->UFSR的UNDEFINSTR表示执行未定义指令，排查编译器优化或函数调用错误

• 栈溢出检测
  在FreeRTOSConfig.h中开启：

  #define configCHECK_FOR_STACK_OVERFLOW 2
  

  实现钩子函数定位溢出任务：

  void vApplicationStackOverflowHook(TaskHandle_t xTask, char *pcTaskName)
  {
    while(1); // 触发断点，查看pcTaskName定位问题任务
  }
  

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