FileX移植及简单分析

一、写在开头

FIleX的移植比较简单，只需要实现Azure RTOS FileX 文档中第五章的“FileX的I/O驱动程序”即可。
对于初次接触FAT文件系统的同学，建议了解下MBR、DPT和DBR，对于理解FileX的移植原理很有帮助。可参考下面两篇文章：

https://blog.csdn.net/guanyasu/article/details/52695086?spm=1001.2014.3001.5501
https://blog.csdn.net/guanyasu/article/details/52739695

二、平台介绍

硬件平台：STM32L475VET6；
ThreadX版本：6.1.3；
FileX版本：6.1.3；
基础工程：实现SD卡扇区的读和写功能（SPI接口/SDIO接口均可）

三、移植

1、首先移植ThreadX系统，ThreadX的移植可参考上一篇文章

2、复制FileX/common和FileX/ports/cortex_m4/gun（没有ac5版本，只有gun）到基础工程

3、在基础工程中添加FileX文件以及头文件路径

4、编写FileX的I/O驱动程序
FileX的I/O驱动程序只需要实现下面5个case即可：
FX_DRIVER_INIT：初始化
FX_DRIVER_READ：读扇区
FX_DRIVER_WRITE：写扇区
FX_DRIVER_BOOT_READ：读boot区
FX_DRIVER_BOOT_WRITE：写boot区
读操作：调用基础工程中的SD卡的读扇区函数
写操作：调用基础工程中的SD卡的写扇区函数

这里简单介绍下SD的空间分配：
①SD卡的0扇区是MBR+DPT，后面跟n个保留扇区
②接下来是DBR扇区（也就是FileX中的BOOT区），后面跟m个保留扇区
③再接下来是文件分配表，占x扇区
④文件分配表后面就是用户数据区了

再简单介绍下FileX的启动过程：
①首先发出初始化请求，完成SD卡初始化
②然后读BOOT扇区，用于设置结构体FX_MEDIA中的成员
③之后用户数据的读写，即FX_DRIVER_READ和FX_DRIVER_WRITE
其中最重要的是第二步，第二步的关键是找到BOOT区（DBR扇区）地址。其方法为首先读取0扇区获取DPT，DPT的8~12字节即为DBR扇区地址。FileX提供了一个函数，可以从0扇区的内容中分离出DBR地址。

UINT _fx_partition_offset_calculate(void *partition_sector, UINT partition, ULONG *partition_start, ULONG *partition_size)；

下面提供一个示例驱动：

UINT  _fx_partition_offset_calculate(void  *partition_sector, UINT partition, ULONG *partition_start, ULONG *partition_size);
		
VOID  _fx_sd_spi_driver(FX_MEDIA *media_ptr)
{
	ULONG       partition_start;
	ULONG       partition_size;
	
	switch(media_ptr->fx_media_driver_request)
	{
		case FX_DRIVER_INIT:
		{
			SD_Init();
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}
		
		case FX_DRIVER_UNINIT:
		{
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}
		
		case FX_DRIVER_READ:
		{
			SD_ReadDisk((uint8_t*)media_ptr->fx_media_driver_buffer, media_ptr->fx_media_driver_logical_sector + media_ptr->fx_media_hidden_sectors, media_ptr->fx_media_driver_sectors);
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}
		
		case FX_DRIVER_WRITE:
		{
			SD_WriteDisk((uint8_t*)media_ptr->fx_media_driver_buffer, media_ptr->fx_media_driver_logical_sector + media_ptr->fx_media_hidden_sectors, media_ptr->fx_media_driver_sectors);
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}
		
		case FX_DRIVER_FLUSH:
		{
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}

		case FX_DRIVER_ABORT:
		{
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}
		
		case FX_DRIVER_BOOT_READ:
		{
			SD_ReadDisk((uint8_t*)media_ptr->fx_media_driver_buffer, 0, 1);		//读0扇区，获得MBR+DPT数据
			_fx_partition_offset_calculate(media_ptr -> fx_media_driver_buffer, 0,\
			 &partition_start, &partition_size);		//从0扇区数据中获得boot区地址和大小
			SD_ReadDisk((uint8_t*)media_ptr->fx_media_driver_buffer, partition_start, 1);		//读boot区
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}
		
		case FX_DRIVER_BOOT_WRITE:
		{
			SD_WriteDisk((uint8_t*)media_ptr->fx_media_driver_buffer, partition_start, 1);
			media_ptr->fx_media_driver_status =  FX_SUCCESS;
			break;
		}
		
		default:
		{
			media_ptr->fx_media_driver_status =  FX_IO_ERROR;
			break;
		}
	}
}

5、编写FileX应用程序测试。
下面提供一个简单的测试程序，将测试程序添加到ThreadX的任务中即可。

FX_MEDIA     sdio_disk; 
FX_FILE      fx_file;
uint32_t media_memory[1*1024];
char FsWriteBuf[1024] = {"1234567890\r\n"};

void you_thread_entry(ULONG thread_input)
{
	int status = 0;
	fx_system_initialize();
	status =  fx_media_open(&sdio_disk, "STM32_SDIO_DISK", _fx_sd_spi_driver, 0, media_memory, sizeof(media_memory));
	status =  fx_file_create(&sdio_disk, "armfly.txt");
	status =  fx_file_open(&sdio_disk, &fx_file, "armfly.txt", FX_OPEN_FOR_WRITE);
	status =  fx_file_write(&fx_file, FsWriteBuf, strlen(FsWriteBuf));
	status =  fx_file_close(&fx_file);
	status =  fx_media_flush(&sdio_disk);
	while(1)
	{
		tx_thread_sleep(1);
	}
}

记录一下踩过的坑

1、SD卡的前n个扇区为MBR扇区+（n-1）个保留扇区，紧接着才是DBR扇区+m个保留扇区。BOOT区就是DBR扇区，其不在SD卡的0扇区。
2、逻辑扇区media_ptr->fx_media_driver_logical_sector提供的是相对地址，相对于DBR扇区的地址。在读写SD卡物理扇区时，必须加上隐藏扇区大小。