Para oferecer suporte ao gerenciamento de energia específico do veículo, o Android oferece um
serviço CarPowerManagementService e uma
interface CarPowerManager.
As transições de estado são acionadas pela unidade de controle mestre do veículo (VMCU, na sigla em inglês). Para se comunicar com a VMCU, os integradores precisam implementar vários componentes. Os integradores são responsáveis pela integração com a camada de abstração de hardware do veículo (VHAL, na sigla em inglês) e a implementação do kernel. Os integradores também são responsáveis por desativar as fontes de ativação e garantir que os desligamentos não sejam adiados indefinidamente.
Terminologia
Estes termos são usados neste documento:
Design do sistema
Esta seção descreve como o AAOS representa o estado de energia do processador de apps e quais módulos implementam o sistema de gerenciamento de energia. Este material também descreve como esses módulos funcionam juntos e como as transições de estado normalmente ocorrem.
Máquina de estado de energia do carro
O AAOS usa uma máquina de estado para representar o estado de energia do AP. A máquina de estado fornece os estados ilustrados abaixo:
Figura 1. Máquina de estado de energia do carro.
As transições mais comuns estão destacadas em azul. Estes são os estados e as transições comuns:
- Suspender para RAM. O veículo e o SoC estão desligados. Nenhum código está sendo executado. A energia é mantida na RAM do SoC.
- Aguarde a VHAL. Quando o motorista interage com o veículo, por exemplo, abrindo uma porta, a VMCU aplica energia ao SoC. O AAOS é retomado do modo de suspensão para a RAM e entra no estado "Aguardar VHAL", em que aguarda a coordenação com a VHAL.
- Ativado. A VHAL instrui o AAOS a entrar no estado On. Nesse estado, o AAOS está totalmente em execução e interagindo com o motorista.
- Preparação para o encerramento. Quando o motorista termina de dirigir, o VHAL informa ao AAOS para entrar na fase de preparação pré-desligamento enviando
SHUTDOWN_PREPARE. Nesse estado, os listeners de mudanças de estado de energia recebemSTATE_PRE_SHUTDOWN_PREPARE. Isso serve como um aviso antecipado de que o encerramento está começando. - Preparação para desligamento. Quando todos os listeners terminam ou o tempo limite da fase de preparação pré-desligamento é atingido, o sistema Android entra na fase principal de preparação para o desligamento, notificando os listeners com
STATE_SHUTDOWN_PREPARE. A tela e o áudio estão desligados, e o AAOS não está interagindo com o motorista. O sistema Android ainda está em execução e pode realizar operações de limpeza e atualização, como executar o Modo de Garagem. - Aguarde a conclusão da VHAL. Nesse momento, o AAOS informa à VHAL que está pronto para ser desligado. A VMCU deve colocar o SoC em sono profundo e remover a energia do processador de apps. O AAOS fica no estado de suspensão para RAM, mas nenhum código é executado.
Módulos de gerenciamento de energia
O sistema de gerenciamento de energia é composto por estes módulos:
| Nome do módulo | Descrição |
|---|---|
| CarPowerManager | API Java ou C++. |
| CarPowerManagementService | Coordena as transições de estado de energia e delega o gerenciamento da política de energia ao CarPowerPolicyDaemon. |
| CarPowerPolicyDaemon | Gerencia políticas de energia e se comunica com clientes nativos de políticas de energia. |
| HAL veicular | Interface para a VMCU. |
| Kernel | Suspender para implementação de RAM ou disco. |
O recurso de suspensão profunda/hibernação (suspensão do Android para RAM/disco) é implementado no kernel.
Esse recurso é exposto ao espaço do usuário como um arquivo especial localizado em
/sys/power/state. O AAOS é suspenso ao gravar mem ou disk
nesse arquivo.
O CPMS coordena o estado de energia com outros serviços e HALs. O CPMS implementa a máquina de estado descrita acima e envia notificações para todos os observadores quando ocorre uma transição de estado de energia. Esse serviço também usa a VHAL para enviar mensagens ao hardware.
O CPPD é a fonte de verdade para as políticas de energia. Ele gerencia as políticas de energia durante todo o ciclo de vida do dispositivo e notifica o CPMS, a VHAL e outros listeners nativos sobre mudanças na política de energia. O CPMS delega solicitações de mudança de política de energia ao CPPD.
O CPMS se comunica com a VMCU lendo e gravando propriedades da VHAL relacionadas ao estado de energia, como AP_POWER_STATE_REQ e AP_POWER_STATE_REPORT. Os apps podem usar a interface definida no CPM para monitorar mudanças no estado de energia. Essa interface também permite que os apps registrem listeners de política de energia. Essa API Java é anotada com @SystemApi e @hide, o que a torna disponível apenas para apps privilegiados. A relação entre esses módulos, apps e serviços é ilustrada abaixo:

