Serviço SystemSuspend

No Android 9 e versões anteriores, há uma linha de execução em libsuspend responsável por iniciar a suspensão do sistema. O Android 10 introduz uma funcionalidade equivalente em um serviço SystemSuspend HIDL. Esse serviço está localizado na imagem do sistema e é veiculado pela plataforma Android. A lógica de libsuspend permanece praticamente a mesma, exceto que todos os processos do espaço do usuário que bloqueiam a suspensão do sistema precisam se comunicar com o SystemSuspend.

libsuspend e libpower

No Android 10, o serviço SystemSuspend substitui libsuspend. libpower foi reimplementado para depender do serviço SystemSuspend em vez de /sys/power/wake[un]lock sem mudar a API C.

Este pseudocódigo mostra como implementar acquire_wake_lock e 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;
}

Linhas de execução

O serviço SystemSuspend monitora o número de wake locks emitidos com um contador de suspensão. Ele tem duas linhas de execução:

• A linha de execução main atende às chamadas de vinculação.
• A linha de execução suspend controla a suspensão do sistema.

Linha de execução principal

A linha de execução principal responde a solicitações de clientes para alocar novos bloqueios de ativação, incrementando/decrementando o contador de suspensão.

Suspender a linha de execução

A linha de execução de suspensão executa o seguinte em um loop:

1. Leia em /sys/power/wakeup_count.
2. Adquira o mutex. Isso garante que a linha de execução de suspensão não toque no contador de suspensão enquanto a linha de execução principal tenta aumentá-lo ou diminuí-lo. A linha de execução principal é bloqueada ao emitir ou remover bloqueios de ativação quando o contador de suspensão atinge zero e a linha de execução suspensão está tentando ser executada.
3. Aguarde até que o contador seja igual a zero.
4. Grave o valor lido de /sys/power /wakeup_count (da etapa 1) neste arquivo. Se a gravação falhar, retorne ao início do loop.
5. Inicie a suspensão do sistema gravando mem em /sys/power/state.
6. Libere o mutex.

Quando uma solicitação de um bloqueio de ativação é retornada, a linha de execução de suspensão é bloqueada.

API SystemSuspend

A API SystemSuspend consiste em duas interfaces. A interface HIDL é usada por processos nativos para adquirir bloqueios de ativação, e a interface AIDL é usada para comunicação entre SystemServer e SystemSuspend.

Interface HIDL ISystemSuspend

enum WakeLockType : uint32_t {
    PARTIAL,
    FULL
};

interface IWakeLock {
    oneway release();
};

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

Cada cliente que solicita um bloqueio de ativação recebe uma instância IWakeLock exclusiva. Isso é diferente de /sys/power/wake_lock, que permite que vários clientes usem o bloqueio de ativação com o mesmo nome. Se um cliente que mantém uma instância de IWakeLock for encerrado, o driver de vinculação e o serviço SystemSuspend vão limpar o processo.

Interface AIDL ISuspendControlService

O ISuspendControlService é destinado apenas ao SystemServer.

interface ISuspendCallback {
     void notifyWakeup(boolean success);
}

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

O uso do HIDL do Android oferece os seguintes benefícios:

• Se um processo de suspensão de bloqueio for encerrado, o SystemSuspend poderá ser notificado.
• A linha de execução responsável pela suspensão do sistema pode receber um callback.