Güç politikası

Donanım ve yazılım bileşenlerinin (ör. ekran, ses ve sesli etkileşim) gerektiğinde seçici bir şekilde açılıp kapatılmasını sağlamak için AAOS, donanım ve yazılım bileşenleri için beklenen bir dizi açma ve kapama durumundan oluşan bir güç politikası sağlar. VHAL veya sistem ayrıcalıklı tedarikçi hizmetleri, Android güç durumu geçiş yaptığında ya da bekledikleri koşullar karşılandığında yeni bir güç politikası uygulayabilir.

VHAL'yi Bekle ve Açık durumlarında (bazen bazı kısıtlamalarla) güç politikası uygulanmasına izin verilir. Kapatma hazırlığındayken Garaj Modu çalışır ve güç durumu değişikliğinden etkilenmez. Normal güç politikası uygulanamaz ancak Kapatma Hazırlığı'nda, kullanıcı etkileşimi yok adlı sistem güç politikası olan özel bir güç politikası uygulanır.

AAOS güç durumu

AAOS cihazlar aşağıdaki güç durumu şemasını izler:

Şekil 1. AAOS güç durumu şeması.

Her güç durumu aşağıda açıklanmıştır:

Güç politikası nasıl tanımlanır?

Uygulamacılar, /vendor/etc/automotive/power_policy.xml içinde güç politikalarını tanımlar. Bu politikalar:

• Güç politikasını tanımlar.
• Varsayılan güç politikasını içeren ve güç durumu geçişleri gerçekleştiğinde otomatik olarak uygulanan güç politikası gruplarını tanımlar.
• Sistem gücü politikasını geçersiz kılar.

Güç politikası

Güç politikası, donanım ve yazılım bileşenlerinin beklenen güç durumlarından oluşur. AAOS, güç politikasında aşağıdaki bileşenleri destekler:

Tedarikçi firmalar, güç politikalarıyla birlikte kullanılmak üzere kendi özel güç bileşenlerini de tanımlayabilir. Özel güç bileşenlerini, güç politikalarıyla aynı XML dosyasında tanımlayın (bu örnekte gösterildiği gibi):

<customComponents>
  CUSTOM_COMPONENT_1000
  CUSTOM_COMPONENT_SPECIAL_SENSOR
  CUSTOM_COMPONENT_AUX_INPUT
</customComponents>

Güç politikası grubu

Varsayılan güç politikası, güç politikası grubunda belirtilen güç durumu geçişinde otomatik olarak uygulanır. Tedarikçiler, VHAL Bekle, Açık ve VHAL Bitmesini Bekle (Derin Uyku Girişi veya Kapatma Başlangıcı) için varsayılan güç politikasını tanımlayabilir.

Sistem güç politikaları

AAOS, kullanıcı etkileşimi yok ve askıya alma hazırlığı olmak üzere iki sistem güç politikasını destekler. Sistem güç politikası, cihaz Sessiz Mod, Garaj Modu, RAM'e Askıya Alma veya Diske Askıya Alma moduna geçtiğinde uygulanır.

Aşağıdaki tablolarda, sistem güç politikasındaki her bir bileşenin davranışı listelenmiştir. Uygulamacılar, kullanıcı etkileşimi yok sistem güç politikasında Bluetooth, NFC ve Güvenilir cihaz algılama özelliklerini geçersiz kılabilir. Üzeride yazılanlar /vendor/etc/power_policy.xml'te uygulanır.

Kullanıcı etkileşimi yok

Kullanıcı etkileşimi yok sistem güç politikasının davranışı bu tabloda tanımlanmıştır:

askıya alma hazırlığı

Askıya alma hazırlığı sistem güç politikasının davranışı bu tabloda tanımlanmıştır:

VHAL ile etkileşim

Sistem katmanında çalışan araç güç politikası daemon'ı, VHAL'den gelen istekleri dinlemek için iki mülke abone olur:

• POWER_POLICY_REQ VHAL, güç politikası kimliğini bu mülke yazar.
• POWER_POLICY_GROUP_REQ VHAL, güç politikası grup kimliğini bu mülke yazar.

Sistemdeki mevcut güç politikası, VHAL dışındaki modüller tarafından değiştirilebilir. Bu durumda, araba güç politikası daemon'ı, VHAL'de yapılan değişikliği bildirmek için CURRENT_POWER_POLICY mülkünü günceller.

Yerel süreçlerle etkileşim

Yukarıda belirtildiği gibi, araç güç politikası daemon'ı sistem katmanında çalışır ve güç politikası yönetimi açısından, çerçeve katmanında çalışan CPMS ile neredeyse aynı işlevi sağlar. Ayrıca, araç gücü politikası daemon'ının ve CPMS'nin tamamen senkronize olduğunu varsayın.

Araç güç politikası daemon'ı, HAL'ler ve diğer yerel süreçler tarafından kullanılmak üzere AIDL arayüzlerini dışa aktarır. Yeni bir güç politikası değiştirildiğinde bildirim alabilirler. Diğer bir deyişle, her birinin güç durumunu değiştirmesi gerektiğinde.

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 modülleriyle etkileşim

CarPowerManager, güç politikası yönetimini etkinleştirme yöntemleri sağlar:

• Mevcut güç politikasını alma
• Yeni bir güç politikası uygulama
• Yeni bir güç politikası grubu ayarlama

Bu yöntemleri yalnızca sistem ayrıcalıklarına sahip modüller kullanabilir. Bir güç politikası uygulandığında bilgilendirilmek isteyen modüller, CarPowerManager