Procedimiento de prueba MIDI

Estas pruebas se pueden usar para validar la función MIDI en dispositivos Android. La ejecución correcta de estas pruebas es un requisito para reclamar la función MIDI.

Preparación

Hardware

Para las pruebas, se necesita el siguiente hardware.

  • Teclado MIDI con conector USB
  • Teclado MIDI compatible con Bluetooth de bajo consumo (BLE)
  • Cables USB
  • Adaptador USB On-The-Go (OTG) para convertir un USB-A hembra en micro-USB o USB-C macho
  • Dispositivo Android con Android 6.0 Marshmallow o versiones posteriores
  • Opcional: computadora de escritorio

Varios teclados MIDI admiten USB y BLE-MIDI, por lo que puedes realizar las pruebas con un solo teclado. Algunos ejemplos son el Akai LPK25 Wireless y el Korg Microkey Air.

Apps

Este procedimiento de prueba usa varias apps. Las apps están disponibles en código fuente en el proyecto de GitHub android-midisuite y a través de Google Play™ en los vínculos de la siguiente tabla.

Código fuente Google Play™ Descripción
MidiScope o MidiScope MIDI Scope Muestra mensajes MIDI en pantalla.
MidiKeyboard Teclado MIDI envía mensajes MIDI presionando un teclado musical en pantalla
MidiSynthExample o
MidiSynth		 Ejemplo de sintetizador MIDI sintetizador MIDI simple que usa osciladores de sierra
MidiBtlePairing MIDI BLE Connect Vincula un dispositivo Android con un periférico BLE.
MidiTools dependencia de la biblioteca de las apps anteriores

Si decides trabajar desde el código fuente en lugar de instalarlo a través de Google Play™, primero compila la app con el Android.mk proporcionado. Luego, instala la app con Android Debug Bridge (ADB). Por ejemplo, para instalar la app de MidiScope, haz lo siguiente:

  1. Usa una estación de trabajo con ADB instalado.
  2. Conecta un cable USB de la estación de trabajo al dispositivo Android.
  3. Es posible que debas permitir la conexión USB en el dispositivo Android. Consulta Modo periférico USB.
  4. En la estación de trabajo, ingresa lo siguiente:
cd THIS_FOLDER
adb install -r MidiScope.apk

Pruebas de sintetizador virtual

Ten en cuenta que un puerto de entrada MIDI solo puede tener una conexión. Por lo tanto, si otra app ya está usando un puerto de entrada, ese puerto no estará disponible. Si no puedes conectarte a un puerto de entrada, intenta cerrar otras apps.

Hardware necesario: Dispositivo Android en prueba

Conexión simple

Apps necesarias: MidiKeyboard y MidiSynthExample

Esta prueba verifica la enumeración de dispositivos, los dispositivos virtuales, las conexiones de puertos y el envío de mensajes.

  1. Ajusta el volumen del dispositivo Android a la mitad.
  2. Orienta el teléfono en modo horizontal.
  3. Inicia la app MidiKeyboard.
  4. Selecciona SynthExample en el menú del selector.
  5. Teclas de reproducción Deberías escuchar notas que se reproducen en la app de SynthExample.
  6. Para salir de la aplicación, presiona el botón Atrás para que se cierre el puerto.

Prueba de USB: modo host

Hardware necesario: Teclado MIDI USB, cable USB y adaptador OTG

Repite estas pruebas varias veces. Notamos que la pila USB fallaba en algunos dispositivos prototipo si se conectaban y desconectaban varias veces.

El teclado ya está conectado

Apps necesarias: MidiSynthExample o MidiScope

Esta prueba USB MIDI en modo host.

  1. Ajusta el volumen del dispositivo Android a la mitad.
  2. Conecta el teclado USB con el adaptador OTG.
  3. Inicia la app de SynthExample o la de MidiScope.
  4. En el menú, selecciona el teclado USB. Se mostrará la marca.
  5. Toca notas en el teclado. Si ejecutaste SynthExample, deberías escuchar las notas que se reproducen en el teléfono. Si ejecutaste MidiScope, deberías ver los mensajes NoteOn y NoteOff en la pantalla.
  6. Desconecta el teclado. El menú Receptor de Synth debería mostrar - - - - -.
  7. Para salir de la aplicación, presiona el botón Atrás.

