最终提交

4G/源代码/lib/pm.lua

@@ -0,0 +1,65 @@
+--- 模块功能：休眠管理
+-- @module pm
+-- @author openLuat
+-- @license MIT
+-- @copyright openLuat
+-- @release 2017.10.22
+module(..., package.seeall)
+
+--[[
+关于休眠这一部分的说明：
+目前的休眠处理有两种方式，
+一种是底层core内部，自动处理，例如tcp发送或者接收数据时，会自动唤醒，发送接收结束后，会自动休眠；这部分不用lua脚本控制
+另一种是lua脚本使用pm.sleep和pm.wake自行控制，例如，uart连接外围设备，uart接收数据前，要主动去pm.wake，这样才能保证前面接收的数据不出错，当不需要通信时，调用pm.sleep；如果有lcd的项目，也是同样道理
+不休眠时功耗至少30mA左右
+如果不是故意控制的不休眠，一定要保证pm.wake("A")了，有地方去调用pm.sleep("A")
+]]
+--唤醒标记表
+local tags = {}
+--lua应用是否休眠，true休眠，其余没休眠
+local flag = true
+
+--- 某个Lua应用唤醒系统
+-- @param tag 一般string类型，某个Lua应用的唤醒标记，用户自定义
+-- @return 无
+-- @usage pm.wake(tag)
+function wake(tag)
+    assert(tag and tag ~= nil, "pm.wake tag invalid")
+    --唤醒表中此唤醒标记位置置1
+    tags[tag] = 1
+    --如果lua应用处于休眠状态
+    if flag == true then
+        --设置为唤醒状态
+        flag = false
+        --调用底层软件接口，真正唤醒系统
+        pmd.sleep(0)
+    end
+end
+--- 某个Lua应用休眠系统
+-- @param tag 一般string类型，某个Lua应用的唤醒标记，用户自定义，跟wake中的标记保持一致
+-- @return 无
+-- @usage pm.sleep(tag)
+function sleep(tag)
+    assert(tag and tag ~= nil, "pm.sleep tag invalid")
+    --唤醒表中此休眠标记位置置0
+    tags[tag] = 0
+    --只要存在任何一个标记唤醒,则不睡眠
+    for k, v in pairs(tags) do
+        if v > 0 then
+            return
+        end
+    end
+    flag = true
+    --调用底层软件接口，真正休眠系统
+    pmd.sleep(1)
+end
+
+--- pm.isSleep([tag]) 读取某个Lua应用或者全局的休眠状态
+-- @param tag 可选参数，如果查询某个tag的休眠状态，则跟wake中的tag保持一致；如果查询全局休眠状态，则不需要这个参数
+-- @return true休眠，其余没休眠
+-- @usage
+-- pm.isSleep() -- 查询全局休眠状态
+-- pm.isSleep('lcd') -- 查询lcd的休眠状态
+function isSleep(tag)
+    return tag and tags[tag] ~= 1 or flag
+end