domoticz-homematicip-workbook

Guide on how to integrate eQ-3 Homematic CCU3 with selected Homematic IP Devices into Domoticz Home Automation System.

This guide has been developed for personal use only.

Purpose

To integrate the HomeMatic Smart Home Central Control Unit (HmIP-CCU3) in Domoticz Home Automation System. It is an addendum to the Domoticz Homeautomation Workbook.
This work-in-progress document has been developed for personal use to explore, build, share and as a supplemental reference - use at your own risk.

Overview

Described are various ways on how to integrate Homematic IP devices (connected to the CCU) in Domoticz.
Homematic offers a variety of devices.
This document covers only the Homematic device used by the author.
Whilst evolving, new devices will be added step-by-step or solutions reworked - and captured in this document.
The examples are based on good-practice by the author. It does not mean that there are other and probably better ways.

There are two key chapters:

• Functions - describing dedicated solutions with Homematic IP devices
• Explore - looking into ways of using API's & communication between the CCU and Domoticz

Functions with Homematic IP devices:

• Alert Indicator (HmIP-MOD-OC8)
• Battery Check (HmIP All Devices)
• Coffee Machine Monitor (HmIP-PSM)
• Custom Pages (HmIP-CCU3)
• Duty-Cycle Monitor (HmIP-CCU3)
• E-Paper Status Display (HmIP-WRCD)
• Garage Door Monitor (HmIP-SWDM)
• Heating Unit Gas Usage (HmIP-FCI1)
• Heating Unit Temperature (HmIP-STE2-PCB)
• Pluggable Switch and Meter (HmIP-PSM)
• Postbox Notifier (HmIP-SWDO)
• Remote Control (HmIP-RC8)
• Statelist Node-RED (HmIP All Devices)
• Thermostat Control (HmIP-eTRV)
• Thermostat Custom Page (HmIP-eTRV)

Domoticz

• The devices to control Homematic devices are mainly virtual devices (Hardware type "Dummy").
• The Automation Events are developed in dzVents - Domoticz next generation Lua scripting.
• The Plugins in Python 3.
• The communication between Domoticz and the CCU v.v. is handled via Remote Homematic Script API (embedded in dzVents) or HTTP XML- or REST-API requests with the CCU Addons XML-API, CCU-Jack (REST-API, MQTT-API) and CUx-Daemon. In addition explored the Homematic JSON-API and XML-RPC-API.

Other

• Node-RED used for tests and some tools.

Credits

A BIG THANK YOU, to the developers of Domoticz, Homematic, RaspberryMatic, Homematic addons, Tools and to all sharing information about Domoticz and/or Homematic. Without these, it would not be possible to build this project and write this document.

Licence

GNU GENERAL PUBLIC LICENSE v3.0.