|  **银杏科技有限公司旗下技术文档发布平台**  ||||
|技术支持电话|**0379-69926675-801**|||
|技术支持邮件|Gingko@vip.163.com|||
^  版本  ^  日期  ^  作者  ^  修改内容  ^
|  V1.0  |  2019-02-29  |  gingko  |  初次建立  | 
\\
\\
\\
\\
===== STM32CubeMX教程十七——FATFS实验 =====
\\
1.在主界面选择File-->New Project   或者直接点击ACCEE TO MCU SELECTOR  
{{ :icore4t:icore4t_cube_17_1.png?direct |}}
2.出现芯片型号选择,搜索自己芯片的型号,双击型号,或者点击Start Project进入配置
在搜索栏的下面,提供的各种查找方式,可以选择芯片内核,型号,等等,可以帮助你查找芯片。本实验选取的芯片型号为:STM32H750IBKx。
{{ :icore4t:icore4t_cube_17_2.png?direct |}}
3.配置RCC,使用外部时钟源
{{ :icore4t:icore4t_cube_17_3.png?direct |}}
4.时基源选择SysTick
{{ :icore4t:icore4t_cube_17_4.png?direct |}}
5.将PA10,PB7,PB8设置为GPIO_Output
{{ :icore4t:icore4t_cube_17_5.png?direct |}}
6.引脚模式配置
{{ :icore4t:icore4t_cube_17_6.png?direct |}}
{{ :icore4t:icore4t_cube_17_7.png?direct |}}
7.设置串口
{{ :icore4t:icore4t_cube_17_8.png?direct |}}
8.在NVIC Settings一栏使能接收中断
{{ :icore4t:icore4t_cube_17_9.png?direct |}}
9.配置SDMMC1
{{ :icore4t:icore4t_cube_17_10.png?direct |}}
10.配置FATFS
{{ :icore4t:icore4t_cube_17_11.png?direct |}}
11.时钟源设置,选择外部高速时钟源,配置为最大主频
{{ :icore4t:icore4t_cube_17_12.png?direct |}}
{{ :icore4t:icore4t_cube_17_13.png?direct |}}
12.工程文件的设置, 这里就是工程的各种配置 我们只用到有限几个,其他的默认即可  IDE我们使用的是 MDK V5.27
{{ :icore4t:icore4t_cube_17_14.png?direct |}}
13.点击Code Generator,进行进一步配置
{{ :icore4t:icore4t_cube_17_15.png?direct |}}
  * **Copy all used libraries into the project folder**
  * **将HAL库的所有.C和.H都复制到所建工程中**
    * 优点:这样如果后续需要新增其他外设又可能不再用STM32CubeMX的时候便会很方便
    * 缺点:体积大,编译时间很长
  * **Copy only the necessary library files**
  * **只复制所需要的.C和.H(推荐)**
    * 优点:体积相对小,编译时间短,并且工程可复制拷贝
    * 缺点:新增外设时需要重新用STM32CubeMX导入
  * **Add necessary library files as reference in the toolchain project configuration file**
  * **不复制文件,直接从软件包存放位置导入.C和.H**
  * 优点:体积小,比较节约硬盘空间
    * 缺点:复制到其他电脑上或者软件包位置改变,就需要修改相对应的路径
    * 自行选择方式即可
14.然后点击GENERATE CODE  创建工程
{{ :icore4t:icore4t_cube_17_16.png?direct |}}
创建成功,打开工程。
\\
\\
\\
===== 实验十七:FATFS实验——文件操作 =====
==== 一、 实验目的与意义 ====
  - 了解STM32 FATFS结构。
  - 了解STM32 FATFS特征。
  - 掌握FATFS的使用方法。
  - 掌握STM32 HAL库中FATFS属性的配置方法。
  - 掌握KEILMDK 集成开发环境使用方法。
