Suporte a dispositivos sem bateria

Esta página descreve como o Android lida com produtos com baterias removíveis ou sem baterias internas. Os últimos dispositivos são conectados a uma fonte de alimentação externa, como uma tomada CA ou porta USB em outro dispositivo.

A bateria está presente?

O código a seguir pode ser usado por aplicativos para detectar se o dispositivo tem uma bateria presente no momento:

```
final Intent batteryInfo = registerReceiver(null, new
IntentFilter(Intent.ACTION_BATTERY_CHANGED));

return batteryInfo.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
```

Comportamento do dispositivo sem bateria

Se o Android não detectar um dispositivo de bateria para seu produto, os seguintes valores padrão relacionados à bateria serão usados. Observe que os padrões foram alterados na versão do Android 9. Esta tabela mostra as diferenças.

Estado da bateria Android 9 e superior Android 8.1 e inferior
Presente falso verdadeiro
Status desconhecido cobrando
Capacidade restante 0 100%
Saúde desconhecido Boa
Status online do carregador AC Não modificado forçado a verdade

Os fabricantes podem alterar as configurações padrão usando um driver power_supply do kernel ou Health HAL .

Android 9 e superior

O Android 9 remove alguns códigos anteriores para dispositivos sem bateria que, por padrão, fingiam que uma bateria estava presente, estava sendo carregada a 100% e estava em boas condições com uma leitura de temperatura normal em seu termistor.

A maioria das APIs de framework que lidam com essas informações continuam a lidar com situações comuns da mesma forma que anteriormente: o sistema será considerado carregando (ou seja, não funcionando com bateria) e não será considerado com bateria fraca. Se a interface do usuário desenhar o ícone da bateria, ele aparecerá com um ponto de exclamação e a porcentagem da bateria será mostrada como 0%. Mas o dispositivo não será desligado devido à bateria fraca, e os trabalhos que exigem carregamento ou bateria boa serão agendados.

Android 8.1 e inferior

Como o status da bateria é desconhecido, as APIs da estrutura do Android considerarão que o sistema está carregando (ou não funcionando com bateria) e não será considerado com bateria fraca. Se a interface do usuário renderizar o ícone da bateria, ele aparecerá com um ponto de exclamação e a porcentagem da bateria será mostrada como 0%. Mas o dispositivo não será desligado devido à bateria fraca, e os trabalhos que exigem carregamento ou bateria boa serão agendados.

Implementação

O código padrão do Android 9 pode funcionar corretamente para seu dispositivo, mas é recomendável fazer uma alteração de kernel ou HAL para refletir com precisão a energia e o estado da bateria do seu produto, conforme descrito acima. Se o Android 9 e superior não detectar um dispositivo de carregador de classe de fonte de alimentação Linux , por padrão, todos os tipos de carregador (CA, USB, Sem fio) terão o status off -line. Se todos os carregadores estiverem off-line, mas nenhum dispositivo de bateria for detectado, o sistema ainda será considerado como carregando no sentido de que está funcionando com alimentação externa, não com bateria, conforme descrito anteriormente.

Se o seu produto não tiver bateria e estiver sempre conectado a uma fonte de alimentação, é melhor implementar um driver de carregador de classe power_supply do kernel Linux para a fonte de alimentação CA ou USB que defina seu atributo sysfs online como true . Ou você pode configurar a propriedade online do carregador AC em um Health HAL para o seu dispositivo. Para fazer isso, implemente um Health HAL conforme descrito em Implementando o Health 2.0 .

Este Health HAL personalizado implementa uma versão personalizada de Health::getHealthInfo() que modifica o valor de BatteryProperties.chargerAcOnline = true .

Para começar, copie o arquivo hardware/interfaces/health/2.0/default/Health.cpp para sua própria implementação do Health HAL e modifique-o de acordo com o Health 2.0 README .