homebridge-domoticz-thermostat
v0.3.0
Published
Accessory plugin which create a home setpoint using 4 domoticz devices. see github for description
Downloads
37
Readme
homebridge-domoticz-thermostat
Homebride thermostat created from domoticz devices
Why
I built this plugin to publish my own heating solution in domoticz (https://github.com/akamming/Domoticz_Thermostate_Plugin) to homekit to have a nice interface, but i decided to make it generic, so i can reuse, or anyone can reuse it. (e.g. it also works on Spirit Zwave Plus or Fibaro heat controller)
how it works
This plugin gets the status from 4 domoticz devices (of which 3 mandatory) and publishes this as 1 thermostat device in homekit. There is no heating/cooling logic in this plugin, it is only the interface to homekit, so any heating/cooling logic must be present in domotcz or the devices behind domoticz to make this work.
how to install
requisites
This plugin requires domoticz 2023.2 or higher
configure domoticz :
Make sure you the following devices in domoticz representing your heating/cooling system:
- a setpoint device stating the target room temperature
- a temperature device stating your current room temperature
- (optional): a selector switch which indicates your current heating/cooling state, configure the selector options like below: . If you don;t have this device, configure as 0.
- a selector switch which indicates if your target heating/cooling state, configure the selector options like below:
- make sure you have some mechanisme in domoticz which controls your heating/cooling based on these 4 devices.
If you use the above mentioned domoticz plugin, or if you are using a fibaro heat controller, or a eurotronic spirit zwaveplus, these devices will automatically be created for you in domoticz)
install the plugin
- if you are new to homebdrige, follow the instructions on https://homebridge.io/ to install a homebridge instance
- login to homebridge
- go to the plugins tab
- in the search bar: enter "domoticz thermostat" and press enter
- install this plugin (it is called Homebridge-Domoticz-Thermostat)
- Enter your domoticz api adress and port, a domoticz user and password and the 4 device numbers of the domoticz devices mentioned above
- Restart homebridge And you are in business!!
advanced
If you want configure more than one thermostat in homebridge: this can be achieved by
- Enable the childbridge feature of homebridge
- Manually configure the 2nd (or 3rd, etc..) thermostat directly in the json in the homebridge config in the accessories section. Here is a smple config (not that all usernames must be the same or it will not work) :
"accessories": [
{
"name": "DomoticzThermostat",
"ApiAddress": "https://xxx.yyy.zzz.aaa",
"port": 443,
"username": "username",
"password": "password",
"CurrentHeatingCoolingStateIDX": xxx
"TargetHeatingCoolingStateIDX": yyy,
"TargetHeatingCoolingStateMaxValue": "HEAT",
"CurrentTemperatureIDX": zzz,
"TargetTemperatureIDX": aaa,
"accessory": "DomoticzThermostat",
"_bridge": {
"username": "0E:B1:17:4E:86:E8",
"port": 40783
}
},
{
"name": "DomotixzThermostat2",
"ApiAddress": "https://xxx.yyy.zzz.aaa",
"port": 443,
"username": "username",
"password": "password",
"CurrentHeatingCoolingStateIDX": bbb,
"TargetHeatingCoolingStateIDX": ccc,
"TargetHeatingCoolingStateMaxValue": "HEAT",
"CurrentTemperatureIDX": ddd,
"TargetTemperatureIDX": eee,
"accessory": "DomoticzThermostat",
"_bridge": {
"username": "0E:B1:17:4E:86:E8"
}
}
],