全面解读Air724UG模组软件的KEYPAD操作！

最新推荐文章于 2024-12-09 16:08:56 发布

学无止境的小孩

最新推荐文章于 2024-12-09 16:08:56 发布

阅读量528

点赞数 25

CC 4.0 BY-SA版权

文章标签：人工智能单片机嵌入式硬件硬件工程 4G模组低功耗模组

本文链接：https://blog.youkuaiyun.com/UpUpStudy123/article/details/144138571

本文将全面解读Air724UG低功耗模组软件的KEYPAD操作，我已整理成文分享给大家。

一、简介

在电路设计中，通常需要较多的外部输入，如果每个按键都单独去占用一个 IO 接口，就会非常浪费资源，为了减少 I/O 口的占用，通常将按键排列成矩阵形式，即矩阵键盘。

特性：

KEYIN0
扫描键盘输入 0，与 UBOOT 复用，此管脚在模块开机动作完成之前不能进行拉高，电压域为 V_GLOBAL_1V8。
KEYIN1
扫描键盘输入 1，此管脚在模块开机动作完成之前不能进行拉高，电压域为 V_GLOBAL_1V8。
KEYIN2、KEYIN3、KEYIN4、KEYIN5
扫描键盘输入管脚，电压域为 V_GLOBAL_1V8。
KEYOUT0、KEYOUT1、KEYOUT2、KEYOUT3
扫描键盘输出管脚，电压域为 V_GLOBAL_1V8。
KEYOUT4
扫描键盘输出管脚 4，与 UART3_RXD 复用，电压域为 V_GLOBAL_1V8。
KEYOUT5
扫描键盘输出管脚 5，与 UART3_TXD 复用，电压域为 V_GLOBAL_1V8。

注意：键盘接口的所有管脚不能复用为GPIO。

二、演示功能概述

本教程教你如何使用开发板的矩阵键盘获取输入信息。

三、准备硬件环境

3.1 开发板准备

使用 EVB_Air724 开发板，如下图所示：

此开发板的详细使用说明参考：
https://docs.openluat.com/air724ug/product/

Air724UG 产品手册中的《EVB_Air724UG_AXX 开发板使用说明》，写这篇文章时最新版本的使用说明为：《EVB_Air724UG_A14 开发板使用说明》；开发板使用过程中遇到任何问题，可以直接参考这份使用说明文档。

API文档：
https://doc.openluat.com/wiki/21?wiki_page_id=2068

3.2 数据通信线

USB数据线一根（micro USB）。

3.3 PC 电脑

WIN7以及以上版本的 WINDOWS 系统。

3.4 矩阵键盘

4x4 矩阵键盘

3.5 组装硬件环境

USB 数据线插入 USB 口，另一端与电脑相连，拨码开关全部拨到 ON，串口切换开关选择 UART1,USB 供电的 4V 对应开关拨至 ON 档，连接矩阵键盘，把键盘阵列软排线接口插入开发板相对印引脚,keyin2 keyin3 keyin4 keyin5 keyout0 keyout1 keyout2 keyout3，如下图所示。

四、准备软件环境

4.1 下载调试工具

使用说明参考：
Luatools下载和详细使用
https://docs.openluat.com/Luatools/

4.2 源码及固件

1、底层 core 下载

下载底层固件，并解压。

链接：
https://docs.openluat.com/air724ug/luatos/firmware/

如下图所示，红框的是我们要使用到的

2、本教程使用的demo见附件：

https://gitee.com/openLuat/LuatOS-Air724UG/tree/master/script_LuaTask/demo/keypad

4.3 下载固件和脚本到开发板中

打开 Luatools，开发板上电开机，如开机成功 Luatools 会打印如下信息。

点击项目管理测试选项。

进入管理界面，如下图所示。

点击选择文件，选择底层固件，我的文件放在 D:\luatOS\Air724 路径中

点击增加脚本或资源文件，选择之前下载的程序源码，如下图所示。

点击下载底层和脚本，下载完成如下图所示。

五、代码示例介绍

5.1 API 说明

5.1.1 powerKey.setup(longPrd, longCb, shortCb) 开机键功能配置

配置开机键长按弹起和短按弹起的功能.

如何定义长按键和短按键，例如长按键判断时长为 3 秒：

按下大于等于 3 秒再弹起判定为长按键；

按下后，在3 秒内弹起，判定为短按键

参数

名称	传入值类型	释义
longPrd	number	可选参数，默认为 3000 长按键判断时长，单位毫秒
longCb	function	可选参数，默认为 nil 长按弹起时的回调函数，如果为 nil，使用默认的处理函数
shortCb	function	可选参数，默认为 nil 短按弹起时的回调函数