# Upgrade Firmwares

## Overview <a href="#title-0-overview" id="title-0-overview"></a>

If your devices use the MCU or the IPC SDK to access the Tuya Cloud, you can remotely upgrade shipped devices' firmware online on the Tuya Smart platform without needing to burn the upgrade. To support remote firmware upgrade, the control board needs to support firmware upgrade. The following describes how to upgrade the firmware when your devices use the MCU or IPC SDK to access the Tuya Cloud.

## Procedure <a href="#title-1-procedure" id="title-1-procedure"></a>

### Log in to the Tuya Smart platform <a href="#title-2-log-20in-20to-20the-20tuya-20smart-20platform" id="title-2-log-20in-20to-20the-20tuya-20smart-20platform"></a>

Click **Product**, and select a product to be upgraded. On the displayed page, click **Advanced Features**. Click **Settings** next to **Firmware Updates Center**.&#x20;

![](/files/-MC-vJtS9WoSMN4NCgVJ)

### Create New firmware  <a href="#title-3-create-20new-20firmware" id="title-3-create-20new-20firmware"></a>

![Upgrade Firmwares](https://images.tuyacn.com/smart/aircondition/gjsj14.png)

![Upgrade Firmwares](https://images.tuyacn.com/smart/aircondition/gjsj13.png)

Enter the relevant information and click **New firmware update**.

* Select **MCU firmware** or **SDK firmware** for **Firmware type**.
* Set **Key Version** to **Yes** or **No**. If you select **Yes**, the firmware version cannot be skipped.
* Select an upgrade method.
  1. **Notification upgrade**: App users will receive upgrade notifications in the App and can choose whether to upgrade the firmware.
  2. **MCU silent upgrade**: Devices are automatically upgraded without notifying App users.
  3. **Forced upgrade**: App users must upgrade the firmware to use devices.
  4. **Automatic upgrade**: App users proactively upgrade the firmware in the app.
* Add upgrade description.

### Manage the test whitelist. <a href="#title-4-manage-20the-20test-20whitelist." id="title-4-manage-20the-20test-20whitelist."></a>

![](/files/-MC-vf7zG1rKqZ4yR8Ot)

&#x20;To test devices, configure a test whitelist first. You can add devices under your App account to the whitelist in batch.

Click **Whitelist Devices** and **New Whitelist Device** and add several App user accounts for testing.

* Select **China**, **United States**, or **Europe** for devices to be added.
* Enter your App account. After your account passes the verification, product IDs (PIDs) of devices under the account will be added to the whitelist automatically.

![](/files/-MC-vlWblLIUFRCRw3al)

&#x20;For security purposes, the App user accounts need to be verified.

### Select a device to be tested. The firmware will be sent to the devices and verified.  <a href="#title-5-select-20a-20device-20to-20be-20tested.-20the-20firmware-20will-20be-20sent-20to-20the-20dev" id="title-5-select-20a-20device-20to-20be-20tested.-20the-20firmware-20will-20be-20sent-20to-20the-20dev"></a>

![Upgrade Firmwares](https://images.tuyacn.com/smart/aircondition/gjsj17.png)

![Upgrade Firmwares](https://images.tuyacn.com/smart/aircondition/gjsj18.png)

Click **Test device management**. On the displayed page, select a region, for example, **China**, **United States**, or **Europe** to verify the device.

![](/files/-MC-wC3RELZhDoCNFW1u)

&#x20;Select PIDs of devices to be tested from the whitelist. The firmware will then be sent to the selected devices.

### Apply for an OTA firmware upgrade release. <a href="#title-6-apply-20for-20an-20ota-20firmware-20upgrade-20release." id="title-6-apply-20for-20an-20ota-20firmware-20upgrade-20release."></a>

![](/files/-MC-wGusA5rzXmDA2cF8)

Click **All Publish** or **Grayscale Publish**. The system automatically submits a release application. Tuya will review your release application and the firmware security. Upon approval, Tuya will push the firmware to target consumers within the release scope that you specify.

(1) After the testing devices pass verification, the OTA firmware upgrade can be released.\
&#x20;(2) The firmware upgrade can be released in China, the United States, and Europe.\
&#x20;(3) Grayscale releases and all releases are supported, and you can specify the release time. If you choose grayscale release, you can select one or more regions, the device quantity, and one or more version numbers.\
&#x20;(4) After you confirm the firmware upgrade release, Tuya will verify unapproved firmware within 24 hours before releasing it and immediately release approved firmware.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ifreeq.com/developer/configure-in-platform/cloud-configuration/upgrade-firmwares.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.