Homebridge-haieracbridge-platform NPM

`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

Download HaierACBridge app
Install and login in HaierACBridge app
Get token and IP address from app
Install this plugin by running npm install -g homebridge-haieracbridge-platform or by finding it in homebridge-config-ui-x
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