MIDI

La interfaz digital para instrumentos musicales (MIDI) es un protocolo estándar para interconectar computadoras con instrumentos musicales, iluminación de escenario y otros medios orientados al tiempo.

A partir de Android 13, se admite MIDI 2.0 en el transporte USB. MIDI 2.0 es un estándar MIDI más reciente que se definió en 2020. Este protocolo agrega funciones como la comunicación bidireccional, una resolución más alta y el intercambio de propiedades. MIDI 2.0 a través del modo host USB siempre está habilitado cuando la compatibilidad con MIDI está habilitada en la plataforma.

Estrictamente hablando, MIDI no está relacionado con el audio. Sin embargo, como MIDI se usa comúnmente con música, este artículo se encuentra en la sección de audio.

MIDI para NDK

Con Android 10, es más fácil portar apps de audio profesionales con MIDI en la plataforma de Android.

AMidi es una API de NDK que proporciona a los desarrolladores de apps la capacidad de enviar y recibir datos MIDI con código C/C++.

Por lo general, las apps MIDI de Android usan la API de midi para comunicarse con el servicio MIDI de Android. Las apps MIDI dependen principalmente de la clase MidiManager para descubrir, abrir y cerrar uno o más objetos MidiDevice, y pasar datos hacia y desde cada dispositivo a través de los puertos de entrada y salida MIDI del dispositivo.

Transportes

La capa de transporte física especificada en el MIDI 1.0 original es un bucle de corriente con conector DIN de 5 pines.

Desde MIDI 1.0, se definieron transportes adicionales, incluidos MIDI a través de USB y MIDI a través de Bluetooth de bajo consumo (BLE).

MIDI para Android

Android admite USB On-The-Go, que permite que un dispositivo Android actúe como host USB para controlar periféricos USB. Las APIs del modo host USB permiten a los desarrolladores implementar MIDI a través de USB a nivel de la aplicación, pero hasta hace poco no había APIs de plataforma integradas para MIDI.

A partir de la versión de Android 6.0 (Marshmallow), los fabricantes de dispositivos pueden habilitar la compatibilidad opcional con MIDI en la plataforma. Android admite directamente los transportes USB, BLE y virtuales (entre apps). Android admite MIDI 1.0 a través de un adaptador externo.

Para obtener detalles sobre la programación de aplicaciones con las APIs de MIDI, consulta el paquete android.media.midi.

En el resto de este artículo, se explica cómo un fabricante de dispositivos Android puede habilitar la compatibilidad con MIDI en la plataforma.

Habilita los transportes MIDI 1.0

La implementación de MIDI 1.0 depende de ALSA para los transportes de modo host USB y modo periférico USB. ALSA no se usa para BLE ni para los transportes virtuales.

Modo de host USB

Para habilitar MIDI para el modo host USB, primero admite el modo host USB en general y, luego, habilita CONFIG_SND_RAWMIDI y CONFIG_SND_USB_MIDI en la configuración del kernel.

El transporte MIDI a través de USB se define formalmente según el estándar Definición de clase de dispositivo de bus universal en serie para dispositivos MIDI, versión 1.0, 1 de noviembre de 1999 publicado por USB Implementers Forum, Inc.

Modo periférico USB

Para habilitar MIDI para el modo periférico USB, es posible que debas aplicar parches al kernel de Linux para integrar drivers/usb/gadget/f_midi.c en el controlador de dispositivos USB. Estos parches están disponibles para la versión 3.10 del kernel de Linux. Estos parches aún no se actualizaron para ConfigFs (una nueva arquitectura para los controladores de dispositivos USB) ni se fusionaron en kernel.org upstream.

Los parches se muestran en orden de confirmación para el árbol del kernel en la rama android-3.10 del proyecto kernel/common:

  1. https://android-review.googlesource.com/#/c/127450/
  2. https://android-review.googlesource.com/#/c/127452/
  3. https://android-review.googlesource.com/#/c/143714/

También debes realizar una de las siguientes acciones:

  • Ve a Configuración > Opciones para desarrolladores > Red y marca la casilla de MIDI en el diálogo Seleccionar configuración de USB.
  • Mientras está conectado al host USB, tira hacia abajo desde la parte superior de la pantalla, selecciona la entrada USB para y, luego, MIDI.

BLE

MIDI sobre BLE siempre está habilitado, siempre y cuando el dispositivo admita BLE.

Virtual (entre apps)

El transporte virtual (entre apps) siempre está habilitado.

Cómo reclamar la función

Las apps pueden detectar la presencia de compatibilidad con MIDI con la función android.software.midi.

Para reclamar la compatibilidad con MIDI, agrega esta línea a tu device.mk:

PRODUCT_COPY_FILES += \
frameworks/native/data/etc/android.software.midi.xml:system/etc/permissions/android.software.
midi.xml

Consulta el Documento de definición de compatibilidad de Android (CDD) para obtener información sobre los requisitos para reclamar la función.

Cómo depurar en modo host

Mientras el dispositivo está en modo de host USB, la depuración de Android Debug Bridge (adb) por USB no está disponible. Consulta la sección Uso inalámbrico de Android Debug Bridge para obtener una alternativa.