在嵌入式開發(fā)中，休眠喚醒是實(shí)現(xiàn)設(shè)備低功耗的核心功能，而RK系列平臺(tái)（如RK3399）的休眠喚醒調(diào)試，是開發(fā)過(guò)程中高頻且關(guān)鍵的工作。從休眠失敗排查到喚醒耗時(shí)優(yōu)化，從工具使用到關(guān)鍵節(jié)點(diǎn)調(diào)試，每一步都有明確的實(shí)操方法和技巧。本文結(jié)合RK平臺(tái)實(shí)際開發(fā)文檔，從問(wèn)題定位、流程時(shí)間優(yōu)化、Pm-test工具使用、核心調(diào)試節(jié)點(diǎn)四個(gè)維度，手把手教你搞定RK平臺(tái)休眠喚醒所有問(wèn)題！

一、RK平臺(tái)休眠核心問(wèn)題定位

休眠失敗是RK平臺(tái)開發(fā)中最常見的問(wèn)題，核心誘因主要集中在鎖資源、中斷觸發(fā)、定時(shí)器機(jī)制三類，結(jié)合實(shí)操實(shí)驗(yàn)可快速定位根因，以下是具體排查方法：

1. wake_lock導(dǎo)致無(wú)法休眠

這是休眠失敗的最主要原因，系統(tǒng)存在未釋放的喚醒鎖時(shí)，會(huì)直接阻止休眠流程。RK平臺(tái)提供兩個(gè)核心節(jié)點(diǎn)用于排查鎖資源，二者互補(bǔ)，需配合使用：

?僅查Android層鎖：cat /sys/power/wake_lock，該節(jié)點(diǎn)只能識(shí)別Android系統(tǒng)中設(shè)置的喚醒鎖，無(wú)法檢測(cè)kernel層鎖；

?查全量鎖（推薦）：cat /sys/kernel/debug/wake_source，可識(shí)別所有喚醒鎖，包括kernel層驅(qū)動(dòng)設(shè)置的鎖、通過(guò)命令行手動(dòng)添加的鎖，同時(shí)能查看鎖的當(dāng)前激活狀態(tài)。

2.休眠過(guò)程中產(chǎn)生中斷/驅(qū)動(dòng)休眠函數(shù)含wake_lock

休眠流程執(zhí)行中，若有未屏蔽的硬件中斷觸發(fā)，或驅(qū)動(dòng)的suspend（休眠）函數(shù)中主動(dòng)添加了wake_lock，會(huì)直接中斷休眠。這類問(wèn)題需通過(guò)內(nèi)核log判斷，重點(diǎn)查看休眠階段的中斷打印和驅(qū)動(dòng)休眠函數(shù)的執(zhí)行日志，定位觸發(fā)中斷的設(shè)備或違規(guī)添加鎖的驅(qū)動(dòng)。

3. 2S內(nèi)有鬧鐘中斷產(chǎn)生，系統(tǒng)拒絕休眠

RK平臺(tái)內(nèi)核中存在鬧鐘中斷檢測(cè)機(jī)制：若檢測(cè)到2S內(nèi)有RTC鬧鐘中斷即將觸發(fā)，系統(tǒng)會(huì)直接拒絕進(jìn)入休眠，核心邏輯在alarmtimer_suspend函數(shù)中。

函數(shù)會(huì)遍歷定時(shí)器隊(duì)列，計(jì)算最近一次鬧鐘中斷的觸發(fā)時(shí)間差delta，若delta.tv64 < 2S，則直接返回0阻止休眠，避免系統(tǒng)剛休眠就被鬧鐘喚醒，造成功耗浪費(fèi)。

4.實(shí)操實(shí)驗(yàn)：驅(qū)動(dòng)加鎖驗(yàn)證休眠失敗場(chǎng)景

以RK808電源管理驅(qū)動(dòng)為例，在其suspend函數(shù)中手動(dòng)添加wake_lock，可復(fù)現(xiàn)休眠失敗場(chǎng)景，從log中能清晰看到核心現(xiàn)象：

