为测试新买的开发板TF卡读写是否正常，使用STM32CubeMX（后简称CubeMX）进行代码构建。生成代码后烧录测试，发现在挂载TF卡时无法成功，返回值为错误3（FR_NOT_READY）。经排查后问题已解决，遂记录配置过程供大家参考，并讲解挂载时返回错误3的解决方式。

①为了输出TF卡（或者SD卡）的读写测试结果，需要你的工程能实现串口打印。因此请准备好一个使用CubeMX生成的工程（我生成的为Keil工程），要求此工程能够使用printf函数打印信息到串口调试助手上。因为这个过程非常简单，并且教程极多，请自行搜索并准备工程。生成的工程根目录内容类似下图：

②请确认你的TF卡槽连接的IO，不同的板卡IO不同，例如我的板卡上热拔插检测引脚没有连接，本教程以我的IO连接为例，原理图如下所示：

双击工程文件夹根目录中“xxx.ioc”文件，此时会进入CubeMX的配置界面。

1.2.1 配置SDIO

①点击左侧“Connectivity”，Mode选择“SD 4 bits Wide bus”，将“SDIOCLK clock divide factor”设置为2（调试时先不要太快，试验成功后可以自行改），如下图所示：

②勾选NVIC中的“SDIO global interruptSDIO”，如下所示：

③配置GPIO，请参照你的板卡原理图进行配置。此处以我的原理图为例，配置如下图所示：

④注意，如果你的板卡上有热拔插检测引脚，请根据板卡原理图，直接在右侧的“PinOut View”窗口点击对应的引脚，设置为“GPIO_Input”模式。这里假设我的板卡热拔插检测引脚连接到PE2，则设置如下所示：

1.2.2 配置DMA（如果不想用DMA那么此步骤可省略）

①在SDIO配置下的“DMA Settings”栏目下点击ADD，添加RX与TX请求，添加后的配置无需修改，使用默认的参数即可：

1.2.3 配置FatFs

①点击右侧的“Middleware and Software Packs”，选择“FATFS”，Mode勾选“SDCard”，并修改“Set Defines”中的“CODE_PAGE (Code page ontarget)”为“DBSC”，修改“USE_LFN (Use Long Filename)”为“Enabled with dynamicworking buffer on the STACK”。如下所示：

②（此步骤使用DMA时才需要配置）如果使用了DMA，则需要在“Advanced Settings”栏目将“Use dma template”设置为“Enable”：

③（当你的板卡连接了热拔插检测引脚时此步骤才需要配置）如果你的板卡SD卡热拔插引脚连接到了GPIO上，那么需要在“Platform Settings”中将“Detect_SDIO”项配置为你前面设置为输入的那个引脚。比如我在前面假设我的板子检测引脚连接到了PE2，则配置如下：

！！！注意：如果你的板子上热拔插检测引脚未连接GPIO，那么这项可以不选，后面有警告直接忽略即可。当然你也可以随便选一个未使用的IO配置成输入模式，然后在这里选择该引脚，这样警告就消失了，但是要将此引脚接地，否则可能识别为卡没有插入导致TF读写测试不通过

1.2.4 配置NVIC

①打开“System Core”中的“NVIC”，修改DMA的两个通道的“Preemption Priority”值，只要大于“SDIO global interrupt”的值就可以了：

1.2.5 修改时钟配置

①点击“Clock Configuration”栏，将“48MHz clocks”的频率修改为48：

1.2.6 修改工程设置并输出工程

①打开“Project Manager”栏目，将“Minimum Stack Size”设置为0x500（空间足够的话最好设置大一点，比如可以设置为0x1000），设置后点击“GENERATE CODE”生成代码：

①打开Keil工程，在“main.c”文件中的main()函数前添加TF卡测试代码，代码内容如下：

//需要修改MX_SDIO_SD_Init为1B

#define u8 uint8_t
#define u16 uint16_t
#define u32 uint32_t

    FATFS fs;
    FIL fil;
    uint32_t total,mfree;                  // file objects
	uint32_t byteswritten;                /* File write counts */
	uint32_t bytesread;                   /* File read counts */
	uint8_t wtext[] = "SDTest File";      /* File write buffer */
	uint8_t rtext[100];                   /* File read buffers */
	char filename[] = "SDTest.txt";
  
u8 exf_getfree(u8 *drv,u32 *total,u32 *free)

	return res;
}

void Fatfs_RW_test(void)

    else
    {
      printf(" Mount sucess :) 
");
    }
     
    /*##-2- Create and Open new text file objects with write access ######*/
		retSD=exf_getfree("0",&total,&mfree);
		if(retSD==0)
			printf(" total : %d MB,free : %d MB  

",total>>10,mfree>>10);
		else
			 printf(" Getfree error!!! 
");
    retSD = f_open(&fil, filename, FA_CREATE_ALWAYS | FA_WRITE);
    if(retSD)
      printf(" Open file error!!! Error Num : %d
",retSD);
    else
      printf(" Open file sucess :) 
");
     
    /*##-3- Write data to the text files ###############################*/
    retSD = f_write(&fil, wtext, sizeof(wtext), (void *)&byteswritten);
    if(retSD)
      printf(" Write file error!!! Error Num : %d
",retSD);
    else
    {
      printf(" Write file sucess :) 
");
        printf(" Write Data : %s

",wtext);
    }
     
    /*##-4- Close the open text files ################################*/
    retSD = f_close(&fil);
    if(retSD)
        printf(" Close error!!! Error Num : %d
",retSD);
    else
      printf(" Close sucess :) 
");
     
    /*##-5- Open the text files object with read access ##############*/
    retSD = f_open(&fil, filename, FA_READ);
    if(retSD)
        printf(" Open file error!!! Error Num : %d
",retSD);
    else
        printf(" Open file sucess :) 
");
     
    /*##-6- Read data from the text files ##########################*/
    retSD = f_read(&fil, rtext, sizeof(rtext), (UINT*)&bytesread);
    if(retSD)
        printf(" Read error!!! Error Num : %d
",retSD);
    else
    {
        printf(" Read sucess :) 
");
        printf(" Read Data : %s

",rtext);
    }
     
    /*##-7- Close the open text files ############################*/
    retSD = f_close(&fil);
    if(retSD)  
        printf(" Close error!!! Error Num : %d
",retSD);
    else
        printf(" Close sucess :) 

");
     
    /*##-8- Compare read data with the expected data ############*/
    if(bytesread == byteswritten)
    { 
        printf(" FatFs is working well!!!
");
    }
}

②在main()函数中，MX_SDIO_SD_Init和MX_FATFS_Init执行完以后的地方调用TF测试代码：

经过上面的配置，如果你用的是旧版CubeMX软件，那么编译并烧录后便可以通过TF测试了（具体多旧的版本未知）。
如果此时你烧录运行发现输出了Mount Error的信息，Num值为3，如下图所示：

则说明你需要进行以下修改：

找到“void MX_SDIO_SD_Init(void)”函数，将“hsd.Init.BusWide”的值由“SDIO_BUS_WIDE_4B”修改为“SDIO_BUS_WIDE_1B”，修改后如下所示：

此时重新编译并运行，问题便得以解决，以下是测试通过时的输出信息：

在SDIO进行初始化时，使用的是1位宽模式进行配置的，在初始化完成后才会使用4位宽进行数据传输。新版的CubeMX软件生成代码时不知道为何会在初始化时直接配置成4位宽模式，从而导致初始化不过，返回错误3。因此只要将初始化代码中位宽进行修改即可。