Hass.io Core Add-on: HomeMatic

HomeMatic central based on OCCU.

About

This add-on allows you to control your HomeMatic devices so they can be integrated into Home Assistant. It is based on the HomeMatic Open Central Control Unit (OCCU) SDK.

Note: Requires a HM-MOD-RPI-PCB or HmIP-RFUSB to interface with your devices.

Features

• Your Raspberry Pi is your HomeMatic control center!
• WebUI (experimental)
• Firmware updates

Installation

The installation of this add-on is straightforward and easy to do.

1. Navigate in your Home Assistant frontend to Hass.io -> Add-on Store.
2. Find the "HomeMatic CCU" add-on and click it.
3. Click on the "INSTALL" button.

How to use

1. Properly configure the add-on config (see below).
2. Start the add-on.
3. Check the add-on log output to see if it started successfully.
4. Add homematic to your Home Assistant configuration (also see below).
5. Restart Home Assistant.

Configuration

Add-on configuration:

{
  "rf_enable": true,
  "rf": [
    {
      "type": "CCU2",
      "device": "/dev/ttyAMA0"
    }
  ],
  "wired_enable": false,
  "wired": [
    {
      "serial": "xy",
      "key": "abc",
      "ip": "192.168.0.0"
    }
  ],
  "hmip_enable": false,
  "hmip": [
    {
      "type": "HMIP_CCU2",
      "device": "/dev/ttyUSB0"
    }
  ]
}

Option: rf_enable (required)

Enable or disable BidCoS-RF.

Option: rf

List of RF devices.

Option: rf.type (required)

Device type for RFD service. Check your device manual.

Option: rf.device (required)

Device on the host.

Option: wired_enable (required)

Enable or disable BidCoS-Wired.

Option: wired

List of wired devices.

Option: wired.serial (required)

Serial number of the device.

Option: wired.key (required)

Encryption key for the device.

Option: wired.ip (required)

IP address of LAN gateway.

Option: hmip_enable (required)

Enable or disable hmip.

Option: hmip

List of HMIP devices.

Option: hmip.type (required)

Device type for HMIP service. Check your device manual.

Option: hmip.device (required)

Device on the host.

Home Assistant configuration

Add the following to your Home Assistant configuration to enable the integration:

homematic:
  interfaces:
    rf:
      host: core-homematic
      port: 2001
    wired:
      host: core-homematic
      port: 2000
    hmip:
      host: core-homematic
      port: 2010

Raspberry Pi3

If you use the HM-MOD-RPI-PCB on a Raspberry Pi 3, you need to add the following to the config.txt file on the boot partition:

dtoverlay=pi3-miniuart-bt

HmIP-RFUSB

HassOS versions 1.11 and later support the HmIP-RFUSB by default and don't need any configuration. If you installed Hassio on another distribution of Linux, you need to follow the installation guide for the UART USB to setup the UART USB interface on your computer.

Support

Got questions?

You have several options to get them answered:

• The Home Assistant Discord Chat Server.
• The Home Assistant Community Forum.
• Join the Reddit subreddit in /r/homeassistant

In case you've found a bug, please open an issue on our GitHub.