Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time

Home Assistant Add-on: HomeMatic

WARNING: This add-on is considered to be obsolete/retired in favor of the much more advanced third-party RaspberryMatic CCU add-on for running a HomeMatic/homematicIP smart home central within HomeAssistant. If you want to migrate to the new add-on, please make sure to update to the latest version of this old "HomeMatic CCU" add-on first and then use the WebUI-based backup routines to export a *.sbk config backup file which you can then restore in the new "RaspberryMatic CCU" add-on afterwards (cf. RaspberryMatic Documentation)


Follow these steps to get the add-on installed on your system:

  1. Navigate in your Home Assistant frontend to Supervisor -> 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.


Add-on configuration:

rf_enable: true
  - type: CCU2
    device: "/dev/ttyAMA0"
wired_enable: false
  - serial: xy
    key: abc
hmip_enable: false
  - type: HMIP_CCU2
    device: "/dev/ttyUSB0"
regahss_reset: false

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.

Option: regahss_reset

If this is set and enabled, the ReGaHss setting will be removed before it will be started.

Home Assistant configuration

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

      host: core-homematic
      port: 2001
      host: core-homematic
      port: 2000
      host: core-homematic
      port: 2010
      host: core-homematic
      port: 9292
      path: /groups

Raspberry Pi3/4

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



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.


Got questions?

You have several options to get them answered:

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