Skip to content
Projects

SukramJ/homematicip_local

View on GitHub

SukramJ/homematicip_local has 609 GitHub stars and 55 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:37 UTC. Last push 2026-11-14.

How these counts are measured

What you can do

  • 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

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

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

Developer Tools

README.md

Original

Homematic(IP) Local for OpenCCU

releasebadge License hainstall GitHub Sponsors Marketplace

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, OpenCCU Lite, Debmatic). No cloud required. See Supported Hardware for the complete, exhaustive list.
  • Communication: Local XML-RPC for control and push state updates; JSON-RPC for names and rooms. OpenCCU Lite is connected through the OpenCCU Loom backend.
  • Installation: via the Home Assistant Marketplace (HACS before Home Assistant 2026.11); manual installation supported.
  • Auto-discovery: Supported for CCU and compatible hubs.
  • Minimum requirements: Home Assistant 2026.11.0+; for Homematic IP on CCU require at least CCU2 2.61.x / CCU3 3.61.x.

Quick Start

Resource Link
Full Documentation User Guide
Installation See Installation below
Alternative Setup (OpenCCU) OpenCCU Wiki
Changelog changelog.md
Issues GitHub Issues
Discussions GitHub Discussions

Related Integrations

Integration Use Case
This integration Local connection to CCU2/3, OpenCCU, OpenCCU Lite, Debmatic
Homematic(IP) Cloud Cloud connection via Homematic IP Access Point
Homematic IP Local (HCU) Local connection to HmIP-HCU1

Installation

Marketplace (Recommended)

From Home Assistant 2026.11 on, use the Home Assistant Marketplace. On earlier versions, the same steps apply in HACS.

  1. In Home Assistant, open the Marketplace and browse the integrations
  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:

Add Integration

Requirements

Supported Hardware

  • CCU2/3
  • OpenCCU
  • OpenCCU Lite (CCU platform without ReGaHSS; supported through the OpenCCU Loom backend)
  • Debmatic
  • Home Assistant OS/Supervised with suitable add-on + communication device

Note: This list is exhaustive. Third-party hubs that reimplement the CCU interfaces (XML-RPC, JSON-RPC, ReGa) are not supported, even if they appear to work. Issues reported against such a setup are closed without further assessment.

Required Ports

Interface Purpose Port TLS Port
HomematicIP (HmIP-RF) Wireless/wired HmIP devices 2010 42010
Homematic (BidCos-RF) Classic wireless devices 2001 42001
Homematic Wired Classic wired devices 2000 42000
Virtual Devices Heating groups 9292 49292
JSON-RPC Names and rooms 80 443

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:

Topic Link
Home Assistant Integration User Guide
Actions Reference Actions
Events Reference Events
Troubleshooting Troubleshooting Guide
Week Profiles Week Profiles
Naming Conventions Naming
Glossary Glossary

Additional Resources

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.

The button blueprints (2/4/6/8-button) react to the selected device's event entities (event.*, one per button channel). These are enabled by default; a button whose event entity you have disabled or hidden cannot trigger the automation. They require Home Assistant 2026.9 or newer.

The remaining blueprints are driven by the integration's events — see the Events Reference for which parameters trigger which event. Note that CCU service messages (CONFIG_PENDING, UPDATE_PENDING, …) are not events; they are available through the sensor.<instance>_hub_service_messages sensor.

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

Support and Contributing

Resource Link
Report Issues GitHub Issues
Discussions GitHub Discussions
Documentation sukramj.github.io/aiohomematic
Contributing CONTRIBUTING.md
AI Contribution Policy AI_POLICY.md
Sponsor GitHub Sponsors

Development

Parts of Homematic(IP) Local for OpenCCU are developed with agentic AI assistance, primarily Claude Code. Submitted issues are also triaged and analysed with agentic help. Every change is still reviewed by a human maintainer and must pass the project's tests before it lands — AI accelerates the work, it does not replace the review gate. The rules for AI use in contributions are documented in AI_POLICY.md.

License

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