Prosedur pengujian MIDI

Pengujian ini dapat digunakan untuk memvalidasi fitur MIDI di perangkat Android. Keberhasilan pelaksanaan tes ini adalah prasyarat untuk mengklaim fitur MIDI.

Persiapan

Hardware

Hardware berikut diperlukan untuk pengujian.

  • Keyboard MIDI dengan konektor USB
  • Keyboard MIDI dengan dukungan Bluetooth Hemat Energi (BLE)
  • Kabel USB
  • Adaptor USB On-The-Go (OTG) untuk mengonversi USB-A perempuan menjadi USB mikro atau USB-C laki-laki
  • Perangkat Android yang menjalankan Android 6.0 Marshmallow atau versi yang lebih baru
  • Opsional: komputer desktop

Beberapa keyboard MIDI mendukung USB dan BLE-MIDI, sehingga Anda dapat melakukan pengujian dengan hanya dengan satu {i>keyboard<i}. Contohnya adalah Nirkabel Akai LPK25 dan Korg Microkey Air.

Aplikasi

Beberapa aplikasi digunakan oleh prosedur uji ini. Aplikasi ini tersedia dalam kode sumber di project GitHub android-midisuite, dan melalui Google PlayTM di link dalam tabel berikut.

Kode sumber Google PlayTM Deskripsi
MidiScope atau MidiScope Cakupan MIDI menampilkan pesan MIDI di layar
MidiKeyboard Keyboard MIDI mengirim pesan MIDI dengan menekan keyboard musik di layar
MidiSynthExample atau
MidiSynth		 Ex Synth MIDI synthesizer MIDI sederhana yang menggunakan osilator gigi gergaji
MidiBtlePairing Koneksi MIDI BLE menyambungkan perangkat Android dengan periferal BLE
MidiTools dependensi library aplikasi di atas

Jika Anda memilih untuk bekerja dari kode sumber dan bukan menginstal melalui Google PlayTM, pertama-tama bangun aplikasi menggunakan Android.mk yang disediakan. Kemudian instal aplikasi menggunakan Android Debug Bridge (ADB). Misalnya, untuk menginstal aplikasi MidiScope:

  1. Menggunakan workstation yang dilengkapi ADB.
  2. Hubungkan kabel USB dari workstation ke perangkat Android.
  3. Anda mungkin perlu mengizinkan koneksi USB di perangkat Android; lihat Mode periferal USB
  4. Di workstation, masukkan:
cd THIS_FOLDER
adb install -r MidiScope.apk

Pengujian synth virtual

Perhatikan bahwa port input MIDI hanya dapat memiliki satu koneksi. Jadi, jika aplikasi lain menggunakan porta input, porta tersebut tidak akan tersedia. Jika Anda tidak dapat terhubung ke porta input kemudian mencoba menutup aplikasi yang lain.

Hardware yang diperlukan: Perangkat Android yang sedang diuji

Koneksi sederhana

Aplikasi yang diperlukan: MidiKeyboard, MidiSynthExample

Pengujian ini menguji enumerasi perangkat, perangkat virtual, koneksi port, dan pesan dikirim.

  1. Sesuaikan volume di perangkat Android menjadi sekitar setengah.
  2. Orientasikan ponsel dalam mode lanskap.
  3. Luncurkan aplikasi MidiKeyboard.
  4. Pilih SynthExample dari menu indikator lingkaran berputar.
  5. Tombol Play. Anda akan mendengar catatan diputar di aplikasi SynthExample.
  6. Keluar dari aplikasi dengan menekan tombol Kembali sehingga port akan tutup.

Pengujian USB: mode host

Hardware yang diperlukan: Keyboard MIDI USB, kabel USB, adaptor OTG

Ulangi pengujian ini beberapa kali. Kami telah melihat tumpukan USB rusak di beberapa prototipe perangkat jika perangkat dicolokkan dan dicabut beberapa kali.

Keyboard sudah dicolokkan

Aplikasi yang diperlukan: MidiSynthExample atau MidiScope

Tindakan ini menguji MIDI USB dalam mode host.

  1. Sesuaikan volume di perangkat Android menjadi sekitar setengah.
  2. Colokkan keyboard USB menggunakan adaptor OTG.
  3. Luncurkan aplikasi SynthExample atau aplikasi MidiScope.
  4. Dari menu, pilih keyboard USB. Brand akan ditampilkan.
  5. Memutar catatan di keyboard. Jika menjalankan SynthExample, Anda akan mendengar catatan yang sedang diputar di ponsel. Jika Anda menjalankan MidiScope, maka Anda akan melihat NoteOn dan NoteOff di layar.
  6. Cabut keyboard dari sumber listrik. Menu Pengirim untuk Synth akan menampilkan - - - - -.
  7. Keluar dari aplikasi dengan menekan tombol Kembali.

