AIDL untuk HAL Hardware Composer

Mulai Android 13, HAL Hardware Composer (HWC) ditentukan dalam AIDL dan versi HIDL yang berkisar dari android.hardware.graphics.composer@2.1 hingga android.hardware.graphics.composer@2.4 tidak digunakan lagi.

Halaman ini menjelaskan perbedaan antara HAL AIDL dan HIDL untuk HWC serta penerapan dan pengujian HAL AIDL.

Karena keuntungan yang ditawarkan oleh AIDL, vendor dianjurkan untuk menerapkan HAL komposer AIDL mulai Android 13, bukan versi HIDL. Lihat bagian Implementasi untuk mengetahui informasi selengkapnya.

Perbedaan antara HAL AIDL dan HIDL

HAL composer AIDL baru, yang bernama android.hardware.graphics.composer3, ditentukan dalam IComposer.aidl. HAL ini mengekspos API yang mirip dengan HIDL HAL android.hardware.graphics.composer@2.4 dengan perubahan berikut:

  • Penghapusan Fast Message Queue (FMQ) untuk mendukung perintah parcelable.

    AIDL HAL menentukan antarmuka perintah berdasarkan jenis parcelable yang diketik secara kuat, bukan perintah yang diserialkan melalui FMQ di HIDL. Hal ini menyediakan antarmuka yang stabil untuk perintah dan definisi yang lebih mudah dibaca tentang cara payload perintah ditafsirkan.

    Metode executeCommands didefinisikan dalam IComposerClient.aidl sebagai

    CommandResultPayload[] executeCommands(in DisplayCommand[] commands);

    dengan setiap perintah adalah jenis parcelable strongly typed yang ditentukan dalam DisplayCommand.aidl. Respons perintah adalah parcelable yang diketik dengan ketat yang ditentukan dalam CommandResultPayload.aidl.

  • Penghapusan IComposerClient.getClientTargetSupport karena tidak ada klien aktif untuk metode ini.

  • Representasi warna sebagai float, bukan byte, agar lebih selaras dengan stack grafis atas di Android seperti yang ditentukan dalam ASurfaceTransaction_setColor.

  • Penambahan kolom baru untuk mengontrol konten HDR.

    Di AIDL HAL, tumpukan lapisan SDR/HDR campuran mendukung peredupan yang lancar pada lapisan SDR saat lapisan HDR ditampilkan secara bersamaan di layar.

    Kolom brightness di LayerCommand memungkinkan SurfaceFlinger menentukan kecerahan per lapisan, sehingga HWC meredupkan konten lapisan dalam ruang cahaya linear, bukan ruang gamma.

    Kolom brightness di ClientTargetPropertyWithBrightness memungkinkan HWC menentukan ruang kecerahan untuk komposisi klien dan menginstruksikan RenderEngine apakah akan meredupkan lapisan SDR dalam komposisi klien.

    Kolom dimmingStage memungkinkan HWC mengonfigurasi kapan RenderEngine harus meredupkan konten. Hal ini mengakomodasi ColorModes yang ditentukan vendor, yang mungkin lebih memilih peredupan di ruang gamma, untuk memungkinkan peningkatan kontras yang ditentukan vendor dalam pipeline warna mereka.

  • Penambahan jenis komposisi baru DISPLAY_DECORATION di Composition.aidl untuk dekorasi layar.

    Beberapa perangkat memiliki hardware khusus untuk mengoptimalkan penggambaran mask alpha yang memperhalus sudut bulat dan potongan pada layar. Perangkat dengan hardware tersebut harus menerapkan IComposerClient.getDisplayDecorationSupport untuk menampilkan struktur DisplayDecorationSupport seperti yang ditentukan dalam DisplayDecorationSupport.aidl baru. Struktur ini menjelaskan enum PixelFormat dan AlphaInterpretation yang diperlukan oleh perangkat. Setelah penerapan ini, UI Sistem menandai lapisan mask alfa sebagai DISPLAY_DECORATION, jenis komposisi baru yang memanfaatkan hardware khusus.

  • Penambahan kolom expectedPresentTime baru ke DisplayCommand.aidl.

    Kolom expectedPresentTime memungkinkan SurfaceFlinger menyetel waktu presentasi yang diharapkan ke waktu saat konten saat ini harus ditampilkan di layar. Dengan fitur ini, SurfaceFlinger mengirimkan perintah present ke implementasi lebih awal, sehingga memungkinkan pipeline lebih banyak pekerjaan komposisi.

  • Penambahan API baru untuk mengontrol konfigurasi tampilan booting.

    Dengan menggunakan BOOT_DISPLAY_CONFIG, vendor dapat menentukan bahwa konfigurasi tampilan booting didukung. Metode setBootDisplayConfig, clearBootDisplayConfig, dan getPreferredBootDisplayConfig menggunakan BOOT_DISPLAY_CONFIG sebagai berikut:

    • Dengan menggunakan setBootDisplayConfig, framework memberi tahu vendor tentang konfigurasi tampilan waktu booting. Vendor harus melakukan caching dalam konfigurasi tampilan booting, dan melakukan booting dalam konfigurasi ini pada reboot berikutnya. Jika perangkat tidak dapat melakukan booting dalam konfigurasi ini, vendor harus menemukan konfigurasi yang cocok dengan resolusi dan kecepatan refresh konfigurasi ini. Jika tidak ada konfigurasi seperti itu, vendor harus menggunakan konfigurasi tampilan pilihannya.

    • Dengan menggunakan clearBootDisplayConfig, framework akan memberi tahu vendor untuk menghapus konfigurasi tampilan booting, dan melakukan booting dalam konfigurasi tampilan pilihan mereka selama mulai ulang berikutnya.

    • Dengan menggunakan getPreferredBootDisplayConfig, framework membuat kueri mode booting pilihan vendor.

    Jika konfigurasi tampilan booting tidak didukung, metode ini akan menampilkan nilai UNSUPPORTED.

  • Penambahan API baru untuk mengontrol timer tidak ada aktivitas layar.

    • Dengan menggunakan DISPLAY_IDLE_TIMER, vendor dapat menentukan bahwa timer tidak aktif diterapkan oleh vendor untuk tampilan ini. Saat tidak ada aktivitas, kemampuan ini mengubah kecepatan refresh ke setelan yang lebih rendah untuk menghemat daya. Platform ini menggunakan setIdleTimerEnabled untuk mengontrol waktu tunggu timer, dan dalam beberapa kasus, untuk menonaktifkannya agar mencegah peralihan kecepatan refresh yang tidak diinginkan saat tidak ada aktivitas.

    • Menggunakan callback IComposerCallback.onVsyncIdle menunjukkan kepada platform bahwa layar tidak ada aktivitas dan irama vsync telah berubah. Platform merespons callback ini dengan mereset model vsync-nya. Tindakan ini akan memaksa sinkronisasi ulang vsync pada frame berikutnya, dan mempelajari irama vsync baru.

Implementasi

Vendor tidak diwajibkan untuk mengimplementasikan AIDL HAL untuk Android 13. Namun, mereka dianjurkan untuk menerapkan HAL komposer AIDL, bukan versi HIDL, untuk menggunakan fungsi dan API baru.

Implementasi referensi untuk AIDL HWC HAL diimplementasikan di emulator Android.

Pengujian

Untuk menguji implementasi Anda, jalankan VtsHalGraphicsComposer3_TargetTest.