Figura 2. Diagrama de referência de componentes de energia.
Sequência de mensagens
A seção anterior descreveu os módulos que compõem o sistema de gerenciamento de energia. Esta seção usa os exemplos de entrar no modo hibernar e sair do modo hibernar para explicar como os módulos e apps se comunicam:
Entrar em sono profundo
Somente a VMCU pode iniciar o modo de suspensão profunda. Depois que o sono profundo é iniciado, a VMCU envia uma
notificação ao CPMS pela VHAL. O CPMS muda o estado para SHUTDOWN PREPARE e
transmite essa transição de estado para todos os observadores (os apps e serviços que monitoram
o CPMS) chamando o método onStateChanged() com um novo ID de estado fornecido pelo
CPM.
O CPM faz a mediação entre os apps/serviços e o CPMS. O método onStateChanged() para os apps/serviços é invocado de forma síncrona no método onStateChanged() do CPM. A maioria dos apps e serviços precisa concluir
a preparação antes de retornar dessa chamada. Os serviços privilegiados podem continuar as
preparações de forma assíncrona depois de retornar para PRE_SHUTDOWN_PREPARE,
SUSPEND_ENTER, POST_SUSPEND_ENTER. Nesse caso, o serviço privilegiado precisa
chamar complete() no objeto CompletablePowerStateChangeFuture fornecido
quando terminar a preparação. A preparação assíncrona não é permitida para
SHUTDOWN_PREPARE. Antes que DEEP_SLEEP_ENTRY seja enviado ao VHAL, o CPMS
envia periodicamente solicitações de adiamento de desligamento ao VHAL.
Quando todos os objetos do CPM concluírem as preparações para o desligamento, o CPMS vai enviar
AP_POWER_STATE_REPORT para a VHAL, que vai notificar a VMCU de que o AP está pronto para
ser suspenso. O CPMS também chama o método de suspensão, que suspende o kernel.
A sequência descrita acima é ilustrada abaixo:

