hahomematic


Namehahomematic JSON
Version 2025.2.7 PyPI version JSON
download
home_pagehttps://github.com/sukramj/hahomematic
SummaryHomematic interface for Home Assistant running on Python 3.
upload_time2025-02-09 11:23:42
maintainerNone
docs_urlNone
authorNone
requires_python>=3.13.0
licenseMIT License
keywords home automation homematic
VCS
bugtrack_url
requirements aiohttp orjson python-slugify voluptuous
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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/sukramj/custom_homematic).
Necessary installation instructions can be found [here](https://github.com/sukramj/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/sukramj/hahomematic",
    "name": "hahomematic",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.13.0",
    "maintainer_email": null,
    "keywords": "home, automation, homematic",
    "author": null,
    "author_email": "SukramJ <sukramj@icloud.com>, Daniel Perna <danielperna84@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/83/17/7e982906f627626ec97e134a7437d15f88e484008f535d756945556ae135/hahomematic-2025.2.7.tar.gz",
    "platform": null,
    "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/sukramj/custom_homematic).\nNecessary installation instructions can be found [here](https://github.com/sukramj/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": "2025.2.7",
    "project_urls": {
        "Bug Reports": "https://github.com/sukramj/hahomematic/issues",
        "Docs: Dev": "https://github.com/sukramj/hahomematic",
        "Forum": "https://github.com/sukramj/hahomematic/discussions",
        "Homepage": "https://github.com/sukramj/hahomematic",
        "Source Code": "https://github.com/sukramj/hahomematic"
    },
    "split_keywords": [
        "home",
        " automation",
        " homematic"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "358b8521ff0b12e113e98654ca156ffc9983bd9a5abff9e1d52ce2ab5dd51f33",
                "md5": "c8d97e60dfbd5878619e556c8f589f85",
                "sha256": "c229e3da2f8867f926a5b4e3df25c9cc4356f85c21f5efb9e6bb882cf9a6f30b"
            },
            "downloads": -1,
            "filename": "hahomematic-2025.2.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c8d97e60dfbd5878619e556c8f589f85",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.13.0",
            "size": 179376,
            "upload_time": "2025-02-09T11:23:39",
            "upload_time_iso_8601": "2025-02-09T11:23:39.622851Z",
            "url": "https://files.pythonhosted.org/packages/35/8b/8521ff0b12e113e98654ca156ffc9983bd9a5abff9e1d52ce2ab5dd51f33/hahomematic-2025.2.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "83177e982906f627626ec97e134a7437d15f88e484008f535d756945556ae135",
                "md5": "b4b6cfba9b0f226cc8f3438ae4bbf3df",
                "sha256": "ef7c2c893b9df9e77cf738277259d7161e0d305eddc45c2cad5de4ba3fd622f0"
            },
            "downloads": -1,
            "filename": "hahomematic-2025.2.7.tar.gz",
            "has_sig": false,
            "md5_digest": "b4b6cfba9b0f226cc8f3438ae4bbf3df",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.13.0",
            "size": 179494,
            "upload_time": "2025-02-09T11:23:42",
            "upload_time_iso_8601": "2025-02-09T11:23:42.174742Z",
            "url": "https://files.pythonhosted.org/packages/83/17/7e982906f627626ec97e134a7437d15f88e484008f535d756945556ae135/hahomematic-2025.2.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-09 11:23:42",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "sukramj",
    "github_project": "hahomematic",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "aiohttp",
            "specs": [
                [
                    ">=",
                    "3.11.11"
                ]
            ]
        },
        {
            "name": "orjson",
            "specs": [
                [
                    ">=",
                    "3.10.15"
                ]
            ]
        },
        {
            "name": "python-slugify",
            "specs": [
                [
                    ">=",
                    "8.0.4"
                ]
            ]
        },
        {
            "name": "voluptuous",
            "specs": [
                [
                    ">=",
                    "0.15.2"
                ]
            ]
        }
    ],
    "lcname": "hahomematic"
}
        
Elapsed time: 0.48930s