Procedimento de teste MIDI

Esses testes podem ser usados ​​para validar o recurso MIDI em dispositivos Android. A execução bem-sucedida desses testes é um pré-requisito para reivindicar o recurso MIDI .

Preparação

Hardware

O seguinte hardware é necessário para os testes.

  • Teclado MIDI com conector USB
  • Teclado MIDI com suporte a Bluetooth Low Energy (BLE)
  • cabos USB
  • Adaptador USB On-The-Go (OTG) para converter um USB-A fêmea em micro-USB ou USB-C macho
  • Dispositivo Android com Android 6.0 Marshmallow ou versão posterior
  • Opcional: computador de mesa

Vários teclados MIDI suportam USB e BLE-MIDI, então você pode fazer seus testes com apenas um teclado. Exemplos são o Akai LPK25 Wireless e o Korg Microkey Air .

Aplicativos

Vários aplicativos são usados ​​por este procedimento de teste. Os aplicativos estão disponíveis em código-fonte no projeto do GitHub android-midisuite e via Google Play ™ nos links na tabela a seguir.

Código fonte Google Play™ Descrição
MidiScope ou MidiScope Escopo MIDI exibe mensagens MIDI na tela
Teclado Midi Teclado MIDI envia mensagens MIDI pressionando um teclado musical na tela
MidiSynthExample ou
MidiSynth		 Ex de sintetizador MIDI sintetizador MIDI simples que usa osciladores dente de serra
MidiBtlePairing Conexão BLE MIDI emparelha um dispositivo Android com um periférico BLE
MidiTools dependência de biblioteca dos aplicativos acima

Se você optar por trabalhar a partir do código-fonte em vez de instalar via Google Play ™, primeiro crie o aplicativo usando o Android.mk fornecido. Em seguida, instale o aplicativo usando o Android Debug Bridge (ADB). Por exemplo, para instalar o aplicativo MidiScope :

  1. Use uma estação de trabalho com o ADB instalado.
  2. Conecte um cabo USB da estação de trabalho ao dispositivo Android.
  3. Pode ser necessário permitir a conexão USB no dispositivo Android; veja modo periférico USB
  4. Na estação de trabalho, digite:
cd THIS_FOLDER
adb install -r MidiScope.apk

Testes de sintetizadores virtuais

Observe que uma porta de entrada MIDI pode ter apenas uma conexão. Portanto, se outro aplicativo já estiver usando uma porta de entrada, essa porta não estará disponível. Se você não conseguir se conectar a uma porta de entrada, tente fechar outros aplicativos.

Hardware necessário: dispositivo Android em teste

Conexão simples

Aplicativos necessários: MidiKeyboard , MidiSynthExample

Isso testa a enumeração de dispositivos, dispositivos virtuais, conexões de porta e envio de mensagens.

  1. Ajuste o volume no dispositivo Android até a metade.
  2. Oriente o telefone no modo paisagem.
  3. Inicie o aplicativo MidiKeyboard .
  4. Selecione SynthExample no menu giratório.
  5. Teclas de jogo. Você deve ouvir as notas sendo tocadas no aplicativo SynthExample .
  6. Saia do aplicativo pressionando o botão Voltar para que a porta seja fechada.

Teste USB: modo host

Hardware necessário: teclado USB MIDI, cabo USB, adaptador OTG

Repita esses testes várias vezes. Vimos a pilha USB travar com força em alguns dispositivos protótipos se os dispositivos fossem conectados e desconectados algumas vezes.

Teclado já conectado

Aplicativos necessários: MidiSynthExample ou MidiScope

Isso testa USB MIDI no modo host.

  1. Ajuste o volume no dispositivo Android até a metade.
  2. Conecte o teclado USB usando o adaptador OTG.
  3. Inicie o aplicativo SynthExample ou o aplicativo MidiScope .
  4. No menu, selecione o teclado USB. Ele exibirá a marca.
  5. Toque notas no teclado. Se você executou o SynthExample , deve ouvir as notas sendo tocadas no telefone. Se você executou o MidiScope , deverá ver as mensagens NoteOn e NoteOff na tela.
  6. Desconecte o teclado. O menu Sender for Synth deve exibir - - - - - .
  7. Saia do aplicativo pressionando o botão Voltar .

