一、簡(jiǎn)介

在電路設(shè)計(jì)中，通常需要較多的外部輸入，如果每個(gè)按鍵都單獨(dú)去占用一個(gè) IO 接口，就會(huì)非常浪費(fèi)資源，為了減少 I/O 口的占用，通常將按鍵排列成矩陣形式，即矩陣鍵盤(pán)。

特性：

KEYIN0

掃描鍵盤(pán)輸入 0，與 UBOOT 復(fù)用，此管腳在模塊開(kāi)機(jī)動(dòng)作完成之前不能進(jìn)行拉高，電壓域?yàn)?V_GLOBAL_1V8。

KEYIN1

掃描鍵盤(pán)輸入 1，此管腳在模塊開(kāi)機(jī)動(dòng)作完成之前不能進(jìn)行拉高，電壓域?yàn)?V_GLOBAL_1V8。

KEYIN2、KEYIN3、KEYIN4、KEYIN5

掃描鍵盤(pán)輸入管腳，電壓域?yàn)?V_GLOBAL_1V8。

KEYOUT0、KEYOUT1、KEYOUT2、KEYOUT3

掃描鍵盤(pán)輸出管腳，電壓域?yàn)?V_GLOBAL_1V8。

KEYOUT4

掃描鍵盤(pán)輸出管腳 4，與 UART3_RXD 復(fù)用，電壓域?yàn)?V_GLOBAL_1V8。

KEYOUT5

掃描鍵盤(pán)輸出管腳 5，與 UART3_TXD 復(fù)用，電壓域?yàn)?V_GLOBAL_1V8。

注意：鍵盤(pán)接口的所有管腳不能復(fù)用為GPIO。

二、演示功能概述

本教程教你如何使用開(kāi)發(fā)板的矩陣鍵盤(pán)獲取輸入信息。

三、準(zhǔn)備硬件環(huán)境

3.1 開(kāi)發(fā)板準(zhǔn)備

使用 EVB_Air724 開(kāi)發(fā)板

此開(kāi)發(fā)板的詳細(xì)使用說(shuō)明參考：

https://docs.openluat.com/air724ug/product/

API文檔：

https://doc.openluat.com/wiki/21?wiki_page_id=2068

3.2 數(shù)據(jù)通信線(xiàn)

USB數(shù)據(jù)線(xiàn)一根（micro USB）。

3.3 PC 電腦

WIN7以及以上版本的 WINDOWS 系統(tǒng)。

3.4 矩陣鍵盤(pán)

4x4 矩陣鍵盤(pán)

3.5 組裝硬件環(huán)境

USB 數(shù)據(jù)線(xiàn)插入 USB 口，另一端與電腦相連，撥碼開(kāi)關(guān)全部撥到 ON，串口切換開(kāi)關(guān)選擇 UART1,USB 供電的 4V 對(duì)應(yīng)開(kāi)關(guān)撥至 ON 檔，連接矩陣鍵盤(pán)，把鍵盤(pán)陣列軟排線(xiàn)接口插入開(kāi)發(fā)板相對(duì)印引腳,keyin2 keyin3 keyin4 keyin5 keyout0 keyout1 keyout2 keyout3，如下圖所示。

四、準(zhǔn)備軟件環(huán)境

4.1 下載調(diào)試工具

使用說(shuō)明參考：

Luatools下載和詳細(xì)使用

https://docs.openluat.com/Luatools/

4.2 源碼及固件

1、底層 core 下載

下載底層固件，并解壓。

鏈接：

https://docs.openluat.com/air724ug/luatos/firmware/

如下圖所示，紅框的是我們要使用到的

2、本教程使用的demo見(jiàn)附件：

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

4.3 下載固件和腳本到開(kāi)發(fā)板中

打開(kāi) Luatools，開(kāi)發(fā)板上電開(kāi)機(jī)，如開(kāi)機(jī)成功 Luatools 會(huì)打印如下信息。

點(diǎn)擊項(xiàng)目管理測(cè)試選項(xiàng)。

