Homey integration

This page covers the integration via MQTT to Homey

Installation

1. Install homey app for MQTT client and MQTT Hub
2. Install homey app for MQTT broker or use an existing one (e.g. Mosquitto running already on the network)
3. Add a new device of "MQTT Hub" type "FAN". Capabilities are not relevant.
4. Click on the device
5. Go to settings -> ‘Advanced settings’ -> ‘Topics’
6. Copy / paste the code below

{
  "dim": {
    "capability": "dim",
    "stateTopic": "itho/state",
    "setTopic": "itho/cmd",
    "valueTemplate": "round((value / 255) * 100)",
    "outputTemplate": "round((value / 100) * 255)",
    "displayName": "Dim level" 
  },
  "measure_temperature": {
    "capability": "measure_temperature",
    "stateTopic": "itho/ithostatus",
    "setTopic": "",
    "valueTemplate": "$['temp']",
    "outputTemplate": "",
    "displayName": "Temperature"
  },
  "measure_humidity": {
    "capability": "measure_humidity",
    "stateTopic": "itho/ithostatus",
    "setTopic": "",
    "valueTemplate": "$['hum']",
    "outputTemplate": "",
    "displayName": "Humidity"
  }
}

if the code above gives a Dim related error on homey please try the older version:

{
  "dim": {
    "capability": "dim",
    "stateTopic": "itho/state",
    "setTopic": "itho/cmd",
    "valueTemplate": "round((value / 255) * 100)",
    "outputTemplate": "round((value / 100) * 255)",
    "displayName": "Dim level" 
  },
  "measure_temperature": {
    "capability": "measure_temperature",
    "stateTopic": "itho/ithostatus",
    "setTopic": "",
    "valueTemplate": "$.temp",
    "outputTemplate": "",
    "displayName": "Temperature"
  },
  "measure_humidity": {
    "capability": "measure_humidity",
    "stateTopic": "itho/ithostatus",
    "setTopic": "",
    "valueTemplate": "$.hum",
    "outputTemplate": "",
    "displayName": "Humidity"
  }
}

7. Restart your Homey device
8. You now should have a humidity and temperature sensor and a dimmer for the fan speed (CVE only). If values for humidity and temperature remain 0, then chances are "temp" and "hum" as specified for "valueTemplate" don't exist in the message returned by the stateTopic "itho/ithostatus" for your model. As an example, HRU200 ECO currently contains keys like "Indoorhumidity (%)" and "OutdoorTemp (°C)" instead. Skip the sensor creation if you don't have a sensor that supports it.

Optional capabilities

In case you also have a CO2 sensor, you can add it to homey as well, but you need to know the name of the sensor (in the example code it's "woonkamer")

{
  "measure_co2": {
    "capability": "measure_co2",
    "stateTopic": "itho/remotesinfo",
    "setTopic": "",
    "valueTemplate": "$.woonkamer.co2",
    "outputTemplate": "",
    "displayName": "CO2"
  }
}

Example flows by Pierre Vissers

1. Set ventilation to high based on Aquara humidity sensor.
   https://homey.app/en-us/flow/R_dzvl/

2. Manual on/off button control in Homey app or timer based via homeydash using virtual device.
   https://homey.app/en-us/flow/v8izvl/

3. Eco setting at night with low speed and increase at first shower in the morning.
   https://homey.app/en-us/flow/WauEvl/