Cómo brindar compatibilidad con dispositivos sin batería

En esta página, se describe cómo Android controla los productos que tienen baterías extraíbles o no tienen baterías internas. En su lugar, estos últimos dispositivos están conectados a una fuente de alimentación externa, como un enchufe de CA o un puerto USB de otro dispositivo.

¿Hay una batería?

Las aplicaciones pueden usar el siguiente código para detectar si el dispositivo tiene batería:

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

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

Comportamiento de los dispositivos sin batería

Si Android no detecta un dispositivo de batería para tu producto, se usarán los siguientes valores predeterminados relacionados con la batería. Ten en cuenta que los valores predeterminados cambiaron en la versión de Android 9. En esta tabla, se muestran las diferencias.

Estado de la batería Android 9 y versiones posteriores Android 8.1 y versiones anteriores
Presentar falso verdadero
Estado desconocido cargando
Capacidad restante 0 100%
Salud desconocido bueno
Estado en línea del cargador de CA no modificado forzado a verdadero

Los fabricantes pueden modificar la configuración predeterminada con un controlador power_supply del kernel o HAL de Health.

Android 9 y versiones posteriores

Android 9 quita algunos códigos anteriores de los dispositivos sin batería que, de forma predeterminada, simulaban tener una batería, se cargaban al 100% y estaban en buen estado con una lectura de temperatura normal en su termistor.

La mayoría de las APIs de framework que trabajan con esta información continúan controlando situaciones comunes de la misma manera que antes: se considera que el sistema está cargando (es decir, que no funciona con batería) y no se considerará que tiene batería baja. Si la interfaz de usuario dibuja el ícono de batería, aparecerá con un signo de exclamación, y el porcentaje de batería se mostrará como 0%. Sin embargo, el dispositivo no se apagará debido a la batería baja, y se programan trabajos que requieran carga o batería.

Android 8.1 y versiones anteriores

Como se desconoce el estado de la batería, las APIs del framework de Android considerarán que el sistema se está cargando (o que no funciona con batería) y no se considerará que tiene poca batería. Si la interfaz de usuario renderiza el ícono de batería, aparecerá con un signo de exclamación, y el porcentaje de batería se mostrará como 0%. Sin embargo, el dispositivo no se apagará debido a la batería baja, y se programarán las tareas que requieran carga o batería en buen estado.

Implementación

Es posible que el código predeterminado de Android 9 funcione correctamente en tu dispositivo, pero se recomienda realizar un cambio en el kernel o en el HAL para reflejar con precisión el estado de la batería y la energía de tu producto, como se describió anteriormente. Si Android 9 y las versiones posteriores no detectan un dispositivo cargador de clase de fuente de alimentación de Linux, todos los tipos de cargadores (AC, USB, inalámbricos) tendrán el estado sin conexión de forma predeterminada. Si todos los cargadores están sin conexión, pero no se detecta ningún dispositivo con batería, se considerará que el sistema se está cargando en el sentido de que funciona con energía externa y no con batería, como se describió anteriormente.

Si tu producto no tiene batería y siempre está conectado a una fuente de alimentación, lo mejor es implementar un controlador de cargador de clase power_supply del kernel de Linux para la fuente de alimentación de CA o USB que establezca su atributo sysfs en línea en true. También puedes configurar la propiedad en línea del cargador de CA en una HAL de Health para tu dispositivo. Para ello, implementa una HAL de Health como se describe en Cómo implementar Health 2.0.

Esta HAL de estado personalizada implementa una versión personalizada de Health::getHealthInfo() que modifica el valor de BatteryProperties.chargerAcOnline = true.

Para comenzar, copia el archivo hardware/interfaces/health/2.0/default/Health.cpp a tu propia implementación de HAL de Health y modifícalo según el archivo readme de Health 2.0.