Tools for building, installing, recovering and inspecting. Each links to its source; check its README for the current state.
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