示例程序

8 Nov 2024

Read time: 5 minute(s)

LVGL Demo

如需运行 LVGL demo，可在 Luban-Lite 系统 RT-Thread 配置中执行 me 命令打开配置界面，具体步骤如下：

进入Application options > Filesystem related > Using File System Image 0 > Select File System Type (FATFS) > Data Directory，将路径设置为对应的 demo 资源文件所在目录。例如：
- 使用 lvgl_demo_basic_function 时，路径为 packages/artinchip/lvgl-ui/aic_demo/base_demo/lvgl_src/
- 使用 lvgl_demo_meter 时，路径为packages/artinchip/lvgl-ui/aic_demo/meter_demo/lvgl_src/
在 LVGL (official) 选项卡中，设置线程优先级、栈大小和显示刷新周期等参数。
在 ArtInChip lvgl demo 选项卡中，选择要使用的 demo 应用，并设置颜色深度和图像缓存数量。

在 ArtInChip lvgl demo 中，如果选择了不同的 demo 应用，则需要对应调整 Using File System Image 0 中的 Data Directory 路径，否则会导致无法找到资源文件，显示出现白屏。
设置 LVGL Resource Directory 为(/rodata/lvgl_data)。
保存设置并退出配置界面。
编译并烧录程序到开发板。
完成操作后，即可运行所选的 LVGL demo。

配置代码示例如下：

注：每个参数的含义详见LVGL 使用指南。

Application options  --->
*** Filesystem related ***
[*] Using File System Image 0  --->
    --- Using File System Image 0
    Select File System Type (FATFS)  --->
    (packages/artinchip/lvgl-ui/aic_demo/base_demo/lvgl_src/) Data Directory
    (app.fatfs) Image Name
    [*] auto calcuate image size
[ ] Using File System Image 1  ----
*** lvgl demo select related ***
-*- LVGL (official): powerful and easy-to-use embedded GUI library  --->
    (20)  Priority of LVGL thread
    (32768) Stack size of LVGL thread
    (5)   Display refresh period (ms)
    [ ]   Support SquareLine Studio
    [ ]   Enable built-in examples
    [ ]   Enable built-in demos
-*- ArtInChip lvgl demo
    select lvgl demo (lvgl demo with basic function)  --->
        (X) lvgl demo with basic function
        () lvgl demo of meter
    (16)  LVGL color depth(32/16)
    (8)   LVGL image cached number
(/rodata/lvgl_data) LVGL Resource Directory

界面运行示例如下所示：

用户自定义 APP

本节演示添加一个名为 test_demo 的 LVGL 应用，详见LVGL 使用指南中的添加应用。

添加 APP 选项

在 application/Kconfig 中，添加下列代码：

config AIC_LVGL_METER_DEMO
    bool "LVGL demo of meter"
config AIC_LVGL_TEST_DEMO # 添 加 AIC_LVGL_TEST_DEMO， 以 便 在 menuconfig␣菜 单 中 选 择
    bool "LVGL demo of test"
config AIC_LVGL_LAUNCHER_DEMO
    bool "LVGL launcher demo"

配置 APP

使用 me 命令进入配置界面，在 Application options 中选择 AIC_LVGL_TEST_DEMO，并保存配置。

Application options --->
    [*] ArtInChip LVGL demo --->
    select LVGL demo (LVGL demo of test) --->
        ( ) LVGL demo with basic function
        ( ) LVGL demo of meter
        (X) LVGL demo of test
        ( ) LVGL launcher demo

配置素材路径

Application options --->
    [*] Using File System Image 0
        (packages/artinchip/lvgl-ui/aic_demo/test_demo/lvgl_src/) Data Directory 该路径以 SDK 为根目录 ，根据实际情况自行修改
    [*] Using File System Image 1
    (packages/artinchip/lvgl-ui/aic_demo/test_demo/lvgl_src/) Data Directory 该路径以 SDK 为根目录 ，根据实际情况自行修改

源码适配

将源码解压缩至 packages/artinchip/lvgl-ui/aic_demo 目录下，文件结构为：

packages/artinchip/lvgl-ui/aic_demo/aic_demo$ tree -h
.
└── [4.0K]  test_demo
    ├── [4.0K]  lvgl_src
    │   └── [   0]  readme.txt         # 该文件用于验证资源打包，本身为空文件
    ├── [ 571]  SConscript
    ├── [4.0K]  thread
    │   ├── [1.0K]  test_thread.c
    │   └── [ 211]  test_thread.h
    └── [4.0K]  ui
        ├── [1.3K]  test_ui.c
        └── [ 228]  test_ui.h

根据实际项目路径，修改 test_demo 中的 SConscript 文件。

from building import *
import os

cwd = GetCurrentDir()
group = []
src = Glob('*.c')
# 源文件路径
src += Glob('./ui/*.c')
src += Glob('./thread/*.c')

CPPPATH = [cwd]
# 头文件路径
CPPPATH.append(cwd + './ui')
CPPPATH.append(cwd + './thread')

list = os.listdir(cwd)
for d in list:
    path = os.path.join(cwd, d)
    if os.path.isfile(os.path.join(path, 'SConscript')):
        group = group + SConscript(os.path.join(d, 'SConscript'))

# AIC_LVGL_TEST_DEMO 宏需要与 application/Kconfig 中添加的宏一致
group = group + DefineGroup('LVGL-port', src, depend = ['AIC_LVGL_TEST_DEMO'], CPPPATH = CPPPATH)

Return('group')

增加入口函数，接入 UI 功能。

Luban-Lite SDK 中，已经融合了 LVGL-8.3.2，并与 AIC 芯片硬件接口、加速模块、触控等进行了对接，用户仅需接入 UI 部分的功能即可。

在 packages/artinchip/lvgl-ui/aic_ui.c 中，添加以下代码：

注：

Bringup 时不建议调整，使用运行默认程序即可。

void aic_ui_init()
{
#ifdef AIC_LVGL_BASE_DEMO
#include "base_ui.h"
    base_ui_init();
#endif

#ifdef AIC_LVGL_METER_DEMO
#include "meter_ui.h"
    meter_ui_init();
#endif

#ifdef AIC_LVGL_LAUNCHER_DEMO
    extern void launcher_ui_init();
    launcher_ui_init();
#endif

#ifdef AIC_LVGL_MUSIC_DEMO
    extern void lv_demo_music(void);
    lv_demo_music();
#endif

#ifdef AIC_LVGL_TEST_DEMO
    test_thread();
    test_ui_init();
#endif

    return;
}