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 以太网、MKRZERO...）
• ESP8266（Adafruit HUZZAH ESP8266、Sparkfun ESP8266 Thing 开发）
• ESP32（Adafruit HUZZAH32 – ESP32 羽毛板）Wi-Fi
• 带有 W5500 设置的 ESP32
• 青少年 3.2 和 4.1
• Adafruit Feather M0 WiFi - ATSAMD21 + ATWINC1500

网络盾

• Arduino 以太网扩展板（Wiznet W5100 和 W5500）
• Arduino Wifi R3 扩展板
• MKR ETH 盾牌（基于 W5500 和 W6100）
• 青少年 WIZ820io W5200
• Teensy 4.1 带以太网套件

笔记

会话名称

Mac 上的会话名称可能会很长（例如“Johann Gambolputty 的 Macbook Pro .. Ulm 的 von Hautkopft”），并且会被截断为MaxSessionNameLen

内存占用

库的内存占用可以显着降低，请阅读 wiki

以太网缓冲区大小

强烈建议修改以太网库或使用Ethernet3库以避免缓冲区溢出 - 了解更多

延迟

使用有线以太网可以减少延迟，Wi-Fi 会增加延迟，并且延迟各不相同。更多维基百科

Arduino IDE (arduino.cc)

• 16年1月8日

贡献

我很乐意包含您的增强功能或错误修复！请注意维护现有的编码风格，而不是正式的样式指南。请在发送拉取请求之前测试您的代码。如果您在拉取请求中包含对更改的详细说明，将会非常有帮助。