闲言碎语
有关注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可能会是更合适的选择。