起因

在做LVGL项目的时候,经常是以自定义UI的方式做的,这时候图片会占用很多资源。一张 800x480、16 位色的全屏图就接近 750KB,图标、按钮各种状态图加起来轻松超过片内 Flash;而且图片以 C 数组编进固件,每换一张图都要重新编译烧录。所以必须将图片转换成bin文件存放到外部存储器上,比如SD卡或者Flash存储芯片。

需求

  • PC 模拟器(Code::Blocks + Win32)里用 lv_img 直接显示 bin 图片文件
  • 同一套 UI 代码,到嵌入式上换成本地文件系统(FatFS + SD/SPI Flash)时不用大改
  • 外部字体同样以 bin 存放,按需读取

技术实现原理

LVGL 文件系统是一层回调抽象

LVGL 内核不认识 stdio、也不认识 FatFS,它只认 lv_fs_drv_t 里注册的一组回调(open/read/write/seek/tell/close)。路径的首字符是盘符——"S:xxx" 里的 S 就是注册时填的 letter,LVGL 靠它把请求路由到对应驱动。因果链是:控件要图片数据 → lv_img 通过 lv_fs 按盘符找到驱动 → 驱动回调里你自己决定数据从哪来。所以 PC 上回调用 fopen/fread 实现,嵌入式上换成 f_open/f_read(FatFS),上层 UI 代码一行不用改——这就是分层的意义,也是官方把 porting 层单独拆出来的原因。

为什么图片要转成 bin

转换工具把图片像素按目标色彩格式(要和 lv_conf.h 的 LV_COLOR_DEPTH 匹配)重排,加上 LVGL 认识的文件头,输出成 bin。运行时 lv_img_set_src 指到 "S:..." 路径,LVGL 先从头里读出宽高、格式,再按需到文件里取像素数据(配合 LV_IMG_CACHE_DEF_SIZE 还能缓存已解码的图)。字体 bin 同理:字模数据放文件里,__user_font_getdata 回调负责“给个偏移和长度,返回那段数据”。

先上效果图

具体操作

1.注册lvgl文件系统

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
void init_fs_config(void)
{
    static lv_fs_drv_t pcfs_drv;                         /*A driver descriptor*/
    lv_fs_drv_init(&pcfs_drv);
    pcfs_drv.user_data = NULL;
    pcfs_drv.letter = 'S';
    pcfs_drv.ready_cb = pcfs_ready;
    pcfs_drv.write_cb = pcfs_write;
    pcfs_drv.open_cb = pcfs_open;
    pcfs_drv.close_cb = pcfs_close;
    pcfs_drv.read_cb = pcfs_read;
    pcfs_drv.seek_cb = pcfs_seek;
    pcfs_drv.tell_cb = pcfs_tell;
    lv_fs_drv_register(&pcfs_drv);
}

