Arduino AppleMIDI Library

AppleMIDI (он же rtpMIDI) для Arduino

Позволяет Arduino с возможностями IP/UDP (экран Ethernet, ESP8266, ESP32, ...) участвовать в сеансе AppleMIDI.

Важно: Пожалуйста, прочитайте примечание ниже об увеличении размера буфера стандартной библиотеки Ethernet, чтобы избежать потери MIDI-сообщений!

Функции

• Создан на базе популярной MIDI-библиотеки FortySevenEffects.
• Протестировано с AppleMIDI в Mac OS (Big Sur) и с использованием rtpMIDI от Тобиаса Эриксена в Windows 10.
• Отправлять и получать все MIDI-сообщения
• Использует обратные вызовы для получения MIDI-команд (нет необходимости в опросе)
• Автоматическое создание экземпляра объекта AppleMIDI (см. конец AppleMidi.h)
• Компилируется на Arduino, MacOS (XCode) и Windows (MSVS).

Новое в версии 3.2.0

• Цепочка событий

Новое в версии 3.3.0

• Улучшенный анализ больших входящих MIDI-сообщений с помощью небольшого внутреннего буфера Arduino.

Установка

В диспетчере библиотек Arduino IDE найдите AppleMIDI.

Это также установит MIDI-библиотеку FortySevenEffects.

Основное использование

# include < Ethernet.h >
# include < AppleMIDI.h >

byte mac[] = { 0xDE , 0xAD , 0xBE , 0xEF , 0xFE , 0xED };

APPLEMIDI_CREATE_DEFAULTSESSION_INSTANCE (); 

void setup ()
{
  Ethernet. begin (mac);

  MIDI. begin (); // listens on channel 1
}

void loop ()
{
  // Listen to incoming notes
  MIDI. read ();
  
  ....
  if (something) {
    // Send MIDI note 40 on, velocity 55 on channel 1
    MIDI. sendNoteOn ( 40 , 55 , 1 );
  }
}

Больше вариантов использования в папке примеров и в вики.

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

• Arduino/Genuino (Mega, Uno, Arduino Ethernet, MKRZERO, ...)
• ESP8266 (Adafruit HUZZAH ESP8266, Sparkfun ESP8266 Thing Dev)
• ESP32 (Adafruit HUZZAH32 – Feather Board ESP32) Wi-Fi
• ESP32 с настройкой W5500
• Крошка 3.2 и 4.1
• Adafruit Feather M0 WiFi — ATSAMD21 + ATWINC1500

Сетевые щиты

• Плата Arduino Ethernet (Wiznet W5100 и W5500)
• Шилд Arduino Wi-Fi R3
• Шилд MKR ETH (на базе W5500 и W6100)
• Тинси WIZ820io W5200
• Teensy 4.1 с комплектом Ethernet

Примечания

Имена сеансов

Имена сеансов на Mac могут быть очень длинными (например, «Macbook Pro Иоганна Гамболпутти .. фон Хауткопфта из Ульма») и будут сокращены до MaxSessionNameLen

Объем памяти

Затраты памяти библиотеки можно значительно уменьшить, читайте вики

Размер буфера Ethernet

Настоятельно рекомендуется изменить библиотеку Ethernet или использовать библиотеку Ethernet3, чтобы избежать переполнения буфера — подробнее

Задержка

Используйте проводной Ethernet для уменьшения задержки, Wi-Fi увеличивает задержку, а задержка варьируется. Еще из вики

Arduino IDE (arduino.cc)

• 1.8.16

Содействие

Я хотел бы включить ваши улучшения или исправления ошибок! Вместо формального руководства по стилю позаботьтесь о сохранении существующего стиля кодирования. Пожалуйста, проверьте свой код перед отправкой запроса на включение. Было бы очень полезно, если бы вы включили подробное объяснение ваших изменений в запрос на включение.