Transmisión de radio HAL

En las siguientes secciones, se describe cómo trabajar con la capa de abstracción de hardware (HAL) para hacer lo siguiente: implementar la radiodifusión.

Interfaz de HAL de transmisión de radio

La HAL de radio de transmisión proporciona estructuras de datos e interfaces a nivel de hardware para implementar la radio de transmisión, como AM/FM y DAB.

Interfaces de AIDL y HIDL 2.0

La HAL de radio de transmisión usa las interfaces que se describen en las siguientes secciones.

IPromptListener

IAnnouncementListener es la interfaz de devolución de llamada para el objeto de escucha de anuncios, que pueden registrarse en la HAL de la transmisión de radio para recibir anuncios. La interfaz tiene lo siguiente métodos:

ICloseHandle

ICloseHandle es el controlador de cierre genérico que permite quitar una devolución de llamada que no necesita un elemento. interfaz activa.

ITunerCallback

ITunerCallback es la interfaz de devolución de llamada a la que llama la HAL de radio de transmisión para enviar actualizaciones al servicio de cliente HAL.

iBroadcastRadio

IBroadcastRadio es la interfaz principal para la HAL de radio de transmisión. En el HIDL 2.0 HAL, usa la interfaz ITunerSession para el sintonizador a fin de llamar a operaciones. Sin embargo, en la mayoría de un sintonizador está activo a la vez (siempre que cada instancia de HAL de radio de transmisión solo tenga un sintonizador ). Se quitó ITunerSession de las interfaces del AIDL y se movieron sus interfaces a IBroadcastRadio

Aclaraciones sobre la interfaz

Comportamiento asíncrono

Dado que cada operación de ajuste (por ejemplo, ajuste, análisis (en HIDL) o búsqueda (en AIDL) y paso) puede puede consumir mucho tiempo y el subproceso no debe bloquearse por mucho tiempo, la operación debe programar operaciones que requieren mucho tiempo para que ocurran más tarde y que devuelvan rápidamente un estado o resultado. En detalle, cada operación debe:

• Cancela todas las operaciones de ajuste pendientes.
• Comprueba si la operación se puede procesar según las entradas del método y el estado de la decodificador.
• Programa la tarea de ajuste y, luego, muestra Result (en HIDL). status (en AIDL) de inmediato. Si Result o status es OK, la devolución de llamada del sintonizador Se debe llamar a tuneFailed o currentProgramInfoChanged cuando el ajuste la tarea falló (por ejemplo, debido a un tiempo de espera) o se completó.

Del mismo modo, startProgramListUpdates también programa la lenta tarea de actualizar la lista de programas para que se lleve a cabo más tarde y para devolver rápidamente un estado o un resultado. El método primero cancela las solicitudes de actualización pendientes y, luego, programa la tarea de actualización y devuelve resultado.

Condición de carrera

Debido al comportamiento asíncrono de las operaciones de ajuste (por ejemplo, ajuste, análisis (en HIDL) o búsqueda (en AIDL) y el paso), existe una condición de carrera entre la cancelación de la operación y el ajuste las operaciones. Si se llama a cancel después de que la HAL completa una operación de ajuste y antes de se completa la devolución de llamada, se puede ignorar la cancelación, y esta debe completarse y recibirse por el cliente HAL.

De manera similar, si se llama a stopProgramListUpdates después de que la HAL completa un programa actualización de la lista y antes de que se complete la devolución de llamada onCurrentProgramInfoChanged, stopProgramListUpdates se puede ignorar, y la devolución de llamada debería completarse.

Límite de tamaño de los datos

Como hay un límite estricto en el búfer de transacciones de Binder, el límite de datos para algunas interfaces los métodos que pasan datos de un tamaño potencialmente grande se aclaran en la HAL del AIDL

• getImage requiere que la imagen se muestre de menos de 1 MB.
• onProgramListUpdate requiere que cada chunk sea inferior a 500 kiB. La implementación de HAL debe dividir las listas de programas más grandes en varios fragmentos y enviarlas múltiples devoluciones de llamada.

Cambios en las estructuras de datos de la HAL del AIDL

Además de los cambios en las interfaces, estos cambios se aplicaron a las estructuras de datos definido en la HAL del AIDL de la radio de transmisión, que aprovecha el AIDL.

• Se quita la enumeración Constant del AIDL y se define como const int en IBroadcastRadio Mientras tanto, se cambia el nombre de ANTENNA_DISCONNECTED_TIMEOUT_MS a ANTENNA_STATE_CHANGE_TIMEOUT_MS. Un nuevo valor constante TUNER_TIMEOUT_MS es agregado. Todas las operaciones de ajuste, búsqueda y paso deben completarse dentro de este tiempo.
• Se quitaron del AIDL las enumeraciones RDS y Deemphasis, y se definieron como int int. en AmFmRegionConfig. En consecuencia, fmDeemphasis y Las fmRds en ProgramInfo se declaran como int, un resultado de cálculo de bits de las marcas respectivas. Mientras tanto, se cambiaron los nombres de D50 y D75 a DEEMPHASIS_D50 y DEEMPHASIS_D75, respectivamente.
• Se quitan del AIDL las enumeraciones ProgramInfoFlags y se definen como int int en Se agregó ProgramInfo con un prefijo FLAG_. En consecuencia, infoFlags en ProgramInfo se declara como int, un resultado de cálculo de bits. de marcas. También se cambió el nombre de TUNED por FLAG_TUNABLE para describirlo mejor. la definición de que se puede sintonizar la estación.
• En AmFmBandRange, se cambia el nombre de scanSpacing a seekSpacing, ya que se cambió el nombre de scan a seek en el AIDL.
• Dado que el concepto de unión se introduce en el AIDL, MetadataKey y Los Metadata definidos en la HAL de HIDL ya no se usan. Una unión del AIDL Metadata se define en la HAL del AIDL. Cada valor de enumeración que antes se encontraba en MetadataKey ahora es un campo en Metadata con tipo de cadena o int, según sus definiciones.