midi-protocol-lookup

Look up APC Mini MK2 MIDI protocol details including note numbers, MIDI channels, velocity values, and SysEx format. Use when user asks about "MIDI note", "channel", "velocity", "status byte", "SysEx", "protocol", or needs to understand how MIDI messages control the APC Mini MK2.

$ 安裝

git clone https://github.com/majiayu000/claude-skill-registry /tmp/claude-skill-registry && cp -r /tmp/claude-skill-registry/skills/data/midi-protocol-lookup ~/.claude/skills/claude-skill-registry

// tip: Run this command in your terminal to install the skill


name: midi-protocol-lookup description: Look up APC Mini MK2 MIDI protocol details including note numbers, MIDI channels, velocity values, and SysEx format. Use when user asks about "MIDI note", "channel", "velocity", "status byte", "SysEx", "protocol", or needs to understand how MIDI messages control the APC Mini MK2.

APC Mini MK2 MIDI Protocol Reference

Quick reference for MIDI protocol details when developing APC Mini MK2 applications.

MIDI Message Structure

APC Mini MK2 uses standard MIDI messages:

  • Note On: [status, note, velocity] where status = 0x9n (n = channel)
  • Note Off: [status, note, velocity] where status = 0x8n
  • Control Change: [status, cc, value] where status = 0xBn

Note Number Quick Reference

Pad Grid (8x8 RGB Pads)

Notes 0-63, bottom-left to top-right:

RowNotesHex Range
8 (top)56-630x38-0x3F
748-550x30-0x37
640-470x28-0x2F
532-390x20-0x27
424-310x18-0x1F
316-230x10-0x17
28-150x08-0x0F
1 (bottom)0-70x00-0x07

Formula: note = row * 8 + column (0-indexed)

Peripheral Buttons

ButtonNotesHexLED Color
Track 1-8100-1070x64-0x6BRed
Scene Launch 1-8112-1190x70-0x77Green
Shift1220x7ANone

Faders (Control Change)

FaderCC NumberHex
Fader 1-848-550x30-0x37
Master560x38

MIDI Channel Effects

Channel selection determines LED brightness and animation:

ChannelHexEffect
00x9010% brightness
10x9125% brightness
20x9240% brightness
30x9355% brightness
40x9470% brightness
50x9585% brightness
60x96100% brightness (recommended)
70x97Pulse 1/16
80x98Pulse 1/8
90x99Pulse 1/4
100x9APulse 1/2
110x9BBlink 1/24
120x9CBlink 1/16
130x9DBlink 1/8
140x9EBlink 1/4
150x9FBlink 1/2

Status Byte Construction

Status byte = 0x90 + channel

Examples:

  • Full brightness: 0x96 (channel 6)
  • Pulse 1/4: 0x99 (channel 9)
  • Blink 1/8: 0x9D (channel 13)

SysEx Format for Custom RGB

For colors beyond the 128-color palette:

F0 47 7F 4F 24 [len-MSB] [len-LSB] [start] [end] [R-MSB] [R-LSB] [G-MSB] [G-LSB] [B-MSB] [B-LSB] F7

Header breakdown:

  • 0xF0: SysEx start
  • 0x47: Akai manufacturer ID
  • 0x7F: Device broadcast
  • 0x4F: APC Mini MK2 product ID
  • 0x24: RGB LED command
  • 0xF7: SysEx end

RGB encoding (8-bit value to MSB/LSB):

const msb = (value >> 7) & 0x01;
const lsb = value & 0x7F;

Quick Examples

Set pad to red at full brightness

[0x96, 0x00, 0x05]  // Channel 6, Note 0, Red

Turn off pad

[0x90, 0x00, 0x00]  // Any channel, Note 0, Off

Set Track button 1 on

[0x90, 0x64, 0x01]  // Channel 0, Note 100, On

Set Scene button 1 blinking

[0x90, 0x70, 0x02]  // Channel 0, Note 112, Blink

Official Documentation

Protocol PDF: cdn.inmusicbrands.com/akai/attachments/APC mini mk2 - Communication Protocol - v1.0.pdf