发布文章
在Open开发环境中，电源管理API是平衡性能与功耗的利器。无论是实时监测电量消耗、智能调度任务执行时机，还是精细化控制硬件模块休眠策略，这些API为开发者提供了完整的技术工具链。本文精选核心API，结合实战案例解析其应用场景与优化技巧，助你打造续航更持久的应用。
最新资料详见：https://docs.openluat.com/air780epm/luatos/api/core/pm/
在实际应用中可灵活结合硬件设计，实现物联网设备超低功耗待机、动态性能优化、电池保护及系统防崩溃的完整电源管理方案。
一、Air780EPM低功耗模式
1.1 功耗模式定义及典型功耗
Air780EPM三种功耗模式的介绍，“常规模式”、“低功耗模式”、“PSM+模式”，以及典型实网环境条件下的功耗测试数据，如下表所示：
1.2 如何设置Air780EPM功耗模式
我知道你一定会问：为什么1和2都是低功耗模式？Why？
历史原因，pm.WORK_MODE在LuatOS中定义了4个模式，但是，就Air780EPM这一特定型号来说，为了方便理解和简化设计，只定义了3种功耗模式，所以就出现了1和2都是低功耗模式的结果。
注意：1和2没有任何区别，设置1和2都是同一个低功耗模式，请大家在设计时务必注意！！！
1.3 pm.power(id, int)
设置Air780EPM进入常规模式、低功耗模式、PSM+模式的函数。
1）参数：
id：int型（功耗模式控制id，pm.WORK_MODE）；
int：int型（0，常规模式；1，低功耗模式；2，低功耗模式；3，PSM+模式； ）。
2）返回值：
返回值类型：boolean；
说明：处理结果true成功，false失败。
3）例子：
二、与定时器唤醒相关的函数
2.1 pm.dtimerStart(id, timeout)
启动底层定时器，在常规模式/低功耗模式/PSM+模式下都可以生效，只触发一次；注意，关机状态下无效。
1）参数：
id：int型
定时器id；Air780EPM可以设置多个定时器，不同的定时器ID代表不同的定时器进程；一般来说，定时器进程不要超过6个。相应的，定时器ID的取值范围是0-5； 其中，0和1的最大休眠时长是2.5小时，2到5的最大休眠时长是740小时。
timeout：int型（定时时长，单位毫秒）。
2）返回值：
返回值类型：boolean；
说明：处理结果。
3）例子：
2.2 pm.dtimerStop(id)
关闭底层定时器
1）参数：
id：int型（定时器id）；
2）返回值：无
3）例子：
2.3 pm.dtimerCheck(id)
检查底层定时器是不是在运行。
1）参数：
id：int型（定时器id）；
2）返回值：
返回值类型：boolean（处理结果，true还在运行，false不在运行）；
返回值类型：number（如果运行，运行剩余时间，单位毫秒）。
3）例子：
2.4 dtimerWkId()
检查定时唤醒是哪一个定时器，如果不是定时唤醒的，返回-1。
1）参数：无
2）返回值：
int型（处理结果 >=0 是本次定时唤醒的定时器ID，其他错误，说明不是定时唤醒的）。
3）例子：
三、开机、关机、重启等相关函数
3.1 pm.lastReson()
Air780EPM共有如下几种开机形式：
PSM+模式下，RAM掉电，PSM+模式前数据丢失，退出PSM+模式后代码需要从头开始运行，这个过程，也被视为"开机"；
从PSM+模式到低功耗模式或常规模式，原因有 定时器唤醒、WAKEUP唤醒、开机键唤醒、UART1唤醒 四种唤醒方式，这四种唤醒方式，是Air780EPM的开机原因之一；
除从PSM+模式到低功耗模式或常规模式的开机之外，还有关机状态下的PWRKEY开机、常规模式/低功耗模式/PSM+模式下的Reset重启，闹钟开机、软件重启、LuaTools等工具控制重启、内部看门狗重启、外部重启以及程序跑飞下的异常开机等。
pm.lastReson()函数，就是用来识别和返回Air780EPM这些开机原因的函数。
1）参数：
id：int型
定时器id；Air780EPM可以设置多个定时器，不同的定时器ID代表不同的定时器进程；一般来说，定时器进程不要超过6个。相应的，定时器ID的取值范围是0-5； 其中，0和1的最大休眠时长是2.5小时，2到5的最大休眠时长是740小时。
timeout：int型（定时时长，单位毫秒）。
2）返回值：
3）例子：
3.2 pm.shutdown()
用于关机。
1）参数：无
2）返回值：nil（无返回值）
3）例子：
3.3 pm.reboot()
用于重启。
1）参数：无
2）返回值：nil（无返回值）
3）例子：
四、IO电平介绍及相关设置函数
pm.ioVol(id, val)
IO高电平电压控制函数
Air780EPM的IO高电平，出厂默认3.0V：
可以通过将Air780EPM的PIN100:IO_Volt_Set拉低到GND改变IO高电平，开机即设置为1.8V；
也可以通过此函数，将IO高电平设置为典型值1.8V/2.8V/3.0V/3.3V。注意！设置IO高电平，实际设置的是Air780EPM的PIN24:VDD_EXT的电压，IO高电平与VDD_EXT电压保持一致。
任何情况下，无论Air780EPM的PIN100:IO_Volt_Set是悬空还是下拉到GND，IO高电平都是以本函数的设置为优先。
1）参数：
id：int型(电平id，目前只有pm.IOVOL_ALL_GPIO）；
val：int型（电平值，单位毫伏）。
2）返回值：
返回值类型：boolean（处理结果true成功，false失败）。
3）例子：
五、相关补充说明
5.1 关于PSM+模式的补充说明
PSM+模式下，模组处于离线状态，无法接收服务器下发信息；退出PSM+模式后，Air780EPM大概在3秒内可以驻网成功。
5.2 关于低功耗模式的补充说明
给出的低功耗模式下的数据，是在特定条件下的测试数据，比如，DRX=2.56秒。
实际环境下，信号质量、DRX间隔等都是由模组所处环境的基站决定，模组并不能自行设置。因此，功耗表现可能与测试数据有差异。
一般情况下，低功耗模式下，模组的功耗在1mA左右都可以被认为是正常表现。
5.3 关于WAKEUP中断唤醒的补充说明
模组在PSM+模式下有四种常见的唤醒方式：
定时器唤醒；
开机键PWRKEY；
串口UART1接收数据；
WAKEUP中断；
其中，WAKEUP中断的使用方式会在API库GPIO中进行介绍，开机键PWRKEY本质上也是WAKEUP。
比如：WAKEUP0，则用gpio.WAKEUP0；pwrkey，则用常量 gpio.PWR_KEY。
5.4 关于PWRKEY开机和Reset复位的补充说明
Air780EPM默认开启了PWRKEY开机防抖；因为开启了PWRKEY开机防抖，所以Reset复位功能就转变成了关机，不能复位。
所以，Air780EPM的Reset是关机，不是复位！
Air780EPM最新开发资料详见：
www.air780epm.cn
今天的内容就分享到这里了~
*博客内容为网友个人发布，仅代表博主个人观点，如有侵权请联系工作人员删除。
