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

예제 폴더와 위키에서 더 많은 사용법

하드웨어

• Arduino/Genuino(Mega, Uno, Arduino 이더넷, MKRZERO, ...)
• ESP8266(Adafruit HUZZAH ESP8266, Sparkfun ESP8266 Thing Dev)
• ESP32(Adafruit HUZZAH32 – ESP32 페더 보드) Wi-Fi
• W5500 설정이 포함된 ESP32
• 틴시 3.2 & 4.1
• Adafruit Feather M0 WiFi - ATSAMD21 + ATWINC1500

네트워크 실드

• Arduino 이더넷 쉴드(Wiznet W5100 및 W5500)
• Arduino Wi-Fi R3 쉴드
• MKR ETH 쉴드 (W5500 및 W6100 기반)
• 틴시 WIZ820io W5200
• 이더넷 키트가 포함된 Teensy 4.1

메모

세션 이름

Mac에서는 세션 이름이 매우 길어질 수 있으며(예: 'Macbook Pro of Johann Gambolputty .. von Hautkopft of Ulm') MaxSessionNameLen 으로 잘립니다.

메모리 공간

라이브러리의 메모리 공간을 크게 줄일 수 있습니다. 위키를 읽어보세요.

이더넷 버퍼 크기

버퍼 오버런을 방지하려면 이더넷 라이브러리를 수정하거나 이더넷3 라이브러리를 사용하는 것이 좋습니다. 자세히 알아보기

숨어 있음

대기 시간을 줄이려면 유선 이더넷을 사용하고, Wi-Fi는 대기 시간을 늘리며 대기 시간은 다양합니다. 위키 더보기

아두이노 IDE (arduino.cc)

• 1.8.16

기여

개선 사항이나 버그 수정 사항을 포함하고 싶습니다! 공식적인 스타일 가이드 대신 기존 코딩 스타일을 유지하도록 주의하세요. 풀 요청을 보내기 전에 코드를 테스트해 보세요. Pull Request에 변경 사항에 대한 자세한 설명을 포함시켜 주시면 큰 도움이 될 것입니다.