Skip to content

Latest commit

 

History

History
105 lines (59 loc) · 5.3 KB

info.md

File metadata and controls

105 lines (59 loc) · 5.3 KB
Raw

Tuya Home Assistant Integration

hacs_badge

Tuya Home Assistant integration is developed for controlling Powered by Tuya (PBT) devices using Tuya Open API, officially maintained by the Tuya Developer Team.

Supported Tuya Device Types

The following Tuya Device types are currently supported by this integration:

  • Light: Supports Tuya Wi-Fi light devices.
  • Switch: Supports Tuya Wi-Fi switch devices, like switch, socket and power strip
  • Cover: Supports Tuya cover devices like smart curtain motor.
  • Climate: Supports Tuya climate devices like air conditioner and heater.
  • Fan: Support Tuya fan devices.

Please check the Develop Tuya-Compatible Home Assistant Drivers and Home Assistant Entity tutorials to develop more drivers for the Tuya Home Assistant Integration and support more Tuya devices.

Tuya Home Assistant Integration User Guide

For more information, please check How to Use Tuya Home Assistant Integration.

Installation

1. Home Assistant Installation

Please refer to the Home Assistant Official Installation documentation to install Home Assistant Core.

You can also get help from Set up Home Assistant Development Environment on Raspberry Pi in Tuya Developer Demo Center.

2. Tuya Home Assistant Integration Installation

There are two methods to install the integration:

  1. Home Assistant Custom Components Installation
  2. Install by HACS

2.1 Home Assistant Custom Components Installation

Download this tuya-home-assistant repo, unzip it, and copy the custom_components/tuya/ folder to the HomeAssistant configuration directory, e.g. ~/.homeassistant

2.2 Install by HACS

1. HACS Install

2. HACS Initial Configuration

3. HACS -> Integrations -> ... -> Custom repositories

4. Input the tuya-home-assistant GitHub URL: https://github.com/tuya/tuya-home-assistant and select Integration as the Category type, then click ADD.

5. Click INSTALL

2.3 Restart Home Assistant

Configuration -> Server Controls -> RESTART

2.4 Activate Tuya Integration

Configuration -> Integrations -> ADD INTEGRATION -> Tuya Integration

3. Enter your Tuya credential

In the Tuya Integration window, select Smart Home PaaS.

Get the Tuya credential info by following the Tuya IoT Platform Configuration Guide Using Smart Home PaaS and fill in the following window.

Start Home Assistant

Go to the home assistant installation folder ~/hass and use the following command to activate it and run the hass service:

➜  hass source bin/activate
(hass) ➜  hass hass

For more information, please refer to the Home Assistant Core tutorial for the startup process and run hass.

Link Tuya Devices to Home Assistant

Please download and use the Tuya Smart or Tuya Smart Life apps to pair Tuya devices to the Home Assistant for controlling. You can check the following links to download the apps.

Issue feedback

You can give feedback on issues you encounter via Github Issue.