Yamaha reface CS MIDI CC chart, NRPN and OSC map¶
The Yamaha reface CS MIDI implementation: 17 CC, each named, for Claude (MCP), SuperCollider or any OSC app.
| Device | Yamaha reface CS |
|---|---|
| Vendor | Yamaha |
| OSC prefix | /reface_cs |
| 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/yamaha/reface_cs.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/yamaha/reface_cs.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 reface_cs: ask “what can the Yamaha reface CS 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 |
|---|---|---|---|---|---|
/reface_cs/general/portamento |
20 | 0–127 | continuous | General | |
/reface_cs/lfo/assign |
78 | 0–127 | continuous | LFO | |
/reface_cs/lfo/depth |
77 | 0–127 | continuous | LFO | |
/reface_cs/lfo/speed |
76 | 0–127 | continuous | LFO | |
/reface_cs/oscillator/type |
80 | 0–127 | continuous | Oscillator | |
/reface_cs/oscillator/texture |
81 | 0–127 | continuous | Oscillator | |
/reface_cs/oscillator/mod |
82 | 0–127 | continuous | Oscillator | |
/reface_cs/filter/cutoff |
74 | 0–127 | continuous | Filter | |
/reface_cs/filter/resonance |
71 | 0–127 | continuous | Filter | |
/reface_cs/envelope_generator/eg_feg_aeg_balance |
83 | 0–127 | continuous | Envelope generator | |
/reface_cs/envelope_generator/eg_attack_time |
73 | 0–127 | continuous | Envelope generator | |
/reface_cs/envelope_generator/eg_decay_time |
75 | 0–127 | continuous | Envelope generator | |
/reface_cs/envelope_generator/eg_sustain_level |
79 | 0–127 | continuous | Envelope generator | |
/reface_cs/envelope_generator/eg_release_time |
72 | 0–127 | continuous | Envelope generator | |
/reface_cs/effect/type |
17 | 0–127 | continuous | Effect | |
/reface_cs/effect/depth |
18 | 0–127 | continuous | Effect | |
/reface_cs/effect/rate |
19 | 0–127 | continuous | Effect |
Performance MIDI¶
Notes, pitch bend and any CC are also available: /reface_cs/note/on <note> <velocity>, /reface_cs/cc/<number> <value>, /reface_cs/pitchbend <0-16383>, /reface_cs/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.
Frequently asked questions¶
Which MIDI CC controls the filter cutoff on the Yamaha reface CS?
CC 74 (0–127), named /reface_cs/filter/cutoff in SynthHub's map.
How many parameters of the Yamaha reface CS can be controlled over MIDI?
SynthHub's map of the Yamaha reface CS lists 17 MIDI CC parameters, each with its number, range and a readable name; the full chart is on this page.
Can an AI agent like Claude control the Yamaha reface CS?
Yes: SynthHub's hosted MCP server knows the Yamaha reface CS's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.