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 addHome 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!
