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

<Warning>
  During the upgrade, **do not** disconnect the USB connection, close the upgrade software, or disconnect device power. Keep the computer active and avoid entering sleep mode.
</Warning>

### One-Click Upgrade (Recommended)

1. On the **CONNECT DEVICE** screen, click **ONE-CLICK UPGRADE** to open the **PERFORM UPGRADE** screen.

2. After confirming the device information and target version, click **START UPGRADE**.
   <img src="https://mintcdn.com/wuji-0bbde051/KO3tT6qNwl3EeRut/assets/source/images/en/wuji-hand-upgrader/start-upgrade-2025-12.png?fit=max&auto=format&n=KO3tT6qNwl3EeRut&q=85&s=7dee5b98bea58ac27a54dc1febc6ab6d" alt="Start Upgrade" width="1327" height="763" data-path="assets/source/images/en/wuji-hand-upgrader/start-upgrade-2025-12.png" />

3. The software automatically performs the following operations and waits for the upgrade to complete:
   * Download the latest firmware
   * Verify firmware integrity
   * Execute the flashing operation

4. After the upgrade completes, the software opens the **Update Complete** screen. See [Upgrade Complete](#upgrade-complete) for the closing steps.

### Manual Firmware Selection

If you need a specific firmware version or a local firmware file, use manual selection mode. On the **CONNECT DEVICE** screen, below **ONE-CLICK UPGRADE**, click **Or select version manually** to open the **SELECT FIRMWARE** screen.

* The left side shows firmware details and **RELEASE NOTES**
* The right side shows the **AVAILABLE** list
* The lower-right area shows **Upload Local Firmware** and **INSTALL FIRMWARE**

<img src="https://mintcdn.com/wuji-0bbde051/KO3tT6qNwl3EeRut/assets/source/images/en/wuji-hand-upgrader/firmware-selection-2025-12.png?fit=max&auto=format&n=KO3tT6qNwl3EeRut&q=85&s=b0cf2c438ac015c68fa0c0841fc2798c" alt="Firmware Selection Interface" width="1329" height="767" data-path="assets/source/images/en/wuji-hand-upgrader/firmware-selection-2025-12.png" />

#### Select Online Firmware

1. In the **AVAILABLE** list, select the desired firmware version.
2. Click the version card to select it.
3. Click **INSTALL FIRMWARE** to start the upgrade.

#### Select Local Firmware

1. Click **Upload Local Firmware**.
2. Select the local firmware archive file (.zip format).
3. Wait for file extraction and verification to complete.
4. Click **INSTALL FIRMWARE** to start the upgrade.

After clicking **INSTALL FIRMWARE**, wait for the flashing to complete, then follow [Upgrade Complete](#upgrade-complete) for the closing steps.

### Upgrade Complete

After the upgrade flow finishes, the software opens the **Update Complete** screen with **Firmware version verified**.

<img src="https://mintcdn.com/wuji-0bbde051/KO3tT6qNwl3EeRut/assets/source/images/en/wuji-hand-upgrader/upgrade-complete-2026-05.png?fit=max&auto=format&n=KO3tT6qNwl3EeRut&q=85&s=ebdc127cb387031a1cb908f6677a89b9" alt="Upgrade Complete" width="1278" height="718" data-path="assets/source/images/en/wuji-hand-upgrader/upgrade-complete-2026-05.png" />

The screen displays:

* **NEXT STEPS**: Close this application and Power cycle the device
* **VERSION COMPARISON**: Current vs Target, marked Version Match

To finish the upgrade:

1. Click **Close App** to exit the Upgrader, or click **Back to Home** to continue upgrading another device.
2. Power off Wuji Hand, then power it on again to exit Bootloader mode and return to normal operation.


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