9102_LUA/script

AirUI 演示系统

一、功能模块介绍

1.1 核心主程序模块

1. main.lua - 主程序入口，负责系统初始化和任务调度
2. ui_main.lua - AirUI 主程序，负责页面管理和主循环调度

1.2 硬件驱动模块

1. lcd_drv.lua - LCD 显示驱动模块，基于 lcd 核心库，支持 ST7796 屏幕
2. tp_drv.lua - 触摸面板驱动模块，基于 tp 核心库，支持 GT911 触摸控制器

1.3 演示页面模块

1. home_page.lua - 主页模块，提供所有演示入口
2. all_component_page.lua - 所有组件综合演示页面
3. label_page.lua - 标签组件演示页面
4. button_page.lua - 按钮组件演示页面
5. container_page.lua - 容器组件演示页面
6. bar_page.lua - 进度条组件演示页面
7. switch_page.lua - 开关组件演示页面
8. dropdown_page.lua - 下拉框组件演示页面
9. table_page.lua - 表格组件演示页面
10. input_page.lua - 输入框组件演示页面
11. msgbox_page.lua - 消息框组件演示页面
12. image_page.lua - 图片组件演示页面
13. tabview_page.lua - 选项卡组件演示页面
14. win_page.lua - 窗口组件演示页面
15. switch_page_demo.lua - 页面切换演示
16. hzfont_page.lua - 矢量字体（HZFont）演示页面
17. game_page.lua - 俄罗斯方块游戏演示页面

二、演示效果

主页	选项卡	容器	窗口

下拉框	表格	进度条	输入框

三、演示硬件环境

3.1 实际设备演示说明

• 演示所使用的是 Air8000 开发板
• 其他组件演示，demo 所使用的固件是 LuatOS-SoC_V2024_Air8000_14.soc
• 使用其他型号模块可以参考 docs 文档中对应型号的固件支持功能进行固件选择，按管脚说明进行接线和配置 lcd_drv.lua 和 tp_drv.lua 中的参数，然后进行烧录使用

3.2 硬件清单

• Air8000 开发板 × 1
• AirLCD_1010 触摸配件板 × 1
• TYPE-C 数据线 × 1

3.3 接线配置

• AirLCD_1010 触摸配件板插入到Air8000 开发板 四线SPI屏接口
• Air8000 开发板 4G天线旁拨码开关打到 ON 位置，此时背光正常供电
• Air8000 开发板 侧面供电开关打到 USB供电一端，开发板通过 TYPE-C USB 口供电

3.4 接线图

四、演示软件环境

4.1 开发工具

• Luatools下载调试工具 - 固件烧录和代码调试

4.2 内核固件

• 点击下载Air8000最新版本内核固件，demo所使用的是LuatOS-SoC_V2024_Air8000 14/114号固件

五、演示核心步骤

5.1 硬件准备

1. 将屏幕对准定位点插入
2. Air8000 开发板侧面供电开关打到 USB供电一端
3. 通过 TYPE-C USB 口供电

5.2 软件配置

在 main.lua 中选择要运行的演示模块：

-- 加载显示驱动
lcd_drv = require("lcd_drv")
-- 加载触摸驱动
tp_drv = require("tp_drv")

-- 引入演示模块（每次只选择一个运行）
require("ui_main") --动态更新标签演示

5.3 初始化参数配置

在对应的驱动文件中根据实际硬件调整硬件参数：

• lcd_drv.lua - lcd显示驱动配置、AirUI初始化、hzfont初始化配置
• tp_key_drv.lua - tp触摸驱动配置和初始化，触摸设备绑定AirUI

5.4 软件烧录

1. 使用 Luatools 烧录对应型号的最新内核固件
2. 下载并烧录本项目所有脚本文件
3. 将图片文件随脚本文件一起烧录到脚本分区
4. 设备自动重启后开始运行
5. 点击查看Luatools 下载和详细使用

5.5 功能测试

5.5.1 主页面操作

1. 设备启动后显示主页面，包含所有演示入口卡片
2. 查看系统标题和版本信息
3. 点击各功能卡片进入对应演示页面

5.5.2 组件演示页面

1. 所有组件演示：一次性查看12个AirUI组件
2. 标签组件：测试文本标签和图标标签
3. 按钮组件：体验不同大小和样式的按钮
4. 进度条组件：测试动画进度条和颜色自定义
5. 输入框组件：测试文本输入和键盘弹出
6. 消息框组件：体验多种消息框样式
7. 游戏演示：玩俄罗斯方块游戏，支持触摸控制

5.5.3 字体演示页面

1. 矢量字体页：查看高质量中文矢量字体显示
2. 支持不同字体大小和颜色对比
3. 中英文混合显示测试面

5.6 预期效果

• 系统启动：正常初始化，显示主页面
• 页面切换：流畅的页面过渡效果
• 组件交互：所有 UI 组件响应灵敏
• 字体显示：各字体页面正常显示，动态调整功能正常
• 触摸操作：准确的触摸定位和事件响应

5.7 故障排除

1. 显示异常：检查 LCD 接线，确认对应驱动文件中的硬件参数正确
2. 触摸无响应：检查 I2C 接线，确认触摸芯片型号配置正确
3. 字体显示异常：确认选择的字体驱动与固件匹配
4. 图片无法显示：确认图片文件已正确烧录到指定路径
5. 系统卡顿：调整 ui_main.lua 中的刷新率参数

六、扩展开发

本演示 demo 所有接口都在 AirUI 核心库内有详细说明，如需实现更丰富的自定义功能可按接口说明实现。