You need
- An M5 Cardputer (the ADV, or the original), and a microSD card in it (FAT32).
- A powered USB hub (or a USB-C OTG adapter with a charging port), for the FM-1 and your MIDI controllers. For recovering an FM-1 that won't start, a USB-C cable straight to it.
- A computer and a USB-C cable that carries data, or just Wi-Fi if you use M5 Launcher
The easy ways
- M5 Launcher, over Wi-Fi: in its OTA menu, find CardBuddy and install it. Launcher stays on the Cardputer, and cardbuddy is an app like any other there. See the M5 Launcher tab.
- M5 Burner, M5Stack's desktop app: in its Cardputer list, find CardBuddy (by konsumer), Download, then Burn, with the Cardputer in download mode (step 1 below). Like this page, it replaces what's on the Cardputer's flash.
Or install it from this page, in Chrome or Edge:
1. Download mode
- Switch the Cardputer off (the switch on its side). This matters: plugged in while it's on, it can't be programmed.
- Plug it into this computer with the USB-C cable.
- Hold its G0 button, switch it on, then let go. The screen stays dark: that's download mode.
No port to pick? Do this again: it has to be off before you plug it in. Running cardbuddy, the Cardputer's USB-C port is a USB host (for the FM-1 and your controllers) unless a computer is on it as it starts, so a Cardputer plugged in while it's on shows no port. Download mode always does. Still nothing: try another cable (some only charge), and on Linux, check you can use serial ports (the dialout group).
2. Install
Press Install, and pick the Cardputer's port (USB JTAG/serial debug unit, or similar). Let it erase the first time.
This replaces what's on the Cardputer's flash, M5 Launcher too. The SD card isn't touched.
No build yet: the page has no firmware next to it.
3. Start it
When it's done, switch the Cardputer off and on again (or press its reset button). cardbuddy starts, and makes its folders on the SD card the first time.
4. Firmwares
Two ways to get them:
- From the Hub, over Wi-Fi: set it up in Settings > Wi-Fi, then Firmware: Hub has every FM-1 firmware on mutant.cloud.
- From your computer: put
.fwscfiles in/fm1on the SD card. USB disk on the Cardputer makes the card a drive on your computer (it comes back by itself when you eject it), or use a card reader.
M5 Launcher keeps several apps on the Cardputer and starts the one you pick. cardbuddy is one of them: the Cardputer can run other things when you don't need it.
Over Wi-Fi
- In Launcher: OTA, and connect to Wi-Fi if it asks.
- Find CardBuddy (by konsumer): search for it, or look in the Cardputer list. It's the same one as in M5 Burner.
- Pick it, then Install. Launcher starts it.
From the SD card
No Wi-Fi, or you want a build that isn't in the list yet:
- Get
cardbuddy.bin: the latest release. - Copy it onto the Cardputer's SD card (anywhere: the card's top level is fine).
- In Launcher: SD, pick
cardbuddy.bin, then Install. Launcher starts it.
Launcher shows its own screen for a moment each time the Cardputer starts: press a key then to get back to it, and pick something else.
Getting around
| move | ; . , / (the arrows on the keys) |
| open, pick | enter |
| back | esc (fn + these while typing) |
| find a firmware | just type, in a firmware list |
| SD card's list / the Hub's | tab |
Install a firmware
- Plug a powered USB hub into the Cardputer's USB-C port, and the FM-1 (switched on) into the hub.
- On the Cardputer: Firmware: SD card (or Firmware: Hub), pick one,
enter. - cardbuddy sends the FM-1 into its boot loader and writes it. If it asks, switch the FM-1 off, then on.
- The FM-1 restarts with its new firmware.
Back up and recover
- Backup & recover saves the FM-1's whole flash to
/backups. Do this first, before trying firmwares. - An FM-1 that won't start: plug it straight into the Cardputer (no hub), pick a firmware or a backup to bring it back with, and switch the FM-1 on when cardbuddy says. The flash map is drawn on both screens as it goes.
Everything else
- Sounds: send
.syxbanks, save the stock firmware's voice, keep and load fomajam's songs and kits, SLOOP backups, projects, songs and samples (.wav). - MIDI: the devices on the hub, routing between them (
r, with/midimap.txt: make one on fm1buddy's MIDI map page), Bluetooth MIDI (b). - Keys: the keyboard as a MIDI controller, two octaves laid out as in trackers (
z s x d c v… andq 2 w 3 e r…),-=octave,[]channel. - USB disk: the SD card as a drive on a computer.
- Settings: Wi-Fi, theme, brightness, Bluetooth MIDI, USB MIDI on a computer.
The SD card
/fm1 |
firmwares (.fwsc) |
/backups |
the FM-1's whole flash |
/syx |
sounds (.syx, DX7 banks) |
/setups |
setups, fomajam's kits |
/sloop |
SLOOP backups, songs/, samples/ |
/recordings |
WAV recordings |
/midimap.txt |
MIDI routing |
/fm1buddy |
the Hub's list, logs (cardbuddy-log.txt) |
Nothing is written to the FM-1 until you pick something, and its boot loader is in its ROM: nothing here can make it unrecoverable.
How it works, and the code: cardbuddy. Its bigger sibling, with a touch screen: fm1buddy.