進(jìn)入管理界面，如下圖所示。

點(diǎn)擊選擇文件，選擇底層固件，我的文件放在 D:luatOSAir724 路徑中

點(diǎn)擊增加腳本或資源文件，選擇之前下載的程序源碼，如下圖所示。

點(diǎn)擊下載底層和腳本，下載完成如下圖所示。

五、代碼示例介紹

5.1 API 說(shuō)明

5.1.1 powerKey.setup(longPrd, longCb, shortCb) 開(kāi)機(jī)鍵功能配置

配置開(kāi)機(jī)鍵長(zhǎng)按彈起和短按彈起的功能.

如何定義長(zhǎng)按鍵和短按鍵，例如長(zhǎng)按鍵判斷時(shí)長(zhǎng)為 3 秒：

按下大于等于 3 秒再?gòu)椘鹋卸殚L(zhǎng)按鍵；

按下后，在3 秒內(nèi)彈起，判定為短按鍵

參數(shù)

5.1.2 創(chuàng)建一個(gè) tKeypad 表，儲(chǔ)存所有按鍵值（16 個(gè)鍵盤(pán)元素 +1 個(gè)開(kāi)關(guān)機(jī)鍵元素）

--每個(gè)元素的索引為行列值拼接而成的字符串，值為按鍵名的字符串

--例如：按鍵名為"1"的行值為 5，列值為 3，則["53"] = "1"

5.1.3 定義某個(gè) keyName 按鍵的長(zhǎng)按下消息處理函數(shù)

5.1.4 定義一個(gè)按鍵消息處理函數(shù)

--按鍵消息處理函數(shù)

5.1.5 注冊(cè)按鍵消息處理函數(shù)

5.1.6 初始化鍵盤(pán)陣列

5.2 testKeypad.lua 代碼

注冊(cè)按鍵消息處理函數(shù) rtos.on(rtos.MSG_KEYPAD,keyMsg)，初始化鍵盤(pán)陣列 rtos.init_module(rtos.MOD_KEYPAD,0,0x0F,0x0F)，當(dāng)有鍵盤(pán)按下或抬起時(shí)按鍵消息處理函數(shù)會(huì)打印出對(duì)應(yīng)的行列值。

5.3 main.lua 代碼

本代碼為主程序腳本，系統(tǒng)啟動(dòng)后首先會(huì)對(duì) 4G 網(wǎng)絡(luò)進(jìn)行配置，等待網(wǎng)絡(luò)連接成功，然后加載矩陣鍵盤(pán)測(cè)試模塊。

六、開(kāi)機(jī)調(diào)試

6.1 開(kāi)發(fā)板開(kāi)機(jī)

連接好硬件并下載固件后，啟動(dòng) Luatools 軟件，系統(tǒng)運(yùn)行信息將顯示在界面中。紅框中為開(kāi)發(fā)板連接到 PC 機(jī)后正常打印的信息，如下圖所示。

6.2 鍵盤(pán)調(diào)試

鍵盤(pán)按下或抬起時(shí)按鍵消息處理函數(shù)會(huì)打印出對(duì)應(yīng)的行列，true 為按鍵按下，false 為按鍵抬起。

七、常見(jiàn)問(wèn)題

7.1 為什么 KEYIN0 的按鍵在開(kāi)機(jī)時(shí)被按下后就會(huì)不開(kāi)機(jī)。

答：因?yàn)?KEYIIN0 信號(hào)復(fù)用為是 USB_BOOT，如果被按下就會(huì)進(jìn)入下載模式，就進(jìn)入不了開(kāi)機(jī)流程。只需重新斷電開(kāi)機(jī)就能恢復(fù)

7.2 為什么按下按鍵時(shí)沒(méi)反應(yīng)？

1、看下按鍵引腳是否與模塊引腳是否接對(duì)？鍵盤(pán)是不是 ok?

2、是不是引用了 powKey.lua ,關(guān)機(jī)按鍵默認(rèn)行列是（255，255）不需另外配置。

審核編輯 黃宇