2.3 Upload Firmware and Config Files

Check List · Step 3 of 12 · Optional learning step for reinstalling FluidNC firmware and uploading files

ℹ️

Optional Section: The board is shipped with FluidNC firmware, config.yaml, and the required WebUI file pre-installed from the factory. You do not need to repeat this step for normal first-time use.

▶️ Tutorial Video

This section follows the process shown in the video below. Although FluidNC can also be installed through the Web Installer, this tutorial uses the Windows software tools for learning and demonstration purposes.

📥

The firmware package, test config.yaml, and WebUI file can be downloaded from 5 Documentation. The WebUI file name is index.html.gz.

⚠️

Warning: Running erase_s3.bat will erase the existing firmware and files from the ESP32-S3 flash. This operation cannot be undone. Only continue if you really want to reinstall the firmware and upload the files again.

Install the CP2102 Driver

Connect the board to your Windows PC using a USB-C data cable.
Install the corresponding CP2102 USB-to-UART driver.
Open Windows Device Manager and check the assigned COM port.
Write down the COM port number. You may need it during firmware upload or serial connection.

Erase the Existing Firmware

💡 Open the firmware folder first. Make sure you are using the package for the PiBot V5.88 Ultra ESP32-S3 Wi-Fi version.

Find and run erase_s3.bat.
Wait until the erase process is completed.
⚠️ This step removes the existing firmware and files from the board.

Upload the Wi-Fi Firmware

Run install-wifi_s3.bat.
The tool will automatically detect the COM port and start uploading the firmware.
Wait until the upload is fully completed.
After upload, select the board COM port and open the serial connection.

Upload Config and WebUI Files

Press CTRL + U to open the file upload function.
Upload the first file: the test config.yaml.
Wait until the upload is complete.
Press CTRL + U again and upload the second file: index.html.gz.

Upload Order	File	Purpose
1st	`config.yaml`	Factory test configuration file for the checklist procedure.
2nd	`index.html.gz`	FluidNC WebUI file.

Restart the Board

Press CTRL + R to restart the board.
Wait for the startup message to appear.
After rebooting, the terminal should show the FluidNC 4.0.x version information.

⚠️

Note: If USB CDC appears in red in the self-check message, this does not affect normal use. It is used for the test in Section 3.1 Test Secondary USB.

✓

Expected Results

The CP2102 driver is installed and the board COM port can be found.
The Wi-Fi firmware is uploaded successfully.
The test config.yaml and index.html.gz are uploaded successfully.
After pressing CTRL + R, the startup message shows FluidNC 4.0.x.

← 2.2 Check Jumpers and Power On Step 3 of 12 2.4 Test Wi-Fi and SD Card →