Tools

Tools for building, installing, recovering and inspecting. Each links to its source; check its README for the current state.

Toolchains

Tool Notes
JieLi Linux toolchain (clang 4.0.1, pi32v2) https://pkgman.jieliapp.com/s/linux-toolchain; m-bootloader pins 20250324.1 by SHA-256
JieLi Windows toolchain 2.5.3 used by FM1 Open; C:\JL\pi32
pi32v2-llvm / pi32v2-isa open assembler, linker, objdump and LLVM; builds FM-1 firmwares that run on hardware
mvave-fm1 mvave-build.sh podman image with the JieLi toolchain and SDK files, hash-pinned; builds Felucca-family firmwares unchanged (Getting Started)

Packaging and installing

Tool Notes
fm1pkg.py / fm1pkg_make.py (felucca-bsp, Felucca) builds a .fwsc from an app and a loader (Firmware Package Format)
fm1_install.py (felucca-bsp, Felucca, fm1-base) USB-MIDI installer; --info reads the identity
Web installers (Felucca family, fm1-base) Chrome/Edge, Web MIDI with SysEx
M-UPGRADE (M-VAVE) official updater, Windows/macOS
fm1-linux-update stock updates from Linux
Slipway Windows: firmware list and installer
FM1Kit Swift: install from iOS/macOS
fm-static web installer for units with odd MIDI port names
TransitFM1 silent stopover firmware between two custom firmwares; answers as V15, writes the next firmware first sector last (Update Protocol and Installers)
FM-1-RE tools/fm1_ota.py the stock update protocol from Python
fm1-firmware-patcher (Unlicense) binary patches of stock V15 and V16 (detune, aftertouch, colours); the patched file may not be shared
FM-1 Macropad Patch (MIT) patch of stock V15: every input sends a USB-MIDI note

Recovery and flash access

Tool Notes
M-Flasher backup, restore, install, bootloader install; Windows, macOS, Linux
FM-1 Transporter RP2040 dongle: USB_KEY plus flash read/write
jl-uboot-tool JieLi flasher and dumper; source of wl82loader.bin
MvaveFM1Unbricker soft-brick recovery over a plain cable; double-read full backup; Linux and Windows for flash work (no macOS SCSI back end), softkey on macOS too (Recovery)
flipper-fm1-recovery Flipper Zero as the USB key
fm1_rescue (Felucca family, felucca-bsp) macOS: stock V15 back through download mode

Inspecting

Tool Notes
objdump -d (JieLi or pi32v2-isa) look up a crash PC
fm1_debug.py (fm1-x0x debug builds) register peek/poke, clock loop
fm1_remote.py (fm1-base) drive the panel and read the screen over USB
RemoteFM1 the FM-1 as a USB/Bluetooth panel for a firmware running on the computer (Simulators and Emulators)
jl-misctools JieLi containers and key files
Ghidra + ghidra-jieli disassemble stock firmware
Emulators see Simulators and Emulators
tools/fm1_bootarea.py (kmplngj/Felucca) offline, read-only: names a dump’s or package’s boot area (V15, V16, m-bootloader), checks CRCs, reads the chip key and the declared clock
tests/mul64_hload_check.py (kmplngj/Felucca) scans a build’s disassembly for 64-bit multiplies next to 16-bit loads, the erratum’s pattern (Performance)
tools/fm1_diagnostics.py (kmplngj/Felucca) read-only collector of a device’s health, input, crash and boot-clock data over the USB serial console
tools/provenance.py (fm1-base) finds lines copied from Felucca in a project, for relicensing (fm1-base as a Base)
AI assistant skills see AI Skills

Unofficial community wiki. Not affiliated with M-VAVE or JieLi. Text under CC BY-SA 4.0; code excerpts keep their own licences (License). Facts are tagged [HW] [SDK] [RE] [CODE] [?]: see Home. Found an error? See Contributing. Home