⭐建立一个lvgl项目¶
要在我们的项目中使用 lvgl ，我们起码需要获取到官方的这两个库：
lvgl(lvgl)核心图形库的官方 GitHub 仓库地址：https://github.com/lvgl/lvgl。
lvgl(lv_drivers)输入输出设备驱动官方 GitHub 仓库地址：https://github.com/lvgl/lv_drivers
我们可以克隆或下载这两个库的最新版本，将它们复制到我们的项目中，然后进行适配。
目录 lvgl 就是 lvgl 的官方图形库
目录 lv_drivers 是 lvgl 输入输出设备驱动官方示例配置
目录 lv_examples 是 lvgl 的官方demo(可选，但不要直接使用到实际项目中)
配置文件¶
上面的三个库中有一个类似名为 lv_conf_template.h 的配置头文件(template就是模板的意思)。通过它可以设置库的基本行为，裁剪不需要模块和功能，在编译时调整内存缓冲区的大小等等。
将 lvgl/lv_conf_template.h 复制到 lvgl 同级目录下，并将其重命名为
lv_conf.h。打开文件并将开头的#if 0更改为#if 1以使能其内容。将 lv_drivers/lv_drv_conf_template.h 复制到 lv_drivers 同级目录下，并将其重命名为
lv_drv_conf.h。打开文件并将开头的#if 0更改为#if 1以使能其内容。(可选)将 lv_examples/lv_ex_conf_template.h 复制到 lv_examples 同级目录下，并将其重命名为
lv_ex_conf.h。打开文件并将开头的#if 0更改为#if 1以使能其内容。
准备lvgl配置文件¶
使能配置文件¶
lv_conf.h 也可以复制到其他位置，但是应该在编译器选项中添加 ``LV_CONF_INCLUDE_SIMPLE`` 定义 (例如，对于 gcc 编译器为 ``-DLV_CONF_INCLUDE_SIMPLE`` ) 并手动设置包含路径。
在配置文件中，注释说明了各个选项的含义。我们在移植时至少要检查以下三个配置选项，其他配置根据具体的需要进行修改：
LV_HOR_RES_MAX显示器的水平分辨率。LV_VER_RES_MAX显示器的垂直分辨率。LV_COLOR_DEPTH颜色深度，其可以是：
8 - RG332
16 - RGB565
32 - (RGB888和ARGB8888)
初始化lvgl¶
准备好这三个库：lvgl、lv_drivers、lv_examples 后，我们就要开始使用lvgl带给我们的功能了。使用 lvgl 图形库之前，我们还必须初始化 lvlg 以及相关其他组件。初始化的顺序为：
调用 lv_init() 初始化 lvgl 库;
初始化驱动程序；
在 LVGL 中注册显示和输入设备驱动程序；
在中断中每隔
x毫秒调用lv_tick_inc(x)用以告知 lvgl 经过的时间；每隔
x毫秒定期调用lv_task_handler()用以处理与 lvgl 相关的任务。
Windows初始化示例(Cdoe::Blocks)¶
如果你是基于 windows上的IDE模拟器(推荐) 进行学习，请先 点击这里下载配置好的项目工程 及 windows上的IDE模拟器(Cdoe::Blocks) 用于后面的学习。
1 #if WIN32
2 int APIENTRY WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR szCmdLine, int nCmdShow)
3 #else
4 int main(int argc, char** argv)
5 {
6 /*Initialize LittlevGL*/
7 lv_init();
8
9 /*Initialize the HAL for LittlevGL*/
10 hal_init();
11
12 /*Check the themes too*/
13 lv_disp_set_default(lv_windows_disp);
14
15 /*Run your APP here */
16
17
18 #if WIN32
19 while(!lv_win_exit_flag) {
20 #else
21 while(1) {
22 #endif // WIN32
23 /* Periodically call the lv_task handler.
24 * It could be done in a timer interrupt or an OS task too.*/
25 lv_task_handler();
26 usleep(5*1000); /*Just to let the system breath*/
27 lv_tick_inc(5*1000)
28 }
29 return 0;
30 }
Linux初始化示例¶
如果你是基于 Linux开发板 进行学习，请先 点击这里下载配置好的项目工程 用于后面的学习。
1 int main(void)
2 {
3 /* LittlevGL init */
4 lv_init();
5
6 /* Linux frame buffer device init */
7 fbdev_init();
8
9 /* A small buffer for LittlevGL to draw the screen's content */
10 static lv_color_t buf[DISP_BUF_SIZE];
11
12 /* Initialize a descriptor for the buffer */
13 static lv_disp_buf_t disp_buf;
14 lv_disp_buf_init(&disp_buf, buf, NULL, DISP_BUF_SIZE);
15
16 /* Initialize and register a display driver */
17 lv_disp_drv_t disp_drv;
18 lv_disp_drv_init(&disp_drv);
19 disp_drv.buffer = &disp_buf;
20 disp_drv.flush_cb = fbdev_flush;
21 lv_disp_drv_register(&disp_drv);
22
23 //hal_init
24 lv_disp_set_default lv_windows_disp
25
26
27 /* Linux input device init */
28 evdev_init();
29
30 /* Initialize and register a display input driver */
31 lv_indev_drv_t indev_drv;
32 lv_indev_drv_init(&indev_drv); /*Basic initialization*/
33
34 indev_drv.type = LV_INDEV_TYPE_POINTER;
35 indev_drv.read_cb = evdev_read; //lv_gesture_dir_t lv_indev_get_gesture_dir(const lv_indev_t * indev)
36 lv_indev_t * my_indev = lv_indev_drv_register(&indev_drv);
37
38
39
40 /*Run your APP here */
41
42
43 /*Handle LitlevGL tasks (tickless mode)*/
44 while(1) {
45 lv_task_handler();
46 usleep(5000);
47 lv_tick_inc(5*1000);
48 }
49
50 return 0;
51 }