Создание интерфейса HAL

Вы должны использовать HIDL для описания всех флагов сборки, используемых для условной компиляции фреймворка. Соответствующие флаги сборки должны быть сгруппированы и включены в один файл .hal . Использование HIDL для указания элементов конфигурации имеет следующие преимущества:

  • Версия (чтобы добавить новые элементы конфигурации, поставщики/производители оборудования должны явно расширить HAL)
  • Хорошо задокументированы
  • Контроль доступа с помощью SELinux
  • Проверка работоспособности элементов конфигурации с помощью Vendor Test Suite (проверка диапазона, проверка взаимозависимостей между элементами и т. д.)
  • Автоматически сгенерированные API как на C++, так и на Java

Идентификация флагов сборки, используемых фреймворком

Начните с определения конфигураций сборки, используемых для условной компиляции фреймворка, а затем откажитесь от устаревших конфигураций, чтобы уменьшить набор. Например, для surfaceflinger определен следующий набор флагов сборки:

  • TARGET_USES_HWC2
  • TARGET_BOARD_PLATFORM
  • TARGET_DISABLE_TRIPLE_BUFFERING
  • TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS
  • NUM_FRAMEBUFFER_SURFACE_BUFFERS
  • TARGET_RUNNING_WITHOUT_SYNC_FRAMEWORK
  • VSYNC_EVENT_PHASE_OFFSET_NS
  • SF_VSYNC_EVENT_PHASE_OFFSET_NS
  • PRESENT_TIME_OFFSET_FROM_VSYNC_NS
  • MAX_VIRTUAL_DISPLAY_DIMENSION

Создание HAL-интерфейса

Доступ к конфигурациям сборки для подсистемы осуществляется через интерфейс HAL, а интерфейсы для предоставления значений конфигурации сгруппированы в пакете HAL android.hardware.configstore (в настоящее время в версии 1.0). Например, чтобы создать файл интерфейса HAL для surfaceflinger , в hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal :

package android.hardware.configstore@1.0;

interface ISurfaceFlingerConfigs {
    // TO-BE-FILLED-BELOW
};

После создания файла .hal запустите hardware/interfaces/update-makefiles.sh , чтобы добавить новый файл .hal в файлы Android.bp и Android.mk .

Добавление функций для флагов сборки

Для каждого флага сборки добавьте в интерфейс новую функцию. Например, в hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal :

interface ISurfaceFlingerConfigs {
    disableTripleBuffering() generates(OptionalBool ret);
    forceHwcForVirtualDisplays() generates(OptionalBool ret);
    enum NumBuffers: uint8_t {
        USE_DEFAULT = 0,
        TWO = 2,
        THREE = 3,
    };
    numFramebufferSurfaceBuffers() generates(NumBuffers ret);
    runWithoutSyncFramework() generates(OptionalBool ret);
    vsyncEventPhaseOffsetNs generates (OptionalUInt64 ret);
    presentTimeOffsetFromSyncNs generates (OptionalUInt64 ret);
    maxVirtualDisplayDimension() generates(OptionalInt32 ret);
};

При добавлении функции:

  • Будьте лаконичны с именами. Избегайте преобразования имен переменных make-файла в имена функций и помните, что TARGET_ и BOARD_ больше не нужны.
  • Добавьте комментарии. Помогите разработчикам понять назначение элемента конфигурации, как он меняет поведение платформы, допустимые значения и другую важную информацию.

Типы возвращаемых функций могут быть Optional[Bool|String|Int32|UInt32|Int64|UInt64] . Типы определяются в types.hal в том же каталоге и оборачивают примитивные значения полем, которое указывает, указано ли значение в HAL; если нет, используется значение по умолчанию.

struct OptionalString {
    bool specified;
    string value;
};

При необходимости определите перечисление, которое лучше всего представляет тип элемента конфигурации, и используйте это перечисление в качестве возвращаемого типа. В приведенном выше примере перечисление NumBuffers определено для ограничения количества допустимых значений. При определении таких пользовательских типов данных добавьте поле или значение перечисления (например, USE_DEFAULT ) для обозначения того, указано ли значение в HAL или нет.

Не обязательно, чтобы один флаг сборки стал одной функцией в HIDL. Владельцы модулей могут в качестве альтернативы объединять тесно связанные флаги сборки в структуру и иметь функцию, которая возвращает эту структуру (это может уменьшить количество вызовов функций).

Например, вариант объединения двух флагов сборки в одну структуру в hardware/interfaces/configstore/1.0/ISurfaceFlingerConfigs.hal :

 interface ISurfaceFlingerConfigs {
    // other functions here
    struct SyncConfigs {
        OptionalInt64 vsyncEventPhaseoffsetNs;
        OptionalInt64 presentTimeoffsetFromSyncNs;
    };
    getSyncConfigs() generates (SyncConfigs ret);
    // other functions here
};

Альтернативы одной функции HAL

В качестве альтернативы использованию одной функции HAL для всех флагов сборки интерфейс HAL также предоставляет простые функции, такие как getBoolean(string key) и getInteger(string key) . Фактические пары key=value хранятся в отдельных файлах, а служба HAL предоставляет значения путем чтения/анализа этих файлов.

Хотя этот подход легко определить, он не включает в себя преимущества, предоставляемые HIDL (принудительное управление версиями, простота документации, контроль доступа), и поэтому не рекомендуется.

Одиночные и множественные интерфейсы

Дизайн интерфейса HAL для элементов конфигурации предлагает два варианта:

  • Единый интерфейс, охватывающий все элементы конфигурации
  • Несколько интерфейсов, каждый из которых охватывает набор связанных элементов конфигурации

Единый интерфейс проще, но может стать неудобным в сопровождении, поскольку в один файл добавляется больше элементов конфигурации. Кроме того, управление доступом не является точным, поэтому процесс, которому предоставлен доступ к интерфейсу, может прочитать все элементы конфигурации (доступ к частичному набору элементов конфигурации не может быть предоставлен). В качестве альтернативы, если доступ не предоставлен, элементы конфигурации не могут быть прочитаны.

Из-за этих проблем Android использует несколько интерфейсов с одним интерфейсом HAL для группы связанных элементов конфигурации. Например, ISurfaceflingerConfigs для элементов конфигурации, связанных с surfaceflinger , и IBluetoothConfigs для элементов конфигурации, связанных с Bluetooth.