> ## 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  in the Activity bar to open the Firmware Upgrade View. Wuji Studio provides a step-by-step firmware upgrade wizard.

![Firmware Upgrade](https://mintcdn.com/wuji-0bbde051/3uhnC3cY-ox8e3b-/shared/assets/source/images/en/wuji-studio/upgrade-steps.png?fit=max\&auto=format\&n=3uhnC3cY-ox8e3b-\&q=85\&s=870965535cac033677ef7bae8dfc5bcd)

## 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.

### 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](https://docs.wuji.tech/docs/en/wuji-studio/latest/troubleshooting.md).

### 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.