// RK808休眠函數(shù)中添加喚醒鎖staticintrk808_suspend(structdevice *dev){  printk("rk808_suspendn");  wake_lock(&rk808_wake_lock);// 手動(dòng)添加鎖 // 原有休眠邏輯 return0;}

關(guān)鍵log現(xiàn)象：系統(tǒng)執(zhí)行RK808的休眠函數(shù)后，檢測(cè)到激活的喚醒鎖，直接終止休眠，且會(huì)執(zhí)行對(duì)應(yīng)驅(qū)動(dòng)的resume（喚醒）函數(shù)，核心log如下：

27.180129 PM:wakeup pending,abortingsuspendactive wakeupsource: rk808 wake locktestPM: Some devices failed tosuspend, or early wake event detected27.180581 rk808_resume // 休眠失敗后執(zhí)行喚醒函數(shù)

二、休眠喚醒流程時(shí)間優(yōu)化

以RK3399為例，正常情況下從按下Power鍵到背光PWM有波形輸出的喚醒耗時(shí)約972ms，若實(shí)際開發(fā)中耗時(shí)遠(yuǎn)超該值，需通過(guò)以下兩種方法定位耗時(shí)瓶頸：

1.命令行形式：打印單個(gè)設(shè)備休眠耗時(shí)

通過(guò)兩個(gè)命令配合，讓內(nèi)核打印每個(gè)設(shè)備的休眠/喚醒耗時(shí)，快速定位耗時(shí)過(guò)長(zhǎng)的設(shè)備驅(qū)動(dòng)：

# 休眠時(shí)讓console不進(jìn)入休眠，保證log完整輸出echoN > /sys/module/printk/parameters/console_suspend# 開啟設(shè)備休眠耗時(shí)打印功能echo1 > /sys/power/pm_print_times

執(zhí)行后觸發(fā)休眠，內(nèi)核會(huì)打印每個(gè)設(shè)備的suspend函數(shù)執(zhí)行時(shí)間，重點(diǎn)關(guān)注耗時(shí)遠(yuǎn)超平均水平的設(shè)備，排查其驅(qū)動(dòng)休眠邏輯。

2.打開DPM_WATCHDOG_TIMEROUT：設(shè)置休眠超時(shí)閾值

通過(guò)開啟內(nèi)核的設(shè)備電源管理看門狗，設(shè)置休眠超時(shí)時(shí)間（精確到秒），若某個(gè)設(shè)備休眠耗時(shí)超過(guò)閾值，內(nèi)核會(huì)觸發(fā)超時(shí)提醒，快速定位卡死在休眠階段的設(shè)備。

?配置方式：內(nèi)核編譯時(shí)開啟Device suspend/resume watchdog，并設(shè)置超時(shí)時(shí)間（如60s）；

?實(shí)操示例：在RK808驅(qū)動(dòng)中添加mdelay(8000)模擬耗時(shí)，看門狗會(huì)檢測(cè)到該設(shè)備休眠超時(shí)并打印日志。

三、Pm-test工具全使用說(shuō)明：休眠喚醒穩(wěn)定性測(cè)試

RK平臺(tái)內(nèi)核集成了Pm-test工具，用于休眠喚醒的功能驗(yàn)證和穩(wěn)定性拷機(jī)，分為/sys/power/pm_test節(jié)點(diǎn)配置和Suspend_test內(nèi)核模塊測(cè)試，適用于開發(fā)不同階段的調(diào)試需求。

1. /sys/power/pm_test：靈活設(shè)置休眠喚醒測(cè)試級(jí)別

該節(jié)點(diǎn)用于手動(dòng)觸發(fā)不同級(jí)別的休眠喚醒測(cè)試，可設(shè)置喚醒間隔，默認(rèn)喚醒間隔為5s，核心操作命令如下：

# 查看支持的測(cè)試級(jí)別cat/sys/power/pm_test# 輸出：[none] core processors platform devices freezer# 設(shè)置喚醒間隔為30secho30 > /sys/module/suspend/parameters/pm_test_delay# 選擇core級(jí)別測(cè)試echocore > /sys/power/pm_test# 觸發(fā)休眠，系統(tǒng)會(huì)在30s后自動(dòng)喚醒echomem > /sys/power/state

