Last Updated on : 2023-01-29 09:27:16download
To enhance the self-service development capability of customers, Tuya IoT Development Platform has introduced firmware management. You can manage firmware uploaded by yourself during product development. With deployment scope setting, you can manage available firmware developed by OEM, copy, or transfer.
The function mainly applies to those who develop products by copy or OEM.
|Custom firmware||This kind of firmware is uploaded, maintained, and updated by you.|
|Tuya firmware||This kind of firmware is developed and updated by Tuya. You can select and use the firmware.|
|Manufacturer firmware||This kind of firmware is obtained when you develop products by copy or OEM. It is maintained and updated by the manufacturer.|
|Firmware type||It is divided into production firmware, user area firmware, and update firmware. Production firmware and user area firmware are mainly used during the flashing by Tuya’s plant, and they are required only when the product is produced by Tuya.
Update firmware is mainly used for device remote OTA updates. It is available for all products.
|Firmware owner||The account that can manage the firmware. It is divided into the following two cases.
Firmware management is mainly used to manage My Custom Firmware. You can add, edit, delete, enable, and deactivate the firmware.
By enabling and deactivating the firmware, you can set the availability of the firmware version. For example, if you want to remotely update your devices via OTA, you need to add a firmware version and enable it in Firmware Version Management, and then go to Update Firmware > New Update Deployment to add a new firmware version. Then, you can send update notifications to devices.
You have created at least one product. See Create Products for details.
Choose Product > Development in the left-side navigation bar, find a product, and click Continue to Develop. On the page that appears, click Hardware Development > Add Custom Firmware.
You can add custom firmware in Development or in Firmware Management in 3 steps.
With the firmware key generated, you are required to develop the firmware. After development, add a new firmware version and upload a valid firmware file, which mainly refers to production firmware.
Note: Generally, in product development, you upload production firmware and user area firmware. Every firmware file you upload (new firmware version) will be maintained as a version.
By default, once the firmware version is added, it will have a status—enabled or not enabled.
Firmware enabling process
Firmware enabling is for managing products with the same firmware key. You can specify whether an account or a PID can receive update notifications for firmware updates or product development.
Service process (see the diagram above)
Whitelist of limited scope
A whitelist refers to the account/PID and organizations that can use the enabled firmware version during update and development. The organizations get firmware keys by copying a product or creating an OEM product.
Impact scope of enabling
Note: After you enable the firmware, OEM customers can use its versions if the product is published. To avoid troubles like misusing faulty firmware, it is recommended to set the deployment scope limited during debugging stage.
After you complete product development, you can enter Device > Firmware Management > My Firmware to view the firmware information.
Note: Only firmware owners can add a new version of firmware (see Term).
In practice, you can go to Firmware Management to add a new firmware version. Notice that only the firmware owner can do it.
Note: Only the firmware owner can add a new version. If the button Add Firmware Version is invalid, it indicates that you are not the firmware owner. Contact the product owner to get authorized.
Add a firmware version
Entry 1 (recommended): In the left-side navigation bar, go to Product > Device > Firmware Management, select a firmware, and click Create Version.
Entry 2: In the left-side navigation bar, go to Product > Device > Firmware Management > Details, select a firmware, and click Add Firmware Version.
Entry 3: In the left-side navigation bar, go to Product > Device > Firmware Update, select a firmware, and click Add Firmware Version.
Complete the information of the firmware version, and upload the firmware file.
When you enable the firmware, you need to select the firmware type and its deployment scope.
If you select Firmware Updates, customers who use the firmware can receive update notifications in Firmware Update.
If you upload Production Firmware, customers who use the firmware can update it in the third step of Hardware Development.
After you enable the new firmware version with update files, go to Firmware Update, and you can see update notifications for the firmware. Click New Update Deployment, and complete the setting.
After the setting, the new version will be displayed below My Updates. You can continue the process to verify and publish the version.
In practice, if you want to set the latest version as factory firmware, go to product development to change it.
You need to upload both production firmware and user area firmware.
You must enable the production firmware first.
After enabling the new firmware version, you will receive update notifications in your product list. You can enter Product > Development > Continue to Develop > Hardware Development, and click Update to change the version.
Update firmware version
Is this page helpful?YesFeedback
Is this page helpful?YesFeedback