Forráskód Böngészése

add:新增Air8000系列搭配AirLCD_1010使用lcd核心库开发demo

江访 1 hónapja
szülő
commit
b02689fbe7

BIN
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/font_drv/customer_font_24.bin


+ 16 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/font_drv/customer_font_drv.lua

@@ -0,0 +1,16 @@
+--[[ 
+说明:
+customer_font_drv是用户外部自定义外部点阵字体驱动功能模块,因为不需要进行初始化,所以本文件没有任何实质代码,只在此处描述在项目中如何使用。
+自定义字体制作说明可以参考lcd核心库自定义字体制作说明:https://docs.openluat.com/osapi/core/lcd/#_6
+1、通过链接 https://gitee.com/Dozingfiretruck/u8g2_font_tool 下载字体文件制作工具
+2、制作字体
+   - 将.ttf和.otf格式字体加载到制作工具内
+   - 选择自定义,输入需要生成的字体内容,调用自定义文字显示接口只能显示所输入的内容,其他内容需要切换支持的字体
+   - 选择其他,则会按苏哦选编码格式生成对应的字体
+   - 设置字体大小,生成合宙lcd核心库可加载的.bin格式的字体文件
+3、使用lcd.setFontFile(font)接口设置
+   - 其中font为字体文件路径
+   - 若将生成的字体文件命名为customer_font_24.bin 并通过luatools工具同代码一起烧录到脚本分区,则设置接口为lcd.setFontFile("/luadb/customer_font_24.bin")
+   - 若将生成的字体文件命名为customer_font_24.bin 并通过luatools工具同固件和代码一起烧录到文件系统,则设置接口为lcd.setFontFile("/customer_font_24.bin")
+4、使用lcd.drawStr(x,y,str,fg_color)接口显示具体内容
+]]

+ 50 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/font_drv/gtfont_drv.lua

@@ -0,0 +1,50 @@
+--[[
+@module  gtfont_drv
+@summary GTFont矢量字库驱动模块
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为GTFont矢量字库驱动功能模块,主要功能包括:
+1、初始化AirFONTS_1000矢量字库小板的SPI接口;
+2、配置SPI通信参数和设备对象;
+3、初始化矢量字库核心功能;
+
+
+说明:
+1、gtfont核心库演示demo,是使用gtfont核心库来驱动合宙AirFONTS_1000矢量字库小板
+2、在主程序mian.lua中require "gtfont_drv"即可执行加载本demo内的演示代码
+3、通过使用gtfont_drv.init()对合宙AirFONTS_1000矢量字库小板进行初始化
+4、通过使用 lcd.drawGtfontUtf8Gray(str,size,gray,x,y)接口在lcd屏幕上灰度显示 UTF8 字符串,支持10-192号字体
+]]
+
+--初始化AirFONTS_1000的SPI配置
+--AirFONTS_1000通过SPI接口(SCK CS MOSI MISO)和主控相连
+--主控设备为SPI主设备,AirFONTS_1000为SPI从设备
+
+--spi_id:number类型;
+--     表示主设备的SPI ID;
+--     取值范围:主控产品上有效的SPI ID值,目前合宙模组的硬件SPI的总线ID只有0/1,部分产品内部占用了SPI0接口可优先选择时SPI1;
+
+--spi_cs:number类型;
+--     表示cs引脚的GPIO ID;
+--     取值范围:主控产品上有效的GPIO ID值,实际使用过程中可根据自己的电路设计选择对应的GPIO编号;
+
+--返回值:成功返回true,失败返回false
+local function init()
+    --创建一个SPI设备对象
+    gtfont_spi = spi.deviceSetup(1 , 12, 0, 0, 8, 20*1000*1000, spi.MSB, 1, 0)
+    log.error("AirFONTS_1000.init", "spi.deviceSetup", type(gtfont_spi))
+    --检查SPI设备对象是否创建成功
+    if type(gtfont_spi) ~= "userdata" then
+        log.error("AirFONTS_1000.init", "spi.deviceSetup error", type(gtfont_spi))
+    end
+
+    --初始化矢量字库
+    if not gtfont.init(gtfont_spi) then
+        log.error("gtfont_drv.init", "gtfont_drv.init error")
+    end
+
+end
+
+init()

+ 1 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/font_drv/hzfont_drv.lua

@@ -0,0 +1 @@
+-- hzfont 是合宙开发的一个内置矢量字体库,目前正在开发中

BIN
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/images/logo.jpg


+ 52 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/lcd_drv/exlcd_drv.lua

@@ -0,0 +1,52 @@
+--[[
+@module  exlcd_drv
+@summary 扩展LCD显示驱动模块,基于exlcd扩展库
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为扩展LCD显示驱动功能模块,主要功能包括:
+1、初始化AirLCD_1010扩展LCD显示;
+2、配置显示缓冲区和自动刷新设置;
+
+对外接口:
+1、exlcd_drv.init():初始化扩展LCD显示驱动
+如果需要实现背光亮度调节,参考exlcd扩展库中的exlcd.set_bl(level)进行设置
+]]
+
+local exlcd = require "exlcd"
+
+local exlcd_drv = {}
+
+--[[
+初始化扩展LCD显示驱动;
+
+@api exlcd_drv.init()
+@summary 配置并初始化AirLCD_1010扩展LCD显示
+@return boolean 初始化成功返回true,失败返回false
+
+@usage
+-- 初始化扩展LCD显示
+local result = exlcd_drv.init({})
+if result then
+    log.info("扩展LCD初始化成功")
+else
+    log.error("扩展LCD初始化失败")
+end
+]]
+
+function exlcd_drv.init()
+    local result = exlcd.init({lcd_model = "AirLCD_1010", pin_vcc = 0xFF})
+
+    log.info("exlcd.init", result)
+
+    if result then
+        -- 显示设置
+        lcd.setupBuff(nil, true)
+        lcd.autoFlush(false)
+    end
+
+    return result
+end
+
+return exlcd_drv

+ 80 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/lcd_drv/lcd_drv.lua

@@ -0,0 +1,80 @@
+--[[
+@module  lcd_drv
+@summary LCD显示驱动模块,基于lcd核心库
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为LCD显示驱动功能模块,主要功能包括:
+1、初始化ST7796 LCD控制器;
+2、配置LCD显示参数和显示缓冲区;
+3、支持多种屏幕方向和分辨率设置;
+
+对外接口:
+1、lcd_drv.init():初始化LCD显示驱动
+]]
+
+
+local lcd_drv = {}
+
+--[[
+初始化LCD显示驱动;
+
+@api lcd_drv.init()
+@summary 配置并初始化ST7796 LCD控制器
+@return boolean 初始化成功返回true,失败返回false
+
+@usage
+-- 初始化LCD显示
+local result = lcd_drv.init()
+if result then
+    log.info("LCD初始化成功")
+else
+    log.error("LCD初始化失败")
+end
+]]
+
+function lcd_drv.init()
+    local result = lcd.init("st7796",
+        {
+            pin_rst = 36,                          -- 复位引脚
+            pin_pwr = 1,                           -- 背光控制引脚GPIO的ID号
+            port = lcd.HWID_0,                     -- 驱动端口
+            -- pin_dc = 0xFF,          -- lcd数据/命令选择引脚GPIO ID号,使用lcd 专用 SPI 接口 lcd.HWID_0不需要填此参数,使用通用SPI接口需要赋值
+            direction = 0,                         -- lcd屏幕方向 0:0° 1:90° 2:180° 3:270°,屏幕方向和分辨率保存一致
+            w = 320,                               -- lcd 水平分辨率
+            h = 480,                               -- lcd 竖直分辨率
+            xoffset = 0,                           -- x偏移(不同屏幕ic 不同屏幕方向会有差异)
+            yoffset = 0,                           -- y偏移(不同屏幕ic 不同屏幕方向会有差异)
+            sleepcmd = 0X10,                       -- 睡眠命令,默认0X10
+            wakecmd = 0X11,                        -- 唤醒命令,默认0X11
+            -- bus_speed = 50*1000*1000,                            -- SPI总线速度,不填默认50M,若速率要求更高需要进行设置
+            -- interface_mode = lcd.WIRE_4_BIT_8_INTERFACE_I,       -- lcd模式,默认lcd.WIRE_4_BIT_8_INTERFACE_I
+            -- direction0 = {0x36,0x00},                            -- 0°方向的命令,(不同屏幕ic会有差异)
+            -- direction90 = {0x36,0x60},                           -- 90°方向的命令,(不同屏幕ic会有差异)
+            -- direction180 ={0x36,0xc0} ,                          -- 180°方向的命令,(不同屏幕ic会有差异)
+            -- direction270 = {0x36,0xA0},                          -- 270°方向的命令,(不同屏幕ic会有差异)
+            -- hbp = nil,                                           -- 水平后廊
+            -- hspw = nil,                                          -- 水平同步脉冲宽度
+            -- hfp = 0,                                             -- 水平前廊
+            -- vbp = 0,                                             -- 垂直后廊
+            -- vspw = 0,                                            -- 垂直同步脉冲宽度
+            -- vfp = 0,                                             -- 垂直前廊
+            -- initcmd = nil,                                       -- 自定义屏幕初始化命令表
+            -- flush_rate = nil,                                    -- 刷新率
+            -- spi_dev = nil,                                       -- spi设备,当port = "device"时有效,当port ≠ "device"时可不填或者填nil
+            -- init_in_service = false,                             -- 允许初始化在lcd service里运行,在后台初始化LCD,默认是false,Air8000/G/W/T/A、Air780EHM/EGH/EHV 支持填true,可加快初始化速度,默认SPI总线速度80M
+        })
+
+    log.info("lcd.init", result)
+
+    if result then
+        -- 显示设置
+        lcd.setupBuff(nil, true)
+        lcd.autoFlush(false)
+    end
+
+    return result
+end
+
+return lcd_drv

