Lighting

Homematic(IP) Local for OpenCCU

SukramJ/homematicip_local · v2.12.1

HACSLocal push

A custom Home Assistant component for HomeMatic(IP) that connects to OpenCCU

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`light`	Light
`switch`	Switch or outlet
`cover`	Blind, garage door, window or door
`climate`	Thermostat
`lock`	Lock	Needs its own HomeKit Bridge in accessory mode
`alarm_control_panel`	Security system
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`valve`	Valve
`button`	Button (as a switch)
`select`	Mode picker (as switches)

1 report below say how a device from this integration behaves in the Home app.

What people report

Works locally with Homematic CCU-style controllers; piVCCU users asked for backup support.

Works4
Partly works2

Device	In Home Assistant	In Apple Home	What they said	Source
Debmatic	Works Local		Listed supported controller Saved copy Supported devices: CCU2/3; OpenCCU; Debmatic; Homegear; Home Assistant OS/Supervised with suitable add-on + communication device. Excerpt saved from the README on 2026-10-23.	README
Homegear	Works Local		Listed supported controller Saved copy Supported devices: CCU2/3; OpenCCU; Debmatic; Homegear; Home Assistant OS/Supervised with suitable add-on + communication device. Excerpt saved from the README on 2026-10-23.	README
Homematic CCU2/CCU3	Works Local		Listed supported controller (CCU2/3) Saved copy Supported devices: CCU2/3; OpenCCU; Debmatic; Homegear; Home Assistant OS/Supervised with suitable add-on + communication device. Excerpt saved from the README on 2026-10-23.	README
OpenCCU	Works Local		Listed supported controller Saved copy Supported devices: CCU2/3; OpenCCU; Debmatic; Homegear; Home Assistant OS/Supervised with suitable add-on + communication device. Excerpt saved from the README on 2026-10-23.	README
Homematic IP HmIP-SMI motion/illumination sensor	Partly works Local	Broken in Home Illuminance sensor shown as air quality sensor in Home app	Illumination exposed with wrong device_class mapping; workaround via template sensor Saved copy … at least identified a workaround how to solve this in the meantime. Since the issue seems to me the wrong mapping of the `device_class` of the related HomematicIP HmIP SMI motion detection sensor, which provides an illumination sensor as well, I created a customization for home assistant configuration.yaml [code] which links to ``` # HomematicIP Device_class required for HomeKit # to recognize the entity as a the right illumination accessory. sensor.dachgeschoss_bewegungsmelder_helligkeit: device_class: illuminance sensor.treppe_souterrain_bewegungsmelder_helligkeit: device_class: illuminance … Excerpt saved from GitHub on 2026-10-23.	Issue #152547 · 2025-09
piVCCU with HM-MOD-RPI-PCB	Partly works Local		CCU backup action fails on piVCCU; feature request completed Saved copy Environment - Home Assistant: 2026.9.4 - Homematic(IP) Local: 2.11.1 (installed via HACS) - CCU: piVCCU on a Raspberry Pi - Radio module: HM-MOD-RPI-PCB - CCU authentication: enabled, Admin user configured in the integration (the same user can create backups in the CCU WebUI) ### Current behaviour Both the button "Backup erstellen" and the action `homematicip_local.create_ccu_backup` fail with: [code] Even with `aiohomematic` debug logging enabled, no more specific error is logged. ### What works - Creating a system backup manually in the CCU WebUI (Settings → Control panel → Security → … Excerpt saved from GitHub on 2026-10-23.	Issue #1316 · 2026-10

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Found automatically over

SSDP/UPnP
Bonjour (zeroconf)

Details

Installs (analytics)	10,417 (1.47%)
GitHub stars	604
Latest version	2.12.1 (2026-10-21)
Set up in the UI	Yes
Maintainers	@SukramJ
License	MIT

Devices listed in its README

CCU2/3
OpenCCU
Debmatic
Homegear
Home Assistant OS/Supervised with suitable add-on + communication device

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/sukramj/homematicip_local
Source code: https://github.com/SukramJ/homematicip_local
Issues: https://github.com/sukramj/aiohomematic/issues
HACS: https://hacs.xyz