==== 二、 实验设备及平台 ====
  - iCore4T 双核心板。[[https://item.taobao.com/item.htm?spm=a1z10.1-c.w137644-251734891.3.5923532fDrMDOe&id=610595120319|点击购买]]
  - JLINK(或相同功能)仿真器。[[https://item.taobao.com/item.htm?id=554869837940|点击购买]]
  - Micro USB线缆。
  - Keil MDK 开发平台。
  - STM32CubeMX开发平台。
  - 装有WIN XP(及更高版本)系统的计算机。
==== 三、 实验原理 ====
=== 1.文件系统 ===
  * 负责管理和存储文件信息的软件机构称为文件管理系统,简称文件系统。即在磁盘上组织文件的方法。
  * 常见的文件系统:
    * (1) FAT/FATFS。
    * (2) NTFS(基于安全性的文件系统,是Window NT采用的独特的文件系统结构。
    * (3) CDFS:CDFS是大部分光盘的文件系统。
=== 2.FATFS文件系统简介: ===
  * FATFS是一个完全免费开源的FAT文件系统模块,专门为小型的嵌入式系统而设计,完全用标准C语言编写,具有良好的硬件平台独立性,可移植到8051、PIC、ARM等系列单片机上而只需做简单的修改。它支持FAT12、FAT16、FATI32,支持多个存储媒介;有独立的缓冲区,可以对多个文件进行读/写,并特别对8位单片机和16位单片机做了优化。
=== 3.FATFS模块的层次结构图 ===
  * (1) 底层接口:
    * 包括存储媒介读/写接口(disk I/O)和供给文件创建修改时间的实时时钟,需要我们根据平台和存储介质编写移植代码。
  * (2) 中间层FATFS模块:
    * 实现了FAT 文件读/写协议。FATFS模块提供的是ff.c和ff.h,除有必要,使用者一般不用修改使用时将头文件直接包含进去即可。
  * (3) 最顶层是应用层:
    * 使用者无需理会FATFS的内部结构和复杂的FAT协议,只需要调用FATFS模块提供给用户的一系列应用接口函数,如f_open;f_read,f_write 和f_close等,就可以像在PC上读/写文件那样简单。
{{ :icore4t:icore4t_arm_hal_17_1.png?direct |}} 
=== 4.FATFS文件系统特点: ===
  * (1)Window兼容的FAT文件系统(支持FAT12/FAT16/FAT32)。
  * (2)代码量少、效率高。
  * (3)与平台无关、移植简单,全部通过C语言编写。
  * (4)多种配置选项:支持多卷(物理驱动器或分区,最多10个卷)、多个ANSI/OEM代码页、支持长文件名、支持RTOS、支持多种扇区大小等。
==== 四、 实验程序 ====
=== 1.主函数 ===
int main(void)  
{  
  int i,j;  
  static FRESULT res;  
  unsigned char write_buffer[512];      //写文件缓冲区
  unsigned char read_buffer[512];        //读文件缓冲区
  unsigned int counter;   
  /* 重置所有外围设备,初始化Flash接口和Systick */  
  HAL_Init();  
  SystemClock_Config();  
  
  i2c.initialize();  
  axp152.initialize();  
  axp152.set_dcdc1(3500);//[ARM & FPGA BK1/2/6 &OTHER]  
  axp152.set_dcdc2(1200);//[FPGA INT & PLL D]  
  axp152.set_aldo1(2500);//[FPGA PLL A]  
  axp152.set_dcdc4(3300);//[POWER_OUTPUT] 
    axp152.set_dcdc3(3300);//[FPGA BK4][Adjustable]  
    axp152.set_aldo2(3300);//[FPGA BK3][Adjustable]  
    axp152.set_dldo1(3300);//[FPGA BK7][Adjustable]  
    axp152.set_dldo2(3300);//[FPGA BK5][Adjustable]    
    /* 初始化所有已配置的外围设备 */  
    MX_GPIO_Init();  
    MX_USART2_UART_Init();  
    MX_SDMMC1_SD_Init();  
    MX_FATFS_Init();  
    usart2.initialize(115200);             //串口波特设置 
    usart2.printf("\x0c");                 //清屏
    usart2.printf("\033[1;32;40m");        //设置终端字体为绿色  
    usart2.printf("Hello,I am iCore4T!\r\n\r\n");//´串口信息输出
    //判断f_mount是否成功 
    HAL_Delay(500);  
    res = f_mount(&fatfs,"0:",1);  
    if(res != RES_OK){  
        usart2.printf("f_mount error!\r\n");  
        while(1){  
            LED_ON;  
            HAL_Delay(500);  
            LED_OFF;  
            HAL_Delay(500);           
        }  
    }else{  
        usart2.printf("f_mount successful!\r\n");  
    }  
    //打开源文件
res = f_open(&file,"0:/SD卡测试.txt",FA_READ | FA_WRITE | FA_OPEN_
ALWAYS);//打开驱动器0上的源文件
   if(res != RES_OK){  
        usart2.printf("f_open error!\r\n");  
        while(1){  
            HAL_Delay(500);  
            LED_ON;  
            HAL_Delay(500);  
            LED_OFF;  
        }         
    }else{  
        usart2.printf("f_open successful!\r\n");  
    }  
    //移动写指针到文件首
    res = f_lseek(&file,0);                                              
    if(res != RES_OK){  
        usart2.printf("f_lseek error!\r\n");  
        while(1){  
            HAL_Delay(500);  
            LED_ON;  
            HAL_Delay(500);  
            LED_OFF;  
        }                 
    }else{  
        usart2.printf("f_lseek successful!\r\n");  
    }  
    for(i = 0;i < 512;i++){  
        write_buffer[i] = i % 256;  
    }     
    //向文件写数据
    res = f_write(&file,write_buffer,512,&counter);                           //将缓冲器中的内容写入源文件
    if(res != RES_OK || counter != 512){  
        usart2.printf("f_write error!\r\n");  
        while(1){  
            HAL_Delay(500);  
            LED_ON;  
            HAL_Delay(500);  
            LED_OFF;  
        }     
    }else{  
        usart2.printf("f_write successful!\r\n");     
    }     
    //移动读指针到文件首
    res = f_lseek(&file,0);                                              
    if(res != RES_OK){  
        usart2.printf("f_lseek error!\r\n");  
        while(1){  
            HAL_Delay(500);  
            LED_ON;  
            HAL_Delay(500);  
            LED_OFF;  
        }                 
    }else{  
        usart2.printf("f_lseek successful!\r\n");  
    }  
    //读文件数据
    res = f_read(&file,read_buffer,512,&counter);  
    if(res != RES_OK || counter != 512){  
        usart2.printf("f_read error!\r\n");  
        while(1){  
            HAL_Delay(500);  
            LED_ON;  
            HAL_Delay(500);  
            LED_OFF;  
        }     
    }else{  
        usart2.printf("f_read successful!\r\n");  
    }  
    f_close(&file);   
    //打印读取到的数据
    usart2.printf("read data:\r\n");  
    for(i = 0;i < 32;i++){  
        for(j = 0; j < 16; j ++)  
            usart2.printf(" %02X",read_buffer[i*16+j]);  
        usart2.printf("\r\n");  
    }         
    LED_ON;  
  while (1)  
  {  
  }  
} 
=== 2.FATFS函数介绍 ===
FRESULT f_mount (       //挂载/卸载逻辑驱动器
FATFS* fs,		/* 指向文件系统对象的指针*/
const TCHAR* path,	/* 要安装/卸载的逻辑驱动器号 */
BYTE opt	        /* 模式选项0:不安装(延迟安装),1:立即安装*/
)
FRESULT f_open (           //打开或创建文件
	FIL* fp,	   /* 指向空白文件对象的指针 */
	const TCHAR* path, /* 指向文件名的指针 */
	BYTE mode	   /* 访问模式和文件打开模式标志 */
)
FRESULT f_read (           //读文件
	FIL* fp, 	   /* 指向文件对象的指针 */
	void* buff,	   /* 指向数据缓冲区的指针 */
	UINT btr,	   /* 读取的字节数 */
	UINT* br	   /* 指向读取的字节数的指针 */
)
FRESULT f_write (          //写文件
	FIL* fp,	   /* 指向文件对象的指针 */
	const void* buff,  /* 指向要写入的数据的指针 */
	UINT btw,	   /* 要写入的字节数 */
	UINT* bw	   /* 指向写入字节数的指针 */
)
FRESULT f_sync (           //冲洗一个写文件的缓存信息
	FIL* fp		   /* 指向文件对象的指针 */
)
FRESULT f_close (          //关闭一个文件
	FIL* fp		   /* 指向要关闭的文件对象的指针 */
)
FRESULT f_lseek (          //移动文件读/写指针
	FIL* fp,	   /* 指向文件对象的指针 */
	FSIZE_t ofs	   /* 指向文件头的指针 */
)
FRESULT f_opendir (        //创建目录对象
	DIR* dp,	   /* 指向要创建的目录对象的指针 */
	const TCHAR* path  /* 指向目录路径的指针 */
)
FRESULT f_closedir (       //  关闭目录
	DIR *dp		   /* 指向要关闭的目录对象的指针 */
)
FRESULT f_readdir (        //顺序读取目录条目
	DIR* dp,	   /* 指向打开目录对象的指针 */
	FILINFO* fno	   /* 指向要返回的文件信息的指针 */
)
FRESULT f_stat (           //获取文件状态
	const TCHAR* path, /* 指向文件路径的指针 */
	FILINFO* fno	   /* 指向要返回的文件信息的指针 */
)
FRESULT f_getfree (        //获取空闲簇数
	const TCHAR* path, /* 逻辑驱动器号的路径名 */
	DWORD* nclst,	   /* 指向变量的指针以返回空闲簇的数量*/
	FATFS** fatfs	   /* 返回指向相应文件系统对象的指针的指针 */
)
FRESULT f_truncate (       //截断文件
	FIL* fp		   /* 指向文件对象的指针 */
)
FRESULT f_unlink (         //删除一个文件或目录
	const TCHAR* path  /* 指向文件或目录路径的指针 */
)
FRESULT f_mkdir (          //创建一个目录
	const TCHAR* path  /* 指向目录路径的指针 */
)
FRESULT f_rename (         //重命名文件/目录
	const TCHAR* path_old,   /* 指向要重命名的对象名称的指针 */
	const TCHAR* path_new	 /* 指向新名称的指针 */
)
	
==== 五、实验步骤 ====
  - 把仿真器与iCore4T的SWD调试口相连(直接相连或者通过转接器相连);
  - 把iCore4T通过Micro USB线与计算机相连,为iCore4T供电;
  - 打开PuTTY串口终端;
  - 打开Keil MDK 开发环境,并打开本实验工程;
  - 烧写程序到iCore4T上;
  - 也可以进入Debug 模式,单步运行或设置断点验证程序逻辑。
==== 六、实验现象 ====
{{ :icore4t:icore4t_arm_hal_17_2.png?direct |}}