zedboard第十四课（SD卡，FAT32读写）

SDK的standalone已移植好了FatFs库(SDK中叫做xilffs)，所以在BSP中添加xilffs库后就可以在程序中使用FatFs中各API来操作SD卡，该库支持FAT12, FAT16 FAT32 and exFAT文件系统（本例将SD卡格式化为FAT32）。
打开BSP中的system.mss，可以修改BSP的配置信息。
我们选中xilffs这个lib，并在左侧选项卡中，对这个lib进行选项配置。确保fs_interface这个选项的值是true。还有use_lfn这个选项为true。还有use_strfunc这个选项为2，用来使能f_printf()函数。
之后我们可以在BSP中看到xilffs_v3_7这个文件夹。
diskio.c是底层操作函数，和板子相关的硬件操作。
ff.c是文件操作函数，和FATFS相关的文件操作。
我们主要使用的，就是FATFS相关的文件操作。

注意，之前版本中的f_write的关于section的BUG，在V3_7这个版本里，已经被修正了。即使写入的不是256的整数倍也是可以的，而且对写入的长度不再有最小长度的要求，哪怕只有1个BYTE都是可以的。

其中的几个重要函数是：

FRESULT f_mount (
	FATFS* fs,			/* Pointer to the file system object (NULL:unmount)*/
	const TCHAR* path,	/* Logical drive number to be mounted/unmounted */
	BYTE opt			/* 0:Do not mount (delayed mount), 1:Mount immediately */
)

这个函数用来挂载SD卡上的FAT32。

FRESULT f_open (
	FIL* fp,			/* Pointer to the blank file object */
	const TCHAR* path,	/* Pointer to the file name */
	BYTE mode			/* Access mode and file open mode flags */
)

这个函数用来打开一个FILE。

FRESULT f_lseek (
	FIL* fp,		/* Pointer to the file object */
	DWORD ofs		/* File pointer from top of file */
)

这个函数用来标记LSEEK。

FRESULT f_read (
	FIL* fp, 		/* Pointer to the file object */
	void* buff,		/* Pointer to data buffer */
	UINT btr,		/* Number of bytes to read */
	UINT* br		/* Pointer to number of bytes read */
)

这个函数用来读取文件中的数据，并转存到buff中来。

FRESULT f_write (
	FIL* fp,			/* Pointer to the file object */
	const void *buff,	/* Pointer to the data to be written */
	UINT btw,			/* Number of bytes to write */
	UINT* bw			/* Pointer to number of bytes written */
)

这个函数用来把buff中的数据，写入FILE中。

FRESULT f_close (
	FIL *fp		/* Pointer to the file object to be closed */
)

这个函数用来关闭一个FILE。

还有其他的一些函数，可以在ff.c文件中查看源代码，了解它的功能。

下面进行一些情景分析。

static FATFS fatfs;

声明一个静态的数据对象，FATFS类型，它用来作为SD卡上的FAT32文件系统的句柄。

#define FILE "test123456789.txt"
static  char src_str[MAX_LEN] = { 0 } ;
static  char dst_str[MAX_LEN] = { 0 } ;

定义缓冲区，定义文件名字符串。

int SD_Init()
{
FRESULT rc;
rc = f_mount(&fatfs,"",0);
if(rc)
{
xil_printf("ERROR : f_mount returned %d\r\n",rc);
return XST_FAILURE;
}
return XST_SUCCESS;
}

定义了初始化函数。主要是mount文件系统，利用空串，检索到系统内的默认的逻辑卷0，并初始化FATFS数据对象。
这是一个比较费解的地方，这里多做一些说明。
在fatfs外挂一个设备的时候，通过 f_mount(&fs, “”, 1);就可以访问，而在多个设备时，就得指定磁盘号。
支持以下两种方式:
f_mount(&fs, “1:”, 1);
f_mount(&fs, “1:/”, 1);

这种方式不支持：
f_mount(&fs, “1”, 1);

result = f_mount(&fs, "", 1);    /* Mount a logical drive */
 result = f_mount(&fs, "1:/", 1);    /* Mount a logical drive */
result  = f_mount(NULL, "1:/", 1); /* UnMount a logical drive */

这是f_mount使用的样例。

int SD_Transfer_read(char *FileName,u32 DestinationAddress,u32 ByteLength)
{
FIL fil;
FRESULT rc;
UINT br;

rc = f_open(&fil,FileName,FA_READ);
if(rc)
{
xil_printf("ERROR : f_open returned %d\r\n",rc);
return XST_FAILURE;
}
rc = f_lseek(&fil, 0);
if(rc)
{
xil_printf("ERROR : f_lseek returned %d\r\n",rc);
return XST_FAILURE;
}
rc = f_read(&fil, (void*)DestinationAddress,ByteLength,&br);
printf("act read len is %d \n\r",br );
if(rc)
{
xil_printf("ERROR : f_read returned %d\r\n",rc);
return XST_FAILURE;
}
rc = f_close(&fil);
if(rc)
{
xil_printf(" ERROR : f_close returned %d\r\n", rc);
return XST_FAILURE;
}
return XST_SUCCESS;
}

定义了读文件数据的函数。

int SD_Transfer_write(char *FileName,u32 SourceAddress,u32 ByteLength)
{
FIL fil;
FRESULT rc;
UINT bw;

rc = f_open(&fil,FileName,FA_CREATE_ALWAYS | FA_WRITE);
if(rc)
{
xil_printf("ERROR : f_open returned %d\r\n",rc);
return XST_FAILURE;
}
rc = f_lseek(&fil, 0);
if(rc)
{
xil_printf("ERROR : f_lseek returned %d\r\n",rc);
return XST_FAILURE;
}
rc = f_write(&fil,(void*) SourceAddress,ByteLength , &bw );
printf("SD_Transfer_write -> f_write result len is %d \n\r" , bw );
if(rc)
{
xil_printf("ERROR : f_write returned %d\r\n", rc);
return XST_FAILURE;
}
rc = f_close(&fil);
if(rc){
xil_printf("ERROR : f_close returned %d\r\n",rc);
return XST_FAILURE;
}
return XST_SUCCESS;
}

定义了写文件数据的函数。

下面来看看在main中如何使用SD的操作函数的具体流程。

r  = SD_Init();
if ( XST_SUCCESS != r ){
	printf("fail to open SD\n\r");
	return 1 ;
}
printf("OK to open SD\n\r");

初始化SD卡。

SD_Transfer_write(FILE,(void *)src_str,(MAX_LEN));
printf("write done SD\n\r");

向FILE中写入buffer里的数据。

SD_Transfer_read(FILE,(void*)dst_str,(MAX_LEN));
printf("read done SD\n\r");

从FILE中读出数据，写入BUFFER。