STM32H743使用FATFS时返回FR_NOT_READY？

Question

在使用STM32H743配合FATFS文件系统时，常遇到`f_mount`或`f_open`等函数返回`FR_NOT_READY`错误。该问题通常源于底层SDIO或SPI外设驱动未能正确初始化SD卡，或电源稳定后未给予存储介质足够的启动时间。尤其在使用HAL库时，若未正确配置时钟、GPIO或未实现`disk_initialize()`中对SD卡的正常识别流程，FATFS将无法访问设备。此外，Card_Detect引脚电平误判或写保护状态异常也会导致此错误。需检查`disk_status`是否返回`STA_NOINIT`或`STA_NODISK`，并确保`disk_ioctrl`和初始化时序符合物理层规范。

Answer 1

1. 问题现象与初步诊断

在使用STM32H743配合FATFS文件系统时，开发者常遇到f_mount或f_open函数返回FR_NOT_READY错误。该错误表明FATFS无法访问底层存储设备，通常意味着物理层尚未准备好。

从FATFS的架构来看，该返回值由disk_status()函数的状态决定。若其返回STA_NOINIT（未初始化）或STA_NODISK（无卡），则f_mount将直接失败。

• FR_NOT_READY：设备未就绪
• STA_NOINIT：磁盘未初始化
• STA_NODISK：无存储介质

2. 常见技术问题分析

导致此问题的技术因素可归纳为以下几类：

类别	具体原因	影响层级
电源与时序	SD卡上电后未等待足够稳定时间（至少74个时钟周期）	物理层
外设配置	SDIO/SPI时钟、GPIO未正确初始化	驱动层
FATFS接口实现	disk_initialize()未完成标准识别流程	中间件层
硬件检测逻辑	Card_Detect引脚误判、写保护状态异常	硬件感知层

3. 深入剖析初始化流程

以SDIO模式为例，FATFS通过diskio.c中的接口调用底层驱动。关键函数执行顺序如下：

f_mount() → disk_initialize() → SD_Init()
                      ↓
              SD_SendCmd(CMD0, 0) // 进入Idle状态
              SD_SendCmd(CMD8, ...) // 检查电压匹配
              ACMD41(...)          // 等待卡退出Idle
              Read CID/CSD         // 获取卡信息
              Select Card (CMD7)   // 激活卡
    

若任一命令超时或校验失败，disk_initialize()将返回错误，进而导致disk_status()持续返回STA_NOINIT。

4. HAL库下的典型配置陷阱

在使用STM32 HAL库时，常见疏漏包括：

1. 未启用SDMMC1/2时钟：__HAL_RCC_SDMMC1_CLK_ENABLE()
2. GPIO配置错误：CLK、CMD、D0~D3未设置为AF12（SDIO）模式
3. 未配置内部时钟分频器，导致初始频率超过400kHz（应≤400kHz）
4. 中断优先级未设置，影响DMA传输完成回调
5. 未调用HAL_SD_Init()或其内部初始化失败但未捕获

5. 解决方案与最佳实践

以下是推荐的调试与修复步骤：

graph TD
            A[上电] --> B[延时至少1ms]
            B --> C[初始化SDIO外设]
            C --> D[调用disk_initialize()]
            D --> E{返回成功?}
            E -- 是 --> F[调用f_mount()]
            E -- 否 --> G[检查disk_status()]
            G --> H{STA_NODISK?}
            H -- 是 --> I[检查Card Detect引脚]
            H -- 否 --> J[抓取SDIO波形分析命令交互]
            J --> K[验证ACMD41重试机制]

6. 关键代码片段示例

确保在disk_initialize()中包含必要的延时和重试逻辑：

DSTATUS disk_initialize(BYTE drv) {
    if (drv) return RES_NOTRDY;
    if (SD_Init() != HAL_OK) {
        status |= STA_NOINIT;
        return status;
    }
    // 额外确保卡已稳定
    HAL_Delay(10);
    if (HAL_SD_WaitCardsState(&hsd1, HAL_SD_CARD_TRANSFER) != HAL_OK)
        return STA_NOINIT;
    status &= ~STA_NOINIT;
    return status;
}
    

同时，在主循环挂载前建议加入状态轮询：

while (disk_status(0) & STA_NOINIT) {
    printf("SD card not initialized...\n");
    HAL_Delay(100);
}