Known Projects
Projects that hold developer knowledge: bases, references and specifications. For the full list of firmwares, editors and tools, see awesome-fm-1, the FM-1 resource hub, the FM-1 Firmware Database and the FM-1 Firmware Atlas. Licences and descriptions are from each project’s README (October 2026).
Bases and platforms
| Project | Licence | What |
|---|---|---|
| Felucca (Leo Kuroshita, Hügelton Instruments) | GPL-3.0 | The first big open firmware; the origin of most community platform code |
| felucca-bsp | MPL-2.0 | The chip and board layer split out of Felucca, beta |
| fm1-base (Charles Vestal) | MPL-2.0 | A platform and template on felucca-bsp, with host simulator, browser emulator, BLE MIDI, WiFi, USB audio, velocity and pressure, second core; beta. See fm1-base as a Base |
| Dinghy | GPL-3.0 | The smallest documented firmware to build on |
| foma | GPL-3.0 | One C file, Docker, a WebAssembly preview and installer on one page |
| fm1-nes | Apache-2.0 | Source-only integration with JieLi’s SDK; app-only updates |
| FM1 Open (M-VAVE) | GPLv3 + SDK linking exception | M-VAVE’s open app with a binary engine SDK |
| smk37_open (M-VAVE) | as above | The same for the SMK-37 |
| Optimist | GPL-3.0 | A modular firmware platform from SLOOP / Felucca |
Specifications and reverse engineering
| Project | Licence | What |
|---|---|---|
| m-bootloader and its SPEC.md | MIT | Clean-room bootloader; the spec is the most complete public description of boot, flash formats, keys and panel |
FM-1 resource hub REVERSE_ENGINEERING.md | none declared | Pin-by-pin package map from board photos and JieLi’s datasheet, the stock updater’s internals, protocol notes, case opening; mixes FM-1 facts with generic AC79 material (e.g. 4–8 MB flash), so check each point |
| FM-1-RE | WTFPL | Analysis of the stock firmware: architecture, memory map, OTA protocol, Ghidra scripts |
| pi32v2-isa | MIT-0 | The instruction set as a table, an open assembler/linker, and an LLVM fork that builds FM-1 firmware |
| fm1-bootloader | Apache-2.0 | The stock bootloader, readable C |
| jielie (kagaimiq) | Reference site for JieLi SoCs; USB_KEY notes | |
| ghidra-jieli | Ghidra processor module for pi32v2 | |
| JieLi AC79 SDK and docs | Apache-2.0 | The vendor SDK (Chinese docs) |
Firmwares with notes worth reading
Many firmwares document hardware lessons in their own docs. Some that have shaped this wiki:
- fm1-x0x: debug builds for register reads, second-core use; issues #10 (core 1 misreads) and #21 (voltages).
- Melodee: the second-core worker, USB MIDI host.
- SLOOP: a groovebox on both cores.
- Jangada: core supply raising; measured the core-1 misreads.
- fm1-radio: WiFi, HE-AAC; found the 64-bit multiply erratum.
- Lunar Modulator: a USB_KEY dongle write-up.
- Dinghy:
docs/RULES.md, the integer-only rules and the build checks (64-bit division, ROM addresses, registers outsidehal/); the div-by-zero trap left off. - TransitFM1:
docs/SAFETY.md, power-cut tests of every flash operation of an install; where V15 stages its loader. - ORBIT (SLOOP lineage): explicit “tested on hardware or not” release notes.
- kmplngj/Felucca: dated investigation notes with exact images (deadline misses, the second core’s idle polling, display power), diagnostics and agent workflows (AI Skills).
- mvave-fm1: AI skills and a build container (AI Skills).
- DUB-1: CPU-load notes on XIP and the cache, clock registers on a settings page.
Add yours: see Contributing.
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