如何用开发板实现开关机功能
开关机
简介
Air724UGx系列模块LUAT固件默认上电自动开机。AT固件需要通过PWRKEY管脚来给出开机信号。推荐模块供电VBAT在(3.3V~4.3V)范围内时,拉低1.2s以上,模块会进入开机流程。
常用的电路是控制PWRKEY管脚的方法是直接使用一个按钮开关。按钮附近需放置一个TVS管用以ESD保护,也可以去掉tvs管。下图为参考电路
图表:按键开机参考电路
。
材料准备
- EVB_Air724UG_A13开发板一套,包括天线SIM卡,USB线。
- PC电脑,以及官方TCP测试web页面:http://tcplab.openluat.com/
- luat开发环境:环境搭建方法
步骤
本文以demo\powkey这个DEMO为例做演示。
开关机接口控制
模块功能:开机键功能配置
powerKey.setup(longPrd, longCb, shortCb)
配置开机键长按弹起和短按弹起的功能.
如何定义长按键和短按键,例如长按键判断时长为3秒:
按下大于等于3秒再弹起判定为长按键;
按下后,在3秒内弹起,判定为短按键
- 参数
传入值类型 | 释义 |
---|---|
number | 可选参数,默认为3000 ,longPrd,长按键判断时长,单位毫秒 |
function | 可选参数,默认为nil ,longCb,长按弹起时的回调函数,如果为nil,使用默认的处理函数,会自动关机 |
function | 可选参数,默认为nil ,shortCb,短按弹起时的回调函数 |
- 返回值
nil
- 例子
powerKey.setup(nil,longCb,shortCb)
powerKey.setup(5000,longCb)
powerKey.setup()
长按powerkey键3秒以上弹起,执行关机操作:powerKey.setup(3000, function() rtos.poweroff() end)
开关机使用实例
开关机的具体使用方式可以参考如下示例代码,示例代码的主要步骤如下:
1.开机一般默认是按住开机键1.2s可以开机,开机后usb会打印log.
2.关机时,是调用powerKey.lua 库中接口,设置longprd 可以修改关机按下的时间,代码如下:
- 按键消息处理函数
--[[
sta:按键状态,IDLE表示空闲状态,PRESSED表示已按下状态,LONGPRESSED表示已经长按下状态
longprd:长按键判断时长,默认3秒;按下大于等于3秒再弹起判定为长按键;按下后,在3秒内弹起,判定为短按键
longcb:长按键处理函数
shortcb:短按键处理函数
]]
local sta,longprd,longcb,shortcb = "IDLE",3000
local function longtimercb()
log.info("keypad.longtimercb")
sta = "LONGPRESSED"
end
local function keyMsg(msg)
log.info("keyMsg",msg.key_matrix_row,msg.key_matrix_col,msg.pressed)
if msg.pressed then
sta = "PRESSED"
sys.timerStart(longtimercb,longprd)
else
sys.timerStop(longtimercb)
if sta=="PRESSED" then
if shortcb then shortcb() end
elseif sta=="LONGPRESSED" then
log.info("关机",sta);
(longcb or rtos.poweroff)()
end
sta = "IDLE"
end
end
- 配置开机键长按弹起和短按弹起的功能.
-- 如何定义长按键和短按键,例如长按键判断时长为3秒:
-- 按下大于等于3秒再弹起判定为长按键;
-- 按下后,在3秒内弹起,判定为短按键
-- @number[opt=3000] longPrd,长按键判断时长,单位毫秒
-- @function[opt=nil] longCb,长按弹起时的回调函数,如果为nil,使用默认的处理函数,会自动关机
-- @function[opt=nil] shortCb,短按弹起时的回调函数
-- @return nil
-- @usage
-- powerKey.setup(nil,longCb,shortCb)
--powerKey.setup(20000,longCb)
-- powerKey.setup()
function setup(longPrd,longCb,shortCb)
longprd,longcb,shortcb = longPrd or 3000,longCb,shortCb
end
- 注册按键消息,初始化模块键盘引脚
rtos.on(rtos.MSG_KEYPAD,keyMsg)
rtos.init_module(rtos.MOD_KEYPAD,0,0,0)
3.上面是对powerKey库中代码介绍,现在demo中新建一个main.lua脚本, 加载require “powerKey”,设定按下按键8s关机。
--加载powerKey测试模块
require "powerKey"
--定义长按8s 关机
powerKey.setup(8000, function() rtos.poweroff() end)
烧录代码后,按开机键,开关机,Luatools 打印如下:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kigGleVo-1624773433844)(http://openluat-luatcommunity.oss-cn-hangzhou.aliyuncs.com/images/20210330120137899_微信截图_20210330105248.png “undefined”)]
常见问题
- 1:为什么上电自动开机了?
lua 如果usb供电,上电会自动开机,at 不会,如果设置了闹钟开机也会自动开机。 - 2:为什么关不了机?
看是不是开机键坏,模块供电是否正常,模块程序是不是进入了死循环,可以重新烧个程序看看。