2.定义文件操作函数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
//文件系统是否准备好被回调函数pcfs_ready
bool pcfs_ready(lv_fs_drv_t* drv)
{
    (void)drv; /*Unused*/
    return true;  //这里仅返回true,如果是嵌入式,则是返回嵌入式文件系统挂载成功与否的标志
}
//打开文件被回调的函数pcfs_open
static void* pcfs_open(lv_fs_drv_t* drv, const char* fn, lv_fs_mode_t mode)
{
    (void)drv; /*Unused*/

    errno = 0;

    const char* flags = "";

    if (mode == LV_FS_MODE_WR) flags = "wb";
    else if (mode == LV_FS_MODE_RD) flags = "rb";
    else if (mode == (LV_FS_MODE_WR | LV_FS_MODE_RD)) flags = "a+";

    /*Make the path relative to the current directory (the projects root folder)*/
    char buf[256];
    sprintf(buf, "./%s", fn);

    return fopen(buf, flags);  
}
//写入文件被回调的函数pcfs_write
static lv_fs_res_t pcfs_write(struct _lv_fs_drv_t* drv, void* file_p, const void* buf, uint32_t btw, uint32_t* bw)
{
    (void)drv; /*Unused*/

    *bw = (uint32_t)fwrite(buf, 1, btw, file_p);

    return LV_FS_RES_OK;
}
//读取文件被回调的函数pcfs_read
static lv_fs_res_t pcfs_read(lv_fs_drv_t* drv, void* file_p, void* buf, uint32_t btr, uint32_t* br)
{
    (void)drv; /*Unused*/
    
    //pc_file_t* fp = file_p;        /*Just avoid the confusing casings*/
    *br = (uint32_t)fread(buf, 1, btr, file_p);
    return LV_FS_RES_OK;
}
//关闭文件被回调的函数pcfs_close
static lv_fs_res_t pcfs_close(lv_fs_drv_t* drv, void* file_p)
{
    (void)drv; /*Unused*/

    return fclose(file_p);
}
//移动文件位置被回调的函数pcfs_seek
static lv_fs_res_t pcfs_seek(lv_fs_drv_t* drv, void* file_p, uint32_t pos,lv_fs_whence_t whence)
{
    (void)drv; /*Unused*/

    return fseek(file_p, pos, whence);
}
//获取文件位置被回调的函数pcfs_tell
static lv_fs_res_t pcfs_tell(lv_fs_drv_t* drv, void* file_p, uint32_t* pos_p)
{
    (void)drv; /*Unused*/
    *pos_p = ftell(file_p);
    return LV_FS_RES_OK;
}
//初时化调用init_fs_config函数
init_fs_config();

3.将图片转换成bin文件

转换工具使用的是

  • Lvgl_image_convert_tool

  • LvglFontTool_V0.4

这种离线工具,比官网的在线方式好用很多。 工具直接百度搜下,很多的。

转换图片时注意输出格式要与 lv_conf.h 的 LV_COLOR_DEPTH 一致,色深选错模拟器上不一定报错,但显示颜色会整体不对;LvglFontTool 生成 bin 的同时还会生成一个声明字体对象(如 _myFont)的 C 文件,两个要配套加入工程。

4.调用bin格式的图片

将转换后的bin文件存放到项目目录下(注意,只有放到根目录下才能读取的到,我项目用的是codeblocks的IDE)。原因在 pcfs_open 的实现里:它用 sprintf(buf, "./%s", fn) 把路径拼成相对路径,./ 指向进程的当前工作目录——Code::Blocks 运行时默认把工作目录设为项目根,所以 bin 要放在项目根下,子目录用相对路径写(如示例代码里的 images/btn/…)。

加载外部图片

调用代码:

1
2
3
4

	lv_obj_t* obj = lv_img_create(lv_scr_act());
    lv_img_set_src(obj,"S:images/btn/btn_mode_manual_p.bin");
    lv_obj_center(obj);

例如,我项目中用到的某个按钮,图片存放到SD卡上,调用方式如下:

加载外部字体需要匹配读取数据函数

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
	static uint8_t __g_font_buf[364];//如bin文件存在SPI FLASH可使用此buff
	static uint8_t *__user_font_getdata(int offset, int size){
    //如字模保存在SPI FLASH, SPIFLASH_Read(__g_font_buf,offset,size);
    //如字模已加载到SDRAM,直接返回偏移地址即可如:return (uint8_t*)(sdram_fontddr+offset);
    lv_fs_file_t file;
    lv_fs_res_t result;
    result = lv_fs_open(&file, "S:/myFont.bin", LV_FS_MODE_RD);
    if (result != LV_FS_RES_OK)
        return NULL;

    lv_fs_seek(&file, offset, LV_FS_SEEK_CUR);
    uint32_t len;
    lv_fs_read(&file, __g_font_buf, size, &len);
    lv_fs_close(&file);
    return __g_font_buf;
}

使用外部字显示

1
2
3
4
5
6
7
8
	lv_obj_t* obj = lv_btn_create(lv_scr_act());
    lv_obj_set_size(obj, 300, 300);
    lv_obj_center(obj);

    lv_obj_t* label = lv_label_create(obj);
    lv_obj_set_style_text_font(label, &_myFont, 0);
    lv_label_set_text(label, "外部字体测试");
    lv_obj_center(label);

