wangfq
173dd6874f
- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码 - 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等) - 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
5.2 KiB
5.2 KiB
eink墨水屏演示系统
一、功能模块介绍
1.1 核心主程序模块
- main.lua - 主程序入口，负责系统初始化和任务调度
- ui_main.lua - 用户界面主控模块，管理页面切换和事件分发
1.2 显示页面模块
- home_page.lua - 主页模块，提供应用入口和导航功能
- eink_page.lua - eink核心库演示模块
- time_page.lua - 时间显示演示模块
1.3 驱动模块
- eink_drv.lua - eink显示驱动模块，基于eink核心库
- key_drv.lua - 按键驱动模块，管理BOOT键和PWR键
二、按键功能说明
2.1 按键消息
- "KEY_EVENT" - 按键事件消息，包含按键类型和状态
- boot键事件：
boot_down（按下）、boot_up（释放） - pwr键事件：
pwr_down（按下）、pwr_up（释放）
- boot键事件：
2.2 按键功能定义
-
主页页面：
- BOOT键：切换选项（eink演示 ↔ 时间显示）
- PWR键：确认进入选中的页面
-
eink演示页面：
- PWR键：返回主页
- BOOT键：无功能
-
时间显示页面：
- BOOT键：切换时间显示格式（共6种格式）
- PWR键：返回主页
三、显示效果
| 主页 | eink库图像页面 | 更新时间页面 |
 |
 |
 |
四、硬件接线配置
4.1 物料清单
-
Air780EPM核心板 × 1
-
微雪1.54寸墨水屏 × 1 demo所使用的墨水屏购买链接
-
母对母杜邦线 × 8
-
TYPE-C 数据线 × 1
-
Air780EPM核心板和微雪1.54寸墨水屏的硬件接线方式为
- Air780EPM 核心板通过 TYPE-C USB 口供电（核心板正面开关拨到 ON 一端），此种供电方式下，VDD_EXT 引脚为 3.3V，可以直接给微雪1.54寸墨水屏供电；
- 为了演示方便，所以 Air780EPM 核心板上电后直接通过VDD_EXT引脚给微雪1.54寸墨水屏供电；
- 客户在设计实际项目时，一般来说，需要通过一个 GPIO 来控制 LDO 给配件板供电，这样可以灵活地控制配件板的供电，可以使项目的整体功耗降到最低；
4.2 接线方式
| Air780EPM核心板 | 墨水屏引脚 |
|---|---|
| 26/GPIO33 | BUSY |
| 25/GPIO26 | RST |
| 23/GPIO2 | DC |
| 22/GPIO1 | CS |
| 86/SPI0CLK | SCK |
| 85/SPI0MOSI | DIN |
| 24/VDD_EXT | VCC |
| GND | GND |
4.2.3 接线图
五、演示软件环境
5.1 开发工具
- Luatools下载调试工具 - 固件烧录和代码调试
5.2 内核固件
- 点击下载Air780EPM系列最新版本内核固件，demo所使用的是LuatOS-SoC_V2018_Air780EPM 1号固件
六、演示操作步骤
6.1 硬件准备
- 按照接线表连接eink屏幕
- 确保电源连接正确，通过TYPE-C USB口供电
- 确保所有连接正确无误
6.2 软件配置
在main.lua中选择加载对应的驱动模块：
-- 加载eink显示驱动管理功能模块
require "eink_drv"
-- 加载按键驱动管理功能模块
require "key_drv"
-- 加载eink核心库实现的用户界面功能模块
-- 实现多页面切换、按键事件分发和界面渲染功能
-- 包含主页、eink演示页和时间显示页
require "ui_main"
6.3 软件烧录
- 使用Luatools烧录最新内核固件
- 下载并烧录本项目所有脚本文件
- 设备自动重启后开始运行
6.4 功能测试
主页操作
- 设备启动后显示主页
- 使用BOOT键在两个选项间切换
- 使用PWR键进入选中的页面
eink演示页面
- 查看基本图形绘制示例
- 查看文本显示效果
- 查看二维码和电池图标
- 按PWR键返回主页
时间显示页面
- 查看当前时间显示
- 使用BOOT键切换不同的时间格式
- 按PWR键返回主页
6.5 预期效果
- 主页：清晰显示两个选项，选中状态明显
- eink演示页面：图形绘制清晰，布局合理
- 时间显示页面：时间格式切换流畅
- 按键交互：响应及时准确，页面切换正常
七、故障排除
- 屏幕不显示：检查SPI接线，确认电源供电
- 按键无响应：确认GPIO配置正确
- 时间显示异常：检查系统时间设置
- 页面切换异常：检查内存使用情况，适当调整刷新间隔
八、注意事项
- eink屏幕刷新较慢，请勿频繁切换页面
- 按键操作后请等待屏幕刷新完成
- 长时间运行请确保电源稳定
- 避免在高温高湿环境下使用
九、拓展使用
本demo内所演示的图形显示接口均可在eink核心库内找到，更丰富和详细的使用说明可以点击进入eink核心库