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.