How pfkellogg/fm1-bonus-box works
FM-1 Bonus Box combines an ESP32-S3 controller, browser-based soundbank management, and sing-on-key practice; a separate CLI manages banks over USB MIDI. The main workflow is to browse or arrange presets, save a bank, and send it to the FM-1. The current control-box sketch, USB bridge sketch, and several runtime details were not excerpted, so their links below rely on README statements where available; unsampled implementation relationships are omitted.
Main entry points: fm1_control_box.ino Control firmware · usb_midi_host.cpp USB MIDI host · web_page.h Bank web page · usb_midi_bridge.cpp USB MIDI bridge
Components 16
Control box
- Control firmware
fm1_control_box/fm1_control_box.ino - Preset display
fm1_control_box/fm1_control_box.ino
Soundbank management
- Bank web page
fm1_control_box/web_page.h - Stored bank
fm1_control_box/fm1_control_box.ino
Sing practice
- Pitch detector
fm1_control_box/pitch_detector.cpp - DOO voice data
tools/doo_voice.py
MIDI connections
- USB MIDI host
fm1_control_box/usb_midi_host.cpp - USB MIDI bridge
fm1_usb_bridge/usb_midi_bridge.cpp - Bridge firmware
fm1_usb_bridge/fm1_usb_bridge.ino
Standalone tools
- Soundbank CLI
fm1_soundbank_app/fm1_soundbank.py - Sustain footswitch firmware
fm1_sustain_footswitch.ino
Other components
- Musician
- FM-1 synthesizer
- Phone or laptop
- Microphone
- USB MIDI keyboard
Connections 19
- Musician → Control firmware: operates
README.md - Control firmware → Preset display: updates
README.md - Control firmware → FM-1 synthesizer: sends MIDI
README.md - Control firmware → Pitch detector: polls pitch
- Microphone → Pitch detector: provides audio
- Control firmware → DOO voice data: selects voice
- Phone or laptop → Bank web page: uses
README.md - Bank web page → Stored bank: saves bank
fm1_control_box/web_page.h - Control firmware → Stored bank: reads bank
README.md - Control firmware → FM-1 synthesizer: sends banks
README.md - USB MIDI keyboard → USB MIDI host: sends events
- Control firmware → USB MIDI host: reads packets
- USB MIDI host → FM-1 synthesizer: forwards MIDI
README.md - Bridge firmware → USB MIDI bridge: starts
- USB MIDI bridge → FM-1 synthesizer: bridges USB MIDI
- Musician → Soundbank CLI: runs commands
fm1_soundbank_app/fm1_soundbank.py - Soundbank CLI → FM-1 synthesizer: sends banks
fm1_soundbank_app/fm1_soundbank.py - Musician → Sustain footswitch firmware: presses pedal
- Sustain footswitch firmware → FM-1 synthesizer: sends sustain