Questi test possono essere utilizzati per convalidare la funzionalità MIDI sui dispositivi Android. L'esecuzione corretta di questi test è un prerequisito per richiedere la funzionalità MIDI.
Preparazione
Hardware
Per i test è necessario il seguente hardware.
- Tastiera MIDI con connettore USB
- Tastiera MIDI con supporto Bluetooth Low Energy (BLE)
- Cavi USB
- Adattatore USB On-The-Go (OTG) per convertire una porta USB-A femmina in una porta micro-USB o USB-C maschio
- Dispositivo Android con Android 6.0 Marshmallow o versioni successive
- (Facoltativo) computer desktop
Diverse tastiere MIDI supportano sia USB che BLE-MIDI, quindi puoi eseguire i test con una sola tastiera. Esempi sono il Akai LPK25 Wireless e il Korg Microkey Air.
App
Questa procedura di test utilizza diverse app. Le app sono disponibili in codice sorgente nel progetto GitHub android-midisuite, e tramite Google Play™ ai link riportati nella tabella seguente.
| Codice sorgente | Google Play™ | Descrizione |
|---|---|---|
| MidiScope o MidiScope | Ambito MIDI | Visualizza i messaggi MIDI sullo schermo |
| MidiKeyboard | Tastiera MIDI | invia messaggi MIDI premendo una tastiera musicale sullo schermo |
| MidiSynthExample o
MidiSynth |
MIDI Synth Ex | un semplice sintetizzatore MIDI che utilizza oscillatori a dente di sega |
| MidiBtlePairing | MIDI BLE Connect | accoppia un dispositivo Android con una periferica BLE |
| MidiTools | dipendenza della libreria delle app sopra indicate |
Se scegli di lavorare dal codice sorgente anziché installare tramite Google Play™, innanzitutto compila l'app utilizzando il file Android.mk fornito. Poi installa l'app utilizzando Android Debug Bridge (ADB). Ad esempio, per installare l'app MidiScope:
- Utilizza una workstation con ADB installato.
- Collega un cavo USB dalla workstation al dispositivo Android.
- Potresti dover consentire la connessione USB sul dispositivo Android; vedi Modalità periferica USB
- Nella workstation, inserisci:
cd THIS_FOLDERadb install -r MidiScope.apk
Test di synth virtuali
Tieni presente che una porta di ingresso MIDI può avere una sola connessione. Pertanto, se un'altra app utilizza già una porta di input, questa non sarà disponibile. Se non riesci a connetterti a una porta di input, prova a chiudere altre app.
Hardware necessario: dispositivo Android di cui è in corso il test
Connessione semplice
App necessarie: MidiKeyboard, MidiSynthExample
Vengono testati l'enumerazione dei dispositivi, i dispositivi virtuali, le connessioni delle porte e l'invio di messaggi.
- Regola il volume del dispositivo Android a circa metà.
- Orienta lo smartphone in modalità Orizzontale.
- Avvia l'app MidiKeyboard.
- Seleziona SynthExample dal menu del selettore.
- Riproduci le chiavi. Dovresti sentire le note riprodotte nell'app SynthExample.
- Esci dall'applicazione premendo il pulsante Indietro in modo che la porta venga chiusa.
Test USB: modalità host
Hardware necessario: tastiera MIDI USB, cavo USB, adattatore OTG
Ripeti questi test più volte. Abbiamo notato un arresto anomalo dello stack USB su alcuni dispositivi di prototipazione se questi sono stati collegati e scollegati alcune volte.
Tastiera già collegata
App necessarie: MidiSynthExample o MidiScope
Viene testato il MIDI USB in modalità host.
- Regola il volume del dispositivo Android a circa metà.
- Collega la tastiera USB utilizzando l'adattatore OTG.
- Avvia l'app SynthExample o l'app MidiScope.
- Dal menu, seleziona la tastiera USB. Verrà visualizzato il brand.
- Riproduci le note sulla tastiera. Se hai eseguito SynthExample, dovresti sentire le note riprodotte sullo smartphone. Se hai eseguito MidiScope, dovresti vedere i messaggi NoteOn e NoteOff sullo schermo.
- Scollega la tastiera. Nel menu Mittente per Synth dovrebbe essere visualizzato - - - - -.
- Esci dall'applicazione premendo il pulsante Indietro.
Tastiera USB con hot-plug
App necessarie: MidiSynthExample o MidiScope
Viene testato il MIDI USB in modalità host.
- Regola il volume del dispositivo Android a circa metà.
- Assicurati che non sia collegata una tastiera MIDI USB.
- Avvia l'app SynthExample.
- Al centro, accanto a Mittente per Synth, cerca nel menu. La tastiera USB non dovrebbe essere elencata.
- Collega la tastiera USB utilizzando l'adattatore OTG.
- Al centro, accanto a Mittente per synth, seleziona la tastiera USB. Verrà visualizzato il marchio.
- Riproduci le note sulla tastiera. Dovresti sentire le note riprodotte sullo smartphone.
- Al centro, accanto a Mittente per Synth, seleziona - - - - -.
- Riproduci le note sulla tastiera. Non dovresti sentire nulla.
- Al centro, accanto a Mittente per synth, seleziona la tastiera USB. Verrà visualizzato il marchio.
- Riproduci le note sulla tastiera. Dovresti sentire le note riprodotte sullo smartphone.
- Scollega il sintetizzatore. Nel menu Mittente per Synth dovrebbe essere visualizzato - - - - -.
- Esci dall'applicazione premendo il pulsante Indietro.
Test USB: modalità periferica
Hardware necessario: cavo USB, adattatore OTG
Da Android ad Android
App necessarie: MidiKeyboard sul dispositivo Android in test, MidiScope su un altro dispositivo Android.
Utilizzare i dispositivi Android come controller periferico per un altro dispositivo Android. Per contribuire a testare questa modalità, utilizza un altro dispositivo Android in modalità host. Tieni presente che puoi modificare il test in modo che funzioni con un computer desktop su cui è in esecuzione un software Digital Audio Workstation (DAW) come GarageBand.
- Collega il cavo USB al dispositivo Android in test (dispositivo Android A).
- Utilizza un adattatore OTG per collegare l'altra estremità del cavo a un secondo dispositivo Android B che funzioni in modalità host.
- Sul dispositivo Android A:
- Trascina il dito verso il basso dalla parte superiore dello schermo.
- Seleziona l'icona USB per la ricarica.
- Seleziona MIDI.
- Avvia l'app MidiKeyboard.
- Seleziona Porta periferica USB Android dal menu Ricevitore per chiavi in alto.
- Sul dispositivo Android B:
- Avvia l'app MidiScope.
- Seleziona l'altro dispositivo Android come origine.
- Sul dispositivo Android A:
- Riproduci le note sulla tastiera e cerca NoteOn e NoteOff sul dispositivo Android B.
Test BLE
Hardware necessario: tastiera MIDI che supporta BLE
Accoppiamento e riproduzione di base
App necessarie: MidiBtlePairing, MidiSynthExample
Prova una tastiera collegata ad Android tramite BLE.
- Riavvia il dispositivo Android.
- Accendi la tastiera BLE.
(la tastiera Miselu C.24 si accende premendo il pulsante vicino alla parte posteriore in modo che si apra. Il pulsante di accensione del C.24 lampeggia in blu in modalità di accoppiamento. - Avvia l'app MidiBtlePairing, che ha un'icona MIDI+BTLE.
- Premi il pulsante Scansione Bluetooth.
- Seleziona la periferica BLE che ti interessa.
- L'app dovrebbe tornare alla pagina principale e dovresti vedere la periferica elencata. Se utilizzi un C.24, noterai che la spia dovrebbe diventare verde sul C.24 per indicare la modalità accoppiata.
- Esci dall'app premendo il pulsante Home, non il pulsante Indietro.
- Avvia l'app SynthExample.
- Seleziona la tastiera BLE come mittente dal menu.
- Dovresti riuscire a premere i tasti sulla tastiera BLE e sentire le note su Android.