Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

Kebijakan daya
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Untuk memastikan bahwa komponen hardware dan software (seperti interaksi layar, audio, dan suara) diaktifkan dan dinonaktifkan secara selektif sesuai kebutuhan, AAOS menyediakan kebijakan daya, yang terdiri dari serangkaian status daya aktif dan nonaktif yang diharapkan untuk komponen hardware dan software. VHAL, atau layanan vendor dengan hak istimewa sistem, dapat menerapkan kebijakan daya baru saat status daya Android bertransisi atau saat kondisi yang ditunggu terpenuhi.

Penerapan kebijakan daya diizinkan dalam status Tunggu VHAL dan Aktif (terkadang dengan beberapa batasan). Dalam Persiapan Penonaktifan, Mode Garasi sedang berjalan dan tidak boleh terganggu oleh perubahan status daya. Meskipun kebijakan daya reguler tidak dapat diterapkan, kebijakan daya khusus, yang merupakan kebijakan daya sistem bernama tidak ada interaksi pengguna, diterapkan di Persiapan Penonaktifan.

Status daya AAOS

Perangkat AAOS mengikuti diagram status daya ini:

Diagram status daya AAOS

Gambar 1. Diagram status daya AAOS.

Setiap status daya dijelaskan di bawah:

Nilai	Deskripsi
Nonaktif	Tidak ada daya yang disediakan secara fisik ke prosesor aplikasi (AP), memori, dan periferal.
Menunggu VHAL	Saat pengemudi berinteraksi dengan kendaraan (misalnya, dengan membuka pintu), VMCU akan menyalurkan daya ke AP, memori, dan periferal. AAOS bertransisi dari salah satu dari tiga status (Nonaktif, Suspend-to-RAM (STR, Tunggu VHAL selesai)), lalu memasuki Tunggu VHAL, tempatnya menunggu koordinasi dengan VHAL.
Aktif	VHAL memerintahkan AAOS untuk memasuki status Aktif. Dalam status ini, AAOS berjalan sepenuhnya dan berinteraksi dengan driver. Layar dikontrol oleh kebijakan daya, bukan oleh panggilan Aktif/Nonaktif layar Android untuk faktor bentuk lainnya.
Persiapan shutdown	Saat pengemudi berhenti mengemudi, VHAL akan menginstruksikan AAOS untuk memasuki Persiapan Penonaktifan. Dalam status ini, layar dan audio nonaktif dan AAOS tidak berinteraksi dengan pengemudi. Sistem Android masih berjalan dan dapat mengupdate aplikasi serta sistem Android. Saat update (jika ada) selesai, sistem Android akan memasuki Tunggu VHAL Selesai.
Tunggu hingga VHAL selesai	AAOS memberi tahu VHAL bahwa VHAL dapat dimatikan. Unit Pengontrol Mikro Kendaraan (VMCU) diharapkan menempatkan System-on-Chip (SoC) ke dalam Deep Sleep dan untuk mencabut daya dari AP. AAOS kemudian berada dalam status STR, meskipun tidak ada kode yang dieksekusi. Jika VHAL tidak selesai dan driver kembali, head unit (HU) harus bertransisi langsung ke Tunggu VHAL.
Suspend-to-RAM (STR)	Kendaraan dan AP nonaktif, tidak ada kode yang dieksekusi, dan daya dipertahankan ke RAM AP.
Suspend-to-disk (STD)	Kendaraan dan AP nonaktif, tidak ada kode yang dieksekusi, dan tidak ada daya yang dipertahankan ke unit pemrosesan dan RAM AP.

Bagaimana kebijakan daya ditentukan?

Implementator menentukan kebijakan daya di /vendor/etc/automotive/power_policy.xml, yang:

Menentukan kebijakan daya.
Menentukan grup kebijakan daya, yang mencakup kebijakan daya default dan diterapkan secara otomatis saat transisi status daya terjadi.
Mengganti kebijakan daya sistem.

Kebijakan daya

Kebijakan daya terdiri dari serangkaian status daya yang diharapkan dari komponen hardware dan software. AAOS mendukung komponen berikut dalam kebijakan daya:

AUDIO
MEDIA
DISPLAY
BLUETOOTH

WIFI
SELULER
ETHERNET
PROYEKSI

NFC
INPUT
VOICE_INTERACTION
VISUAL_INTERACTION

TRUSTED_DEVICE_DETECTION
LOCATION
MICROPHONE
CPU

Vendor juga dapat menentukan komponen daya kustom mereka sendiri untuk digunakan dengan kebijakan daya. Tentukan komponen daya kustom dalam file XML yang sama dengan kebijakan daya, seperti dalam contoh ini:

<customComponents>
  CUSTOM_COMPONENT_1000
  CUSTOM_COMPONENT_SPECIAL_SENSOR
  CUSTOM_COMPONENT_AUX_INPUT
</customComponents>

Grup kebijakan daya

Kebijakan daya default diterapkan secara otomatis saat transisi status daya ditentukan dalam grup kebijakan daya. Vendor dapat menentukan kebijakan daya default untuk Wait For VHAL, On, dan Wait for VHAL Finish (Deep Sleep Entry atau Shutdown Start).

Kebijakan daya sistem

AAOS mendukung dua kebijakan daya sistem, yaitu tanpa interaksi pengguna dan penyiapan penangguhan. Kebijakan daya sistem diterapkan saat perangkat beralih ke Mode Senyap, Mode Garasi, Mode Tidur-ke-RAM, atau Mode Tidur-ke-disk.

Tabel berikut mencantumkan perilaku setiap komponen dalam kebijakan daya sistem. Implementator dapat mengganti deteksi Bluetooth, NFC, dan Perangkat tepercaya dalam kebijakan daya sistem tanpa interaksi pengguna. Penggantian diterapkan di /vendor/etc/power_policy.xml.

tidak ada interaksi pengguna

Perilaku kebijakan daya sistem tanpa interaksi pengguna ditentukan dalam tabel ini:

Komponen	Status daya	Dapat Dikonfigurasi
Audio	Nonaktif	Tidak
Media	Nonaktif	Tidak
Tampilan	Nonaktif	Tidak
Bluetooth	Nonaktif	Ya
Wifi	Aktif	Tidak
Seluler	Aktif	Tidak
Ethernet	Aktif	Tidak
Proyeksi	Nonaktif	Tidak
NFC	Nonaktif	Ya
Input	Nonaktif	Tidak
Asisten	Nonaktif	Tidak
Interaksi pengguna	Nonaktif	Tidak
Deteksi perangkat tepercaya untuk login pengguna	Aktif	Ya
Lokasi	Nonaktif	Tidak
Mikrofon	Nonaktif	Tidak
CPU	Aktif	Tidak

persiapan penangguhan

Perilaku kebijakan daya sistem suspend prep ditentukan dalam tabel ini:

Komponen	Status daya	Dapat dikonfigurasi OEM
Audio	Nonaktif	Tidak
Media	T/A	Tidak
Tampilan	T/A	Tidak
Bluetooth	Nonaktif	Tidak
Wifi	Nonaktif	Tidak
Seluler	T/A	Tidak
Ethernet	T/A	Tidak
Proyeksi	T/A	Tidak
NFC	T/A	Tidak
Input	T/A	Tidak
Asisten	T/A	Tidak
Interaksi pengguna	T/A	Tidak
Deteksi perangkat tepercaya untuk login pengguna	T/A	Tidak
Lokasi	Nonaktif	Tidak
Mikrofon	Nonaktif	Tidak
CPU	Nonaktif	Tidak

Interaksi dengan VHAL

Daemon kebijakan daya mobil yang berjalan di lapisan sistem berlangganan dua properti untuk memproses permintaan dari VHAL:

POWER_POLICY_REQ VHAL menulis ID kebijakan daya ke properti ini.
POWER_POLICY_GROUP_REQ VHAL menulis ID grup kebijakan daya ke properti ini.

Kebijakan daya saat ini di sistem dapat diubah oleh modul selain VHAL. Dalam hal ini, daemon kebijakan daya mobil akan memperbarui properti CURRENT_POWER_POLICY untuk memberi tahu perubahan pada VHAL.

Interaksi dengan proses native

Seperti yang disebutkan di atas, daemon kebijakan daya mobil berjalan di lapisan sistem dan, dalam hal pengelolaan kebijakan daya, memberikan fungsi yang hampir sama dengan CPMS yang berjalan di lapisan framework. Selain itu, asumsikan bahwa daemon kebijakan daya mobil dan CPMS disinkronkan sepenuhnya.

Daemon kebijakan daya mobil mengekspor antarmuka AIDL untuk digunakan oleh HAL dan proses native lainnya. Mereka dapat diberi tahu saat kebijakan daya baru diubah. Dengan kata lain, kapan setiap perangkat harus mengubah status daya.

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

Interaksi dengan modul Java

CarPowerManager menyediakan metode untuk mengaktifkan pengelolaan kebijakan daya:

Mendapatkan kebijakan daya saat ini
Menerapkan kebijakan daya baru
Menetapkan grup kebijakan daya baru

Hanya modul dengan hak istimewa sistem yang dapat menggunakan metode ini. Modul yang ingin diberi tahu saat kebijakan daya diterapkan dapat mendaftarkan pemroses perubahan kebijakan daya ke CarPowerManager

Kebijakan daya Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.