homebridge-domoticz-thermostat v0.3.0

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"
            }
        }
    ],