Set Up Tuya Integration (Stable) in Home Assistant

This topic describes how to install the official Tuya integration in Home Assistant.

Requirements

This integration only supports the basic product categories, such as switches, lights, fans, thermometers, and hygrometers. For more information, go to GitHub to check the supported device categories.

It is not guaranteed that all the Powered by Tuya devices can work with the Home Assistant Integration. If your device is not supported by the integration, see this tutorial to develop the driver yourself.

Billing

For now, you can extend the trial period multiple times. However, Tuya does not promise it to be permanent. As the integration will make relevant adjustments accoding to the Tuya IoT Development Platform rules in the following years.

Prerequisites

• You have installed Python 3.8 (including python3-dev) or a later version on your system.
• You have created a cloud project of Smart Home type on the Tuya IoT Development Platform. For more information, see Configuration Wizard of Smart Home PaaS.

  • You have added at least one real device or one virtual device.

  • You have authorized your project to use the required API services.

    If your cloud project was created before May 25, 2021, you need to perform project migration. For more information, see How to Migrate to the Tuya Home Assistant Integration.

Procedure

Install Home Assistant Core

After you have installed Home Assistant Core (v2021.10.4 or later), you can search for and set up the Tuya integration in Home Assistant.

Set up

1. Enter localhost:8123 into the address bar in your browser and hit Enter to connect to Home Assistant.

2. Register and log in.

3. Click Configuration > Integrations.

   

4. On the Integrations page in the configurations panel, click the + button in the lower right.

   

5. Search for Tuya and click the icon to install.

   

6. Enter your Tuya credentials.

   

   Parameters	Description
   Country	Select the region of your account of the Smart Life app. Note: Open the mobile app and tap Me > Setting > Account and Security > Region.
   Tuya IoT Access ID and Tuya IoT Access Secret	Go to the Tuya IoT Development Platform and select your cloud project. Click the Overview tab and find the Access ID and Access Secret in the Authorization Key area.
   Account	Your account of the Smart Life app.
   Password	Your password for the Smart Life app.

   The mobile app mentioned in the above table must be the one you use to scan the QR code for linking devices to your cloud project on the Tuya IoT Development Platform.

7. Click Submit.

   Click Overview in the sidebar on the left. You will find all the smart devices linked to your cloud project created on the Tuya IoT Development Platform.

   

FAQs

I got an error saying ‘Config flow could not be loaded’ when setting up the Tuya integration. How to fix it?

Go to custom_components under the Home Assistant directory and delete the tuya_v2 folder. Restart Home Assistant and try to install the integration again.

I got an error shown in the following screenshot when I tried to scan a QR code to link my devices to my cloud project. How to fix it?

This is because the data center you selected for your cloud project cannot serve the region of your app account. You must switch to the correct data center and scan the QR code again.

1. Here is how to find the region: open the Smart Life app and tap Me > Setting > Account and Security > Region.

   

2. See Mappings Between OEM App Accounts and Data Centers and find the data center that can serve your region.

3. (Optional) If you do not find the data center you want to use, click the Overview tab and then Edit to add data centers.

   

4. Click the Devices tab > Link Tuya App Account. Select the correct data center from the drop-down menu in the top right corner and click Add App Account.

   

5. Scan the QR code again to link devices.

Will I be billed after the free trial of the API service expires?

• After your API service expires, go to Cloud > My Services on the Tuya IoT Development Platform to request extending your API service by up to 6 months.

  1. Click Extend Trial Period.

     

  2. Complete this form.

     

  3. You will get the result within one working day.

     

• The Trial Edition allows you to use all free API services but puts limits on the quota of API calls. For more information about the quota, see Pricing.

How to deal with the following errors?

Error code sample:

[tuya-openapi] Response: {
  "code": 2406,
  "msg": "skill id invalid",
  "success": false,
  "t": 1624477851701
}

How to get the diagnostic log?

You can get the diagnostic log with the following two options.

• Option 1: Edit the configuration file. You can get the complete log but you need to restart Home Assistant after editing the file.

  1. Copy the following code to the configuration.yaml and save.

     logger:
       default: critical
       logs:
         custom_components.tuya_v2: debug
     

  2. After your Home Assistant is restarted, you can check the log of Tuya integration from the Terminal or the home-assistant.log file.

     

• Option 2: Export the log directly.

  1. On the homepage of the Home Assistant, choose Configurations > Devices & Services.

     

  2. Find the Tuya integration and click ⋮ > Download diagnostics to download the log file.

     

What categories does Tuya Home Assistant Integration support?

The following table lists the supported product categories: