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 selon les besoins, AAOS fournit une stratégie d'alimentation, qui consiste en un ensemble d'états d'activation et de désactivation attendus pour les composants matériels et logiciels. VHAL ou les services fournisseurs privilégiés du système peuvent appliquer une nouvelle stratégie d'alimentation lorsque l'état d'alimentation 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 "Wait for VHAL" et "On" (parfois avec certaines restrictions). En mode Préparation à l'arrêt, le mode Garage est en cours d'exécution et ne doit pas être perturbé par un changement d'état de l'alimentation. Bien qu'une stratégie d'alimentation normale ne puisse pas être appliquée, une stratégie d'alimentation spéciale, qui est la stratégie d'alimentation système nommée "aucune interaction utilisateur", est appliquée dans la phase de préparation à l'arrêt.

État de l'alimentation AAOS

Les appareils AAOS suivent ce diagramme d'état de l'alimentation :

Schéma de l'état de l'alimentation AAOS

Figure 1. Diagramme de l'état de l'alimentation AAOS.

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

Valeur Description
Désactivé
  • Aucune alimentation n'est physiquement fournie au processeur d'application (AP), à la mémoire et aux périphériques.
Attendre VHAL
  • Lorsque le conducteur interagit avec le véhicule (par exemple, en ouvrant une portière), le VMCU alimente l'AP, la mémoire et les périphériques.
  • AAOS passe de l'un des trois états (désactivé, suspendu à la RAM (STR, Wait for VHAL to finish)) et passe ensuite à l'état "Wait for VHAL" (Attente de la fin de VHAL), où il attend la coordination avec VHAL.
Activé
  • Le VHAL demande à AAOS de passer à l'état "On". Dans cet état, AAOS est entièrement opérationnel et interagit avec le conducteur.
  • L'affichage est contrôlé par la stratégie d'alimentation et non par les appels d'activation/désactivation de l'affichage Android pour d'autres facteurs de forme.
Préparation de l'arrêt
  • Lorsque le conducteur a arrêté de conduire, la VHAL demande à AAOS de passer en mode "Shutdown Prepare" (Préparation à l'arrêt). Dans cet état, l'écran et le son sont désactivés, et AAOS n'interagit pas avec le conducteur. Le système Android est toujours en cours d'exécution et peut mettre à jour les applications et le système Android. Une fois les mises à jour (le cas échéant) terminées, le système Android passe à l'état "Wait for VHAL Finish" (Attente de la fin de VHAL).
Attendre la fin de VHAL
  • AAOS informe le VHAL qu'il peut être éteint. L'unité de microcontrôleur du véhicule (VMCU) est censée mettre le système sur puce (SoC) en veille prolongée et couper l'alimentation du PA. AAOS est alors en état STR, bien qu'aucun code ne soit exécuté.
  • Si VHAL ne se termine pas et que le conducteur revient, l'unité principale (UP) doit passer directement à "Attente de VHAL".
Suspendre vers RAM (STR)
  • Le véhicule et le PA sont éteints, aucun code n'est exécuté et l'alimentation est maintenue à la RAM du PA.
Suspend-to-disk (STD)
  • Le véhicule et le PA sont éteints, aucun code n'est exécuté et aucune alimentation n'est maintenue pour l'unité de traitement et la RAM du PA.

Comment la politique d'alimentation est-elle définie ?

Les implémenteurs définissent les stratégies 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 lorsque des transitions d'état d'alimentation se produisent.
  • Remplace la règle d'alimentation du système.

Règlement sur l'alimentation

La stratégie 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 stratégie d'alimentation :

AUDIO
MULTIMÉDIA
ÉCRAN
BLUETOOTH 		WIFI
CELLULAR
ETHERNET
PROJECTION 		NFC
INPUT
VOICE_INTERACTION
VISUAL_INTERACTION 		TRUSTED_DEVICE_DETECTION
LOCATION
MICROPHONE
CPU

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'activation

Le groupe de règles d'alimentation spécifie la règle d'alimentation par défaut à appliquer automatiquement lors des transitions d'état de l'alimentation. Les fournisseurs peuvent définir la règle d'alimentation par défaut pour les états "Wait For VHAL", "On" et "Wait for VHAL Finish" (Deep Sleep Entry ou Shutdown Start).

Règles d'alimentation du système

AAOS est compatible avec deux règles d'alimentation du système : aucune interaction de l'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 veille avec mise en RAM ou en mode veille avec mise sur disque.

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

aucune interaction de l'utilisateur

Le comportement de la règle d'alimentation système aucune interaction de l'utilisateur est défini dans le tableau suivant :

Composants État de l'alimentation Configurable
Audio Désactivé Non
Contenus multimédias Désactivé Non
Écran Désactivé Non
Bluetooth Désactivé Oui
Wi-Fi Activé Non
Connexion cellulaire Activé Non
Ethernet Activé Non
Projection Désactivé Non
NFC Désactivé Oui
Entrée Désactivé Non
Assistant Désactivé Non
Interaction de l'utilisateur Désactivé Non
Détection des appareils de confiance pour la connexion des utilisateurs Activé Oui
Emplacement Désactivé Non
Micro Désactivé Non
Processeur Activé Non

suspendre la prep

Le comportement de la règle d'alimentation système Préparation à la suspension est défini dans le tableau suivant :

Composants État de l'alimentation Configurable par l'OEM
Audio Désactivé Non
Contenus multimédias N/A Non
Écran N/A Non
Bluetooth Désactivé Non
Wi-Fi Désactivé Non
Connexion cellulaire N/A Non
Ethernet N/A Non
Projection N/A Non
NFC N/A Non
Entrée N/A Non
Assistant N/A Non
Interaction de l'utilisateur N/A Non
Détection des appareils de confiance pour la connexion des utilisateurs N/A Non
Emplacement Désactivé Non
Micro Désactivé Non
Processeur Désactivé Non

Interaction avec le VHAL

Le démon de la politique d'alimentation de la voiture s'exécutant dans la couche système s'abonne à deux propriétés pour écouter les requêtes du VHAL :

  • POWER_POLICY_REQ : le VHAL écrit l'ID de la stratégie 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 VHAL. Dans ce cas, le démon 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 démon des règles d'alimentation de la voiture. Le daemon est la seule source d'informations fiables pour les règles d'alimentation du système. Le daemon de la règle d'alimentation de la voiture gère l'état de la règle d'alimentation et informe le CPMS, le VHAL et d'autres clients natifs des modifications.

Le démon de la stratégie d'alimentation de la voiture exporte les interfaces AIDL pour être utilisées par les HAL et d'autres processus natifs. Ils peuvent être avertis lorsqu'une nouvelle stratégie d'alimentation est modifiée. En d'autres termes, lorsque 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 stratégie d'alimentation
  • Définir un nouveau groupe de stratégies d'alimentation

Seuls les modules disposant de privilèges 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.