Cette page décrit comment Android gère les produits dotés de batteries amovibles ou sans batterie interne. Ces derniers appareils sont plutôt connectés à une source d'alimentation externe, telle qu'une prise de courant alternatif ou un port USB sur un autre appareil.
Une batterie est-elle présente ?
Le code suivant peut être utilisé par les applications pour détecter si l'appareil a une batterie actuellement présente :
```
final Intent batteryInfo = registerReceiver(null, new
IntentFilter(Intent.ACTION_BATTERY_CHANGED));
return batteryInfo.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
```
Comportement de l'appareil sans batterie
Si Android ne détecte pas de périphérique à batterie pour votre produit, les valeurs par défaut suivantes liées à la batterie sont utilisées. Notez que les valeurs par défaut ont changé dans la version Android 9. Ce tableau montre les différences.
| État de la batterie | Android 9 et supérieur | Android 8.1 et versions antérieures |
|---|---|---|
| Cadeau | faux | vrai |
| Statut | inconnu | mise en charge |
| Capacité restante | 0 | 100% |
| Santé | inconnu | bien |
| État en ligne du chargeur CA | non modifié | forcé à vrai |
Les fabricants peuvent modifier les paramètres par défaut à l'aide d'un pilote power_supply du noyau ou de Health HAL .
Android 9 et supérieur
Android 9 supprime certains codes précédents pour les appareils sans batterie qui, par défaut, prétendaient qu'une batterie était présente, était chargée à 100 % et était en bonne santé avec une lecture de température normale sur sa thermistance.
La plupart des API de framework qui traitent ces informations continuent de gérer les situations courantes de la même manière qu'auparavant : le système sera considéré comme étant en charge (c'est-à-dire qu'il ne fonctionne pas sur batterie) et ne sera pas considéré comme ayant une batterie faible. Si l'interface utilisateur dessine l'icône de la batterie, elle apparaîtra avec un point d'exclamation et le pourcentage de la batterie sera affiché à 0 %. Mais l'appareil ne s'éteindra pas en raison d'une batterie faible, et les travaux nécessitant une charge ou une bonne batterie seront programmés.
Android 8.1 et versions antérieures
Étant donné que l'état de la batterie est inconnu, les API du framework Android considéreront que le système est en charge (ou ne fonctionne pas sur batterie) et ne seront pas considérés comme ayant une batterie faible. Si l'interface utilisateur affiche l'icône de la batterie, elle apparaîtra avec un point d'exclamation et le pourcentage de la batterie sera affiché à 0 %. Mais l'appareil ne s'éteindra pas en raison d'une batterie faible, et les travaux nécessitant une charge ou une bonne batterie seront programmés.
Mise en œuvre
Le code par défaut d'Android 9 peut fonctionner correctement pour votre appareil, mais il est recommandé d'effectuer un changement de noyau ou de HAL pour refléter avec précision l'état de l'alimentation et de la batterie de votre produit, comme décrit ci-dessus. Si Android 9 et supérieur ne détecte pas un chargeur de classe d'alimentation Linux , alors par défaut tous les types de chargeur (AC, USB, sans fil) auront le statut hors ligne . Si tous les chargeurs sont hors ligne mais qu'aucun dispositif de batterie n'est détecté, le système sera toujours considéré comme étant en charge dans le sens où il fonctionne sur une alimentation externe et non sur batterie, comme décrit précédemment.
Si votre produit n'a pas de batterie et est toujours connecté à une source d'alimentation, il est préférable d'implémenter un pilote de chargeur de classe power_supply du noyau Linux pour la source d'alimentation CA ou USB qui définit son attribut sysfs en ligne sur true . Ou vous pouvez configurer la propriété en ligne du chargeur CA dans un Health HAL pour votre appareil. Pour ce faire, implémentez un Health HAL comme décrit dans Implémentation de Health 2.0 .
Cette HAL de santé personnalisée implémente une version personnalisée de Health::getHealthInfo() qui modifie la valeur de BatteryProperties.chargerAcOnline = true .
Pour commencer, copiez le fichier hardware/interfaces/health/2.0/default/Health.cpp dans votre propre implémentation Health HAL et modifiez-le conformément au README Health 2.0 .