Keyboard USB hot plug

Aplikasi yang diperlukan: MidiSynthExample atau MidiScope

Tindakan ini menguji MIDI USB dalam mode host.

  1. Sesuaikan volume di perangkat Android menjadi sekitar setengah.
  2. Pastikan tidak ada keyboard MIDI USB yang dicolokkan.
  3. Luncurkan aplikasi SynthExample.
  4. Di tengah, di samping Sender for Synth, lihat dalam menu. Anda tidak akan melihat USB keyboard dicantumkan.
  5. Colokkan keyboard USB menggunakan adaptor OTG.
  6. Di bagian tengah, di samping Sender for Synth, pilih keyboard USB. Halaman ini akan menampilkan merek.
  7. Memutar catatan di keyboard. Anda akan mendengar catatan diputar di ponsel.
  8. Di tengah, di samping Sender for Synth, pilih - - - - -.
  9. Memutar catatan di keyboard. Anda tidak akan mendengar apa pun.
  10. Di bagian tengah, di samping Sender for Synth, pilih keyboard USB. Halaman ini akan menampilkan merek.
  11. Memutar catatan di keyboard. Anda akan mendengar catatan diputar di ponsel.
  12. Cabut synthesizer. Menu Pengirim untuk Synth akan menampilkan - - - - -.
  13. Keluar dari aplikasi dengan menekan tombol Kembali.

Pengujian USB: mode periferal

Hardware yang diperlukan: Kabel USB, adaptor OTG

Android ke Android

Aplikasi yang diperlukan: MidiKeyboard di perangkat Android yang sedang diuji, MidiScope di perangkat lain perangkat Android.

Menggunakan perangkat Android sebagai pengontrol periferal untuk perangkat Android lainnya. Untuk membantu menguji mode ini, gunakan perangkat Android lain yang berjalan dalam mode {i>host<i}. Perlu diketahui bahwa Anda dapat memodifikasi pengujian agar berfungsi dengan komputer desktop yang menjalankan Digital Audio Workstation (DAW) perangkat lunak seperti GarageBand.

  1. Hubungkan kabel USB ke perangkat Android yang sedang diuji (perangkat Android A).
  2. Gunakan adaptor OTG untuk menghubungkan ujung kabel lainnya ke perangkat Android kedua perangkat B yang beroperasi dalam mode host.
  3. Di perangkat Android A:
    1. Tarik jari ke bawah dari bagian atas layar.
    2. Pilih ikon USB untuk Pengisian Daya.
    3. Pilih MIDI.
    4. Luncurkan aplikasi MidiKeyboard.
    5. Pilih Android USB Peripheral Port dari menu Receiver for Keys di bagian atas.
  4. Di perangkat Android B:
    1. Luncurkan aplikasi MidiScope.
    2. Pilih perangkat Android lainnya sebagai sumber.
  5. Di perangkat Android A:
    1. Putar catatan di keyboard dan cari NoteOn dan NoteOff di perangkat Android B.

Pengujian BLE

Hardware yang diperlukan: Keyboard MIDI yang mendukung BLE

Pemasangan dan pemutaran dasar

Aplikasi yang diperlukan: MidiBtlePairing, MidiSynthExample

Uji keyboard yang terhubung ke Android melalui BLE.

  1. Mulai ulang perangkat Android.
  2. Nyalakan keyboard BLE.
    (Keyboard Miselu C.24 dihidupkan dengan menekan tombol di dekat bagian belakang sehingga sehingga kotak itu terbuka. Tombol daya di C.24 berkedip biru saat dipasangkan .)
  3. Luncurkan aplikasi MidiBtlePairing. Layar ini memiliki ikon MIDI+BTLE.
  4. Tekan tombol Pemindaian Bluetooth.
  5. Pilih periferal BLE yang diinginkan.
  6. Aplikasi akan kembali ke halaman utama, dan Anda akan melihat periferal sudah tercantum. Jika Anda menggunakan C.24, maka Anda akan melihat bahwa lampu akan menyala hijau C.24 untuk menunjukkan mode berpasangan.
  7. Keluar dari aplikasi dengan menekan tombol Layar Utama, bukan tombol Kembali.
  8. Luncurkan aplikasi SynthExample.
  9. Pilih keyboard BLE sebagai pengirim dari menu.
  10. Anda seharusnya dapat menekan tombol di {i>keyboard<i} BLE dan mendengarkan catatan tentang Android.