Linux 环境中使用 LVGL

之前有记录过在 esp32 中使用 LVGL 的笔记，需要的小伙伴可以了解一下，esp-idf 移植 lvgl8.3.3
我之前整理的学习资料：https://www.cnblogs.com/jzcn/p/16647106.html

一、准备材料

开发板：一块 linux 的开发板 或 linux 的虚拟机
lvgl：8.3.3
系统：ubuntu 18.04

注意：在 linux 环境下使用 lvgl 就相对比较简单了，这里记录了两个方式。

二、方式一

因为 linux 环境下，官方已经帮我们创建好了项目，所以只需要直接拉取就好了。
仓库地址：https://github.com/lvgl/lv_port_linux_frame_buffer

  1. git 命令

    git clone --recursive https://github.com/lvgl/lv_port_linux_frame_buffer.git
# 如果拉取不下来，可以使用下面的加速地址，我也不知道是否会失效
https://github.moeyy.xyz/https://github.com/lvgl/lv_port_linux_frame_buffer.git

    注意：拉取的时候已经要加 --recursive，否则项目中的子工程拉不下来，如果拉取时忘记加 --recursive 参数，可以在拉取完成是使用 git submodule update --init --recursive 命令更新一下即可。

  2. 工程目录
    拉取完成后，工程目录如下所示：

  3. 编译工程
    直接使用 make 命令编译即可，完成后如下图所示：会直接生成可执行文件，如下图所示：

    注意： 发现可执行文件后，基本就完成了，直接运行即可，./demo ，毫无疑问基本会运行失败，结果如下图所示：

  4. 修改显示驱动
    这里的显示驱动都是使用的 Framebuffer 缓冲区，我之间有个简单的笔记使用，不了解的小伙伴，可以看我之前的笔记，Linux Framebuffer 实验，知道自己的缓冲区设备后，就可以直接在文件 lv_drv_conf.h 中进行修改，不过多数情况下都是 /dev/fb0 可以不用修改，如下图所示：

  5. 修改鼠标或触摸驱动
    在修改鼠标或触摸驱动时，需要借助 evtest 工具，找到自己设备的输入事件。

    • 安装 evtset 工具

      sudo apt-get install evtest

    • 使用命令 sudo evtest 找到对应的事件编号，如下图所示：

    找到鼠标事件后，直接在 lv_drv_conf.h 文件中，更改对应的事件编号即可，如下图所示：

  6. 运行测试
    完成驱动修改后，重新编译测试，因为使用的是 Framebuffer 缓冲区，所以在 ubuntu 缓冲区中使用是，需要关闭图形显示后，才是正常使用 Framebuffer ，命令如下

    # 关闭图形显示
systemctl set-default multi-user.target
reboot

# 打开图形显示
systemctl set-default graphical.target
reboot

    关闭图形显示后，测试结果如下图所示：

三、方式二

上面我们已经完成了，在 ubuntu 中测试 LVGL 操作还是比较简单的，现在我们开始尝试手动创建工程，并将编译后生成的.o文件放到指定目录下，然后更改编译工具，使其在arm开发板中进行使用。

注意： 在创建过程中，有什么问题可以直接参考上面的工程，可以解决我们过程中遇到的问题

  1. 下载 LVGL

  2. 创建工程目录
    这里我就不详细说明了，直接上图，只要文件目录如图所示一样即可，路径图下图所示：

  3. 将 lvgl 移动到 lib 文件下，并删除多余的文件，如下图所示：

    注意：其中的 lv_conf.h 文件是直接将 lv_conf_template.h 拷贝后进行重命名的，完成后将文件中的 #if 0 改为 #if 1

  4. 将 lvgl 目录下的 demos 文件拷贝到 lib 文件下，如下图所示：

    注意：这里为了 demos 使用中减少问题，我直接拷贝了 lvgl 文件下的 demos 并重命名为 lv_demos

  5. 将 lv_drivers 拷贝到 lib 文件下，并删除多余的文件，如下图所示：

    注意：其中 lv_drv_conf.h 文件是拷贝 lv_drv_conf_template.h 文件重命名后得到的，完成后将文件中的 #if 0 改为 #if 1

  6. 将 lvgl 目录下的 examples 文件拷贝到 lib 文件下，如下图所示：

  7. 在 application 文件下创建 main.c 文件，内容如下：

    #include "lvgl.h"
