Back to Tinyusb

MIDI 2.0 Song Sender

examples/device/midi2_device/README.md

0.21.01.6 KB
Original Source

MIDI 2.0 Song Sender

USB MIDI 2.0 Device example that plays "Twinkle Twinkle Little Star" using native UMP (Universal MIDI Packet) format with full MIDI 2.0 expression.

MIDI 2.0 Features Demonstrated

  • 16-bit Velocity (vs 7-bit MIDI 1.0)
  • 32-bit Control Change values
  • 32-bit Pitch Bend (vs 14-bit MIDI 1.0)
  • 32-bit Channel Pressure (Aftertouch)
  • 32-bit Poly Pressure (Per-Note Aftertouch)
  • Per-Note Management (MIDI 2.0 exclusive)
  • Program Change with Bank Select
  • JR Timestamps

USB Descriptors

The device exposes both USB-MIDI 1.0 (Alt Setting 0) and USB-MIDI 2.0 (Alt Setting 1) as required by the USB-MIDI 2.0 specification. A MIDI 2.0 capable host (e.g. Windows MIDI Services) will select Alt Setting 1 for native UMP transport. Legacy hosts use Alt Setting 0 with automatic MIDI 1.0 fallback.

InterfaceClass driver
0–1MIDI 2.0 (audio control + MIDI streaming)

Configuration

Notable tusb_config.h settings:

c
#define CFG_TUD_MIDI2           1

Building

CMake:

bash
mkdir build && cd build
cmake -DBOARD=raspberry_pi_pico ..
cmake --build .

Make:

bash
make BOARD=raspberry_pi_pico all

Testing

Linux:

bash
aseqdump -p "MIDI 2.0 Device"

Windows (MIDI 2.0 native):

powershell
midi endpoint list
midi endpoint monitor

Song Data

Twinkle Twinkle Little Star in C major, 120 BPM. Six phrases with dynamic shaping (pp to ff crescendo and back), pitch bend vibrato on sustained notes, and channel/poly pressure for expression. All values use genuine MIDI 2.0 resolution with no 7-bit equivalent.