Skip to content

Python 3 Interface for Home Assistant to interact with HomeMatic devices

License

Notifications You must be signed in to change notification settings

SukramJ/hahomematic

Repository files navigation

hahomematic

hahomematic is a Python 3 module for Home Assistant to interact with HomeMatic and HomematicIP 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, siren etc..

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 HomematicIP 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.