門鈴、門鎖、電池攝像機這類產品,大部分時間都在睡覺,續航好不好全看低功耗做得怎麼樣。TXW82x 的 TXW828 系列支持低功耗,SDK 2.7.1.7 也提供了完整的電池攝像機參考方案。這篇講三種休眠模式怎麼選、核心接口怎麼用,以及怎麼把自己的模塊接進低功耗流程。
內容整理自泰芯《TXW82x 低功耗開發指南》V1.0(適用 SDK v2.7.1.7),實測數據基於泰芯電池攝像機開發板。
CUSTOMER_ID 9(電池相機 1080P),另有 CUSTOMER_ID 7(低功耗 720P IPC)。| 模式 | 休眠時 Wi-Fi | 喚醒後 | 喚醒方式 | 休眠電流參考 |
|---|---|---|---|---|
| 1 · Wi-Fi 保活休眠 | 保持連接 | 從休眠點繼續運行 | 遠程喚醒 / IO / 定時 | 約 338μA |
| 3 · SRAM 保持休眠 | 斷開 | 從休眠點繼續運行 | IO / 定時 | 約 91μA |
| 5 · RTC 休眠 | 斷開 | 系統重啟,重新初始化 | IO / 定時 | 約 43μA |
電流數據是官方在電池攝像機開發板上、4.2V 供電、屏蔽環境下的測試參考,你的板子要自己實測。
怎麼選:
電池攝像機開發板出廠就燒了 Demo(Flash 被擦了就編譯 CUSTOMER_ID 9 重新燒):
AT+SLEEP=5,80000,23,1
含義:模式 5(RTC 休眠),80 秒後定時喚醒,喚醒 IO 為 PB7(下降沿,對應 SW1 按鍵)。休眠期間電流應在 35~45μA,按 SW1 或等 80 秒後喚醒。
開發板的 SW1 按下後接通電源,需要程序啟動後自己控制電源開關腳來維持供電;休眠期間也要保持這個腳的輸出狀態,否則會把自己斷電。這一點設計自己的板子時同樣要注意。
struct system_sleep_param args;
os_memset(&args, 0, sizeof(args));
args.sleep_ms = 5000; // 5 秒後定時喚醒,填 0 表示不定時喚醒
system_sleep(SYSTEM_SLEEP_TYPE_SRAM_ONLY, &args); // 模式 3
system_sleep_param 裡還可以配喚醒 IO:
| 字段 | 說明 |
|---|---|
sleep_ms |
定時喚醒時長,毫秒;0 = 只靠 IO 喚醒 |
wkup_io_sel[6] |
最多 6 路喚醒 IO(IO0~IO5)選哪個引腳 |
wkup_io_en |
使能掩碼,bit0 對應 wkup_io_sel[0]
|
wkup_io_edge |
邊沿掩碼:0 = 上升沿(芯片自動開下拉),1 = 下降沿(自動開上拉) |
喚醒 IO 優先用 PA0~PA14,這個範圍 6 路喚醒源都能選到,兼容性最好。
進入休眠時,沒有特別聲明的 IO 會被複位,防止浮空漏電。電源使能、TF 卡電源、功放使能這類休眠期間要保持電平的腳,要用掩碼聲明:
dsleep_set_user_gioa(BIT(0) | BIT(3)); // 休眠期間保持 PA0、PA3 原有狀態
B~F 口對應 dsleep_set_user_giob() ~ dsleep_set_user_giof()。
休眠時只有常電 SRAM 區域的數據不會丟。需要跨休眠保存的變量,用 __dsleep_data 修飾:
__dsleep_data uint8 wake_count = 0;
運行時動態申請用 sys_sleepdata_request(SYSTEM_SLEEPDATA_ID_USER, size)。只用 SYSTEM_SLEEPDATA_ID_USER 這個 ID,其他 ID 是 SDK 內部用的。
休眠時 systick 停止計數(日志時間戳不變),喚醒後 SDK 會補償系統時間。休眠流程裡要計時,用常電域的 RC 定時器 pmu_tmrao_get(),再按校準後的 RC 頻率換算成毫秒。
| Hook | 什麼時候調用 | 典型用途 |
|---|---|---|
wakeup_hook |
IO / 定時喚醒後立刻調用 | 喚醒過濾:比如 PIR 觸發 5 次才真正喚醒,否則返回「繼續休眠」,避免幹擾脈沖誤喚醒 |
ready_hook |
射頻就緒後調用 | 主動發保活包,周期性向服務器上報狀態 |
rx_hook |
收到 MAC 層數據包時調用 | 判斷是不是有效的喚醒報文(在中斷裡執行,要盡快返回) |
wakeup_hook 的返回值決定接下來怎麼走:DSLEEP_ACTION_SLEEP_CONTINUE 放棄本次喚醒繼續睡,DSLEEP_ACTION_SLEEP_EXIT 正常喚醒,DSLEEP_ACTION_DO_NOTHING 交給框架默認處理。
參考代碼的遠程喚醒檢測是「收到任意 TCP 包就喚醒」。量產產品應該再校驗源 IP、端口或報文內容,否則網絡上的雜包會頻繁把設備喚醒,嚴重影響續航。
真實產品睡覺前,要先把 TF 卡、攝像頭、ISP、音頻這些模塊停掉;醒來後再按順序恢複。SDK 的 sdk/app/lowPower_app 框架幫你管這件事:每個模塊提供一對 suspend / resume 回調,注冊成一個數組,框架自動按順序調用。
1. 確認工程打開了 CONFIG_SLEEP,並且在 wifi.c 裡調用了 bgn_dsleep_init()。
2. 每個模塊寫 suspend / resume 回調:suspend 返回前要確認相關任務、DMA、中斷都停了;resume 按初始化依賴恢複,不要重複創建任務。成功返回 RET_OK。
3. 按上電初始化的順序排數組:
static const struct lowPower_module_ops user_lowpower_modules[] = {
{"power", user_power_suspend, user_power_resume, {NULL, NULL, NULL, NULL}},
{"sensor", user_sensor_suspend, user_sensor_resume, {&g_sensor, &g_sensor_cfg, NULL, NULL}},
{"service", user_service_suspend, user_service_resume, {NULL, NULL, NULL, NULL}},
};
框架規則:suspend 從數組末尾往前執行,resume 從前往後執行。 上面的數組睡前依次停 service → sensor → power,醒後依次恢複 power → sensor → service。某個模塊 suspend 失敗時,框架會把已經停掉的模塊恢複回來。
4. 業務模塊都初始化完以後,注冊一次:
lowpower_app_init(user_lowpower_modules, ARRAY_SIZE(user_lowpower_modules));
一個應用只調用一次,再調用會清空之前的模塊表。
5. 業務需要時調用 system_sleep(),框架會自動執行 suspend,喚醒後自動調度 resume。
電池相機方案的模塊表可以直接參考,它注冊了 7 個模塊:電源前置、SD、MIPI、ISP、VPP、音頻、電源後置。
執行順序只看數組位置,和模塊名字裡的prev/post無關。設計新板子時,按外圍器件的上下電要求重新檢查數組順序。
dsleep_set_ext_dcdc(1),休眠期間關閉內部 LDO,進一步降低功耗。bgn_dsleep_init 的 flags 裡使能。做電池產品遇到功耗問題,歡迎在社區提問,附上休眠模式、電流曲線和喚醒方式。