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
問答

發布
問題