Figura 3. Entrar em sono profundo.
Interfaces de programação fornecidas pelo CPM
Nesta seção, descrevemos a API Java fornecida pelo CPM para apps e serviços do sistema. Essa API permite que o software de sistema:
- Monitorar mudanças no estado de energia no AP.
- Aplicar políticas de energia.
Siga estas etapas para chamar as APIs fornecidas pelo CPM:
- Para adquirir a instância do CPM, chame a API Car.
- Chame o método apropriado no objeto criado na Etapa 1.
Criar um objeto CarPowerManager
Para criar um objeto CPM, chame o método getCarManager() do objeto Car. Esse método é
uma fachada usada para criar objetos CPM. Especifique android.car.Car.POWER_SERVICE como um argumento para criar um objeto de CPM.
Car car = Car.createCar(this); CarPowerManager powerManager = (CarPowerManager) car.getCarManager(android.car.Car.POWER_SERVICE);
CarPowerStateListener e registro
Os apps e serviços do sistema podem receber notificações de mudança de estado de energia implementando
CarPowerManager.CarPowerStateListener. Essa interface define um método
onStateChanged(), que é uma função de callback invocada quando o estado de energia do CPMS
é alterado. O exemplo a seguir define uma nova classe anônima que implementa a interface:
private final CarPowerManager.CarPowerStateListener powerListener = new CarPowerManager.CarPowerStateListener () { @Override public void onStateChanged(int state) { Log.i(TAG, "onStateChanged() state = " + state); } };
Para instruir esse objeto listener a monitorar uma transição de estado de energia, crie uma nova linha de execução e registre o listener e essa linha de execução no objeto CPM:
executor = new ThreadPerTaskExecutor(); powerManager.setListener(powerListener, executor);
Quando o estado de energia é alterado, o método onStateChanged() do objeto listener
é invocado com um valor para representar o novo estado de energia. A associação entre o valor real e o
estado de energia é definida em CarPowerManager e mostrada na
tabela abaixo:
| Nome | Descrição |
|---|---|
| STATE_ON | Insira o estado ativado. O sistema está totalmente operacional. |
| STATE_SHUTDOWN_CANCELLED | O desligamento é cancelado, e o estado de energia volta ao normal. |
| STATE_SHUTDOWN_ENTER | os apps precisam limpar os dados e estar prontos para serem encerrados. |
| STATE_POST_SHUTDOWN_ENTER | As preparações para o desligamento foram concluídas, e a VMCU está pronta para ser desligada. Entrar no estado de desligamento. |
| STATE_PRE_SHUTDOWN_PREPARE | O processo de desligamento é solicitado, mas o CPMS ainda não o inicia. A tela e o áudio ainda estão ligados |
| STATE_SHUTDOWN_PREPARE | O Modo de Garagem pode ser executado durante o período. |
| STATE_SUSPEND_ENTER | os apps precisam limpar os dados e estar prontos para a suspensão para a RAM. |
| STATE_POST_SUSPEND_ENTER | As preparações para suspensão para RAM foram concluídas, e a VMCU está pronta para suspensão para RAM. Insira o estado de suspensão. |
| STATE_SUSPEND_EXIT | Ativar após a suspensão ou retomar após uma suspensão cancelada. |
| STATE_HIBERNATION_ENTER | os apps precisam ser limpos e estar prontos para a hibernação. |
| STATE_POST_HIBERNATION_ENTER | As preparações para a hibernação foram concluídas, e a VMCU está pronta para entrar no estado de hibernação. |
| STATE_HIBERNATION_EXIT | Sair da hibernação ou retomar de uma hibernação cancelada. |
| STATE_WAIT_FOR_VHAL | O sistema está sendo iniciado, mas aguardando para estabelecer comunicação com a VHAL antes de passar para o estado ON. |
Cancelamento do registro de CarPowerStateListener
Para cancelar o registro de todos os objetos de listener registrados no CPM, chame o método clearListener:
powerManager.clearListener();
Integração do sistema na implementação do Android
Os integradores são responsáveis pelos seguintes itens:
- Implementação da interface do kernel para suspender o Android.
- Implementar as funções da VHAL para:
- Propagar a inicialização da suspensão ou do desligamento do carro para o Android.
- Envie a mensagem de prontidão para desligamento do Android para o carro.
- Iniciar o desligamento ou a suspensão do Android pela interface do kernel do Linux.
- Verifique se todas as fontes de ativação estão desativadas quando o dispositivo está suspenso.
- Verifique se os apps são encerrados com rapidez suficiente para não adiar indefinidamente o processo de encerramento.
- Verifique se o BSP ativa (ou desativa) os componentes do dispositivo de acordo com a política de energia para não bloquear a suspensão ou a hibernação.
Interface do kernel: /sys/power/state
O AAOS coloca um dispositivo no modo de suspensão quando um app ou serviço grava mem para
suspensão na RAM ou disk para suspensão no disco em um arquivo localizado em
/sys/power/state. O integrador precisa fornecer uma função que monitore esse arquivo e
coloque o Linux no estado de energia de suspensão. Essa função pode enviar um GPIO para a VMCU para notificar
que o dispositivo foi completamente desligado. O integrador também é responsável por remover qualquer
disputa entre a VHAL que envia a mensagem final para a VMCU e o sistema que entra no
modo de suspensão ou desligamento.
Responsabilidade da VHAL
A VHAL fornece uma interface entre a rede do veículo e o Android. A VHAL:
- Propaga o início da suspensão ou do desligamento do carro para o Android.
- Envia a mensagem de prontidão para desligamento do Android para o carro.
- Inicia o desligamento ou a suspensão do Android pela interface do kernel do Linux.
Quando o CPMS informa à VHAL que está pronto para ser encerrado, a VHAL envia a mensagem de prontidão para encerramento à VMCU. Normalmente, periféricos no chip, como UART, SPI e USB, transmitem a mensagem. Depois que a mensagem é enviada, o CPMS chama o comando do kernel para suspender ou desligar o dispositivo. Antes de fazer isso, a VHAL ou o BSP pode alternar um GPIO para instruir a VMCU de que é seguro remover a energia do dispositivo.
A VHAL precisa ser compatível com as seguintes propriedades, que controlam o gerenciamento de energia pela VHAL:
| Nome | Descrição |
|---|---|
| AP_POWER_STATE_REPORT | O Android informa as transições de estado para a VMCU com essa propriedade, usando os valores de tipo enumerado VehicleApPowerStateReport. |
| AP_POWER_STATE_REQ | A VMCU usa essa propriedade para instruir o Android a fazer a transição para diferentes estados de energia, usando os valores de tipo enumerado VehicleApPowerStateReq. |
AP_POWER_STATE_REPORT
Use essa propriedade para informar o estado atual de gerenciamento de energia do Android. Essa propriedade contém dois números inteiros:
int32Values[0]: tipo enumerado VehicleApPowerStateReport do estado atual.int32Values[1]: tempo em milissegundos para adiar, suspender ou desligar. O significado desse valor depende do primeiro valor.
O primeiro valor pode ser um dos seguintes: VehicleApPowerStateReport.aidl
contém descrições mais específicas, que são armazenadas em
hardware/interfaces/automotive/vehicle/aidl/android/hardware/automotive/vehicle.
| Nome do valor | Descrição | Segundo valor |
|---|---|---|
| WAIT_FOR_VHAL | O AP está iniciando e precisa estabelecer comunicação com a VHAL. | |
| DEEP_SLEEP_ENTRY | O AP está entrando no estado de sono profundo. A VMCU precisa ligar o AP novamente após o tempo especificado no segundo valor. | Precisa ser definido |
| DEEP_SLEEP_EXIT | O AP está saindo do estado de sono profundo. | |
| HIBERNATION_ENTRY | O AP está entrando no estado de hibernação. A VMCU precisa ligar o AP novamente após o tempo especificado no segundo valor. | Precisa ser definido |
| HIBERNATION_EXIT | O AP está saindo do estado de hibernação. | |
| SHUTDOWN_POSTPONE | O Android não está pronto para ser desligado. A VMCU precisa aguardar o tempo especificado no segundo valor antes de encerrar o AP. O Android pode solicitar mais adiamentos emitindo outros relatórios SHUTDOWN_POSTPONE. | Precisa ser definido |
| SHUTDOWN_PREPARE | O Android está se preparando para desligar. | Precisa ser definido |
| SHUTDOWN_START | O AP está pronto para ser desligado. A VMCU precisa ligar o AP novamente após o tempo especificado no segundo valor. A VMCU não é necessária para oferecer suporte ao recurso de ativação programada. | Precisa ser definido |
| SHUTDOWN_CANCELLED | O Android está interrompendo a preparação para o desligamento e vai prosseguir para WAIT_FOR_VHAL. | |
| ATIVADO | O Android está funcionando normalmente. |
O estado pode ser definido de forma autônoma ou em resposta a uma solicitação pela VMCU.
AP_POWER_STATE_REQ
Essa propriedade é enviada pela VMCU para fazer a transição do Android para um estado de energia diferente e contém dois números inteiros:
int32Values[0]: valor de tipo enumeradoVehicleApPowerStateReq, que representa o novo estado para o qual fazer a transição.int32Values[1]: valor de tipo enumeradoVehicleApPowerStateShutdownParam. Esse valor é enviado apenas para uma mensagemSHUTDOWN_PREPAREe transmite ao Android as opções que ela contém.
O primeiro valor inteiro representa o novo estado para o qual o Android vai transitar. A semântica
é definida em VehicleApPowerStateReq.aidl e fornecida abaixo:
| Nome do valor | Descrição |
|---|---|
| ATIVADO | O AP deve começar a operar totalmente. |
| SHUTDOWN_PREPARE | O AP precisa se preparar para desligar. O segundo valor indica se o AP pode adiar o desligamento e se ele deve ser desligado ou entrar em suspensão profunda. |
| CANCEL_SHUTDOWN | O AP precisa interromper a preparação para desligar e se preparar para ligar. |
| FINISHED | O AP será encerrado ou suspenso. |
VehicleApPowerStateShutdownParam é definido em
VehicleApPowerStateShutdownParam.aidl. Esse tipo enumerado tem os seguintes elementos:
| Nome do valor | Descrição |
|---|---|
| CAN_SLEEP | O AP pode entrar em sono profundo em vez de desligar completamente. É permitido adiar. |
| CAN_HIBERNATE | O AP pode entrar em hibernação em vez de ser desligado completamente. É permitido adiar. |
| SHUTDOWN_ONLY | O AP deve ser desligado. É permitido adiar. O sono profundo não é permitido. |
| SLEEP_IMMEDIATELY | O AP pode entrar em sono profundo, mas precisa dormir ou desligar imediatamente. Não é permitido adiar. |
| HIBERNATE_IMMEDIATELY | O AP pode entrar em suspensão para o disco, mas precisa hibernar ou desligar imediatamente. Não é permitido adiar. |
| SHUTDOWN_IMMEDIATELY | O AP precisa ser desligado imediatamente. Não é permitido adiar. O sono profundo não é permitido. |
Fontes de ativação
O integrador precisa desativar as fontes de ativação adequadas quando o dispositivo estiver no modo de suspensão. As fontes de ativação comuns incluem heartbeats, modem, Wi-Fi e Bluetooth. A única fonte de ativação válida precisa ser uma interrupção da VMCU para ativar o SoC. Isso pressupõe que a VMCU pode detectar eventos de ativação remota no modem (como a partida remota do motor). Se essa funcionalidade for enviada ao AP, outra fonte de ativação para atender ao modem precisará ser adicionada.
Apps
Os OEMs precisam ter cuidado ao criar apps para que eles possam ser encerrados rapidamente e não adiem o processo indefinidamente.
Apêndice
Diretórios na árvore do código-fonte
| Conteúdo | Diretório |
|---|---|
| Código relacionado ao CarPowerManager. | packages/services/Car/car-lib/src/android/car/hardware/power |
| CarPowerManagementService e assim por diante. | packages/services/Car/service/src/com/android/car/power |
Serviços que lidam com a VHAL, como VehicleHal e HAlClient. |
packages/services/Car/service/src/com/android/car/hal |
| Definições de interface e propriedade da VHAL. | hardware/interfaces/automotive/vehicle/aidl/android/hardware/automotive/vehicle/ |
App de exemplo para dar uma ideia sobre o CarPowerManager |
packages/services/Car/tests/EmbeddedKitchenSinkApp/src/com/google/android/car/kitchensink |
Diagrama de classe
Este diagrama de classes mostra as classes e interfaces Java no sistema de gerenciamento de energia:

Figura 4. Diagrama de classe de potência.
Relação de objetos
A Figura 5 ilustra quais objetos têm referências a outros objetos. Uma borda significa que o objeto de origem contém uma referência ao objeto de destino. Por exemplo, VehicleHAL tem uma referência a um objeto PropertyHalService.

Figura 5. Diagrama de referência de objeto.