02 AirKEY_1000

作者：沈园园　|　最后修改：2026-04-14

一、AirKEY_1000 概述

AirKEY_1000是合宙推出的一款支持8个独立按键的配件板，其中：

按键板，用于测试GPIO中断功能；
适用于Air780E系列/Air8000系列/Air8101系列；

二、演示功能概述

AirKEY_1000是合宙设计生产的一款支持8个独立按键的配件板；

本demo演示的核心功能为：

Air780EHV核心板+AirKEY_1000配件板，使用Air780EHV核心板的GPIO中断检测AirKEY_1000配件板上8个独立按键的按下或者弹起状态；

三、准备硬件环境

1、Air780EHV核心板一块

2、TYPE-C USB数据线一根

3、AirKEY_1000配件板

4、母对母的杜邦线9根

5、Air780EHV核心板和数据线的硬件接线方式为

Air780EHV核心板通过TYPE-C USB口连接TYPE-C USB 数据线，数据线的另外一端连接电脑的USB口；
核心板正面的 ON/OFF 拨动开关拨到ON一端；

Air780EHV核心板和AirSHT30_1000配件板的硬件接线方式为

Air780EHV核心板	AirKEY_1000配件板
25/GPIO26	K1
107/GPIO21	K2
20/GPIO24	K3
19/GPIO22	K4
99/GPIO23	K5
106/GPIO25	K6
78/GPIO28	K7
16/GPIO27	K8
GND	G

演示软件环境

四、准备软件环境

4.1 软件环境

在开始实践本示例之前，先筹备一下软件环境：

1、烧录工具：Luatools 下载调试工具

2、内核固件：本demo开发测试时使用的固件为Air780EHV V2032 版本固件，本demo对固件版本没有什么特殊要求，所以你如果要测试本demo时，可以直接使用最新版本的内核固件；如果发现最新版本的内核固件测试有问题，可以使用我们开发本demo时使用的内核固件版本来对比测试；

3、脚本文件：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EHM_Air780EHV_Air780EGH/demo/accessory_board/AirKEY_1000

4、lib脚本文件：使用Luatools烧录时，勾选添加默认lib 选项，使用默认lib脚本文件

准备好软件环境之后，接下来查看如何烧录项目文件到Air780EHV核心板，将本篇文章中演示使用的项目文件烧录到Air780EHV核心板中。

4.2 API 介绍

GPIO库：https://docs.openluat.com/osapi/core/gpio/

五、程序结构

AirKEY_1000/
│── main.lua
│── key_app.lua
│── AirKEY_1000.lua
│── readme.md

5.1 文件说明

main.lua：主程序入口文件。
key_app.lua：每隔1秒读取一次温湿度数据。
AirKEY_1000.lua：AirKEY_1000驱动文件。

六、代码详解

6.1 main.lua

主程序文件 main.lua 是整个项目的入口点。它负责初始化系统环境。

6.2 key_app.lua

使用Air780EHV核心板的GPIO中断检测AirKEY_1000配件板上8个独立按键的按下或者弹起状态。

6.2.1 检测按键的按下或者弹起状态

--AirKEY_1000上8个按键对应的Air780EHM/Air780EHV/Air780EGH的GPIO ID
local KEY1_GPIO_ID = 26
local KEY2_GPIO_ID = 21
local KEY3_GPIO_ID = 24
local KEY4_GPIO_ID = 22
local KEY5_GPIO_ID = 23
local KEY6_GPIO_ID = 25
local KEY7_GPIO_ID = 28
local KEY8_GPIO_ID = 27


