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 possui 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 o 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 | carregando |
Capacidade restante | 0 | 100% |
Saúde | desconhecido | bom |
Status on-line do carregador AC | Não modificado | forçado a verdadeiro |
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 em 100% e estava em boas condições com uma leitura de temperatura normal em seu termistor.
A maioria das APIs de estrutura que lidam com essas informações continuam lidando com situações comuns da mesma forma que anteriormente: o sistema será considerado em carregamento (ou seja, não funcionando com energia da 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 desligará devido à bateria fraca e os trabalhos que requerem 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 está funcionando com energia da bateria) e não será considerado como tendo 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 desligará devido à bateria fraca e os trabalhos que requerem carregamento ou bateria boa serão agendados.
Implementação
O código padrão do Android 9 pode funcionar corretamente para o 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 carregamento de classe de fonte de alimentação Linux , então, por padrão, todos os tipos de carregador (AC, USB, sem fio) terão status offline . Se todos os carregadores estiverem off-line, mas nenhum dispositivo de bateria for detectado, o sistema ainda será considerado em carregamento no sentido de que está funcionando com energia externa, não com bateria, conforme descrito anteriormente.
Se o seu produto não tiver uma 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 define seu atributo sysfs
online como true
. Ou você pode configurar a propriedade on-line do carregador CA em um Health HAL para 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 LEIA-ME do Health 2.0 .