Skip to main content

ZSWatch Firmware Update

Update your ZSWatch firmware and image resources over USB or Bluetooth

How does this work?

Step 1: On your ZSWatch, go to Apps → Update and enable USB or BLE.

Step 2: Connect to the watch using the Connection panel on the left. USB is much faster than BLE.

Step 3 – Firmware: Use Prebuilt Firmware to fetch the latest build matching your hardware. To flash, extract the .zip file you downloaded, then upload the dfu_application.zip.

Step 4 – Image Resources: Upload lvgl_resources_raw.bin in the File System section so icons and graphics display correctly. This file is included in the firmware download package.

Firmware downloads are available from GitHub Releases and GitHub Actions.

Connection

Disconnected
BLE: UnavailableUSB Serial: Unavailable
❌USB Serial (WebSerial) Unavailable

Requires Web Serial support (Chrome or Edge).

💡Enable Firmware Updates

Go to ZSWatch System -> Update App and enable either USB or Bluetooth. USB is significantly faster than Bluetooth due to Web Bluetooth API limitations.

Serial Recovery: If ZSWatch is not responding enter MCUBoot by holding down two right buttons for 25 seconds.

Not required when connecting over USB.

Browser Support

  • Chrome, Edge, Opera (Desktop)
  • Chrome, Edge (WebSerial / USB serial updates)
  • Chrome (Android)
  • Bluefy (iOS/iPadOS)

Troubleshooting

General issues▼

• Press F12 and check console for errors

• Reload the page

Connection issues▼

• Forget device in OS Bluetooth settings

• Ensure watch is on

• Use supported browser

Upload fails▼

• Reset watch, reload page and reconnect

• Check file format (.zip or .bin)

• Try switching to USB serial mode.

Manual Upload

Upload Firmware Files

Drag and drop the dfu_application.zip from your firmware package here

File System

Upload File System

Drag and drop your lvgl_resources_raw.bin file here to upload icons and graphics.

This file is included in the firmware download package from GitHub Releases or GitHub Actions.

ℹ️ Please connect to device to upload filesystem.

Shell Console

Prebuilt Firmware

Download the latest firmware from GitHub Actions.

Note: Downloading GitHub Actions artifacts requires you to be logged in to GitHub.

After downloading: The downloaded file is a zip archive. Extract it to find:

• dfu_application.zip — upload this in Manual Upload to flash firmware

• lvgl_resources_raw.bin — upload this in File System to update icons/graphics

📦

No firmwares fetched yet

Click "Fetch Latest" to get builds

Images

⚠️

Connect to device to view image status