homebridge-haieracbridge-platform

homebridge-haieracbridge-platform is plugin for homebridge which allows you to control Haier AC devices from HomeKit! It should work with all AC devices controlled by SmartAir2 app.

Features

• HomeKit automation
• Automatic detection of Haier devices added in your SmartAir2 app
• Turn AC on / off
• Show temperature values
• Show relative humidity if AC supports it
• Set every available mode COOL, HEAT, SMART, DRY, FAN
• Control fan speed, even auto
• Ability to control swing mode in every axis
• Syncing values with AC's remote
• Ability to force health mode
• Ability to turn on\off option to enable fan mode
• Ability to turn on\off option to enable dry mode
• After disabling automatic fan speed plugin will restore previously set value
• Custom language options

Drawbacks

To use this plugin you will need HaierACBridge app made by me. My solution requires having a dedicated Android device with app running in background in the same subnet as homebridge instance. If you want to access devices directly please use bstuff/haier-ac-remote instead.

Installation

1. Download HaierACBridge app
2. Install and login in HaierACBridge app
3. Get token and IP address from app
4. Install this plugin by running npm install -g homebridge-haieracbridge-platform or by finding it in homebridge-config-ui-x
5. Update your homebridge config.json (refer to config section) or configure plugin in homebridge-config-ui-x

NOTE: This plugin is supported by homebridge-config-ui-x plugin

Config

Example config

{
  "platform": "HaierACBridge",
  "ip": "192.168.0.1",
  "token": "nuxr2qNzdMb9OJX",
  "polling": 4,
  "useFanMode": true,
  "useDryMode": true,
  "healthModeType": "FORCE",
  "swingType": "BOTH",
  "lang": {
    "acdevice_name": "Klimatyzacja",
    "acdevice_fan": "Wentylator",
    "acdevice_fan_rightleft": "Prawo-Lewo",
    "acdevice_fan_updown": "Góra-Dół",
    "acdevice_healthmode": "Tryb zdrowia",
    "acdevice_drymode": "Tryb suszenia"
  }
}

Values

| Option | Available values | Required | Meaning | | :--------------: | :-----------------------------: | :------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | ip | ipv4 value | yes | IP address displayed in Android Bridge app | | token | 15 character string | yes | Token generated by Android Bridge app | | polling | integer from 1 to 60 | yes | Polling interval in seconds | | useFanMode | boolean | yes | When enabled, turning on Fan first in Home app, when AC is turned off, will set Fan mode on device | | useDryMode | boolean | yes | When enabled, switch controlling Dry Mode will appear within accessory | | healthModeType | "SHOW" or "FORCE" or "OFF" | yes | When 'Show' is selected, switch controlling Health Mode will appear within accessory. When 'Force' is selected, switch controlling Health Mode will NOT appear within accessory, but instead Health Mode will be always enabled | | swingType | "BOTH" or "INDIVIDUAL" or "OFF" | yes | When 'Individual' is selected, both switches controlling Up-Down swing and Right-Left will appear within accessory.\n When 'Both' is selected, fan accessory will have oscillate option instead | | lang | object | no | Language settings (refer to lang settings) |

Lang values

| Option | Available values | Required | Meaning | | :--------------------: | :--------------: | :------: | :----------------------------------: | | acdevice_name | string | no | Base name of accessory | | acdevice_fan | string | no | Name of fan subaccessory | | acdevice_fan_rightleft | string | no | Name of RightLeft Swing subaccessory | | acdevice_fan_updown | string | no | Name of UpDown Swing subaccessory | | acdevice_healthmode | string | no | Name of Health Mode subaccessory | | acdevice_drymode | string | no | Name of Dry Mode subaccessory |

FAQ

How to turn on FAN mode

Remember that you need useFanMode enabled to use that functionality. To enable fan mode, first make sure that AC is turned off (Target mode = Off). After that set desired speed on Fan accessory. AC should turn on in FAN mode

How forcing health mode works

When healthModeType is set to FORCE, every time some action is being made plugin enables health mode in AC.

Note: You can still disable this mode on remote, but after using HomeKit it will be set back to enabled.

After setting new language values in config HomeKit don't show changes

Make sure you set desired language values BEFORE starting plugin for the first time or BEFORE adding new device in SmartAir2.

How to install it on without having an Android device?

See wiki

100% working Haier AC models

• AS25S2SF1FA-BC