Arduino AppleMIDI Library

用於 Arduino 的 AppleMIDI（又稱 rtpMIDI）

使具有 IP/UDP 功能（乙太網路擴充板、ESP8266、ESP32...）的 Arduino 能夠參與 AppleMIDI 會話。

重要提示：請閱讀下面有關擴大標準乙太網路庫緩衝區大小以避免丟失 MIDI 訊息的註釋！

特徵

• 基於流行的 FortySevenEffects MIDI 庫構建
• 在 Mac OS (Big Sur) 上使用 AppleMIDI 進行測試，在 Windows 10 上使用 Tobias Erichsen 的 rtpMIDI 進行測試
• 發送和接收所有 MIDI 訊息
• 使用回調接收 MIDI 指令（無需輪詢）
• AppleMIDI 物件的自動實例化（請參閱「AppleMidi.h」末端）
• 可在 Arduino、MacOS (XCode) 和 Windows (MSVS) 上編譯

3.2.0 中的新功能

• 事件鏈

3.3.0 中的新功能

• 使用小型內部 Arduino 緩衝區更好地解析大量傳入 MIDI 訊息

安裝

從 Arduino IDE 庫管理器中，搜尋 AppleMIDI

這也將安裝 FortySevenEffects MIDI 庫

基本用法

# 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 );
  }
}

更多用法請參考範例資料夾和 wiki

硬體

• Arduino/Genuino（Mega、Uno、Arduino 乙太網路、MKRZERO...）
• ESP8266（Adafruit HUZZAH ESP8266、Sparkfun ESP8266 Thing 開發）
• ESP32（Adafruit HUZZAH32 – ESP32 羽毛板）Wi-Fi
• 帶有 W5500 設定的 ESP32
• 青少年 3.2 和 4.1
• Adafruit Feather M0 WiFi - ATSAMD21 + ATWINC1500

網路盾

• Arduino 乙太網路擴充板（Wiznet W5100 和 W5500）
• Arduino Wifi R3 擴充板
• MKR ETH 盾牌（基於 W5500 和 W6100）
• 青少年 WIZ820io W5200
• Teensy 4.1 含乙太網路套件

筆記

會話名稱

Mac 上的會話名稱可能會很長（例如“Johann Gambolputty 的 Macbook Pro .. Ulm 的 von Hautkopft”），並且會被截斷為MaxSessionNameLen

記憶體佔用

庫的記憶體佔用可以顯著降低，請閱讀 wiki

乙太網路緩衝區大小

強烈建議修改乙太網路庫或使用Ethernet3庫以避免緩衝區溢出 - 了解更多

延遲

使用有線乙太網路可以減少延遲，Wi-Fi 會增加延遲，延遲各不相同。更多維基百科

Arduino IDE (arduino.cc)

• 16年1月8日

貢獻

我很樂意包含您的增強功能或錯誤修復！請注意維護現有的編碼風格，而不是正式的樣式指南。請在發送拉取請求之前測試您的程式碼。如果您在拉取請求中包含變更的詳細說明，將會非常有幫助。