完整代码

下面是完整的代码

lv_port_fs.h

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
/**
 * @file lv_port_fs.h
 *
 */

 /*Copy this file as "lv_port_fs.h" and set this value to "1" to enable content*/
#if 1

#ifndef LV_PORT_FS_H
#define LV_PORT_FS_H

#ifdef __cplusplus
extern "C" {
#endif

/*********************
 *      INCLUDES
 *********************/
#include "../lvgl/lvgl.h"

/*********************
 *      DEFINES
 *********************/
//使用PC文件系统
#define USE_PC_FILE_SYSTEM 1
//使用FATFS文件系统
#define USE_FATFS_FILE_SYSTEM 0
/**********************
 *      TYPEDEFS
 **********************/

/**********************
 * GLOBAL PROTOTYPES
 **********************/

/**********************
 *      MACROS
 **********************/

#ifdef __cplusplus
} /*extern "C"*/
#endif

#endif /*LV_PORT_FS_H*/

#endif /*Disable/Enable content*/

lv_port_fs.c

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
/**
 * @file lv_port_fs.c
 *
 */

/*Copy this file as "lv_port_fs.c" and set this value to "1" to enable content*/
#if 1

/*********************
 *      INCLUDES
 *********************/
#include "lv_port_fs.h"
#if USE_FATFS_FILE_SYSTEM==1
#include "fatfs/ff.h"
#endif
#include "../lvgl/lvgl.h"
#include "stdio.h"

/*********************
 *      DEFINES
 *********************/

/**********************
 *      TYPEDEFS
 **********************/

/**********************
 *  STATIC PROTOTYPES
 **********************/
static void fs_init(void);
#if USE_PC_FILE_SYSTEM==1
static lv_fs_res_t fs_open(lv_fs_drv_t *drv, void *file_p, const char *path,
		lv_fs_mode_t mode);
static lv_fs_res_t fs_close(lv_fs_drv_t *drv, void *file_p);
static lv_fs_res_t fs_read(lv_fs_drv_t *drv, void *file_p, void *buf,
		uint32_t btr, uint32_t *br);
static lv_fs_res_t fs_write(lv_fs_drv_t *drv, void *file_p, const void *buf,
		uint32_t btw, uint32_t *bw);
static lv_fs_res_t fs_seek(lv_fs_drv_t *drv, void *file_p, uint32_t pos,
		lv_fs_whence_t whence);
static lv_fs_res_t fs_size(lv_fs_drv_t *drv, void *file_p, uint32_t *size_p);
static lv_fs_res_t fs_tell(lv_fs_drv_t *drv, void *file_p, uint32_t *pos_p);

static void* fs_dir_open(lv_fs_drv_t *drv, void *rddir_p, const char *path);
static lv_fs_res_t fs_dir_read(lv_fs_drv_t *drv, void *rddir_p, char *fn);
static lv_fs_res_t fs_dir_close(lv_fs_drv_t *drv, void *rddir_p);
#endif
/**********************
 *  STATIC VARIABLES
 **********************/

/**********************
 * GLOBAL PROTOTYPES
 **********************/

/**********************
 *      MACROS
 **********************/

/**********************
 *   GLOBAL FUNCTIONS
 **********************/
#if USE_PC_FILE_SYSTEM==1
bool pcfs_ready(lv_fs_drv_t *drv);
static void* pcfs_open(lv_fs_drv_t *drv, const char *fn, lv_fs_mode_t mode);
static lv_fs_res_t pcfs_write(struct _lv_fs_drv_t *drv, void *file_p,
		const void *buf, uint32_t btw, uint32_t *bw);
static lv_fs_res_t pcfs_read(lv_fs_drv_t *drv, void *file_p, void *buf,
		uint32_t btr, uint32_t *br);
