Documentation / Gemini 330 series /
Update firmware

Update firmware

1. Device firmware mode introduction

The Gemini 330 series cameras have two modes. The first is normal mode, where the camera operates normally. The second is recovery mode, where the camera cannot function but can only perform firmware update. By default, the device will enter normal mode. It will only enter recovery mode when it is unable to enter normal mode.

 

1.1 How to identify the device mode

1.1.1 Windows system

In normal mode, the device manager displays the device as follows:

In normal mode, the device is displayed as follows when connected to Orbbec Viewer:

In recovery mode, the device manager displays the device as follows:

In recovery mode, the device is displayed as follows when connected to Orbbec Viewer:

1.1.2 Ubuntu system

In normal mode, the device information is displayed as follows when using the **lsusb** command:

In normal mode, the device is displayed as follows when connected to the Orbbec Viewer:

In recovery mode, the device information is displayed as follows when using the **lsusb** command:

In recovery mode, the device is displayed as follows when connected to the Orbbec Viewer:

 

1.2 Notes

  • Ensure the device has a stable power supply and stable communication during the update process.
  • The camera firmware includes ISP firmware. ISP firmware will not be updated in recovery mode; it needs to be updated again after entering normal mode.
  • If any failure occurs during the update process, you can repeat the update until it is successful.

 

2. Update firmware

2.1 Online update via Orbbec Viewer

1)-Open Orbbec Viewer. If firmware updates are available, a notification will appear in the top right corner of the screen, indicating that new firmware is available for update.

2)  Click the notification in the red box as shown above, and the following dialog box will appear.

3) Select “New Firmware Upgrade”.

4) Click “Upgrade,” and the following dialog box will appear.

5) Click “Yes.”

6) Reboot the device.

7)  Confirm the firmware version number after the update.

Notes:

If the update process fails, you can repeat the update until it is successful.

2.2 Offline update via Orbbec Viewer

The difference between offline  and online updates is as follows: With online updates, the firmware is  automatically downloaded from the server (downloaded to the “output/firmwareFile” directory in Orbbec Viewer) and then the device is updated. However, with offline updates, you manually select the firmware path and then proceed with the update. The interface is as follows:

After clicking “Upgrade,” the subsequent update steps are the same as online update.

2.3 Code Sample

3. Handle update exception

If there is a power failure or the USB cable is unplugged during the online update process, the device may enter Recovery mode. In this case, you will need to perform an offline update using the firmware downloaded through online. The path to the online firmware download is in the “output/firmwareFile” directory of Orbbec Viewer, for example, on the Windows platform, as shown in the following figure.

If the device enters Recovery mode but there is no firmware available, please download the firmware from the product’s firmware download page first. Then, follow the offline update method to perform the update.

Notes:(Very Important)

In Recovery mode, ISP firmware update is not supported. You need to enter Normal mode and perform firmware update again to ensure ISP firmware matches the current system. (In Recovery mode, firmware needs to be updated twice).

 

4. Update Orbbec Viewer

If there is a new version of Orbbec Viewer available for update, when opening OrbbecViewer, there will be a prompt in the top right corner: “A new version of the tool can be updated.” Click on this prompt, it will link to the download directory of Orbbec Viewer on GitHub. Please download the corresponding platform’s Orbbec Viewer.

Notes:

Each firmware has a corresponding minimum version number of supported Orbbec Viewer. If the current Orbbec Viewer version is too lower, you need to update Orbbec Viewer first to detect the prompt for the latest firmware update.

Stay updated

Be the first to learn about our new
products and updates.