STM32学习笔记之fatfs文件系统接口函数使用

FatFS文件系统包含了文件

ff.h ：文件系统实现头文件，定义有文件系统所需的数据结构

diskio.h ：底层驱动头文件，就一些状态宏的定义和底层驱动函数的申明

integer.h：仅实现数据类型重定义,增加系统的可移植性

ffconf.h ：文件系统配置

ff.c ：文件系统实现。

diskio.c 底层驱动

f_mount - 注册/注销一个工作区域（Work Area）

f_open - 打开/创建一个文件f_close - 关闭一个文件

f_read - 读文件f_write - 写文件

f_lseek - 移动文件读/写指针

f_truncate - 截断文件

f_sync - 冲洗缓冲数据 Flush Cached Data

f_opendir - 打开一个目录

f_readdir - 读取目录条目

f_getfree - 获取空闲簇 Get Free Clusters

f_stat - 获取文件状态

f_mkdir - 创建一个目录

f_unlink - 删除一个文件或目录

f_chmod - 改变属性（Attribute）

f_utime - 改变时间戳（Timestamp）

f_rename -重命名/移动一个文件或文件夹

f_mkfs - 在驱动器上创建一个文件系统

f_forward - 直接转移文件数据到一个数据流 Forward file data to the stream directly

f_gets - 读一个字符串

f_putc - 写一个字符

f_puts - 写一个字符串

f_printf - 写一个格式化的字符磁盘I/O接口

f_tell - 获取当前读/写指针

f_eof - 测试一个文件是否到达文件末尾

f_size - 获取一个文件大小

f_error - 测试一个文件是否出错

因为FatFs模块完全与磁盘I/O层分开，因此需要下面的函数来实现底层物理磁盘的读写与获取当前时间。底层磁盘I/O模块并不是FatFs的一部分，并且必须由用户提供。

disk_initialize - Initialize disk drive 初始化磁盘驱动器

disk_status - Get disk status 获取磁盘状态

disk_read - Read sector(s) 读扇区

disk_write - Write sector(s) 写扇区

disk_ioctl - Control device dependent features 设备相关的控制特性

get_fattime - Get current time 获取当前时间

结合我之前写的一篇博客SPI操作SD卡驱动,完成自定义的diskio.c文件如下：

#include"nrf_gpio.h"

#include"nrf_drv_spi.h"

#include"nrf_drv_common.h"

#include"nrf_assert.h"

#include"app_util_platform.h"

#include"bsp.h"

#include"app_trace.h"

#include"string.h"

#include"drv_sd_api.h"

#include"diskio.h"

/*StatusofDiskFunctions*/

DSTATUSdisk_initialize(BYTEdrv)

{

uint8_tres=0;

res=SD_Card_Initialize();//正确返回1：sd2:SDHC

if(res!=1)returnSTA_NOINIT;

elsereturn0;

}

DSTATUSdisk_status(

BYTEdrv/*Physicaldrivenmuber(0..)*/

)

{

return0;

}

DRESULTdisk_read(

BYTEdrv,/*Physicaldrivenmuber(0..)*/

BYTE*buff,/*Databuffertostorereaddata*/

DWORDsector,/*Sectoraddress(LBA)*/

BYTEcount/*Numberofsectorstoread(1..255)*/

)

{

uint8_tres=0;

if(!count)returnRES_PARERR;

if(count==1)//1个sector的读操作

{

res=SD_readSingleBlock(sector,buff);

}

else//多个sector的读操作

{

res=SD_ReadMultiBlock(sector,buff,count);

}

if(res==0x00)returnRES_OK;

elsereturnRES_ERROR;

}

#if_READONLY==0

DRESULTdisk_write(

BYTEdrv,/*Physicaldrivenmuber(0..)*/

constBYTE*buff,/*Datatobewritten*/

DWORDsector,/*Sectoraddress(LBA)*/

BYTEcount/*Numberofsectorstowrite(1..255)*/

)

{

uint8_tres=0;

if(count==1)

{

res=SD_writeSingleBlock(sector,buff);

}

else

{

res=SD_WriteMultiBlock(sector,buff,count);

}

//返回值转换

if(res==0)

{

returnRES_OK;

}

else

{

returnRES_ERROR;

}

}

#endif/*_READONLY*/

DRESULTdisk_ioctl(

BYTEdrv,/*Physicaldrivenmuber(0..)*/

BYTEctrl,/*Controlcode*/

void*buff/*Buffertosend/receivecontroldata*/

)

{

DRESULTres;

if(drv)

{

returnRES_PARERR;//仅支持单磁盘操作，否则返回参数错误

}

//FATFS目前版本仅需处理CTRL_SYNC，GET_SECTOR_COUNT，GET_BLOCK_SIZ三个命令

switch(ctrl)

{

caseCTRL_SYNC:

/*

SD_CS_ENABLE();

if(SD_WaitReady()==0)

{

res=RES_OK;

}

else

{

res=RES_ERROR;

}

SD_CS_DISABLE();

*/