准备好
LVGL官方文档(已跳转到arduino部分)、官方的示例ino文件、Arduino IDE
一、lvgl库安装
使用Arduino IDE自带的库管理即可,在菜单栏 工具-管理库 弹出的库管理窗口中搜索lvgl并安装图中的两个库(一个本体一个示例);版本自选,这里安装的是文章编写时最新的7.10.0:
安装完成后,还需安装屏幕驱动,继续搜索TFT_eSPI并安装最新版本。
二、配置库
这时候库是无法通过编译的,需要按照官方文档的要求进行配置,官方文档有详细操作步骤,这里贴出来加上翻译供参考。
1.lvgl库
1.打开arduino库文件夹libraries
2. 将lvgl文件夹下的lv_conf_template.h文件复制出来和lvgl文件夹并列,并重命名为lv_conf.h
3. 打开lv_conf.h文件,将第一个 #if 0 改为 #if 1
4. 根据屏幕分辨率修改LV_HOR_RES_MAX和LV_VER_RES_MAX
5. 根据屏幕色深修改LV_COLOR_DEPTH
6.将定义 #define LV_TICK_CUSTOM 改为 1
2.lv_examples库
- 打开arduino库文件夹libraries
- 将lv_examples文件夹下的 lv_ex_template.h文件复制出来和lv_examples文件夹并列,并重命名为 lv_ex_conf.h
- 打开lv_ex_conf.h文件并修改第一个 #if 0 为 #if 1
- 使能你想要使用的例程,以lv_ex_…()开头的例程是一直使能的。
三、使用例程
lvgl整个库一个ino文件都没有,而lv_example又是作为库存在的,这样的话IDE的示例一栏里就没有lvgl的示例,很不方便。
1.添加ino文件
将官方的示例ino文件LVGL_Arduino.ino放进 lvgl 的 examples 目录下,用IDE打开一下生成同名的项目文件夹,重启IDE后在 文件 - 示例 就能找到 lvgl 的示例了。
2.修改ino文件
打开示例,在图中光标所在黄色区域添加一个空格,否则下一行的lv_ex_btn_1()会被编译器认为是注释,而这一句正是lv_example库中例程的调用方式。
文件没有加载example库却调用了例子,编译必报错,需要在include那块加一条:
#include <lv_examples.h>
另外由于TFT_eSPI默认是没有配置触摸的,所以编译后TOUCH部分会报错,第三篇会填坑讲讲如何配置驱动。如果没有触摸屏,可以把touch部分代码删掉 。这样编译就可以通过了。
OK,结束。
END
更正一下:
不用删掉touch部分代码。TFT_eSPI库配置里只要启用TOUCH_CS引脚,touch部分就不再报错了,具体操作踩坑指南03里会写。