keyPad

简介

Air724UG支持6X6键盘矩阵，可以在luat二次开发的方式应用，但注意AT版本不支持键盘功能。

API说明

API接口 描述
powerKey.setup(longPrd, longCb, shortCb) 开机键功能配置

常用api_1介绍
常用api_2介绍

示例

1.创建一个tKeypad表，储存所有按键值（16个键盘元素+1个开关机键元素）

--每个元素的索引为行列值拼接而成的字符串，值为按键名的字符串
--例如：按键名为"1"的行值为5，列值为3，则["53"] = "1"
local tKeypad =
{ 
   
    ["53"] = "1",["52"] = "2",["51"] = "3",["50"] = "A",
    ["43"] = "4",["42"] = "5",["41"] = "6",["40"] = "B",
    ["33"] = "7",["32"] = "8",["31"] = "9",["30"] = "C",
    ["23"] = "*",["22"] = "0",["21"] = "#",["20"] = "D",
    ["255255"] = "开关机"
}

2.定义某个keyName按键的长按下消息处理函数

local function keyLongPressTimerCb(keyName)
    log.info("keypad.keyLongPressTimerCb",keyName)

3.定义一个按键消息处理函数

--按键消息处理函数
local function keyMsg(msg)
    --保存按键名
    --msg.key_matrix_row：行索引
    --msg.key_matrix_col：列索引

    local keyName = tKeypad[msg.key_matrix_row..msg.key_matrix_col]  
    log.info("keyMsg",msg.key_matrix_row,msg.key_matrix_col,msg.pressed,keyName)  
    if msg.pressed then      
        --第一个参数：keyName按键的长按消息处理函数
        --第二个参数：超时时间为3秒
        --第三个参数：按键名
        sys.timerStart(keyLongPressTimerCb,300,keyName)
    end
end

4.注册按键消息处理函数

rtos.on(rtos.MSG_KEYPAD,keyMsg)

5.初始化键盘阵列

--第一个参数：固定为rtos.MOD_KEYPAD，表示键盘  
--第二个参数：目前无意义，固定为0  
--第三个参数：键盘阵列keyin标记，例如使用了keyin2、keyin3、keyin4、keyin5，则第三个参数为1<<2|1<<3|1<<4|1<<5 = 0x3C    行
--第四个参数：键盘阵列keyout标记，例如使用了keyout0、keyout1、keyout2、keyout3，则第四个参数为1<<0|1<<1|1<<2|1<<3 = 0x0F  列
rtos.init_module(rtos.MOD_KEYPAD,0,0x3c,0x0F)

6.把键盘阵列keyin标记和keyout标记软排线接口插入模块相对印引脚,比如键盘的keyin2对印模块的keyin2脚

7.在了解并修改了DEMO后将demo和对应的底包下载到开发板，下载的方式这里不详细说明请参考环境搭建中的烧录章节。

8.下载完成后重启，我们随便按一个按键，可以在luatools工具上看到打印的数据。

比如按下1键时：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-FSeNWzYu-1624771263903)(http://openluat-luatcommunity.oss-cn-hangzhou.aliyuncs.com/images/20210328182956060_微信截图_20210328161906.png “undefined”)]

按下A键时：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-79nptfPX-1624771263906)(http://openluat-luatcommunity.oss-cn-hangzhou.aliyuncs.com/images/20210328183038808_微信截图_20210328163505.png “undefined”)]

常见问题

为什么按下按键时没反应？
看下按键引脚是否与模块引脚是否接对？键盘是不是ok?

相关资料以及开发板购买链接

Air724UG开发板
Air724 开发板使用说明