#include "../lib/lv_demos/lv_demos.h"
#include "../lib/lv_drivers/display/fbdev.h"
#include "../lib/lv_drivers/indev/evdev.h"
#include <unistd.h>
#include <pthread.h>
#include <time.h>
#include <sys/time.h>

#define DISP_BUF_SIZE (128 * 1024)

int main(void)
{
    /*LittlevGL init*/
    lv_init();

    /*Linux frame buffer device init*/
    fbdev_init();

    /*A small buffer for LittlevGL to draw the screen's content*/
    static lv_color_t buf[DISP_BUF_SIZE];

    /*Initialize a descriptor for the buffer*/
    static lv_disp_draw_buf_t disp_buf;
    lv_disp_draw_buf_init(&disp_buf, buf, NULL, DISP_BUF_SIZE);

    /*Initialize and register a display driver*/
    static lv_disp_drv_t disp_drv;
    lv_disp_drv_init(&disp_drv);
    disp_drv.draw_buf   = &disp_buf;
    disp_drv.flush_cb   = fbdev_flush;
    disp_drv.hor_res    = 800;
    disp_drv.ver_res    = 480;
    lv_disp_drv_register(&disp_drv);

    evdev_init();
    static lv_indev_drv_t indev_drv_1;
    lv_indev_drv_init(&indev_drv_1); /*Basic initialization*/
    indev_drv_1.type = LV_INDEV_TYPE_POINTER;

    /*This function will be called periodically (by the library) to get the mouse position and state*/
    indev_drv_1.read_cb = evdev_read;
    lv_indev_t *mouse_indev = lv_indev_drv_register(&indev_drv_1);


    /*Set a cursor for the mouse*/
    LV_IMG_DECLARE(mouse_cursor_icon)
    lv_obj_t * cursor_obj = lv_img_create(lv_scr_act()); /*Create an image object for the cursor */
    lv_img_set_src(cursor_obj, &mouse_cursor_icon);           /*Set the image source*/
    lv_indev_set_cursor(mouse_indev, cursor_obj);             /*Connect the image  object to the driver*/


    /*Create a Demo*/
    lv_demo_widgets();

    /*Handle LitlevGL tasks (tickless mode)*/
    while(1) {
        lv_timer_handler();
        usleep(5000);
    }

    return 0;
}

/*Set in lv_conf.h as `LV_TICK_CUSTOM_SYS_TIME_EXPR`*/
uint32_t custom_tick_get(void)
{
    static uint64_t start_ms = 0;
    if(start_ms == 0) {
        struct timeval tv_start;
        gettimeofday(&tv_start, NULL);
        start_ms = (tv_start.tv_sec * 1000000 + tv_start.tv_usec) / 1000;
    }

    struct timeval tv_now;
    gettimeofday(&tv_now, NULL);
    uint64_t now_ms;
    now_ms = (tv_now.tv_sec * 1000000 + tv_now.tv_usec) / 1000;

    uint32_t time_ms = now_ms - start_ms;
    return time_ms;
}

  8. 拷贝鼠标文件 mouse_cursor_icon.c
    将方式一中获取到的鼠标文件拷贝到 application 文件下

  9. 在 lib 目录下创建 lib.mk 文件，内容如下：

    ##################################### lvgl库 #####################################
# 文件路径
LVGL_DIR ?= $(PROJECT_PATH)/lib

