Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

AIDL для аппаратного компоновщика HAL

Начиная с Android 13, Hardware Composer (HWC) HAL определен в AIDL , а версии HIDL от android.hardware.graphics.composer@2.1 до android.hardware.graphics.composer@2.4 устарели.

На этой странице описываются различия между AIDL и HIDL HAL для HWC, а также реализация и тестирование AIDL HAL.

Из-за преимуществ, предлагаемых AIDL, поставщикам рекомендуется внедрять AIDL composer HAL, начиная с Android 13, вместо версии HIDL. Более подробную информацию см. в разделе «Внедрение» .

Различия между HAL AIDL и HIDL

Новый AIDL composer HAL, названный android.hardware.graphics.composer3 , определен в IComposer.aidl . Он предоставляет API, похожий на HIDL HAL android.hardware.graphics.composer@2.4 со следующими изменениями:

Удаление быстрой очереди сообщений (FMQ) в пользу пакетируемых команд.
AIDL HAL определяет интерфейс команд на основе строго типизированных парцеллируемых типов в отличие от сериализованных команд через FMQ в HIDL. Это обеспечивает стабильный интерфейс для команд и более читаемое определение того, как интерпретируется полезная нагрузка команды.
Метод executeCommands определен в IComposerClient.aidl как
```
CommandResultPayload[] executeCommands(in DisplayCommand[] commands);
```
где каждая команда — это строго типизированный parcelable тип, определенный в DisplayCommand.aidl . Ответы команд — это строго типизированные parcelables, определенные в CommandResultPayload.aidl .
Удаление IComposerClient.getClientTargetSupport , поскольку для этого метода нет активных клиентов.
Представление цветов в виде чисел с плавающей точкой, а не байтов, для лучшего соответствия верхнему графическому стеку Android, как определено в ASurfaceTransaction_setColor .
Добавление новых полей для управления HDR-контентом.
В AIDL HAL смешанные стеки слоев SDR/HDR поддерживают плавное затемнение слоев SDR, когда на экране одновременно отображается слой HDR.
Поле brightness в LayerCommand позволяет SurfaceFlinger указывать яркость для каждого слоя, чтобы HWC затемнял содержимое слоя в линейном световом пространстве, а не в гамма-пространстве.
Поле brightness в ClientTargetPropertyWithBrightness позволяет HWC указывать пространство яркости для клиентской композиции и указывать RenderEngine , следует ли затемнять слои SDR в клиентской композиции.
Поле dimmingStage позволяет HWC настраивать, когда RenderEngine должен затемнять контент. Это учитывает определенные поставщиком ColorModes , которые могут предпочесть затемнение в гамма-пространстве, чтобы разрешить определенные поставщиком улучшения контрастности в их цветовых конвейерах.
Добавление нового типа композиции DISPLAY_DECORATION в Composition.aidl для оформления экрана.
Некоторые устройства имеют выделенное оборудование для оптимизации отрисовки альфа-маски, которая сглаживает закругленные углы и вырезы на дисплеях. Устройства с таким оборудованием должны реализовать IComposerClient.getDisplayDecorationSupport для возврата структуры DisplayDecorationSupport , как определено в новом DisplayDecorationSupport.aidl . Эта структура описывает перечисления PixelFormat и AlphaInterpretation , требуемые устройством. После этой реализации System UI помечает слой альфа-маски как DISPLAY_DECORATION , новый тип композиции, который использует преимущества выделенного оборудования.
Добавление нового поля expectedPresentTime в DisplayCommand.aidl .
Поле expectedPresentTime позволяет SurfaceFlinger устанавливать ожидаемое настоящее время, когда текущий контент должен быть отображен на экране. С помощью этой функции SurfaceFlinger отправляет команду present реализации заранее, что позволяет ей выполнять большую часть работы по композиции.
Добавление новых API для управления конфигурацией загрузочного дисплея.
Используя BOOT_DISPLAY_CONFIG , поставщики могут указать, что поддерживается конфигурация отображения загрузки. Методы setBootDisplayConfig , clearBootDisplayConfig и getPreferredBootDisplayConfig используют BOOT_DISPLAY_CONFIG следующим образом:
- Используя setBootDisplayConfig , фреймворк информирует поставщиков о конфигурации отображения времени загрузки. Поставщики должны кэшировать конфигурацию отображения загрузки и загружаться в этой конфигурации при следующей перезагрузке. Если устройство не может загрузиться в этой конфигурации, поставщик должен найти конфигурацию, которая соответствует разрешению и частоте обновления этой конфигурации. Если такой конфигурации не существует, поставщик должен использовать предпочтительную конфигурацию отображения.
- Используя clearBootDisplayConfig , фреймворк информирует поставщиков о необходимости очистить конфигурацию загрузочного дисплея и выполнить загрузку с предпочитаемой конфигурацией дисплея во время следующей перезагрузки.
- Используя getPreferredBootDisplayConfig , фреймворк запрашивает предпочтительный режим загрузки поставщика.
Если конфигурация загрузочного дисплея не поддерживается, эти методы возвращают значение UNSUPPORTED .
Добавлены новые API для управления таймером простоя дисплея.
- Используя DISPLAY_IDLE_TIMER , поставщики могут указать, что поставщик реализует таймер бездействия для этого дисплея. В режиме ожидания эта возможность изменяет частоту обновления на более низкую настройку для экономии энергии. Платформа использует setIdleTimerEnabled для управления тайм-аутом таймера и, в некоторых случаях, для его отключения с целью предотвращения нежелательных переключений частоты обновления в режиме ожидания.
- Использование обратного вызова IComposerCallback.onVsyncIdle указывает платформе, что дисплей находится в режиме ожидания и каденция vsync изменилась. Платформа отвечает на этот обратный вызов, сбрасывая свою модель vsync . Она принудительно выполняет повторную синхронизацию vsync на следующем кадре и изучает новую каденция vsync .

Выполнение

Поставщикам не обязательно реализовывать AIDL HAL для Android 13. Однако им рекомендуется реализовать AIDL Composer HAL вместо версии HIDL, чтобы использовать новые функции и API.

Эталонная реализация AIDL HWC HAL реализована в эмуляторах Android.

Тестирование

Чтобы протестировать реализацию, запустите VtsHalGraphicsComposer3_TargetTest .