Skip to content

Control Tuya IR based air conditioners from Home Assistant

License

Notifications You must be signed in to change notification settings

EnzoD86/tuya-smart-ir-ac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Home Assistant Tuya Smart IR Air Conditioner Integration

hacs_badge Stable Donate

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

344095726-d887c8a1-9e66-4552-835e-bbe333482a85

349898076-b50941eb-8681-4425-ba35-86eafa2ae182

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).

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

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).

Add Integration to your Home Assistant instance.

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!

Buy Me A Coffee