Процедура тестирования MIDI

Эти тесты можно использовать для проверки функции MIDI на устройствах Android. Успешное выполнение этих тестов является обязательным условием для использования функции MIDI .

Подготовка

Аппаратное обеспечение

Для тестов необходимо следующее оборудование.

  • MIDI-клавиатура с разъемом USB
  • MIDI-клавиатура с поддержкой Bluetooth Low Energy (BLE)
  • USB-кабели
  • Адаптер USB On-The-Go (OTG) для преобразования гнездового USB-A в штекерный микро-USB или USB-C
  • Устройство Android под управлением Android 6.0 Marshmallow или более поздней версии
  • Дополнительно: настольный компьютер

Несколько MIDI-клавиатур поддерживают как USB, так и BLE-MIDI, поэтому вы можете проводить тестирование только с одной клавиатурой. Примерами являются Akai LPK25 Wireless и Korg Microkey Air .

Приложения

В этой процедуре тестирования используются несколько приложений. Приложения доступны в исходном коде в проекте GitHub android-midisuite , а также в Google Play ™ по ссылкам в следующей таблице.

Исходный код Google Play™ Описание
Мидископ или Мидископ MIDI-область отображает MIDI-сообщения на экране
Миди-клавиатура MIDI-клавиатура отправляет MIDI-сообщения нажатием экранной музыкальной клавиатуры
MidiSynthПример или
МидиСинт		 MIDI-синтезатор простой MIDI-синтезатор, использующий пилообразные генераторы
MidiBtlePairing MIDI-подключение BLE соединяет устройство Android с периферийным устройством BLE
MidiИнструменты зависимость библиотеки вышеуказанных приложений

Если вы предпочитаете работать с исходным кодом, а не устанавливать через Google Play ™, сначала создайте приложение, используя прилагаемый Android.mk . Затем установите приложение с помощью Android Debug Bridge (ADB). Например, чтобы установить приложение MidiScope :

  1. Используйте рабочую станцию ​​с установленным ADB.
  2. Подключите USB-кабель от рабочей станции к устройству Android.
  3. Возможно, вам придется разрешить USB-соединение на устройстве Android; см. режим периферийного устройства USB
  4. На рабочей станции введите: 
cd THIS_FOLDER
adb install -r MidiScope.apk

Виртуальные синтезаторные тесты

Обратите внимание, что входной порт MIDI может иметь только одно соединение. Поэтому, если другое приложение уже использует входной порт, этот порт будет недоступен. Если вы не можете подключиться к входному порту, попробуйте закрыть другие приложения.

Необходимое оборудование: тестируемое устройство Android.

Простое подключение

Необходимые приложения: MidiKeyboard , MidiSynthExample.

При этом проверяется перечисление устройств, виртуальные устройства, соединения портов и отправка сообщений.

  1. Отрегулируйте громкость на устройстве Android примерно наполовину.
  2. Ориентируйте телефон в ландшафтном режиме.
  3. Запустите приложение MidiKeyboard .
  4. Выберите SynthExample в меню счетчика.
  5. Игровые ключи. Вы должны услышать ноты, воспроизводимые в приложении SynthExample .
  6. Выйдите из приложения, нажав кнопку «Назад» , чтобы порт закрылся.

USB-тест: режим хоста

Необходимое оборудование: USB MIDI-клавиатура, USB-кабель, адаптер OTG.

Повторите эти тесты несколько раз. Мы видели серьезные сбои стека USB на некоторых прототипах устройств, если устройства были подключены и отключены несколько раз.

Клавиатура уже подключена

Необходимые приложения: MidiSynthExample или MidiScope.

Это тестирует USB MIDI в режиме хоста.

  1. Отрегулируйте громкость на устройстве Android примерно наполовину.
  2. Подключите USB-клавиатуру с помощью адаптера OTG.
  3. Запустите приложение SynthExample или приложение MidiScope .
  4. В меню выберите USB-клавиатуру. Он будет отображать бренд.
  5. Играйте ноты на клавиатуре. Если вы запустили SynthExample , вы должны услышать ноты, воспроизводимые на телефоне. Если вы запустили MidiScope , вы должны увидеть на экране сообщения NoteOn и NoteOff .
  6. Отключите клавиатуру. В меню «Отправитель для синтезатора» должно отображаться — — — — — .
  7. Выйдите из приложения, нажав кнопку «Назад» .

