第一部分 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
要注意:
- USB插着是不会进入低功耗的
- 释放所有锁
- 不能有中断信号打断
- 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指令,查看低功耗设置情况:
- 连接USB, 使用QCOM打开AT 口
- 发送AT指令: AT+log=80,1 //此指令会定时3s从调试串口打印内部休眠相关的Flag 和寄存器值
- 用USB转串口工具连接debug口(UART0), 然后在PC上查看调试信息
上述log主要查看前四个参数：
- PMEnableSleep：休眠总开关
- PMEnableSleep：允许进入休眠开关
- PMEnableSleep： USB状态
- PMEnableSleep： UART状态
以上四个参数是“1，1，0，0”基本可以表明模组已经进入了休眠。后面的参数是唤醒寄存器的值，通过该值可以具体查看哪些唤醒源没有被清除。
第四部分 example - 执行python脚本
模块功能：提供方法让用户可以在命令行或者代码中执行python脚本
import example
example.exec(filePath)
