Arduino AppleMIDI Library

AppleMIDI (também conhecido como rtpMIDI) para Arduino

Permite que um Arduino com capacidades IP/UDP (Ethernet Shield, ESP8266, ESP32, ...) participe de uma sessão AppleMIDI.

Importante: Por favor, leia a nota abaixo sobre como aumentar o tamanho do buffer da biblioteca Ethernet padrão para evitar a perda de mensagens MIDI!

Características

• Construa com base na popular biblioteca MIDI FortySevenEffects
• Testado com AppleMIDI no Mac OS (Big Sur) e usando rtpMIDI de Tobias Erichsen no Windows 10
• Envie e receba todas as mensagens MIDI
• Usa retornos de chamada para receber comandos MIDI (sem necessidade de polling)
• Instanciação automática do objeto AppleMIDI (veja no final de 'AppleMidi.h')
• Compila em Arduino, MacOS (XCode) e Windows (MSVS)

Novo em 3.2.0

• Encadeamento de eventos

Novo em 3.3.0

• Melhor análise de grandes mensagens MIDI recebidas com um pequeno buffer interno do Arduino

Instalação

No Arduino IDE Library Manager, procure por AppleMIDI

Isso também instalará a biblioteca MIDI FortySevenEffects

Uso Básico

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

Mais usos na pasta de exemplos e no wiki

Hardware

• Arduino/Genuíno (Mega, Uno, Arduino Ethernet, MKRZERO, ...)
• ESP8266 (Adafruit HUZZAH ESP8266, Sparkfun ESP8266 Thing Dev)
• ESP32 (Adafruit HUZZAH32 – ESP32 Feather Board) Wi-Fi
• ESP32 com configuração W5500
• Adolescente 3.2 e 4.1
• Adafruit Pena M0 WiFi - ATSAMD21 + ATWINC1500

Escudos de Rede

• Escudo Ethernet Arduino (Wiznet W5100 e W5500)
• Escudo Arduino Wifi R3
• Escudo MKR ETH (baseado em W5500 e W6100)
• WIZ820io W5200
• Teensy 4.1 com kit Ethernet

Notas

Nomes de sessão

Os nomes das sessões podem ficar muito longos em Macs (por exemplo, 'Macbook Pro de Johann Gambolputty .. von Hautkopft de Ulm') e serão truncados para MaxSessionNameLen

Pegada de memória

O consumo de memória da biblioteca pode ser reduzido significativamente, leia o wiki

Tamanho do buffer Ethernet

É altamente recomendável modificar a biblioteca Ethernet ou usar a biblioteca Ethernet3 para evitar sobrecargas de buffer - saiba mais

Latência

Use Ethernet com fio para reduzir a latência, o Wi-Fi aumenta a latência e a latência varia. Mais do wiki

Arduino IDE (arduino.cc)

• 1.8.16

Contribuindo

Eu adoraria incluir suas melhorias ou correções de bugs! Em vez de um guia de estilo formal, tome cuidado para manter o estilo de codificação existente. Teste seu código antes de enviar uma solicitação pull. Seria muito útil se você incluísse uma explicação detalhada de suas alterações na solicitação pull.