MIDI and sync

Groove OS listens to MIDI over USB, Bluetooth and the TRS MIDI jack, and sends it over USB and Bluetooth. Each track has its own MIDI channel, so a controller or a DAW can play and record any track. The FM-1 can send its clock to a drum machine, or follow someone else's. A track can play an external synth instead of a sound. Control changes drive the panel, and Program Change picks sounds. Over USB, a web page can also follow the FM-1 and play its panel.

Ways in and out

Notes, controllers, Program Change, clock and DX7 SysEx come in the same way from all three. Remote control, the website's transfers and updates run over USB only.

In this beta: the TRS jack is in the code but has not yet been proven on a unit.

Where the settings are

Channels

Track 1 listens on channel 1, track 2 on channel 2, and so on: tracks 1 to 4 start on channels 1 to 4, and a new track takes the next free channel. SETTINGS > MIDI > MIDI CH shows the first track's channel and the range (1-4 with four tracks) and moves them all together; a track's own MIDI CH changes just that track (each channel reaches one track).

SETTINGS > MIDI > SYNTH CH (ALL or 1 to 16) changes none of this: bend and controllers always follow the selected track's channel.

A note-off always takes the way its note-on took, so a held note never sticks when you change tracks.

Pro tip: a MIDI keyboard or a DAW clip is a good way to record a part that is hard to play on the FM-1's short keybed. Press REC, then play from the controller, on the channel of the track you want.

Clock

MIDI CLOCK has three modes:

With EXT:

• The FM-1 follows the clocks themselves, not only their tempo: every clock moves it on a 24th of a beat, so it stays with the leader for as long as you play. Clocks that come unevenly, late, or several at once (a computer over USB often sends them that way) still keep it in step. There is no drift: with a drum machine, or with a DAW over USB, the bars stay lined up however long you play.
• The BPM on the screen shows the leader's tempo, with its small wobbles smoothed out.
• Start starts the music from the top on the next clock.
• Continue after a Song Position waits for the sender to reach the start of the FM-1's next loop, then starts from the top so the two line up.
• Stop stops the music.
• If the clock stops for a quarter of a second the FM-1 keeps the last tempo and runs on it. When the clock comes back, it falls in step again on the nearest clock.
• The tempo cannot be set by hand: the tempo controls say TEMPO: MIDI CLOCK.

Clock out goes over USB MIDI, and over Bluetooth when a device is linked; nothing is sent out of the TRS jack. If another device does not follow it, make the FM-1 the follower (EXT) instead.

CLOCK IN

With more than one way in for a clock, SETTINGS > MIDI > CLOCK IN says which one EXT follows:

The other way's clock, start, stop and song position are ignored, so they never count. Notes and controllers from every way still come in.

In this beta: CLOCK IN is in the code but has not yet been proven on a unit. If EXT does not follow a clock, set CLOCK IN to AUTO.

MIDI OUT tracks

A track whose engine is MIDI OUT plays another instrument instead of a sound. Everything the track plays (its recording, its pattern, the arpeggiator and your keys while it is selected) goes out as MIDI notes on its output channel, set in TRACK menu > MIDI OUT CH (K4 MIDI CH on TRACKS is the same value). The track still has its MIDI CH too: that is the channel it listens on, as for every track.

To make one, choose ENGINE ▸ MIDI OUT in a sound track's TRACK menu. A MIDI OUT track has no sound, so there is no sound editor for it; K1 to K4 on TRACKS are its LENGTH, OCTAVE, TRANSP and MIDI CH. A note always ends on the channel it started on, even if you change the channel or the engine while it sounds.

Careful: a kit track cannot be MIDI OUT, and MIDI OUT tracks have no parameter locks. Output goes out over USB, and over Bluetooth when a device is linked.

Program Change

A Program Change on the selected track's channel loads a sound onto the selected track, as the browser does:

The sound's macros come with it. A program on a VA slot is ignored: Program Change loads FM sounds. A Program Change is ignored while the browser is open, and on a kit track the screen says KIT TRACK: NO PROGRAM CHANGE. Program Changes on other channels are dropped.

Control changes: the panel

A control change on any track's channel drives the panel, as if you touched the control:

The panel CCs only reach Groove OS screens. There is no CC for SAVE.

Effects over MIDI

Set SETTINGS > MIDI > FX CC CH to a channel from 1 to 16 (it is OFF by default) and control changes 0 to 23 on that channel drive the six effects' parameters, fade-free. Each effect takes four CCs, in the order of the FX editor: the first switches it on (any value above 0) or off (0), the others are its values (a filter's or reverb's second CC is its type, 0 to 2). A value is the parameter's own number: 0 to 100 for most, 0 to 107 for the filter's cutoff and 0 to 10 for its resonance; larger numbers are held at the top.

Sounds over SysEx

DX7 voices and banks you send become track sounds. See Sending DX7 sounds.

Remote control over USB

A web page or an app on your computer can follow the FM-1 and play its panel over the USB cable (Chrome or Edge on the computer side). While one is linked (a page playing the panel), a small link mark sits in the header of every view, left of the unsaved square, so you always know when something else has a hand on the panel.

Remote input goes through the same path as your own hands, so everything that guards the panel guards it too: PERFORM's stage lock, the questions, a save in progress. You can keep playing while it is connected.

The link ends when the page says goodbye, or by itself a few seconds after the page goes quiet (a closed tab, a pulled cable): the link mark goes with it. Nothing needs switching on or off on the FM-1.

Careful: the link mark shows for as long as a page is linked, whether it only follows along or presses the controls too. What a page presses can be undone as your own presses can, with HOME+REC; a save cannot.

For app writers, the wire is documented in the repository's docs/REMOTE.md.

Bluetooth

Bluetooth MIDI is a row in SETTINGS, on or off, with no pairing. Turn SETTINGS > BLUETOOTH on (BLUETOOTH ON: FM-1) and a computer or phone lists the FM-1 as FM-1 Groove in its Bluetooth MIDI setup or in a MIDI app; link to it from there. The row reads FM-1 while it waits and FM-1 LINKED once a device is linked, one at a time. See BLUETOOTH in SETTINGS.

A linked device plays and records on the tracks' channels like any controller, can send the clock (it counts as TRS for CLOCK IN), and receives what the FM-1 sends: the notes of MIDI OUT tracks and the clock.

Troubleshooting