一、写在开头
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卡物理扇区时,必须加上隐藏扇区大小。