Política de energía

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Para garantizar que los componentes de hardware y software (como la pantalla, el audio y la interacción por voz) se enciendan y apaguen de forma selectiva según sea necesario, el AAOS proporciona una política de energía, que consiste en un conjunto de estados de encendido y apagado esperados para los componentes de hardware y software. VHAL, o los servicios de proveedores con privilegios del sistema, pueden aplicar una nueva política de energía cuando se produce la transición del estado de energía de Android o cuando se cumplen las condiciones que esperan.

Se permite aplicar una política de energía en los estados de Esperar VHAL y Encendido (a veces con algunas restricciones). En Shutdown Prepare, el modo garaje se está ejecutando y no debería verse afectado por un cambio de estado de energía. Aunque no se puede aplicar una política de energía normal, se aplica una política de energía especial, que es la política de energía del sistema denominada sin interacción del usuario, en Shutdown Prepare.

Estado de energía de AAOS

Los dispositivos AAOS siguen este diagrama de estado de energía:

Figura 1: Diagrama del estado de la alimentación de AAOS.

Cada estado de energía se describe a continuación:

¿Cómo se define la política de energía?

Los implementadores definen políticas de energía en /vendor/etc/automotive/power_policy.xml, que hacen lo siguiente:

• Define la política de energía.
• Define grupos de políticas de energía, que incluyen la política de energía predeterminada y se aplican automáticamente cuando se producen transiciones de estado de energía.
• Anula la política de alimentación del sistema.

Política de energía

La política de energía consta de un conjunto de estados de energía esperados de los componentes de hardware y software. El AAOS admite los siguientes componentes en la política de energía:

Los proveedores también pueden definir sus propios componentes de energía personalizados para usarlos con las políticas de energía. Define los componentes de energía personalizados en el mismo archivo en formato XML que las políticas de energía, como en este ejemplo:

<customComponents>
  CUSTOM_COMPONENT_1000
  CUSTOM_COMPONENT_SPECIAL_SENSOR
  CUSTOM_COMPONENT_AUX_INPUT
</customComponents>

Grupo de políticas de energía

La política de energía predeterminada se aplica automáticamente cuando se especifica la transición de estado de energía en el grupo de políticas de energía. Los proveedores pueden definir la política de energía predeterminada para Esperar a VHAL, Encendido y Esperar a que finalice VHAL (entrada de suspensión profunda o inicio de apagado).

Políticas de alimentación del sistema

El AAOS admite dos políticas de energía del sistema, que son sin interacción del usuario y suspender preparación. La política de energía del sistema se aplica cuando el dispositivo entra en modo silencioso, modo garaje, suspensión en la RAM o suspensión en el disco.

En las siguientes tablas, se indica el comportamiento de cada componente en la política de energía del sistema. Los implementadores pueden anular la detección de Bluetooth, NFC y dispositivos de confianza en la política de energía del sistema sin interacción del usuario. Las anulaciones se aplican en /vendor/etc/power_policy.xml.

sin interacción del usuario

El comportamiento de la política de energía del sistema sin interacción del usuario se define en esta tabla:

preparación para suspender

El comportamiento de la política de energía del sistema de preparación para suspender se define en esta tabla:

Interacción con el VHAL

El daemon de la política de energía del automóvil que se ejecuta en la capa del sistema suscribe dos propiedades para escuchar las solicitudes de la VHAL:

• POWER_POLICY_REQ El VHAL escribe el ID de la política de energía en esta propiedad.
• POWER_POLICY_GROUP_REQ El VHAL escribe el ID del grupo de políticas de energía en esta propiedad.

Los módulos que no son VHAL pueden cambiar la política de energía actual del sistema. En ese caso, el daemon de la política de energía del automóvil actualiza la propiedad CURRENT_POWER_POLICY para notificar el cambio al VHAL.

Interacción con procesos nativos

Como se mencionó anteriormente, el daemon de la política de energía del automóvil se ejecuta en la capa del sistema y, en términos de administración de políticas de energía, proporciona casi la misma funcionalidad que los CPM que se ejecutan en la capa del framework. Además, supongamos que el daemon de la política de activación de componentes del vehículo y CPMS están completamente sincronizados.

El daemon de la política de energía del automóvil exporta interfaces AIDL para que las usen los HAL y otros procesos nativos. Se les puede notificar cuando se cambia una nueva política de energía. En otras palabras, cuándo cada uno debe cambiar su estado de energía.

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);
  }

Interacción con módulos de Java

CarPowerManager proporciona métodos para habilitar la administración de políticas de energía:

• Obtén la política de energía actual
• Aplica una nueva política de energía
• Cómo establecer un nuevo grupo de políticas de energía

Solo los módulos con privilegios del sistema pueden usar los métodos. Los módulos que quieran estar informados cuando se aplique una política de energía pueden registrar un objeto de escucha de cambios de política de energía en CarPowerManager.