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 开发板使用说明