目录
- 开关机
- 简介
- 开关机接口控制
- powerKey.setup(longPrd, longCb, shortCb)
- 开关机使用实例
- 常见问题及故障排查
- 1 无法正常开机
- 2 低电自动关机后，等电压恢复正常，为什么开不了机？
- 针对带电池cat1设备，烧录1.3基线后，电池电压低于3v时，重新上电不能自动开机总结如下。
- 3 为什么上电自动开机了？
- 4 为什么关不了机？
开关机
简介
Air724UGx系列模块LUAT固件默认上电自动开机。AT固件需要通过PWRKEY管脚来给出开机信号。推荐模块供电VBAT在（3.3V~4.3V)范围内时，拉低1.2s以上，模块会进入开机流程。
常用的电路是控制PWRKEY管脚的方法是直接使用一个按钮开关。按钮附近需放置一个TVS管用以ESD保护，也可以去掉tvs管。下图为参考电路
图表：按键开机参考电路
开关机接口控制
模块功能：开机键功能配置
powerKey.setup(longPrd, longCb, shortCb)
配置开机键长按弹起和短按弹起的功能.
如何定义长按键和短按键，例如长按键判断时长为3秒：
按下大于等于3秒再弹起判定为长按键；
按下后，在3秒内弹起，判定为短按键
- 参数
传入值类型 | 释义 |
number | 可选参数，默认为 |
function | 可选参数，默认为 |
function | 可选参数，默认为 |
- 返回值
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”,设定按下按键4s关机。
--加载powerKey测试模块
require "powerKey"
--定义长按4s 关机
powerKey.setup(4000, function() rtos.poweroff() end)烧录代码后，按开机键，开关机，Luatools 打印如下：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-00RXRAvY-1624847578436)(http://openluat-luatcommunity.oss-cn-hangzhou.aliyuncs.com/images/20210330120137899_微信截图_20210330105248.png “undefined”)]
常见问题及故障排查
1 无法正常开机
- 确定模块供电端是否在工作范围内，电压是否稳定
- 是否有拉低开机信号去执行开机动作
- 复位脚电平是否处于高电平状态
2 低电自动关机后，等电压恢复正常，为什么开不了机？
- 1.3基线增加了低电压检测关机功能，1.2基线没这个功能不会出现上电不开机问题
- 1.3基线低电压关机后需按复位键，或者vbat完全断电，或者vbus供电（at版本不行），都可以重新上电开机
- AT版本不支持充电开机,AT版本如果powerkey按键接地后， 软件关机，就无法在开机了,通过AT设置电压后， 不会触发软件关机， 只会硬件掉电，这样电压上来就可以通过按键开机
- LUA版本支持充电开机，所以vbus供电后就可以开机。
针对带电池cat1设备，烧录1.3基线后，电池电压低于3v时，重新上电不能自动开机总结如下。
硬件状态 | LUA固件 | AT固件 |
powerkey接地，vbus不供电 | 1.可以自动开机 2.电池电压低于3v时自动关机后，重新上电到正常电压，不能自动开机；按照以下两种方式中任意一种方式操作，才能自动开机 (1)需按复位键，或者vbat完全断电再上电到正常电压，才能重新上电开机， (2)需烧录大于等于v3035版本【关闭“低电自动关机”功能、关闭“开机检测低电不允许开机”功能】才能上电可以自动开机 | 1.可以自动开机 2.电池电压低于3v时关机后，重新上电到正常电压，不能自动开机 (1)需按复位键，或者vbat完全断电再上电到正常电压，才能重新上电开机 (2)需烧录大于等于v301840版本【关闭“低电自动关机”功能、关闭“开机检测低电不允许开机”功能】，可以上电开机 |
powerkey接地，vbus供电 | 1.可以自动开机 2.电池电压低于3v时关机后，重新上电，能上电开机 | 1.可以自动开机 2.电池电压低于3v时关机后，重新上电，不能自动开机 (1)需按复位键，或者vbat完全断电再上电到正常电压，才能重新上电开机 (2)需烧录大于等于v301840版本可以上电开机 |
powerkey不接地，vbus不供电 | 1.不能自动开机 2.需按键开机，开机后，电池电压低于3v时关机后，重新上电，不能自动开机，需烧录大于等于v3035版本才能上电开机 | 1.不能自动开机 2.需按键开机，开机后，电池电压低于3v时关机后，重新上电，不能自动开机，需烧录大于等于v301840版本可以上电开机 |
powerkey不接地，vbus供电 | 1.能上电开机 | 1.不能上电开机 2.需按键开机，开机后，电池电压低于3v时关机后，重新上电，不能自动开机，需烧录大于等于v301840版本可以上电开机 |
722ug模块 第6脚不接VBAT | 不开机，需烧录大于等于v3035版本才能开机,开机后和其他cat1设备一样分上述四种情况 | 不开机，需烧录大于等于v301840版本才能开机,开机后和其他cat1设备一样分上述四种情况 |
722ug模块 第6脚接VBAT | 能自动开机，开机后和其他cat1设备一样分上述四种情况 | 能自动开机，开机后和其他cat1设备一样分上述四种情况 |
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-XmJ19awU-1624847578439)(http://openluat-luatcommunity.oss-cn-hangzhou.aliyuncs.com/images/20210603173346649_微信截图_20210603173259.png “undefined”)]
3 为什么上电自动开机了？
lua 如果usb供电，上电会自动开机，如果at 不会，如果设置了闹钟开机也会自动开机。
4 为什么关不了机？
看是不是开机键坏，模块供电是否正常，模块程序是不是进入了死循环，可以重新烧个程序看看。
