/hahomematic

Python 3 Interface for Home Assistant to interact with HomeMatic devices

Primary LanguagePythonMIT LicenseMIT

hahomematic

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.

Project goal and features

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.

Requirements

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.