static lv_fs_res_t pcfs_close(lv_fs_drv_t *drv, void *file_p);
static lv_fs_res_t pcfs_seek(lv_fs_drv_t *drv, void *file_p, uint32_t pos,
		lv_fs_whence_t whence);
static lv_fs_res_t pcfs_tell(lv_fs_drv_t *drv, void *file_p, uint32_t *pos_p);
#endif
void lv_port_fs_init(void) {
	/*----------------------------------------------------
	 * Initialize your storage device and File System
	 * -------------------------------------------------*/
	fs_init();

	/*---------------------------------------------------
	 * Register the file system interface in LVGL
	 *--------------------------------------------------*/
#if USE_FATFS_FILE_SYSTEM==1
    /*Add a simple drive to open images*/
    static lv_fs_drv_t fs_drv;
    lv_fs_drv_init(&fs_drv);

    /*Set up fields...*/
    fs_drv.letter = 'S';
    fs_drv.open_cb = fs_open;
    fs_drv.close_cb = fs_close;
    fs_drv.read_cb = fs_read;
    fs_drv.write_cb = fs_write;
    fs_drv.seek_cb = fs_seek;
    fs_drv.tell_cb = fs_tell;

    fs_drv.dir_close_cb = fs_dir_close;
    fs_drv.dir_open_cb = fs_dir_open;
    fs_drv.dir_read_cb = fs_dir_read;

    lv_fs_drv_register(&fs_drv);
#endif

#if USE_PC_FILE_SYSTEM==1
	static lv_fs_drv_t pcfs_drv; /*A driver descriptor*/
	lv_fs_drv_init(&pcfs_drv);
	pcfs_drv.user_data = NULL;
	pcfs_drv.letter = 'S';
	pcfs_drv.ready_cb = pcfs_ready;
	pcfs_drv.write_cb = pcfs_write;
	pcfs_drv.open_cb = pcfs_open;
	pcfs_drv.close_cb = pcfs_close;
	pcfs_drv.read_cb = pcfs_read;
	pcfs_drv.seek_cb = pcfs_seek;
	pcfs_drv.tell_cb = pcfs_tell;
	lv_fs_drv_register(&pcfs_drv);
#endif
}

/**********************
 *   STATIC FUNCTIONS
 **********************/

/*Initialize your Storage device and File system.*/
static void fs_init(void) {
	/*E.g. for FatFS initialize the SD card and FatFS itself*/
#if USE_FATFS_FILE_SYSTEM==1
    sfc_init();
    #endif
	/*You code here*/
}

#if USE_PC_FILE_SYSTEM==1
//文件系统是否准备好被回调函数pcfs_ready
bool pcfs_ready(lv_fs_drv_t *drv) {
	(void) drv; /*Unused*/
	return true;  //这里仅返回true,如果是嵌入式,则是返回嵌入式文件系统挂载成功与否的标志
}
//打开文件被回调的函数pcfs_open
static void* pcfs_open(lv_fs_drv_t *drv, const char *fn, lv_fs_mode_t mode) {
	(void) drv; /*Unused*/

	errno = 0;

	const char *flags = "";

	if (mode == LV_FS_MODE_WR)
		flags = "wb";
	else if (mode == LV_FS_MODE_RD)
		flags = "rb";
	else if (mode == (LV_FS_MODE_WR | LV_FS_MODE_RD))
		flags = "a+";

	/*Make the path relative to the current directory (the projects root folder)*/
	char buf[256];
	sprintf(buf, "./%s", fn);

	return fopen(buf, flags);
}
//写入文件被回调的函数pcfs_write
static lv_fs_res_t pcfs_write(struct _lv_fs_drv_t *drv, void *file_p,
		const void *buf, uint32_t btw, uint32_t *bw) {
	(void) drv; /*Unused*/

	*bw = (uint32_t) fwrite(buf, 1, btw, file_p);

	return LV_FS_RES_OK;
}
//读取文件被回调的函数pcfs_read
static lv_fs_res_t pcfs_read(lv_fs_drv_t *drv, void *file_p, void *buf,
		uint32_t btr, uint32_t *br) {
	(void) drv; /*Unused*/

	//pc_file_t* fp = file_p;        /*Just avoid the confusing casings*/
	*br = (uint32_t) fread(buf, 1, btr, file_p);
	return LV_FS_RES_OK;
}
//关闭文件被回调的函数pcfs_close
static lv_fs_res_t pcfs_close(lv_fs_drv_t *drv, void *file_p) {
	(void) drv; /*Unused*/

	return fclose(file_p);
}
//移动文件位置被回调的函数pcfs_seek
static lv_fs_res_t pcfs_seek(lv_fs_drv_t *drv, void *file_p, uint32_t pos,
		lv_fs_whence_t whence) {
	(void) drv; /*Unused*/

	return fseek(file_p, pos, whence);
}
//获取文件位置被回调的函数pcfs_tell
static lv_fs_res_t pcfs_tell(lv_fs_drv_t *drv, void *file_p, uint32_t *pos_p) {
	(void) drv; /*Unused*/
	*pos_p = ftell(file_p);
	return LV_FS_RES_OK;
}
#endif

