這篇寫給要在 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 量產指南:固件打包、量產燒錄、產測與認證測試》。