Skip to content

HOWTO Update Firmware

rusefillc edited this page Mar 31, 2026 · 20 revisions

How to Update Firmware

Disconnect it from the vehicle. Use caution.

Download the rusEFI bundle for your hardware.

Windows

Launch rusEFI Console. You can find it in the bundle you downloaded, in the "console" folder.

Click the "Update Firmware" button once you've picked desired update mode.

Linux

TODO one day we need to fix rusEFI console (unless it works as is?) for OpenBLT to be happily available.

DFU is a bit dangerous. At some point we've decided not to include .DFU files into the bundles.

You will need dfu-util:

# Debian/Ubuntu
sudo apt install dfu-util
# Arch/Manjaro
sudo pacman -Syu dfu-util

Once you have dfu-util, you can run this from the extracted bundle directory:

java -jar console/rusefi_console.jar reboot_dfu

dfu-util -a 0 -D rusefi.dfu

DFU mode

These days normal firmware update should be happening via more modern OpenBLT approach. We only use DFU in case of emergency. It shouldn't blink in DFU mode. When in DFU mode, we expect to see "STM32 BOOTLOADER" in device manager.

image

Troubleshooting

Does blue LED close to main processor blink? If nothing is blinking after power cycle, things are pretty broken. Next step is power cycling while holding "PROG" button to enter STM32 DFU mode.

What's the status of red LED close to main processor?

Corrupted Option Bytes

It looks like firmware versions between October 2025 and January 2026 were fragile in case of less than ideal power supply during calibration updates or firmware updates. If "STM32 BOOTLOADER" does not appear in device manager it should be there, the only next step is ST-LINK restoration via TC-2030 programming cable.

Some technical details at https://github.com/rusefi/rusefi/issues/8926

FAQ

Q: Device is under Read Out Protection or Target is held under reset

A: sometimes write operations glitch and lock the unit. You would need to enable DFU mode, and then run console\STM32_Programmer_CLI\bin\stm32-remove-read-out-protection.bat batch file, and then manually flash firmware in DFU mode.

Q: I got "DRIVER ERROR"
A: In rusEFI console please hit "Device Manager". When ECU gets into DFU mode (blue LED stops blinking) you are expected to see a "STM32 Bootloader" device. If you see "STM device in DFU mode", please uninstall it and remove the old driver.

Bad

x

Good

x

More Information

For more about DFU see HOWTO-DFU.

ST-LINK is an advanced mode of firmware update which requires ST-LINK device, either external or built-in like on Discovery and Nucleo boards.

Update TunerStudio Definition

Once you have updated your firmware, you also need to update your TunerStudio definition so it is able to communicate properly. A happy installation of TunerStudio will download the current .ini file automatically!

If you chose to do it manually, you can find the .ini file in the USB storage device that rusEFI board presents to your computer, or in the rusEFI bundle.

Clone this wiki locally