homebridge-itho-daalderop

     

Homebridge plugin for Itho Daalderop mechanical fan units

This Homebridge plugin exposes your Itho Daalderop mechanical fan unit to Apple HomeKit by using the WiFi Add-on module. So you can use the Home App to control your fan units and integrate into your Home Automations.

Features

• Control your mechanical ventilation unit from within the Home App
• Use your mechanical ventilation unit in your Home Automations
• Exposes an Air Quality Sensor with CO2, Humidity and Temperature measurements
• Supports both MQTT and HTTP API. The HTTP API is enabled by default

Requirements

It is required to have installed and configured the WiFi Add-on module for your fan unit. More info about this module and for a complete list on what mechanical ventilation models models are supported, please take a look at Arjan Hiemstra's GitHub repository or this forum thread on Tweakers.net (Dutch): Itho Daalderop - open source wifi control add-on module.

MQTT

Using the MQTT API is optional, the plugin will use the HTTP API by default as it requires no additional software to be present in your network.

However, using MQTT is recommended as it is more reliable and faster than the HTTP API.

If you want to use the MQTT API, you will need to install and configure a MQTT broker on your local network. I recommend using Mosquitto. The IP address of the MQTT broker is required to configure the plugin in Homebridge and in the WiFi Add-on module.

Installation

This plugin requires Node 14 or higher to be installed.

npm install -g homebridge-itho-daalderop

Or use the Homebridge UI to install the plugin:

1. Go to your Homebridge UI and click on "Plugins"
2. Search for Itho Daalderop and select the plugin Homebridge Itho Daalderop from @jvandenaardweg and click "Install"

Configuring the plugin

I recommend using the Homebridge UI to configure the plugin settings, as it gives guidance on what settings are required.

1. Go the the plugin settings in the Homebridge UI
2. On the plugin page click on "Settings" for Homebridge Itho Daalderop
3. Choose between using MQTT or the HTTP API and fill in the required settings. Click Save.
4. Click the little QR code icon for the plugin and enable the bridge. Save it and restart Homebridge.
5. After restarting Homebridge, click the QR code icon again and scan the QR code with your iPhone using the Home App. This will add the plugin bridge to your Home App.
6. Your Mechanical Ventilation unit should now be available to configure in the Home App

Example config

{
  "platform": "HomebridgeIthoDaalderop",
  "name": "Itho Daalderop",
  "api": {
    "protocol": "mqtt",
    "ip": "192.168.1.21",
    "port": 1883
  },
  "device": {
    "co2Sensor": true
  },
  "verboseLogging": false
}

About manual speed control

The plugin allows full manual speed control from 0% to 100% and everything in between. However, your fan needs to be able to support such speed commands. It is known that speed commands send to CVE unit's with a built-in CO2 sensor (like the CVE-S Optima Inside) are overruled by the internal speed control of the fan. This means you can't have fine grained control over your fan speed, and are limited to "low", "medium" and "high" speed settings.

If you have such a device with a built-in CO2 sensor, please add the device configuration option to your config.json file and set the co2Sensor option to true. Or use the Homebridge UI to set that option. The plugin will then automatically map the speed in the Home App to the respective virtual remote commands, which will allow you to control the fan speed in 3 steps. The mapping is as follows:

Home App speed	Virtual remote command	HomeKit Active state
0%	low	inactive
33%	low	active
67%	medium/auto	active
100%	high	active

Troubleshooting

If you have any issues with the plugin, please enable the verboseLogging configuration option in the Homebridge plugin and check the Homebridge logs for any errors and debug messages.

Feel free to open an issue on GitHub if you have any questions or problems.

Changelog

0.3.0

30 December 2022

• feat: use virtual remote commands when device has build-in co2 sensor 610ce0c
• refactor: prepare code for target fan state ea8d4e7
• refactor: move platform handlers in own method bc071c0
• docs: update readme 947441a
• feat: handle identify properly eb7547a
• chore: release v0.3.0 9710b37
• refactor: use active speed threshold 0d0d6eb
• docs: remove docs dir fdb7177