Metadata-Version: 2.1
Name: hahomematic
Version: 1.9.2
Summary: Homematic interface for Home Assistant running on Python 3.
Home-page: https://github.com/danielperna84/hahomematic
Author: Daniel Perna
Author-email: danielperna84@gmail.com
License: MIT License
Project-URL: Source Code, https://github.com/danielperna84/hahomematic
Project-URL: Bug Reports, https://github.com/danielperna84/hahomematic/issues
Project-URL: Docs: Dev, https://github.com/danielperna84/hahomematic
Keywords: home,assistant,homematic
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Home Automation
Requires-Python: >=3.9.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp (>=3.8.1)
Requires-Dist: voluptuous (>=0.13.1)
Requires-Dist: python-slugify (>=4.0.1)

# hahomematic

`hahomematic` is a Python 3 (>= 3.9) module for [Home Assistant](https://www.home-assistant.io/) to interact with [HomeMatic](https://www.eq-3.com/products/homematic.html) and [homematic IP](https://www.homematic-ip.com/en/start.html) devices. Some other devices (f.ex. Bosch, Intertechno) might be supported as well.

This is intended to become the successor of [pyhomematic](https://github.com/danielperna84/pyhomematic).

It can be installed by using the [custom_component](https://github.com/danielperna84/custom_homematic).
Necessary installation instructions can be found [here](https://github.com/danielperna84/custom_homematic/wiki/Installation).

## Project goal and features

[pyhomematic](https://github.com/danielperna84/pyhomematic) has the requirement to manually add support for devices to make them usable in [Home Assistant](https://www.home-assistant.io/). `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](https://github.com/danielperna84/pyhomematic/tree/master/pyhomematic/devicetypes) of [pyhomematic](https://github.com/danielperna84/pyhomematic). This will be needed for thermostats, lights, covers, climate, lock etc..

[Homematic Devices supported by custom entities](https://github.com/danielperna84/hahomematic/wiki/Homematic-Devices-supported-by-custom-entity)

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: https://github.com/jens-maus/RaspberryMatic/issues/843. Other CCU-like platforms that leverage the buggy version of the `HmIPServer` aren't supported as well.