Teclado USB con conexión en caliente

Apps necesarias: MidiSynthExample o MidiScope

Esta prueba USB MIDI en modo host.

  1. Ajusta el volumen del dispositivo Android a la mitad.
  2. Asegúrate de que no haya un teclado MIDI USB conectado.
  3. Inicia la app SynthExample.
  4. En el medio, junto a Receptor para Synth, busca en el menú. No deberías ver el teclado USB en la lista.
  5. Conecta el teclado USB con el adaptador OTG.
  6. En el medio, junto a Sender for Synth, selecciona el teclado USB. Se mostrará la marca.
  7. Toca notas en el teclado. Deberías escuchar las notas que se reproducen en el teléfono.
  8. En el medio, junto a Sender for Synth, selecciona - - - - -.
  9. Toca notas en el teclado. No deberías escuchar nada.
  10. En el medio, junto a Sender for Synth, selecciona el teclado USB. Se mostrará la marca.
  11. Toca notas en el teclado. Deberías escuchar las notas que se reproducen en el teléfono.
  12. Desconecta el sintetizador. El menú Receptor de Synth debería mostrar - - - - -.
  13. Para salir de la aplicación, presiona el botón Atrás.

Prueba de USB: modo periférico

Hardware necesario: cable USB, adaptador OTG

De Android a Android

Apps necesarias: MidiKeyboard en el dispositivo Android en prueba, MidiScope en otro dispositivo Android.

Usar dispositivos Android como controladores de periféricos para otro dispositivo Android Para probar este modo, usa otro dispositivo Android que se ejecute en modo host. Ten en cuenta que puedes modificar la prueba para que funcione con una computadora de escritorio que ejecute software de estación de trabajo de audio digital (DAW), como GarageBand.

  1. Conecta el cable USB al dispositivo Android en prueba (dispositivo Android A).
  2. Usa un adaptador OTG para conectar el otro extremo del cable a un segundo dispositivo Android B que funcione en modo host.
  3. En el dispositivo Android A:
    1. Arrastra el dedo hacia abajo desde la parte superior de la pantalla.
    2. Selecciona el ícono USB para cargar.
    3. Selecciona MIDI.
    4. Inicia la app MidiKeyboard.
    5. Selecciona Puerto periférico USB de Android en el menú Receptor de llaves en la parte superior.
  4. En el dispositivo Android B:
    1. Inicia la app de MidiScope.
    2. Selecciona el otro dispositivo Android como fuente.
  5. En el dispositivo Android A:
    1. Toca notas en el teclado y busca NoteOn y NoteOff en el dispositivo Android B.

Prueba de BLE

Hardware necesario: Teclado MIDI compatible con BLE

Vinculación y reproducción básicas

Apps necesarias: MidiBtlePairing, MidiSynthExample

Prueba un teclado conectado a Android a través de BLE.

  1. Reinicia el dispositivo Android.
  2. Enciende el teclado BLE.
    (Para encender el teclado Miselu C.24, presiona el botón cerca de la parte posterior para que se abra. El botón de encendido del C.24 parpadea en azul cuando está en modo de vinculación).
  3. Inicia la app MidiBtlePairing. Tiene un ícono MIDI+BTLE.
  4. Presiona el botón Búsqueda de Bluetooth.
  5. Selecciona el periférico BLE que desees.
  6. La app debería regresar a la página principal y deberías ver el periférico en la lista. Si usas un C.24, notarás que la luz debería volverse verde en el C.24 para indicar el modo vinculado.
  7. Para salir de la app, presiona el botón Inicio, no el botón Atrás.
  8. Inicia la app de SynthExample.
  9. Selecciona el teclado BLE como remitente en el menú.
  10. Deberías poder presionar teclas en el teclado BLE y escuchar notas en Android.