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 Ethernet、MKRZERO、...)
• ESP8266 (Adafruit HUZZAH ESP8266、Sparkfun ESP8266 Thing Dev)
• ESP32 (Adafruit HUZZAH32 – ESP32 フェザーボード) Wi-Fi
• W5500 セットアップを備えた ESP32
• ティーンシー 3.2 & 4.1
• Adafruit Feather M0 WiFi - ATSAMD21 + ATWINC1500

ネットワークシールド

• Arduino Ethernet シールド (Wiznet W5100 および W5500)
• Arduino Wifi R3 シールド
• MKR ETH シールド (W5500 および W6100 ベース)
• 小さな WIZ820io W5200
• Teensy 4.1 (イーサネットキット付き)

注意事項

セッション名

Mac ではセッション名が非常に長くなる可能性があり (例: 「Johann Gambolputty の Macbook Pro .. von Hautkopft of Ulm」)、 MaxSessionNameLenに切り詰められます。

メモリ使用量

ライブラリのメモリ使用量は大幅に削減できます。Wiki を読んでください。

イーサネットバッファサイズ

バッファ オーバーランを避けるために、Ethernet ライブラリを変更するか、Ethernet3 ライブラリを使用することを強くお勧めします - 詳細

レイテンシ

有線イーサネットを使用すると遅延が減少しますが、Wi-Fi では遅延が増加し、遅延は変動します。ウィキの詳細

Arduino IDE (arduino.cc)

• 1.8.16

貢献する

機能強化やバグ修正をぜひ含めていただきたいと思っています。正式なスタイルガイドの代わりに、既存のコーディング スタイルを維持するように注意してください。プル リクエストを送信する前にコードをテストしてください。プルリクエストに変更の詳細な説明を含めていただけると非常に役立ちます。