Внедрить Здоровье 2.1

В Android 11 весь код healthd был переработан в libhealthloop и libhealth2impl , а затем модифицирован для реализации HAL health@2.1. Эти две библиотеки статически связаны с health@2.0-impl-2.1 , сквозной реализацией Health 2.1. Статически связанные библиотеки позволяют health@2.0-impl-2.1 выполнять ту же работу, что и healthd , например, запускать healthd_mainloop и опрашивать систему. В процессе инициализации health@2.1-service регистрирует реализацию интерфейса IHealth в hwservicemanager . При обновлении устройств с образом поставщика Android 8.x или 9 и фреймворком Android 11, образ поставщика может не предоставлять службу health@2.1. Обратная совместимость со старыми образами поставщиков обеспечивается графиком устаревания .

Для обеспечения обратной совместимости:

  1. healthd регистрирует IHealth в hwservicemanager , несмотря на то, что это системный демон. IHealth добавляется в системный манифест с именем экземпляра "backup".
  2. Взаимодействия между фреймворком и storaged со healthd осуществляются через hwbinder а не через binder .
  3. В коде для framework и storaged внесены изменения, позволяющие получать экземпляр "default", если он доступен, а затем "backup".
    • Клиентский код на C++ использует логику, определенную в libhealthhalutils .
    • Клиентский Java-код использует логику, определенную в HealthServiceWrapper .
  4. После того, как IHealth/default станет широко доступен, а образы поставщиков Android 8.1 будут признаны устаревшими, IHealth/backup и healthd также могут быть признаны устаревшими.

Переменные сборки, специфичные для платы, для healthd

Переменные BOARD_PERIODIC_CHORES_INTERVAL_* являются специфичными для платы и используются для сборки healthd . В рамках разделения сборки на системную и производственную версии, значения, специфичные для платы, не могут быть определены для системных модулей. Ранее эти значения переопределялись в устаревшей функции healthd_board_init .

В health@2.1 поставщики могут переопределить значения интервалов этих двух периодических задач в структуре healthd_config перед передачей их конструктору класса реализации health. Класс реализации health должен наследовать от android::hardware::health::V2_1::implementation::Health .

Внедрить сервис Health 2.1

Для получения информации о внедрении сервиса Health 2.1 см. файл hardware/interfaces/health/2.1/README.md .

Пациенты медицинских учреждений

У health@2.x следующие клиенты:

  • Зарядное устройство. Использование кода libbatterymonitor и healthd_common обернуто в health@2.0-impl .
  • восстановление. Связывание с libbatterymonitor обернуто в health@2.0-impl . Все вызовы BatteryMonitor заменены вызовами класса реализации Health .

  • BatteryManager.BatteryManager.queryProperty BatteryManager.queryProperty(int id) был единственным клиентом IBatteryPropertiesRegistrar.getProperty . IBatteryPropertiesRegistrar.getProperty предоставлялся healthd и напрямую считывал данные /sys/class/power_supply .

    В целях безопасности приложениям запрещено напрямую обращаться к health HAL. В Android 9 и выше служба привязки IBatteryPropertiesRegistrar предоставляется сервисом BatteryService , а не healthd . BatteryService делегирует вызов health HAL для получения запрошенной информации.

  • BatteryService. В Android 9 и выше BatteryService использует HealthServiceWrapper для определения того, следует ли использовать экземпляр службы мониторинга состояния по умолчанию от vendor или резервный экземпляр службы мониторинга состояния от healthd . Затем BatteryService прослушивает события мониторинга состояния через IHealth.registerCallback .

  • Storaged. В Android 9 и выше storaged использует libhealthhalutils для определения того, следует ли использовать экземпляр службы мониторинга состояния по умолчанию от vendor или резервный экземпляр службы мониторинга состояния от healthd . Затем storaged прослушивает события мониторинга состояния через IHealth.registerCallback и получает информацию о хранилище.

Изменения в SELinux

В HAL health@2.1 внесены следующие изменения в SELinux для платформы:

  • Добавляет android.hardware.health@2.1-service в file_contexts .

Для устройств с собственной реализацией SELinux могут потребоваться некоторые изменения, внесенные производителем. Пример:

# device/<manufacturer>/<device>/sepolicy/vendor/hal_health_default.te
# Add device specific permissions to hal_health_default domain, especially
# if it links to board-specific libhealthd or implements storage APIs.

Интерфейсы ядра

