Home Assistant Tuya Smart IR Air Conditioner Integration

This is a custom integration to control IR-based air conditioners from Tuya via Home Assistant tested with the following devices:

This repository was cloned from DavidIlie's project because it had not been updated for some time.

Installation using HACS

We recommend installing via Home Assistant Community Store (HACS) to always receive the latest integration updates. Add this repository to your custom repositories or click the button below (requires My Homeassistant setup).

Retrieve correct information from Tuya IoT website

Before you start setting up the integration, you will need some information that can be retrieved from the Tuya IoT platform. The steps to retrieve the information you need are the following:

• connect to https://platform.tuya.com ;
• from the left menu select Cloud -> Development;
• create a project or select the existing one (making sure it is connected to SmartLife/Tuya app);
• from the Overview tab retrieve the Access ID, Access Secret and Data Center data of the project (which will be used for the installation of the platform);
• from the Service API tab, verify that the following APIs are active (verify by clicking on View details, the API status is In Service for each of them):
  • IoT Core;
  • IR Control Hub Open Service.
• from the Devices tab you will see all your devices connected to SmartLife/Tuya app and you will have to search for the following devices:
  • the HUB IR device (called InfraredID by the integration);
  • the air conditioner connected to the HUB (called ClimateID by the integration).

The last point must be repeated for each air conditioner that must be configured.

Platform configuration

Add the following sections in your configuration.yaml and restart HA (Tuya Access ID, Tuya Access Secret can be found on the Tuya IoT Website):

Name	Type	Description	Required
access_id	string	Tuya access ID.	Yes
access_secret	string	Tuya access secret.	Yes
country	string	Tuya country API: EU (Europe), US (America), IN (India), CN (China)	Yes

Example

tuya_smart_ir_ac:
  access_id: "tuya_access_id_example"
  access_secret: "tuya_access_secret_example"
  country: "EU"

Integration configuration

After the platform has been configured, you can add air conditioners using the Integrations configuration UI. Go to Settings / Devices & Services and press the Add Integration button, or click the shortcut button below (requires My Homeassistant configured).

The interface will show a form to fill in with the following information:

Name	Description
Infrared ID	IR HUB Device ID (retrieved from Tuya Platform).
Climate ID	Air Conditioner Device ID (retrieved from Tuya Platform).
Air conditioner name	Name of the device that will be displayed in Home Assistant.
Temperature sensor	Name of the temperature sensor to pair with the device.
Humidity sensor	Name of the humidity sensor to pair with the device.
Minimum temperature	Minimum set point availabl supported by the device.
Maximum temperature	Maximum set point available supported by the device.
Step temperature	Step size for temperature set point supported by the device.
HVAC modes supported	HVAC modes supported by the device.
FAN modes supported	FAN modes supported by the device.
Default temperatures when setting HVAC mode	Enable default temperature settings when changing HVAC modes to auto, cool and heat.
Default fan speed when setting HVAC mode	Enable default fan speed settings when changing HVAC modes.
Force power on when setting hvac mode	Send a double power command when setting an HVAC mode (fixes compatibility issues with some devices).
Set minimum temperature in dry mode	Set temperature to 16° when DRY MODE is selected (fixes compatibility issues with some devices).
Set minimum fan mode in dry mode	Set fan speed to LOW when DRY MODE is selected (fixes compatibility issues with some devices).

Debug

It is possible to activate debug mode by adding the following lines in your configuration.yaml file:

logger:
  # Begging of lines to add
  logs:
    custom_components.tuya_smart_ir_ac: debug
  # End of lines to add

Home Assistant needs to be restarted after this change.

Contributions are welcome!

If you have ideas to contribute to the project, open a pull request and we will evaluate together how to implement the improvement. Thanks!

Support me

I dedicate my free time to the development and support for this integration, if you appreciate my work and want to support me, you can buy me a coffee. Thanks!