Homeassistant pulled aiohomematic 2026.2.21 and caused incompatibility with homematicip_local

[andrewdolphin]

I agree to the following

• I have read the documentation
• I have read the troubleshooting documentation, and tried to identify/solve the issue by myself.
• I have read the Glossary and understand the difference between Integration, App, and Backend
• I am aware of the latest release notes
• I am aware that an integration that was installed via HACS also needs to be updated via HACS
• The Backend (CCU/Homegear/...) is working as expected, devices are taught in and are controllable by its own UI.
• I am running the latest version of the custom_component (and Home Assistant)

The problem

I'm not sure why but I am seeing an error related to the above in the logs.

As my heating has broken I've temporarily fixed the issue by connecting to my container an manually pip installing 2026.2.20 instead which has fixed the issue for now.

Not sure if anyone else has seen this problem?

I recognise I'm running the beta but dropping back to non-beta didn't resolve the issue.

What version of Homematic(IP) Local for OpenCCU has the issue?

2.3.0b10

What was the last working version of Homematic(IP) Local for OpenCCU?

No response

What type of installation are you running?

Home Assistant Container

What type of installation are you running for your Homematic backend?

CCU3

Which version of your Homematic backend are you running?

No response

What hardware are you running for your system?

No response

Which config details do you use

• TLS
• callback data (see)

Which interfaces do you use?

• Homematic IP
• Homematic (Bidcos-RF)
• Groups (Heating-Group)
• BidCos-Wired (HM-Wired)
• CuXD
• CCU-Jack

Diagnostics information (no logs here!)

No response

Log file (preferably DEBUG log)

No response

Additional information

No response

[github-actions]

Automatic Issue Analysis

Summary: User reports an incompatibility issue after Home Assistant pulled aiohomematic 2026.2.21, which broke their heating system. They temporarily fixed it by manually pip installing version 2026.2.20 in their container. However, there's confusion about version numbers (reported integration version appears to be Home Assistant core version), and critically, no diagnostics, logs, or actual error messages are provided. Without this information, it's impossible to diagnose what incompatibility occurred or provide proper support.

🚨 CRITICAL: Version Issue

The reported version '2026.2.20' appears to be a Home Assistant core version, not the Homematic(IP) Local integration version. The integration uses version format 1.x.x or 2.x.x (current stable: 2.2.4, current pre-release: 2.3.0b10). The issue mentions 'aiohomematic 2026.2.21' which is the library version that Home Assistant automatically pulls - this is NOT the integration version. You need to check the actual Homematic(IP) Local integration version in Home Assistant under Settings -> Devices & Services -> Homematic(IP) Local.

Current stable version: 2.2.4
Current pre-release: 2.3.0b10

Please ensure you are using the latest version before reporting issues. Support can only be provided for the current version.

Terminology Notes

To avoid confusion, please note the correct terminology (Glossary):

• aiohomematic 2026.2.21 → Home Assistant Core version or aiohomematic library version: There appears to be confusion between the Home Assistant core version, the aiohomematic Python library version, and the Homematic(IP) Local integration version. The integration version should be 1.x.x or 2.x.x format. The user mentioned installing '2026.2.20' with pip, which suggests confusion about which component needs which version.

⚠️ Missing Required Information

Meaningful support is only possible if all required information is provided!

Missing:

• ❌ Integration diagnostics (.json file) - Download via: Settings → Devices → Select integration → Download diagnostics
• ❌ Log file - Preferably a DEBUG log. Enable via: Settings → Devices → Select integration → Enable debug logging. Then reproduce the issue and download log (Settings → System → Logs → Load unchanged logs)

⚠️ Issues without this information cannot be processed and may be closed.

Exception: For initial setup issues, diagnostics may not be available yet.

Additional Missing Information

• Integration diagnostics: The diagnostics file (.json) downloaded from Settings -> Devices -> Homematic(IP) Local -> Download diagnostics is critical for analyzing this issue. This is required to understand the actual configuration and state.
• Log file: The complete Home Assistant log file showing the actual error that occurred. The user mentions 'seeing an error related to the above in the logs' but hasn't provided the actual error message. This is essential to diagnose the incompatibility issue.
• CCU Backend version: The CCU3 firmware version is missing. This helps understand if there are any compatibility issues with the backend.
• Hardware information: Information about the hardware running Home Assistant is missing. Container environments can have specific dependency issues.
• Error details: Specific error message from the logs showing the incompatibility between aiohomematic 2026.2.21 and homematicip_local. What was the exact error that caused the heating to break?

Attachment Analysis

Findings:

• ❌ [Other] No diagnostics or logs provided despite user reporting a critical error that broke their heating system
  • 💡 Recommendation: Without the actual error message from logs and diagnostics data, it's impossible to determine what incompatibility occurred. This must be provided for any meaningful support.
• ⚠️ [Configuration] User is running in Home Assistant Container environment and manually installed a Python package with pip. This suggests potential dependency management issues or misunderstanding of how Home Assistant manages integration dependencies.
  • 💡 Recommendation: In Home Assistant Container, integration dependencies are managed automatically. Manual pip installation may create version conflicts. The actual issue needs to be identified from logs before attempting workarounds.

Helpful Documentation

The following documentation pages might be helpful:

• troubleshooting
  Essential for understanding how to collect proper diagnostic information and logs for this compatibility issue
• glossary
  Helps clarify the difference between aiohomematic (library), Homematic(IP) Local (integration), and Home Assistant (core platform)
• releases
  User should check the actual integration version and review release notes for any known issues with specific Home Assistant versions

Similar Issues and Discussions

The following issues or discussions might be relevant:

• ✅ Reparaturmeldungen nach „Neu laden“ der Integration seit Version 2.2.4 (Geräterstellung verzögert) #2960: Reparaturmeldungen nach „Neu laden“ der Integration seit Version 2.2.4 (Geräterstellung verzögert)
• ✅ Neues HMIP Gerät lässt sich nicht hinzufügen / taucht nicht in HA auf #2951: Neues HMIP Gerät lässt sich nicht hinzufügen / taucht nicht in HA auf
• ✅ Integration not starting, python json related? #2935: Integration not starting, python json related?
• ✅ Most Integration startups end with "Central Home FAILED - CCU internal error (interface: Unknown)" #2928: Most Integration startups end with "Central Home FAILED - CCU internal error (interface: Unknown)"

---

This analysis was generated automatically. For questions or support, please use the discussions.