4. Firmware
The firmware package comprises three files to be installed on the Maslow: firmware.bin, Maslow.yaml, and index.html.gz. The firmware package also includes compress archives of the source code and fluidNC package on which the Maslow firmware is built. The latest and previous versions of the firmware package can be found at Releases · BarbourSmith/FluidNC · GitHub. Instructions for installing the firmware package can be found on the User Guide — Maslow.
When the firmware is updated, it is strongly recommended that the other two files (Maslow.yaml and index.html.gz) be updated as well. If the M4 has been previously calibrated, the values in the old Maslow.yaml file that start with “Maslow” be copied to the new Maslow.yaml file to retain the old calibration.
Resetting (Wiping Out) the Maslow’s Firmware
It is sometimes useful to reset the maslow to “factory state”. There are several ways to accomplish this.
- Via USB with included zip file.
- Via USB or wifi with the Maslow source code and platformio
- Others?
Via USB with included zip file
This method only works on a windows machine. You will need to attach your maslow to the computer with a USB-c cable, then extract the zip file in the release. there is a README there with instructions. This is the easiest method.
Via USB or wifi with Maslow source code and platformio
If you are not on windows or just want to use this method, you can download and install platformio (Your Gateway to Embedded Software Development Excellence · PlatformIO), then you can download the maslow source from GitHub - BarbourSmith/FluidNC: The next generation of motion control firmware - either with git or download a zip file. NOTE: if you download a ZIP it will be of the current Maslow-Main branch in git which will be the most recent release. if you want another release, first select the tag from the dropdown / tags
When you have the source, (and are on the right tag if using git) launch a command line in that directory. You can then decide which operation below you want to do, and whether you want to do this over wifi or via USB. The “options” on the below commands will be -e usb --upload-port <portname> for USB or --upload-port <ip_address> if using wifi. portname will be the device name from the output of pio device list. --upload-port <ip_address> is only needed if you are using something other than maslow.local for your maslow.
- wipe out/reset the files (index,maslow,etc, not gcode)
pio run -t uploadfs <options> - build and upload the firmware
pio run -t upload <options> - erase everything
pio run -t erase <options>(you will then need to upload and uploadfs)