USB fix: put the firmware back
For an FM-1 with a black screen that shows up on the computer as WL82 UBOOT1.00. This is the most common fix.
-
Get these ready
- The FM-1, charged.
- A USB cable that carries data. Some cables only charge; if nothing shows up later, try another cable.
- A Windows 10 or 11 computer.
- A Mac with macOS 11 or newer (Apple silicon or Intel), and your Mac password.
- A Linux computer or a Raspberry Pi.
- An internet connection (only for the setup).
-
Install Python (free)
Python is the program that runs the rescue tool. Download it from python.org/downloads and run the installer. On the first screen, tick "Add python.exe to PATH", then click Install Now.
-
Check that Python is there
Open the Terminal app (Applications → Utilities) and type:
python3 --version
Anything from
Python 3.9up is fine. If your Mac offers to install the "command line developer tools" instead, click Install, wait, and try again. Or install Python from python.org. -
Check that Python is there
Most Linux systems and Raspberry Pi OS already have it. Open a terminal and type:
python3 --version
Anything from
Python 3.9up is fine. -
Download the rescue tool
Open your Downloads folder, right-click MvaveFM1Unbricker-main.zip, choose Extract All…, then Extract. You now have a folder with a file called
fm1_unbrick.pyinside.Your Mac unzips it in Downloads by itself (if not, double-click it). You now have a folder
MvaveFM1Unbricker-mainwithfm1_unbrick.pyinside.Unzip it in your Downloads folder (double-click it, or
unzip MvaveFM1Unbricker-main.zip). You now have a folderMvaveFM1Unbricker-mainwithfm1_unbrick.pyinside. -
Get the official V15 firmware
M-VAVE no longer offers V15, but a copy is kept here:
Move it into the same folder as
fm1_unbrick.py. Keep its name,V15-FM-1.fwsc: the commands below use it (if your browser saved it asV15-FM-1 (1).fwsc, rename it).iThe tool recognises the official V15 file by its and refuses a damaged or fake one, so it doesn't matter where you got it.
!Only have V16 from M-VAVE's site? This fix refuses it on purpose: V16's firmware is longer than what this fix writes. Use V15 here and update to V16 afterwards, or use the Bootloader fix, which can write V16 completely. Why?
-
Connect the FM‑1
Switch the FM-1 on (the screen stays black, that's expected) and plug it straight into the computer, not through a USB hub or dock.
!If Windows asks to format a disk, click Cancel. That "disk" is the FM-1's rescue mode. Never format it.
!If your Mac says the disk is not readable, click Ignore, never Initialize. That "disk" is the FM-1's rescue mode.
-
Open PowerShell as administrator
Open a terminal
Open Terminal
Right-click the Start button and choose Terminal (Admin) or Windows PowerShell (Admin). Click Yes when Windows asks. "Admin" matters: the tool needs it to talk to the FM-1.
Open the Terminal app. You'll type a few commands; the tool will ask for your password when it needs it.
Open the Terminal app. You'll type a few commands; when one asks for your Password, type your Mac password (nothing shows while you type, that's normal) and press Enter.
Then go into the tool's folder. Copy this, paste it in the window and press Enter:
cd "$HOME\Downloads\MvaveFM1Unbricker-main\MvaveFM1Unbricker-main"
cd ~/Downloads/MvaveFM1Unbricker-main
cd ~/Downloads/MvaveFM1Unbricker-main
i"Cannot find path"? Your folder is somewhere else. Open the folder that contains
fm1_unbrick.pyin File Explorer, click its address bar, copy it, and typecd ", paste,", Enter."No such file or directory"? Type
cd(with a space), drag the folder that containsfm1_unbrick.pyinto the terminal window, and press Enter. -
Set up the tool (once)
This downloads the helper that talks to the FM-1's chip. It takes a minute.
py fm1_unbrick.py setup
python3 -m venv .venv .venv/bin/python fm1_unbrick.py setup
python3 -m venv .venv .venv/bin/python fm1_unbrick.py setup
-
Run the fix
py fm1_unbrick.py restore V15-FM-1.fwsc
sudo modprobe sg sudo .venv/bin/python fm1_unbrick.py restore V15-FM-1.fwsc
sudo .venv/bin/python fm1_unbrick.py restore V15-FM-1.fwsc
!On a Mac, be quick. macOS lets the FM-1 slip out of rescue mode after about half a minute, so run this soon after plugging it in. If your FM-1 still starts a firmware (it isn't dark), this one line asks for your password first, then sends it into rescue mode and starts the fix at once:
sudo -v && .venv/bin/python fm1_unbrick.py softkey --yes && sudo .venv/bin/python fm1_unbrick.py restore V15-FM-1.fwsc
The tool checks it's talking to an FM-1, then reads the whole memory twice and saves a backup in the
backupsfolder. Then it shows what it's about to do and asks you to confirm:What you'll see (shortened)Backup OK backups/fm1-recovery-…/full-flash-before.bin About to WRITE the FM-1 flash: package V15-FM-1.fwsc identity FM-1_015 = official M-VAVE V15 (sha256 verified) Type WRITE to continue (anything else cancels):Type WRITE in capitals and press Enter. It writes, then reads everything back to check it. Don't unplug anything while it works.
-
Restart the FM‑1
When it says Done:
- Unplug the USB cable.
- Switch the FM-1 off.
- Wait 5 seconds.
- Switch it on. 🎉
Keep the
backupsfolder. If you used a custom firmware (Felucca, ChoralRoot…), your songs and settings from before are in it.iStill black after a fix that said Done? Then the firmware wasn't the problem: the probably is. Go to the Bootloader fix.