This guide explains the importance of keeping VESC firmware up to date, how to perform firmware updates safely and the potential risks involved.
DISCLAIMER: The VESC Bible is currently being republished and rewritten to encompass all necessary beginner guides. All guides with a beta tag are still preliminary and need to be vetted and reviewed by VESC experts.
Performing Firmware Updates Safely
Unexpected Changes and Bugs: It is crucial to note that VESC firmware updates can sometimes introduce unforeseen changes and bugs that can cause problems with certain hardware configurations.
For example, firmware version 6.5 brought issues for users with Spintend controllers and momentary switches, and a bug in the VESC Tool app could reset settings to default
Therefore, it is strongly recommended to wait until the firmware has been thoroughly tested and reviewed by experienced community members before upgrading.
What you need to perform the update
- Correct VESC firmware files: VESC Firmware files - where to find the latest versions
- Stable bluetooth connection:
- Latest VESC App version
Safe Update Procedure (First timers and beginners)
If you’re not sure or it’s your first time, follow all steps here, otherwise see Minimal Procedure below…
- Backup your settings. Before updating, back up your current motor, app, and package configurations using the VESC Tool app. This will protect your current settings and allow you to restore them if needed.
- Disable (Re)Float Package: Go to Float Cfg, enable the “Disable Package” setting and hit the Write button
- UBOX only: Use a latching switch. Using a latching switch (instead of a momentary switch) during the update process is crucial to prevent accidental interruptions that could damage your controller. If your board uses a momentary switch, make sure to increate the auto shut off timer to 30min or disable if possible.
- Download the correct firmware. Make sure to download the firmware file that is compatible with your specific VESC hardware. The VESC firmware archive is a good place to find the right file.
→ You can find latest versions here: VESC Firmware files - where to find the latest versions - Verify the file integrity. Ensure that the downloaded firmware file is complete and undamaged. It is also advisable to rename the file to clearly identify it and avoid any confusion during the upload process.
- Update the bootloader if necessary. You may need to update the bootloader on your VESC before installing the new firmware. Use the generic bootloader provided in VESC Tool.
- Start the firmware update. Connect to your VESC with the VESC Tool app. In the firmware update section, select the correct firmware file and start the upload.
- Do not interrupt the update. It is essential to avoid interrupting the update process. Interruptions can lead to corrupted firmware and may brick your VESC.
- Confirm the update. After the update is complete, check if the VESC Tool displays the correct firmware version. If it doesn’t, you might need to update the bootloader.
- Rerun the motor wizard or perform a manual motor calibration. This step ensures optimal motor performance and accounts for any changes in motor detection parameters introduced by the new firmware.
- Update the package. Update the (Re)Float) package to the latest version. Package updates are available in the VESC Tool app.
- Restore your settings. After the firmware update, restore the configuration settings you backed up earlier. Double-check that all settings are restored correctly.
Minimal Procedure (Advanced Users)
- Backup Config - there’s a dedicated button for this on the main page of the VESC App
- Load Firmware - make sure the file is the right one so you don’t brick your controller (see here)
- Once done, reconnect to your board in the VESC App (don’t power cycle it!!)
- Load the same package again you used before
- Once the Package Cfg Tab shows up, Hit the Restore Config button on the Start Tab
Troubleshooting / FAQ
I can’t connect from the VESC Desktop App
Use tunnel connection via VESC Mobile App. See our guide below:
Any other issuer?
If you experience any issues during the firmware update process, you can ask for help here:
- PEV.dev: You can use our search and create a new topic in Help Desk
- VESCify Discord: Go into the
#issueschannel and provide all detailed information aroud your issues - YouTube channels: Channels like “surfdado” and “The Board Garage” frequently provide tutorials and guides on various VESC-related aspects, including firmware updates.
By carefully following these instructions and utilising available resources, you can safely update your VESC firmware and take advantage of the latest features and performance improvements. Always err on the side of caution, and if you have any doubts, consult with the community before proceeding.
