Homebridge Tuya IR

Forked from prasad-edlabadka/homebridge-tuya-ir to improve Fan control experience.

Control your Tuya Smart IR based devices in HomeKit. Also works with Smart Home IR Blaster. You can add multiple Smart IR device to single configuration.

Supported Devices

• Air Conditioner (Only pre-configured vendor. No DIY devices)
• Fan (Pre-configured and DIY devices)
  • Fan Remote Settings (The below settings are exclusively for Fan remote)
    • Vertical Swing: If the fan supports vertical swing. Default is No.
    • Can this fan remember swing mode: For some fan models (e.g. Dyson Cool), horitzontal swing status is not remembered after turning off the fan. Default is No.
    • Can Swing/Speed button turn on the fan: For some fan models (e.g. Dyson Cool), you can turn on the fan by pressing Speed or Swing buttons. Default is No.
  • Custom keys mapping (When setting up the remote via Tuya/Smart Life apps):
    • speed_up: Increase fan speed
    • speed_down: Decrease fan speed
    • vertical_swing: Enable vertical swing (Only works if "Vertical Swing" is checked)
• DIY Devices. Each learned button will be added a switch.
• All other Pre-configured remotes will be added as switch to turn them on and off only. No other feature. (No DIY devices)

Installation Instructions

You will need to build and install this plugin manually as it is not yet published to NPM

Add Smart IR and Remotes

Download Tuya Smart app and add your Smart IR device based on OEM documentation and add remotes you want to control using the Smart IR device.

Create Tuya IoT Project

• Follow steps on Tuya website to create your Tuya Cloud project and assign your devices to the project.
• Login to your Tuya IoT account and open the project. Each remote is shown as separate device.
• The Smart IR device will also be shown as a separate device.
• Copy the device ID for Smart IR and remotes as shown in the image below. You will need to these to configure the plugin.

Authorization

Tuya IoT Platform You need to attach multiple services to your Tuya IOT project.

1. Search for "IR Control Hub Open Service" in Tuya IoT Platform Service
2. Subscribe to the service, authorize the project you are working on.

Repeat the steps for all the services in the following image

Configuration

UI

1. Navigate to the Plugins page in homebridge-config-ui-x.
2. Click the Settings button for the Tuya IR plugin.
3. Add your devices
4. Add device parameters
5. Restart Homebridge for the changes to take effect.

Manual

1. Edit the config.json file to add your devices and parameters.
2. Sample Configuration

"platforms": [
    {
        "name": "TuyaIR",
        "tuyaAPIClientId": "Your Tuya Client ID",
        "tuyaAPISecret": "Your Tuya API Secret",
        "deviceRegion": "eu",
        "smartIR": [
            {
                "deviceId": "xxxxxxx",
                "autoFetchRemotesFromServer": false,
                "configuredRemotes": [
                    {
                        "id": "xxxxxxx",
                        "diy": false,
                        "model": "Sample",
                        "brand": "Sample Brand"
                    },
                    {
                        "id": "xxxxxx",
                        "diy": false,
                        "model": "Sample",
                        "brand": "Sample Brand"
                    }
                ]
            }
        ],
        "platform": "TuyaIR"
    }
]

2. Restart Homebridge

Known Issues

1. Tuya API doesn't always return devices added to Smart IR based on OEM hardware. Thus, you need to add them in your app and then provide IDs in the plugin configuration. This is configuruable in the configuration.

Contributing

If you have new accessory logic for a new device, please add a function defined by manufacturer, and describe your changes in the readME file.

Donating

Please donate to a local pet shelter, or food pantry. It's been a wild time, but we can do our part by helping others.