hahomematic
is a Python 3 (>= 3.9) module for Home Assistant to interact with HomeMatic and homematic IP devices. Some other devices (f.ex. Bosch, Intertechno) might be supported as well.
This is intended to become the successor of pyhomematic.
It can be installed by using the custom_component. Necessary installation instructions can be found here.
pyhomematic has the requirement to manually add support for devices to make them usable in Home Assistant. hahomematic
automatically create entities for each parameter on each channel on every device (if it not black listed). To achieve this, all paramsets (VALUES
) are fetched (and cached for quick successive startups).
On top of that it is possible to add custom entity-classes to implement more complex entities, if it makes sense for a device, much like the devicetypes of pyhomematic. This will be needed for thermostats, lights, covers, climate, lock etc..
Homematic Devices supported by custom entities
Helpers for automatic re-connecting after a restart of the CCU are provided as well.
Due to a bug in previous version of the CCU2 / CCU3, hahomematic
requires at least the following version for usage with homematic IP devices:
- CCU2: 2.53.27
- CCU3: 3.53.26
More information about this bug can be found here: jens-maus/RaspberryMatic#843. Other CCU-like platforms that leverage the buggy version of the HmIPServer
aren't supported as well.