这篇写给要在 TXW81x 上做电池供电产品(如低功耗 MiniDV、低功耗带屏音视频产品)的软件工程师:先搞清楚 SDK 提供了哪几种休眠模式、各自省多少电、醒来后程序是接着跑还是从头跑;再把进入休眠、配置唤醒源、处理唤醒原因这几步走通;最后对照官方测试条件,把功耗测准。
技术细节以泰芯官方《泰芯TXW81x低功耗开发指南》为准。
1. 型号支持低功耗。 官网参数表里标注「低功耗 √」的型号是 TXW812-310、TXW818-C08L、TXW818-C04L。TXW818 数据手册注明:型号带「L」的内置并支持 Buck DCDC。型号怎么挑可以看 《TXW81x 型号怎么选:812/813/816/817/818 区别与 SDK 版本选择》。
2. SDK 版本够新。 按官方 SDK 选型表,FPV SDK 从 2.5.3 起加入低功耗(面向低功耗 MiniDV、低功耗带屏音视频产品);WNB、IOT 两类 SDK 也是 2.5.3 起支持低功耗。
3. 工程配置里的 CONFIG_SLEEP。 低功耗功能靠 CONFIG_SLEEP 编译进来(RTC 闹钟唤醒也要求打开它)。反过来,不做低功耗的项目,要在工程配置里删除 CONFIG_SLEEP,这是选型表里专门写明的。
另外先想清楚方案形态,两种开发方式不太一样:
| 方案 | TXW81x 负责什么 | 用哪套 SDK |
|---|---|---|
| 单芯片方案 | Wi-Fi(含低功耗)+ 音视频全部在 81x 上 | FPV SDK 二次开发 |
| 带主控方案 | 81x 只做 Wi-Fi 和休眠保活,音视频在主控上 | 81x 作为 Wi-Fi 模组,配合主控 |
| 模式 | 宏 | 休眠时 Wi-Fi | 休眠时 SRAM | 唤醒后 | 典型用途 |
|---|---|---|---|---|---|
| 模式 1 | SYSTEM_SLEEP_TYPE_SRAM_WIFI | 保持连接 | 全部带电 | 从休眠处接着运行 | 休眠中还要和云端保活,要远程唤醒、醒得快 |
| 模式 2 | SYSTEM_SLEEP_TYPE_WIFI_DSLEEP | 保持连接 | 只有前 32K 带电 | 复位,重新初始化 | 要远程唤醒,但不需要应用层保活,对唤醒速度要求不高 |
| 模式 3 | SYSTEM_SLEEP_TYPE_SRAM_ONLY | 断开 | 全部带电 | 接着运行,Wi-Fi 自动重新打开 | 只靠本地 IO / 定时器唤醒,不需要远程唤醒 |
| 模式 4 | SYSTEM_SLEEP_TYPE_LIGHT_SLEEP | 仅关闭无线收发 | 全部带电 | 接着运行 | 暂停无线,但 CPU 低速运行,LED、UART 等外设还要工作 |
| 模式 5 | SYSTEM_SLEEP_TYPE_RTCC | 无 | 32K 带电 | 外部电源恢复后重新初始化 | 主电源掉电后由锂电池维持,只保留 RTC 计时 |
| 模式 6 | SHUTDOWN(关机) | 无 | 不保留 | 复位重启 | 彻底关机,由 CHIP_EN 控制 |
选型思路可以按这个顺序问自己:
休眠期间 PA2 / PA3 / PA8 / PA11 可以输出硬件 PWM(可用于呼吸灯)。硬件设计指南特别提醒:低功耗保活状态下这四个脚被用作硬件 PWM,如果你想让它们在休眠中保持电平,只能设为 INPUT,不能设为 OUTPUT;其它 PA 口不受此限制。
所有模式都用同一个函数进入休眠,区别只在参数:
system_sleep(uint16 type, struct system_sleep_param *args);
struct system_sleep_param {
uint32 sleep_ms;
uint8 wkup_io_sel[6]; // 选择唤醒 IO0 ~ IO5
uint8 wkup_io_en; // 0: 关闭; 1: 使能
uint8 wkup_io_edge; // 0: 上升沿; 1: 下降沿
};| 字段 | 含义 |
|---|---|
type | 休眠模式,即上表里的宏 |
sleep_ms | 休眠时长(ms),到时由内部定时器唤醒;填 0 表示不用定时器唤醒 |
wkup_io_sel[6] | 最多同时选 6 路唤醒 IO |
wkup_io_en | 按 bit 使能:bit0 对应 wkup_io_sel[0],bit1 对应 wkup_io_sel[1],以此类推 |
wkup_io_edge | 按 bit 选边沿:0 上升沿、1 下降沿,芯片内部会自动打开对应的下拉或上拉 |
6 路唤醒源能映射的引脚如下:
| 唤醒源 | PA | PB | PC |
|---|---|---|---|
| IO0 | PA0-PA14 | PB0-PB15 | 无 |
| IO1 | PA0-PA14 | PB0-PB15 | PC0 |
| IO2 | PA0-PA15 | PB0-PB15 | 无 |
| IO3 | PA0-PA14 | PB0-PB14 | PC5 |
| IO4 | PA0-PA14 | PB0-PB14 | PC1、PC4 |
| IO5 | PA0-PA14 | PB0-PB14 | PC2、PC3 |
唤醒脚优先用 PA0~PA14:6 路唤醒源都支持,而且默认休眠后只有 PA 口有电。如果一定要用 PB(VCAM 电源域)或 PC 口,需要调用dsleep_set_user_giob(user_giob)把它设为用户 IO,参数每个 bit 对应一个脚,例如0x08表示 PB3。
| 唤醒方式 | 说明与配置 |
|---|---|
| 远程唤醒 | 前提是休眠时 Wi-Fi 保持连接(模式 1、2)。默认 App 发任意数据包都会唤醒;设置唤醒数据后只有匹配的数据才唤醒 |
| IO 唤醒 | 进入休眠时通过 system_sleep 的 wkup_io_* 字段设置,最多 6 路 |
| 定时器唤醒 | 进入休眠时通过 sleep_ms 设置休眠时长 |
| API 唤醒 | 仅模式 4 支持,调用 system_wakeup |
| 比较器唤醒 | 支持两路,休眠时把两个 IO 设为比较器的 N 端和 P 端,比较器输出满足条件时唤醒 |
| RTC 闹钟唤醒 | dsleep_rtc_alarm_cfg,见第六节 |
不设唤醒数据时,网络上发给设备的任意数据包都会把它叫醒,实际产品里很容易被频繁误唤醒,白白耗电。正确做法是用 sys_sleepdata_request 设置唤醒数据,只有收到匹配内容才唤醒。可直接参考 SDK 里 sdk/lib/net/utils/udp_kalive.c 的 udp_kalive_init()。
LMAC_WKDATA_SIZE、LMAC_WKDATA_COUNT。wkdata->count 必须等于 LMAC_WKDATA_COUNT,wkdata->wkdata_size 必须等于 LMAC_WKDATA_SIZE,否则会出问题。醒来后调用 uint8 sys_wakeup_reason(void) 查询原因,再决定做什么。常用的几个:
| 返回值 | 宏 | 含义 |
|---|---|---|
| 1 | DSLEEP_WK_REASON_TIMER | 定时器到时 |
| 2 | DSLEEP_WK_REASON_TIM | 收到单播数据,通常就是远程唤醒 |
| 3 | DSLEEP_WK_REASON_BC_TIM | 收到广播数据 |
| 4 | DSLEEP_WK_REASON_IO | IO 唤醒 |
| 5 | DSLEEP_WK_REASON_BEACON_LOST | AP 的 Beacon 丢失 |
| 6 | DSLEEP_WK_REASON_AP_ERROR | 检测到 AP 异常,通常是路由器重启了 |
| 7 | DSLEEP_WK_REASON_HB_TIMEOUT | 远程心跳超时 |
| 8 | DSLEEP_WK_REASON_WK_DATA | 唤醒数据匹配 |
| 10 | DSLEEP_WK_REASON_LVD | 低电复位 |
| 13 | DSLEEP_WK_REASON_PS_DISCONNECT | AP 在设备休眠时断开了连接 |
| 15 | DSLEEP_WK_REASON_MAX_IDLE_TMO | AP 判定保活超时 |
完整枚举见 SDK 中的 DSLEEP_WK_REASON。RTC 闹钟唤醒时返回 25。
模式 1 休眠时要先把应用和设备「挂起」,醒来再按相反顺序「恢复」:
sys_suspend:挂起应用程序。一般是网络相关模块,进入休眠前停止发数据。dev_suspend:挂起设备,备份设备状态。dev_resume:恢复设备。sys_resume:恢复应用程序,并产生事件 SYSEVT_SYSTEM_RESUME。你需要动手的地方有三处:
1. 注册应用的挂起 / 恢复回调。 受休眠影响的模块在初始化时用 sys_register_sleepcb 注册回调。回调分 4 级:挂起按 STEP1→4 执行,恢复按 STEP4→1 执行。应用代码一般放在 step1 即可,step4 默认留给 SDK 内部协议栈。
2. 处理自己写的外设驱动。 SDK 自带驱动已实现 suspend / resume;自己加的外设驱动要自己实现,否则醒来后状态不对。还有两个弱函数可以重写:
| 弱函数 | 调用时机 | 返回值 |
|---|---|---|
dev_suspend_hook(dev, type) | 每个设备 suspend 之前 | 1 继续挂起,0 跳过该设备 |
dev_resume_hook | 每个设备 resume 之前 | 1 继续恢复,0 跳过;可按唤醒原因决定 |
3. 处理 SYSEVT_SYSTEM_RESUME 事件。 SDK 默认已加了处理代码,在 sys_check_wkreason 里按唤醒原因分支执行。其中的 udp_kalive_start() 是 SDK 提供的 UDP 保活示例:休眠期间定时醒来向服务器发保活包,连续 10 次发送失败就认为链路断开并唤醒主控。照着它改成自己的保活协议即可。
dev_suspend_hook 里终止 UART 的挂起,并重新设置波特率等参数;不需要挂起的应用模块可以不注册 sleepcb。醒来要调 system_wakeup,系统时钟会重新配置,Wi-Fi 自动重连。dsleep_rtc_init(PA_n, PB_n) 初始化,PA 侧(默认 PA8)作 P 端接 VCC33,PB 侧(默认 PB9)作 N 端参考电压,可选范围分别是 PA_0~PA_14、PB_0~PB_14。芯片检测到 VCC33 低于 VBAT 时自动休眠,串口打印 sys_sleep...;VCC33 恢复后退出并打印 soft_reset。用 dsleep_rtc_get() 读 RTC 值(uint32,每 1/8 秒加 1)。CHIP_EN 拉低进入关机,拉高后复位重启。wlan0,模组内部协议栈创建 w0,两者 MAC 和 IP 相同,各跑各的程序;模组靠识别 TCP/UDP 数据流来区分数据归谁。模组内部数据流数量有限,打印 NO FREE LOCALID 说明超了,要控制模组内部的连接数。需要「每天几点醒来」这类日历闹钟时,用 RTC 日历接口(工程需打开 CONFIG_SLEEP):
dsleep_rtc_calendar_init(time, date, flags)。time 按 24 小时制写,如 0x00234955 表示 23:49:55;date 含日期和星期,如 0x24041306 表示 2024-04-13 星期六;flags 的 bit0 为 0 用内部时钟、为 1 用外部 32.768KHz 晶振。dsleep_rtc_calendar_read(RTC_TIMER_TYPEDEF *rtc_time)。dsleep_rtc_alarm_cfg(time, msk),如 time=0x00235000 表示 23:50:00 唤醒;msk 用来屏蔽小时(0x04)、分钟(0x02)或秒(0x01)。也可以同时配唤醒 IO。sys_wakeup_reason() 返回 4 是 IO 唤醒,返回 25 是闹钟唤醒。官方给出的该场景休眠功耗约 28uA。
测试条件:25℃、3.3V、单芯片方案、STA 每次接收 Beacon 1ms、屏蔽环境、DCDC 供电。
| DTIM 周期 | 内置 32K(mA) | 外置 32K(mA) |
|---|---|---|
| DTIM1 | 2.277 | 2.273 |
| DTIM3 | 0.804 | 0.792 |
| DTIM5 | 0.509 | 0.490 |
| DTIM6 | 0.435 | 0.413 |
| DTIM10 | 0.288 | 0.251 |
| DTIM30 | 0.216 | 0.178 |
另外 TXW818 数据手册给出的几个静态数据:272KB SRAM 全部保持约 233.5uA,仅 16KB SRAM 保持约 31.3uA,CHIP_EN 为 0(关机)约 0.7uA;ULP 模式电流 <28uA。
| 影响因素 | 说明 |
|---|---|
| DTIM 周期 | 功耗随 DTIM 变化很大(DTIM1 与 DTIM10 差近 8 倍)。DTIM 是 AP 侧参数;81x 自己做 AP 时用 ieee80211_conf_set_dtim_int 设置,默认 10 |
| 32K 时钟源 | 内置 32K 休眠越久误差越大,功耗会上升;DTIM30 时内置比外置高约 20% |
| 无线环境 | 有干扰时 Wi-Fi 省电模式功耗会增加,官方数据是在屏蔽环境测的 |
| 供电设计 | 低功耗方案电源与常电方案不同:内部 DCDC 一般给 VCCD、VDD15 供电,VDD 可外接 DCDC;VCCD 在非低功耗应用才直接接 3.3V。按「成本优先 / 兼顾 / 功耗优先」三档的接法见硬件设计指南 |
| 音频电源 | V33AUDIO 若独立供电,休眠时要关断其电源输入(数据手册要求);也可接到 VCAM |
| IO 状态 | PA2/PA3/PA8/PA11 休眠中做 PWM 用;PB/PC 口默认休眠后无电,需要的话用 dsleep_set_user_giob |
| 误唤醒 | 未设唤醒数据时任何数据包都会唤醒,平均功耗会被拉高,见第四节 |
测之前先用sys_wakeup_reason()打一次日志。 如果醒来原因经常是BC_TIM(广播数据)这类你没预期的唤醒,说明设备被网络包频繁叫醒,先解决误唤醒,再谈底电流。
| 现象 | 原因与处理 |
|---|---|
| 不做低功耗的项目也带着休眠代码 | 在工程配置里删除 CONFIG_SLEEP |
| 醒来后程序从头跑、变量全丢 | 模式 2、5 和 RTC 闹钟唤醒本来就会复位;需要保留的数据放进复位后保持的区域,醒来后先查唤醒原因 |
| 自己加的外设醒来后不工作 | 驱动没实现 suspend / resume,或在 dev_resume_hook 里被跳过了 |
| 模式 4 休眠时 UART 没输出 | UART 默认也被挂起,需在 dev_suspend_hook 里保留并重设波特率 |
| PB 口做唤醒脚不灵 | PB 默认休眠后无电,换成 PA0~PA14,或用 dsleep_set_user_giob 设为用户 IO |
打印 NO FREE LOCALID | 模组内部 TCP/UDP 数据流超过上限,减少模组内部连接 |
频繁出现 BEACON_LOST / AP_ERROR 唤醒 | 路由器侧问题(Beacon 丢失、AP 重启),按唤醒原因做重连处理 |
做低功耗时经常要反复烧录对比,单台烧录推荐用 创芯蜂 HiveComm,操作见《CKLink 驱动安装与固件烧录教程:用 HiveComm 一键烧录》,CKLink 调试器可在创芯蜂淘宝店购买;烧录遇到问题,可以按《TXW 系列芯片固件烧录(下载)教程:烧录器接线、操作与失败排查》逐项排查。量产阶段的固件打包和批量烧录见《TXW81x 量产指南:固件打包、量产烧录、产测与认证测试》。