homebridge-cool-automation

Homebridge plugin for Cool Automation - HVAC Systems Controller

Requirements

 

check with: node -v & homebridge -V and update if needed

Installation

The plugin can be easily installed configured via Homebridge UI.

Otherwise, follow these instructions

1. Install homebridge using: sudo npm install -g homebridge --unsafe-perm
2. Install this plugin using: sudo npm install -g homebridge-cool-automation
3. Update your configuration file. See config-sample.json in this repository for a sample.

* install from git: sudo npm install -g git+https://github.com/nitaybz/homebridge-cool-automation.git

Config file

Easy config (required):

"platforms": [
    {
        "platform": "CoolAutomation",
        "ip": "192.168.X.X"
    }
]

Advanced config (optional):

"platforms": [
    {
        "platform": "CoolAutomation",
        "ip": "192.168.X.X",
        "statePollingInterval": 30,
        "minTemperature": 16,
        "maxTemperature": 30,
        "coolMode": true,
        "heatMode": true,
        "autoMode": false,
        "fanMode": true,
        "dryMode": true,
        "vlowFspeed": false,
        "lowFspeed": true,
        "medFspeed": true,
        "highFspeed": true,
        "topFspeed": false,
        "autoFspeed": true,
        "debug": false
    }
]

Configurations Table

Parameter	Description	Required	Default	type
platform	always "cool-automation"	✓	-	String
ip	IP Address of the CoolAutomation hub	✓	-	String
statePollingInterval	Time in seconds between each status polling of the Electra devices		30	Integer
minTemperature	Minimum Temperature to show in HomeKit Control (supports fahrenheit)		16	Integer
maxTemperature	Maximum Temperature to show in HomeKit Control (supports fahrenheit)		30	Integer
coolMode	Enable COOL mode control		true	Boolean
heatMode	Enable HEAT mode control		true	Boolean
autoMode	Enable AUTO mode control		true	Boolean
fanMode	Enable FAN mode control - Adds extra fan accessory		true	Boolean
dryMode	Enable DRY mode control - Adds extra dehumidifier accessory		true	Boolean
vlowFspeed	Support "Very-Low/Quite" fan speed		true	Boolean
lowFspeed	Support "Low" fan speed		true	Boolean
medFspeed	Support "Medium" fan speed		true	Boolean
highFspeed	Support "High" fan speed		true	Boolean
topFspeed	Support "Very-High/Top" fan speed		true	Boolean
autoFspeed	Support "Auto" fan speed		true	Boolean
debug	When set to true, the plugin will produce extra logs for debugging purposes		false	Boolean

Fan speeds & "AUTO" speed

Since HomeKit control over fan speed is with a slider between 0-100, the plugin converts the steps you have in the Electra app to values between 1 to 100, when 100 is highest and 1 is lowest. Setting the fan speed to 0, should actually set it to "AUTO" speed.

Available fan speeds: AUTO, VLOW, LOW, MED, HIGH, TOP
enable or disable them inside the config

Issues & Debug

If you experience any issues with the plugin please refer to the Issues tab and check if your issue is already described there, if it doesn't, please create a new issue with as much detailed information as you can give (logs are crucial).

if you want to even speed up the process, you can add "debug": true to your config, which will give me more details on the logs and speed up fixing the issue.

---

Support homebridge-cool-automation

homebridge-cool-automation is a free plugin under the GNU license. it was developed as a contribution to the homebridge/hoobs community with lots of love and thoughts. Creating and maintaining Homebridge plugins consume a lot of time and effort and if you would like to share your appreciation, feel free to "Star" or donate.