下载codeblock(mingw),安装。可参考网上教程。
仓库地址:lvgl/lv_port_win_codeblocks: Windows PC simulator project for LVGL embedded GUI Library (github.com)
?拉取代码到本地硬盘,如下操作步骤:
# 打开git终端输入下面地址并回车
git clone https://github.com/lvgl/lv_sim_codeblocks_win.git
# 进入文件夹lv_sim_codeblocks_win
cd lv_sim_codeblocks_win
# 执行下面命令拉取子模块并初始化仓库
git submodule update --init --recursive
# 文件夹介绍:
# lvgl:lvgl源代码
# lv_examples:lvgl 的使用例程(各种控件使用例程,布局使用例程,系统API使用例程,第三方库使用例程...)
# lv_demo:官方给的比较综合的demo示例
# lv_drivers:和平台相关的底层驱动
如下图:
LittlevGL.cbp 就是codeblock工程。
我拉取的LVGL 是V9 版本。
打开codeblock,选择工程,【File】-【Open】如下图:
设置编译器,【Settings】-【Compiler...】,如下图:
执行【Auto-detect】,或者选取自己的mingw编译器路径,我使用的是QT5自带的编译器
编译并运行,如下图:
等待一段时间,一个默认的demo编译好后自动运行界面如下:
本篇文章不具体讲解LVGL控件使用,可自行在网上找教程,或使用官方教程文档。
下面我记录下,使用LVGL访问文件系统出现的问题,我一开始参考的教程是百问网的LVGL教程,他使用的LVGL是V8版本,所以我参照教程使用一直报 “未知错误”
LVGL默认支持4种文件系统 分别是?LV_USE_FS_STDIO ,LV_USE_FS_POSIX,LV_USE_FS_WIN32,LV_USE_FS_FATFS
我们使用windows 平台我选择?LV_USE_FS_WIN32 ,对应的底层文件操作都是windows自带的,所以不需要移植了。
在lv_conf.h中打开配置如下:
我挂载到D盘,工作目录 LV_FS_WIN32_PATH ""? 不配置。
示例代码如下:
#define FILE_NAME "D:/example/example.txt"
void lv_chenbo_demo_fs(void)
{
#if 1
lv_fs_file_t f;
lv_fs_res_t res;
res = lv_fs_open(&f, FILE_NAME, LV_FS_MODE_RD);
if(res != LV_FS_RES_OK) {
LV_LOG_USER("open file error:%d!", res);
return;
}
uint32_t read_num;
uint8_t buf[32];
memset(buf,0x0,sizeof buf);
res = lv_fs_read(&f, buf, 32, &read_num);
if(res != LV_FS_RES_OK) {
LV_LOG_USER("read file error!");
}
printf("read content:\n%s", buf);
lv_fs_close(&f);
#endif
}
我在D盘创建文件??example/example.txt
编译运行:
一直报错打开文件失败,错误代码12
跳转到 lv_fs.c 中的?lv_fs_res_t lv_fs_open(lv_fs_file_t * file_p, const char * path, lv_fs_mode_t mode)函数如下:
lv_fs_res_t lv_fs_open(lv_fs_file_t * file_p, const char * path, lv_fs_mode_t mode)
{
if(path == NULL) {
LV_LOG_WARN("Can't open file: path is NULL");
return LV_FS_RES_INV_PARAM;
}
char letter = path[0];
lv_fs_drv_t * drv = lv_fs_get_drv(letter);
if(drv == NULL) {
LV_LOG_WARN("Can't open file (%s): unknown driver letter", path);
return LV_FS_RES_NOT_EX;
}
if(drv->ready_cb) {
if(drv->ready_cb(drv) == false) {
LV_LOG_WARN("Can't open file (%s): driver not ready", path);
return LV_FS_RES_HW_ERR;
}
}
if(drv->open_cb == NULL) {
LV_LOG_WARN("Can't open file (%s): open function not exists", path);
return LV_FS_RES_NOT_IMP;
}
const char * real_path = lv_fs_get_real_path(path);
void * file_d = drv->open_cb(drv, real_path, mode);
if(file_d == NULL || file_d == (void *)(-1)) {
return LV_FS_RES_UNKNOWN;
}
file_p->drv = drv;
file_p->file_d = file_d;
if(drv->cache_size) {
file_p->cache = lv_malloc(sizeof(lv_fs_file_cache_t));
LV_ASSERT_MALLOC(file_p->cache);
lv_memzero(file_p->cache, sizeof(lv_fs_file_cache_t));
file_p->cache->start = UINT32_MAX; /*Set an invalid range by default*/
file_p->cache->end = UINT32_MAX - 1;
}
return LV_FS_RES_OK;
}
这个函数是LVGL提供的是一个抽象的文件操作API,他根据不同的文件系统去调用更底层的文件系统接口。
问题出在这里:
const char * real_path = lv_fs_get_real_path(path);
void * file_d = drv->open_cb(drv, real_path, mode);
if(file_d == NULL || file_d == (void *)(-1)) {
return LV_FS_RES_UNKNOWN;
}
看下static const char * lv_fs_get_real_path(const char * path) 函数
/**
* Skip the driver letter and the possible : after the letter
* @param path path string (E.g. S:/folder/file.txt)
* @return pointer to the beginning of the real path (E.g. /folder/file.txt)
*/
static const char * lv_fs_get_real_path(const char * path)
{
path++; /*Ignore the driver letter*/
if(*path == ':') path++;
return path;
}
它的功能就是获取路径 : 后面的字符地址,也就是他把盘符D: 去掉了。
drv->open_cb()是一个回调函数,我们使用是WIN32平台的文件系统所以看
lv_fs_win32.c 中的static void * fs_open(lv_fs_drv_t * drv, const char * path, lv_fs_mode_t mode)
函数如下:
/**
* 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 pointer to FIL struct or NULL in case of fail
*/
static void * fs_open(lv_fs_drv_t * drv, const char * path, lv_fs_mode_t mode)
{
LV_UNUSED(drv);
DWORD desired_access = 0;
if(mode & LV_FS_MODE_RD) {
desired_access |= GENERIC_READ;
}
if(mode & LV_FS_MODE_WR) {
desired_access |= GENERIC_WRITE;
}
/*Make the path relative to the current directory (the projects root folder)*/
char buf[MAX_PATH];
lv_snprintf(buf, sizeof(buf), LV_FS_WIN32_PATH "%s", path);
return (void *)CreateFileA(
buf,
desired_access,
FILE_SHARE_READ,
NULL,
OPEN_EXISTING,
FILE_ATTRIBUTE_NORMAL,
NULL);
}
看下面代码(重点):
char buf[MAX_PATH];
lv_snprintf(buf, sizeof(buf), LV_FS_WIN32_PATH "%s", path);
这个功能是:把我们传过来的路径(前面已经去掉D:) 然后和 LV_FS_WIN32_PATH 拼接在一起,还记得之前这个宏定义我们设置的是空字符串"",这样拼成的新的路径传递给windows底层API使用,造成的结果就是路径错误("/example/examle.txt")。
所以我们就算不配置工作路径,也要把盘符设置一下:
/*API for CreateFile, ReadFile, etc*/
#define LV_USE_FS_WIN32 1
#if LV_USE_FS_WIN32
#define LV_FS_WIN32_LETTER 'D' /*Set an upper cased letter on which the drive will accessible (e.g. 'A')*/
#define LV_FS_WIN32_PATH "D:" /*Set the working directory. File/directory paths will be appended to it.*/
#define LV_FS_WIN32_CACHE_SIZE 1024 /*>0 to cache this number of bytes in lv_fs_read()*/
#endif
这样编译,在运行:
D:/example/example.txt 文件中的 hello,world 被读取出来并显示。
注意:我实际测试的LVGL V9版本必须要这样设置。