#if USE_FATFS_FILE_SYSTEM==1

/**
 * Open a file
 * @param drv       pointer to a driver where this function belongs
 * @param path      path to the file beginning with the driver letter (e.g. S:/folder/file.txt)
 * @param mode      read: FS_MODE_RD, write: FS_MODE_WR, both: FS_MODE_RD | FS_MODE_WR
 * @return          a file descriptor or NULL on error
 */
static lv_fs_res_t fs_open(lv_fs_drv_t *drv, void *file_p, const char *path,
                           lv_fs_mode_t mode)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /************************************************
     * 在这里,我们需要先进行设备的判断,因为我们实际上
     * 可能不只有一个设备,而且LVGL里使用letter(即单个字符)
     * 作为驱动号
     * 而在FatFS里使用VOLUME_STR(字符串)或者一个字节的pdrv
     * 驱动号,使用前要进行转换。
     *
     * 有一种方便的方法,就是上面提到的user_data,我们可以把
     * VOLUME_STR提前装入user_data,那我们的程序进行判断时
     * 耦合度会更低,在更多设备时,这种方法会更方便
     *************************************************/

    char *path_buf = NULL;
    uint8_t opt_mode = 0;
    uint16_t path_len = strlen(path);

    // 根据传入的letter判断是什么存储设备
    switch (drv->letter)
    {
    case 'S':       // SD card
        path_buf = (char*) lv_mem_alloc(sizeof(char) * (path_len + 4));
        sprintf(path_buf, "SD:/%s", path);
        break;
    case 'F':       // SPI FALSH
        path_buf = (char*) lv_mem_alloc(sizeof(char) * (path_len + 6));
        sprintf(path_buf, "SPIF:/%s", path);
        break;
    default:
        printf("No drive %c\n", drv->letter);
        return LV_FS_RES_NOT_EX;
    }

    /* 文件操作方法,将FatFS的转换成LVGL的操作方法 */
    if (mode == LV_FS_MODE_WR)
    {
        opt_mode = FA_OPEN_ALWAYS | FA_WRITE;
    }
    else if (mode == LV_FS_MODE_RD)
    {
        opt_mode = FA_OPEN_EXISTING | FA_READ;
    }
    else if (mode == (LV_FS_MODE_WR | LV_FS_MODE_RD))
    {
        opt_mode = FA_WRITE | FA_READ;
    }

    /* 调用FatFs的函数 */
    FRESULT fres = f_open((FIL*) file_p, path_buf, opt_mode);
    if (fres != FR_OK)
    {
        printf("f_open error (%d)\n", fres);
        res = LV_FS_RES_NOT_IMP;
    }
    else
        res = LV_FS_RES_OK;

    lv_mem_free(path_buf);

    return res;
}

