Roland SPD-20 PRO: MIDI CC, NRPN and OSC map¶
The Roland SPD-20 PRO as named OSC addresses — 17 CC — ready to use from Claude (MCP), SuperCollider, Sonic Pi, TouchDesigner or any OSC app via osc-bridge.
| Device | Roland SPD-20 PRO |
|---|---|
| Vendor | Roland |
| OSC prefix | /spd_20_pro |
| Source | 📦 Derived from MIDI Guide (community CC/NRPN data) |
| Firmware | unknown |
| Revision | per pencilresearch canonical CSV |
| Upstream | pencilresearch |
| Data licence | CC-BY-SA-4.0 — MIDI Guide (https://midi.guide) by Pencil Research and contributors |
| Driver file | devices/roland/spd_20_pro.pencilresearch.fw-unknown.json |
Not tested on the device yet
This driver comes from documentation or community data and has not been checked on real hardware. If you own one, a quick test and a pull request promoting it helps everyone — see CONTRIBUTING.
How do you control it?¶
Find the MIDI ports, then start the bridge with this driver:
osc-bridge detect # prints the ready-to-run line for what is plugged in
osc-bridge run --device devices/roland/spd_20_pro.pencilresearch.fw-unknown.json --out-port <N> --in-port <M>
Then send OSC to 127.0.0.1:7777, for example:
From Claude or any MCP client, the osc-bridge mcp server exposes this driver as spd_20_pro: ask “what can the Roland SPD-20 PRO do?” and it reads this map with list_routes. See the MCP guide.
MIDI CC and NRPN parameters (17)¶
| OSC address | CC | NRPN (MSB/LSB) | Range | Nature | Section |
|---|---|---|---|---|---|
/spd_20_pro/bank_select/msb |
0 | 0–127 | continuous | Bank select | |
/spd_20_pro/bank_select/lsb |
32 | 0–1 | switch | Bank select | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_1_mod |
1 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_2_breath |
2 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_4_foot |
4 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_11_exp |
11 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_16_gen1 |
16 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_17_gen2 |
17 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_18_gen3 |
18 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/hi_hat_control/hi_hat_pedal_position_19_gen4 |
19 | 0–127 | continuous | Hi-hat control | |
/spd_20_pro/channel_mode/all_sounds_off |
120 | 0–0 | continuous | Channel mode | |
/spd_20_pro/channel_mode/reset_all_controllers |
121 | 0–0 | continuous | Channel mode | |
/spd_20_pro/channel_mode/all_notes_off |
123 | 0–0 | continuous | Channel mode | |
/spd_20_pro/channel_mode/omni_off |
124 | 0–0 | continuous | Channel mode | |
/spd_20_pro/channel_mode/omni_on |
125 | 0–0 | continuous | Channel mode | |
/spd_20_pro/channel_mode/mono |
126 | 0–16 | continuous | Channel mode | |
/spd_20_pro/channel_mode/poly |
127 | 0–0 | continuous | Channel mode |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /spd_20_pro/note/on <note> <velocity>, /spd_20_pro/cc/<number> <value>, /spd_20_pro/pitchbend <0-16383>, /spd_20_pro/program_change <n>.
Limitations¶
CC/NRPN only. SysEx (preset management, display control, bulk dump/load, vendor-proprietary opcodes) is NOT covered by pencilresearch. To extend this device with SysEx, sniff the vendor editor, add `sysex.header/footer` + `commands` blocks, and use `update_device.md` PR template.