FluidNC Firmware Upgrade - Spark-Concepts/xPro-V5 GitHub Wiki

Upgrading Firmware

FluidNC installation instructions:

Go to the FluidNC project page on Github
- Click on the releases link on the right side of the page.
- Click on the release that you want. You should generally use the latest non "Pre" release.
- Download the zip file for your operating system (win64 for Windows and posix for Linux and Mac) from the Assets section of the release. You do not need to download the source code to use pre-compiled files.
- Unzip it in a folder on your computer. Do not try to run from inside the zip file. Make sure it is fully extracted before you start. On some operating systems, like Windows, the folder should be on local drives, not a networked folder.
Connect the ESP32 via USB. It is best to remove all other USB/Serial devices while installing it because it might try the wrong one.

*For first time installation of FluidNC, skip to First time install

Update FluidNC (currently running FluidNC)

Run either install-wifi.bat or install-bt.bat (.sh on other OS's). Make sure you are running the script while in that that folder.

First time install

Open FluidNC folder and Run erase.bat

For subsequent steps each and every time you see Connecting......._____..., press and hold the programming button until the load or action begins

Run either install-wifi.bat or install-bt.bat (.sh on other OS's). NOTE: Make sure you are running the script while in that that folder

Run install-fs.bat (or .sh) to install the file system, including the WebUI

If you already have a config file or other files on an ESP32, they will be deleted, so this is not recommended for upgrading firmware.
You may notice a message like this E (38) SPIFFS: mount failed, -10025 on the first run of the firmware. This is normal. It only happens on the first boot and is formatting the flash file system. Note: this operation may take a few minutes
Load a config.yaml file. NOTE: spindle type default is viod and will need to be set depending on your configuration

Upload a new configuration `config.yaml` file

Plug in xPRO V5 to computer using a USB to USB-C cable
Open FluidTerm.bat
Select the COM port named (\Devie\Silabser0)

Press CTRL+U to start and upload config.yaml NOTE:by default FluidNC looks for the config.yaml file name, if you name the file something else you will need to update the configuration field in fluidNC WebUI

Press Enter to begin upload - if successful it should look like this:

Updating WebUI Fimware (must currently be running FluidNC)

If the releases notes say that the WebUI has been updated, you will need to upload index.html.gz from the wifi folder. Do this using the local file system panel.

Over the air (OTA) Updates

If you have Wifi and the WebUI running, you can update via the FluidNC tab. This will not overwrite your config yaml file. Click the yellow cloud icon to upload your compiled binary (.bin) file. The compiled binaries are in the bt or wifi folders of downloaded releases.

If the upgrade affects the WebUI, you will need to upload index.html.gz from the FluidNC/data folder of the repo by clicking on the green folder icon in the image above.