Внедрение Health 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 и опрос. В init сервис health@2.1-service регистрирует реализацию интерфейса IHealth для hwservicemanager . При обновлении устройств с образом поставщика Android 8.x или 9 и платформой Android 11 образ поставщика может не предоставлять службу health@2.1. Обратная совместимость со старыми образами поставщиков обеспечивается графиком прекращения поддержки .

Чтобы обеспечить обратную совместимость:

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

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

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

В health@2.1 поставщики могут переопределить эти два значения интервала периодических работ в структуре healthd_config перед переходом к конструктору класса реализации работоспособности. Класс реализации работоспособности должен наследовать от 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.queryProperty(int id) был единственным клиентом IBatteryPropertiesRegistrar.getProperty . IBatteryPropertiesRegistrar.getProperty был предоставлен healthd и напрямую прочитан /sys/class/power_supply .

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

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

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

Изменения в SELinux

Health@2.1 HAL включает в себя следующие изменения 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 перед созданием службы работоспособности HAL 2.1.

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

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

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

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

  • Единицами мгновенного и среднего тока батареи должны быть микроамперы (мкА).
  • Знак мгновенного и среднего тока батареи должен быть правильным. Конкретно:
    • ток == 0, когда состояние батареи UNKNOWN
    • ток > 0, когда аккумулятор находится в состоянии CHARGING
    • ток <= 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 .