20、nodeMCU学习笔记--cron模块

闲言碎语

有关注nodemcu的简友应该知道，项目组最近更新了一些新的模块，比如这回要说的cron模块。这是个时间有关的模块，用来提供计划任务或者说是定时执行任务。有了这个模块，就不需要自己写个tmr来回调了。

使用这个模块需要RTC的支持，所以别忘记添加rtctime模块！

模块函数

cron模块的函数还是比较少的，只有5个。

|序号|函数名|参数|返回值|
|:--|:--:|:---:|:--:|--:|
|1|cron.schedule()|mask, callback|sub model
|2|cron.reset()|空|nil|
|3|cron.entry:handler()|callback | nil|
|4|cron.entry:schedule()|mask |nil|
|5|cron.entry:unschedule()|空|空|

使用的方法也是比较简单的。通过mask设置执行的时间，然后通过回调在时间到的时候执行任务。mask的格式如下：

 ┌───────────── minute (0 - 59)
 │ ┌───────────── hour (0 - 23)
 │ │ ┌───────────── day of month (1 - 31)
 │ │ │ ┌───────────── month (1 - 12)
 │ │ │ │ ┌───────────── day of week (0 - 6) (Sunday to Saturday;
 │ │ │ │ │                                       7 is also Sunday)
 │ │ │ │ │
 │ │ │ │ │
 * * * * *  

具体的用法，用例子来解析会比较好理解。

mask	用意
* * * * *	表示每分钟执行一次任务
*/10 * * * *	表示每10分钟执行一次任务
1 * * * *	表示每个 *：1的时候执行一次任务

.schedule()：用来创建一个计划任务，同时返回一个cron模块；
.reset()：将会移除所以计划任务；
:handler()：可以用来修改一个计划所执行的任务；
:schedule()：用来修改一个计划的mask；
:unschedule()：用来取消一个计划，并没有移除，可以通过:schedule()重新启动任务。

实践一下

虽然cron模块看起来蛮简单的，也让我折腾了一段时间。

在设置执行任务时，需要用到RTC，确保添加了RTC模块。另外，如果要设置时间，记得添加sntp模块使用sntp.sync来联网同步。联网同步则需要确保设备连入wifi。联网和同步的方法还请参照前面的文章。

测试了一下，mask支持三种格式：、/n、n。

下面的代码实现每分钟执行一次计划任务。
cron.schedule("* * * * *", function(e) print("Every minute") end)

如果要隔n分钟执行一次，比如20分钟执行一次，可以这样写，
cron.schedule("*/20 * * * *", function(e) print("Every minute") end)

如果要每一小时执行一次，比如在每小时20分钟的时候执行任务。可以这样写
cron.schedule("20 * * * *", function(e) print("Every minute") end)

下面这个代码也可以实现每分钟打印，
cron.schedule("*/1 * * * *", function(e) print(e) end)
根据猜测，这种写法"* */1 * * *"也可以实现每小时执行一次任务。只是时间太久没测试。

另外，回调函数传入任务的句柄（暂且称句柄），所以可以在回调函数function(e)中使用e:handler()来修改执行的任务；也可以使用e:schedule()调整计划周期；亦或者使用e:unschedule()取消这个计划任务。

要注意一下，使用e:unschedule()取消计划任务后，回调将不会再执行，如果还想重新启动这个计划任务的话，是没办法用e:schedule()的，因为没法得到句柄。所以建议使用下面这种写法，
handle = cron.schedule("* * * * *", function(e) --you work in here end)

cron的用法就介绍到这里。如果你在做一些小玩意需要用到定时执行的时候，现在除了tmr，还多了cron可以选择。特别是现在具体的某个时刻执行任务的时候，cron可能会是更合适的选择。