Teclado USB hot-plug

Aplicativos necessários: MidiSynthExample ou MidiScope

Isso testa USB MIDI no modo host.

  1. Ajuste o volume no dispositivo Android até a metade.
  2. Certifique-se de que não há um teclado USB MIDI conectado.
  3. Inicie o aplicativo SynthExample .
  4. No meio, ao lado de Sender for Synth , procure no menu. Você não deve ver o teclado USB listado.
  5. Conecte o teclado USB usando o adaptador OTG.
  6. No meio, ao lado de Sender for Synth , selecione o teclado USB. Ele exibirá a marca.
  7. Toque notas no teclado. Você deve ouvir notas sendo tocadas no telefone.
  8. No meio, ao lado de Sender for Synth , selecione - - - - - .
  9. Toque notas no teclado. Você não deve ouvir nada.
  10. No meio, ao lado de Sender for Synth , selecione o teclado USB. Ele exibirá a marca.
  11. Toque notas no teclado. Você deve ouvir notas sendo tocadas no telefone.
  12. Desligue o sintetizador. O menu Sender for Synth deve exibir - - - - - .
  13. Saia do aplicativo pressionando o botão Voltar .

Teste USB: modo periférico

Hardware necessário: cabo USB, adaptador OTG

Android para Android

Aplicativos necessários: MidiKeyboard no dispositivo Android em teste, MidiScope em outro dispositivo Android.

Use dispositivos Android como um controlador periférico para outro dispositivo Android. Para ajudar a testar esse modo, use outro dispositivo Android em execução no modo host. Observe que você pode modificar o teste para funcionar com um computador desktop executando o software Digital Audio Workstation (DAW), como o GarageBand.

  1. Conecte o cabo USB ao dispositivo Android em teste (dispositivo Android A ).
  2. Use um adaptador OTG para conectar a outra extremidade do cabo a um segundo dispositivo Android B que opera no modo host.
  3. No dispositivo Android A:
    1. Arraste o dedo para baixo da parte superior da tela.
    2. Selecione o ícone USB para carregamento .
    3. Selecione MIDI .
    4. Inicie o aplicativo MidiKeyboard .
    5. Selecione Android USB Peripheral Port no menu Receiver for Keys na parte superior.
  4. No dispositivo Android B:
    1. Inicie o aplicativo MidiScope .
    2. Selecione o outro dispositivo Android como a fonte.
  5. No dispositivo Android A:
    1. Toque notas no teclado e procure por NoteOn e NoteOff no dispositivo Android B.

teste BLE

Hardware necessário: teclado MIDI compatível com BLE

Emparelhamento e reprodução básicos

Aplicativos necessários: MidiBtlePairing , MidiSynthExample

Teste um teclado conectado ao Android por BLE.

  1. Reinicie o dispositivo Android.
  2. Ligue o teclado BLE.
    (O teclado Miselu C.24 é ligado pressionando o botão próximo à parte traseira para que ele se abra. O botão liga/desliga no C.24 pulsa em azul quando no modo de emparelhamento.)
  3. Inicie o aplicativo MidiBtlePairing . Tem um ícone MIDI+BTLE .
  4. Pressione o botão Bluetooth Scan .
  5. Selecione o periférico BLE desejado.
  6. O aplicativo deve retornar à página principal e você deve ver o periférico listado. Se você estiver usando um C.24, notará que a luz deve ficar verde no C.24 para indicar o modo emparelhado.
  7. Saia do aplicativo pressionando o botão Início , não o botão Voltar .
  8. Inicie o aplicativo SynthExample.
  9. Selecione o teclado BLE como remetente no menu.
  10. Você deve ser capaz de pressionar teclas no teclado BLE e ouvir notas no Android.