+ 117 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/main.lua

@@ -0,0 +1,117 @@
+--[[
+@module  main
+@summary LuatOS用户应用脚本文件入口,总体调度应用逻辑
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本demo演示的核心功能为:
+1、LCD显示屏驱动初始化,支持多种LCD驱动模式;
+2、触摸面板驱动初始化,支持多种触摸驱动模式;
+3、字库驱动管理,支持外部矢量字库、内部软件矢量字库和外部自定义点阵字库;
+4、用户界面主循环,实现多页面切换和触摸事件处理;
+5、系统看门狗配置,确保系统稳定运行;
+
+更多说明参考本目录下的readme.md文件
+]]
+
+--[[
+必须定义PROJECT和VERSION变量,Luatools工具会用到这两个变量,远程升级功能也会用到这两个变量
+PROJECT:项目名,ascii string类型
+        可以随便定义,只要不使用,就行
+VERSION:项目版本号,ascii string类型
+        如果使用合宙iot.openluat.com进行远程升级,必须按照"XXX.YYY.ZZZ"三段格式定义:
+            X、Y、Z各表示1位数字,三个X表示的数字可以相同,也可以不同,同理三个Y和三个Z表示的数字也是可以相同,可以不同
+            因为历史原因,YYY这三位数字必须存在,但是没有任何用处,可以一直写为000
+        如果不使用合宙iot.openluat.com进行远程升级,根据自己项目的需求,自定义格式即可
+]]
+
+-- main.lua - 程序入口文件
+
+-- 定义项目名称和版本号
+PROJECT = "ui_demo" -- 项目名称
+VERSION = "001.000.000"    -- 版本号
+
+-- 在日志中打印项目名和项目版本号
+log.info("ui_demo", PROJECT, VERSION)
+
+-- 设置日志输出风格为样式2(建议调试时开启)
+-- log.style(2)
+
+-- 如果内核固件支持wdt看门狗功能,此处对看门狗进行初始化和定时喂狗处理
+-- 如果脚本程序死循环卡死,就会无法及时喂狗,最终会自动重启
+if wdt then
+    --配置喂狗超时时间为9秒钟
+    wdt.init(9000)
+    --启动一个循环定时器,每隔3秒钟喂一次狗
+    sys.timerLoopStart(wdt.feed, 3000)
+end
+
+
+-- 如果内核固件支持errDump功能,此处进行配置,【强烈建议打开此处的注释】
+-- 因为此功能模块可以记录并且上传脚本在运行过程中出现的语法错误或者其他自定义的错误信息,可以初步分析一些设备运行异常的问题
+-- 以下代码是最基本的用法,更复杂的用法可以详细阅读API说明文档
+-- 启动errDump日志存储并且上传功能,600秒上传一次
+-- if errDump then
+--     errDump.config(true, 600)
+-- end
+
+
+-- 使用LuatOS开发的任何一个项目,都强烈建议使用远程升级FOTA功能
+-- 可以使用合宙的iot.openluat.com平台进行远程升级
+-- 也可以使用客户自己搭建的平台进行远程升级
+-- 远程升级的详细用法,可以参考fota的demo进行使用
+
+
+-- 启动一个循环定时器
+-- 每隔3秒钟打印一次总内存,实时的已使用内存,历史最高的已使用内存情况
+-- 方便分析内存使用是否有异常
+-- sys.timerLoopStart(function()
+--     log.info("mem.lua", rtos.meminfo())
+--     log.info("mem.sys", rtos.meminfo("sys"))
+-- end, 3000)
+
+
+-- 加载显示屏驱动管理功能模块,有以下两种:
+-- 1、使用lcd核心库驱动的lcd_drv.lua
+-- 2、使用exlcd扩展库驱动的exlcd_drv.lua
+-- 根据自己的需求,启用两者中的任何一种都可以
+-- 也可以不启用任何一种,不使用显示屏功能
+lcd_drv = require "lcd_drv"
+-- lcd_drv = require "exlcd_drv"
+
+
+-- 加载触摸面板驱动管理功能模块,有以下两种:
+-- 1、使用tp核心库驱动的tp_drv.lua
+-- 2、使用extp扩展库驱动的extp_drv.lua
+-- 根据自己的需求,启用两者中的任何一种都可以
+-- 也可以不启用任何一种,不使用触摸面板功能
+tp_drv = require "tp_drv"
+-- tp_drv = require "extp_drv"
+
+
+-- 加载字库驱动管理功能模块,有以下三种:
+-- 1、使用gtfont核心库驱动AirFONTS_1000矢量字库配件板的gtfont_drv.lua
+-- 2、使用hzfont核心库驱动内核固件中支持的软件矢量字库的hzfont_drv.lua(正在开发中,后续补充)
+-- 3、使用自定义字体
+-- 根据自己的需求,启用三者中的任何几种都可以
+-- 也可以不启用任何一种,只使用内核固件中自带的点阵字库
+require "gtfont_drv"
+-- require "hzfont_drv"
+-- 使用外部自定义字体不需要require "customer_font_drv",可以参照customer_font_drv.lua内的使用说明进行创建和加载字体文件
+
+
+
+-- 加载输入法驱动管理功能模块(正在开发中,后续补充)
+
+
+-- 加载lcd核心库实现的用户界面功能模块
+-- 实现多页面切换、触摸事件分发和界面渲染功能
+-- 包含主页、lcd核心库功能演示页、GTFont演示页和自定义字体演示页
+require "ui_main"
+
+
+-- 用户代码已结束
+-- 结尾总是这一句
+sys.run()
+-- sys.run()之后不要加任何语句!!!!!因为添加的任何语句都不会被执行

+ 250 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/readme.md

