系統暫停服務

在 Android 9 以下版本中，libsuspend 會建立一個負責啟動系統暫停作業的執行緒。Android 10 在 SystemSuspend HIDL 服務中引入了同等功能。這項服務位於系統映像檔中，由 Android 平台提供。libsuspend 的邏輯大致相同，但每個封鎖系統停權的使用者空間程序都必須與 SystemSuspend 通訊。

libsuspend 和 libpower

在 Android 10 中，SystemSuspend 服務會取代 libsuspend。libpower 已重新實作，以便依賴 SystemSuspend 服務，而非 /sys/power/wake[un]lock，且不會變更 C API。

這個虛擬程式碼說明如何實作 acquire_wake_lock 和 release_wake_lock。


static std::unordered_map<std::string, sp<IWakeLock>> gWakeLockMap;

int acquire_wake_lock(int, const char* id) {
    ...
    if (!gWakeLockMap[id]) {
        gWakeLockMap[id] = suspendService->acquireWakeLock(WakeLockType::PARTIAL, id);
    }
    ...
    return 0;
}

int release_wake_lock(const char* id) {
    ...
    if (gWakeLockMap[id]) {
        auto ret = gWakeLockMap[id]->release();
        gWakeLockMap[id].clear();
        return 0;
    }
    ...
    return -1;
}

執行執行緒

「系統暫停」服務會追蹤透過暫停計數器發出的 Wake Lock 數量。它有兩個執行緒：

  • main 執行緒會回應繫結器呼叫。
  • suspend 執行緒可控制系統暫停。

主要執行緒

主要執行緒會回應來自用戶端的要求，以分配新的 Wake Lock，增加/減少暫停計數器。

暫停執行緒

暫停執行緒會在迴圈中執行下列作業：

  1. 從 /sys/power/wakeup_count 讀取。
  2. 取得互斥鎖。這可確保在「主」執行緒嘗試遞增或遞減時，暫停執行緒不會觸碰暫停計數器。當暫停計數器已達零，且「暫停」執行緒嘗試執行時，主執行緒會在發出或移除喚醒鎖定時遭到封鎖。
  3. 等待計數器等於零。
  4. 將 /sys/power /wakeup_count 中讀取的值 (從步驟 1) 寫入此檔案。如果寫入失敗，請返回迴圈的開頭
  5. 將 mem 寫入 /sys/power/state，啟動系統暫停。
  6. 釋放互斥鎖。

成功傳回 Wake Lock 的要求時，暫停執行緒就會遭到封鎖。

圖 1. 暫停執行緒迴圈

SystemSuspend API

SystemSuspend API 包含兩個介面。原生程序會使用 HIDL 介面取得 Wake Lock，而 AIDL 介面則用於 SystemServer 和 SystemSuspend 介面。

ISystemSuspend HIDL 介面


enum WakeLockType : uint32_t {
    PARTIAL,
    FULL
};

interface IWakeLock {
    oneway release();
};

interface ISystemSuspend {
    acquireWakeLock(WakeLockType type, string debugName)
        generates (IWakeLock lock);
};

每個要求喚醒鎖的用戶端都會收到一個專屬的 IWakeLock 例項。這與 /sys/power/wake_lock 不同，後者可讓多個用戶端在相同名稱中使用 Wake Lock。如果持有 IWakeLock 例項的用戶端終止，繫結器驅動程式和 SystemSuspend 服務會清理該例項。

ISuspendControlService AIDL 介面

ISuspendControlService 僅供 SystemServer 使用。


interface ISuspendCallback {
     void notifyWakeup(boolean success);
}

interface ISuspendControlService {
    boolean enableAutosuspend();
    boolean registerCallback(ISuspendCallback callback);
    boolean forceSuspend();
}

運用 Android HIDL 具備下列優點：

  • 如果暫停阻斷程序停止運作，SystemSuspend 可以收到通知。
  • 負責系統暫停的執行緒可以提供回呼。