门铃、门锁、电池摄像机这类产品,大部分时间都在睡觉,续航好不好全看低功耗做得怎么样。TXW82x 的 TXW828 系列支持低功耗,SDK 2.7.1.7 也提供了完整的电池摄像机参考方案。这篇讲三种休眠模式怎么选、核心接口怎么用,以及怎么把自己的模块接进低功耗流程。
内容整理自泰芯《TXW82x 低功耗开发指南》V1.0(适用 SDK v2.7.1.7),实测数据基于泰芯电池摄像机开发板。
CUSTOMER_ID 9(电池相机 1080P),另有 CUSTOMER_ID 7(低功耗 720P IPC)。| 模式 | 休眠时 Wi-Fi | 唤醒后 | 唤醒方式 | 休眠电流参考 |
|---|---|---|---|---|
| 1 · Wi-Fi 保活休眠 | 保持连接 | 从休眠点继续运行 | 远程唤醒 / IO / 定时 | 约 338μA |
| 3 · SRAM 保持休眠 | 断开 | 从休眠点继续运行 | IO / 定时 | 约 91μA |
| 5 · RTC 休眠 | 断开 | 系统重启,重新初始化 | IO / 定时 | 约 43μA |
电流数据是官方在电池摄像机开发板上、4.2V 供电、屏蔽环境下的测试参考,你的板子要自己实测。
怎么选:
电池摄像机开发板出厂就烧了 Demo(Flash 被擦了就编译 CUSTOMER_ID 9 重新烧):
AT+SLEEP=5,80000,23,1含义:模式 5(RTC 休眠),80 秒后定时唤醒,唤醒 IO 为 PB7(下降沿,对应 SW1 按键)。休眠期间电流应在 35~45μA,按 SW1 或等 80 秒后唤醒。
开发板的 SW1 按下后接通电源,需要程序启动后自己控制电源开关脚来维持供电;休眠期间也要保持这个脚的输出状态,否则会把自己断电。这一点设计自己的板子时同样要注意。
struct system_sleep_param args;
os_memset(&args, 0, sizeof(args));
args.sleep_ms = 5000; // 5 秒后定时唤醒,填 0 表示不定时唤醒
system_sleep(SYSTEM_SLEEP_TYPE_SRAM_ONLY, &args); // 模式 3system_sleep_param 里还可以配唤醒 IO:
| 字段 | 说明 |
|---|---|
sleep_ms | 定时唤醒时长,毫秒;0 = 只靠 IO 唤醒 |
wkup_io_sel[6] | 最多 6 路唤醒 IO(IO0~IO5)选哪个引脚 |
wkup_io_en | 使能掩码,bit0 对应 wkup_io_sel[0] |
wkup_io_edge | 边沿掩码:0 = 上升沿(芯片自动开下拉),1 = 下降沿(自动开上拉) |
唤醒 IO 优先用 PA0~PA14,这个范围 6 路唤醒源都能选到,兼容性最好。
进入休眠时,没有特别声明的 IO 会被复位,防止浮空漏电。电源使能、TF 卡电源、功放使能这类休眠期间要保持电平的脚,要用掩码声明:
dsleep_set_user_gioa(BIT(0) | BIT(3)); // 休眠期间保持 PA0、PA3 原有状态B~F 口对应 dsleep_set_user_giob() ~ dsleep_set_user_giof()。
休眠时只有常电 SRAM 区域的数据不会丢。需要跨休眠保存的变量,用 __dsleep_data 修饰:
__dsleep_data uint8 wake_count = 0;运行时动态申请用 sys_sleepdata_request(SYSTEM_SLEEPDATA_ID_USER, size)。只用 SYSTEM_SLEEPDATA_ID_USER 这个 ID,其他 ID 是 SDK 内部用的。
休眠时 systick 停止计数(日志时间戳不变),唤醒后 SDK 会补偿系统时间。休眠流程里要计时,用常电域的 RC 定时器 pmu_tmrao_get(),再按校准后的 RC 频率换算成毫秒。
| Hook | 什么时候调用 | 典型用途 |
|---|---|---|
wakeup_hook | IO / 定时唤醒后立刻调用 | 唤醒过滤:比如 PIR 触发 5 次才真正唤醒,否则返回「继续休眠」,避免干扰脉冲误唤醒 |
ready_hook | 射频就绪后调用 | 主动发保活包,周期性向服务器上报状态 |
rx_hook | 收到 MAC 层数据包时调用 | 判断是不是有效的唤醒报文(在中断里执行,要尽快返回) |
wakeup_hook 的返回值决定接下来怎么走:DSLEEP_ACTION_SLEEP_CONTINUE 放弃本次唤醒继续睡,DSLEEP_ACTION_SLEEP_EXIT 正常唤醒,DSLEEP_ACTION_DO_NOTHING 交给框架默认处理。
参考代码的远程唤醒检测是「收到任意 TCP 包就唤醒」。量产产品应该再校验源 IP、端口或报文内容,否则网络上的杂包会频繁把设备唤醒,严重影响续航。
真实产品睡觉前,要先把 TF 卡、摄像头、ISP、音频这些模块停掉;醒来后再按顺序恢复。SDK 的 sdk/app/lowPower_app 框架帮你管这件事:每个模块提供一对 suspend / resume 回调,注册成一个数组,框架自动按顺序调用。
1. 确认工程打开了 CONFIG_SLEEP,并且在 wifi.c 里调用了 bgn_dsleep_init()。
2. 每个模块写 suspend / resume 回调:suspend 返回前要确认相关任务、DMA、中断都停了;resume 按初始化依赖恢复,不要重复创建任务。成功返回 RET_OK。
3. 按上电初始化的顺序排数组:
static const struct lowPower_module_ops user_lowpower_modules[] = {
{"power", user_power_suspend, user_power_resume, {NULL, NULL, NULL, NULL}},
{"sensor", user_sensor_suspend, user_sensor_resume, {&g_sensor, &g_sensor_cfg, NULL, NULL}},
{"service", user_service_suspend, user_service_resume, {NULL, NULL, NULL, NULL}},
};框架规则:suspend 从数组末尾往前执行,resume 从前往后执行。 上面的数组睡前依次停 service → sensor → power,醒后依次恢复 power → sensor → service。某个模块 suspend 失败时,框架会把已经停掉的模块恢复回来。
4. 业务模块都初始化完以后,注册一次:
lowpower_app_init(user_lowpower_modules, ARRAY_SIZE(user_lowpower_modules));一个应用只调用一次,再调用会清空之前的模块表。
5. 业务需要时调用 system_sleep(),框架会自动执行 suspend,唤醒后自动调度 resume。
电池相机方案的模块表可以直接参考,它注册了 7 个模块:电源前置、SD、MIPI、ISP、VPP、音频、电源后置。
执行顺序只看数组位置,和模块名字里的prev/post无关。设计新板子时,按外围器件的上下电要求重新检查数组顺序。
dsleep_set_ext_dcdc(1),休眠期间关闭内部 LDO,进一步降低功耗。bgn_dsleep_init 的 flags 里使能。做电池产品遇到功耗问题,欢迎在社区提问,附上休眠模式、电流曲线和唤醒方式。