TXW81x 低功耗开发教程:休眠模式怎么选、怎么唤醒、怎么测功耗

发布于 2026-11-08 21:59:49

这篇写给要在 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唤醒后典型用途
模式 1SYSTEM_SLEEP_TYPE_SRAM_WIFI保持连接全部带电从休眠处接着运行休眠中还要和云端保活,要远程唤醒、醒得快
模式 2SYSTEM_SLEEP_TYPE_WIFI_DSLEEP保持连接只有前 32K 带电复位,重新初始化要远程唤醒,但不需要应用层保活,对唤醒速度要求不高
模式 3SYSTEM_SLEEP_TYPE_SRAM_ONLY断开全部带电接着运行,Wi-Fi 自动重新打开只靠本地 IO / 定时器唤醒,不需要远程唤醒
模式 4SYSTEM_SLEEP_TYPE_LIGHT_SLEEP仅关闭无线收发全部带电接着运行暂停无线,但 CPU 低速运行,LED、UART 等外设还要工作
模式 5SYSTEM_SLEEP_TYPE_RTCC无32K 带电外部电源恢复后重新初始化主电源掉电后由锂电池维持,只保留 RTC 计时
模式 6SHUTDOWN(关机)无不保留复位重启彻底关机,由 CHIP_EN 控制

选型思路可以按这个顺序问自己:

  1. 休眠时手机 / 服务器要不要能叫醒设备? 要 → 模式 1 或 2;不要 → 模式 3、4、5、6。
  2. 休眠时设备自己要不要定时和服务器打招呼(应用层保活)? 要 → 只能选模式 1。模式 2 只保 Wi-Fi 连接,不跑应用保活,换来更低的功耗。
  3. 醒来后能不能接受从头启动? 不能接受 → 模式 1、3、4;能接受 → 模式 2、5、6。
  4. 休眠时是否还有外设要工作(比如 UART 收发、点灯)→ 模式 4。
休眠期间 PA2 / PA3 / PA8 / PA11 可以输出硬件 PWM(可用于呼吸灯)。硬件设计指南特别提醒:低功耗保活状态下这四个脚被用作硬件 PWM,如果你想让它们在休眠中保持电平,只能设为 INPUT,不能设为 OUTPUT;其它 PA 口不受此限制。

三、进入休眠:只有一个 API

所有模式都用同一个函数进入休眠,区别只在参数:

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 下降沿,芯片内部会自动打开对应的下拉或上拉

唤醒 IO 能选哪些脚

6 路唤醒源能映射的引脚如下:

唤醒源PAPBPC
IO0PA0-PA14PB0-PB15无
IO1PA0-PA14PB0-PB15PC0
IO2PA0-PA15PB0-PB15无
IO3PA0-PA14PB0-PB14PC5
IO4PA0-PA14PB0-PB14PC1、PC4
IO5PA0-PA14PB0-PB14PC2、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()。

  • SDK 默认只支持 1 组唤醒数据,最长 64 字节。
  • 不够用时修改宏 LMAC_WKDATA_SIZE、LMAC_WKDATA_COUNT。
  • 设置时 wkdata->count 必须等于 LMAC_WKDATA_COUNT,wkdata->wkdata_size 必须等于 LMAC_WKDATA_SIZE,否则会出问题。

唤醒后先查原因

醒来后调用 uint8 sys_wakeup_reason(void) 查询原因,再决定做什么。常用的几个:

返回值宏含义
1DSLEEP_WK_REASON_TIMER定时器到时
2DSLEEP_WK_REASON_TIM收到单播数据,通常就是远程唤醒
3DSLEEP_WK_REASON_BC_TIM收到广播数据
4DSLEEP_WK_REASON_IOIO 唤醒
5DSLEEP_WK_REASON_BEACON_LOSTAP 的 Beacon 丢失
6DSLEEP_WK_REASON_AP_ERROR检测到 AP 异常,通常是路由器重启了
7DSLEEP_WK_REASON_HB_TIMEOUT远程心跳超时
8DSLEEP_WK_REASON_WK_DATA唤醒数据匹配
10DSLEEP_WK_REASON_LVD低电复位
13DSLEEP_WK_REASON_PS_DISCONNECTAP 在设备休眠时断开了连接
15DSLEEP_WK_REASON_MAX_IDLE_TMOAP 判定保活超时

