Arduino AppleMIDI Library

AppleMIDI (alias rtpMIDI) pour Arduino

Permet à un Arduino doté de capacités IP/UDP (Ethernet Shield, ESP8266, ESP32, ...) de participer à une session AppleMIDI.

Important : veuillez lire la note ci-dessous sur l'agrandissement de la taille du tampon de la bibliothèque Ethernet standard pour éviter de supprimer des messages MIDI !

Caractéristiques

• Construit sur la populaire bibliothèque MIDI FortySevenEffects
• Testé avec AppleMIDI sur Mac OS (Big Sur) et en utilisant rtpMIDI de Tobias Erichsen sur Windows 10
• Envoyer et recevoir tous les messages MIDI
• Utilise des rappels pour recevoir des commandes MIDI (pas besoin d'interrogation)
• Instanciation automatique de l'objet AppleMIDI (voir à la fin de 'AppleMidi.h')
• Compile sur Arduino, MacOS (XCode) et Windows (MSVS)

Nouveau dans la version 3.2.0

• Enchaînement d'événements

Nouveau dans la version 3.3.0

• Meilleure analyse des gros messages MIDI entrants avec un petit tampon Arduino interne

Installation

Depuis le gestionnaire de bibliothèque Arduino IDE, recherchez AppleMIDI

Cela installera également la bibliothèque MIDI FortySevenEffects

Utilisation de base

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

Plus d'utilisations dans le dossier exemples et dans le wiki

Matériel

• Arduino/Genuino (Mega, Uno, Arduino Ethernet, MKRZERO, ...)
• ESP8266 (Adafruit HUZZAH ESP8266, Sparkfun ESP8266 Thing Dev)
• ESP32 (Adafruit HUZZAH32 – Carte Feather ESP32)
• ESP32 avec configuration W5500
• Teensy 3.2 et 4.1
• Adafruit Feather M0 WiFi-ATSAMD21 + ATWINC1500

Boucliers réseau

• Blindage Ethernet Arduino (Wiznet W5100 et W5500)
• Bouclier Arduino Wifi R3
• Bouclier MKR ETH (basé sur W5500 et W6100)
• Teensy WIZ820io W5200
• Teensy 4.1 avec kit Ethernet

Remarques

Noms des sessions

Les noms de session peuvent devenir très longs sur Mac (par exemple 'Macbook Pro de Johann Gambolputty .. von Hautkopft d'Ulm') et seront tronqués au MaxSessionNameLen

Empreinte mémoire

L'empreinte mémoire de la bibliothèque peut être considérablement réduite, lisez le wiki

Taille du tampon Ethernet

Il est fortement recommandé de modifier la bibliothèque Ethernet ou d'utiliser la bibliothèque Ethernet3 pour éviter les dépassements de tampon - en savoir plus

Latence

Utilisez Ethernet filaire pour réduire la latence, le Wi-Fi augmente la latence et la latence varie. Plus de wiki

IDE Arduino (arduino.cc)

• 1.8.16

Contribuer

J'aimerais inclure vos améliorations ou corrections de bugs ! Au lieu d'un guide de style formel, veillez à conserver le style de codage existant. Veuillez tester votre code avant d'envoyer une pull request. Il serait très utile d'inclure une explication détaillée de vos modifications dans la demande d'extraction.