Migration from domain hahm to homematicip_local

This revision is a reduced version of the original migration plan.

Introduction

The development of the new HomeMatic / IP / Wired integration has reached a stable state. Therefore we are preparing the code to eventually be merged into Home Assistant some day. This however comes with a breaking change for our existing testers. Until now the Home Assistant domain that has been used was hahm, as there was no decision on what the final domain should be when development has started. We now have decided to stick to homematicip_local.

Starting with version 1.0.0 of the custom component, homematicip_local will be the new domain.

The breaking change is necessary because:

• all entities and devices need an update of their domain (hahm -> homematicip_local)
• SysVars and Heating Groups will get new unique IDs to match the requirements of Home Assistant

It is not planned to change this in the future. As a result there should not be any breaking change of this kind further down the road when the integration finally gets added to the Core.

We are now starting to promote this integration as the preferred solution to integrate HomeMatic / IP / Wired into Home Assistant. The old integration will be deprecated eventually.

We apologize for this inconvenience. But to minimize frustration among the users, it seems the most reasonable path to perform this change while the user base for the new integration is still rather small.

Of course we thank all our testers that have provided us with valuable feedback and bug reports. Without you this new integration could not have become what it is now.

Performing the migration

• Create and download Home Assistant Backup

• Users of unignore should make a copy of their file.

• Delete Integration

• Go to HACS and update Homematic(IP) Local

• Do the following in your config directory:

  • Delete old custom_homematic folder custom_components/hahm:

    or execute rm -Rf custom_components/hahm

  • Delete old cache folder hahm:

    or execute rm -Rf hahm

• Restart Home Assistant

• Add Integration

• Check and reconfigure your scripts, automations, ...

• If you use blueprints you need to update them too.