完整枚举见 SDK 中的 DSLEEP_WK_REASON。RTC 闹钟唤醒时返回 25。

五、模式 1 的开发流程(其它模式在此基础上增减)

模式 1 休眠时要先把应用和设备「挂起」,醒来再按相反顺序「恢复」:

  1. sys_suspend:挂起应用程序。一般是网络相关模块,进入休眠前停止发数据。
  2. dev_suspend:挂起设备,备份设备状态。
  3. (休眠……被唤醒)
  4. dev_resume:恢复设备。
  5. 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 次发送失败就认为链路断开并唤醒主控。照着它改成自己的保活协议即可。

其它模式的差异

  • 模式 2:不走 suspend 流程,收到休眠指令直接睡,应用数据全部丢失,醒来复位重跑。前 32K SRAM 里有 4K 区域复位后保持不变,可以存自定义数据,初始化时读出来用;唤醒原因同样跨复位保留。
  • 模式 3:流程和模式 1 相同,只是休眠时 Wi-Fi 关闭,醒来自动打开。
  • 模式 4:默认所有设备都会被挂起。想在休眠中继续用 UART,就在 dev_suspend_hook 里终止 UART 的挂起,并重新设置波特率等参数;不需要挂起的应用模块可以不注册 sleepcb。醒来要调 system_wakeup,系统时钟会重新配置,Wi-Fi 自动重连。
  • 模式 5(RTCC):调用 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)。
  • 模式 6(SHUTDOWN):CHIP_EN 拉低进入关机,拉高后复位重启。

带主控方案的要点

  • 81x 在主控上创建 wlan0,模组内部协议栈创建 w0,两者 MAC 和 IP 相同,各跑各的程序;模组靠识别 TCP/UDP 数据流来区分数据归谁。模组内部数据流数量有限,打印 NO FREE LOCALID 说明超了,要控制模组内部的连接数。
  • 可让模组提前 DHCP 拿 IP,主控开机直接用,省去等待时间。
  • 保活建议优先用 UDP,对功耗更友好、逻辑也简单。
  • 主控被唤醒后应主动查询唤醒原因再处理。

六、RTC 闹钟定时唤醒

需要「每天几点醒来」这类日历闹钟时,用 RTC 日历接口(工程需打开 CONFIG_SLEEP):

  1. 硬件:要精确计时就在 PA12(LXOSCO,低速晶振输出)、PA13(LXOSCI,低速晶振输入)外接 32.768KHz 晶振;用内部时钟则无硬件要求。
  2. 初始化:dsleep_rtc_calendar_init(time, date, flags)。time 按 24 小时制写,如 0x00234955 表示 23:49:55;date 含日期和星期,如 0x24041306 表示 2024-04-13 星期六;flags 的 bit0 为 0 用内部时钟、为 1 用外部 32.768KHz 晶振。
  3. 读时间:dsleep_rtc_calendar_read(RTC_TIMER_TYPEDEF *rtc_time)。
  4. 设闹钟:休眠前用 dsleep_rtc_alarm_cfg(time, msk),如 time=0x00235000 表示 23:50:00 唤醒;msk 用来屏蔽小时(0x04)、分钟(0x02)或秒(0x01)。也可以同时配唤醒 IO。
  5. 醒来后:除 RTC 和用户数据外其它模块都会复位(休眠期间约有 1KB RAM 可存用户数据)。sys_wakeup_reason() 返回 4 是 IO 唤醒,返回 25 是闹钟唤醒。

官方给出的该场景休眠功耗约 28uA。

七、功耗数据与测量

官方 Wi-Fi 保活功耗

测试条件:25℃、3.3V、单芯片方案、STA 每次接收 Beacon 1ms、屏蔽环境、DCDC 供电。

DTIM 周期内置 32K(mA)外置 32K(mA)
DTIM12.2772.273
DTIM30.8040.792
DTIM50.5090.490
DTIM60.4350.413
DTIM100.2880.251
DTIM300.2160.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 量产指南:固件打包、量产烧录、产测与认证测试》。

参考资料

相关阅读

开发中遇到问题,欢迎在社区提问,也可以先问 AI 助手。

0 条评论

AI
问答

发布
问题