USB-клавиатура с возможностью горячего подключения

Необходимые приложения: MidiSynthExample или MidiScope.

Это тестирует USB MIDI в режиме хоста.

  1. Отрегулируйте громкость на устройстве Android примерно наполовину.
  2. Убедитесь, что USB MIDI-клавиатура не подключена.
  3. Запустите приложение SynthExample .
  4. В середине, рядом с «Отправителем синтезатора» , посмотрите в меню. Вы не должны видеть USB-клавиатуру в списке.
  5. Подключите USB-клавиатуру с помощью адаптера OTG.
  6. В середине рядом с «Отправитель для синтезатора» выберите USB-клавиатуру. Он будет отображать бренд.
  7. Играйте ноты на клавиатуре. Вы должны услышать ноты, воспроизводимые на телефоне.
  8. В середине рядом с «Отправитель для синтезатора » выберите — — — — — .
  9. Играйте ноты на клавиатуре. Вы ничего не должны слышать.
  10. В середине рядом с «Отправитель для синтезатора» выберите USB-клавиатуру. Он будет отображать бренд.
  11. Играйте ноты на клавиатуре. Вы должны услышать ноты, воспроизводимые на телефоне.
  12. Отключите синтезатор. В меню «Отправитель для синтезатора» должно отображаться — — — — — .
  13. Выйдите из приложения, нажав кнопку «Назад» .

USB-тест: периферийный режим

Необходимое оборудование: USB-кабель, адаптер OTG.

Android-Android

Необходимые приложения: MidiKeyboard на тестируемом устройстве Android, MidiScope на другом устройстве Android.

Используйте устройства Android в качестве периферийного контроллера для другого устройства Android. Чтобы протестировать этот режим, используйте другое устройство Android, работающее в режиме хоста. Обратите внимание, что вы можете изменить тест для работы с настольным компьютером, на котором установлено программное обеспечение Digital Audio Workstation (DAW), например GarageBand.

  1. Подключите USB-кабель к тестируемому устройству Android (устройство Android A ).
  2. Используйте адаптер OTG для подключения другого конца кабеля ко второму устройству Android B , которое работает в режиме хоста.
  3. На Android-устройстве А:
    1. Проведите пальцем вниз от верхней части экрана.
    2. Выберите значок USB для зарядки .
    3. Выберите MIDI .
    4. Запустите приложение MidiKeyboard .
    5. Выберите «Периферийный порт Android USB» в меню «Приемник для ключей» вверху.
  4. На Android-устройстве Б:
    1. Запустите приложение MidiScope .
    2. Выберите другое устройство Android в качестве источника.
  5. На Android-устройстве А:
    1. Воспроизведите ноты на клавиатуре и найдите NoteOn и NoteOff на устройстве Android B.

BLE-тест

Необходимое оборудование: MIDI-клавиатура с поддержкой BLE.

Базовое сопряжение и игра

Необходимые приложения: MidiBtlePairing , MidiSynthExample.

Проверьте клавиатуру, подключенную к Android через BLE.

  1. Перезагрузите Android-устройство.
  2. Включите клавиатуру BLE.
    (Клавиатура Miselu C.24 включается нажатием кнопки рядом с задней частью, чтобы она открылась. Кнопка питания на C.24 мигает синим цветом в режиме сопряжения.)
  3. Запустите приложение MidiBtlePairing . Он имеет значок MIDI+BTLE .
  4. Нажмите кнопку сканирования Bluetooth .
  5. Выберите необходимое периферийное устройство BLE.
  6. Приложение должно вернуться на главную страницу, и вы увидите список периферийных устройств. Если вы используете C.24, вы заметите, что индикатор на C.24 должен загореться зеленым, указывая на сопряженный режим.
  7. Выйдите из приложения, нажав кнопку «Домой» , а не кнопку «Назад» .
  8. Запустите приложение SynthExample.
  9. Выберите клавиатуру BLE в качестве отправителя из меню.
  10. Вы сможете нажимать клавиши на клавиатуре BLE и слышать заметки на Android.