# hahomematic
`hahomematic` is a Python 3 module for [Home Assistant](https://www.home-assistant.io/) to interact with [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](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, 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: 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.
Raw data
{
"_id": null,
"home_page": "https://github.com/danielperna84/hahomematic",
"name": "hahomematic",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12.0",
"maintainer_email": null,
"keywords": "home, automation, homematic",
"author": null,
"author_email": "Daniel Perna <danielperna84@gmail.com>, SukramJ <sukramj@icloud.com>",
"download_url": "https://files.pythonhosted.org/packages/4e/f9/64f888fcac4f389d5a7f1ee02cb9462cdbe3465de29d6c2a994912b7891b/hahomematic-2024.4.12.tar.gz",
"platform": "any",
"description": "# hahomematic\n\n`hahomematic` is a Python 3 module for [Home Assistant](https://www.home-assistant.io/) to interact with [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](https://www.homematic-ip.com/en/start.html) devices. Some other devices (f.ex. Bosch, Intertechno) might be supported as well.\n\nThis is intended to become the successor of [pyhomematic](https://github.com/danielperna84/pyhomematic).\n\nIt can be installed by using the [custom_component](https://github.com/danielperna84/custom_homematic).\nNecessary installation instructions can be found [here](https://github.com/danielperna84/custom_homematic/wiki/Installation).\n\n## Project goal and features\n\n[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).\n\nOn 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, siren etc..\n\nHelpers for automatic re-connecting after a restart of the CCU are provided as well.\n\n## Requirements\n\nDue to a bug in previous version of the CCU2 / CCU3, `hahomematic` requires at least the following version for usage with HomematicIP devices:\n\n- CCU2: 2.53.27\n- CCU3: 3.53.26\n\nMore 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.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Homematic interface for Home Assistant running on Python 3.",
"version": "2024.4.12",
"project_urls": {
"Bug Reports": "https://github.com/danielperna84/hahomematic/issues",
"Docs: Dev": "https://github.com/danielperna84/hahomematic",
"Forum": "https://github.com/danielperna84/hahomematic/discussions",
"Homepage": "https://github.com/danielperna84/hahomematic",
"Source Code": "https://github.com/danielperna84/hahomematic"
},
"split_keywords": [
"home",
" automation",
" homematic"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b36e0cfff18f40be925511a951fea296f5d7bbe353ba064a6b02290396d393cd",
"md5": "4e11685f150dadbc458a2069c16f22b9",
"sha256": "d3164ae2ba5888ccd43680cf8c08fd8de56b154fe3f53333a47a6ed1c91c78fe"
},
"downloads": -1,
"filename": "hahomematic-2024.4.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4e11685f150dadbc458a2069c16f22b9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12.0",
"size": 143820,
"upload_time": "2024-04-24T07:49:14",
"upload_time_iso_8601": "2024-04-24T07:49:14.716985Z",
"url": "https://files.pythonhosted.org/packages/b3/6e/0cfff18f40be925511a951fea296f5d7bbe353ba064a6b02290396d393cd/hahomematic-2024.4.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4ef964f888fcac4f389d5a7f1ee02cb9462cdbe3465de29d6c2a994912b7891b",
"md5": "1d6934a8f4b2ac0ccc5673156938e34a",
"sha256": "015d6d6fb25a02b61f86eb0ed9d4068329df11e43297aeb01edfc723c73e51e4"
},
"downloads": -1,
"filename": "hahomematic-2024.4.12.tar.gz",
"has_sig": false,
"md5_digest": "1d6934a8f4b2ac0ccc5673156938e34a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12.0",
"size": 141405,
"upload_time": "2024-04-24T07:49:17",
"upload_time_iso_8601": "2024-04-24T07:49:17.938381Z",
"url": "https://files.pythonhosted.org/packages/4e/f9/64f888fcac4f389d5a7f1ee02cb9462cdbe3465de29d6c2a994912b7891b/hahomematic-2024.4.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-24 07:49:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "danielperna84",
"github_project": "hahomematic",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "aiohttp",
"specs": [
[
">=",
"3.9.5"
]
]
},
{
"name": "orjson",
"specs": [
[
">=",
"3.10.1"
]
]
},
{
"name": "python-slugify",
"specs": [
[
">=",
"8.0.4"
]
]
},
{
"name": "voluptuous",
"specs": [
[
">=",
"0.14.2"
]
]
}
],
"lcname": "hahomematic"
}