Browse the most common questions and expert answers about Product Management on the Tuya IoT Platform.
To resolve the issue of failing to obtain an Access Token when calling the Tuya API with PHP, please follow these steps: 1. Check and confirm that your clientId and clientSecret are correctly configured. 2. Confirm that the base URL is correctly configured to the domestic node (https://openapi.tuyaen.com) or the overseas node (https://openapi.tuyaeu.com). 3. When generating the signature, ensure to use the HMAC-SHA256 algorithm, using clientId + timestamp as the data and clientSecret as the key. 4. Correctly construct the signature string, including the request method (GET), timestamp (in milliseconds), and request path (/v1.0/token?grant_type=1). 5. Include the generated signature and related header information (client_id, sign, sign_method, t, Content-Type) in the API request header. 6. Ensure the timestamp is a millisecond representation of the current time and ensure the timestamp used for signature calculation is consistent with the request. 7. Process the API request response and verify whether the returned result contains a valid access_token. 8. After obtaining the access_token for the first time, cache the token and set an expiration time in advance to reacquire it. By following the above steps, you can ensure the request signature is correct, thereby successfully obtaining the Access Token.
Please follow these steps to resolve the issue: 1. Ensure the correct regional endpoint is used, such as openapi.tuyaeu.com. 2. Check whether the association between the device and the project in the Tuya Developer Platform cloud project is correct. 3. Confirm that the API client has successfully called connect(). 4. Use the Python SDK provided by Tuya for device control and refer to the best practice guide. 5. Confirm whether the authentication method of the SmartLife App device is correct to generate a valid token. 6. If necessary, consider additional configurations such as device data sharing, application authorization, or OAuth to ensure direct access to SmartLife devices and subsequent smart plug control. By following these steps, you can correctly set up and use the Python application to access and control Tuya smart devices.
To obtain an OAuth 2.0 access token by scanning a QR code, you first need to follow these steps: 1. Register a developer account and apply for cloud API authorization to obtain client_id and secret. 2. Use the SDK obtained from the Tuya developer platform to conduct business development based on OpenAPI. 3. After completing development testing, release the application. The specific process for scanning the QR code and obtaining the access token is as follows: 1. After scanning the QR code, you will receive a code value. 2. Use this code value to request an access token. 3. A more detailed authentication process can be found at the following link:Detailed process for obtaining access token 4. If you need to request a signature for application authorization, you can refer to the following link:Application authorization request signature.
You can authorize cloud projects to others through authorization within the enterprise. The specific steps are as follows: 1. Log in to the main account and open the project management page. 2. Find the cloud project that needs to be authorized and enter the settings or permissions management page of the project. 3. Select options such as "Authorize" or "Add Member" and fill in the account information that needs to be authorized. 4. Set the permission level of the account, such as read-only, developer permissions, etc. 5. Confirm the settings and save to complete the authorization.
To resolve cloud development interface call errors, it is recommended to take the following steps: 1. Check if the signature mechanism is correct to ensure the security of the request and proper user verification. 2. Confirm authorization settings to ensure sufficient permissions to perform operations. 3. Ensure a stable network environment to avoid request failures due to network instability. 4. Check the server-side interface response to see if it meets expectations and if the interface is correctly defined. 5. User interface parameters need adjustment, modify the request body content in the following format: ``` { "sub_uid": "bay1598932344214****" } ``` Detailed documentation and error codes can be referenced at the following links: - https://developer.tuya.com/en/docs/iot/global-error-code?id=Kaa7xrmxyveaf - https://developer.tuya.com/en/docs/cloud/5d1c82e8ad?id=Kb68j3v2tqeby#title-4-%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B.
Differential firmware needs to be written by the user, and the platform only transmits the firmware to the MCU side according to the serial port protocol. The operations related to processing differential firmware are carried out on the MCU side, so the user needs to implement the processing logic for differential upgrades on the MCU side. The specific steps are as follows: 1. Obtain the previous version of the firmware file in the MCU (e.g., T5L51_1.5.5.bin). 2. Write the differential firmware and compare it with the newly compiled firmware file (e.g., T5L51.bin) to generate differential data. 3. Upload the generated differential firmware to the Tuya backend. 4. Ensure that the MCU software can recognize and process the differential file to successfully complete the upgrade.
To resolve the issue of OTA upgrade failure, the following steps can be taken: 1. Check if the device's battery is sufficiently charged, ensuring the battery level is within the normal operating range. 2. Check the relevant settings in the application to ensure there are no restrictions on upgrading under low battery conditions. 3. Check if the device signal is good, ensuring smooth and correct connection between the device and the network. 4. If the above two items are not problematic but the upgrade still fails, try restarting the device or disconnecting and reconnecting to the network, then attempt the OTA upgrade again. 5. Confirm whether the current firmware version of the device is compatible with the OTA upgrade version to avoid issues caused by version incompatibility. 6. If the issue is still unresolved, you can refer to the Tuya official website for guidance or FAQs related to OTA upgrades.
It might be that the wrong data region was selected during OTA, please reconfirm.
To synchronize the product's function points to the device, please ensure that your device panel supports the newly added function points, and remove the device, clear the app cache, and reconfigure the network. If the device panel still does not display the new function points, check the correlation between function points and other function points. For example, the white light and color light function points need to be added together with the work mode function point to be displayed. If the problem persists, it is recommended to test the function points or add all function points for inspection.
The current firmware version can only be seen in the firmware upgrade.
Basically no connection, as long as the MCU keeps the module powered, the module will complete the OTA by itself.
Ensure the reliability of OTA upgrades by focusing on the following aspects: 1. Confirm that the MCU connection is stable and there is sufficient power supply to avoid power interruption midway. 2. Verify the integrity of the OTA upgrade package to ensure that all data frames are received and acknowledged according to the protocol. 3. Check whether the buffer size setting for the MCU receiving data is reasonable to prevent data overflow. 4. If using Tuya's Wi-Fi-SDK, be sure to verify protocol consistency and confirm that all setting parameters are correct, such as the size of WIFI_UART_RECV_BUF_LMT. By following the above steps, the success rate and stability of OTA upgrades can be significantly improved.
First, check if the category is supported:https://github.com/tuya/tuya-home-assistant/wiki/Supported-Device-Category?_source=f5f782752be3c4a9157ec47514d6091b If supported, you can integrate according tohttps://developer.tuya.com/en/docs/iot/Home-assistant-tuya-intergration?id=Kb0eqjig0utdd.
In the product multilingual settings, ensure the product name is consistent and updated to the latest version. After configuration, wait 15 minutes (to prevent network delays) beforeremoving the device, clearing its data, and reconnecting it to the network. Reference link: https://developer.tuya.com/en/docs/iot/product-language?id=K93ixsjagr67p Click Product Configuration. In the Multilingual Management section, click Settings to enter the Multilingual Management page.
Device upgrades can only be specified through the device ID and cannot be pushed through the SN code of the Wi-Fi module.
Confirm the complete delivery of the user area, production, and upgrade firmware, and perform a complete burn after using a higher version. Upload the new firmware model and verify it through the Tuya tool. The issue of firmware burning failure can be resolved by delivering complete UA, UG, and QIO files.
When customers report not receiving upgrade notifications, first confirm whether the firmware version used by the device is the latest. Use the device ID or other identifiers to determine the current firmware version of the device. If the device version is still the old version, confirm whether the backend push is paused or has not reached the customer's device. Ensure that the push settings cover the correct data center area so that users can receive firmware upgrade notifications.
If the callback link does not redirect to the Tuya OAuth authorization window and only displays "ok", please follow these steps to troubleshoot: 1. Check if the application SDK is expired, and if so, update or reacquire it. 2. Confirm whether the operation is in accordance with the Tuya Cloud OAuth 2.0 protocol standards, and refer to the relevant Tuya documentation. 3. Verify whether the parameters such as client_id and redirect_uri in the request link are correct.
Your IP address is not allowed to access across regions. Tuya's cloud platform divides different data centers based on country codes, and the data from five regions are independent of each other. Users cannot access device data from other regions through the domain name of the US region. Please select the corresponding region in the data center according to your needs to view the data, and the domain name will switch accordingly.
First, ensure that the cloud authorization signature mechanism has been correctly used, and check whether the content of the signature document meets the requirements. You can refer to the signature document:https://developer.tuya.com/en/docs/iot/new-singnature?id=Kbw0q34cs2e5g. Secondly, ensure that the authorization settings of the project and application are correct, including the following steps: 1. Check whether the project authorization includes authorization credential management. 2. Confirm that the application has been authorized and approved. 3. Verify the correctness of the authorization key. If similar issues occur when using a self-owned App (OEM App/App SDK), these interfaces can only be accessed and used by self-owned Apps authorized by the user, ensuring that the user has passed the authorization mechanism.
Please check the multilingual settings in the product configuration and confirm whether the product name is correctly configured as the desired name (e.g., heater). If the device name is not displayed correctly, please remove the device and reconfigure the network to ensure the device name is consistent with the language settings of the configuration.
The issued DP points do not have default values. Therefore, the panel needs to handle caching on its own to resolve this issue. Please ensure that the panel programming logic includes a caching mechanism so that an appropriate status display can be provided when the device starts or reconnects.
If the product firmware was uploaded by a user and needs to be discontinued or upgraded, please contact the firmware manufacturer for assistance. If a device is integrated with MCU general firmware or IPC SDK, you can update the firmware of the delivered devices on the Tuya IoT Platform online remotely without flashing. The control board shall support firmware updates. References: Firmware Upgrade: https://developer.tuya.com/en/docs/iot/firmware-upgrade-operation-guide?id=K93ixsft1w3to Firmware Manufacturer Support Page: https://support.tuya.com/en/help/_detail/Kd3io03tlsb36.
The device only requires license for authentication during the initial network configuration. Once network configuration is successful, subsequent firmware updates will not require the license again.
Standard function is the common function available under this category. The function point of a no-code development solution is fixed and cannot be modified. You can directly enable the standard function point of the custom solution, and edit them according to product actual function after enabling. Functions that are temporarily unnecessary can be deleted, and can be enabled again after deletion.
The distribution network token needs to be assembled before it can be used by the SDK. Please refer to the interface documentation for instructions on how to assemble it. https://developer.tuya.com/en/docs/cloud/paring-management?id=K95ztzyeyul2w#title-3-API%20address.
Not supported, you can only remove and republish the firmware set to grayscale release.
No more than 50 characters.
In Product Development - Function Definition, you can view the product DP content here.
In the third step of hardware development or firmware management, click "Edit Firmware" to set the firmware upgrade timeout.
Remove the device and reconfigure the network.
It is recommended that you browse the related documents from https://docs.tuya.com/en/iot/open-api/quick-start/quick-start1?id=K95ztz9u9t89n first. Tuya IoT PaaS provides various APIs for developers to obtain their user data and device data. User data generated in the all-in-one App belongs to Tuya, and developers do not have permission to obtain the user data of Tuya official Apps. Tuya provides two systems for developers to obtain device data: custom development system (industry asset system) and smart home PaaS. Industry asset system: Devices are bound to assets, and devices under assets can be moved freely. After an authorized user is added to an asset, the user can log in to the Smart Industry App to control devices under the asset. Smart home PaaS: a. App-based device operation: A developer of an app on Tuya IoT PaaS can operate devices that are bound to the users of the app. b. Product-based device operation: A developer can operate devices that developed by the developer in the Tuya or SmartLife App.
There are several situations: 1. The device to be controlled is not an OEM App created by the developer on the Tuya Open Platform; or the Tuya App is used to pair the device and then control the device through an interface call. solution: 1) First check if the device is paired with Tuya App, and then use the device Id in Tuya App for control; 2) Then check whether the Id of the device to be controlled is correct and whether it is from an OEM App created by its own developer account or an App developed based on the SDK; 3) In the end, you need to make sure that the device and product created by the OEM App created under your developer account can be controlled through the cloud-cloud docking API call. 2. The device requested to be controlled has been removed, restored to factory settings, or re-configured to the network. solution: 1) If the device has been removed, please re-configure the network and add it in the App; 2) Re-obtain the device list and refresh the device ids to be controlled. 3. Interface parameter passing error. solution: Check if the following parameters are correct： 1) The device id is wrong. Note that the device id is not uuid. 2) The area url is wrong. Pay attention to the area where the device is paired. At the same time, call the interface address of the corresponding area.
By default, the API in /v1.0/iot-03/devices/{device_id} is used. If the device is developed for smart home and connected to the Tuya ecosystem through channels such as Tuya, SmartLife, OEM App, App SDK, or OEM WeChat Mini Program, you must change the API to the one in /v1.0/devices/{device_id} and try again.
The "Authorization" tab under App authorization is for connecting industry App SDKs to cloud projects, which is equivalent to authorizing the cloud project data for use by the industry App SDK (SmartLife App SDK does not require authorization) The "Device" tab's associated App refers to linking the App already existing under your account, which is equivalent to authorizing the data under the App to the cloud project.
To enable your OEM App to support third-party login, apply for it from the third-party platform and then configure it on the Tuya developer platform. Facebook：https://developer.tuya.com/en/docs/iot/facebook?id=K989rra7fgg1k Google：https://developer.tuya.com/en/docs/iot/google-login?id=Ka4p2ztytbtpr More reference: Whether OEM App third party login configuration charges? Can I obtain my information when I log in to an OEM app with a third party app account? The app supports login using third-party Facebook accounts, but the portal for third-party account login is not displayed on the login page. Why?
Log in to the Tuya developer platform, select the product on the Product page, and click Product Configuration. Click Settings next to Multilingual and change the DP names.
OEM App: Tuya's developer platform allows you to quickly generate your own-branded apps online without development. app name, logo, and background color. New OEM App functions will be available with continuous updates of the Tuya or SmartLife App to meet your personalized requirements. Custom App: The customer raises the demand, which is developed by the Tuya KAE team, and the module developed by the KAE team is integrated into the Tuya App, and finally package them together into an App. App SDK: R&D capabilities are required to develop an app by using an pp SDK. App SDK is currently developed without charge, it can be released directly.
Please refer to the document: https://developer.tuya.com/en/docs/iot/change-control-instruction-mode?id=Kcbz8lahbg5st.
Function point scale is a function set for displaying decimal points in numerical function points. The reported value is 1, and setting the multiplier to 1 means that one decimal place is 0.1. Setting it to 2 means that two decimal places are 0.01. For example, if you want to display the temperature function point 36.5 ℃ in the device panel, you need to set the function point multiplier to 1. When the device reports 365, the panel will display 36.5.
For example, if the timeout is set to 60 seconds: after the cloud sends a single data packet, if the device does not successfully respond within 60 seconds, the cloud will determine that the OTA has failed; if the device responds correctly, the cloud will reset the 60-second timer (each packet response will trigger a reset of the timer).
CFH certification has the following advantages: 1. Exclusive exposure page for certified products 2. Official Amazon promotion 3. Product information display on Amazon product detail page 4. Priority display on Amazon search page.
Polling time does not support modification.
You can modify the default distribution network name of the product in the Product Configuration - Multilingual - Product Name section of the product creation.
Hello, you need to configure and upload the upgrade file and version information in the background. You can configure it through "Product-Device-Firmware Update". Note: After firmware reconfiguration, it cannot be modified through upgrade.
At present, you can only check the device upgrade status according to the product firmware version. You can go to the firmware OTA record, select the corresponding version, and go to the release page to check the upgrade status. You can get the number of upgraded devices, etc. Please refer to the document for details.
Deleting a cloud project can delete the corresponding cloud authorization.
The hardware id is the number for the unlock method, maintained by the lock-end, each unlock method corresponds to a hardware ID. For example, Password 1 corresponds to 0001, Password 2 corresponds to 0002, Fingerprint 3 corresponds to 0003, Fingerprint 4 corresponds to 0004, Card Key 5 corresponds to 0005. Each unlocking method can have 255 hardware IDs.
On the Product-Development page of the developer platform, click Create Product, enter: https://platform.tuya.com/pmg/solution, select the electrician category to view the supported no-code development solutions.
Currently, the platform does not impose any file size restrictions.
There are two situations regarding devices without regional information: For devices in mainland China: If the app is not allowed to access the location, the device connected to this app may not receive OTA firmware updates. For devices outside mainland China: The country code of a user’s app account is used as the endpoint to receive OTA firmware updates. If the country code does not fall within the specified target regions, the device may not receive OTA firmware updates.
You can click on Protocol parsing specification in the comments section of the function definition page, as shown below:.
Whether the paid advanced capability must be purchased is influenced by two conditions: 1. Whether the hardware product manager has set the advanced capability as mandatory when configuring the solution. 2. For non-mandatory advanced capabilities, whether the customer's product developer has selected the advanced capability during the development process.
The chipset is required to be purchased in two scenarios: 1. The hardware product manager selects the mandatory chipset when delivering the configuration solution. 2. The customer's product developer selects the chipset during the development process. Outside of these two scenarios, the chipset is not required to be purchased.
Available during the device's lifecycle (the warranty period is the same as the module, and if the module is not purchased, the default is 3 years). Beyond the warranty, the service is available but without SLA compensation. As long as the device is functional, the cloud service will be provided. However, if the device is discarded or no longer in use, the cloud service will also stop, and the authorization code bound to the device is non-transferable.
BSMI is the abbreviation for the "Bureau of Standards, Metrology and Inspection" under the Ministry of Economic Affairs of Taiwan. According to the announcement by the Ministry of Economic Affairs of Taiwan, from July 1, 2005, products entering the Taiwan region must comply with regulations on electromagnetic compatibility and safety standards. The BSMI certification in Taiwan is mandatory, and it has requirements for EMC, SAFETY, and RoHS. BSMI is divided into two types: type test and batch inspection. Type testing requires a factory audit. In the case of batch verification, each order undergoes product inspection during customs clearance to verify the consistency of the product and the report. Almost all electronic products need BSMI certification. You can check the specific customs code HS code of goods that can be cleared on the official website. https://civil.bsmi.gov.tw/bsmi_pqn/pqn/uqi6103f.do.
France's NF certification is a quality certification mark issued by the French Association for Standardization (AFNOR, Association Française de Normalisation). This mark indicates that a product or service complies with French national standards (Norme Française, abbreviated as NF). The NF mark is an important quality label in the French market, covering a wide range of product and service categories, including building materials, consumer goods, electrical equipment, furniture, textiles, and sanitary products. For certain product categories, such as fire-fighting equipment and certain building materials, NF certification may be a mandatory requirement for market access in France. To obtain NF certification, products must undergo a series of tests and evaluations to prove that they meet the relevant NF standards. These tests are usually conducted by laboratories recognized by AFNOR. Certified products can use the NF mark on their packaging, which serves as a guarantee of product quality and safety for consumers. NF certification not only helps to enhance the reputation and competitiveness of products in the French market but also reflects the manufacturer's commitment to product quality. Additionally, the NF mark helps to increase consumer trust in the product, thereby promoting sales in the market. Currently, Bureau Veritas (BV) is the certification body in China that can issue NF certificates. The prerequisite for NF certification is that the applicant has an EU representative and the factory has a complete ISO9001 quality control system, a quality control plan for product components and each production procedure, including the process of finished product and production inspection, and it is necessary to determine the form of sales in France and the guarantee documents of the French sales agent. 1. The client submits a written application and provides accurate product information; 2. Preliminary data review, confirmation of costs and certification cycle, and signi.
Vietnam CR certification refers to a type of certification that complies with Vietnam's mandatory product certification system (Conformity Certification, abbreviated as CR). This certification is implemented by the Ministry of Science and Technology of Vietnam, aiming to ensure that products entering the Vietnamese market meet national safety and quality standards. CR certification applies to a range of products, including electrical equipment, construction materials, food safety, mechanical equipment, etc. For these products, manufacturers or importers must demonstrate that their products comply with relevant Vietnamese standards and technical regulations. To obtain CR certification, it is usually necessary to submit detailed product information and technical documents, as well as product test reports issued by laboratories designated or recognized by the Vietnamese government. Once the product has passed the necessary tests and evaluations, it will be awarded the CR certification mark, indicating that the product has been certified and meets Vietnam's requirements.
If the certificate holder's company has a trademark registration certificate for the corresponding certified product category, the trademark can be affixed; if the certified product category does not have a trademark registration certificate, the nameplate of the shipped product may not bear the trademark.
Please verify the certification requirements needed for product shipment, find the certification certificate according to the certification requirements, and ensure that the manufacturer's company information on the certificate is consistent with the certification certificate.
The maximum is no more than 512 bytes.
If you have chosen the no-code development solution, it is not recommended to add custom functions. The firmware functions within the module are fixed, and after adding functions, the module's firmware will not be able to recognize them. Additionally, if the panel does not support it, the added custom functions will not be displayed. If the no-code development solution does not meet your needs, you can select a product type without the "no-code development" label on the page to create your own product.
Currently, a maximum of 40 data points can be created for each product. Not recommended more than 25, otherwise, the device may not be connected. If you need more than 25 data points for a product, contact Tuya technical support for a solution.
When creating a product on the Tuya developer platform, you can indeed select multiple function points according to your specific needs, which can then be combined into a product solution that meets your requirements. However, it is important to note that while you can add multiple function points, they will be combined into a single unified product solution, rather than multiple independent solutions. This ensures that the product's functional configuration is consistent and aligns with the expected usage scenarios. For example, when creating a smart robot vacuum product, you can choose features like laser navigation, suction adjustment, and automatic recharging according to your needs, and these functions will collectively form a complete solution for the robot vacuum. Similarly, when creating other types of products, you can flexibly select and combine the necessary function points based on actual needs. This allows users, even those without professional skills, to quickly and efficiently complete the development of personalized smart products through the various options provided by the platform.
Currently, the knowledge base on the Tuya platform supports AI translation. You can perform single translations or batch multiple translations.
The firmware adopts https encrypted transmission and adopts hmac verification. Generally speaking, the platform will give you what the uploaded file is. All encryption and verification processing modules have been processed, and this file will be sent to the MCU in plaintext.
It is necessary to check the MCU version number reported after the OTA data is received. Whether the OTA under the gateway is finally successful is verified based on the version number reported by the MCU. If the version number is reported incorrectly, the OTA will fail, but the Bluetooth direct connection OTA will not.
Due to the inconsistency between the categories supported by third-party voice platforms and those supported by the Tuya platform, some categories supported by Tuya are not defined on third-party platforms. Therefore, customers need to manually specify the category of the product on the third-party platform. This category generally affects the category name, icon, and voice control through the category displayed on the Alexa App, Google Home App, and Tmall Genie App.
If the product is already activated, voice capability configuration is not supported for now, but you can try to activate it. If the product is not activated, it means that this category is not yet supported. With platform iterations and updates, it will gradually be supported.
Value DP is suitable for linearly adjustable data. Such as: temperature adjustment, the temperature range is 20-40°C.
Due to compliance requirements, device information is isolated in each data center. Therefore, firmware upgrade OTA tasks created on the developer platform need to be published separately in each data center region to take effect globally. For example, if only published in the China data center, users using the US data center will not receive firmware upgrade prompts.
An OTA upgrade updates and iterates the public basic key or the basic program firmware, but not the configuration information.
Not supported. The standard function is bound to some App Interface components, so changing identifiers, function types, and data transfer categories is not supported by the standard function. Other properties are editable.
Contact the relevant project manager or product manager to handle the issue, as the firmware deliverable structure has been restricted to "use the latest version".
No.
Because for the different kinds of products, the distinctions are made for the firmware upgrades as follows: 1. The SoC products do not display the firmware upgrades. 2. Customized firmware products do not display the firmware upgrades. 3. MCU+ general firmware products can only display the MCU firmware uploaded by customers, and will not display the general firmware version bound with the background.
Reason: The corresponding firmware version is removed from the platform but the firmware update is not stopped in advance. Solution: Add the firmware version to the platform and then stop the firmware update deployment.
A key was only created here, it can be left unused without any impact, currently there is no support for deletion.
Upgrade Verification: For a certain version of firmware, it is unknown whether it is functioning normally, so it is necessary to use a small number of devices for verification. When the test devices successfully verify, it indicates that the current firmware version's OTA upgrade function is normal, and a batch upgrade can be carried out. Upgrade Release: After verifying that the firmware has no issues with a small number of devices, it proves that this version of the firmware is problem-free, and the upgrade can be released to push the upgrade to other devices on the market.
Cannot exceed 500.
Currently, firmware Key search is not supported. You need to click on product search. You can find products with a red mark "Firmware retired or off shelf" in the product development section of the IoT platform. Click on the product name to enter the product overview page and check the selected firmware Key and firmware version in the hardware information to determine if it is a version that will be discontinued soon.
You can follow the steps below to make the replacement: Step 1: Debugging new firmware version: IoT platform - Product - Development - Find the corresponding product - Click “Develop” (if your product has been developed, click “Details") - In the "Hardware development" step, find and click “Replace version" in the firmware info - Find the latest firmware version and click "Verify" - Click "OTA Firmware Updates" and follow the instructions on the page for verification. Step 2: Change the firmware version: After verification, go back to the "Hardware development" step of the product, find and click “Replace version" in the firmware info - Find the latest firmware version, click "Verified", click “Select Version", and the operation is completed.
For modules or devices that have already burned the offline firmware version, their use will not be affected. However, to ensure product stability and enhance user experience, it is recommended to upgrade these stock devices to the latest firmware version through the IoT platform. For specific operation steps, please click to view.
It is recommended to confirm whether the server's IP address and the accessed API domain name access address are in the same data center. https://developer.tuya.com/en/docs/iot/api-request?id=Ka4a8uuo1j4t4.
Door locks are a vertical category with separate interface documents, it is recommended to refer to: https://developer.tuya.com/en/docs/cloud/smart-door-lock?id=K9jgsgd4cgysr.
Access ID and Access Secret cannot be changed once created.
For the firmware upgrade of the networking module, select the SDK firmware as the firmware type; For the MCU firmware upgrade, select the MCU firmware as the firmware type.
Currently, both the module firmware and MCU firmware support OTA configuration directly on the platform by the customer, refer to the following link：https://developer.tuya.com/en/docs/iot/firmware-upgrade-operation-guide?id=K93ixsft1w3to.
Yes. You can upgrade the MCU remotely.(Bluetooth Mesh currently does not support MCU remote upgrade).
No. Individual purchase personnel do not have a firmware package and cannot update the firmware. Only product owners can upload firmware packages and perform OTA firmware upgrades. If your account is authorized, contact the authorizing party for a firmware upgrade.
Yes.
A gateway upgrade involves a Wi-Fi module upgrade and a Bluetooth module upgrade. After you receive a Bluetooth upgrade notice, enable Bluetooth on your mobile phone and place the mobile phone as close to the gateway as possible. To upgrade the Wi-Fi module, simply ensure that the gateway has good network connectivity.
The OTA of the Bluetooth device only needs to be connected between the mobile phone and the device, and the OTA data can be sent to the device through the mobile phone.
Please confirm whether the signature sign is correct. Refer to the document signature mechanism: https://developer.tuya.com/en/docs/iot/new-singnature?id=Kbw0q34cs2e5g.
The Tuya Cloud Development Platform API follows the OAuth 2.0 protocol standard and adopts an implicit authorization method. When calling the API, a token (access_token) verification is required and then authorization is required.
Make sure that the latest API package and environment package are used. For more information, see https://developer.tuya.com/en/docs/iot/set-up-postman-environment?id=Ka7o385w1svns.
For the list of supported devices, see https://github.com/tuya/tuya-home-assistant/wiki/Supported-Device-Category?_source=f5f782752be3c4a9157ec47514d6091b.
There is no way to judge the accuracy of the device id on this interface. Please make sure the device id is correct. Or use the GET {{url}}/v1.0/devices/{{device_id}} interface to query.
Please refer to this document to apply: https://docs.tuya.com/en/iot/App-development/oem-App/thirdparty-login-support/facebook?id=K989rra7fgg1k, you can fill in the privacy address of related services The official website of the company.
Please check if the url parameter grant_type=1 is missing.
If you log in to the OEM app with a third-party app account and you do not bound your email address or mobile phone number to the app account, you cannot obtain the email address or mobile phone number.
Both App Knowledge and Product Knowledge support batch import.
It is not affected at present, App exit current policy will not cancel authorization.
The t time in the request header is invalid and has a limit of 5 minutes. If it is automatically obtained, please calibrate the local time of the computer where postman is running.
Tuya supports customized apps. The specific process of customizing apps can be viewed: https://developer.tuya.com/en/docs/iot/app-development/customize-app/customize-app-instruction?id=K989rti7sesm5.
App and applet need to be authorized to the cloud project, please confirm whether the App or applet is associated with the cloud project, refer to the document: https://developer.tuya.com/en/docs/iot/link-devices?id=Ka471nu1sfmkl.
If you have applied the Cloud API key, it is still valid, Tuya will not limit your cloud api request ability for the time being. It is recommended that you use the cloud api key to call Tuya to open the api for verification. At the same time, the Tuya cloud api key is only used for cloud integration solutions, meaning that this key can only be used for Tuya applications to call the Cloud API.
Tuya provides the device log api query, which supports 7-day log for free. Refer to the interface document: https://developer.tuya.com/en/docs/cloud/device-management?id=K9g6rfntdz78a#title-35-Query%20device%20log.
You can query the user's homeid through GET /v1.0/users/{uid}/homes.
Get Android Client ID Visit the Google Developer Platform Find Google Identity Platform Select android option Click Get started Click Config a project, Configure a project Enter your own project name, select the Yes option, click the Next button, and proceed to the next step After entering a project name, click the Next button Choose Android or iOS option Enter the package name of your app and the SHA-1 signature verification (iOS does not need SHA-1) Click the CREAT button to obtain the Client ID authorized by Google Identity Platform Android example iOS example.
Since the uuids of the sub-devices are all device ids, the interface for obtaining the list of sub-devices has no uuid field.
You can get the reported function point data by querying the device status api. If you have high real-time requirements or poll more frequently, you can get real-time device status by accessing Tuya's message push service, but you must have a consumer service To consume the data pushed by Tuya.
For cloud-cloud docking scenarios, developers can apply for cloud API authorization from the platform, using a simple mode to implicitly obtain tokens. Each OAuth token is valid for two hours. After expiration, you need to use refresh_token to replace the previous token. For more details about Get Token For more details about Refresh Token.
When MCU receives the last packet of the upgrade packet with a packet length of zero, it marks the completion of the upgrade packet transmission.
This is because the product is copied to another account. On the product list page of the IoT Platform, after you click Manage Product in the Operation column, you can select Copy Product to Current Space or Copy Product to Another Account to copy a product. If you select Copy Product to Another Account, the product is copied to another account and is not displayed under your account.
It is recommended to cooperate with postman for debugging. We provide request package and environment package, which will improve your development efficiency. At the same time, the encryption of python calculation: import hashlib message = bytes(client_id+t).encode('utf-8') secret = bytes (secret).encode('utf-8') signature = hmac.new(secret, message, hashlib.sha256).hexdigest().upper().
Under normal circumstances, there are currently no restrictions. Tuya's active protection service will monitor abnormal registrations, and we will appropriately limit them on the premise of notifying you.
In order to better help you to expand the global smart product business, Tuya has launched the “Tuya Full Link Smart Product Value-Added Services” program, based on the powerful Tuya ecology, innovating platform service models, and creating global competition for smart products to provide full-link services for the global market. You can choose what you want in value-added service website: https://www.tuya.com/vas/. Also, you can select the service category to find the related services under that category.
Yes, you can perform the firmware upgrade and OTA upgrade after mass production. Mass production does not affect firmware upgrades.
If you want to implement the power-off protection function, we recommend that you communicate with the corresponding business and product managers. Generally, this function can be implemented for products such as sockets and lights. It depends on products and their functions.
The product name is the default. After configuring multiple languages, the multiple languages will be given priority.
The post request needs to add a parameter Content-Type in the header: application/json.
The country code must correspond to the url of the corresponding area. You can get the url of the area corresponding to the country code by GET {{url}}/v1.0/all-countries.
When registering a user, please fill in the numeric code for country_code, such as China: 86.
The password reset is the same interface as the registered user, and the password can be reset after re-registering with the new password. You can refer to:https://support.tuya.com/en/help/_detail/K9g77yne1hie4.
API permissions can be purchased and activated immediately. After expiration, you can apply to extend the trial version or upgrade to a higher version. After submitting the application, we will review and approve it within 1-2 working days.
During the production test process, the device only scans the router and does not connect, so in theory, there is no limit to the number of devices that can be simultaneously produced and tested within the signal coverage area, but it should be noted that the number of devices that are powered on at the same time should not exceed 200, so as to avoid the device Interference between each other, when there are many production and test equipment under one route, you can power on in batches.
The sign is valid for 5 min.
Point-to-point ID, SDK above version 3.0.0 does not need to fill in P2P ID, and the cloud will automatically assign it.
The concept of owner_id is the home id or homeid.
OTA (Over-the-Air) is an over-the-air download technology that remotely updates and upgrades software programs for devices through the network. In simple terms, it means firmware upgrade. Tuya supports OTA, firmware upgrade is divided into wireless and wired, and FOTA is wireless firmware upgrade.
Yes, you only need to set the macro definition PACKAGE_SIZE in the SDK, and you can set the length of 256, 512, 1024.
Make sure the version number of MCU replied is 03, if reply 00, it is the old version of the protocol, and it will not match the new version of the protocol.
Failure case 1: The interaction data between the MCU and the module only has the 0x0A command word, and there is no 0x0B command word returned by the MCU. Solution: This is because the Wi-Fi_UART_QUEUE_LMT setting in protocol.h in the transplanted Wi-Fi-SDK is too small, you can modify it to be larger. Note: How big is PACKAGE_SIZE to choose, Wi-Fi_UART_RECV_BUF_LMT should also choose the corresponding size. Failure case 2: App interface upgrade interface cannot reach 100%. Solution: Check whether the firmware version returned by MCU is consistent with the platform (Wi-Fi module sends all upgrade packages, and resend 01. The MCU needs to reply the software version number in the product information within one minute with the upgraded MCU Version number, the version number needs to be consistent with the version number configured and upgraded in the Tuya background). Others: 1. Confirm that the device firmware has been properly developed for SDK docking. 2. Verify whether the device firmware's version number is later than that of the OTA firmware. 3. Verify whether the 2.4G network used by the device is available and stable. 4. Confirm that the device ID and PID have been correctly configured in the backend.
qt is a generic type of product definition, please provide pid, contact Tuya staff to change the background configuration.
Facebook can only be used outside China. When the configuration is correct, the app automatically checks the mobile phone number, network environment, and login account area. The portal for third-party account login is displayed only when the account is an international one.
Due to network problems, in order to provide better network services, Hong Kong and China use different URLs. For Hong Kong, please use the Americas server. URL: pulsar+ssl://mqe.tuyaus.com:7285/.
Interface bug fixes, resulting in the need to add the discovery_time path parameter, marking the start polling time, you can directly use the time allowed by the gateway to access the network interface as the parameter, but the time stamp is 10.
Yes. Log in to Tuya IoT Platform, choose App Multi-language App Language App Language Pack, and modify the export mode.
①The member id is the user's number, which is assigned by the cloud;The hardware id is the number of the unlocking method, which is assigned by the lock-side; ②A member id can have multiple unlocking methods, that is, corresponding to multiple hardware ids; a hardware id corresponds to only one member id.
Yes. In the knowledge list, select knowledge to be copied and click Copy. In the displayed Copy Knowledge dialog box, select the target knowledge base and product category and click OK.
Using Alexa's voice configuration interface as an example (as shown in the picture), you need to select and modify the corresponding category on the voice capability configuration page, and choose the category you want. After the voice is published, the icon of the selected corresponding device will be synchronized in the third-party app.
Hello, please go to the product list page (https://iot.tuya.com/pmg/list), click on the corresponding product title in the list to enter the product overview page, where you can see the voice services that have been activated for the product.
It is recommended that you enter the internal or customer product model to facilitate product maintenance and order management. The product model will not be displayed in the app.
Cloud timing function, set by APP, without MCU for embedded development. Webpage jump function, you can link to product mall or factory website,there are also advanced cloud functions provided by each hardware solution, etc.
The value change curve displayed on the panel needs to meet two conditions: 1. The panel supports the curve display function. If the public version of the panel does not support this function, you can apply for panel customization. 2. This value DP opens the statistical function. Please attach the PID and the value to be opened for this function and submit a work order application.
In big-endian mode, such as a temperature value of 25°, the 10th byte to the 13th byte are 0x00 0x00 0x00 0x19.
An identifier is the code value of a data point and is used in managing multi-language app function display. An identifier consists of letters, digits, and underscores, and starts with a letter. The identifier is also used for communication between the APP, the cloud, and the module. If the product supports third-party speakers, the identifier must use the standardized name of Tuya.
For details on how to update the DP name of the device, please click to view.
The module will filter the same set of data at the same dp point, and replace it with one data to report.
Configure in the multi-language management under IoT platform expansion function.
Countdown means to count time from a time point in the future to the present. It is used to indicate the time remaining before an event. For example, if the socket is now switched on and the user creates a 5-minute countdown task, the socket will be switched off after 5 minutes. The countdown function will be canceled if the user switches off or reset the device during the set time period.
You can find product solutions that meet your needs at the Solution Center, and by clicking "Get Product Solution", you can apply the features of that solution to your own product. On this basis, you can also customize functions. (Customization is not supported for no-code solutions).
You can view its functions on the Function Definition page to view its functions.
Direct Gradient: The change time is executed within 15 minutes after reaching the target node, with a 10% change in state difference every 90 seconds (For example: Time node A (7:00 am, brightness value 20%, color temperature value 30%); Time node B (8:00 am, brightness value 30%, color temperature value 40%); Time node C (9:00 am, brightness value 40%, color temperature value 50%) changes from node A state to node B state (8.00-8.15, brightness 20-30% gradient, color temperature30% -40% gradient) Full process gradient: The change time is the interval between two nodes, and the state value changes linearly (For example: Time node A (7:00 am, brightness value 20%, color temperature value 30%); Time node B (8:00 am, brightness value 30%, color temperature value 40%); Time node C (9:00 am, brightness value 40%, color temperature value 50%) changes from node A state to node B state (7.00-8.00, brightness 20-30% gradient, color temperature 30% -40% gradient).
OTA upgrade requires a minimum speed of 20KB or above.
Firmware upgrade refers to upgrading the embedded firmware of portable devices such as music players. Firmware upgrades can improve device functions, enhance device stability, and patch device vulnerabilities.
Every time the device connects to the Internet, it will scan whether there is a silent upgrade. Upgrade if available, and skip if not. It is invisible to the user who uses it.
The OTA package is pulled each time the device is powered on. The interval is generally 6 hours and varies with different devices.
Please check whether you have added the country code to the mobile number. For example, you must add +86 before the mobile numbers in China.
You cannot disassociate firmware that has been updated. To disassociate it, submit a service ticket and provide the following information: PID: Firmware key: Firmware version:.
No, it is not supported. The update of different firmware is performed in different channels, while only one channel can be opened at a time. However, firmware versions after the update of multiple channels are allowed to be reported at a time. Therefore, you can only update the firmware one by one.
This depends on the region of the data center of the IoT platform when a new version of device firmware is pushed. If the region of the data center is China, only accounts in China can receive the firmware update notification. To send the firmware update notification to accounts in the US, the region of the data center must be changed to the US before the firmware is released.
Because the Home Assistant-Tuya plugin does not support your device category, so Home Assistant does not show your device. You can set up a scene (Tap-to-Run) on the App and your device will sync the scene to Home Assistant. Supported Device Category：https://github.com/tuya/tuya-home-assistant/wiki/Supported-Device-Category?_source=f5f782752be3c4a9157ec47514d6091b.
The network distribution logic and network distribution steps of each product are different. When the end user operates the network configuration, it is recommended to select the category of the equipment and follow the instructions on the page to configure the network to reduce the failure rate of the network distribution. However, if both products are switches and the network distribution method is the same, both can be used. Therefore, if you have multiple products of the same category, it is recommended that you write a bit more broadly (for example: lights, switches) when filling in the name of the distribution list.
If the smart speaker icon is not displayed, the smart speaker access service you applied for is not activated. Log in to the Tuya Smart platform, click Service Market and My Services, and then click Management next to a smart speaker. On the page that appears, if the status of the corresponding product is Processing, the smart speaker access service cannot be activated automatically. Contact Tuya personnel to activate the access service. Typically, it takes three workdays to activate the access service.
The standard function is bound to the panel component, some of which can be deleted, and the custom function will not be displayed in the public version of the panel.
Advanced features require a paid purchase. At the same time, you need to choose a panel that supports advanced features and configure it in the second step of product development, "Device Interaction".
No. Flashing supports empty modules or different firmware, while firmware upgrade is an upgrade of the firmware itself. The precondition for the firmware upgrade is that the firmware exists in the module.
YouTube：https://youtu.be/lqBkhaBWo6E After you log in to the IoT platform, find "Value Added" in the leftmost navigation bar, then click to enter the value-added service page, and find "Smart Voice Service" in the service category, select the third party you need to subscribe to, and you can complete the activation through online operations For details, visit https://developer.tuya.com/en/docs/iot/service-market/smart-speaker/third-access/thirdaccess?id=K9j6yqoadn2ad.
The length of the warning data is determined by the type of fault, and the bit indicates whether the warning occurs. Assuming that the length is 1 byte, and each of the bit 0-bit 7 can represent a warning. Setting to 1 to indicate that a warning occurred, and setting to 0 to indicate no warning. A total of 8 types of warnings are supported.
Boolean (BOOL) data refers to a binary variable that is either true or false. Such as: switch function, on/off.
No, it is not necessary. Re-burning the authorization is only required when modifying the Json configuration. Just pull the latest firmware configuration.
Yes. A gateway can perform an OTA update for connected sub-devices simultaneously, which has been applied to commercial lighting SaaS products. According to testing and verification, it takes about 2 hours to upgrade 200 sub-devices. Compared with the one-by-one update (5 minutes for each) of sub-devices, 87.5% time is saved, significantly improving the efficiency.
Canary release is a release solution for smooth transition. Tuya supports the following canary release types: Canary release by ratio: OTA canary release is performed based on the ratio of devices activated under a PID. Canary release by quantity: OTA update detection is stopped and then OTA canary release is performed when the number of devices to be updated reaches the preset value.
You can check the list of categories currently supported by Home Assistant: https://github.com/tuya/tuya-home-assistant/wiki/Supported-Device-Category?_source=f5f782752be3c4a9157ec47514d6091b Tuya will continue to support other categories, you can continue to pay attention.
Update detection on the App is triggered after you enter the device panel.
Please check whether the product is available in the queried region. For example, a product dedicated to the U.S. cannot be queried in China.
No, if the json configuration is modified, the Tuya module needs to be re-burned to take effect.
In order to send invitation links to WeChat friends, the OEM App needs to support WeChat login. Please find the information related to configuring WeChat login in your IoT platform. Once the App supports WeChat login, you will be able to send invitation links to WeChat friends while inviting family members.
Currently, for electrical products, both random timing and cycle timing can be enabled in conjunction with the weekly schedule. After creating random and cycle scheduled tasks, you can select the specific days of the week on which the scheduled tasks are run, saving effort and improving efficiency. If you do not enable a weekly schedule, the task will be run only once.
Cloud functions: Timer and web page redirection are available. The Tuya Cloud's timer function allows you to set the on/off time and intervals and does not require hardware development. The web page redirection function allows you to go to a web page from the App, for example, go to an online mall or the product user manual page.
Hello, if you can't find the category you want, you can click "Can't find the category?" under the category of the product creation page, then fill in the information on the page and submit it. Tuya staff will review it.
You can remove some secondary DPs to ensure the product connection. If you use a custom app panel, combine some DPs and use raw DPs for transmission.
The upgradeType parameter can have one of the following values: 0: upgrade reminder; 1: silent upgrade; 2: forced upgrade; 3: check for upgrade.
Incremental update applies only to the device firmware that adopts Tuya's incremental update-enabled SDKs. It is mainly applied in NB-IoT and Cat.1 products.
All release is not affected by the time difference. The device can check for updates after being activated. However, the update is not applied to a device activated after a canary release. Devices outside China may involve a time difference in data sync, but the time difference may not exceed several minutes.
No firmware update notification will be prompted when the device is offline.
After you add a DP, you need to set the language for the DP in Advanced Features—Multilingual. For more details, please see: https://developer.tuya.com/en/docs/iot/configure-in-platform/advanced-features/product-language?id=K93ixsjagr67p.
A data point (DP) represents a smart device function. DPs are of different data types — for example, Boolean, enum, and value — and have read and write attributes. For example, a 2-way switch has two Boolean DPs, and each DP has either a true or false value, which is readable and writable.
Defining product functions is the first step for product development. Usually product functions include standard, custom, and advanced functions. For details, visit https://docs.tuya.com/en/iot/configure-in-platform/function-definition/standard-functions.
No. The price of the license changes with the product category and communication mode.
Currently, there is no function of restricting device upgrades for device IDs, It can be assigned to some devices to upgrade, or all of them can be upgraded.
A device shadow is the projection of a device in the cloud, which also contains the device firmware information. The relationship between a device shadow and OTA is as follows: When a device is activated, the device reports the firmware information to the cloud. Then, the cloud creates a shadow for the device. When detecting firmware updates, the cloud compares the firmware version of the device shadow with the available version to determine whether an update is required. When pushing the update to the device, the cloud delivers the new firmware to the device by using multiple message exchanges. For more information, see the OTA protocol. After the device is updated, it reports the latest firmware information to the cloud, and the cloud updates the device shadow.
If no specific update time is specified, the update time is when the device obtains the OTA package. Generally, the device checks for updates at an interval of 8 hours. The check interval varies with devices.
Yes. You can select Custom Category, click Create a custom category, configure related product information, and upload the image.
You can directly query and configure the categories supported by Alexa platform on the voice console, if there is no category you want to display, you can choose other.
For no-code development products, there is no need to re-flash the module when deleting a DP, adding a DP, or modifying DP properties. Re-pairing the network will synchronize the changes.
Boolean, value, enum, fault, string, and raw.
The maximum value of a function definition on Tuya Developer Platform is 2147483647.
We build white-label Tuya apps, IoT dashboards, and custom integrations for your business.
🚀 Schedule a Call