Cómo implementar un HAL USB

La versión de Android 8.0 traslada el manejo de los comandos USB de las secuencias de comandos de init a un daemon USB nativo para mejorar la configuración y la confiabilidad del código. Para la configuración de la función Gadget, se usan secuencias de comandos init (activadores de propiedades) para realizar operaciones específicas del dispositivo.

En versiones anteriores, estas configuraciones específicas del dispositivo se lograban a través de secuencias de comandos init específicas del dispositivo (con activadores de propiedades). Pasar a un diseño de capa de abstracción de hardware (HAL) genera una implementación mucho más limpia que resuelve estos problemas:

  1. Las operaciones, como las escrituras en los nodos sysfs del kernel, podrían fallar, pero no propagarse al código de frameworks que establece el activador de la propiedad. Como resultado, los frameworks suponen incorrectamente que las operaciones se realizaron correctamente, aunque hayan fallado de forma silenciosa.
  2. Las secuencias de comandos de init tienen una cantidad limitada de operaciones que se pueden ejecutar.

La versión de Android 12 agrega compatibilidad con la HAL de USB Gadget para los modelos de control de red (NCM) y las llamadas a la API que devuelven el número de versión de la HAL y la velocidad de USB. Para obtener más información sobre las llamadas a la API disponibles a través del HAL de USB, consulta el resumen del paquete android.hardware.usb.

HAL y Treble

Los secuencias de comandos init específicos del dispositivo se usaron como sustitutos de las capas de HAL para realizar operaciones USB específicas del dispositivo. El USB (a través de ADB) es una interfaz principal para depurar problemas del sistema. Tener un daemon nativo para realizar la configuración USB elimina la dependencia del código del framework, por lo que, incluso si el framework falla, USB debería estar en ejecución.

En el modelo Treble, que también se introdujo en Android 8.0, todas las HAL están aisladas de los servicios del sistema y deben ejecutarse en sus propios daemons nativos. Esto elimina el requisito de tener un daemon USB exclusivo, ya que la capa HAL funciona muy bien como daemon USB.

La implementación predeterminada del HAL se encarga de todos los dispositivos anteriores a Android 8.0. Por lo tanto, no habría ningún trabajo específico del dispositivo para los dispositivos anteriores a Android 8.0. Android 8.0 usa la interfaz HAL para consultar el estado de los puertos USB y realizar intercambios de roles de datos y roles de alimentación.

Implementación

La nueva interfaz de HAL de USB debe implementarse en todos los dispositivos que se lancen con Android 8.0. La implementación predeterminada debe encargarse de los dispositivos con versiones anteriores a Android 8.0. La implementación predeterminada es suficiente si el dispositivo usa la clase dual_role_usb para informar el estado del puerto USB-C. Es posible que se requieran cambios triviales en las secuencias de comandos USB específicas del dispositivo para transferir la propiedad de los nodos de type-C al sistema.