/**
 * Close an opened file
 * @param drv       pointer to a driver where this function belongs
 * @param file_p    pointer to a file_t variable. (opened with lv_ufs_open)
 * @return          LV_FS_RES_OK: no error or  any error from @lv_fs_res_t enum
 */
static lv_fs_res_t fs_close(lv_fs_drv_t *drv, void *file_p)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /*Add your code here*/

    return res;
}

/**
 * Read data from an opened file
 * @param drv       pointer to a driver where this function belongs
 * @param file_p    pointer to a file_t variable.
 * @param buf       pointer to a memory block where to store the read data
 * @param btr       number of Bytes To Read
 * @param br        the real number of read bytes (Byte Read)
 * @return          LV_FS_RES_OK: no error or  any error from @lv_fs_res_t enum
 */
static lv_fs_res_t fs_read(lv_fs_drv_t *drv, void *file_p, void *buf,
                           uint32_t btr, uint32_t *br)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /*Add your code here*/

    return res;
}

/**
 * Write into a file
 * @param drv       pointer to a driver where this function belongs
 * @param file_p    pointer to a file_t variable
 * @param buf       pointer to a buffer with the bytes to write
 * @param btr       Bytes To Write
 * @param br        the number of real written bytes (Bytes Written). NULL if unused.
 * @return          LV_FS_RES_OK: no error or  any error from @lv_fs_res_t enum
 */
static lv_fs_res_t fs_write(lv_fs_drv_t *drv, void *file_p, const void *buf,
                            uint32_t btw, uint32_t *bw)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /*Add your code here*/

    return res;
}

/**
 * Set the read write pointer. Also expand the file size if necessary.
 * @param drv       pointer to a driver where this function belongs
 * @param file_p    pointer to a file_t variable. (opened with lv_ufs_open )
 * @param pos       the new position of read write pointer
 * @param whence    tells from where to interpret the `pos`. See @lv_fs_whence_t
 * @return          LV_FS_RES_OK: no error or  any error from @lv_fs_res_t enum
 */
static lv_fs_res_t fs_seek(lv_fs_drv_t *drv, void *file_p, uint32_t pos,
                           lv_fs_whence_t whence)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /*Add your code here*/

    return res;
}
/**
 * Give the position of the read write pointer
 * @param drv       pointer to a driver where this function belongs
 * @param file_p    pointer to a file_t variable.
 * @param pos_p     pointer to to store the result
 * @return          LV_FS_RES_OK: no error or  any error from @lv_fs_res_t enum
 */
static lv_fs_res_t fs_tell(lv_fs_drv_t *drv, void *file_p, uint32_t *pos_p)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /*Add your code here*/

    return res;
}

/**
 * Initialize a 'lv_fs_dir_t' variable for directory reading
 * @param drv       pointer to a driver where this function belongs
 * @param path      path to a directory
 * @return          pointer to the directory read descriptor or NULL on error
 */
static void* fs_dir_open(lv_fs_drv_t *drv, void *rddir_p, const char *path)
{
    lv_fs_res_t dir = NULL;
    /*Add your code here*/
    //dir = ...           /*Add your code here*/
    return dir;
}

/**
 * Read the next filename form a directory.
 * The name of the directories will begin with '/'
 * @param drv       pointer to a driver where this function belongs
 * @param rddir_p   pointer to an initialized 'lv_fs_dir_t' variable
 * @param fn        pointer to a buffer to store the filename
 * @return          LV_FS_RES_OK: no error or  any error from @lv_fs_res_t enum
 */
static lv_fs_res_t fs_dir_read(lv_fs_drv_t *drv, void *rddir_p, char *fn)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /*Add your code here*/

    return res;
}

/**
 * Close the directory reading
 * @param drv       pointer to a driver where this function belongs
 * @param rddir_p   pointer to an initialized 'lv_fs_dir_t' variable
 * @return          LV_FS_RES_OK: no error or  any error from @lv_fs_res_t enum
 */