Демон healthd и реализация по умолчанию android.hardware.health@2.0-impl-2.1 обращаются к следующим интерфейсам ядра для получения информации о состоянии батареи:

  • /sys/class/power_supply/*/capacity_level (добавлено в Health 2.1)
  • /sys/class/power_supply/*/capacity
  • /sys/class/power_supply/*/charge_counter
  • /sys/class/power_supply/*/charge_full
  • /sys/class/power_supply/*/charge_full_design (добавлено в Health 2.1)
  • /sys/class/power_supply/*/current_avg
  • /sys/class/power_supply/*/current_max
  • /sys/class/power_supply/*/current_now
  • /sys/class/power_supply/*/cycle_count
  • /sys/class/power_supply/*/health
  • /sys/class/power_supply/*/online
  • /sys/class/power_supply/*/present
  • /sys/class/power_supply/*/status
  • /sys/class/power_supply/*/technology
  • /sys/class/power_supply/*/temp
  • /sys/class/power_supply/*/time_to_full_now (добавлено в Health 2.1)
  • /sys/class/power_supply/*/type
  • /sys/class/power_supply/*/voltage_max
  • /sys/class/power_supply/*/voltage_now

Любая реализация HAL для мониторинга состояния устройства, использующая libbatterymonitor , по умолчанию обращается к этим интерфейсам ядра, если иное не указано в конструкторе класса реализации мониторинга состояния.

Если эти файлы отсутствуют или недоступны для healthd или для службы по умолчанию (например, файл является символической ссылкой на папку, специфичную для конкретного поставщика, доступ к которой запрещен из-за неправильно настроенной политики SELinux), они могут работать некорректно. Поэтому могут потребоваться дополнительные изменения в настройках SELinux, специфичные для конкретного поставщика, даже если используется реализация по умолчанию.

Некоторые интерфейсы ядра, используемые в Health 2.1, такие как /sys/class/power_supply/*/capacity_level и /sys/class/power_supply/*/time_to_full_now , могут быть необязательными. Однако, чтобы предотвратить некорректное поведение фреймворка, возникающее из-за отсутствия интерфейсов ядра, рекомендуется выполнить выборку изменений из CL 1398913 перед сборкой службы Health HAL 2.1.

Тестирование

В Android 11 добавлены новые тесты VTS, специально разработанные для HAL health@2.1. Если устройство объявляет HAL health@2.1 в манифесте устройства, оно должно пройти соответствующие тесты VTS. Тесты написаны как для экземпляра по умолчанию (чтобы убедиться, что устройство корректно реализует HAL), так и для резервного экземпляра (чтобы убедиться, что healthd продолжает корректно работать до его удаления).

Требования к информации о батарее

HAL Health 2.0 устанавливает ряд требований к интерфейсу HAL, но соответствующие тесты VTS относительно лояльно относятся к их соблюдению. В Android 11 добавлены новые тесты VTS, обеспечивающие соблюдение следующих требований на устройствах, запускаемых с Android 11 и выше:

  • Единицами измерения мгновенного и среднего тока батареи должны быть микроамперы (мкА).
  • Знаки мгновенного и среднего тока батареи должны быть правильными. В частности:
    • Текущий ток равен 0, когда состояние батареи UNKNOWN
    • Текущий ток > 0, когда состояние батареи — CHARGING
    • current <= 0, когда состояние батареи NOT_CHARGING
    • Текущий ток < 0, когда состояние батареи — DISCHARGING
    • Не применяется, когда состояние батареи FULL
  • Состояние батареи должно корректно отображаться независимо от того, подключен ли источник питания. В частности:
    • Состояние батареи должно быть одним из следующих: CHARGING , NOT_CHARGING или FULL , только если подключен источник питания;
    • Состояние батареи должно быть DISCHARGING только в том случае, если источник питания отключен.

Если вы используете libbatterymonitor в своей реализации и передаете значения из интерфейсов ядра, убедитесь, что узлы sysfs сообщают корректные значения:

  • Убедитесь, что ток батареи отображается с правильным знаком и единицами измерения. Это относится и к следующим узлам sysfs:
    • /sys/class/power_supply/*/current_avg
    • /sys/class/power_supply/*/current_max
    • /sys/class/power_supply/*/current_now
    • Положительные значения указывают на поступление тока в батарею.
    • Значения должны быть указаны в микроамперах (мкА).
  • Убедитесь, что напряжение батареи отображается в микровольтах (мкВ). Это относится и к следующим узлам sysfs:
    • /sys/class/power_supply/*/voltage_max
    • /sys/class/power_supply/*/voltage_now
    • Обратите внимание, что реализация HAL по умолчанию делит voltage_now на 1000 и выводит значения в милливольтах (мВ). См. @1.0::HealthInfo .

Для получения более подробной информации см. раздел «Источники питания Linux» .