开发板
亚博K210开发板
实验目的
本次测试主要学习 K210 图形化操作界面的功能。
实验元件
LCD 显示屏、FT6236 触摸板
lvgl 图形化库简介
- LVGL（轻度综合图形界面库）是一个免费开源图形库，具有使用方便，画面美观，内存占用率低等优点，能够适配大部分嵌入式单片机，库里拥有许多控件，比如图片按钮、滑动杆、对话框等等，都可以轻松使用。
- 对单片机系统要求：16/32/64 位 MCU，系统时钟速度大于 16MHz，ROM 大于 128K，静态 RAM 大于 16K，栈 RAM 大于 4K，堆 RAM 大于 16K，C99 或更新的编译器。需要注意一点的是内存使用情况可能因架构、编译器和构建选项的不同而有所不同。
由于 lvgl 图形化库版本之间会有差异，这里以 lvgl-v6.1.1 为实验基础版本。
由于 lvgl 图形化库版本之间会有差异，这里以 lvgl-v6.1.1 为实验基础版本。
下载地址：https://github.com/lvgl/lvgl/releases/tag/v6.1.1
这里需要注意的是如果从 lvgl 下载的版本，由于 K210 是 64 位芯片，所以需要增加 64 位的支持，找到 lvgl->src->lv_misc->lv_men.h 文件，在里面增加一个宏定义：#define LV_MEM_ENV64 1
实验原理
- lvgl 图形化库总共可以分为三个大的部分来理解，第一个是 lvgl 的线程，第二个是输入检测，第三个是显示画面。
- lvgl 的主线程由外部定时器每几毫秒调用一次， lv_task_handler 主要是处理 lvgl 的任务，lv_tick_inc 则是起到刷新、清除中断和记录时间的作用。
- lvgl 的输入检测由 lv_indev_drv_t 这个结构体管理，例如触摸板只需要设置输入参数后，在回调函数 read_cb 中传入触摸板的状态和触摸的 X/Y 坐标值就可以。
- lvgl 的显示画面由 lv_disp_drv_t 结构体管理，同样是设置参数后，调用flush_cb 函数把回调传回的图像显示出来。
实验过程
- 首先根据上面的硬件连接引脚图，K210 的硬件引脚和软件功能使用的是FPIOA 映射关系。
// 硬件IO口，与原理图对应
#define PIN_LCD_CS (36)
#define PIN_LCD_RST (37)
#define PIN_LCD_RS (38)
#define PIN_LCD_WR (39)
#define PIN_FT_SCL (9)
#define PIN_FT_SDA (10)
#define PIN_FT_INT (12)
#define PIN_FT_RST (37)
/*****************************SOFTWARE-GPIO********************************/
// 软件GPIO口，与程序对应
#define LCD_RST_GPIONUM (0)
#define LCD_RS_GPIONUM (1)
#define FT_INT_GPIONUM (2)
#define FT_RST_GPIONUM (3)
/*****************************FUNC-GPIO************************************/
// GPIO口的功能，绑定到硬件IO口
#define FUNC_LCD_CS (FUNC_SPI0_SS3)
#define FUNC_LCD_RST (FUNC_GPIOHS0 + LCD_RST_GPIONUM)
#define FUNC_LCD_RS (FUNC_GPIOHS0 + LCD_RS_GPIONUM)
#define FUNC_LCD_WR (FUNC_SPI0_SCLK)
#define FUNC_FT_SCL (FUNC_I2C0_SCLK)
#define FUNC_FT_SDA (FUNC_I2C0_SDA)
#define FUNC_FT_INT (FUNC_GPIOHS0 + FT_INT_GPIONUM)
#define FUNC_FT_RST (FUNC_GPIOHS0 + FT_RST_GPIONUM)
static void hardware_init(void)
{
/* SPI lcd */
fpioa_set_function(PIN_LCD_CS, FUNC_LCD_CS);
fpioa_set_function(PIN_LCD_RST, FUNC_LCD_RST);
fpioa_set_function(PIN_LCD_RS, FUNC_LCD_RS);
fpioa_set_function(PIN_LCD_WR, FUNC_LCD_WR);
sysctl_set_spi0_dvp_data(1);
/* I2C FT6236 */
fpioa_set_function(PIN_FT_SCL, FUNC_FT_SCL);
fpioa_set_function(PIN_FT_SDA, FUNC_FT_SDA);
fpioa_set_function(PIN_FT_INT, FUNC_FT_INT);
// fpioa_set_function(PIN_FT_RST, FUNC_FT_RST);
}
- 设置 LCD 的 IO 口电平电压为 1.8V
static void io_set_power(void)
{
/* 设置显示器电压为1.8V */
sysctl_set_power_mode(SYSCTL_POWER_BANK6, SYSCTL_POWER_V18);
}
- 在使用 LCD 触摸屏前需要初始化，先初始化 LCD，在初始化 ft6236，然后显示一秒自定义图片
/* 初始化触摸屏并显示图片 */
lcd_init();
ft6236_init();
lcd_draw_picture_half(0, 0, 320, 240, gImage_logo);
- 初始化 lvgl，设置 LCD 显示的结构体参数，其中 flush_cb 是 LCD 刷新的回调函数；再设置触摸屏输入的结构体参数，其中 read_cb 是输入设备的回调函数；最后初始化并启动定时器。
void lvgl_disp_input_init(void)
{
lv_init();
static lv_disp_buf_t disp_buf;
static lv_color_t buf[LV_HOR_RES_MAX * 10];
lv_disp_buf_init(&disp_buf, buf, NULL, LV_HOR_RES_MAX * 10);
lv_disp_drv_t disp_drv; /*Descriptor of a display driver*/
lv_disp_drv_init(&disp_drv); /*Basic initialization*/
disp_drv.flush_cb = my_disp_flush; /*Set your driver function*/
disp_drv.buffer = &disp_buf; /*Assign the buffer to the display*/
lv_disp_drv_register(&disp_drv); /*Finally register the driver*/
// input
lv_indev_drv_t indev_drv;
lv_indev_drv_init(&indev_drv); /*Descriptor of a input device driver*/
indev_drv.type = LV_INDEV_TYPE_POINTER; /*Touch pad is a pointer-like device*/
indev_drv.read_cb = my_touchpad_read; /*Set your driver function*/
lv_indev_drv_register(&indev_drv); /*Finally register the driver*/
/* 初始化并启动定时器 */
mTimer_init();
}
- .LCD 显示刷新回调的主要功能是解析需要显示的位置，然后传给 LCD 显示的函数显示出来，其中 color_p 就是需要显示的数据。显示完成后需要通过lv_disp_flush_ready 函数通知 lvgl 系统数据更新完成。
static void my_disp_flush(lv_disp_drv_t * disp, const lv_area_t * area, lv_color_t * color_p)
{
uint16_t x1 = area->x1;
uint16_t x2 = area->x2;
uint16_t y1 = area->y1;
uint16_t y2 = area->y2;
lcd_draw_picture_half((uint16_t)x1, (uint16_t)y1,
(uint16_t)(x2 - x1 + 1), (uint16_t)(y2 - y1 + 1),
(uint16_t *)color_p);
lv_disp_flush_ready(disp); /* Indicate you are ready with the flushing*/
}
- 输入设备回调函数主要的功能读取触摸板的状态和触摸的坐标
static bool my_touchpad_read(lv_indev_drv_t * indev_drv, lv_indev_data_t * data)
{
static int a_state = 0;
if (ft6236.touch_state & TP_COORD_UD)
{
ft6236.touch_state &= ~TP_COORD_UD;
ft6236_scan();
data->point.x = ft6236.touch_x;
data->point.y = ft6236.touch_y;
data->state = LV_INDEV_STATE_PR;
a_state = 1;
return false;
}
else if (ft6236.touch_state & 0xC0)
{
if (a_state == 1)
{
a_state = 0;
data->point.x = ft6236.touch_x;
data->point.y = ft6236.touch_y;
data->state = LV_INDEV_STATE_REL;
return false;
}
}
return false;
}
- 定时器定时时间为每毫秒中断调用一次，在定时器中断函数中调用 lvgl的任务管理函数和时钟函数。
static void mTimer_init(void)
{
timer_init(TIMER_DEVICE_0);
timer_set_interval(TIMER_DEVICE_0, TIMER_CHANNEL_0, 1e6);
timer_irq_register(TIMER_DEVICE_0, TIMER_CHANNEL_0, 0, 1, timer_irq_cb, NULL);
timer_set_enable(TIMER_DEVICE_0, TIMER_CHANNEL_0, 1);
}
static int timer_irq_cb(void * ctx)
{
lv_task_handler();
lv_tick_inc(1);
return 0;
}
- 初始化完成后，就可以运行例程程序，这个例程是创建一个有用三个界面的画面。最后打印 OK，并提示触摸屏幕。
demo_create();
printf("system start ok\n");
printf("Please touch the screen\n");
while (1)
;
- 编译调试，烧录运行
进入自己项目 build目录，运行以下命令编译。
cmake .. -DPROJ=watchdog -G "MinGW Makefiles"
make
实验现象
烧录完成固件后，系统会弹出一个终端界面，如果没有弹出终端界面的可以打开串口助手显示调试内容。
终端会打印“Please touch the screen”提示触摸显示屏，显示屏会显示第一个界面，触摸中间输入框，会在底部弹出一个虚拟键盘，在键盘上触摸可以打印字符；上面顶栏的“List”切换到第二个界面列表，可以点击列表上的内容， 则会把对应的名称显示到第一个界面的输入框中；点击顶栏的“Chart”，切换到第三个界面，拖动底部的滑动杆，上面的条形图会跟着变化。
实验总结
- lvgl 是一个嵌入式微处理器图形化库，拥有丰富的控件。
- K210 开发板完成可以跑图形化的 lvgl 库，并且效果很 OK。
- 由于 lvgl 的不同版本的差异性，跨大版本是存在兼容性问题的。
