Jump to content

Firmware: Difference between revisions

From epicEFI Wiki
← Older edit
Ogalic (talk | contribs)
Bureaucrats, Interface administrators, Administrators
320 edits
VisualWikitext
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
This is my first wiki page. Yay!
= What is this? =
epicEFI is a fork of the open source electronic fuel injection firmware [https://rusefi.com/ ruseEFI]. The firmware was forked to enable more agile software development and to introduce more features than the mainline firmware offers.
 
= Obtaining the firmware =
To download the firmware, you must first know what hardware you have and its respective '''internal name'''.
 
If you are not sure what hardware you have, navigate over to [[Hardware#List of supported hardware|the list of supported ECUs]] and verify what ECU you have and its internal name. The specific internal name and physical hardware are not always 100% clear and you need to select the hardware you actually have.
 
If you have a [[Hardware#epicECU|epicECU]], the internal name is '''epicECU.'''
 
When you have the internal code:
 
* Navigate to the [https://content.epicefi.com/firmware/ firmware downloads] page and download the zip file containing your internal code from the '''latest''' fold
** For example, for epicECU that would be '''rusefi_bundle_epicECU.zip'''
* Extract the firmware bundle
* Locate the '''rusefi.bin''' file (the firmware) and the '''rusefi_''code''.ini''' file (the TunerStudio definition file)
* Now you can [[Firmware#Updating the firmware|update the firmware]]


== What is this? ==
= Updating the Firmware =
epicEFI is a fork of the open source electronic fuel injection firmware [https://rusefi.com/ ruseEFI]. The firmware was forked to enable more agile software development and to introduce more features than the mainline firmware offers.
The firmware update process is done using a online tool leveraging [https://developer.mozilla.org/en-US/docs/Web/API/WebUSB_API WebUSB]. The online flash tool also has support to download a backup of the internal flash if there were breaking changes in the firmware.
{{Warning|The online update utility requires Google Chrome and other browsers are not supported}}
 
== Using the online flash tool ==
'''Step 1.''' Navigate to the [https://content.epicefi.com/flash/ epicEFI Online Flash Tool].
 
'''Step 2.''' Put the ECU into ''DFU (Device Firmware Update) Mode''
 
This can be done in two ways - '''Automatically''' and '''Manually.'''
 
* '''Automatically'''
** Close TunerStudio
** Click '''Connect'''
** Click '''Identify ECU''' and verify that the correct ECU information is displayed
** Click '''Reboot to DFU'''
** The ECU is ready, proceed to Step 3
* '''Manually'''
** Unplug the ECU from the computer
** Disassemble the ECU and locate the '''PROG''' or '''BOOT''' button
**While holding down the '''PROG''' or '''BOOT''' button, connect the USB cable
**The ECU is ready, proceed to Step 3
'''Step 3.''' Select the firmware package and upload it
 
* Click '''Connect to DFU'''
* Select the correct interface, should be ''"@Internal Flash /0x08000000/"'' or something similar. Usually the first option
** Optional: Backup the internal flash using the '''Download ECU Backup button'''
* Click '''Choose File''' and select the [[Firmware#Obtaining the firmware|previously downloaded rusefi.bin file]]
* Click '''Write new firmware''' and wait for the firmware update to finish
* Click '''Disconnect''' and power cycle the ECU
* Your ECU is now updated.
 
=== Updating the TunerStudio definition file ===
If the project used a older firmware version and you are not creating a '''new''' project, the existing project will need to updated to use the new definition file.
 
* Open TunerStudio and connect to the ECU
* Open the '''existing''' project from the '''File → Vehicle Projects''' menu
 
* Once the project is open, open '''File → Vehicle Projects → Project Properties'''
 
[[File:Properties.jpg|border|300x300px]]
 
* Click the '''checkbox''' next to '''Other/Browse''' and select the [[Firmware#Obtaining the firmware|previously downloaded definition file]]
 
[[File:Other-browse.jpg|border]]
 
* Your project definition file is now updated

Latest revision as of 14:04, 15 January 2026

What is this?

epicEFI is a fork of the open source electronic fuel injection firmware ruseEFI. The firmware was forked to enable more agile software development and to introduce more features than the mainline firmware offers.

Obtaining the firmware

To download the firmware, you must first know what hardware you have and its respective internal name.

If you are not sure what hardware you have, navigate over to the list of supported ECUs and verify what ECU you have and its internal name. The specific internal name and physical hardware are not always 100% clear and you need to select the hardware you actually have.

If you have a epicECU, the internal name is epicECU.

When you have the internal code:

  • Navigate to the firmware downloads page and download the zip file containing your internal code from the latest fold
    • For example, for epicECU that would be rusefi_bundle_epicECU.zip
  • Extract the firmware bundle
  • Locate the rusefi.bin file (the firmware) and the rusefi_code.ini file (the TunerStudio definition file)
  • Now you can update the firmware

Updating the Firmware

The firmware update process is done using a online tool leveraging WebUSB. The online flash tool also has support to download a backup of the internal flash if there were breaking changes in the firmware.

The online update utility requires Google Chrome and other browsers are not supported

Using the online flash tool

Step 1. Navigate to the epicEFI Online Flash Tool.

Step 2. Put the ECU into DFU (Device Firmware Update) Mode

This can be done in two ways - Automatically and Manually.

  • Automatically
    • Close TunerStudio
    • Click Connect
    • Click Identify ECU and verify that the correct ECU information is displayed
    • Click Reboot to DFU
    • The ECU is ready, proceed to Step 3
  • Manually
    • Unplug the ECU from the computer
    • Disassemble the ECU and locate the PROG or BOOT button
    • While holding down the PROG or BOOT button, connect the USB cable
    • The ECU is ready, proceed to Step 3

Step 3. Select the firmware package and upload it

  • Click Connect to DFU
  • Select the correct interface, should be "@Internal Flash /0x08000000/" or something similar. Usually the first option
    • Optional: Backup the internal flash using the Download ECU Backup button
  • Click Choose File and select the previously downloaded rusefi.bin file
  • Click Write new firmware and wait for the firmware update to finish
  • Click Disconnect and power cycle the ECU
  • Your ECU is now updated.

Updating the TunerStudio definition file

If the project used a older firmware version and you are not creating a new project, the existing project will need to updated to use the new definition file.

  • Open TunerStudio and connect to the ECU
  • Open the existing project from the File → Vehicle Projects menu
  • Once the project is open, open File → Vehicle Projects → Project Properties

  • Your project definition file is now updated
Retrieved from "https://content.epicefi.com/wiki/index.php?title=Firmware&oldid=189"