Homebridge-cool-automation NPM

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

Install homebridge using: sudo npm install -g homebridge --unsafe-perm
Install this plugin using: sudo npm install -g homebridge-cool-automation
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.