--按键1的中断处理函数
--int_level：number类型，表示触发中断后，某一时刻引脚的电平，1为高电平，0为低电平，并不一定是触发中断时的电平
--gpio_id：number类型，air_key.setup函数配置按键1时，对应的Air780EHM/Air780EHV/Air780EGH上的GPIO ID
--在中断处理函数中，不要直接执行耗时较长的动作，例如写fskv，写文件，延时等
--可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
local function key1_int_cbfunc(int_level, gpio_id)
    log.info("key1_int_cbfunc pressup", gpio_id, int_level)

    --如果需要执行耗时较长的动作，不要在这里直接执行
    --而是使用以下代码，publish一个消息出去，给其他协程或者给订阅消息的处理函数去执行耗时动作
    sys.publish("KEY1_PRESSUP_IND")
end

--按键2的中断处理函数
--int_level：number类型，表示触发中断后，某一时刻引脚的电平，1为高电平，0为低电平，并不一定是触发中断时的电平
--gpio_id：number类型，air_key.setup函数配置按键2时，对应的Air780EHM/Air780EHV/Air780EGH上的GPIO ID
--在中断处理函数中，不要直接执行耗时较长的动作，例如写fskv，写文件，延时等
--可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
local function key2_int_cbfunc(int_level, gpio_id)
    log.info("key2_int_cbfunc pressup", gpio_id, int_level)

    --如果需要执行耗时较长的动作，不要在这里直接执行
    --而是使用以下代码，publish一个消息出去，给其他协程或者给订阅消息的处理函数去执行耗时动作
    sys.publish("KEY2_PRESSUP_IND")
end

--按键3的中断处理函数
--int_level：number类型，表示触发中断后，某一时刻引脚的电平，1为高电平，0为低电平，并不一定是触发中断时的电平
--gpio_id：number类型，air_key.setup函数配置按键3时，对应的Air780EHM/Air780EHV/Air780EGH上的GPIO ID
--在中断处理函数中，不要直接执行耗时较长的动作，例如写fskv，写文件，延时等
--可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
local function key3_int_cbfunc(int_level, gpio_id)
    log.info("key3_int_cbfunc pressup", gpio_id, int_level)

    --如果需要执行耗时较长的动作，不要在这里直接执行
    --而是使用以下代码，publish一个消息出去，给其他协程或者给订阅消息的处理函数去执行耗时动作
    sys.publish("KEY3_PRESSUP_IND")
end

--按键4的中断处理函数
--int_level：number类型，表示触发中断后，某一时刻引脚的电平，1为高电平，0为低电平，并不一定是触发中断时的电平
--gpio_id：number类型，air_key.setup函数配置按键4时，对应的Air780EHM/Air780EHV/Air780EGH上的GPIO ID
--在中断处理函数中，不要直接执行耗时较长的动作，例如写fskv，写文件，延时等
--可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
local function key4_int_cbfunc(int_level, gpio_id)
    log.info("key4_int_cbfunc pressup", gpio_id, int_level)

    --如果需要执行耗时较长的动作，不要在这里直接执行
    --而是使用以下代码，publish一个消息出去，给其他协程或者给订阅消息的处理函数去执行耗时动作
    sys.publish("KEY4_PRESSUP_IND")
end


--按键5、6、7、8的中断处理函数
--int_level：number类型，表示触发中断后，某一时刻引脚的电平，1为高电平，0为低电平，并不一定是触发中断时的电平
--gpio_id：number类型，air_key.setup函数配置按键5、6、7、8时，对应的Air780EHM/Air780EHV/Air780EGH上的GPIO ID
--在中断处理函数中，不要直接执行耗时较长的动作，例如写fskv，写文件，延时等
--可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
local function key5678_int_cbfunc(int_level, gpio_id)
    log.info("key5678_int_cbfunc", gpio_id, int_level)

    --如果需要执行耗时较长的动作，不要在这里直接执行
    --而是使用以下代码，publish一个消息出去，给其他协程或者给订阅消息的处理函数去执行耗时动作
    if gpio_id==KEY5_GPIO_ID then
        log.info("key5 pressdown")
        sys.publish("KEY5_PRESSDOWN_IND")
    elseif gpio_id==KEY6_GPIO_ID then
        log.info("key6 pressdown")
        sys.publish("KEY6_PRESSDOWN_IND")
    elseif gpio_id==KEY7_GPIO_ID then
        log.info("key7 pressdown")
        sys.publish("KEY7_PRESSDOWN_IND")
    elseif gpio_id==KEY8_GPIO_ID then
        log.info("key8 pressdown")
        sys.publish("KEY8_PRESSDOWN_IND")
    end    
