STM32H7控制器SDMMC功能无法正常工作求助

问题背景 #

此前已在STM32F4/F7上成功实现SDIO+FATFS功能，但迁移到STM32H723ZG（Nucleo开发板）后，SD卡无法正常初始化，调试时卡在sd_diskio.c第220行的循环中，最终触发超时错误。

环境信息 #

• CubeMX V6.11.1生成代码
• 硬件：Nucleo-H723ZG + SD转接板 + 10cm跳线

已尝试操作 #

硬件层面 #

• 反复确认布线正确性，更换多款SD卡及转接板，问题复现。

CubeMX配置 #

1. 正确配置RCC的HSE/LSE
2. CPU时钟设为550MHz，PLL1Q输出183.333MHz
3. 启用SDMMC1，配置为4位宽总线模式
4. SDMMC时钟分频设为2，开启NVIC中断
5. 启用FATFS中间件并勾选SD卡支持
6. 将Max_ss增大至4096
7. 启用DMA模板
8. 指定P0为SD_DETECT引脚

固件层面 #

简化主函数，仅保留SD初始化与FATFS挂载逻辑，其余代码未修改，核心代码如下：

int main(void)
{
  MPU_Config();
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_SDMMC1_SD_Init();
  MX_FATFS_Init();

  /* USER CODE BEGIN 2 */
  HAL_StatusTypeDef result_sd_init = HAL_SD_Init(&hsd1);
  FRESULT result_mount = f_mount(&SDFatFS, (TCHAR const*)SDPath, 1);
  /* USER CODE END 2 */

  while (1)
  {
  }
}

核心差异与排查思路 #

STM32H7与F4/F7的核心差异集中在内存缓存（Cache）、MPU配置、SDMMC时钟初始化流程，以下是针对性排查步骤：

1. 修正MPU内存保护配置 #

H7带有L1 Cache，若SDMMC DMA缓冲区未正确配置MPU属性，会导致CPU与DMA数据不一致，引发超时。需为SD卡相关缓冲区（如FATFS缓存、DMA传输缓冲区）添加MPU区域配置，示例代码：

void MPU_Config(void)
{
  MPU_Region_InitTypeDef MPU_InitStruct = {0};

  HAL_MPU_Disable();

  // 配置SDDMA缓冲区为非缓存、可共享区域
  MPU_InitStruct.Enable = MPU_REGION_ENABLE;
  MPU_InitStruct.Number = MPU_REGION_NUMBER0;
  MPU_InitStruct.BaseAddress = (uint32_t)&SDFatFS; // 替换为实际缓冲区地址
  MPU_InitStruct.Size = MPU_REGION_SIZE_256B; // 根据缓冲区大小调整
  MPU_InitStruct.SubRegionDisable = 0x00;
  MPU_InitStruct.TypeExtField = MPU_TEX_LEVEL0;
  MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
  MPU_InitStruct.DisableExec = MPU_INSTRUCTION_ACCESS_DISABLE;
  MPU_InitStruct.IsShareable = MPU_ACCESS_SHAREABLE;
  MPU_InitStruct.IsCacheable = MPU_ACCESS_NOT_CACHEABLE;
  MPU_InitStruct.IsBufferable = MPU_ACCESS_BUFFERABLE;
  HAL_MPU_ConfigRegion(&MPU_InitStruct);

  HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
}

2. 调整SDMMC初始化时钟 #

SD卡初始化阶段要求时钟不超过400kHz，而当前配置的PLL1Q=183.333MHz分频2后为91.66MHz，远超限制。需先以低速时钟初始化SD卡，完成后再切换到高速：

// 修改MX_SDMMC1_SD_Init函数
HAL_StatusTypeDef MX_SDMMC1_SD_Init(SD_HandleTypeDef* hsd)
{
  hsd->Instance = SDMMC1;
  hsd->Init.ClockEdge = SDMMC_CLOCK_EDGE_RISING;
  hsd->Init.ClockPowerSave = SDMMC_CLOCK_POWER_SAVE_DISABLE;
  hsd->Init.BusWide = SDMMC_BUS_WIDE_4B;
  hsd->Init.HardwareFlowControl = SDMMC_HARDWARE_FLOW_CONTROL_DISABLE;
  hsd->Init.ClockDiv = 225; // 初始化时分频226，得到~810kHz，接近400kHz
  if (HAL_SD_Init(hsd) != HAL_OK)
  {
    Error_Handler();
  }
  // 初始化完成后切换到高速时钟
  hsd->Instance->CLKCR = (hsd->Instance->CLKCR & ~SDMMC_CLKCR_CLKDIV) | (2 << SDMMC_CLKCR_CLKDIV_Pos);
  return HAL_OK;
}

3. 修正DMA与Cache同步 #

若使用DMA传输，需在读写前后执行Cache同步操作：

• 读操作前：无效化对应区域Cache，确保CPU读取最新数据
• 写操作后：清理对应区域Cache，确保DMA能获取最新数据
  示例代码：

// 在SD_read函数中添加
SCB_InvalidateDCache_by_Addr((uint32_t*)buff, count * 512);
// 在SD_write函数中添加
SCB_CleanDCache_by_Addr((uint32_t*)buff, count * 512);

4. 验证SD_DETECT引脚配置 #

Nucleo-H723ZG的SD_DETECT引脚默认是PC13，而非P0，需核对硬件原理图，将引脚配置为输入模式+内部上拉，确保SD卡插入时能正确检测电平变化。

5. 简化测试流程 #

• 先禁用4位总线，改用1位总线测试，排除总线宽度问题
• 暂时移除FATFS，直接调用HAL_SD_ReadBlocks测试SD卡底层读写，定位问题是在SD初始化还是FATFS层

6. 升级HAL库/CubeMX版本 #

CubeMX V6.11.1对应的HAL库可能存在SDMMC相关bug，尝试升级至最新版本的CubeMX及HAL库，修复已知问题。

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