devices/m-vave/fm-1.vendor.fw-ctl-1.0.json, updated 2026-10-24Edit on GitHubJSONCSVMIDNAMOSCQueryM-VAVE FM-1 running CTL-1 1.0
The M-VAVE FM-1 MIDI implementation: 18 CC, 2 SysEx commands, each named, for Claude (MCP), SuperCollider or any OSC app.
- sourcemaker's documentation
- firmwarectl-1.0
- Maker
- M-VAVE
- Firmware
- CTL-1 1.0 (alternative firmware by charlesvestal)
- Source
- maker's documentation
From the README of charlesvestal/fm1-ctl at e181b4a, licence MPL-2.0.
CTL-1 for the M-VAVE FM-1
CTL-1 turns the M-VAVE FM-1 into a MIDI controller. The keys play notes, with velocity and aftertouch read from the keys themselves, in any scale with its chords under the black keys; the knobs send controllers in four banks; an arpeggiator and a four-track Euclidean drum sequencer run on its clock. Everything goes out over USB and Bluetooth, MIDI from the TRS jack is passed along, and the FM-1 plays it all on its own General MIDI sounds too, so it works with nothing connected.
- Try it in your browser (no FM-1 needed): https://charlesvestal.github.io/fm1-ctl/emu/
- Install it (Chrome or Edge, with the FM-1 plugged in): https://charlesvestal.github.io/fm1-ctl/install/
- Read the manual: https://charlesvestal.github.io/fm1-ctl/manual/ (source: docs/MANUAL.md)
- Download the firmware file: releases:
ctl-X.Y.fwschas USB, TRS and Bluetooth MIDI,ctl-usb-X.Y.fwscthe same without Bluetooth
Installing it is at your own risk, though it's hard to get stuck: the web installer can put M-VAVE's own firmware back, and an FM-1 that fails to start twice comes up in a safe mode the installer can reach.
In short
| Keys | Notes; with a scale, its notes on the white keys and its chords on the black keys |
| KNOB 1–4 | The page's four values; on Play, four controllers in four banks |
| HOME · SEL · ARP · SEQ · EDIT · GLO | The pages: Play, Keys, Arp, Sequencer, Sound, Setup |
| SELECT | The page's own pages: the banks on Play, the tracks on the Sequencer |
| ALGORITHM · PRESETS · MASTER | MIDI channel · program change (the sound follows) · volume |
| FX | The next bank; held, KNOB 1–4 set its controller numbers |
| ENV · LFO | Sustain (tap twice to lock) · mod wheel |
| PLAY · REC · SAVE | Start / stop · panic · save |
| OCT− / OCT+ | An octave down or up |
The manual has the rest.
Screen reader
CTL-1 tells the FM-1 Screen Reader what its screen shows, over USB: the page and its knobs, a knob's value as it turns (a controller with its name, "CC 74 cutoff 64"), the channel and the program, the Sequencer's steps and mutes, the Touch settings, play and stop, and what each button did (the notes you play are not read out). Open the page in Chrome with the FM-1 plugged in; it speaks with its own voice, or hands the text to your computer's screen reader. The reader's messages stay between it and CTL-1: they are never passed on to Bluetooth.
Try it in your browser
Play a virtual FM-1 with any of its community firmwares: M-VAVE FM-1.
Communities
Where M-VAVE FM-1 owners meet, share and help each other:
- M-VAVE forum, forum
MIDI controls
20 controls, from the source at CTL-1 1.0 (alternative firmware by charlesvestal)
Track
| Control | CC | Range | Name to send |
|---|---|---|---|
| Modulation | 1 | 0–127 | /fm1_ctl/modulation |
| Volume | 7 | 0–127 | /fm1_ctl/volume |
| General | 16 | 0–127 | /fm1_ctl/general |
| General 17 | 17 | 0–127 | /fm1_ctl/general_17 |
| General 18 | 18 | 0–127 | /fm1_ctl/general_18 |
| General 19 | 19 | 0–127 | /fm1_ctl/general_19 |
| General 20 | 20 | 0–127 | /fm1_ctl/general_20 |
| General 21 | 21 | 0–127 | /fm1_ctl/general_21 |
| General 22 | 22 | 0–127 | /fm1_ctl/general_22 |
| General 23 | 23 | 0–127 | /fm1_ctl/general_23 |
| Sustain | 64 | switch | /fm1_ctl/sustain |
| Resonance | 71 | 0–127 | /fm1_ctl/resonance |
| Release | 72 | 0–127 | /fm1_ctl/release |
| Attack | 73 | 0–127 | /fm1_ctl/attack |
| Cutoff | 74 | 0–127 | /fm1_ctl/cutoff |
| Decay | 75 | 0–127 | /fm1_ctl/decay |
| Vibrato | 76 | 0–127 | /fm1_ctl/vibrato |
| All notes off | 123 | trigger | /fm1_ctl/all_notes_off |
SysEx commands
| Command | Arguments | Name to send |
|---|---|---|
| Program | program: u7 | /fm1_ctl/program |
| System identify | /fm1_ctl/system/identify |
Performance MIDI
Notes, pitch bend and any CC are also available: /fm1_ctl/note/on <note> <velocity>, /fm1_ctl/cc/<number> <value>, /fm1_ctl/pitchbend <0-16383>, /fm1_ctl/program_change <n>.
Use 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 m-vave/fm-1.vendor.fw-ctl-1.0 --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 fm1_ctl: ask “what can the M-VAVE FM-1 do?” and it reads this map with list_routes. See the MCP guide.
Limitations
CTL-1 1.0 by charlesvestal (MPL-2.0), a controller firmware for the FM-1. Licence MPL-2.0, not GPL-3.0. Channels: Out: keyboard channel set by ALGORITHM (default ch1); Euclidean drum sequencer on Seq ch (default ch10). In: all channels thru to the onboard GM synth (all 16 parts, drums ch10) unless Sound page MIDI in = Ignored. Pitch bend: Not sent. In: onboard EAS 14-bit bend, default +-2 st, RPN0 sets range (RPN1/2 tuning). Aftertouch: Out: poly aftertouch per note (default) or channel pressure from the key sensors (Touch page). In: EAS uses channel pressure as modulation; poly pressure ignored. Clock: Int (default): sends F8 24 ppqn over USB (BLE while running) and FA/FC on PLAY; Int quiet: FA/FC only; Ext: follows F8/FA/FB/FC from USB/TRS/BLE. Tempo 40-240. No SPP. MIDI out: USB + Bluetooth MIDI (BLE peripheral 'FM-1' and central to BLE devices): keys (fixed or sensed velocity, scale/chord mapping), CCs, PC, aftertouch, arp, Euclidean drums, clock. Thru: USB->BLE, BLE->USB, TRS->USB+BLE; channel + realtime messages, no SysEx. Onboard Sonivox EAS GM synth (128 GM + drum kit ch10, 24 voices) plays what it sends and what comes in. NRPN: none sent; onboard EAS ignores NRPN. CCs without a fixed number: MASTER knob CC (out: optional, Sound page sets a CC number (0 = MASTER is the onboard volume)); incoming CC on keyboard channel (in: a CC matching a bank knob's number updates that knob's stored value (follow)). SysEx `F0 00 32 45 00 00 00 40 7F F7`: M-VAVE vendor update protocol kept (felucca-bsp ota.c): identify reply = 27-byte product string (fm1.toml id_prefix + 00 dev / + XXYYZZ release); update, backup and screen mirror commands in the 00 59 framing. SysEx `F0 7D 53 52`: fm1-reader screen-reader protocol (SR): HELLO, page/knob announcements as text. SysEx `F0 7D 4C 47 F7`: development log readout (LG): crash record, rails, as ASCII frames. SysEx `F0 7D 4C 43`: remote panel control (LC): buttons, keys, encoders, master; ack F0 7D 4C 43 op F7. SysEx `F0 43`: absent: no DX7 bulk parser; other SysEx dropped. SysEx `F0 7E 7F 06 01`: absent: no Universal Identity reply. Identity: vendor identify: FM-1_6010000 for release 1.0 (FM-1_600 dev build); USB product "CTL-1 FM-1"; editor INFO: none (no F0 7D 46 4C handler); Universal Identity: none; BLE name FM-1; also ctl-usb-X.Y.fwsc build without BLE.
Firmwares
The M-VAVE FM-1 runs 94 firmwares SynthHub maps, each with its own MIDI or another's it shares. All the devices with several: firmwares.
94 firmwares
Frequently asked questions
Which MIDI CC controls the filter cutoff on the M-VAVE FM-1?
CC 74 (0–127), named /fm1_ctl/cutoff in SynthHub's map.
How many parameters of the M-VAVE FM-1 can be controlled over MIDI?
SynthHub's map of the M-VAVE FM-1 lists 18 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 M-VAVE FM-1?
Yes: SynthHub's hosted MCP server knows the M-VAVE FM-1's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.