Правила в отношении питания

Чтобы аппаратные и программные компоненты (например, дисплей, аудио и голосовое взаимодействие) включались и выключались по мере необходимости, в AAOS предусмотрены правила электропитания, которые состоят из набора ожидаемых состояний включения и выключения аппаратных и программных компонентов. VHAL или системные сервисы поставщика могут применять новые правила электропитания при изменении состояния питания Android или при выполнении условий, которых они ожидают.

Применение правил электропитания разрешено в состояниях Wait for VHAL, On и Pre Shutdown Prepare (иногда с некоторыми ограничениями). В отличие от Wait for VHAL и On, для Pre Shutdown Prepare нельзя настроить политику энергопотребления по умолчанию в группе политик энергопотребления. На основном этапе подготовки к выключению работает режим обслуживания, и его не следует прерывать изменением состояния питания. Хотя обычное правило электропитания применить нельзя, на этапе подготовки к выключению применяется специальное правило электропитания – системное правило электропитания Без взаимодействия с пользователем.

Состояние питания AAOS

Устройства AAOS работают по следующей схеме:

Диаграмма состояний питания AAOS

Рисунок 1. Диаграмма состояний питания AAOS.

Ниже описаны все режимы питания.

Значение Описание
Отключено
  • Питание на процессор приложений, память и периферийные устройства не подается.
Ожидание VHAL
  • Когда водитель взаимодействует с автомобилем (например, открывает дверь), VMCU подает питание на процессор приложений, память и периферийные устройства.
  • AAOS переходит из одного из трех состояний (Off, Suspend-to-RAM (STR, Wait for VHAL to finish)) в состояние Wait for VHAL, в котором ожидает координации с VHAL.
Включено
  • VHAL дает AAOS команду перейти в состояние On (Включено). В этом состоянии AAOS полностью запущена и взаимодействует с водителем.
  • Дисплей управляется правилами электропитания, а не вызовами включения/выключения дисплея Android для других типов устройств.
Подготовка к отключению
  • Когда водитель останавливает автомобиль, VHAL дает AAOS команду перейти в режим подготовки к выключению. Сначала выполняется предварительная подготовка, а затем основная. На основном этапе дисплей и аудио выключены, а AAOS не взаимодействует с водителем. Система Android продолжает работать и может обновлять приложения и саму себя. После завершения обновлений система Android переходит в состояние ожидания завершения работы VHAL.
Дождитесь завершения работы VHAL
  • AAOS сообщает VHAL, что его можно отключить. Микроконтроллер автомобиля (VMCU) должен перевести систему на кристалле (SoC) в режим глубокого сна и отключить питание процессора приложений. После этого AAOS переходит в режим STR, но код не выполняется.
  • Если VHAL не завершает работу и водитель возвращается, стереосистема должна перейти в состояние ожидания VHAL.
Приостановка с сохранением в ОЗУ (STR)
  • Автомобиль и процессор приложений выключены, код не выполняется, питание подается на ОЗУ процессора приложений.
Приостановка с записью на диск (STD)
  • Автомобиль и процессор приложений выключены, код не выполняется, питание на блок обработки и ОЗУ процессора приложений не подается.

Как задаются правила управления питанием?

Разработчики определяют правила управления питанием в /vendor/etc/automotive/power_policy.xml, которые:

  • Определяет правила управления питанием.
  • Определяет группы правил управления электропитанием, которые включают правила по умолчанию и автоматически применяются при изменении состояния питания.
  • Переопределяет системные правила управления питанием.

Правила управления питанием

Правила управления питанием состоят из набора ожидаемых состояний питания аппаратных и программных компонентов. AAOS поддерживает следующие компоненты в правилах электропитания:

AUDIO
MEDIA
DISPLAY
BLUETOOTH
WIFI
CELLULAR
ETHERNET
PROJECTION
NFC
INPUT
VOICE_INTERACTION
VISUAL_INTERACTION
TRUSTED_DEVICE_DETECTION
LOCATION
MICROPHONE
CPU

Поставщики также могут определять собственные компоненты питания для использования с правилами электропитания. Определите пользовательские компоненты питания в том же XML-файле, что и правила электропитания, как в этом примере:

