LVGL官方文档-7.11.0-17-Overview-File system

LVGL有个“File System”的抽象模块，使得其支持各种类型的文件系统。File System是用一个驱动的字母来标记的。例如，如果SD卡是与字母“S”相关联，那么其上的文件路径就是“S:path/to/file.txt”。

Add a driver

要添加一个驱动，需要初始化一个lv_fs_drv_t类型的变量：

lv_fs_drv_t drv;
lv_fs_drv_init(&drv);                     /*Basic initialization*/

drv.letter = 'S';                         /*An uppercase letter to identify the drive */
drv.file_size = sizeof(my_file_object);   /*Size required to store a file object*/
drv.rddir_size = sizeof(my_dir_object);   /*Size required to store a directory object (used by dir_open/close/read)*/
drv.ready_cb = my_ready_cb;               /*Callback to tell if the drive is ready to use */
drv.open_cb = my_open_cb;                 /*Callback to open a file */
drv.close_cb = my_close_cb;               /*Callback to close a file */
drv.read_cb = my_read_cb;                 /*Callback to read a file */
drv.write_cb = my_write_cb;               /*Callback to write a file */
drv.seek_cb = my_seek_cb;                 /*Callback to seek in a file (Move cursor) */
drv.tell_cb = my_tell_cb;                 /*Callback to tell the cursor position  */
drv.trunc_cb = my_trunc_cb;               /*Callback to delete a file */
drv.size_cb = my_size_cb;                 /*Callback to tell a file's size */
drv.rename_cb = my_rename_cb;             /*Callback to rename a file */


drv.dir_open_cb = my_dir_open_cb;         /*Callback to open directory to read its content */
drv.dir_read_cb = my_dir_read_cb;         /*Callback to read a directory's content */
drv.dir_close_cb = my_dir_close_cb;       /*Callback to close a directory */

drv.free_space_cb = my_free_space_cb;     /*Callback to tell free space on the drive */

drv.user_data = my_user_data;             /*Any custom data if required*/

lv_fs_drv_register(&drv);                 /*Finally register the drive*/

任何一个回调都可以设置为NULL，表示这个操作不支持。

可以像下面这样使用这些回调：

lv_fs_open(&file, "S:/folder/file.txt", LV_FS_MODE_WR)

在LVGL中，会有如下的过程：

1. 找到与字母“S”关联的驱动。
2. 检查open_cb是否已经实现（非空）。
3. 用“folder/file.txt”这个路径调用open_cb。

Usage example

下面是一个读文件的示例：

lv_fs_file_t f;
lv_fs_res_t res;
res = lv_fs_open(&f, "S:folder/file.txt", LV_FS_MODE_RD);
if(res != LV_FS_RES_OK) my_error_handling();

uint32_t read_num;
uint8_t buf[8];
res = lv_fs_read(&f, buf, 8, &read_num);
if(res != LV_FS_RES_OK || read_num != 8) my_error_handling();

lv_fs_close(&f);

lv_fs_open中的模式可以是LV_FS_MODE_WR表示以只写模式打开，也可以是LV_FS_MODE_RD|LV_FS_MODE_WR表示以读写模式打开。

下面的例子显示了如何读取目录的内容。怎么标记目录是由驱动决定的，但是推荐在路径的前面增加一个“/”表示这是一个目录。

lv_fs_dir_t dir;
lv_fs_res_t res;
res = lv_fs_dir_open(&dir, "S:/folder");
if(res != LV_FS_RES_OK) my_error_handling();

char fn[256];
while(1) {
    res = lv_fs_dir_read(&dir, fn);
    if(res != LV_FS_RES_OK) {
        my_error_handling();
        break;
    }

    /*fn is empty, if not more files to read*/
    if(strlen(fn) == 0) {
        break;
    }

    printf("%s\n", fn);
}

lv_fs_dir_close(&dir);

Use drivers for images

除了可以以变量的形式存储在flash中以外，图像也可以从文件打开。

为了初始化图像，需要实现下面的这些回调：

• open
• close
• read
• seek
• tell