> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Firmware Upgrade

Click the **Upgrade** icon <svg width="1.2em" height="1.2em" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{verticalAlign: 'middle', display: 'inline'}}><path d="M12 2v8" /><path d="m16 6-4 4-4-4" /><rect width="20" height="8" x="2" y="14" rx="2" /><path d="M6 18h.01" /><path d="M10 18h.01" /></svg> in the Activity bar to open the Firmware Upgrade View. Wuji Studio provides a step-by-step firmware upgrade wizard.

<img src="https://mintcdn.com/wuji-0bbde051/GsT0bEnPZ_18e5HL/assets/source/images/en/wuji-studio/upgrade-steps.png?fit=max&auto=format&n=GsT0bEnPZ_18e5HL&q=85&s=f827f0fa3082d5db9b25c1965f8d4e6a" alt="Firmware Upgrade" width="1438" height="898" data-path="assets/source/images/en/wuji-studio/upgrade-steps.png" />

## Upgrade Workflow

### Step 1: Select Device

After entering the Upgrade View, the Sidebar lists all connected devices. The Sidebar groups devices by product type and lists unrecognized devices under **Other Devices**.

Upon selecting a target device:

* Displays the device's current firmware version
* Automatically checks for available updates
* Notifies you if the device is already on the latest version

### Step 2: Select Firmware

The application automatically retrieves available firmware from the server, sorted by version (newest first). Each entry displays:

* Version number
* Release date
* Release notes

After selecting a target version, the app shows the cumulative changelog between the current and target versions, to help you understand all the feature updates you'll receive.

<Warning>
  If the selected target version is lower than the current version (downgrade), a warning highlights
  lost features with strikethrough. Confirm the downgrade impact before proceeding.
</Warning>

### Step 3: Upgrading

After confirming the upgrade, the progress bar shows real-time status:

1. **Preparing** — Initializing the upgrade environment
2. **Receiving** — Transferring the firmware to the device
3. **Verifying** — Validating firmware integrity

<Warning>
  * Do not close the application or disconnect the device during the upgrade. If you attempt to
    close the app, a confirmation dialog will warn that an upgrade is in progress. - If you encounter
    issues during the upgrade, refer to [Troubleshooting](/en/docs/wuji-studio/troubleshooting).
</Warning>

### Step 4: Result

* **Success**: Shows pre/post version comparison and verification result
* **Failure**: Shows error details and upgrade log, with a retry option. The firmware automatically rolls back to the previous version on upgrade failure


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.