Règlement sur l'alimentation

Pour s'assurer que les composants matériels et logiciels (tels que l'écran, l'audio et l'interaction vocale) sont activés et désactivés de manière sélective, AAOS fournit une règle d'alimentation, qui consiste en un ensemble d'états d'activation et de désactivation attendus pour les composants matériels et logiciels. La VHAL ou les services de fournisseurs disposant de droits système peuvent appliquer une nouvelle règle d'alimentation lorsque l'état d'alimentation d'Android change ou lorsque les conditions qu'ils attendent sont remplies.

L'application d'une règle d'alimentation est autorisée dans les états "Attendre VHAL", "Activé" et "Préparation avant l'arrêt" (parfois avec certaines restrictions). Contrairement à "Attendre le VHAL" et "Activé", une règle d'alimentation par défaut ne peut pas être configurée pour "Préparation avant l'arrêt" dans un groupe de règles d'alimentation. Dans la phase principale de préparation de l'arrêt, le mode Garage est en cours d'exécution et ne doit pas être perturbé par un changement d'état d'alimentation. Bien qu'une règle d'alimentation standard ne puisse pas être appliquée, une règle d'alimentation spéciale, qui est la règle d'alimentation du système nommée aucune interaction utilisateur, est appliquée lors de la phase principale de préparation de l'arrêt.

État de l'alimentation AAOS

Les appareils AAOS suivent ce schéma d'état d'alimentation :

Figure 1. Diagramme d'état d'alimentation AAOS.

Chaque état d'alimentation est décrit ci-dessous :

Comment la règle de gestion de l'alimentation est-elle définie ?

Les implémenteurs définissent les règles d'alimentation dans /vendor/etc/automotive/power_policy.xml, qui :

• Définit la règle d'alimentation.
• Définit les groupes de règles d'alimentation, qui incluent la règle d'alimentation par défaut et sont automatiquement appliqués lors des transitions d'état d'alimentation.
• Remplace la règle d'alimentation du système.

Règles d'alimentation

La règle d'alimentation se compose d'un ensemble d'états d'alimentation attendus des composants matériels et logiciels. AAOS accepte les composants suivants dans la règle d'alimentation :

Les fournisseurs peuvent également définir leurs propres composants d'alimentation personnalisés à utiliser avec les règles d'alimentation. Définissez des composants d'alimentation personnalisés dans le même fichier XML que les règles d'alimentation, comme dans cet exemple :

<customComponents>
  CUSTOM_COMPONENT_1000
  CUSTOM_COMPONENT_SPECIAL_SENSOR
  CUSTOM_COMPONENT_AUX_INPUT
</customComponents>

Groupe de règles d'alimentation

Le groupe de règles d'alimentation spécifie la règle d'alimentation par défaut à appliquer automatiquement lors des transitions d'état d'alimentation. Les fournisseurs peuvent définir la règle d'alimentation par défaut pour les états "Wait for VHAL" (Attente de la VHAL) et "On" (Activé).

La règle d'alimentation par défaut pour "Attendre le VHAL" ou "Activé" est appliquée à chaque transition vers cet état, y compris lorsqu'un arrêt est annulé et qu'Android revient à l'état "Attendre le VHAL". Si aucune règle d'alimentation par défaut n'est définie pour un état donné dans le groupe de règles d'alimentation actuel, le daemon de règle d'alimentation de la voiture applique une règle d'alimentation intégrée. Une exception s'applique lorsque le système est en mode silencieux : le daemon de règle d'alimentation de la voiture enregistre la règle d'alimentation standard actuelle ou demandée comme étant en attente, verrouille les modifications de la règle d'alimentation standard et applique la règle d'alimentation du système sans interaction de l'utilisateur. L'application d'une règle d'alimentation ne modifie que les composants couverts par la règle, laissant les composants non concernés dans leur état actuel.

Règles d'alimentation du système

AAOS est compatible avec deux règles d'alimentation du système : aucune interaction utilisateur et préparation de la suspension. La règle d'alimentation du système est appliquée lorsque l'appareil passe en mode silencieux, en mode Garage, en mode Suspend-to-RAM ou en mode Suspend-to-disk.

Les tableaux suivants décrivent le comportement de chaque composant dans la règle d'alimentation du système. Les implémenteurs peuvent ignorer la détection du Bluetooth, du NFC et des appareils vérifiés dans la règle d'alimentation du système sans interaction de l'utilisateur. Les remplacements sont appliqués dans /vendor/etc/automotive/power_policy.xml.

aucune interaction de l'utilisateur

Le comportement de la règle d'alimentation du système Aucune interaction utilisateur est défini dans ce tableau :

suspendre la préparation

Le comportement de la règle d'alimentation du système suspend prep est défini dans ce tableau :

Interaction avec la VHAL

Le daemon de la règle d'alimentation de la voiture qui s'exécute dans la couche système s'abonne à deux propriétés pour écouter les requêtes de la VHAL :

• POWER_POLICY_REQ : le VHAL écrit l'ID de la règle d'alimentation dans cette propriété.
• POWER_POLICY_GROUP_REQ : le VHAL écrit l'ID du groupe de règles d'alimentation dans cette propriété.

La règle d'alimentation actuelle du système peut être modifiée par des modules autres que la VHAL. Dans ce cas, le daemon de la règle d'alimentation de la voiture met à jour la propriété CURRENT_POWER_POLICY pour notifier la modification au VHAL.

Interaction avec les processus natifs

Le service CarPowerManagementService (CPMS) délègue la gestion des règles d'alimentation au daemon de règles d'alimentation de la voiture. Le daemon est la source unique de vérité pour les règles d'alimentation du système. Le daemon de règle d'alimentation de la voiture gère l'état de la règle d'alimentation et informe le CPMS, le VHAL et les autres clients natifs des modifications.

Le daemon de règle d'alimentation de la voiture exporte les interfaces AIDL pour qu'elles soient utilisées par les HAL et d'autres processus natifs. Ils peuvent être avertis lorsqu'une nouvelle règle d'alimentation est modifiée. En d'autres termes, quand chacun doit changer d'état d'alimentation.

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

Interaction avec les modules Java

CarPowerManager fournit des méthodes pour activer la gestion des règles d'alimentation :

• Obtenir la stratégie d'alimentation actuelle
• Appliquer une nouvelle règle d'alimentation
• Définir un nouveau groupe de règles d'alimentation

Seuls les modules disposant de droits système peuvent utiliser les méthodes. Les modules qui souhaitent être informés lorsqu'une règle d'alimentation est appliquée peuvent enregistrer un écouteur de modification de règle d'alimentation sur CarPowerManager.