LVGL8 Dual Benchmark 双屏性能测试示例

功能说明

演示 LVGL 8.x 图形库在双屏场景下运行 Benchmark 性能测试的能力，用于评估两块屏幕同时渲染时的图形性能和稳定性。

本示例基于 LISA Display 多显示框架和 LVGL 多显示移植层实现：

display 使用 SPI1 驱动第一块 ST7789P3 屏幕
display1 使用 SPI0 驱动第二块 ST7789P3 屏幕
两块屏幕分别启动各自独立的 benchmark 实例
第一块屏默认接入 CST328 触摸屏
第二块触摸屏为可选，若设备不存在会跳过，不影响 benchmark 运行

与单屏 benchmark 示例不同，benchmark_dual 不是直接对两块屏重复调用 lv_demo_benchmark()，而是在 sample 内部为每块屏创建独立的 benchmark 实例，避免原始 demo 的全局静态状态在双屏场景下互相覆盖。

硬件连接

LCD0 显示屏（SPI1）

信号	引脚	说明
SPI_CLK	PB3	SPI1 时钟
SPI_DATA	PB1	SPI1 数据
CS	PB5	LCD0 片选
DC	PB0	LCD0 数据/命令选择
RST	PA1	LCD0 复位
PWM	PA0	LCD0 背光 PWM

LCD1 显示屏（SPI0）

信号	引脚	说明
SPI_CLK	PA15	SPI0 时钟
SPI_DATA	PA14	SPI0 数据
CS	PA12	LCD1 片选
DC	PA13	LCD1 数据/命令选择
PWM	PA11	LCD1 背光 PWM

Touch0 触摸屏（I2C0，可选但推荐）

信号	引脚	说明
SDA	PA22	I2C0 数据
SCL	PA23	I2C0 时钟
INT	PA24	Touch0 中断
RST	PA25	Touch0 复位

Touch1 触摸屏（I2C1，可选）

信号	引脚	说明
SDA	PA18	I2C1 数据
SCL	PA19	I2C1 时钟
INT	PA27	Touch1 中断
RST	PA26	Touch1 复位

说明：

第二块触摸屏当前为可选硬件。如果 touch_cst328_1 设备不存在，示例会打印 warning 并跳过 display1 的输入设备注册。
第二块触摸屏的 RST/INT 引脚定义目前采用 sample 内占位值，如实际硬件不同，请同步修改 samples/modules/lvgl/lvgl8/benchmark_dual/src/main.c。

示例步骤

初始化 LVGL 库
初始化两块显示屏对应的 GPIO、SPI、PWM 资源
注册 display 和 display1 到 LVGL 多显示驱动层
初始化第一块触摸屏，并在设备存在时尝试初始化第二块触摸屏
打开两块屏幕背光并设置亮度
分别在 disp0 和 disp1 上启动独立的 benchmark 实例
在主循环中持续调用 lv_timer_handler() 处理两块屏幕的刷新与动画

编译

bash "samples/modules/lvgl/lvgl8/benchmark_dual/build.sh" \
  -S "samples/modules/lvgl/lvgl8/benchmark_dual" \
  -B "build_benchmark_dual" \
  -DBOARD=arcs_evb

烧录

请根据当前开发板烧录流程，将 build_benchmark_dual/app.bin 烧录到目标设备。

如果你已经有统一的烧录脚本，也可以直接使用该脚本对 build_benchmark_dual/app.bin 进行烧录。

预期输出

终端输出：

LVGL8 dual benchmark start

如果第二块触摸设备不存在，可能额外看到如下 warning，这属于预期行为：

Touch device touch_cst328_1 not found, skip display1 touch

屏幕显示：

两块屏幕都会进入 benchmark 测试场景
两块屏幕都会自动切换矩形、边框、阴影、图片、文字、线条、弧形等测试项目
每块屏幕都会独立刷新自己的 FPS 结果
benchmark 结束后，两块屏幕都会各自进入结果汇总页

核心 API

API	说明
`lv_init()`	初始化 LVGL 库
`lisa_display_attach_bus()`	绑定显示设备与总线
`lv_port_disp_register()`	注册 LVGL 多显示设备
`lisa_touch_attach_bus()`	绑定触摸设备与总线
`lv_port_indev_register()`	注册 LVGL 多输入设备
`lv_demo_benchmark_disp0_bind()`	绑定 display0 的 benchmark 实例
`lv_demo_benchmark_disp0()`	启动 display0 的 benchmark
`lv_demo_benchmark_disp1_bind()`	绑定 display1 的 benchmark 实例
`lv_demo_benchmark_disp1()`	启动 display1 的 benchmark
`lv_timer_handler()`	处理 LVGL 定时器和刷新

关键实现

双屏注册

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

双实例 benchmark 绑定与启动

lv_demo_benchmark_disp0_bind(disp0);
lv_demo_benchmark_disp1_bind(disp1);

lv_demo_benchmark_disp0();
lv_demo_benchmark_disp1();

第二块触摸屏的降级处理

if (!touch_dev) {
    LISA_LOGW(LOG_TAG, "Touch device %s not found, skip display1 touch", TOUCH1_DEVICE);
    return 1;
}

配置说明

必需配置项（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_BENCHMARK=y
CONFIG_LV_USE_GPU_CSK_DMA2D=y
CONFIG_LV_DOUBLE_VDB=y
CONFIG_LV_USE_PERF_MONITOR=y

性能相关配置

CONFIG_LV_USE_GPU_CSK_DMA2D=y
CONFIG_LV_DOUBLE_VDB=y
CONFIG_LV_DRIVER_FULL_REFRESH=y
CONFIG_LV_REFR_UNCONDITIONAL_AREA_JOIN=y
CONFIG_LV_ATTRIBUTE_FAST_MEM_USE_IRAM=y

这些配置用于提升双屏 benchmark 的刷新效率，减少渲染瓶颈对测试结果的干扰。

与单屏 benchmark 的区别

项目	`benchmark`	`benchmark_dual`
显示屏数量	1	2
显示驱动	单显示移植层	多显示移植层
benchmark 实例数量	1	2
触摸设备	1 个必需	第 2 个可选
运行目标	单屏性能测试	双屏同时渲染性能与稳定性测试

注意事项

不要直接在双屏场景中对两块屏重复调用原始 lv_demo_benchmark()
- 原始 benchmark demo 内部包含全局静态状态
- 在双屏环境中直接复用会导致状态互相覆盖，可能在场景切换或结果汇总阶段触发异常
- 本 sample 已在本地做了双实例隔离处理
第二块触摸屏不是运行 benchmark 的前置条件
- 即使 touch_cst328_1 不存在，display1 的 benchmark 仍可正常运行
请确认双屏硬件连接与板级 pinmux 一致
- 尤其是 SPI0/SPI1、PWM、I2C1 相关引脚
内存占用高于单屏 benchmark
- 双屏同时运行会增加显存与对象内存占用
- 请保留足够 PSRAM 空间，当前配置使用 CONFIG_PSRAM_HEAP_SIZE=0x200000
稳定性验证建议持续观察至少 1 分钟以上
- 重点确认两块屏都能顺利切换场景并完成结果页展示
若第二块屏幕方向或触摸映射不正确
- 请检查 CONFIG_LV_DRIVER_ROTATE_270 与板级接线方向是否匹配