Skip to content

MQTT Setup

twendt edited this page Nov 29, 2020 · 7 revisions

Overview

By default the Homematic app for Homey uses XMLRPC and BINRPC to communicate with the CCU. Unfortunately this uses a lot of memory especially in larger environments. It can even cause Homey to kill the app due to the amount of memory consumed.

To workaround these issues it is now possible to enable MQTT as the transport protocol. However this requires some setup on the CCU and it only works with the CCU3 and RaspberryMatic. This is because the CCU does not support MQTT itself, therefore it is required to install the RedMatic addon and also the Mosquitto addon.

The MQTT feature can be enabled/disabled in the app settings. A restart of the app is required for the change to take affect.

Due to the dependency between the Homey app and the configuration on the CCU I would suggest to disable the automatic update of the app in Homey as new versions might require changes to the flows in Node Red. I will document this in the release notes.

This is currently considered an experimental feature.

Install RedMatic addon

Download the latest RedMatic stable release from here.

Please open the settings page for RedMatic in the Control Panel of the CCU after the installation is complete and check if RedMatic is running. It might be required to reboot the CCU.

Install Mosquitto addon

Download the latest stable release from here

You can also use any existing mqtt broker installation, but the Homey app currently does not support authentication or TLS.

Import flow

Open Node Red: http://<ccu ip>/addons/red

Username: Admin

Password: <same as for CCU Web UI>

Import the required flow for Homey as a new flow by copying the json file from here.

Enable MQTT in Homey app

Go to the settings page of the Homematic app and enable the Use MQTT checkbox. Restart the app.

To check that the app uses MQTT open the settings page of the Homematic app and use the the Get Logs button. There will be a message Initializing MQTT CCU for MQTT or Initializing RPC CCU for xmlrpc/binrpc.

Clone this wiki locally