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

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

   ![Start Upgrade](https://mintcdn.com/wuji-0bbde051/nLLDY-yV3f5aegbJ/shared/assets/source/images/en/wuji-hand-upgrader/start-upgrade-2025-12.png?fit=max\&auto=format\&n=nLLDY-yV3f5aegbJ\&q=85\&s=1d5aa7c26dfc89785736c0d0c31200c5)

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

![Firmware Selection Interface](https://mintcdn.com/wuji-0bbde051/nLLDY-yV3f5aegbJ/shared/assets/source/images/en/wuji-hand-upgrader/firmware-selection-2025-12.png?fit=max\&auto=format\&n=nLLDY-yV3f5aegbJ\&q=85\&s=7622142bb495f667a273b1e19ccd3be2)

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

![Upgrade Complete](https://mintcdn.com/wuji-0bbde051/nLLDY-yV3f5aegbJ/shared/assets/source/images/en/wuji-hand-upgrader/upgrade-complete-2026-05.png?fit=max\&auto=format\&n=nLLDY-yV3f5aegbJ\&q=85\&s=831482ff271d8d43e62e6c14d50885da)

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.