static lv_fs_res_t fs_dir_close(lv_fs_drv_t *drv, void *rddir_p)
{
    lv_fs_res_t res = LV_FS_RES_NOT_IMP;

    /*Add your code here*/

    return res;
}
#endif

#else /*Enable this file at the top*/

/*This dummy typedef exists purely to silence -Wpedantic.*/
typedef int keep_pedantic_happy;
#endif

main.c中调用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
/**
 * @file main
 *
 */

/*********************
 *      INCLUDES
 *********************/
#include <stdlib.h>
#include <unistd.h>
#include "lvgl/lvgl.h"

#include "lv_drivers/win32drv/win32drv.h"

#include "app/mainui.h"
#include <windows.h>

/*********************
 *      DEFINES
 *********************/

/**********************
 *      TYPEDEFS
 **********************/

/**********************
 *  STATIC PROTOTYPES
 **********************/
static void hal_init(void);
static int tick_thread(void *data);

/**********************
 *  STATIC VARIABLES
 **********************/

/**********************
 *      MACROS
 **********************/

/**********************
 *   GLOBAL FUNCTIONS
 **********************/
int APIENTRY WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
		LPSTR szCmdLine, int nCmdShow) {
	/*Initialize LittlevGL*/
	lv_init();
	/*文件系统支持*/
	lv_port_fs_init();
	/*Initialize the HAL for LittlevGL*/
	lv_win32_init(hInstance, SW_SHOWNORMAL, 800, 480, NULL);

	/*Output prompt information to the console, you can also use printf() to print directly*/
	LV_LOG_USER("LVGL initialization completed!");

	//run main app ui
	main_ui();

	while (!lv_win32_quit_signal) {
		/* Periodically call the lv_task handler.
		 * It could be done in a timer interrupt or an OS task too.*/
		lv_timer_handler();
		usleep(10000); /*Just to let the system breath*/
	}
	return 0;
}

在main.c文件中调用代码如下:

1
2
	/*文件系统支持*/
	lv_port_fs_init();

代码说明

  • init_fs_config()(PC 简化版):注册盘符 ‘S’,把 pcfs_* 一组回调挂到 lv_fs_drv_t 上;
  • pcfs_open:把 LVGL 的模式标志翻译成 stdio 的打开方式(LV_FS_MODE_RD → “rb”),并加上 “./” 前缀——所以文件实际相对的是程序工作目录;
  • __user_font_getdata:外部字体的取数回调。LVGL 渲染某个字时按 offset/size 来要字模数据,回调里用 lv_fs 打开字体 bin、seek 过去读一段返回;注释里同时给了 SPI Flash、SDRAM 两种嵌入式场景的写法;
  • 完整代码 lv_port_fs.c 用 USE_PC_FILE_SYSTEM / USE_FATFS_FILE_SYSTEM 两个宏切换两套实现,FatFS 那套还演示了用 user_data 解耦多设备(SD、SPI Flash)的做法。

踩坑记录与注意事项

  • bin 放错目录读不到:pcfs_open 以 “./” 相对工作目录拼路径,实际位置由 IDE 的工作目录设置决定(Code::Blocks 默认项目根),和源码所在目录不一定相同;
  • 色彩格式不匹配:转换 bin 时的色深要和 lv_conf.h 的 LV_COLOR_DEPTH 一致,不匹配的常见现象是花屏或颜色整体偏色;
  • 一个盘符一个驱动:路径首字符就是盘符,多设备(SD + SPI Flash)就注册多个字母,别往一个盘符里塞两套存储;
  • 字体回调返回的是共享缓冲__g_font_buf 是复用 buffer,LVGL 拿到数据立即使用,不能把它的地址存起来下次再用;嵌入式直读 SDRAM/Flash 的写法没这个限制;
  • PC 模拟取数效率低:每取一段数据都 open/seek/close 一遍文件,只适合功能验证,嵌入式上应按注释改为直读存储介质;
  • 图片缓存:LV_IMG_CACHE_DEF_SIZE 默认值很小,图片反复解码会掉帧,内存富余时调大。