LuatOS/module/Air780EPM/demo/accessory_board/AirLCD_1000

AirLCD_1000_Air780EPM 演示 demo

一、功能模块介绍

1. main.lua：主程序入口；

2. ui_main.lua：UI应用模块，负责UI启动初始和UI主循环

3. AirLCD_1000.lua：显示驱动模块，负责执行AirLCD_1000初始化，背光亮度调节和屏幕休眠和唤醒

二、演示功能概述

1. 屏幕接线引脚配置在AirLCD_1000.lua内进行设置

2. 设置好后，启动主循环屏幕初始化程序，点亮屏幕

3. 进入UI主task，循环显示显示图片、字符、色块等内容，并通过接口设置背光亮度和对屏幕进行休眠和唤醒。

三、演示硬件环境

3.1 硬件准备

1. AirLCD_1000 显示屏*1

2. Air780EPM 开发板或核心板*1

3. 母对母杜邦线*8

4. TYPE-C 数据线*1

5. 按照硬件接线图正确连接 LCD 显示屏

6. 将核心板正面开关打到 ON 位置

7. 本demo使用的背光引脚,既是GPIO_1也是PWM_0引脚

8. 调节屏幕亮度需要确保背光控制引脚（如 demo 中 GPIO1）支持 PWM 功能

9. 背光引脚通过切换到PWM模式，通过调节占空比实现背光亮度调节

10. 背光引脚通过切换到GPIO模式，再调用休眠/唤醒接口使屏幕进入休眠/唤醒

3.2接线说明

引脚说明	核心开发板	屏幕	引脚说明
屏幕供电	VDD-EXT	VCC	显示屏电源供电脚
电源地	GND	GND	电源地
LCD SPI 串口的时钟信号	LCD_CLK	CLK	SPI 串口的时钟信号
LCD SPI 串口的数据脚	LCD_SDA	MOS	SPI 串口的数据输入脚
LCD 复位脚	LCD_RST	RES	显示屏复位脚
LCD 数据/寄存器控制脚	LCD_RS	DC	4 线 SPI 串口的显示数据/寄存器指令
LCD SPI片选，同一个SPI接口上有多个设备才使用	LCD_CS	CS	LCD驱动芯片片选脚
LCD 背光控制引脚	GPIO_1/PWM0	BKL	背光使能引脚

注意：模组GPIO供电能力弱，所以使用VDD-EXT供电。

四、演示软件环境

4.1 底层固件准备

固件版本，推荐使用 V2015 及以后最新固件版本：

Air780EPM固件下载链接（Air780EHM固件下载下方）

4.2Luatools下载调试工具

demo下载调试工具:Luatools

4.2演示emo下载

下载本 demo中除readme外的所有的代码文件以及图片文件

五、演示核心步骤

5.1 烧录程序

1. 下载 luatools 烧录工具：luatools下载链接及使用说明

2. 按照操作说明，将本 demo 内除 readme.md 外的全部文件通过 luatools 下载到模块内（按住 BOOT 键开机，选择下载底层和脚本）

3. 如需显示图片，如 demo 中显示的 logo，确保 logo.jpg 图片文件存在，下载时会放在模组 /luadb/ 目录下

5.2、演示 demo 效果

1. 通过 demo 了解屏幕连接、配置、初始化过程，为显示做好准备

2. 通过 demo 将图片、12 号中文、英文、点、线、圆形、矩形、颜色填充、二维码显示在屏幕上

3. 通过 demo 了解如何使用接口对屏幕进行背光亮度调节、屏幕休眠、屏幕唤醒

4. 实现效果图

六、程序对外接口

6.1 AirLCD_1000 模块接口

AirLCD_1000.lcd_init()

• 功能：初始化 AirLCD_1000LCD 显示屏

• 参数：

  • LCD_MODEL: LCD 型号字符串（如"AirLCD_1000"）
  • lcd_pin_dc: 数据/命令引脚号
  • lcd_pin_rst: 复位引脚号
  • lcd_pin_pwr: 背光控制引脚号

• 返回值：初始化成功状态(true/false), 屏幕宽度, 屏幕高度

AirLCD_1000.set_backlight(level)

• 功能：设置背光亮度
• 参数：level - 亮度级别(0-100)
• 返回值：设置成功状态(true/false)

AirLCD_1000.set_sleep(sleep)

• 功能：设置屏幕休眠或唤醒
• 参数：sleep - true 进入休眠, false 唤醒
• 返回值：设置成功状态(true/false)
• 注意事项：目前在屏幕休眠模式下，仅 AIR780EPM 支持模组设置 pm.power(pm.WORK_MODE, 1)，其他型号暂时不支持，唤醒模组会导致模组死机

6.2 screen_data_table 配置参数

• lcd_models: 支持的 LCD 型号及其参数
• default: 默认配置（滑动阈值、点击时间阈值等）预留后续扩展功能使用

6.3 更多显示接口

• 可以参考合宙 docs 上 LCD 库进行扩展使用：https://docs.openluat.com/osapi/core/lcd/

七、扩展说明

1. 目前支持 ST7796、ST7789、CO5300 显示芯片，其他 st7735 、st7735v、st7735s、gc9a01、gc9106l、gc9306x、ili9486 也同样支持，

2. 模组字体支持有限，需要使用其他字体可以搭配合宙 AirFONTS_1000 矢量字库使用

3. Air780EPM/EHM/EGH/EHV、Air8000 系列、Air8101，按正确的接口接线并修改 screen_data_table.lua 都可以使用此 demo

4. 其他屏幕可以参考 custom 的方式自定义屏幕初始化配置

   -- 配置接口参数
   local lcd_param = {
       port = lcd.HWID_0,        -- 使用的spi id 号
       pin_dc = 0xff,            -- 命令选择引脚
       pin_rst = 36,             -- 复位引脚
       direction = 0,            -- 屏幕方向
       w = width,                -- 屏幕宽度
       h = height,               -- 屏幕高度
       xoffset = 0,              -- X轴偏移像素
       yoffset = 0,              -- Y轴偏移像素
       sleepcmd = 0x10,          -- LCD睡眠命令
       wakecmd = 0x11,           -- LCD唤醒命令
   }
       
   -- 初始化SPI设备
       spi.deviceSetup(
           lcd.HWID_0,  -- LCD端口号
           nil,         -- CS片选脚，可选
           0,           -- CPHA=0
           0,           -- CPOL=0
           8,           -- 8位数据宽度
           20000000,    -- 20MHz波特率
           spi.MSB,     -- 高位先传
           1,           -- 主机模式
           1            -- 全双工模式
       )
           
   -- QSPI如有特殊配置，需要在lcd.init前配置好
   --lcd.qspi(0x02, 0x32, 0x12)
           
   -- 初始化屏幕 
   lcd.init("custom", lcd_param)
       
   -- 如有其他参数需要配置，可使用lcd.cmd命令
   --lcd.cmd(0x53, 0x20)
           
   -- 自定义初始化后必须运行该程序
   lcd.user_done()