Homematic(IP) Local for OpenCCU

Homematic(IP) Local for OpenCCU is a custom integration for Home Assistant.

At a Glance

• Local Home Assistant integration for Homematic(IP) hubs (CCU2/3, OpenCCU, Debmatic, Homegear). No cloud required.
• Communication: Local XML-RPC for control and push state updates; JSON-RPC for names and rooms.
• Installation: HACS recommended; manual installation supported.
• Auto-discovery: Supported for CCU and compatible hubs.
• Minimum requirements: Home Assistant 2025.10.0+; for Homematic IP on CCU require at least CCU2 2.61.x / CCU3 3.61.x.

Quick Start

Related Integrations

Installation

HACS (Recommended)

1. In Home Assistant, go to HACS > Integrations > Explore & Download Repositories
2. Search for "Homematic(IP) Local for OpenCCU" and install it
3. Restart Home Assistant when prompted

Manual Installation

1. Copy the custom_components/homematicip_local directory to your Home Assistant config/custom_components directory
2. Restart Home Assistant

Note: Manual installation does not support automatic updates.

After installation, add the integration via Settings > Devices & Services > Add Integration or use this button:

Requirements

Supported Hardware

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

Required Ports

Authentication

• Admin privileges required on your CCU
• Allowed password characters: A-Z, a-z, 0-9, .!$():;#-
• XML-RPC authentication recommended (Settings > Control Panel > Security)

For complete requirements and configuration details, see the Full Documentation.

Documentation

The complete documentation is available at sukramj.github.io/aiohomematic:

Additional Resources

• Contributing Guide: See CONTRIBUTING.md for development setup and contribution guidelines
• Local Naming Documentation: See docs/naming.md

Device Configuration Panel

A built-in sidebar panel for editing Homematic device MASTER parameters directly from the Home Assistant UI.

Features

• Browse all configurable devices grouped by interface
• View device details including reachability, RSSI, and firmware
• Edit MASTER paramset values per channel with auto-generated forms (sliders, toggles, dropdowns)
• Validate changes before writing to the device
• Reset parameters to factory defaults

Enabling the Panel

1. Go to Settings → Devices & Services → Homematic(IP) Local
2. Click Configure on your integration entry
3. Navigate to Advanced Options
4. Enable Device configuration panel
5. The panel appears in the sidebar as Homematic Config

Note: The panel requires admin access and is not visible to non-admin users.

Blueprints

Ready-to-use automation blueprints are available in the blueprints/automation directory:

• Support for 2/4/6/8-button remotes
• Persistent notifications for unavailable devices
• Device reactivation helpers
• Error event handlers

Copy the desired blueprint files to your config/blueprints/automation directory.

Community blueprints are welcome via pull request in blueprints/community.

Companion Cards

Enhance your Home Assistant dashboard with custom cards designed for this integration:

Support and Contributing

License

This project is licensed under the MIT License. See LICENSE for details.