end



--本demo中，Air780EHM/Air780EHV/Air780EGH核心板和AirKEY_1000配件板的接线方式如下
--Air780EHM/Air780EHV/Air780EGH核心板             AirKEY_1000配件板
--     25/GPIO26-----------------K1
--     107/GPIO21-----------------K2
--     20/GPIO24-----------------K3
--     19/GPIO22-----------------K4
--     99/GPIO23-----------------K5
--     106/GPIO25-----------------K6
--     78/GPIO28-----------------K7
--     16/GPIO27-----------------K8
--       GND-----------------G



--AirKEY_1000上的1、2、3、4，四个按键的引脚
--分别和Air780EHM/Air780EHV/Air780EGH的KEY1_GPIO_ID、KEY2_GPIO_ID、KEY3_GPIO_ID、KEY4_GPIO_ID四个引脚相连
--GPIO配置为上升沿触发中断，可以实时检测到按键弹起的动作
--按键弹起时，会执行对应的中断处理函数key1_int_cbfunc、key2_int_cbfunc、key3_int_cbfunc、key4_int_cbfunc
--在中断处理函数中，不要直接执行耗时较长的动作，例如写fskv，写文件，延时等
--可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
air_key.setup(1, KEY1_GPIO_ID, gpio.RISING, key1_int_cbfunc)
air_key.setup(2, KEY2_GPIO_ID, gpio.RISING, key2_int_cbfunc)
air_key.setup(3, KEY3_GPIO_ID, gpio.RISING, key3_int_cbfunc)
air_key.setup(4, KEY4_GPIO_ID, gpio.RISING, key4_int_cbfunc)

--AirKEY_1000上的5、6、7、8，四个按键的引脚
--分别和Air780EHM/Air780EHV/Air780EGH的KEY5_GPIO_ID、KEY6_GPIO_ID、KEY7_GPIO_ID、KEY8_GPIO_ID四个引脚相连
--GPIO配置为下降沿触发中断，可以实时检测到按键按下的动作
--按键按下时，会执行对应的中断处理函数key5678_int_cbfunc
--这四个按键共用了同一个中断处理函数，可以通过函数传入的GPIO ID来区分是哪一个按键被按下
--在中断处理函数中，不要直接执行耗时较长的动作，例如写fskv，写文件，延时等
--可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
air_key.setup(5, KEY5_GPIO_ID, gpio.FALLING, key5678_int_cbfunc)
air_key.setup(6, KEY6_GPIO_ID, gpio.FALLING, key5678_int_cbfunc)
air_key.setup(7, KEY7_GPIO_ID, gpio.FALLING, key5678_int_cbfunc)
air_key.setup(8, KEY8_GPIO_ID, gpio.FALLING, key5678_int_cbfunc)

6.3 AirKEY_1000.lua

AirKEY_1000驱动配置文件。

6.3.1 配置主机和AirKEY_1000之间的控制参数

--本文件中的主机是指Air780EHM/Air780EHV/Air780EGH核心板
--AirKEY_1000是合宙设计生产的一款8路独立按键的配件板

local AirKEY_1000 = {}


--配置主机和AirKEY_1000之间的控制参数；

