Prosedur tes MIDI

Tes ini dapat digunakan untuk memvalidasi fitur MIDI pada perangkat Android. Keberhasilan pelaksanaan pengujian ini merupakan prasyarat untuk mengklaim fitur MIDI .

Persiapan

Perangkat keras

Perangkat keras berikut diperlukan untuk pengujian.

  • Keyboard MIDI dengan konektor USB
  • Keyboard MIDI dengan dukungan Bluetooth Low Energy (BLE).
  • kabel USB
  • Adaptor USB On-The-Go (OTG) untuk mengonversi USB-A betina ke micro-USB atau USB-C jantan
  • Perangkat Android yang menjalankan Android 6.0 Marshmallow atau rilis lebih baru
  • Opsional: komputer desktop

Beberapa keyboard MIDI mendukung USB dan BLE-MIDI, sehingga Anda dapat melakukan pengujian hanya dengan satu keyboard. Contohnya adalah Akai LPK25 Wireless dan Korg Microkey Air .

Aplikasi

Beberapa aplikasi digunakan oleh prosedur pengujian ini. Aplikasi tersedia dalam kode sumber di proyek GitHub android-midisuite , dan melalui Google Play ™ di tautan pada tabel berikut.

Kode sumber Google Play™ Keterangan
MidiScope atau MidiScope Lingkup MIDI menampilkan pesan MIDI di layar
Papan Ketik Midi Papan Ketik MIDI mengirim pesan MIDI dengan menekan keyboard musik di layar
Contoh MidiSynth atau
MidiSynth		 MIDI Synth Ex synthesizer MIDI sederhana yang menggunakan osilator gigi gergaji
Pemasangan MidiBtle Koneksi MIDI BLE memasangkan perangkat Android dengan periferal BLE
alat midi ketergantungan perpustakaan dari aplikasi di atas

Jika Anda memilih untuk bekerja dari kode sumber daripada menginstal melalui Google Play ™, buatlah aplikasi terlebih dahulu menggunakan Android.mk yang disediakan. Kemudian instal aplikasi menggunakan Android Debug Bridge (ADB). Misalnya, untuk menginstal aplikasi MidiScope :

  1. Gunakan stasiun kerja dengan ADB terinstal.
  2. Hubungkan kabel USB dari workstation ke perangkat Android.
  3. Anda mungkin perlu mengizinkan koneksi USB pada perangkat Android; lihat mode periferal USB
  4. Di stasiun kerja, masukkan:
cd THIS_FOLDER
adb install -r MidiScope.apk

Tes synth virtual

Perhatikan bahwa port input MIDI hanya dapat memiliki satu koneksi. Jadi jika aplikasi lain sudah menggunakan port input, port tersebut tidak akan tersedia. Jika Anda tidak dapat terhubung ke port input, coba tutup aplikasi lain.

Perangkat keras yang dibutuhkan: Perangkat Android sedang diuji

Koneksi sederhana

Aplikasi yang dibutuhkan: MidiKeyboard , MidiSynthExample

Ini menguji enumerasi perangkat, perangkat virtual, koneksi port, dan pengiriman pesan.

  1. Sesuaikan volume pada perangkat Android menjadi sekitar setengahnya.
  2. Arahkan ponsel dalam mode lanskap.
  3. Luncurkan aplikasi MidiKeyboard .
  4. Pilih SynthExample dari menu spinner.
  5. Mainkan kunci. Anda akan mendengar not diputar di aplikasi SynthExample .
  6. Keluar dari aplikasi dengan menekan tombol Back sehingga port akan tertutup.

Tes USB: mode host

Perangkat keras yang dibutuhkan: keyboard USB MIDI, kabel USB, adaptor OTG

Ulangi tes ini beberapa kali. Kami telah melihat tumpukan USB mengalami kerusakan parah pada beberapa perangkat prototipe jika perangkat dicolokkan dan dicabut beberapa kali.

Keyboard sudah terpasang

Aplikasi yang dibutuhkan: MidiSynthExample atau MidiScope