@@ -0,0 +1,250 @@
+# LCD、触摸与字体演示系统
+
+## 一、功能模块介绍
+
+### 1.1 核心主程序模块
+
+1. **main.lua** - 主程序入口,负责系统初始化和任务调度
+2. **ui_main.lua** - 用户界面主控模块,管理页面切换和事件分发
+
+### 1.2 显示页面模块
+
+3. **home_page.lua** - 主页模块,提供应用入口和导航功能
+4. **lcd_page.lua** - LCD图形绘制演示模块
+5. **gtfont_page.lua** - GTFont矢量字体演示模块
+6. **customer_font_page.lua** - 自定义字体演示模块
+
+### 1.3 驱动模块
+
+7. **lcd_drv.lua** - LCD显示驱动模块,基于lcd核心库,lcd_drv和exlcd_drv二选一使用
+8. **exlcd_drv.lua** - LCD显示驱动模块,基于exlcd扩展库,lcd_drv和exlcd_drv二选一使用
+9. **tp_drv.lua** - 触摸驱动模块,基于tp核心库,tp_drv和extp_drv二选一使用
+10. **extp_drv.lua** - 触摸驱动模块,基于extp扩展库,tp_drv和extp_drv二选一使用
+11. **gtfont_drv.lua** - GTFont矢量字库驱动模块
+12. **customer_font_drv.lua** - 自定义外部字体驱动功能模块
+13. **hzfont_drv.lua** - 合宙软件矢量字库(开发中)
+    - gtfongt_drv、customer_font_drv、hzfont_drv
+    - 可以都不启用
+    - 可以仅启用一种
+    - 可以启用任意两种
+    - 可以全部启用
+
+## 二、触摸消息介绍
+
+1. **"BASE_TOUCH_EVENT"** - 基础触摸事件消息,包含触摸坐标和事件类型
+   - tp触摸库事件类型:`tp.EVENT_DOWN`(按下)、`tp.EVENT_MOVE`(移动)、`tp.EVENT_UP`(抬起)
+   - extp触摸库事件类型:`SINGLE_TAP`(单击)、`LONG_PRESS`(长按)可根据UI需求打开滑动事件
+   - 坐标范围:X: 0-319,Y: 0-479
+
+## 三、显示效果
+
+<table>
+<tr>
+<td>主页<br/></td><td>lcd核心库页面<br/></td><td>gtfont页面<br/></td><td>自定义字体页面<br/></td></tr>
+<tr>
+<td rowspan="2"><img src="https://docs.openluat.com/cdn/image/Air780EHMLCD演示1.png" width="80" /><br/></td><td rowspan="2"><img src="https://docs.openluat.com/cdn/image/Air780EHMLCD演示2.png" width="80" /><br/></td><td><img src="https://docs.openluat.com/cdn/image/Air780EHMLCD演3.png" width="80" /><br/></td><td rowspan="2"><img src="https://docs.openluat.com/cdn/image/Air780EHMLCD演示5.jpg" width="80" /><br/></td></tr>
+<tr>
+<td><img src="https://docs.openluat.com/cdn/image/Air780EHMLCD演示4.jpg" width="80" /><br/></td></tr>
+</table>
+
+## 四、演示功能概述
+
+### 4.1 LCD图形绘制演示
+
+1. **基本图形绘制** - 展示点、线、矩形、圆形等基本图形绘制功能
+2. **图片显示** - 支持外部图片文件显示
+3. **二维码生成** - 动态生成并显示二维码
+4. **xbm格式位图示例** - 显示16*16 xbm点阵
+5. **中文、英文字体示例** - 显示12号中文字体和英文字体
+
+### 4.2 GTFont矢量字体演示
+
+1. **矢量字体显示** - 使用AirFONTS_1000矢量字库小板显示平滑字体
+2. **字体大小切换** - 支持10-192号字体大小动态变化
+3. **灰度模式** - 支持灰度显示模式,字体边缘更平滑
+4. **多颜色显示** - 支持多种颜色字体显示
+
+### 4.3 自定义字体演示
+
+1. **外部字体加载** - 支持加载外部自定义字体文件
+2. **多颜色文字** - 支持不同颜色的文字显示
+
+### 4.4 触摸交互功能
+
+1. **页面导航** - 支持多页面之间的切换
+2. **按钮响应** - 触摸按钮的点击响应功能
+3. **模式切换** - 支持gtfont切换灰度/常规显示
+
+## 五、演示硬件环境
+
+### 5.1 硬件清单
+
+- Air8000核心板 × 1
+- AirLCD_1010 触摸配件板 × 1
+- GTFont 矢量字库,使用的是 AirFONTS_1000 配件板 × 1
+- 母对母杜邦线 × 17,杜邦线太长的话,会出现 spi 通信不稳定的现象;
+- TYPE-C 数据线 × 1
+- Air8000核心板和 AirLCD_1010 配件板以及 AirFONTS_1000 配件板的硬件接线方式为
+
+  - Air8000核心板通过 TYPE-C USB 口供电(核心板背面的开关拨到 USB ON 一端,正面开关拨到 供电 一端),此种供电方式下,VDD_EXT 和 VBAT 引脚为 3.3V,可以直接给 AirLCD_1010 配件板和 AirFONTS_1000 配件板供电;
+  - 为了演示方便,所以 Air8000核心板上电后直接通过 VBAT 引脚给 AirLCD_1010 配件板供电,通过VDD_EXT引脚给 AirFONTS_1000 配件板供电;
+  - 客户在设计实际项目时,一般来说,需要通过一个 GPIO 来控制 LDO 给配件板供电,这样可以灵活地控制配件板的供电,可以使项目的整体功耗降到最低;
+
+### 5.2 接线配置
+
+#### 5.2.1 LCD 显示屏接线
+
+<table>
+<tr> <td>Air8000核心板</td><td>AirLCD_1010配件板</td></tr>
+<tr> <td>LCD_CLK</td><td>SCLK/CLK</td></tr>
+<tr> <td>LCD_CS</td><td>CS</td></tr>
+<tr> <td>LCD_RST</td><td>RES/RST</td></tr>
+<tr> <td>LCD_SDA</td><td>SDA/MOS</td></tr>
+<tr> <td>LCD_RS</td><td>DC/RS</td></tr>
+<tr> <td>GPIO1</td><td>BLK</td></tr>
+<tr> <td>VBAT</td><td>VCC</td></tr>
+<tr> <td>I2C1_SCL</td><td>SCL</td></tr>
+<tr> <td>I2C1_SDA</td><td>SDA</td></tr>
+<tr> <td>WAKEUP0</td><td>INT</td></tr>
+<tr> <td>GND</td><td>GND</td></tr>
+</table>
+
+#### 5.2.2 GTFont 字库接线
+
+<table>
+<tr> <td>Air8000核心板</td><td>AirFONTS_1000配件板</td></tr>
+<tr> <td>SPI0_CS</td><td>CS</td></tr>
+<tr> <td>SPI0_MISO</td><td>MISO</td></tr>
+<tr> <td>SPI0_MOSI</td><td>MOSI</td></tr>
+<tr> <td>SPI0_CLK</td><td>CLK</td></tr>
+<tr> <td>VDD_EXT</td><td>VCC</td></tr>
+<tr> <td>GND</td><td>GND</td></tr>
+</table>
+
+#### 5.2.3 接线图
+
+![](https://docs.openLuat.com/cdn/image/Air8000核心板_AirLCD_1010_AirFONTS_1000接线图.jpg)
+![](https://docs.openLuat.com/cdn/image/Air8000引脚定义背面图.png)
+
+## 六、演示软件环境
+
+### 6.1 开发工具
+
+- [Luatools下载调试工具](https://docs.openluat.com/air8000/luatos/common/download/) - 固件烧录和代码调试
+
+### 6.2 内核固件
+
+- [点击下载Air8000系列最新版本内核固件](https://docs.openluat.com/air8000/luatos/firmware/),demo所使用的是LuatOS-SoC_V2018_Air8000 1号固件
+  
+
+### 6.3 字体文件
+
+- 自定义字体文件:`customer_font_24.bin`(和lua脚本文件一起烧录,会自动放置在`/luadb/`目录下)
+- 演示图片文件:`logo.jpg`(和lua脚本文件一起烧录,会自动放置在`/luadb/`目录下)
+- [点击查看自定义字体生成和使用说明](https://docs.openluat.com/osapi/core/lcd/?h=lcd#_6)
+
+## 七、演示核心步骤
+
+### 7.1 硬件准备
+
+1. 按照硬件接线表连接所有设备
+2. 确保电源连接正确,通过TYPE-C USB口供电
+3. 检查所有接线无误,避免短路
+
+### 7.2 软件配置
+
+在`main.lua`中选择加载对应的驱动模块:
+
+```lua
+-- 加载显示屏驱动管理功能模块,有以下两种:
+-- 1、使用lcd核心库驱动的lcd_drv.lua
+-- 2、使用exlcd扩展库驱动的exlcd_drv.lua
+-- 根据自己的需求,启用两者中的任何一种都可以
+-- 也可以不启用任何一种,不使用显示屏功能
+lcd_drv = require "lcd_drv"
+-- lcd_drv = require "exlcd_drv"
+
+
+-- 加载触摸面板驱动管理功能模块,有以下两种:
+-- 1、使用tp核心库驱动的tp_drv.lua
+-- 2、使用extp扩展库驱动的extp_drv.lua
+-- 根据自己的需求,启用两者中的任何一种都可以
+-- 也可以不启用任何一种,不使用触摸面板功能
+tp_drv = require "tp_drv"
+-- tp_drv = require "extp_drv"
+
+
+-- 加载字库驱动管理功能模块,有以下三种:
+-- 1、使用gtfont核心库驱动AirFONTS_1000矢量字库配件板的gtfont_drv.lua
+-- 2、使用hzfont核心库驱动内核固件中支持的软件矢量字库的hzfont_drv.lua(正在开发中,后续补充)
+-- 3、使用自定义字体
+-- 根据自己的需求,启用三者中的任何几种都可以
+-- 也可以不启用任何一种,只使用内核固件中自带的点阵字库
+require "gtfont_drv"
+-- require "hzfont_drv"
+-- 使用外部自定义字体不需要require "customer_font_drv",可以参照customer_font_drv.lua内的使用说明进行创建和加载字体文件
+
+
+
+-- 加载输入法驱动管理功能模块(正在开发中,后续补充)
+
+
+-- 加载lcd核心库实现的用户界面功能模块
+-- 实现多页面切换、触摸事件分发和界面渲染功能
+-- 包含主页、lcd核心库功能演示页、GTFont演示页和自定义字体演示页
+require "ui_main"
+```
+
+### 7.3 软件烧录
+
+1. 使用Luatools烧录最新内核固件
+2. 下载并烧录本项目所有脚本文件
+3. 将字体文件和图片文件随脚本文件一起烧录到脚本分区或者单独烧录到文件系统
+4. 设备自动重启后开始运行
+
+### 7.4 功能测试
+
+#### 7.4.1 主页面操作
+
+1. 设备启动后显示主页面,包含三个功能按钮
+2. 查看系统功能概览信息
+3. 点击各功能按钮进入对应演示页面
+
+#### 7.4.2 LCD演示页面
+
+1. 查看基本图形绘制示例(点、线、矩形、圆形)
+2. 查看图片显示区域(显示logo图片)
+3. 查看二维码区域(合宙文档二维码)
+4. 查看位图和字体示例
+5. 点击"返回"按钮回到主页
+
+#### 7.4.3 GTFont演示页面
+
+1. 计时阶段,gtfont说明显示
+2. 字体大小变化阶段,查看10-192号字体动态变化
+3. 点击"灰度/常规"切换按钮,体验不同显示模式
+4. 查看多颜色字体显示效果
+5. 点击"返回"按钮回到主页
+
+#### 7.4.4 自定义字体页面
+
+1. 查看外部字体文件显示效果
+2. 查看多颜色文字显示(红色、绿色、蓝色)
+3. 查看字体使用说明和接口信息
+4. 点击"返回"按钮回到主页
+
+### 7.5 预期效果
+
+- **主页面**:正常显示,三个功能按钮响应灵敏
+- **LCD演示页面**:图形绘制清晰,图片和二维码显示正常,颜色示例完整
+- **GTFont演示页面**:字体显示平滑,字号切换流畅,灰度模式切换正常
+- **自定义字体页面**:外部字体加载正确,多颜色文字显示正常
+- **触摸交互**:所有触摸操作响应及时准确,页面切换流畅
+
+### 7.6 故障排除
+
+1. **显示异常**:检查LCD接线是否正确,确认电源供电稳定
+2. **触摸无响应**:检查I2C接线,确认触摸芯片初始化成功
+3. **字体显示异常**:检查SPI接线(如使用GTFont),确认字体文件路径正确
+4. **图片无法显示**:确认图片文件已正确烧录到指定路径
+5. **系统卡顿**:检查内存使用情况,适当调整刷新频率

+ 60 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/tp_key_drv/extp_drv.lua

@@ -0,0 +1,60 @@
+--[[
+@module  extp_drv
+@summary 扩展触摸面板驱动模块,基于extp扩展库
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为扩展触摸面板驱动功能模块,主要功能包括:
+1、初始化AirLCD_1010扩展触摸面板;
+2、配置I2C通信接口和触摸参数;
+3、发布触摸事件消息供UI系统处理;
+
+说明:
+成功执行extp_drv.init()之后,在触摸面板上有触摸动作时,在extp扩展库内,默认会发布以下消息:
+1、sys.publish("BASE_TOUCH_EVENT", "SINGLE_TAP", x, y) --单击消息,x和y表示坐标
+2、sys.publish("BASE_TOUCH_EVENT", "LONG_PRESS", x, y) --长按消息,x和y表示坐标
+如果需要发布上下左右滑动、移动、原始数据几种消息,参考extp扩展库中的extp.set_publish_enabled(msg_type, enabled)进行设置
+
+对外接口:
+1、extp_drv.init():初始化扩展触摸面板驱动
+]]
+
+local extp = require "extp"
+
+local extp_drv = {}
+
+--[[
+初始化扩展触摸面板驱动;
+
+@api extp_drv.init()
+@summary 配置并初始化AirLCD_1010扩展触摸面板
+@return boolean 初始化成功返回true,失败返回false
+
+@usage
+-- 初始化扩展触摸面板
+local result = extp_drv.init()
+if result then
+    log.info("扩展触摸面板初始化成功")
+else
+    log.error("扩展触摸面板初始化失败")
+end
+]]
+
+function extp_drv.init()
+    -- 初始化I2C
+    local result = i2c.setup(1, i2c.SLOW)
+
+    if result==0 then
+        log.error("extp_drv.init i2c.setup error")
+        return false
+    end
+
+    result = extp.init({tp_model = "AirLCD_1010", i2c_id = 1, pin_rst = 0xFF, pin_int = gpio.WAKEUP0, w = 320, h = 480})
+
+    log.info("extp.init", result)
+
+    return result
+end
+
+return extp_drv

+ 69 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/tp_key_drv/tp_drv.lua

@@ -0,0 +1,69 @@
+--[[
+@module  tp_drv
+@summary 触摸面板驱动模块,基于tp核心库
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为触摸面板驱动功能模块,主要功能包括:
+1、初始化GT911触摸控制器;
+2、配置I2C通信接口和触摸回调函数;
+3、发布触摸事件消息供UI系统处理;
+
+对外接口:
+1、tp_drv.init():初始化触摸面板驱动
+]]
+
+local tp_drv = {}
+
+--[[
+触摸事件回调函数;
+
+@local
+@function tp_callback(tp_device, tp_data)
+@userdata tp_device 触摸设备对象
+@table tp_data 触摸数据数组
+@return nil
+]]
+
+local function tp_callback(tp_device, tp_data)
+    if tp_data[1].event == tp.EVENT_DOWN then
+        -- log.info("tp_drv tp_callback", tp_data[1].event, tp_data[1].x, tp_data[1].y)
+        sys.publish("BASE_TOUCH_EVENT", tp_data[1].event, tp_data[1].x, tp_data[1].y)
+    end
+end
+
+--[[
+初始化触摸面板驱动;
+
+@api tp_drv.init()
+@summary 配置并初始化GT911触摸控制器
+@return boolean 初始化成功返回true,失败返回false
+
+@usage
+-- 初始化触摸面板
+local result = tp_drv.init()
+if result then
+    log.info("触摸面板初始化成功")
+else
+    log.error("触摸面板初始化失败")
+end
+]]
+
+function tp_drv.init()
+    -- 初始化I2C
+    local result = i2c.setup(1, i2c.SLOW)
+
+    if result==0 then
+        log.error("tp_drv.init i2c.setup error")
+        return false
+    end
+
+    result = tp.init("gt911", {port = 1, pin_rst = 0xFF, pin_int = gpio.WAKEUP0, w = 320, h = 480}, tp_callback)
+
+    log.info("tp.init", result)
+
+    return result
+end
+
+return tp_drv

+ 99 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/ui/customer_font_page.lua

@@ -0,0 +1,99 @@
+--[[
+@module  customer_font_page
+@summary 自定义字体演示模块
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为自定义字体演示功能模块,主要功能包括:
+1、展示外部自定义字体文件的使用方法;
+2、演示不同颜色的字体显示效果;
+3、提供字体文件路径和使用接口说明;
+4、支持页面离开时恢复系统默认字体;
+
+对外接口:
+1、customer_font_page.draw():绘制自定义字体演示页面
+2、customer_font_page.handle_touch():处理自定义字体页面触摸事件
+3、customer_font_page.on_leave():页面离开时恢复系统字体
+]]
+
+local customer_font_page = {}
+
+-- 按钮区域定义
+local back_button = { x1 = 10, y1 = 10, x2 = 80, y2 = 50 }
+
+
+--[[
+绘制自定义字体演示页面;
+
+@api customer_font_page.draw()
+@summary 绘制自定义字体演示页面的所有UI元素和字体内容
+@return nil
+]]
+function customer_font_page.draw()
+    lcd.clear()
+    lcd.setFont(lcd.font_opposansm12_chinese)
+
+    -- 绘制返回按钮
+    lcd.fill(back_button.x1, back_button.y1, back_button.x2, back_button.y2, 0xC618)
+    lcd.setColor(0x07E0, 0x0000)
+    lcd.drawStr(35, 35, "返回", 0x0000)
+
+    -- 设置默认颜色
+    lcd.setColor(0xFFFF, 0x0000)
+
+    -- 显示标题(使用系统字体)
+    lcd.drawStr(106, 20 + 12, "自定义点阵字体演示", 0x0000)
+
+    -- 设置自定义字体文件
+    lcd.setFontFile("/luadb/customer_font_24.bin")
+
+    lcd.drawStr(112, 206, "上海合宙", 0xF800) -- 红色
+    lcd.drawStr(120, 240, "LuatOS", 0x07E0) -- 绿色
+    lcd.drawStr(100, 274, "演示demo", 0x001F) -- 蓝色
+
+    -- 恢复系统字体显示说明
+    lcd.setFont(lcd.font_opposansm12_chinese)
+    lcd.setColor(0xFFFF, 0x0000)
+
+    -- 显示说明信息
+    lcd.drawStr(20, 410, "- 字体路径: /luadb/customer_font_24.bin", 0x0000)
+    -- 显示使用说明
+    lcd.drawStr(20, 430, "使用接口:", 0x0000)
+    lcd.drawStr(20, 450, "lcd.setFontFile(字体路径)", 0x0000)
+    lcd.drawStr(20, 470, "lcd.drawStr(x, y,文本)", 0x0000)
+end
+
+--[[
+处理自定义字体页面触摸事件;
+
+@api customer_font_page.handle_touch(x, y, switch_page)
+@number x 触摸点X坐标,范围0-319
+@number y 触摸点Y坐标,范围0-479
+@function switch_page 页面切换回调函数
+@return boolean 事件处理成功返回true,否则返回false
+]]
+function customer_font_page.handle_touch(x, y, switch_page)
+    -- 检查返回按钮
+    if x >= back_button.x1 and x <= back_button.x2 and
+        y >= back_button.y1 and y <= back_button.y2 then
+        switch_page("home")
+        return true
+    end
+
+    return false
+end
+
+--[[
+页面离开时恢复系统字体;
+
+@api customer_font_page.on_leave()
+@summary 恢复系统默认字体设置
+@return nil
+]]
+function customer_font_page.on_leave()
+    -- 恢复使用12号中文字体
+    lcd.setFont(lcd.font_opposansm12_chinese)
+end
+
+return customer_font_page

+ 332 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/ui/gtfont_page.lua

@@ -0,0 +1,332 @@
+--[[
+@module  gtfont_page
+@summary GTFont矢量字体演示模块
+@version 1.1
+@date    2025.12.2
+@author  江访
+@usage
+本模块为GTFont矢量字体演示功能模块,主要功能包括:
+1、展示AirFONTS_1000矢量字库小板的字体显示功能;
+2、支持10-192号字体大小动态变化演示;
+3、支持灰度模式和常规模式切换;
+4、提供倒计时和字体大小变化两种演示阶段;
+
+对外接口:
+1、gtfont_page.draw():绘制GTFont演示页面
+2、gtfont_page.handle_touch():处理GTFont页面触摸事件
+3、gtfont_page.on_enter():页面进入时状态重置
+]]
+local gtfont_page = {}
+
+-- 按钮区域定义
+local back_button = { x1 = 10, y1 = 10, x2 = 80, y2 = 50 }
+local switch_button = { x1 = 220, y1 = 10, x2 = 310, y2 = 50 }
+
+-- 字体显示状态
+local font_demo_state = {
+    use_gray = true,                   -- 默认为灰度模式
+    demo_phase = 1,                    -- 演示阶段
+    last_update = 0,
+    update_interval = 1000,            -- 倒计时更新间隔
+    font_update_interval = 20,         -- 字体更新间隔
+    countdown = 18,                     -- 倒计时
+    current_size = 16,                 -- 当前字体大小
+    color_phase = 1,                   -- 颜色阶段
+}
+
+--[[
+绘制开关按钮
+@local
+@return nil
+]]
+local function draw_switch_button()
+    -- 按钮背景
+    lcd.fill(switch_button.x1, switch_button.y1, switch_button.x2, switch_button.y2, 0xC618)
+
+    -- 开关指示器
+    if font_demo_state.use_gray then
+        -- 灰度模式,左边填充
+        lcd.fill(switch_button.x1, switch_button.y1,
+            switch_button.x1 + (switch_button.x2 - switch_button.x1) / 2,
+            switch_button.y2, 0x07E0)
+    else
+        -- 常规模式,右边填充
+        lcd.fill(switch_button.x1 + (switch_button.x2 - switch_button.x1) / 2,
+            switch_button.y1, switch_button.x2, switch_button.y2, 0x07E0)
+    end
+
+    -- 按钮文字
+    lcd.setColor(0xFFFF, 0x0000)
+    lcd.setFont(lcd.font_opposansm12_chinese)
+    lcd.drawStr(switch_button.x1 + 10, switch_button.y1 + 25, "灰度", 0x0000)
+    lcd.drawStr(switch_button.x1 + (switch_button.x2 - switch_button.x1) / 2 + 10,
+        switch_button.y1 + 25, "常规", 0x0000)
+end
+
+--[[
+绘制返回按钮
+@local
+@return nil
+]]
+local function draw_back_button()
+    lcd.fill(back_button.x1, back_button.y1, back_button.x2, back_button.y2, 0xC618)
+    lcd.setColor(0xFFFF, 0x0000)
+    lcd.setFont(lcd.font_opposansm12_chinese)
+    lcd.drawStr(back_button.x1 + 25, back_button.y1 + 25, "返回", 0x0000)
+end
+
+--[[
+绘制倒计时阶段
+@local
+@return boolean 是否完成倒计时
+]]
+local function draw_countdown_phase()
+    local _, current_time = mcu.ticks2(1)
+    
+    if current_time - font_demo_state.last_update > font_demo_state.update_interval then
+        font_demo_state.countdown = font_demo_state.countdown - 1
+        font_demo_state.last_update = current_time
+        
+        if font_demo_state.countdown <= 0 then
+            font_demo_state.demo_phase = 2
+            font_demo_state.current_size = 16
+            font_demo_state.color_phase = 1
+            font_demo_state.last_update = current_time
+            return true
+        end
+    end
+    
+    -- 设置背景色为白色,文字的前景色为黑色
+    lcd.setColor(0xFFFF, 0x0000)
+    if font_demo_state.use_gray then
+        lcd.drawGtfontUtf8Gray("AirFONTS_1000配件板", 24, 2, 50, 70)
+    else
+        lcd.drawGtfontUtf8("AirFONTS_1000配件板", 24, 50, 70)
+    end
+
+    -- 设置背景色为白色,文字的前景色为红色
+    lcd.setColor(0xFFFF, 0xF800)
+    if font_demo_state.use_gray then
+        lcd.drawGtfontUtf8Gray("支持10到192号的黑体字体", 24, 2, 40, 111)
+    else
+        lcd.drawGtfontUtf8("支持10到192号的黑体字体", 24, 40, 111)
+    end
+
+    -- 设置背景色为白色,文字的前景色为绿色
+    lcd.setColor(0xFFFF, 0x07E0)
+    if font_demo_state.use_gray then
+        lcd.drawGtfontUtf8Gray("支持GBK中文和ASCII码字符集", 20, 2, 35, 152)
+    else
+        lcd.drawGtfontUtf8("支持GBK中文和ASCII码字符集", 20, 35, 152)
+    end
+
+    -- 设置背景色为白色,文字的前景色为蓝色
+    lcd.setColor(0xFFFF, 0x001F)
+    if font_demo_state.use_gray then
+        lcd.drawGtfontUtf8Gray("支持灰度显示,字体边缘更平滑", 20, 2, 35, 193)
+    else
+        lcd.drawGtfontUtf8("支持灰度显示,字体边缘更平滑", 20, 35, 193)
+    end
+
+    -- 倒计时
+    lcd.setColor(0xFFFF, 0x0000)
+    if font_demo_state.use_gray then
+        lcd.drawGtfontUtf8Gray("倒计时 : " .. font_demo_state.countdown, 24, 2, 100, 233)
+    else
+        lcd.drawGtfontUtf8("倒计时 : " .. font_demo_state.countdown, 24, 100, 233)
+    end
+    
+    return false
+end
+
+--[[
+绘制字体大小变化阶段
+@local
+@return boolean 是否完成所有阶段
+]]
+local function draw_font_size_phase()
+    local _, current_time = mcu.ticks2(1)
+    
+    if current_time - font_demo_state.last_update > font_demo_state.font_update_interval then
+        font_demo_state.current_size = font_demo_state.current_size + 1
+        font_demo_state.last_update = current_time
+    end
+    
+    -- 根据颜色阶段设置颜色
+    if font_demo_state.color_phase == 1 then
+        lcd.setColor(0xFFFF, 0x0000) -- 黑色
+    elseif font_demo_state.color_phase == 2 then
+        lcd.setColor(0xFFFF, 0xF800) -- 红色
+    elseif font_demo_state.color_phase == 3 then
+        lcd.setColor(0xFFFF, 0x07E0) -- 绿色
+    else
+        lcd.setColor(0xFFFF, 0x001F) -- 蓝色
+    end
+    
+    -- 根据颜色阶段和字体大小显示不同内容
+    if font_demo_state.color_phase == 1 then
+        if font_demo_state.current_size <= 64 then
+            if font_demo_state.use_gray then
+                lcd.drawGtfontUtf8Gray(font_demo_state.current_size .. "号:合宙AirFONTS_1000", 
+                                      font_demo_state.current_size, 4, 10, 100)
+            else
+                lcd.drawGtfontUtf8(font_demo_state.current_size .. "号:合宙AirFONTS_1000", 
+                                  font_demo_state.current_size, 10, 100)
+            end
+        else
+            font_demo_state.color_phase = 2
+            font_demo_state.current_size = 65
+        end
+    elseif font_demo_state.color_phase == 2 then
+        if font_demo_state.current_size <= 96 then
+            if font_demo_state.use_gray then
+                lcd.drawGtfontUtf8Gray(font_demo_state.current_size .. "号", 
+                                      font_demo_state.current_size, 4, 10, 100)
+                lcd.drawGtfontUtf8Gray("AirFONTS_1000", 
+                                      font_demo_state.current_size, 4, 10, 100 + font_demo_state.current_size + 5)
+            else
+                lcd.drawGtfontUtf8(font_demo_state.current_size .. "号", 
+                                  font_demo_state.current_size, 10, 100)
+                lcd.drawGtfontUtf8("AirFONTS_1000", 
+                                  font_demo_state.current_size, 10, 100 + font_demo_state.current_size + 5)
+            end
+        else
+            font_demo_state.color_phase = 3
+            font_demo_state.current_size = 97
+        end
+    elseif font_demo_state.color_phase == 3 then
+        if font_demo_state.current_size <= 128 then
+            if font_demo_state.use_gray then
+                lcd.drawGtfontUtf8Gray(font_demo_state.current_size .. "号", 
+                                      font_demo_state.current_size, 4, 10, 50)
+                lcd.drawGtfontUtf8Gray("合宙", 
+                                      font_demo_state.current_size, 4, 10, 50 + font_demo_state.current_size + 5)
+            else
+                lcd.drawGtfontUtf8(font_demo_state.current_size .. "号", 
+                                  font_demo_state.current_size, 10, 50)
+                lcd.drawGtfontUtf8("合宙", 
+                                  font_demo_state.current_size, 10, 50 + font_demo_state.current_size + 5)
+            end
+        else
+            font_demo_state.color_phase = 4
+            font_demo_state.current_size = 129
+        end
+    else
+        if font_demo_state.current_size <= 192 then
+            -- 矢量字体大小目前不能到180号,常规字体可到192号
+            -- if font_demo_state.use_gray then
+            --     lcd.drawGtfontUtf8Gray(font_demo_state.current_size .. "号", 
+            --                           font_demo_state.current_size, 4, 10, 50)
+            --     lcd.drawGtfontUtf8Gray("合宙", 
+            --                           font_demo_state.current_size, 4, 10, 50 + font_demo_state.current_size + 5)
+            -- else
+                lcd.drawGtfontUtf8(font_demo_state.current_size .. "号", 
+                                  font_demo_state.current_size, 10, 50)
+                lcd.drawGtfontUtf8("合宙", 
+                                  font_demo_state.current_size, 10, 50 + font_demo_state.current_size + 5)
+            -- end
+        else
+            -- 所有阶段完成,重置
+            font_demo_state.demo_phase = 1
+            font_demo_state.countdown = 5
+            font_demo_state.color_phase = 1
+            font_demo_state.current_size = 16
+            return true
+        end
+    end
+    
+    return false
+end
+
+--[[
+绘制字体演示内容
+@local
+@return nil
+]]
+local function draw_font_demo()
+    -- 根据演示阶段调用不同的绘制函数
+    if font_demo_state.demo_phase == 1 then
+        draw_countdown_phase()
+    else
+        draw_font_size_phase()
+    end
+end
+
+--[[
+绘制GTFont演示页面;
+
+@api gtfont_page.draw()
+@summary 绘制GTFont演示页面的所有UI元素和字体演示内容
+@return nil
+]]
+function gtfont_page.draw()
+    lcd.clear()
+    -- 绘制按钮区域
+    draw_back_button()
+    draw_switch_button()
+
+    -- 绘制字体演示内容
+    draw_font_demo()
+
+    lcd.flush()
+end
+
+--[[
+处理GTFont页面触摸事件;
+
+@api gtfont_page.handle_touch(x, y, switch_page)
+@number x 触摸点X坐标,范围0-319
+@number y 触摸点Y坐标,范围0-479
+@function switch_page 页面切换回调函数
+@return boolean 事件处理成功返回true,否则返回false
+]]
+function gtfont_page.handle_touch(x, y, switch_page)
+    -- 检查返回按钮
+    if x >= back_button.x1 and x <= back_button.x2 and
+        y >= back_button.y1 and y <= back_button.y2 then
+        switch_page("home")
+        return true
+    end
+
+    -- 检查切换按钮
+    if x >= switch_button.x1 and x <= switch_button.x2 and
+        y >= switch_button.y1 and y <= switch_button.y2 then
+        font_demo_state.use_gray = not font_demo_state.use_gray
+        return true
+    end
+
+    return false
+end
+
+--[[
+页面进入时重置状态;
+
+@api gtfont_page.on_enter()
+@summary 重置字体演示状态到初始值
+@return nil
+]]
+function gtfont_page.on_enter()
+    font_demo_state.use_gray = true -- 默认灰度模式
+    font_demo_state.demo_phase = 1
+    font_demo_state.countdown = 18
+    font_demo_state.current_size = 16
+    font_demo_state.color_phase = 1
+    local _, ms_l = mcu.ticks2(1)
+    font_demo_state.last_update = ms_l
+    frame_time = 20 -- 进入时改成20ms刷新一次
+end
+
+
+--[[
+页面离开时恢复系统刷新率;
+
+@api gtfont_page.on_leave()
+@summary 恢复刷新率
+@return nil
+]]
+function gtfont_page.on_leave()
+    -- 恢复恢复20S刷新一次
+    frame_time = 20*1000
+end
+
+return gtfont_page

+ 109 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/ui/home_page.lua

@@ -0,0 +1,109 @@
+--[[
+@module  home_page
+@summary 主页模块,提供应用入口和导航功能
+@version 1.1
+@date    2025.12.2
+@author  江访
+@usage
+本模块为主页面功能模块,主要功能包括:
+1、绘制主页面UI界面,显示应用标题和功能介绍;
+2、提供三个功能按钮:LCD演示、矢量字体演示、自定义字体演示;
+3、处理主页面的触摸事件,实现页面导航;
+
+对外接口:
+1、home_page.draw():绘制主页界面
+2、home_page.handle_touch():处理主页触摸事件
+]]
+
+local home_page = {}
+
+-- 屏幕尺寸
+local width, height
+
+local center_x
+
+-- 按钮区域定义
+local buttons = {
+    lcd_page = { x1 = 10, y1 = 350, x2 = 100, y2 = 420 },
+    gtfont_page = { x1 = 115, y1 = 350, x2 = 205, y2 = 420 },
+    customer_font_page = { x1 = 220, y1 = 350, x2 = 310, y2 = 420 }
+}
+
+local title = "合宙lcd演示系统"
+local content1 = "本页面使用的是系统内置的12号中文点阵字体"
+
+
+--[[
+绘制主页界面;
+
+@api home_page.draw()
+@summary 绘制主页面所有UI元素
+@return nil
+]]
+function home_page.draw()
+    lcd.clear()
+    lcd.setColor(0xFFFF, 0x0000)
+    lcd.setFont(lcd.font_opposansm12_chinese)
+
+    -- 显示标题
+    -- 后续V2020版本以上支持lcd核心库的固件会新增lcd.getStrWidth(title)接口获取文本宽度,对齐、居中、换行可使用
+    -- width, height = lcd.getSize()
+    -- center_x = width / 2
+    -- lcd.drawStr(center_x - lcd.getStrWidth(title) / 2, 50, title, 0x0000) -- 自动居中
+    lcd.drawStr(106, 50, title, 0x0000)
+
+    -- 显示说明文字
+    lcd.drawStr(46, 68, content1, 0x0000)
+
+    -- 绘制LCD演示按钮
+    lcd.fill(buttons.lcd_page.x1, buttons.lcd_page.y1,
+        buttons.lcd_page.x2, buttons.lcd_page.y2, 0x001F)
+    lcd.drawStr(15, 390, "lcd核心库演示", 0xFFFF)
+
+    -- 绘制GTFont演示按钮
+    lcd.fill(buttons.gtfont_page.x1, buttons.gtfont_page.y1,
+        buttons.gtfont_page.x2, buttons.gtfont_page.y2, 0xF800)
+    lcd.drawStr(148, 380, "外部", 0xFFFF)
+    lcd.drawStr(124, 400, "矢量字体芯片", 0xFFFF)
+
+    -- 绘制自定义字体演示按钮
+    lcd.fill(buttons.customer_font_page.x1, buttons.customer_font_page.y1,
+        buttons.customer_font_page.x2, buttons.customer_font_page.y2, 0x07E0)
+    lcd.drawStr(235, 390, "自定义字体", 0xFFFF)
+end
+
+--[[
+处理主页触摸事件;
+
+@api home_page.handle_touch(x, y, switch_page)
+@number x 触摸点X坐标,范围0-319
+@number y 触摸点Y坐标,范围0-479
+@function switch_page 页面切换回调函数
+@return boolean 事件处理成功返回true,否则返回false
+]]
+function home_page.handle_touch(x, y, switch_page)
+    -- 检查LCD演示按钮
+    if x >= buttons.lcd_page.x1 and x <= buttons.lcd_page.x2 and
+        y >= buttons.lcd_page.y1 and y <= buttons.lcd_page.y2 then
+        switch_page("lcd")
+        return true
+    end
+
+    -- 检查GTFont演示按钮
+    if x >= buttons.gtfont_page.x1 and x <= buttons.gtfont_page.x2 and
+        y >= buttons.gtfont_page.y1 and y <= buttons.gtfont_page.y2 then
+        switch_page("gtfont")
+        return true
+    end
+
+    -- 检查自定义字体演示按钮
+    if x >= buttons.customer_font_page.x1 and x <= buttons.customer_font_page.x2 and
+        y >= buttons.customer_font_page.y1 and y <= buttons.customer_font_page.y2 then
+        switch_page("customer_font_page")
+        return true
+    end
+
+    return false
+end
+
+return home_page

+ 159 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/ui/lcd_page.lua

@@ -0,0 +1,159 @@
+--[[
+@module  lcd_page
+@summary LCD图形绘制演示模块
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为LCD图形绘制演示功能模块,主要功能包括:
+1、展示LCD核心库的基本图形绘制功能;
+2、演示点、线、矩形、圆形等基本图形绘制;
+3、显示图片和二维码生成功能;
+4、提供颜色示例展示;
+
+对外接口:
+1、lcd_page.draw():绘制LCD演示页面
+2、lcd_page.handle_touch():处理LCD页面触摸事件
+]]
+local lcd_page = {}
+
+-- 按钮区域定义
+local back_button = { x1 = 10, y1 = 10, x2 = 80, y2 = 50 }
+
+--[[
+绘制LCD演示页面;
+
+@api lcd_page.draw()
+@summary 绘制LCD演示页面的所有图形和UI元素
+@return nil
+]]
+function lcd_page.draw()
+    lcd.clear()
+    lcd.setFont(lcd.font_opposansm12_chinese)
+
+    -- 绘制返回按钮
+    lcd.fill(back_button.x1, back_button.y1, back_button.x2, back_button.y2, 0xC618)
+    lcd.setColor(0x07E0, 0x0000)
+    lcd.drawStr(35, 35, "返回", 0x0000)
+    -- 设置默认颜色
+    lcd.setColor(0xFFFF, 0x0000)
+
+    -- 显示标题
+    lcd.drawStr(120, 33, "LCD核心库演示", 0x0000)
+    lcd.drawLine(20, 55, 300, 55, 0x8410)
+
+    -- === 第一区域:基本图形 ===
+    lcd.drawStr(20, 75, "基本图形绘制:", 0x0000)
+
+    -- 绘制点
+    lcd.drawStr(30, 98, "点:", 0x0000)
+    lcd.drawPoint(55, 98, 0xFCC0)
+    lcd.drawPoint(65, 98, 0x07E0)
+    lcd.drawPoint(75, 98, 0x001F)
+
+    -- 绘制线
+    lcd.drawStr(30, 125, "线:", 0x0000)
+    lcd.drawLine(55, 113, 115, 113, 0xFCC0)
+    lcd.drawLine(55, 118, 115, 123, 0x07E0)
+    lcd.drawLine(55, 123, 115, 118, 0x001F)
+
+    -- 绘制矩形(预留右侧空间)
+    lcd.drawStr(30, 160, "矩形:", 0x0000)
+    lcd.drawRectangle(65, 138, 105, 163, 0x7296)
+    lcd.fill(120, 138, 160, 163, 0x07E0)
+
+    -- 绘制圆(预留右侧空间)
+    lcd.drawStr(30, 200, "圆形:", 0x0000)
+    lcd.drawCircle(90, 193, 15, 0x001F)
+    lcd.drawCircle(130, 193, 15, 0xFCC0)
+
+    lcd.drawLine(170, 70, 170, 300, 0x8410) -- 垂直分隔线
+
+    -- === 第二区域:图片和二维码 ===
+    lcd.drawStr(180, 75, "图片/二维码:", 0x0000)
+
+    -- 图片显示区域 (80x80)
+    lcd.drawStr(180, 100, "LOGO:", 0x0000)
+    lcd.drawRectangle(180, 110, 270, 200, 0x0000) 
+    lcd.showImage(185, 115, "/luadb/logo.jpg")  
+
+    -- 二维码区域 (80x80)
+    lcd.drawStr(180, 215, "二维码:", 0x0000)
+    lcd.drawRectangle(180, 225, 270, 308, 0x0000)
+    lcd.drawQrcode(185, 226, "https://docs.openluat.com/air8000/", 80)
+
+    lcd.drawLine(20, 325, 300, 325, 0x8410)
+
+    -- === 第三区域:位图 ===
+    lcd.drawLine(20, 235, 160, 235, 0x8410)
+
+    -- 位图区域
+    lcd.setFont(lcd.font_opposansm12_chinese)
+    lcd.drawStr(20, 255, "位图示例:", 0x0000)
+
+    -- 绘制位图
+    local x_start = 30
+    local y_start = 265
+    lcd.drawXbm(x_start, y_start, 16, 16, string.char(
+        0x00, 0x00, 0x80, 0x00, 0x80, 0x00, 0x80, 0x00, 0x80, 0x00, 0x80, 0x00, 0x80, 0x3F, 0x80, 0x00,
+        0x80, 0x00, 0x80, 0x00, 0x80, 0x00, 0x80, 0x00, 0x80, 0x00, 0x80, 0x00, 0xFE, 0x7F, 0x00, 0x00))
+
+    lcd.drawXbm(x_start + 20, y_start, 16, 16, string.char(
+        0x00, 0x00, 0x80, 0x00, 0xC4, 0x7F, 0x28, 0x00, 0x10, 0x00, 0xD0, 0x3F, 0x42, 0x20, 0x44, 0x22,
+        0x40, 0x24, 0xF0, 0xFF, 0x24, 0x20, 0x24, 0x22, 0x24, 0x20, 0xE2, 0x7F, 0x02, 0x20, 0x02, 0x1E))
+
+    lcd.drawXbm(x_start, y_start + 20, 16, 16, string.char(
+        0x00, 0x00, 0x00, 0x01, 0x80, 0x01, 0x40, 0x02, 0x20, 0x04, 0x18, 0x18, 0xF4, 0x6F, 0x02, 0x00,
+        0x00, 0x00, 0xF8, 0x1F, 0x08, 0x10, 0x08, 0x10, 0x08, 0x10, 0x08, 0x10, 0xF8, 0x1F, 0x08, 0x10))
+
+    lcd.drawXbm(x_start + 20, y_start + 20, 16, 16, string.char(
+        0x00, 0x00, 0x80, 0x00, 0x00, 0x01, 0xFE, 0x7F, 0x02, 0x40, 0x02, 0x40, 0x00, 0x01, 0xFC, 0x3F,
+        0x04, 0x21, 0x04, 0x21, 0xFC, 0x3F, 0x04, 0x21, 0x04, 0x21, 0x04, 0x21, 0xFC, 0x3F, 0x04, 0x20))
+
+    -- === 第四区域:字体 ===
+    lcd.drawStr(20, 345, "中英文字体示例:", 0x0000)
+
+    -- 中文字体
+    lcd.setFont(lcd.font_opposansm12_chinese)
+    lcd.drawStr(20, 368, "中文字体ABC123", 0x0000)
+
+    -- 英文字体
+    local font_y = 388
+    lcd.setFont(lcd.font_opposansm12)
+    lcd.drawStr(20, font_y, "12px: ABCabc123", 0x0000)
+    font_y = font_y + 18
+
+    lcd.setFont(lcd.font_opposansm16)
+    lcd.drawStr(20, font_y, "16px: ABCabc123", 0x0000)
+    font_y = font_y + 22
+
+    lcd.setFont(lcd.font_opposansm20)
+    lcd.drawStr(20, font_y, "20px: ABCabc123", 0x0000)
+    font_y = font_y + 26
+
+    lcd.setFont(lcd.font_opposansm24)
+    lcd.drawStr(20, font_y, "24px: ABCabc123", 0x0000)
+
+    lcd.drawLine(20, 470, 300, 470, 0x8410)
+end
+
+--[[
+处理LCD页面触摸事件;
+
+@api lcd_page.handle_touch(x, y, switch_page)
+@number x 触摸点X坐标,范围0-319
+@number y 触摸点Y坐标,范围0-479
+@function switch_page 页面切换回调函数
+@return boolean 事件处理成功返回true,否则返回false
+]]
+function lcd_page.handle_touch(x, y, switch_page)
+    -- 检查返回按钮
+    if x >= back_button.x1 and x <= back_button.x2 and
+        y >= back_button.y1 and y <= back_button.y2 then
+        switch_page("home")
+        return true
+    end
+    return false
+end
+
+return lcd_page

+ 151 - 0
module/Air8000/demo/accessory_board/AirLCD_1010/lcd/ui/ui_main.lua

@@ -0,0 +1,151 @@
+--[[
+@module  ui_main
+@summary 用户界面主控模块,负责页面管理和事件分发
+@version 1.0
+@date    2025.12.2
+@author  江访
+@usage
+本模块为核心UI控制模块,主要功能包括:
+1、初始化LCD显示和触摸面板驱动;
+2、管理多个页面之间的切换逻辑;
+3、分发触摸事件到各个页面处理;
+4、维护页面状态和生命周期管理;
+
+对外接口:
+1、ui_main():主UI任务入口函数
+2、switch_page():页面切换函数
+3、handle_touch_event():触摸事件处理函数
+]]
+
+
+-- 加载子页面
+local home_page = require "home_page"
+local lcd_page = require "lcd_page"
+local gtfont_page = require "gtfont_page"
+local customer_font_page = require "customer_font_page"
+
+-- 当前页面状态
+local current_page = "home"
+local last_page = ""
+frame_time = 20*1000
+
+--[[
+切换页面;
+
+@api switch_page(new_page)
+@string new_page 目标页面名称
+@valid_values "home", "lcd", "gtfont", "customer_font_page"
+@return nil
+
+@usage
+-- 切换到LCD演示页面
+switch_page("lcd")
+]]
+local function switch_page(new_page)
+    -- 调用旧页面的退出函数(如果存在)
+    if current_page == "home" and home_page.on_leave then
+        home_page.on_leave()
+    elseif current_page == "lcd" and lcd_page.on_leave then
+        lcd_page.on_leave()
+    elseif current_page == "gtfont" and gtfont_page.on_leave then
+        gtfont_page.on_leave()
+    elseif current_page == "customer_font_page" and customer_font_page.on_leave then
+        customer_font_page.on_leave()
+    end
+
+    last_page = current_page
+    current_page = new_page
+
+    -- 调用新页面的进入函数(如果存在)
+    if new_page == "home" and home_page.on_enter then
+        home_page.on_enter()
+    elseif new_page == "lcd" and lcd_page.on_enter then
+        lcd_page.on_enter()
+    elseif new_page == "gtfont" and gtfont_page.on_enter then
+        gtfont_page.on_enter()
+    elseif new_page == "customer_font_page" and customer_font_page.on_enter then
+        customer_font_page.on_enter()
+    end
+
+    log.info("ui_main", "切换到页面:", current_page)
+end
+
+--[[
+处理触摸事件;
+
+@api handle_touch_event(event, x, y)
+@number event 触摸事件类型
+@valid_values tp.EVENT_DOWN, tp.EVENT_MOVE, tp.EVENT_UP
+@number x 触摸点X坐标,范围0-319
+@number y 触摸点Y坐标,范围0-479
+@return boolean 事件处理成功返回true,否则返回false
+]]
+-- 处理触摸事件
+local function handle_touch_event(event, x, y)
+    log.info("触摸事件", "event:", event, "x:", x, "y:", y)
+
+    if event then -- 只在抬起时处理点击
+        if current_page == "home" then
+            return home_page.handle_touch(x, y, switch_page)
+        elseif current_page == "lcd" then
+            return lcd_page.handle_touch(x, y, switch_page)
+        elseif current_page == "gtfont" then
+            return gtfont_page.handle_touch(x, y, switch_page)
+        elseif current_page == "customer_font_page" then
+            return customer_font_page.handle_touch(x, y, switch_page)
+        end
+    end
+    return false
+end
+
+--[[
+用户界面主任务;
+
+@api ui_main()
+@summary 初始化显示和触摸驱动,启动UI主循环
+@return nil
+]]
+local function ui_main()
+    if not lcd_drv.init() then
+        log.error("ui_main", "显示初始化失败")
+        return
+    end
+
+    if not tp_drv.init() then
+        log.error("ui_main", "触摸初始化失败")
+        return
+    end
+
+    -- 默认使用系统自带的12号中文字体
+    lcd.setFont(lcd.font_opposansm12_chinese)
+
+    -- 调用主页的进入函数
+    if home_page.on_enter then
+        home_page.on_enter()
+    end
+
+    while true do
+        -- 根据当前页面绘制内容
+        if current_page == "home" then
+            home_page.draw()
+        elseif current_page == "lcd" then
+            lcd_page.draw()
+        elseif current_page == "gtfont" then
+            gtfont_page.draw()
+        elseif current_page == "customer_font_page" then
+            customer_font_page.draw()
+        end
+
+        lcd.flush()
+
+
+        -- 等待触摸事件
+        local result, event, x, y = sys.waitUntil("BASE_TOUCH_EVENT",frame_time)
+        if result then
+            handle_touch_event(event, x, y)
+        end
+    end
+end
+
+
+sys.taskInit(ui_main)