Supporto di dispositivi senza batteria

Questa pagina descrive il modo in cui Android gestisce i prodotti dotati di batterie rimovibili o privi di batterie interne. Questi ultimi dispositivi vanno invece collegati ad una fonte di alimentazione esterna, come una presa di corrente AC o una porta USB di un altro dispositivo.

È presente una batteria?

Il seguente codice può essere utilizzato dalle applicazioni per rilevare se il dispositivo ha una batteria attualmente presente:

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

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

Comportamento del dispositivo senza batteria

Se Android non rileva un dispositivo a batteria per il tuo prodotto, vengono utilizzati i seguenti valori predefiniti relativi alla batteria. Tieni presente che le impostazioni predefinite sono cambiate nella versione Android 9. Questa tabella mostra le differenze.

Stato della batteria Android 9 e versioni successive Android 8.1 e versioni precedenti
Presente falso VERO
Stato sconosciuto ricarica
Capacità rimanente 0 100%
Salute sconosciuto Bene
Stato online del caricabatterie CA non modificato forzato a vero

I produttori possono modificare le impostazioni predefinite utilizzando un driver power_supply del kernel o un HAL Health .

Android 9 e versioni successive

Android 9 rimuove alcuni codici precedenti per i dispositivi senza batteria che per impostazione predefinita fingevano che fosse presente una batteria, che fosse caricata al 100% ed era in buona salute con una lettura della temperatura normale sul termistore.

La maggior parte delle API del framework che gestiscono queste informazioni continuano a gestire le situazioni comuni come in precedenza: il sistema verrà considerato in carica (ovvero, non alimentato a batteria) e non verrà considerato con la batteria scarica. Se l'interfaccia utente disegna l'icona della batteria, verrà visualizzata con un punto esclamativo e la percentuale della batteria verrà visualizzata come 0%. Ma il dispositivo non si spegnerà a causa della batteria scarica e verranno programmati i lavori che richiedono ricarica o una batteria carica.

Android 8.1 e versioni precedenti

Poiché lo stato della batteria è sconosciuto, le API del framework Android considereranno il sistema in carica (o non funzionante a batteria) e non considereranno la batteria scarica. Se l'interfaccia utente visualizza l'icona della batteria, verrà visualizzata con un punto esclamativo e la percentuale della batteria verrà visualizzata come 0%. Ma il dispositivo non si spegnerà a causa della batteria scarica e verranno programmati i lavori che richiedono ricarica o una batteria carica.

Implementazione

Il codice predefinito di Android 9 potrebbe funzionare correttamente per il tuo dispositivo, ma è consigliabile apportare una modifica al kernel o all'HAL per riflettere con precisione lo stato di alimentazione e batteria del tuo prodotto, come descritto sopra. Se Android 9 e versioni successive non rilevano un dispositivo caricabatterie di classe alimentatore Linux , per impostazione predefinita tutti i tipi di caricabatterie (AC, USB, wireless) avranno lo stato offline . Se tutti i caricabatterie sono offline ma non viene rilevato alcun dispositivo batteria, il sistema verrà comunque considerato in carica nel senso che funziona con alimentazione esterna e non con batteria, come descritto in precedenza.

Se il tuo prodotto non ha una batteria ed è sempre collegato a una fonte di alimentazione, è meglio implementare un driver del caricabatterie della classe power_supply del kernel Linux per la fonte di alimentazione CA o USB che imposta il suo attributo online sysfs su true . In alternativa, puoi configurare la proprietà online del caricabatterie CA in un HAL di integrità per il tuo dispositivo. A tale scopo, implementare un HAL di salute come descritto in Implementazione di Health 2.0 .

Questo HAL di integrità personalizzato implementa una versione personalizzata di Health::getHealthInfo() che modifica il valore di BatteryProperties.chargerAcOnline = true .

Per iniziare, copia il file hardware/interfaces/health/2.0/default/Health.cpp nella tua implementazione HAL di Health e modificalo in base al README di Health 2.0 .