Вещание радио HAL

В следующих разделах описывается, как работать с уровнем аппаратной абстракции (HAL) для реализации радиовещания.

Радиовещательный интерфейс HAL

HAL радиовещания предоставляет структуры данных и интерфейсы на аппаратном уровне для реализации радиовещания, такого как радио AM/FM и DAB.

Интерфейсы HIDL 2.0 и AIDL

Вещательная радиостанция HAL использует интерфейсы, описанные в следующих разделах.

IОбъявлениеСлушатель

IAnnouncementListener — это интерфейс обратного вызова для прослушивателя объявлений, который можно зарегистрировать на радиовещании HAL для получения объявлений. Интерфейс имеет следующие методы:

ICloseHandle

ICloseHandle — это универсальный дескриптор закрытия для удаления обратного вызова, для которого не требуется активный интерфейс.

ITunerОбратный вызов

ITunerCallback — это интерфейс обратного вызова, вызываемый широковещательной радиостанцией HAL для отправки обновлений в клиентскую службу HAL.

IBroadcastRadio

IBroadcastRadio — это основной интерфейс для радиовещания HAL. В HAL HIDL 2.0 используйте интерфейс ITunerSession для тюнера для вызова операций. Однако одновременно активен не более одного тюнера (при условии, что каждый экземпляр HAL радиовещания имеет только один чип тюнера). ITunerSession был удален из интерфейсов AIDL, а его интерфейсы перенесены в IBroadcastRadio .

Уточнения интерфейса

Асинхронное поведение

Поскольку каждая операция настройки (например, настройка, сканирование (в HIDL) или поиск (в AIDL) и шаг) может занимать много времени, а поток не должен блокироваться на длительное время, операция должна планировать трудоемкие операции. произойти позже и быстро вернуть статус или результат. Подробно каждая операция должна:

• Отмените все ожидающие операции настройки.
• Проверьте, может ли операция быть обработана на основе входных данных метода и состояния тюнера.
• Запланируйте задачу настройки, а затем немедленно верните Result (в HIDL) или status (в AIDL). Если Result или status имеют OK , обратный вызов тюнера tuneFailed или currentProgramInfoChanged должен быть вызван, когда задача настройки не удалась (например, из-за тайм-аута) или была завершена.

Аналогично, startProgramListUpdates также планирует выполнение трудоемкой задачи по обновлению списка программ, которая будет выполнена позже и быстро вернет статус или результат. Метод сначала отменяет ожидающие запросы на обновление, а затем планирует задачу обновления и быстро возвращает результат.

Состояние гонки

Из-за асинхронного поведения операций настройки (например, настройки, сканирования (в HIDL) или поиска (в AIDL) и шага), существует состояние гонки между отменой операции и операциями настройки. Если cancel вызывается после того, как HAL завершит операцию настройки и до завершения обратного вызова, отмену можно игнорировать, а обратный вызов должен завершиться и быть получен клиентом HAL.

Аналогично, если stopProgramListUpdates вызывается после того, как HAL завершит обновление списка программ и до завершения обратного вызова onCurrentProgramInfoChanged , stopProgramListUpdates можно игнорировать и обратный вызов должен завершиться.

Ограничение размера данных

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

• getImage требует, чтобы возвращаемое изображение имело размер менее 1 МБ.
• onProgramListUpdate требует, чтобы каждый chunk был меньше 500 КБ. Более крупные списки программ должны быть разделены реализацией HAL на несколько частей и отправлены через несколько обратных вызовов.

Изменения в структурах данных AIDL HAL

Помимо изменений в интерфейсах, эти изменения были применены к структурам данных, определенным в AIDL HAL вещания, который использует преимущества AIDL.

• Перечисление Constant удалено в AIDL и определено как const int в IBroadcastRadio . При этом ANTENNA_DISCONNECTED_TIMEOUT_MS переименовывается в ANTENNA_STATE_CHANGE_TIMEOUT_MS . Добавлена ​​новая константа int TUNER_TIMEOUT_MS . Все операции настройки, поиска и пошагового выполнения должны быть завершены в течение этого времени.
• Enum RDS и Deemphasis удалены в AIDL и определены как const int в AmFmRegionConfig . Соответственно, и fmDeemphasis , и fmRds в ProgramInfo объявлены как int, результат вычисления битов соответствующих флагов. При этом D50 и D75 переименованы в DEEMPHASIS_D50 и DEEMPHASIS_D75 соответственно.
• Enum ProgramInfoFlags удалены в AIDL и определены как const int в ProgramInfo с добавленным префиксом FLAG_ . Соответственно, infoFlags в ProgramInfo объявляется как int, битовый результат вычисления флагов. TUNED также переименован в FLAG_TUNABLE , чтобы лучше описать определение, на которое можно настроить станцию.
• В AmFmBandRange scanSpacing переименован в seekSpacing , поскольку в AIDL scan переименован в seek .
• Поскольку в AIDL введена концепция объединения , MetadataKey и Metadata , определенные в HIDL HAL, больше не используются. Metadata объединения AIDL определены в AIDL HAL. Каждое значение перечисления, ранее входившее в MetadataKey , теперь является полем в Metadata с типом string или int, в зависимости от их определения.