<customComponents>
  CUSTOM_COMPONENT_1000
  CUSTOM_COMPONENT_SPECIAL_SENSOR
  CUSTOM_COMPONENT_AUX_INPUT
</customComponents>

Группа правил управления питанием

Группа правил управления питанием определяет правило по умолчанию, которое автоматически применяется при переходе между состояниями питания. Поставщики могут задать правила электропитания по умолчанию для состояний Wait for VHAL и On.

При каждом переходе в состояние "Ожидание VHAL" или "Включено" применяется политика электропитания по умолчанию, в том числе когда выключение отменяется и Android возвращается в состояние "Ожидание VHAL". Если для определенного состояния в текущей группе правил электропитания не задано правило по умолчанию, демон правил электропитания автомобиля применяет встроенное правило. Исключение – когда система находится в режиме без звука. В этом случае демон политики электропитания автомобиля сохраняет текущую или запрошенную обычную политику электропитания как ожидающую, блокирует изменения обычной политики электропитания и применяет системную политику электропитания без взаимодействия с пользователем. Применение правила управления питанием изменяет только те компоненты, которые охватываются правилом, оставляя нетронутые компоненты в их текущем состоянии.

Правила в отношении питания системы

AAOS поддерживает два правила управления питанием: без взаимодействия с пользователем и подготовка к приостановке. Правила электропитания системы применяются, когда устройство переходит в режим без звука, режим гаража, режим приостановки с сохранением в ОЗУ или режим приостановки с сохранением на диск.

В таблицах ниже описано поведение каждого компонента в правилах управления электропитанием. Разработчики могут переопределить обнаружение Bluetooth, NFC и надежных устройств в правиле управления питанием Без взаимодействия с пользователем. Переопределения применяются в /vendor/etc/automotive/power_policy.xml.

без взаимодействия с пользователем

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

Компоненты Состояние питания Настраиваемый
Аудио Отключено Нет
Мультимедиа Отключено Нет
Экран Отключено Нет
Bluetooth Отключено Да
Wi-Fi Включено Нет
Мобильная сеть Включено Нет
Ethernet Включено Нет
Проекция Отключено Нет
NFC Отключено Да
Ввод Отключено Нет
Ассистент Отключено Нет
Взаимодействие с пользователем Отключено Нет
Обнаружение надежного устройства при входе пользователя в систему Включено Да
Местоположение Отключено Нет
Микрофон Отключено Нет
ЦП Включено Нет

подготовка к приостановке

В таблице ниже описано, как работает правило Подготовка к приостановке.

Компоненты Состояние питания Настраивается производителем
Аудио Отключено Нет
Мультимедиа Н/Д Нет
Экран Н/Д Нет
Bluetooth Отключено Нет
Wi-Fi Отключено Нет
Мобильная сеть Н/Д Нет
Ethernet Н/Д Нет
Проекция Н/Д Нет
NFC Н/Д Нет
Ввод Н/Д Нет
Ассистент Н/Д Нет
Взаимодействие с пользователем Н/Д Нет
Обнаружение надежного устройства при входе пользователя в систему Н/Д Нет
Местоположение Отключено Нет
Микрофон Отключено Нет
ЦП Отключено Нет

Взаимодействие с VHAL

Демон правил электропитания автомобиля, работающий на системном уровне, подписывается на два свойства, чтобы получать запросы от VHAL:

  • POWER_POLICY_REQ VHAL записывает идентификатор правила энергопотребления в это свойство.
  • POWER_POLICY_GROUP_REQ VHAL записывает идентификатор группы правил энергопотребления в это свойство.

Текущую политику энергопотребления в системе могут менять модули, отличные от VHAL. В этом случае демон политики энергопотребления автомобиля обновляет свойство CURRENT_POWER_POLICY, чтобы уведомить VHAL об изменении.

Взаимодействие с нативными процессами

CarPowerManagementService (CPMS) делегирует управление правилами электропитания демону правил электропитания автомобиля. Демон – это единый источник достоверных данных о правилах электропитания в системе. Демон правил электропитания автомобиля управляет состоянием правил электропитания и уведомляет CPMS, VHAL и другие нативные клиенты об изменениях.

