hahomematic


Namehahomematic JSON
Version 2024.2.2 PyPI version JSON
download
home_pagehttps://github.com/danielperna84/hahomematic
SummaryHomematic interface for Home Assistant running on Python 3.
upload_time2024-02-11 17:23:35
maintainer
docs_urlNone
author
requires_python>=3.11.0
licenseMIT License
keywords home automation homematic
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            # hahomematic

`hahomematic` is a Python 3 (>= 3.11) 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": "",
    "docs_url": null,
    "requires_python": ">=3.11.0",
    "maintainer_email": "",
    "keywords": "home,automation,homematic",
    "author": "",
    "author_email": "Daniel Perna <danielperna84@gmail.com>, SukramJ <sukramj@icloud.com>",
    "download_url": "https://files.pythonhosted.org/packages/13/a2/fe9f2f737e6ef324d1276fe6c2a2fc08fb5393f99074c1c7accbb9854fe5/hahomematic-2024.2.2.tar.gz",
    "platform": "any",
    "description": "# hahomematic\n\n`hahomematic` is a Python 3 (>= 3.11) 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.2.2",
    "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": "0c798244d27e3e3ba5afc19d825a44d7861ba2ccbc57c8ac50405f5735145b71",
                "md5": "c862198123e2200cfb7cc8535f063beb",
                "sha256": "8df9f9969b801734a903e0f1d712651f14af8238c5473d14777f33d973f86f65"
            },
            "downloads": -1,
            "filename": "hahomematic-2024.2.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c862198123e2200cfb7cc8535f063beb",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11.0",
            "size": 136178,
            "upload_time": "2024-02-11T17:23:31",
            "upload_time_iso_8601": "2024-02-11T17:23:31.632513Z",
            "url": "https://files.pythonhosted.org/packages/0c/79/8244d27e3e3ba5afc19d825a44d7861ba2ccbc57c8ac50405f5735145b71/hahomematic-2024.2.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "13a2fe9f2f737e6ef324d1276fe6c2a2fc08fb5393f99074c1c7accbb9854fe5",
                "md5": "03e95dfd7bcbcea9f0d408bd385b6792",
                "sha256": "3e2f3b3d8b19320d57a4761509a70b5d2e40120cc2b52501c5a2e56188de6516"
            },
            "downloads": -1,
            "filename": "hahomematic-2024.2.2.tar.gz",
            "has_sig": false,
            "md5_digest": "03e95dfd7bcbcea9f0d408bd385b6792",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11.0",
            "size": 132179,
            "upload_time": "2024-02-11T17:23:35",
            "upload_time_iso_8601": "2024-02-11T17:23:35.316029Z",
            "url": "https://files.pythonhosted.org/packages/13/a2/fe9f2f737e6ef324d1276fe6c2a2fc08fb5393f99074c1c7accbb9854fe5/hahomematic-2024.2.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-11 17:23:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "danielperna84",
    "github_project": "hahomematic",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "lcname": "hahomematic"
}
        
Elapsed time: 0.26206s