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 唤醒后 典型用途
模式 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 控制

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

  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 路唤醒源能映射的引脚如下:

唤醒源 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 () .

  • 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) 查询原因, 再决定做什么. 常用的几个:

返回值 宏 含义
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 的开发流程 (其它模式在此基础上增减)

模式 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)
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 量产指南: 固件打包, 量产烧录, 产测与认证测试 .

参考资料

相关阅读

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

0 条评论

AI
问答

发布
问题