第一部分 modem模块

modem模块提供设备信息获取相关功能。

1. 设备信息获取

import modem
modem.getDevImei()

2. 获取设备型号

modem.getDevModel()

3. 获取设备序列号

modem.getDevSN()

4. 获取设备固件版本号

modem.getDevFwVersion()

5. 获取设备的制造商ID

modem.getDevProductId()

---

第二部分 misc模块

misc提供关机、软件重启、PWM以及ADC相关功能。

一. misc.Power 关机以及软件重启模块

1. 模块关机

from misc import Power
Power.powerDown()

2. 模块重启

Power.powerRestart()

3. 获取模块启动原因

Power. powerOnReason()

返回值: 开机原因
1：正常电源开机
2：重启
3：VBAT
4：RTC定时开机
5：Fault
6：VBUS
0：未知

4. 获取模块上次关机原因

Power. powerDownReason()

返回值
1：正常电源关机
2：电压过高
3：电压偏低
4：超温
5：WDT
6：VRTC 偏低
0：未知

5. 获取电池电压，单位mV

Power. getVbatt()

二. misc.PWM

详见第二篇PWM部分 : https://www.jianshu.com/p/57e38295105a

三. misc.ADC

详见第二篇ADC部分 : https://www.jianshu.com/p/57e38295105a

---

第三部分 低功耗

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

注意: 模组如果需要需要进入低功耗模式，必须满足以下几个条件：

• USB 拔出
• 系统唤醒锁全部释放（唤醒锁的数量可通过pm.get_wakelock_num()接口获取）
• 无外部引脚中断干扰
• 使能系统自动进入休眠（具体接口：pm.autosleep(sleep_flag)）
• CFUN=0 或者为正常注网状态

1. 创建wake_lock锁 (保持唤醒锁)

import pm
lpm_fd = pm.create_wakelock(lock_name, name_size)
# 例如:
lpm_fd = pm.create_wakelock("test_lock", len("test_lock"))

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

2. 删除wake_lock锁 (删除保持唤醒锁)

pm.delete_wakelock(lpm_fd)

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

3. 加锁 (保持唤醒锁上锁)

pm.wakelock_lock(lpm_fd)

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

4. 释放锁 (保持唤醒锁释放锁)

pm.wakelock_unlock(lpm_fd)

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

5. 获取已创建的锁数量

pm.get_wakelock_num()

6. 自动休眠模式控制

pm.autosleep(sleep_flag)

关于低功耗的注意点

关于低功耗:
需要大家仔细学习如下文档: https://python.quectel.com/doc/doc/Advanced_development/zh/QuecPythonSub/PM.html

要注意:

1. USB插着是不会进入低功耗的
2. 释放所有锁
3. 不能有中断信号打断
4. pm.autosleep(1)

低功耗调试方案

由于USB插着是不会进入低功耗的, 所以我们需要拔掉USB线再调试
USB拔掉了怎么查看调试信息呢???
我们要用UART0 UART0是模块预设的DEBUG UART

这里我们要用UART0连接串口调试助手来看了.
调试信息如果想打在DEBUG UART中, 应该使用uart.write方法, 如下例:

import pm
import utime
from machine import UART
lpm_fd = pm.create_wakelock("test_lock", len("test_lock"))  # 创建wakelock锁
uart_debug = UART(UART.UART0, 115200, 8, 0, 1, 0)
pm.autosleep(1)  # 设置自动休眠模式
# 模拟测试，实际开发请根据业务场景选择使用
while 1:
    utime.sleep(10)  # 休眠
    res = pm.wakelock_lock(lpm_fd)   #添加锁
    uart_debug.write("ql_lpm_idlelock_lock, g_c1_axi_fd = %d" %lpm_fd)
    uart_debug.write("unlock  sleep")
    utime.sleep(10)
    res = pm.wakelock_unlock(lpm_fd)  #释放锁
    uart_debug.write("%d"%res)
    uart_debug.write("ql_lpm_idlelock_unlock, g_c1_axi_fd = %d" % lpm_fd)
    num = pm.get_wakelock_num()  # 获取已创建锁的数量
    uart_debug.write("%d"%num)

使用AT指令查看低功耗设置情况

我们可以使用AT指令,查看低功耗设置情况:

1. 连接USB, 使用QCOM打开AT 口
2. 发送AT指令: AT+log=80,1 //此指令会定时3s从调试串口打印内部休眠相关的Flag 和寄存器值
3. 用USB转串口工具连接debug口(UART0), 然后在PC上查看调试信息

上述log主要查看前四个参数：

• PMEnableSleep：休眠总开关
• PMEnableSleep：允许进入休眠开关
• PMEnableSleep： USB状态
• PMEnableSleep： UART状态

以上四个参数是“1，1，0，0”基本可以表明模组已经进入了休眠。后面的参数是唤醒寄存器的值，通过该值可以具体查看哪些唤醒源没有被清除。

---

第四部分 example - 执行python脚本

模块功能：提供方法让用户可以在命令行或者代码中执行python脚本

import example
example.exec(filePath)