Демон политики питания автомобиля экспортирует интерфейсы AIDL для использования HAL и другими нативными процессами. Они могут получать уведомления об изменении настроек электропитания. Другими словами, когда каждое из них должно изменить свое состояние питания.

ICarPowerPolicyServer.aidl

  package android.frameworks.automotive.powerpolicy;

  import android.frameworks.automotive.powerpolicy.CarPowerPolicy;
  import android.frameworks.automotive.powerpolicy.CarPowerPolicyFilter;
  import android.frameworks.automotive.powerpolicy.ICarPowerPolicyChangeCallback;
  import android.frameworks.automotive.powerpolicy.PowerComponent;

  /**
   * ICarPowerPolicyServer is an interface implemented by the power policy daemon.
   * VHAL changes the power policy and the power policy daemon notifies the change to
   * registered subscribers. When subscribing to policy changes, a filter can be specified so
   * that the registered callbacks can listen only to a specific power component's change.
   */

  @VintfStability
  interface ICarPowerPolicyServer {
    /**
     * Gets the current power policy.
     * @throws IllegalStateException if the current policy is not set.
     */
    CarPowerPolicy getCurrentPowerPolicy();

    /**
     * Gets whether the power component is turned on or off.
     *
     * @param componentId Power component ID defined in PowerComponent.aidl to check power
     * state.
     * @return True if the component's power state is on.
     * @throws IllegalArgumentException if the componentId is invalid.
     */
    boolean getPowerComponentState(in PowerComponent componentId);

    /**
     * Subscribes to power policy change.
     * Notification is sent to the registered callback when the power policy changes and the
     * power state of the components which the callback is interested in changes.
     *
     * @param callback Callback that is invoked when the power policy changes.
     * @param filter The list of components which the callback is interested in.
     * @throws IllegalArgumentException if the callback is already registered.
     * @throws IllegalStateException if the callback is dead.
     */
    void registerPowerPolicyChangeCallback(in ICarPowerPolicyChangeCallback callback,
        in CarPowerPolicyFilter filter);

    /**
     * Unsubscribes from power policy change.
     *
     * @param callback Callback that doesn't want to receive power policy change.
     * @throws IllegalArgumentException if the callback is not registered.
     */
    void unregisterPowerPolicyChangeCallback(in ICarPowerPolicyChangeCallback callback);

    /**
     * Applies the power policy.
     *
     * 

{@code policyId} should be one of power policy IDs defined in * {@code /vendor/etc/automotive/power_policy.xml} or predefined system power policies. * * @param policyId ID of power policy. * @throws IllegalArgumentException if {@code policyId} is invalid. */ void applyPowerPolicy(in @utf8InCpp String policyId); /** * Sets the current power policy group. * *

{@code policyGroupId} should be one of power policy group IDs defined in * {@code /vendor/etc/automotive/power_policy.xml}. * * @param policyGroupId ID of power policy group. * @throws IllegalArgumentException if {@code policyGroupId} is invalid. */ void setPowerPolicyGroup(in @utf8InCpp String policyGroupId); }

ICarPowerPolicyChangeCallback.aidl

  package android.frameworks.automotive.powerpolicy;

  import android.frameworks.automotive.powerpolicy.CarPowerPolicy;

  /**
   * ICarPowerPolicyChangeCallback is notified when a power policy changes.
   */

  @VintfStability
  oneway interface ICarPowerPolicyChangeCallback {
    /**
     * Called when a power policy is fully changed.
     *
     * @param policy The current policy.
     */
    void onPolicyChanged(in CarPowerPolicy policy);
  }

Взаимодействие с модулями Java

В CarPowerManager есть методы для управления правилами электропитания:

  • Как получить текущие правила электропитания
  • Как применить новые правила электропитания
  • Как настроить новую группу правил электропитания

Использовать эти методы могут только модули с системными привилегиями. Модули, которые должны получать информацию о применении правил электропитания, могут зарегистрировать прослушиватель изменений правил электропитания в CarPowerManager.