核心測(cè)試級(jí)別說(shuō)明：

?none：無(wú)測(cè)試，正常休眠；

?core：內(nèi)核核心層休眠測(cè)試；

?platform：平臺(tái)層休眠測(cè)試；

?devices：設(shè)備層休眠測(cè)試（重點(diǎn)）；

?freezer：進(jìn)程凍結(jié)測(cè)試（注意：與PM_SUSPEND_FREEZE機(jī)制不同，不可混淆）。

2. Suspend_test：內(nèi)核層休眠喚醒穩(wěn)定性拷機(jī)

適用于平臺(tái)開發(fā)前期（系統(tǒng)未進(jìn)入Android）的休眠喚醒穩(wěn)定性測(cè)試，利用RTC定時(shí)器實(shí)現(xiàn)自動(dòng)循環(huán)休眠喚醒，內(nèi)核4.4版本自帶該功能，需兩步配置：

步驟1：內(nèi)核編譯配置

在menuconfig中開啟對(duì)應(yīng)選項(xiàng)，路徑如下：

->Power management options->Device power management core functionality (PM [=y])->Power Management Debug Support (PM_DEBUG [=y])[*] Test suspend/resume and wakealarm during bootup

步驟2：添加啟動(dòng)參數(shù)，設(shè)置拷機(jī)次數(shù)

在內(nèi)核啟動(dòng)參數(shù)中添加test_suspend=mem,N，其中N為拷機(jī)次數(shù)（可設(shè)100/1000次），示例：

test_suspend=mem,1000# 系統(tǒng)啟動(dòng)后自動(dòng)執(zhí)行1000次休眠喚醒循環(huán)

注意：使用前需確保RTC驅(qū)動(dòng)已正常加載，否則定時(shí)器無(wú)法觸發(fā)自動(dòng)喚醒。

四、RK平臺(tái)休眠喚醒核心調(diào)試節(jié)點(diǎn)匯總

RK平臺(tái)在sysfs和debugfs中提供了6個(gè)核心調(diào)試節(jié)點(diǎn)，覆蓋鎖資源、休眠狀態(tài)、喚醒中斷、耗時(shí)統(tǒng)計(jì)等所有調(diào)試場(chǎng)景，是排查問(wèn)題的“萬(wàn)能鑰匙”，建議開發(fā)時(shí)熟記！

五、RK平臺(tái)休眠喚醒調(diào)試核心腦圖

為了方便大家快速梳理調(diào)試思路，將本文核心內(nèi)容整理為腦圖，涵蓋問(wèn)題定位、時(shí)間優(yōu)化、工具使用、關(guān)鍵節(jié)點(diǎn)四大核心板塊，收藏備用！

六、總結(jié)

RK平臺(tái)的休眠喚醒調(diào)試，核心是“先定位問(wèn)題類型，再用對(duì)應(yīng)工具/節(jié)點(diǎn)排查”：

1.休眠失敗優(yōu)先查wake_source節(jié)點(diǎn)，排除鎖資源問(wèn)題，再通過(guò)log排查中斷和鬧鐘定時(shí)器；

2.喚醒耗時(shí)過(guò)長(zhǎng)用pm_print_times打印設(shè)備耗時(shí)，或開啟DPM看門狗定位超時(shí)設(shè)備；

3.穩(wěn)定性測(cè)試用Pm-test工具，開發(fā)前期用Suspend_test拷機(jī)，后期用pm_test節(jié)點(diǎn)靈活測(cè)試；

4.所有調(diào)試場(chǎng)景都離不開6個(gè)核心節(jié)點(diǎn)，熟記節(jié)點(diǎn)功能能大幅提升調(diào)試效率。

休眠喚醒的調(diào)試本質(zhì)是對(duì)內(nèi)核電源管理機(jī)制和設(shè)備驅(qū)動(dòng)邏輯的理解，結(jié)合RK平臺(tái)的實(shí)操方法，多做實(shí)驗(yàn)、多分析log，就能快速解決各類問(wèn)題。

審核編輯 黃宇