Contact Us
Log In


Last Updated on : 2021-10-30 06:29:17

This topic describes how to troubleshoot problems that might occur when you develop with the Tuya IoT Development Platform or debug embedded software.

Operations on the platform

How to debug using a virtual device?

You can consider the virtual device as a prototype you have designed for a real device. If you do not have a real device at hand, you can use the Tuya Smart app to test or demonstrate product features on the virtual device. The following steps show how to use it for debugging:

  1. Log in to the Tuya IoT Development Platform and go to the product list.

  2. Choose a product in Developing and click Continue to Develop on the Operation column.

  3. Click the Device Debugging tab.

  4. Find List of Virtual Devices and click Add Virtual Device. Open the Tuya Smart app and scan the QR code to add a virtual device.


  5. Click Debug to test two-way communication between the device and cloud. Changing the value of a parameter can simulate the process of status reporting from a device. You can also use the Tuya Smart app to test device control.


    The virtual device only serves as an emulator to help you test or demonstrate how product features or control panels work, which cannot thoroughly verify the device’s functionality. It is recommended you use the virtual device for debugging control panels only. The name of a virtual device is suffixed with -vdevo.

How to get the device logs?

If you get errors or exceptions when debugging, you can search the device logs on the platform to troubleshoot problems. The following steps show how to get device logs:

  1. Log in to the Tuya IoT Development Platform and go to the product list.

  2. Click Product > Device Logs in the left navigation pane.


  3. Enter the device ID and search.


    You can only search logs of paired devices under the currently logged-in account by device IDs. The free edition allows you to search logs for the last 7 days.

Product features

What is product function?

  • Standard function: the common functions of a product.
  • Custom function: the user-defined function if standard functions cannot meet your needs.
  • Cloud function: supports cloud-based schedule and navigation link setting.

For more information, see Product Functions.

What is multilingual UI text and how can I manage it?

To reach a global audience, you can customize multilingual UI text that appeals to a target market, including product name, data point, device panel, network connection guides, device message notification, and firmware upgrade. For more information, see Configure Multilingual UI.

How to send push notifications like alerts to my users?

You can set rules to trigger an automated push notification. For example, set a threshold for a function. If the preset value is reached, the user will receive an alert from the mobile phone. For more information, see Configure Push Notification.

How to set a device pairing guide?

You can edit the pairing guide as needed on the platform. A QR code will be generated accordingly, which can be put on your user manual. For more information, see Configure Pairing Information.

How to set a toggle?

You can set toggles for your products to enable shortcuts for quick device control. For more information, see Enable Toggle.

How to set smart scenes?

You can specify functions that can be used to set up automation. For example, a function is set as a trigger or a task. For more information, see Configure Scene Linkage.

What testing methods can I use?

Tuya provides the Cloud Test app and user cases. For more information, see Test Services.

Common issues

Troubleshoot pairing failure

  1. Make sure you use the mobile app to add a Bluetooth device as instructed instead of the ordinary Bluetooth pairing with your mobile phone.

  2. Check if you enable Wi-Fi on the mobile phone and the router works properly.

  3. Your mobile phone must be connected to the internet because the mobile app must access the cloud to activate the device to add it.

  4. For Android devices, location access must be allowed.

    Android made it mandatory for any app to have location permissions in order to work with Bluetooth devices.

  5. Check if the device has been added to the mobile app. You can reset this device and try to pair it again.

  6. If a Bluetooth gateway is used, try to make the distance between the gateway and Bluetooth devices less than three meters.

  7. Check if the Bluetooth device is being controlled by other users.

  8. Make sure the Bluetooth device you are trying to add is ‘Powered by Tuya’.

Troubleshoot reporting failure

  • Check if the device is turned on properly and connected to the internet.
  • Check the data format. For more information, see Data units.
  • If you have edited the data point (DP) on the platform, remove the device and pair again.

Service and support

Service and support is designed to help you quickly get the information or knowledge you are looking for and troubleshoot problems that occur when you develop with Tuya’s solutions. You can track the progress of your submitted ticket and provide your feedback here.

  • Docs Center: You can find the required documentation that helps your development and production.
  • Help Center: You can find detailed answers to command questions.
  • Bulletin Board: You can find the latest platform announcements.
  • Q&A Bot: Tuya’s smart robot.
  • Technical Ticket: Tuya’s technical team will help you troubleshoot problems.
  • Online service: Contact us to speed up the response to your request.