Ini menguji USB MIDI dalam mode host.

  1. Sesuaikan volume pada perangkat Android menjadi sekitar setengahnya.
  2. Colokkan keyboard USB menggunakan adaptor OTG.
  3. Luncurkan aplikasi SynthExample atau aplikasi MidiScope .
  4. Dari menu pilih keyboard USB. Ini akan menampilkan mereknya.
  5. Memainkan nada pada keyboard. Jika Anda menjalankan SynthExample maka Anda akan mendengar not diputar di telepon. Jika Anda menjalankan MidiScope maka Anda akan melihat pesan NoteOn dan NoteOff di layar.
  6. Cabut keyboardnya. Menu Pengirim untuk Synth akan menampilkan - - - - - .
  7. Keluar dari aplikasi dengan menekan tombol Kembali .

Keyboard USB colokan panas

Aplikasi yang dibutuhkan: MidiSynthExample atau MidiScope

Ini menguji USB MIDI dalam mode host.

  1. Sesuaikan volume pada perangkat Android menjadi sekitar setengahnya.
  2. Pastikan tidak ada keyboard USB MIDI yang terpasang.
  3. Luncurkan aplikasi SynthExample .
  4. Di tengah, di samping Sender for Synth , lihat di menu. Anda seharusnya tidak melihat keyboard USB terdaftar.
  5. Colokkan keyboard USB menggunakan adaptor OTG.
  6. Di tengah, di samping Sender for Synth , pilih keyboard USB. Ini akan menampilkan mereknya.
  7. Memainkan nada pada keyboard. Anda akan mendengar nada dimainkan di telepon.
  8. Di tengah, di samping Pengirim untuk Synth , pilih - - - - - .
  9. Memainkan nada pada keyboard. Anda seharusnya tidak mendengar apa pun.
  10. Di tengah, di samping Sender for Synth , pilih keyboard USB. Ini akan menampilkan mereknya.
  11. Memainkan nada pada keyboard. Anda akan mendengar nada dimainkan di telepon.
  12. Cabut synthesizer. Menu Pengirim untuk Synth akan menampilkan - - - - - .
  13. Keluar dari aplikasi dengan menekan tombol Kembali .

Tes USB: mode periferal

Perangkat keras yang dibutuhkan: kabel USB, adaptor OTG

Android-ke-Android

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

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

  1. Hubungkan kabel USB ke perangkat Android yang diuji (perangkat Android A ).
  2. Gunakan adaptor OTG untuk menyambungkan ujung kabel lainnya ke perangkat Android B kedua yang beroperasi dalam mode host.
  3. Di perangkat Android A:
    1. Seret jari ke bawah dari atas layar.
    2. Pilih USB untuk ikon Pengisian Daya .
    3. Pilih MIDI .
    4. Luncurkan aplikasi MidiKeyboard .
    5. Pilih Port Periferal USB Android dari menu Penerima untuk Tombol di atas.
  4. Di perangkat Android B:
    1. Luncurkan aplikasi MidiScope .
    2. Pilih perangkat Android lain sebagai sumbernya.
  5. Di perangkat Android A:
    1. Mainkan not di keyboard dan cari NoteOn dan NoteOff di perangkat Android B.

tes BLE

Perangkat keras yang dibutuhkan: keyboard MIDI yang mendukung BLE

Memasangkan dan memainkan dasar

Aplikasi yang dibutuhkan: MidiBtlePairing , MidiSynthExample

Uji keyboard yang terhubung ke Android melalui BLE.

  1. Nyalakan ulang perangkat Android.
  2. Nyalakan keyboard BLE.
    (Keyboard Miselu C.24 dinyalakan dengan menekan tombol di dekat bagian belakang sehingga terbuka. Tombol daya pada C.24 berkedip biru saat dalam mode berpasangan.)
  3. Luncurkan aplikasi MidiBtlePairing . 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 periferalnya terdaftar. Jika Anda menggunakan C.24, Anda akan melihat bahwa lampu pada C.24 akan berubah menjadi hijau untuk menunjukkan mode berpasangan.
  7. Keluar dari aplikasi dengan menekan tombol Beranda , bukan tombol Kembali .
  8. Luncurkan aplikasi SynthExample.
  9. Pilih keyboard BLE sebagai pengirim dari menu.
  10. Anda seharusnya dapat menekan tombol pada keyboard BLE dan mendengarkan nada di Android.