Android 9 включает android.hardware.health
HAL 2.0 — основную версию обновления Health@1.0 HAL. Этот новый HAL имеет следующие преимущества:
- Более четкое разделение между фреймворком и кодом поставщика.
- Устаревший ненужный демон
healthd
. - Большая степень свободы для настройки поставщиков в отчетах о состоянии здоровья.
- Больше информации о состоянии устройства, чем просто аккумулятор.
Android 11 включает android.hardware.health
HAL 2.1, небольшое обновление версии health@2.0 HAL. Этот новый HAL имеет следующие преимущества:
- Легче реализовать
- Лучшее соответствие существующим API HAL 2.0.
- Лучшее разделение высоких частот в коде зарядки в выключенном режиме
- Улучшенная поддержка системы для индикации состояния батареи устройства.
Android 13 включает android.hardware.health
AIDL HAL — преобразование HAL health@2.1. Этот новый HAL имеет следующие преимущества:
- Удалите неиспользуемые API, связанные с зарядным устройством.
- Удалите неиспользуемый
StorageAttribute
и связанные поля. - Поддержка док-зарядки.
Требования
Устройства под управлением Android 9 и Android 10
Устройства, запускаемые с Android 9, должны предоставлять HAL 2.x (и не должны предоставлять HAL 1.0) или AIDL HAL. Устройства, которые не запускаются с Android 9, но планируют обновить образ поставщика до версии 3 матрицы совместимости Target Framework (выпущенной в Android 9), должны удалить существующие реализации HAL 1.0 и предоставить HAL 2.x или AIDL HAL.
AOSP включает в себя несколько вспомогательных библиотек, призванных помочь вам реализовать HAL 2.0 и перейти со старой HAL 1.0.
Устройства под управлением Android 11 и Android 12
Устройства, запускаемые с Android 11, должны предоставлять HAL 2.1 (и не должны предоставлять HAL 1.0 или 2.0) или AIDL HAL. Устройства, которые не запускаются с Android 11, но планируют обновить образ поставщика до Target Framework Compatibility Matrix версии 5 (выпущенной в Android 11), должны удалить существующие реализации HAL 2.0 и предоставить HAL 2.1 или AIDL HAL. Устройствам, которые не запускаются с Android 11 и не планируют обновлять образ поставщика, также рекомендуется предоставить HAL 2.1.
AOSP включает в себя несколько вспомогательных библиотек, призванных помочь вам реализовать HAL 2.1 и перейти со старой HAL 1.0.
Устройства под управлением Android 13 и выше
Устройства, запускаемые с Android 13, должны предоставлять AIDL HAL (и не должны предоставлять HIDL HAL). Устройства, которые не запускаются с Android 13, но планируют обновить образ поставщика до версии 7 матрицы совместимости целевой платформы (выпущенной в Android 13), должны удалить существующие реализации HIDL HAL и предоставить AIDL HAL. Устройствам, которые не запускаются с Android 13 и не планируют обновлять образ поставщика, также рекомендуется предоставить AIDL HAL.
Устройства не должны поддерживать HIDL 1.0 HAL.
AOSP включает в себя несколько вспомогательных библиотек, предназначенных для помощи в реализации AIDL HAL и переходе от старых HIDL HAL.
Терминология
- health@1.0 : сокращение
android.hardware.health@1.0
. Относится к Health HIDL HAL версии 1.0, выпущенной в Android 8.0. - health@2.0 : аббревиатура
android.hardware.health@2.0
. Относится к Health HIDL HAL версии 2.0, выпущенной в Android 9. - health@2.1 : сокращение
android.hardware.health@2.1
. Относится к HIDL HAL версии 2.1, выпущенному в Android 11. - здоровье AIDL HAL : аббревиатура
android.hardware.health
.- Версия 1 выпущена в Android 13.
- зарядное устройство : исполняемый файл, работающий в выключенном режиме зарядки, который отображает анимацию зарядки телефона.
- восстановление : исполняемый файл, работающий в режиме восстановления, который должен получить информацию о батарее.
- healthd : устаревший демон, работающий в Android, который извлекает информацию, связанную со здоровьем, и передает ее в платформу.
- Storaged : демон, работающий в Android, который получает информацию о хранилище и предоставляет ее платформе.
Здоровье в Android 8.x
В Android 8.x компонент работоспособности работает, как показано на следующей схеме:
Рисунок 1 . Здоровье в Android 8.x.
На этой диаграмме:
- Один (1) вызов связывателя и один (1) вызов hwbinder используются платформой для связи с оборудованием.
-
healthd
статически ссылается наlibhealthd_android
,libbatterymonitor
иlibbatteryservice
. - health@1.0-impl статически ссылается на
libhealthd. BOARD
.
Каждая плата может настроить свой libhealthd. BOARD
; во время сборки определяется, к какому зарядному устройству, health@1.0-impl и восстановлению относятся ссылки.
Для других режимов:
Рисунок 2. Здоровье в Android 8.x, выключенный режим зарядки и режим восстановления.
- зарядное устройство статически ссылается на
libhealthd. BOARD
,libhealthd_charger
иlibbatterymonitor
. - восстановление статически ссылается на
libhealthd. BOARD
иlibbatterymonitor
.
Здоровье в Android 9
В Android 9 компонент работоспособности работает, как показано на следующей схеме:
Рисунок 3 . Здоровье в Android 9.
Платформа пытается получить службу health@2.0 от hwservicemanager
. В случае сбоя он вызывает health@1.0 (в Android 8.x). Путь к устаревшему коду сохраняется, поэтому образ системы Android 9 совместим с образом поставщика Android 8.x. Платформа не получает информацию из обоих HAL, поскольку на устройстве может существовать только одна версия службы (1.0 или 2.0).
Для других режимов:
Рисунок 4. Здоровье в Android 9, выключенный режим зарядки и режим восстановления.
Здоровье в Android 11
В Android 11 компонент работоспособности работает, как показано на следующей схеме:
[system]
| getService()
V
[health@2.1-service]
| getService(stub=true)
V
[ health@2.0-impl-2.1-<device>.so ]
| | (device-dependent linkage)
V V
+---------Helper libs for impl--------+ [libhealthd.device]
| [libhealthloop (uevent, wakealarm)] |
| [libhealth2impl (IHealth impl) ] |
| [libbatterymonitor (battery) ] |
+-------------------------------------+
Если реализация работоспособности 2.1 не существует, система возвращается к пути к устаревшему коду, как описано в предыдущих разделах.
Для других режимов:
[ charger ]
| getService() | (legacy code path)
V +-------------------------------------------------+
[health@2.1-service] |
| getService(stub=true) |
V |
[ health@2.0-impl-2.1-<device>.so ] |
| | (device-dependent linkage) |
V V |
+---------Helper libs for impl--------+ [libhealthd.device] |
| [libhealthloop (uevent, wakealarm)] | |
| [libhealth2impl (IHealth impl) ] | <---------------------------------+
| [libbatterymonitor (battery) ] |
+-------------------------------------+
[recovery]
| getService() w/o hwservicemanager
V
[ health@2.0-impl-2.1-<device>.so ]
| | (device-dependent linkage)
V V
+---------Helper libs for impl--------+ [libhealthd.device]
| [libhealthloop (uevent, wakealarm)] |
| [libhealth2impl (IHealth impl) ] |
| [libbatterymonitor (battery) ] |
+-------------------------------------+
См. следующую упрощенную схему для различных режимов:
Рисунок 5. Инфраструктура Health HAL 2.1.
Здоровье в Android 13
В Android 13 представлен AIDL HAL для здоровья. Компонент здоровья работает, как показано на следующей диаграмме:
Рис. 6. Инфраструктура Health AIDL HAL.
HIDL-HAL-интерфейс 2.0
Health@2.0 HAL предоставляет платформе ту же функциональность, что и старый демон healthd. Он также предоставляет API, аналогичные тем, которые Healthd ранее предоставлял в качестве службы привязки (т. е. IBatteryPropertiesRegistrar ).
Основной интерфейс IHealth предоставляет следующие функции:
-
registerCallback
для заменыIBatteryPropertiesRegistrar.registerListener
-
unregisterCallback
для заменыIBatteryPropertiesRegistrar.unregisterListener
-
update
, чтобы заменитьIBatteryPropertiesRegistrar.scheduleUpdate
-
IBatteryPropertiesRegistrar.getProperties
заменяются следующим:-
getChargeCounter
-
getCurrentNow
-
getCurrentAverage
-
getCapacity
-
getEnergyCounter
-
getChargeStatus
-
getHealthInfo
-
Кроме того, IHealth
предоставляет следующие новые API-интерфейсы для storaged
для получения информации, связанной с хранилищем конкретного поставщика:
-
getStorageInfo
-
getDiskStats
Новая структура @2.0::HealthInfo
возвращается через обратные вызовы и getHealthInfo
. Эта структура содержит всю информацию о состоянии устройства, доступную через health@2.0 HAL, включая:
- Информация о зарядке (переменный ток/USB/беспроводная связь, ток, напряжение и т. д.)
- Информация о батарее (наличие, уровень заряда батареи, ток, напряжение, заряд, технология и т. д.)
- Информация о хранилище (информация об устройстве хранения, статистика диска)
Сведения о реализации службы Health 2.0 см. в разделе Реализация Health 2.0 .
HIDL-HAL-интерфейс 2.1
Health@2.1 HAL поддерживает зарядку в выключенном состоянии и предоставляет дополнительную информацию о батарее.
Основной интерфейс IHealth предоставляет следующие дополнительные функции:
-
getHealthConfig
: для получения конфигурации этого HAL -
getHealthInfo_2_1
: незначительное обновление версииgetHealthInfo
-
shouldKeepScreenOn
: чтобы определить, должен ли экран оставаться включенным в режиме зарядного устройства.
Кроме того, реализация @2.1::IHealth
необходима для поддержки @2.1::IHealthInfoCallback
для унаследованных функций registerCallback
и unregisterCallback
. Новый интерфейс обратного вызова возвращает клиенту информацию о состоянии здоровья, используя функцию healthInfoChanged_2_1
вместо унаследованной функции healthInfoChanged
.
Новая структура @2.1::HealthInfo
возвращается через обратные вызовы и getHealthInfo_2_1
. Эта структура содержит дополнительную информацию о состоянии устройства, доступную через health@2.0 HAL, в том числе:
- Уровень емкости аккумулятора
- Время полной зарядки аккумулятора (в секундах)
- Расчетная емкость полной зарядки аккумулятора (мкАч)
На следующей диаграмме UML показаны классы, полезные для реализации работоспособности HAL:
Рис. 7. UML-диаграмма Health HAL 2.1.
Сведения о реализации службы Health 2.1 см. в разделе «Реализация Health 2.1» .
Интерфейс AIDL HAL версии 1
Изменения API
HAL AIDL версии 1 поддерживает API, аналогичные HAL HIDL 2.1. По сравнению с интерфейсом HIDL 2.1 в API изменено следующее:
- API-интерфейсы, связанные с зарядными устройствами, представленные в HIDL HAL 2.1, не перенесены в AIDL HAL. Поскольку функция зарядки в выключенном режиме существует только в разделе
/vendor
, API в интерфейсе поставщика не требуются. Чтобы правильно реализовать зарядку в выключенном режиме, см. зарядное устройство ниже. - Тип
StorageAttribute
и связанные поля удаляются, поскольку они не используются. -
chargerDockOnline
добавлен вHealthInfo
для поддержки зарядки от док-станции.
Выполнение
На следующей диаграмме UML показаны классы, полезные для реализации работоспособности HAL:
Рис. 8. UML-диаграмма Health AIDL HAL.
Информацию о реализации службы Health AIDL см. в разделе «Реализация Health AIDL HAL» .
Восстановление
Android 13 поддерживает связывание в восстановлении. Установка службы Health AIDL для восстановления позволяет ей работать в режиме восстановления.
Информацию об установке службы AIDL для восстановления работоспособности см. в следующих разделах:
Зарядное устройство
Функциональность зарядки в выключенном режиме перенесена из /system
в /vendor
. Для устройств, запускаемых с Android 13, если они поддерживают зарядку в выключенном режиме, двоичный файл службы HAL должен поддерживать режим зарядного устройства. Для этого обратитесь к разделу «Зарядное устройство» .
Свойства системы зарядного устройства
Свойства ro.charger.*
больше не доступны для чтения двоичному файлу charger
в /vendor
. Если на вашем устройстве установлены какие-либо системные свойства ro.charger.*
, обратитесь к свойствам системы для зарядного устройства .