Arduino AppleMIDI Library

AppleMIDI (alias rtpMIDI) untuk Arduino

Memungkinkan Arduino dengan kemampuan IP/UDP (Ethernet shield, ESP8266, ESP32, ...) untuk berpartisipasi dalam sesi AppleMIDI.

Penting: Harap baca catatan di bawah tentang cara memperbesar ukuran buffer perpustakaan Ethernet standar untuk menghindari hilangnya pesan MIDI!

Fitur

• Bangun di atas perpustakaan MIDI FortySevenEffects yang populer
• Diuji dengan AppleMIDI di Mac OS (Big Sur) dan menggunakan rtpMIDI dari Tobias Erichsen di Windows 10
• Kirim dan terima semua pesan MIDI
• Menggunakan panggilan balik untuk menerima perintah MIDI (tidak perlu polling)
• Instansiasi otomatis objek AppleMIDI (lihat di akhir 'AppleMidi.h')
• Kompilasi di Arduino, MacOS (XCode) dan Windows (MSVS)

Baru di 3.2.0

• Rangkaian acara

Baru di 3.3.0

• Penguraian pesan MIDI masuk berukuran besar yang lebih baik dengan buffer Arduino internal kecil

Instalasi

Dari Arduino IDE Library Manager, cari AppleMIDI

Ini juga akan menginstal perpustakaan MIDI FortySevenEffects

Penggunaan Dasar

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

Penggunaan lebih lanjut di folder contoh dan di wiki

Perangkat keras

• Arduino/Genuino (Mega, Uno, Arduino Ethernet, MKRZERO, ...)
• ESP8266 (Adafruit HUZZAH ESP8266, Sparkfun ESP8266 Hal Pengembang)
• ESP32 (Adafruit HUZZAH32 – Papan Bulu ESP32) Wi-Fi
• ESP32 dengan Pengaturan W5500
• Sangat kecil 3.2 & 4.1
• Adafruit Feather M0 WiFi - ATSAMD21 + ATWINC1500

Perisai Jaringan

• Pelindung Ethernet Arduino (Wiznet W5100 dan W5500)
• Pelindung Arduino Wifi R3
• Perisai MKR ETH (berbasis W5500 dan W6100)
• WIZ820io W5200 yang sangat kecil
• Sangat kecil 4.1 dengan Kit Ethernet

Catatan

Nama sesi

Nama sesi bisa menjadi sangat panjang di Mac (misalnya 'Macbook Pro of Johann Gambolputty .. von Hautkopft of Ulm') dan akan dipotong menjadi MaxSessionNameLen

Jejak memori

Jejak memori perpustakaan dapat diturunkan secara signifikan, baca wiki

Ukuran penyangga Ethernet

Sangat disarankan untuk memodifikasi perpustakaan Ethernet atau menggunakan perpustakaan Ethernet3 untuk menghindari kelebihan buffer - pelajari lebih lanjut

Latensi

Gunakan Ethernet kabel untuk mengurangi latensi, Wi-Fi meningkatkan latensi dan latensi bervariasi. Lebih banyak tentang wiki

Arduino IDE (arduino.cc)

• 1.8.16

Berkontribusi

Saya ingin menyertakan peningkatan atau perbaikan bug Anda! Sebagai pengganti panduan gaya formal, harap berhati-hati dalam mempertahankan gaya pengkodean yang ada. Silakan uji kode Anda sebelum mengirim permintaan penarikan. Akan sangat membantu jika Anda menyertakan penjelasan detail tentang perubahan Anda di pull request.