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

FatFS文件系统包含了文件ff.h :文件系统实现头文件,定义有文件系统所需的数据结构
diskio.h :底层驱动头文件,就一些状态宏的定义和底层驱动函数的申明
integer.h:仅实现数据类型重定义,增加系统的可移植性
ffconf.h :文件系统配置
ff.c :文件系统实现 。
diskio.c 底层驱动

FatFs 提供下面的函数API: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();
【STM32学习笔记之fatfs文件系统接口函数使用】*/

    推荐阅读