Learn how to update the wireless connectivity firmware on the ESP32-S3 module on the UNO R4 WiFi.
Updating the firmware is required to use UNO R4 WiFi with Arduino Cloud.
In this article:
Windows
-
Unplug any non-essential USB devices from your computer.
-
Connect the UNO R4 WiFi board to your computer with the USB cable.
-
Download unor4wifi-update-windows.zip
-
Unzip the downloaded file.
-
Double-click on the
update.bat
file that is in the unzipped folder.Note: Depending on your Windows security settings, a Windows protected your PC dialog may open with this message:
Microsoft Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.
Click the More info link in the dialog and then click the Run anyway button to continue.
-
A terminal window will open. The terminal window might now show a list of the serial ports present on your computer.
For example:
Start flashing firmware [2023-07-11T06:39:09Z INFO ] Detected 2 serial ports [2023-07-11T06:39:09Z INFO ] Ports which match a known common dev board are highlighted [2023-07-11T06:39:09Z INFO ] Please select a port ❯ COM1 COM43 - USB Serial Device (COM43)
If so, use the ↓ key on your keyboard to select the port of the UNO R4 WiFi board from the list, and then press the Enter key.
-
The terminal window will now show the following prompt:
? Remember this serial port for future use? (y/n) ›
Press the N key on your keyboard.
-
The flashing process should now start. Wait for it to finish, as indicated by output that looks something like this:
Chip type: esp32s3 (revision v0.1) Crystal frequency: 40MHz Flash size: 8MB Features: WiFi, BLE MAC address: dc:54:75:c4:c6:54 [00:00:15] [========================================] 689/689 0x0 Press any key to continue . . .
-
Press any key on your keyboard to close the terminal window.
-
Disconnect the USB cable of the UNO R4 WiFi board from your computer.
-
Connect the UNO R4 WiFi board to your computer with the USB cable again.
Troubleshooting for Windows
If you get a VCRUNTIME140.dII was not found
error, download and install the Microsoft Visual C++ Redistributable package from Microsoft.
macOS
-
Unplug any non-essential USB devices from your computer.
-
Connect the UNO R4 WiFi board to your computer with the USB cable.
-
Download unor4wifi-update-macos.zip
-
Unzip the downloaded file.
-
Control-click on the unzipped
unor4wifi-update-macos
folder and select “New Terminal at Folder” from the context menu. A terminal window will open. -
Type the following command in the Terminal window:
chmod a+x update.command && sudo xattr -d com.apple.quarantine bin/espflash && sudo xattr -d com.apple.quarantine bin/unor4wifi-reboot-macos
-
Press the Enter key.
-
Type your macOS user password in the “Password” prompt and press the Enter key again.
-
Type the following command in the Terminal window:
./update.command
-
Press the Enter key.
-
The terminal window might now show a list of the serial ports present on your computer.
For example:
Start flashing firmware [2023-07-11T08:55:51Z INFO ] Detected 6 serial ports [2023-07-11T08:55:51Z INFO ] Ports which match a known common dev board are highlighted [2023-07-11T08:55:51Z INFO ] Please select a port ❯ /dev/cu.wlan-debug /dev/tty.wlan-debug /dev/cu.Bluetooth-Incoming-Port /dev/tty.Bluetooth-Incoming-Port /dev/cu.usbmodem2214101 - USB JTAG_serial debug unit /dev/tty.usbmodem2214101 - USB JTAG_serial debug unit
If so, use the ↓ key on your keyboard to select the
dev/cu.usbmodem*
port for USB JTAG_serial debug unit and then press the Enter key. -
The terminal window will now show the following prompt:
? Remember this serial port for future use? (y/n) ›
Press the N key on your keyboard.
-
The flashing process should now start. Wait for it to finish, as indicated by output that looks something like this:
[2023-07-11T08:59:44Z INFO ] Serial port: '/dev/cu.usbmodem2214101' [2023-07-11T08:59:44Z INFO ] Connecting... [2023-07-11T08:59:45Z INFO ] Using flash stub Chip type: esp32s3 (revision v0.1) Crystal frequency: 40MHz Flash size: 8MB Features: WiFi, BLE MAC address: dc:54:75:c4:c6:54 [00:00:14] [========================================] 689/689 0x0
-
Close the Terminal window.
-
Disconnect the USB cable of the UNO R4 WiFi board from your computer.
-
Connect the UNO R4 WiFi board to your computer with the USB cable again.
Troubleshooting for macOS
- If you get a
Cannot put the board in ESP mode. (via 'unor4wifi-reboot')
error: disconnect and reconnect the board, then run the command again. - If you get an
xattr: bin/espflash: No such xattr: com.apple.quarantine
orxattr: bin/espflash: No such xattr: com.apple.quarantine
error, it means that the command has already been run, or is otherwise not needed. Proceed with the next step.
Linux
-
Unplug any non-essential USB devices from your computer.
-
Connect the UNO R4 WiFi board to your computer with the USB cable.
-
Download unor4wifi-update-linux.zip
-
Open the release page for the latest version of the firmware in your web browser: https://github.com/arduino/uno-r4-wifi-usb-bridge/releases/latest
-
Extract the downloaded ZIP file.
-
Open a command line terminal in the extracted folder.
-
Type the following command:
./update.sh
-
Press the Enter key.
-
The terminal window might now show a list of the serial ports present on your computer.
For example:
Start flashing firmware [2023-07-12T15:02:36Z INFO ] Detected 3 serial ports [2023-07-12T15:02:36Z INFO ] Ports which match a known common dev board are highlighted [2023-07-12T15:02:36Z INFO ] Please select a port ❯ /dev/ttyACM0 - 7 Series/C210 Series Chipset Family USB xHCI Host Controller /dev/ttyS4 /dev/ttyS0
If so, use the ↓ key on your keyboard to select the port of the UNO R4 WiFi board from the list, and then press the Enter key.
-
The terminal window will now show the following prompt:
? Remember this serial port for future use? (y/n) ›
Press the N key on your keyboard.
-
The flashing process should now start. Wait for it to finish, as indicated by output that looks something like this:
[2023-07-12T15:04:46Z INFO ] Serial port: '/dev/ttyACM0' [2023-07-12T15:04:46Z INFO ] Connecting... [2023-07-12T15:04:46Z INFO ] Using flash stub Chip type: esp32s3 (revision v0.1) Crystal frequency: 40MHz Flash size: 8MB Features: WiFi, BLE MAC address: dc:54:75:c4:c6:54 [00:00:14] [========================================] 689/689 0x0
-
Close the terminal window.
-
Disconnect the USB cable of the UNO R4 WiFi board from your computer.
-
Connect the UNO R4 WiFi board to your computer with the USB cable again.