# 所需的宏定义
CFLAGS += -DLV_CONF_INCLUDE_SIMPLE
CFLAGS += -DLV_LVGL_H_INCLUDE_SIMPLE
# lvgl库
LVGL_DIR_NAME ?= lvgl

# 所需头文件的路径
CFLAGS += -I$(LVGL_DIR)/lvgl

# 收集需要编译的源文件
include $(LVGL_DIR)/lv_demos/lv_demos.mk
include $(LVGL_DIR)/lv_examples/lv_examples.mk
include $(LVGL_DIR)/lv_drivers/lv_drivers.mk
include $(LVGL_DIR)/$(LVGL_DIR_NAME)/lvgl.mk

  10. 在主目录下创建 Makefile 文件，内容如下：

    #
# Makefile
# 编译的.o文件和.c文件在同一路径下
#

$(info "start...")
# 可执行文件名
PROJECT_NAME = lvgl_app

##################################### 项目路径 #####################################
PROJECT_PATH ?= ${shell pwd}
OBJ_DIR := $(PROJECT_PATH)/build

##################################### 设置编译器，默认使用GCC #####################################
CC = arm-linux-gnueabihf-gcc
CC ?= gcc

##################################### 所需头文件的路径 #####################################
# lv_conf.h
CFLAGS += -I$(PROJECT_PATH)/lib/lvgl
# lv_drv_conf.h
CFLAGS += -I$(PROJECT_PATH)/lib/lv_drivers

##################################### 编译和链接参数 #####################################
CFLAGS ?= -O3 -g0 -Wall -Wshadow -Wundef -Wmissing-prototypes -Wno-discarded-qualifiers -Wextra -Wno-unused-function \
-Wno-error=strict-prototypes -Wpointer-arith -fno-strict-aliasing -Wno-error=cpp -Wuninitialized -Wmaybe-uninitialized \
-Wno-unused-parameter -Wno-missing-field-initializers -Wtype-limits -Wsizeof-pointer-memaccess -Wno-format-nonliteral \
-Wno-cast-qual -Wunreachable-code -Wno-switch-default -Wreturn-type -Wmultichar -Wformat-security -Wno-ignored-qualifiers \
-Wno-error=pedantic -Wno-sign-compare -Wno-error=missing-prototypes -Wdouble-promotion -Wclobbered -Wdeprecated -Wempty-body \
-Wshift-negative-value -Wstack-usage=2048 -Wno-unused-value
 
LDFLAGS ?= -lm

##################################### 收集需要编译的源文件 #####################################
CSRCS += $(PROJECT_PATH)/application/main.c
CSRCS += $(PROJECT_PATH)/application/mouse_cursor_icon.c
include $(PROJECT_PATH)/lib/lib.mk


##################################### 将文件名替换为.o文件 #####################################
AOBJS = $(ASRCS:.S=.o)
COBJS = $(CSRCS:.c=.o)
# CXX_SOURCES = $(foreach dir,$(CSRCS), $(wildcard $(dir)/*.c))
# CXX_OBJCTS = $(patsubst  %.c, $(OBJ_DIR)/%.o, $(CSRCS))

all: default

%.o: %.c
	@$(CC)  $(CFLAGS) -c $< -o $@
	#@echo "CC $<"
    
default: $(COBJS)
	$(CC) -o $(PROJECT_NAME)  $(COBJS) $(AOBJS) $(LDFLAGS)

clean: 
	rm -f $(PROJECT_NAME) $(COBJS) $(AOBJS)

