4G模组Air724UG软件指南之闹钟(alarm) 必读教程

众所周知alarm闹钟是电子产品中常用来作为设备软件定时开关机的一项基本功能，本文介绍如何用Air724开发板，进行闹钟功能演示。

一、演示功能概述

本教程教你如何用Air724开发板，进行闹钟的功能演示。

二、准备硬件环境

2.1 开发板准备

使用 EVB_Air724 开发板，如下图所示：

此开发板的详细使用说明参考：
https://docs.openluat.com/air724ug/product/

Air724UG 产品手册中的《EVB_Air724UG_AXX 开发板使用说明》，写这篇文章时最新版本的使用说明为：《EVB_Air724UG_A14 开发板使用说明》；开发板使用过程中遇到任何问题，可以直接参考这份使用说明文档。

api文档：
https://doc.openluat.com/wiki/21?wiki_page_id=2068

2.2 数据通信线

USB 数据线一根（micro USB）。

2.3 PC 电脑

WIN7以及以上版本的WINDOWS系统。

2.4 SIM 卡

中国大陆环境下，可以上网的 SIM 卡。一般来说，使用移动，电信，联通的物联网卡或者手机卡都行。

2.5 组装硬件环境

USB 数据线插入 USB 口，另一端与电脑相连，拨码开关全部拨到 ON，串口切换开关选择 UART1,USB 供电的 4V 对应开关拨至 ON 档，SIM 卡放到 SIM 卡槽中锁紧，如下图所示。

三、准备软件环境

3.1 下载调试工具

使用说明参考：

Luatools 下载和详细使用：
https://docs.openluat.com/Luatools/

3.2 源码及固件

3.2.1 底层 core 下载

下载底层固件，并解压

链接：
https://docs.openluat.com/air724ug/luatos/firmware/

如下图所示，红框的是我们要使用到的。

3.2.2 本教程使用的 demo 见附件：

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

3.3 下载固件和脚本到开发板中

打开 Luatools，开发板上电开机，如开机成功 Luatools 会打印如下信息。

点击项目管理测试选项。

进入管理界面，如下图所示。

点击选择文件，选择底层固件，我的文件放在 D:luatOSAir724 路径中

点击增加脚本或资源文件，选择 之前下载的程序源码，如下图所示。

点击下载底层和脚本，下载完成如下图所示。

四、代码示例介绍

4.1 API 说明

--注册闹钟模块

rtos.init_module(rtos.MOD_ALARM)

--注册闹钟消息的处理函数（如果是开机闹钟，闹钟事件到来时会调用 alarmsg）

rtos.on(rtos.MSG_ALARM,alarMsg)

模块进行 lua 开发的 lua 虚拟机架设在 RTOS 操作系统之上，所以在设置完系统时间，闹钟开关机时间之后，需要将闹钟消息进行注册，才能对操作系统进行开关机启动操作

--设定闹铃

rtos.set_alarm(1,onTimet.year,onTimet.month,onTimet.day,onTimet.hour,onTimet.min,onTimet.sec)

set_alarm 接口参数中的第一个参数 1 表示开启闹钟，0 表示关闭闹钟

闹钟关机之后，模块将进入超低功耗模式，此时停止解析应用层的代码，大部分协议栈也将停止，所以闹钟开机需软件主动重启一次

4.2 testAlarm.lua 代码

首先通过 misc.setClock()接口函数手动设置当前系统时间，该函数可传入 table 类型的变量，依次包含年、月、日、时、分、秒等 6 个参数，设置后，系统时间即更新生效；通过 rtos.set_alarm()接口函数设置闹钟关机后再次开机的时间间隔，在这里修改为 60，即模块关机 60S 后再次开机：

4.3 main.lua 代码

本代码为主程序脚本，系统启动后首先会对 4G 网络进行配置，等待网络连接成功，然后加载测试模块。

五、开机调试

5.1 开发板开机

连接好硬件并下载固件后，启动 Luatools 软件，系统运行信息将显示在界面中。红框中为开发板连接到 PC 机后正常打印的信息，如下图所示。

5.2 功能调试

5.2.1 设置闹钟

通过misc.setClock()接口函数手动设置当前系统时间，然后通过rtos.set_alarm()接口函数设置闹钟关机后再次开机的时间间隔，在这里修改为60，即模块关机开始60S后再次开机`。

5.2.2 闹钟时间到打印输出

六、常见问题

6.1 为什么烧录完 demo 之后，用户反映不能进行闹钟关机？

答：demo 中已经将闹钟关机的函数屏蔽掉，需要用户释放时才能进行闹钟关机。

6.2 为什么烧录完 demo 之后，用开发板测试时发现代码中设定的时间跟我们看到的网络时间不一样，甚至比当前的时间早，但是还是会安装设定的时间间隔开机？

答：demo 中设定的时间为手动设置，并没有与网络时间同步，模块是以手动设定的时间为基础计时运行。

分享完毕。


审核编辑 黄宇