--key_id：number类型；
--        AirKEY_1000的按键ID；
--        取值范围：1到8；
--        必须传入，不允许为空；
--gpio_id：number类型；
--         主机使用的中断引脚GPIO ID；
--         AirKEY_1000上的一个按键引脚，和主机上的一个GPIO中断引脚相连；
--         AirKEY_1000上的按键按下或者弹起，主机上的GPIO中断引脚输入电平发生变化，从而产生中断；
--int_mode：number类型；
--          表示主机GPIO中断触发类型；
--          取值范围：gpio.RISING表示上升沿触发，gpio.FALLING表示下降沿触发；
--          如果没有传入此参数，则默认为gpio.FALLING；
--int_cbfunc：function类型；
--          表示中断处理函数，函数的定义格式如下：
--                           function cb_func(level, gpio_id)
--                               --level：表示触发中断后，某一时刻引脚的电平，1为高电平，0为低电平，并不一定是触发中断时的电平
--                               --gpio_id：表示触发中断的主机中断引脚的GPIO ID；
--                           end
--          中断函数中不要直接执行耗时较长的动作，例如写fskv，写文件，延时等，可以publish消息给其他协程或者给订阅消息的处理函数去执行耗时动作
--          必须传入，不允许为空；

--返回值：成功返回true，失败返回false
function AirKEY_1000.setup(key_id, gpio_id, int_mode, int_cbfunc)
    if not (int_mode==gpio.RISING or int_mode==gpio.FALLING) then
        log.error("AirKEY_1000.setup error", "invalid int_mode", int_mode)
        return false
    end

    if type(int_cbfunc)~="function" then
        log.error("AirKEY_1000.setup error", "invalid int_cbfunc", type(int_cbfunc))
        return false
    end

    -- gpio.setup(gpio_id, int_cbfunc, int_mode==gpio.RISING and gpio.PULLDOWN or gpio.PULLUP, int_mode)
    gpio.setup(gpio_id, int_cbfunc, gpio.PULLUP, int_mode)

    return true
end


return AirKEY_1000

七、运行结果展示

(1) 按键1弹起时，Luatools的运行日志输出 key1_int_cbfunc pressup，表示按键1测试正常；

(2) 按键2弹起时，Luatools的运行日志输出 key2_int_cbfunc pressup，表示按键2测试正常；

(3) 按键3弹起时，Luatools的运行日志输出 key3_int_cbfunc pressup，表示按键3测试正常；

(4) 按键4弹起时，Luatools的运行日志输出 key4_int_cbfunc pressup，表示按键4测试正常；

(5) 按键5按下时，Luatools的运行日志输出 key5 pressdown，表示按键5测试正常；

(6) 按键6按下时，Luatools的运行日志输出 key6 pressdown，表示按键6测试正常；

(7) 按键7按下时，Luatools的运行日志输出 key7 pressdown，表示按键7测试正常；

(8) 按键8按下时，Luatools的运行日志输出 key8 pressdown，表示按键8测试正常；

[2025-10-20 10:39:08.283][000000006.310] I/user.key1_int_cbfunc pressup 28 1
[2025-10-20 10:39:09.351][000000007.382] I/user.key2_int_cbfunc pressup 26 1
[2025-10-20 10:39:10.818][000000008.855] I/user.key3_int_cbfunc pressup 27 1
[2025-10-20 10:39:11.705][000000009.736] I/user.key4_int_cbfunc pressup 16 1
[2025-10-20 10:39:12.900][000000010.930] I/user.key5678_int_cbfunc 1 0
[2025-10-20 10:39:12.906][000000010.931] I/user.key5 pressdown
[2025-10-20 10:39:13.989][000000012.026] I/user.key5678_int_cbfunc 2 0
[2025-10-20 10:39:13.998][000000012.027] I/user.key6 pressdown
[2025-10-20 10:39:15.457][000000013.491] I/user.key5678_int_cbfunc 35 0
[2025-10-20 10:39:15.462][000000013.492] I/user.key7 pressdown
[2025-10-20 10:39:16.790][000000014.829] I/user.key5678_int_cbfunc 34 0
[2025-10-20 10:39:16.792][000000014.830] I/user.key8 pressdown

八、总结

通过本章内容的学习，你可以学习到Air780EHV核心板+AirKEY_1000配件板，使用Air780EHV核心板的GPIO中断检测AirKEY_1000配件板上8个独立按键的按下或者弹起状态。