FATFS是面向小型嵌入式系统的一种通用FAT文件系统,由ANSI C语言编写,并且完全独立于底层的I/O介质。所以可以基本不做修改直接移植到任何处理器中,在STM32CUbeIDE中自带FATFS能够更加方便的使用。它支持FATl2、FATl6 和FAT32,支持多个存储媒介;有独立的缓冲区,可以对多个文件进行读/写,并特别对8 位单片机和16 位单片机做了优化。
FATFS 的特点有:
• 兼容 Windows 的 FAT 文件系统。
• 极小的代码量和工作区
• 丰富的配置选项:
– 多卷 (物理驱动与分区)。
– 多个 ANSI/OEM 代码页,包括 DBCS。
– 以 ANSI/OEM 或 Unicode 支持长文件名。
– 支持 RTOS。
– 支持多种扇区大小。
– 只读、最小化的 API、 I/O 缓冲等等 ......
– FAT子类型:FAT12、 FAT16 和 FAT32。
– 打开的文件数量:无限制,取决于可用的内存。
– 卷的数量:多达 10 个。
– 文件大小:取决于 FAT 规范。(多达 4G-1 字节)
– 卷的大小:取决于 FAT 规范。(512 字节 / 扇区情况下,支持多达 2T 字节)
– 簇的大小:取决于 FAT 规范。(512 字节 / 扇区情况下,支持多达 64K 字节)
– 扇区的大小:取决于 FAT 规范。(多达 4K 字节)
最顶层是应用层,使用者无需理会FATFS 的内部结构和复杂的FAT 协议,只需要调用FATFS 模块提供给用户的一系列应用接口函数。底层磁盘 I/O 和 RTC 模块均与 FatFs 模块完全分离。它们必须由用户提供,这是将 FatFs 模块与其它平台相连的主要工作。
使用的是正点原子Mini开发板STM32F103RC,自带SD卡SPI接口。SD_CS片选是PA3。
开启调试下载:
开启外部时钟:
配置时钟72M:
开启串口调试USART1:
开启硬件SPI:
开启FatFs文件系统:
最重要的一点片选 PA3:
选择开启PA2 PA4目的是为了不对SD卡干扰,开发板SPI接口上面还有Flash,为了不影响SD卡,所以开启PA2 PA4禁止片选。片选根据自己的开发板的电路选择,我自己使用的正点原子开发板。
解决中文乱码,选择GBK编码,默认没有GBK自己手动输入。
配置部分基本完成,修改编写代码。
保存所需要的fatfs.c fatfs.h文件代码,fatfs.c fatfs.h文件代码比较多,我就不在这个地方放了,最后我会附上我的工程文件,有需要自己下载。这里仅仅展示一部分。重要的一点,不要忘记添加文件路径。
volatile uint8_t FatFsCnt = 0;
volatile uint16_t Timer1, Timer2;
void SDTimer_Handler(void)
{
if(Timer1 > 0)
Timer1--;
if(Timer2 > 0)
Timer2--;
}
void SysTick_Handler(void)
{
/* USER CODE BEGIN SysTick_IRQn 0 */
FatFsCnt++;
if(FatFsCnt >= 10)
{
FatFsCnt = 0;
SDTimer_Handler();
}
/* USER CODE END SysTick_IRQn 0 */
HAL_IncTick();
/* USER CODE BEGIN SysTick_IRQn 1 */
/* USER CODE END SysTick_IRQn 1 */
}
第 2 出要修改部分:
下面所有的返回的值都修改。
return SD_disk_initialize(pdrv);
return SD_disk_status(pdrv);
return SD_disk_read(pdrv, buff, sector, count);
return SD_disk_write(pdrv, buff, sector, count);
return SD_disk_ioctl(pdrv, cmd, buff);
这个几个函数是定义在fatfs_sd.h头文件里面,所有不要忘记添加**#include “fatfs_sd.h”**头文件。
/* USER CODE BEGIN Includes */
#include "fatfs_sd.h"
#include "string.h"
#include "stdio.h"
#include
#define printf(...) HAL_UART_Transmit((UART_HandleTypeDef *)&huart1, (uint8_t *)u_buf,\
sprintf((char*)u_buf,__VA_ARGS__), 0xFFFF);
uint8_t u_buf[256];
/* USER CODE END Includes */
/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */
FATFS fs; // 文件系统
FIL fil; // 文件
FILINFO fno; //缓冲
FRESULT fresult; // 结果
UINT br, bw; // 文件读/写计数
/**** 相关变量定义 *****/
FATFS *pfs;
DWORD fre_clust;
uint32_t total, free_space;
#define BUFFER_SIZE 128
char buffer[BUFFER_SIZE]; // 存储字符串 缓冲大小
int i=0;
int bufsize (char *buf)
{
int i=0;
while (*buf++ != '\0') i++;
return i;
}
//清除缓冲
void clear_buffer (void)
{
for (int i=0; i<BUFFER_SIZE; i++) buffer[i] = '\0';
}
//发送字符
void send_uart (char *string)
{
uint8_t len = strlen (string);
HAL_UART_Transmit(&huart1, (uint8_t *) string, len, HAL_MAX_DELAY); // transmit in blocking mode
}
/* USER CODE END 0 */
/* USER CODE BEGIN 2 */
printf("\r\n ****** FatFs Example ******\r\n\r\n");
HAL_Delay (500);
fresult = f_mount(&fs, "/", 1); //挂载SD卡
if (fresult != FR_OK) send_uart ("ERROR!!! in mounting SD CARD...、\r\n");
else send_uart("SD CARD mounted successfully...\r\n");
/*************** Card capacity details ********************/
/* 检查空闲空间 */
f_getfree("", &fre_clust, &pfs);
total = (uint32_t)((pfs->n_fatent - 2) * pfs->csize * 0.5);
sprintf (buffer, "SD CARD Total Size: \t%lu\r\n",total);
send_uart(buffer);
clear_buffer();
free_space = (uint32_t)(fre_clust * pfs->csize * 0.5);
sprintf (buffer, "SD CARD Free Space: \t%lu\r\n",free_space);
send_uart(buffer);
clear_buffer();
/************* 下面的操作是使用PUT和GET 文件写入和读取 *********************/
/* 打开文件来写入,如果它不存在创建文件写入*/
fresult = f_open(&fil, "file1.txt", FA_OPEN_ALWAYS | FA_READ | FA_WRITE);
/* 写入 */
f_puts("This data is from the FILE1.txt. And it was written using ...f_puts... ", &fil);//写入文字
/* 关闭文件 */
fresult = f_close(&fil);
if (fresult == FR_OK)send_uart ("File1.txt created and the data is written \r\n");
/* Open file to read */
fresult = f_open(&fil, "file1.txt", FA_READ);
/* 从文件中读取字符串 */
f_gets(buffer, f_size(&fil), &fil);//读取文件
send_uart("File1.txt is opened and it contains the data as shown below \r\n");
send_uart(buffer);
send_uart("\r\n\r\n");
/* 关闭文件*/
f_close(&fil);
/* 清除缓冲 */
clear_buffer();
/**************** 下面的操作是使用f_write和f_read**************************/
/* 使用读写访问创建第二个文件并打开它 */
fresult = f_open(&fil, "file2.txt", FA_CREATE_ALWAYS | FA_WRITE);
/* 写入 */
strcpy (buffer, "This is File2.txt, written using ...f_write... and it says Hello from Controllerstech\r\n");
fresult = f_write(&fil, buffer, bufsize(buffer), &bw);//写入缓冲文件
send_uart ("File2.txt created and data is written \r\n");
/* Close file */
f_close(&fil);
// 清除缓冲区以显示从文件中获得的结果
clear_buffer();
/* 打开第二个文件读取 */
fresult = f_open(&fil, "file2.txt", FA_READ);
if (fresult == FR_OK)send_uart ("file2.txt is open and the data is shown below \r\n");
/* 从文件中读取数据
* 请参阅参数的函数详细信息 */
f_read (&fil, buffer, f_size(&fil), &br);
send_uart(buffer);
send_uart("\r\n");
/* 关闭文件 */
f_close(&fil);
clear_buffer();
/*********************更新现有文件 ***************************/
/* 用写访问打开文件*/
fresult = f_open(&fil, "file2.txt", FA_OPEN_EXISTING | FA_READ | FA_WRITE);
/* 移动到文件末尾的偏移量 */
fresult = f_lseek(&fil, f_size(&fil));//使用文件大小作为偏移 在后面继续写入,不覆盖文件
if (fresult == FR_OK)send_uart ("About to update the file2.txt \r\n");
/* 将字符串写入文件 */
fresult = f_puts("This is updated data and it should be in the end", &fil);
f_close (&fil);
clear_buffer();
/* 打开以读取文件 */
fresult = f_open (&fil, "file2.txt", FA_READ);
/* 从文件中读取字符串*/
fresult = f_read (&fil, buffer, f_size(&fil), &br);
if (fresult == FR_OK)send_uart ("Below is the data from updated file2.txt \r\n");
send_uart(buffer);
send_uart("\r\n");
/* 关闭文件 */
f_close(&fil);
clear_buffer();
/*************************从目录中删除文件****************************/
fresult = f_unlink("/file1.txt");
if (fresult == FR_OK) send_uart("file1.txt removed successfully...\r\n");
fresult = f_unlink("/file2.txt");
if (fresult == FR_OK) send_uart("file2.txt removed successfully...\r\n");
/* 卸载SD卡 */
fresult = f_mount(NULL, "/", 1);
if (fresult == FR_OK) send_uart ("SD CARD UNMOUNTED successfully...\r\n");
/* USER CODE END 2 */
文件系统FatFs代码移植就结束了,通过在串口查看信息验证是否移植成功。最后附上工程文件:https://wwa.lanzous.com/i1kzxgdiqve
下载:密码:9rwi
小手留情,给个赞呗。