Supporto di dispositivi senza batteria

Questa pagina descrive come Android gestisce i prodotti con batterie rimovibili o senza batterie interne. Questi ultimi dispositivi sono invece collegati a una fonte di alimentazione esterna, come una presa di corrente CA o una porta USB su un altro dispositivo.

È presente una batteria?

Il codice seguente 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 con batteria per il tuo prodotto, vengono utilizzati i seguenti valori predefiniti relativi alla batteria. Nota che le impostazioni predefinite sono cambiate nella versione di Android 9. Questa tabella mostra le differenze.

Stato della batteria Android 9 e versioni successive Android 8.1 e precedenti
Regalo falso vero
Stato sconosciuto carica
Capacità rimanente 0 100%
Salute sconosciuto Buona
Stato in linea del caricatore CA non modificato costretto a vero

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

Android 9 e versioni successive

Android 9 rimuove alcuni codici precedenti per i dispositivi senza batteria che per impostazione predefinita facevano finta che fosse presente una batteria, fosse caricata al 100% ed era in buona salute con una normale lettura della temperatura sul suo 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 funzionante a batteria) e non verrà considerato con una batteria scarica. Se l'interfaccia utente disegna l'icona della batteria, questa apparirà 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 la ricarica o una buona batteria.

Android 8.1 e precedenti

Poiché lo stato della batteria è sconosciuto, le API del framework Android considereranno il sistema in carica (o non funzionante a batteria) e non saranno considerate con una batteria scarica. Se l'interfaccia utente esegue il rendering dell'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 la ricarica o una buona batteria.

Implementazione

Il codice predefinito di Android 9 potrebbe funzionare correttamente per il tuo dispositivo, ma si consiglia di apportare una modifica al kernel o HAL per riflettere accuratamente lo stato di alimentazione e batteria del prodotto, come descritto sopra. Se Android 9 e versioni successive non rilevano un dispositivo di ricarica della classe di alimentazione Linux , per impostazione predefinita tutti i tipi di caricabatterie (CA, USB, wireless) avranno lo stato offline . Se tutti i caricatori sono offline ma non viene rilevato alcun dispositivo batteria, il sistema sarà comunque considerato in carica nel senso che funziona con alimentazione esterna, non a 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 caricatore di classe power_supply del kernel Linux per la fonte di alimentazione CA o USB che imposta il suo attributo sysfs online su true . Oppure puoi configurare la proprietà online del caricabatterie CA in un HAL sanitario per il tuo dispositivo. A tale scopo, implementa un HAL di integrità come descritto in Implementazione dell'integrità 2.0 .

Questo HAL Health 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 Health HAL e modificalo in base a Health 2.0 README .