LVGL8 Widgets Dual 双屏控件演示示例

📁 源码位置: samples/media/lvgl/lvgl8/widgets_dual 查看源码

功能说明

演示 LVGL 8.x 在双屏场景下的 Widgets 控件显示能力。

本示例基于 LISA Display 多实例显示适配层，为两块 ST7789P3 屏幕分别注册独立的 lv_disp_t，并在两块屏上分别启动 lv_demo_widgets()。当前版本保留单路触摸输入：

  • display：绑定 touch_cst328，支持触摸交互

  • display1：仅显示，不绑定触摸输入

此外，示例中保留了 i2c1 的 pinmux 入口，作为后续第二路触摸多实例支持时的硬件预留。

硬件连接

LCD0 显示屏（display / SPI1）

信号

引脚

说明

SPI_CLK

PB3

SPI1 时钟

SPI_DATA

PB1

SPI1 数据

CS

PB5

LCD0 片选

DC

PB0

LCD0 数据/命令选择

RST

PA1

LCD0 复位

PWM

PA0

LCD0 背光 PWM

LCD1 显示屏（display1 / SPI0）

信号

引脚

说明

SPI_CLK

PA15

SPI0 时钟

SPI_DATA

PA14

SPI0 数据

CS

PA12

LCD1 片选

DC

PA13

LCD1 数据/命令选择

PWM

PA11

LCD1 背光 PWM

Touch0 触摸屏（仅绑定 display）

信号

引脚

说明

SDA

PA22

I2C0 数据

SCL

PA23

I2C0 时钟

INT

PA24

触摸中断

RST

PA25

触摸复位

Touch1 预留（当前未启用）

信号

引脚

说明

SDA

PA18

I2C1 数据预留

SCL

PA19

I2C1 时钟预留

示例步骤

  1. 初始化 LVGL 库

  2. 配置双屏 GPIO/SPI/PWM 引脚复用

  3. 初始化 display 和 display1，分别绑定各自 SPI 总线

  4. 为两块屏分别注册 LVGL 显示驱动

  5. 初始化 touch_cst328，并将输入设备绑定到 display

  6. 打开两块屏背光并设置亮度

  7. 在 display 和 display1 上分别运行 lv_demo_widgets()

  8. 在主循环中持续调用 lv_timer_handler() 处理刷新

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

  • arcs_evb - ARCS EVB 评估板

  • arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在 SDK 根目录执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

预期输出

终端输出：

LVGL8 dual widgets start

屏幕显示：

  • LCD0 显示 LVGL Widgets Demo，支持触摸操作

  • LCD1 显示 LVGL Widgets Demo，仅显示不响应触摸

  • 左上角可显示性能监控信息（启用 CONFIG_LV_USE_PERF_MONITOR=y 时）

核心 API

API

说明

lv_init()

初始化 LVGL 库

lisa_device_get()

获取设备句柄

lisa_display_attach_bus()

配置显示设备总线

lv_port_disp_register()

为指定显示设备注册一个 lv_disp_t

lisa_touch_attach_bus()

配置触摸设备总线

lv_port_indev_register()

为指定显示设备注册输入设备

lisa_display_blanking_off()

打开显示输出

lisa_display_set_brightness()

设置背光亮度

lv_demo_widgets()

启动 widgets 控件演示

lv_timer_handler()

LVGL 定时刷新入口

关键代码

双屏显示初始化

disp0 = lv_port_disp_register(display0);
disp1 = lv_port_disp_register(display1);

lisa_display_blanking_off(display0);
lisa_display_blanking_off(display1);
lisa_display_set_brightness(display0, 80);
lisa_display_set_brightness(display1, 80);

单路触摸绑定到屏0

if (init_touch0() != 0) {
    return -1;
}

indev0 = lv_port_indev_register(touch0_dev, display0, disp0);
if (!indev0) {
    return -1;
}

两块屏分别创建 Widgets Demo

lv_disp_set_default(disp0);
lv_demo_widgets();

lv_disp_set_default(disp1);
lv_demo_widgets();

配置说明

必需的配置项（prj.conf）

CONFIG_LISA_DEVICE=y
CONFIG_LISA_GPIO_DEVICE=y
CONFIG_LISA_GPIOA=y
CONFIG_LISA_GPIOB=y
CONFIG_LISA_PWM=y
CONFIG_LISA_SPI0=y
CONFIG_LISA_SPI1=y
CONFIG_LISA_I2C=y
CONFIG_LISA_I2C0=y
CONFIG_LISA_I2C1=y

CONFIG_LISA_DUAL_DISPLAY=y
CONFIG_LISA_DISPLAY_DEVICE=y
CONFIG_LISA_DISPLAY_PANEL_ST7789P3=y
CONFIG_LISA_DISPLAY_BUS_SPI_4WIRE=y

CONFIG_LISA_TOUCH_DEVICE=y
CONFIG_LISA_TOUCH_ARCS_CST328=y

CONFIG_SDK_MODULE_LVGL8=y
CONFIG_LV_USE_DEMO_WIDGETS=y
CONFIG_LV_USE_GPU_CSK_DMA2D=y
CONFIG_LV_DOUBLE_VDB=y
CONFIG_LV_USE_PERF_MONITOR=y

关键显示配置

CONFIG_PANEL_ST7789P3_WIDTH=240
CONFIG_PANEL_ST7789P3_HEIGHT=320
CONFIG_LV_DRIVER_ROTATE_270=y
CONFIG_LISA_DISPLAY_COLOR_INVERT=y
CONFIG_LV_DRIVER_FULL_REFRESH=y
CONFIG_LV_REFR_UNCONDITIONAL_AREA_JOIN=y
CONFIG_LV_ATTRIBUTE_FAST_MEM_USE_IRAM=y

注意事项

  1. 当前触摸能力边界：

    • 目前 sample 只启用一路触摸

    • touch_cst328 绑定到 display

    • display1 暂不支持独立触摸

  2. i2c1 仅为预留：

    • lisa_i2c1_pinmux() 已保留

    • 但当前没有在 sample 中启用第二路 touch 初始化

    • 需要等 touch 驱动支持多实例后再接入

  3. 双屏初始化顺序：

    • 先 lv_init()

    • 再 attach 两块 display

    • 再注册两个 lv_disp_t

    • 最后再注册 touch0 -> disp0

  4. 多屏 Demo 的创建方式：

    • 本示例通过 lv_disp_set_default() 切换默认显示

    • 然后分别调用两次 lv_demo_widgets()

    • 若后续需要完全不同的双屏异显内容，建议改为分别创建独立 screen/root 组件

  5. 性能与内存：

    • 双屏渲染对显存和带宽要求更高

    • 建议保留 CONFIG_LV_USE_GPU_CSK_DMA2D=y、CONFIG_LV_DOUBLE_VDB=y

    • 当前 CONFIG_PSRAM_HEAP_SIZE=0x200000 用于保证 LVGL 内存充足