Gerenciamento de energia

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:

processador de aplicativo (AP)
Parte do system on a chip (SoC).
Pacote de suporte da placa (BSP)
A camada de software que contém firmware de inicialização específico do hardware e drivers de dispositivo que permitem que um sistema operacional incorporado funcione em um determinado ambiente de hardware (uma placa-mãe), integrado ao sistema operacional incorporado.
CarPowerManager (CPM)
Expõe uma API para que os apps se registrem para mudanças no estado de energia.
CarPowerManagementService (CPMS)
Coordena as transições de estado de energia, faz a interface com a VHAL para controle do estado de energia e realiza as chamadas finais para suspender e desligar.
CarPowerPolicyDaemon (CPPD)
Gerencia políticas de energia e expõe interfaces AIDL para que processos nativos registrem listeners de políticas de energia.
entrada ou saída de uso geral (GPIO, na sigla em inglês)
Um pino de sinal digital para uso geral.
camada de abstração de hardware (HAL)
Uma camada de software com que todos os outros módulos de nível superior precisam interagir para acessar a funcionalidade do hardware.
hibernar
Também conhecido como suspensão em disco (S2D/S4). O SoC é colocado no modo de energia S4 (hibernação), o conteúdo da RAM é gravado em mídia não volátil (como flash ou disco) e todo o sistema é desligado.
processador de mídia (MP)
Consulte system on a chip (SoC).
circuito integrado de gerenciamento de energia (PMIC)
Chip usado para gerenciar os requisitos de energia do sistema host.
system on a chip (SoC)
Processador principal que executa o AAOS, normalmente fornecido por fabricantes como Intel, MediaTek, Nvidia, Qualcomm, Renesas e Texas Instruments.
suspender
Também conhecido como suspensão para RAM (S2R ou STR, na sigla em inglês). O SoC é colocado no modo de energia S3, e a CPU é desligada enquanto a RAM permanece ligada.
HAL veicular (VHAL)
A API do Android usada para interagir com a rede do veículo. O parceiro de nível 1 ou OEM é responsável por escrever esse módulo. A rede do veículo pode usar qualquer camada física (como CAN, LIN, MOST e Ethernet). A VHAL abstrai essa rede para permitir que o AAOS interaja com o veículo.
Processador de interface do veículo (VIP)
Consulte a MCU do veículo.
Unidade de controle mestre do veículo (VMCU, na sigla em inglês)
O microcontrolador que fornece a interface entre a rede do veículo e o SoC. O SoC se comunica com a VMCU por sinais USB, UART, SPI e GPIO.

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:

Máquina de estado de energia do carro

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 recebem STATE_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:

Diagrama de referência dos componentes de energia

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:

Entrar em sono profundo

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:

  1. Para adquirir a instância do CPM, chame a API Car.
  2. 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 enumerado VehicleApPowerStateReq, que representa o novo estado para o qual fazer a transição.
  • int32Values[1]: valor de tipo enumerado VehicleApPowerStateShutdownParam. Esse valor é enviado apenas para uma mensagem SHUTDOWN_PREPARE e 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:

Diagrama de classe 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.

Diagrama de referência de objeto

Figura 5. Diagrama de referência de objeto.