pm - 低功耗

在无业务处理时使系统进入休眠状态，进入低功耗模式。

使用示例

模拟测试，实际开发请根据业务场景选择使用！

import pm
import utime

# 创建wakelock锁
lpm_fd = pm.create_wakelock("test_lock", len("test_lock"))
# 设置自动休眠模式
pm.autosleep(1)

# 模拟测试，实际开发请根据业务场景选择使用
while 1:
    utime.sleep(20)  # 休眠
    res = pm.wakelock_lock(lpm_fd)
    print("ql_lpm_idlelock_lock, g_c1_axi_fd = %d" %lpm_fd)
    print("unlock  sleep")
    utime.sleep(20)
    res = pm.wakelock_unlock(lpm_fd)
    print(res)
    print("ql_lpm_idlelock_unlock, g_c1_axi_fd = %d" % lpm_fd)
    num = pm.get_wakelock_num()  # 获取已创建锁的数量
    print(num)

创建wake_lock锁

pm.create_wakelock

pm.create_wakelock(lock_name, name_size)

创建wake_lock锁。

参数描述

• lock_name，自定义lock名，string类型。
• name_size， 可选参数，lock_name的长度， int类型。

返回值描述

成功返回wakelock的标识号，否则返回 -1。

BC25PA平台不支持此方法。

删除wake_lock锁

pm.delete_wakelock

pm.delete_wakelock(lpm_fd)

删除wake_lock锁。

参数描述

• lpm_fd，需要删除的锁对应标识id，int类型。

返回值描述

成功返回 0。

BC25PA平台不支持此方法。

加锁

pm.wakelock_lock

pm.wakelock_lock(lpm_fd)

将指定的wakelock置于锁定状态，存在锁定状态的锁时，模组不会进入低功耗状态

参数描述

• lpm_fd，需要执行加锁操作的wakelock标识id，int类型。

返回值描述

成功返回 0，否则返回 -1。

BC25PA平台不支持此方法。

释放锁

pm.wakelock_unlock

pm.wakelock_unlock(lpm_fd)

释放锁，所有wakelock被释放时，模组才允许进入低功耗

参数描述

• lpm_fd，需要执行释放锁操作的wakelock标识id，int类型。

返回值描述

成功返回 0，否则返回 -1。

BC25PA平台不支持此方法。

自动休眠模式控制

pm.autosleep

pm.autosleep(sleep_flag)

自动休眠模式控制

参数描述

• sleep_flag，0关闭自动休眠， 1开启自动休眠，int类型。

返回值描述

成功返回 0，失败返回 -1

获取已创建的锁数量

pm.get_wakelock_num

pm.get_wakelock_num()

获取已创建的锁数量

返回值描述

int类型，返回已创建wakelock锁的数量。

BC25PA平台不支持此方法。

设置PSM模式的控制时间

pm.set_psm_time

pm.set_psm_time(tau_uint,tau_time,act_uint,act_time)  # 设置并启用PSM <模式1>

pm.set_psm_time(mode)# 单独设置启用或禁用 <模式2>

参数描述

• mode，是否启用PSM，int类型:
  0禁用PSM
  1启用PSM
  2(仅BC25平台)禁用PSM并删除PSM的所有参数，如有默认值，则重置默认值。(注意此种模式禁用的情况下，如果要启用PSM必须用模式1，用模式2没有任何的意义,因为设置的TAU和ACT时间全部清零了。)
• tau_uint，tau(T3412)定时器单位，int类型。

• tau_time，tau(T3412)定时器时间周期值，int类型。
• act_uint，act(T3324)定时器单位，int类型。

• act_time，act(T3324)定时器时间周期值，int类型。

实际设置的tau和act，为单位值和周期值的积

返回值描述

True: 成功
False: 失败

示例

>>> import pm
>>> pm.set_psm_time(1,2,1,4)  #设置tau定时器周期为 1小时 * 2 = 2小时， act定时器周期值为 1分钟 * 4 = 4分钟。
True
>>>

仅BC25/ECX00U/ECX00E支持

获取PSM模式的控制时间

pm.get_psm_time

pm.get_psm_time()

返回值描述

成功：返回值为list类型，说明如下：

失败：返回 None。

示例

>>> pm.get_psm_time()

[1, 1, 1, 1, 2]

仅BC25/ECX00U/ECX00E平台支持

Classes

• class WakeUp – 唤醒中断