Arduino AppleMIDI Library

AppleMIDI (auch bekannt als rtpMIDI) für Arduino

Ermöglicht einem Arduino mit IP/UDP-Funktionen (Ethernet Shield, ESP8266, ESP32, ...) die Teilnahme an einer AppleMIDI-Sitzung.

Wichtig: Bitte lesen Sie den Hinweis unten zur Vergrößerung der Puffergröße der Standard-Ethernet-Bibliothek, um den Verlust von MIDI-Nachrichten zu vermeiden!

Merkmale

• Bauen Sie auf der beliebten MIDI-Bibliothek FortySevenEffects auf
• Getestet mit AppleMIDI unter Mac OS (Big Sur) und mit rtpMIDI von Tobias Erichsen unter Windows 10
• Senden und empfangen Sie alle MIDI-Nachrichten
• Verwendet Rückrufe, um MIDI-Befehle zu empfangen (keine Abfrage erforderlich)
• Automatische Instanziierung des AppleMIDI-Objekts (siehe am Ende von „AppleMidi.h“)
• Kompiliert auf Arduino, MacOS (XCode) und Windows (MSVS)

Neu in 3.2.0

• Ereignisverkettung

Neu in 3.3.0

• Bessere Analyse großer eingehender MIDI-Nachrichten mit einem kleinen internen Arduino-Puffer

Installation

Suchen Sie im Arduino IDE Library Manager nach AppleMIDI

Dadurch wird auch die MIDI-Bibliothek FortySevenEffects installiert

Grundlegende Verwendung

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

Weitere Verwendungsmöglichkeiten im Beispielordner und im Wiki

Hardware

• Arduino/Genuino (Mega, Uno, Arduino Ethernet, MKRZERO, ...)
• ESP8266 (Adafruit HUZZAH ESP8266, Sparkfun ESP8266 Thing Dev)
• ESP32 (Adafruit HUZZAH32 – ESP32 Feather Board) WLAN
• ESP32 mit W5500-Setup
• Teensy 3.2 & 4.1
• Adafruit Feather M0 WiFi – ATSAMD21 + ATWINC1500

Netzwerkschilde

• Arduino Ethernet Shield (Wiznet W5100 und W5500)
• Arduino Wifi R3-Schild
• MKR ETH-Schild (W5500- und W6100-basiert)
• Teensy WIZ820io W5200
• Teensy 4.1 mit Ethernet-Kit

Notizen

Sitzungsnamen

Sitzungsnamen können auf Macs sehr lang werden (z. B. „Macbook Pro von Johann Gambolputty .. von Hautkopft aus Ulm“) und werden auf die MaxSessionNameLen gekürzt

Speicherbedarf

Der Speicherbedarf der Bibliothek kann deutlich gesenkt werden, lesen Sie im Wiki

Ethernet-Puffergröße

Es wird dringend empfohlen, die Ethernet-Bibliothek zu ändern oder die Ethernet3-Bibliothek zu verwenden, um Pufferüberläufe zu vermeiden – erfahren Sie mehr

Latenz

Verwenden Sie kabelgebundenes Ethernet, um die Latenz zu reduzieren. WLAN erhöht die Latenz und die Latenz variiert. Mehr vom Wiki

Arduino IDE (arduino.cc)

• 1.8.16

Mitwirken

Ich würde gerne Ihre Verbesserungen oder Fehlerbehebungen einbeziehen! Anstelle eines formalen Styleguides achten Sie bitte darauf, den bestehenden Codierungsstil beizubehalten. Bitte testen Sie Ihren Code, bevor Sie eine Pull-Anfrage senden. Es wäre sehr hilfreich, wenn Sie dem Pull-Request eine detaillierte Erläuterung Ihrer Änderungen hinzufügen würden.