这篇写给要在 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 量产指南: 固件打包, 量产烧录, 产测与认证测试 .