注意： 到此工程文件已经创建好了，接下来只需要解决我们工程放置文件路径导致的问题即可，目录结构如下图所示：

  1. 修改 lib/lv_demos/lv_demos.mk 文件内容如下：

    CSRCS += $(shell find -L $(LVGL_DIR)/lv_demos -name "*.c")

  2. 修改 lib/lv_examples/lv_examples.mk 文件，内容如下：

    CSRCS += $(shell find -L $(LVGL_DIR)/lv_examples -name \*.c)

  3. 修改 lib/lvgl/lvgl.mk

  4. 启动相应的功

    • USE_FBDEV：在文件 lv_drv_conf.h 中
    • USE_EVDEV：在文件 lv_drv_conf.h 中
    • LV_USE_DEMO_WIDGETS：在文件 lv_conf.h，主要作用是启动相应的案例

  5. 在编译的过程中会有 lvgl.h 头文件的引用错误。如下所示：

    #include "../../../lvgl.h"

    这是因为我们移动路径导致的，所以只需要将所以文件引用改为 #include "lvgl.h" 即可

注意：到此我们自己在 Linux 环境下创建的 LVGL 工程就已经完成了，这里自己创建 lvgl 的目的主要是方便版本的选择，可以根据自己的需要选择相应的 LVGL 版本。

四、指定 .o 文件的存放路径

上面的工程中会发现编译生成的.o文件和.c文件是在同一路径下的，那么在实际开发中有不方便之处，所以将.o文件指定到build文件下，操作比较简单，只需要将 Makefile 文件进行更改即可，如下所示：

Makefile 文件

#
# Makefile
# 编译的.o文件和.c文件在同一路径下
#

$(info "start...")
# 可执行文件名
PROJECT_NAME = lvgl_app

##################################### 项目路径 #####################################
PROJECT_PATH ?= ${shell pwd}
OBJ_DIR := $(PROJECT_PATH)/build

##################################### 设置编译器，默认使用GCC #####################################
CC = arm-linux-gnueabihf-gcc
CC ?= gcc

##################################### 所需头文件的路径 #####################################
# lv_conf.h
CFLAGS += -I$(PROJECT_PATH)/lib/lvgl
# lv_drv_conf.h
CFLAGS += -I$(PROJECT_PATH)/lib/lv_drivers

##################################### 编译和链接参数 #####################################
CFLAGS ?= -O3 -g0 -Wall -Wshadow -Wundef -Wmissing-prototypes -Wno-discarded-qualifiers -Wextra -Wno-unused-function \
-Wno-error=strict-prototypes -Wpointer-arith -fno-strict-aliasing -Wno-error=cpp -Wuninitialized -Wmaybe-uninitialized \
-Wno-unused-parameter -Wno-missing-field-initializers -Wtype-limits -Wsizeof-pointer-memaccess -Wno-format-nonliteral \
-Wno-cast-qual -Wunreachable-code -Wno-switch-default -Wreturn-type -Wmultichar -Wformat-security -Wno-ignored-qualifiers \
-Wno-error=pedantic -Wno-sign-compare -Wno-error=missing-prototypes -Wdouble-promotion -Wclobbered -Wdeprecated -Wempty-body \
-Wshift-negative-value -Wstack-usage=2048 -Wno-unused-value
 
LDFLAGS ?= -lm

##################################### 收集需要编译的源文件 #####################################
CSRCS += $(PROJECT_PATH)/application/main.c
CSRCS += $(PROJECT_PATH)/application/mouse_cursor_icon.c
include $(PROJECT_PATH)/lib/lib.mk


##################################### 将文件名替换为.o文件 #####################################
CXX_OBJCTS = $(patsubst  %.c, $(OBJ_DIR)/%.o, $(notdir $(CSRCS)))
SOURSE_DIR = $(dir $(CSRCS))

vpath %.c $(SOURSE_DIR)

$(OBJ_DIR)/%.o: %.c
	@$(CC) $(CFLAGS) -c $< -o $@
	#@echo "CC $<"

all: $(CXX_OBJCTS)
	@$(CC) -o $(PROJECT_NAME)  $(CXX_OBJCTS) $(LDFLAGS)

clean: 
	@rm -f $(PROJECT_NAME) $(CXX_OBJCTS)

笔记到此结束，有写得不好的地方望各位大佬指出

posted @ 2022-12-29 11:58  浇筑菜鸟  阅读(6917)  评论(7)  编辑  收藏  举报