aiohomematic 2025.8.8__py3-none-any.whl → 2025.8.10__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of aiohomematic might be problematic. Click here for more details.
- aiohomematic/__init__.py +15 -1
- aiohomematic/async_support.py +15 -2
- aiohomematic/caches/__init__.py +2 -0
- aiohomematic/caches/dynamic.py +2 -0
- aiohomematic/caches/persistent.py +29 -22
- aiohomematic/caches/visibility.py +277 -252
- aiohomematic/central/__init__.py +69 -49
- aiohomematic/central/decorators.py +60 -15
- aiohomematic/central/xml_rpc_server.py +15 -1
- aiohomematic/client/__init__.py +2 -0
- aiohomematic/client/_rpc_errors.py +81 -0
- aiohomematic/client/json_rpc.py +68 -19
- aiohomematic/client/xml_rpc.py +15 -8
- aiohomematic/const.py +145 -77
- aiohomematic/context.py +11 -1
- aiohomematic/converter.py +27 -1
- aiohomematic/decorators.py +88 -19
- aiohomematic/exceptions.py +19 -1
- aiohomematic/hmcli.py +13 -1
- aiohomematic/model/__init__.py +2 -0
- aiohomematic/model/calculated/__init__.py +2 -0
- aiohomematic/model/calculated/climate.py +2 -0
- aiohomematic/model/calculated/data_point.py +7 -1
- aiohomematic/model/calculated/operating_voltage_level.py +2 -0
- aiohomematic/model/calculated/support.py +2 -0
- aiohomematic/model/custom/__init__.py +2 -0
- aiohomematic/model/custom/climate.py +3 -1
- aiohomematic/model/custom/const.py +2 -0
- aiohomematic/model/custom/cover.py +30 -2
- aiohomematic/model/custom/data_point.py +6 -0
- aiohomematic/model/custom/definition.py +2 -0
- aiohomematic/model/custom/light.py +18 -10
- aiohomematic/model/custom/lock.py +2 -0
- aiohomematic/model/custom/siren.py +5 -2
- aiohomematic/model/custom/support.py +2 -0
- aiohomematic/model/custom/switch.py +2 -0
- aiohomematic/model/custom/valve.py +2 -0
- aiohomematic/model/data_point.py +30 -3
- aiohomematic/model/decorators.py +29 -8
- aiohomematic/model/device.py +9 -5
- aiohomematic/model/event.py +2 -0
- aiohomematic/model/generic/__init__.py +2 -0
- aiohomematic/model/generic/action.py +2 -0
- aiohomematic/model/generic/binary_sensor.py +2 -0
- aiohomematic/model/generic/button.py +2 -0
- aiohomematic/model/generic/data_point.py +4 -1
- aiohomematic/model/generic/number.py +4 -1
- aiohomematic/model/generic/select.py +4 -1
- aiohomematic/model/generic/sensor.py +2 -0
- aiohomematic/model/generic/switch.py +2 -0
- aiohomematic/model/generic/text.py +2 -0
- aiohomematic/model/hub/__init__.py +2 -0
- aiohomematic/model/hub/binary_sensor.py +2 -0
- aiohomematic/model/hub/button.py +2 -0
- aiohomematic/model/hub/data_point.py +6 -0
- aiohomematic/model/hub/number.py +2 -0
- aiohomematic/model/hub/select.py +2 -0
- aiohomematic/model/hub/sensor.py +2 -0
- aiohomematic/model/hub/switch.py +2 -0
- aiohomematic/model/hub/text.py +2 -0
- aiohomematic/model/support.py +26 -1
- aiohomematic/model/update.py +6 -0
- aiohomematic/support.py +175 -5
- aiohomematic/validator.py +49 -2
- aiohomematic-2025.8.10.dist-info/METADATA +124 -0
- aiohomematic-2025.8.10.dist-info/RECORD +78 -0
- {aiohomematic-2025.8.8.dist-info → aiohomematic-2025.8.10.dist-info}/licenses/LICENSE +1 -1
- aiohomematic-2025.8.8.dist-info/METADATA +0 -69
- aiohomematic-2025.8.8.dist-info/RECORD +0 -77
- {aiohomematic-2025.8.8.dist-info → aiohomematic-2025.8.10.dist-info}/WHEEL +0 -0
- {aiohomematic-2025.8.8.dist-info → aiohomematic-2025.8.10.dist-info}/top_level.txt +0 -0
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: aiohomematic
|
|
3
|
+
Version: 2025.8.10
|
|
4
|
+
Summary: Homematic interface for Home Assistant running on Python 3.
|
|
5
|
+
Home-page: https://github.com/sukramj/aiohomematic
|
|
6
|
+
Author-email: SukramJ <sukramj@icloud.com>, Daniel Perna <danielperna84@gmail.com>
|
|
7
|
+
License: MIT License
|
|
8
|
+
Project-URL: Source Code, https://github.com/sukramj/aiohomematic
|
|
9
|
+
Project-URL: Bug Reports, https://github.com/sukramj/aiohomematic/issues
|
|
10
|
+
Project-URL: Docs: Dev, https://github.com/sukramj/aiohomematic
|
|
11
|
+
Project-URL: Forum, https://github.com/sukramj/aiohomematic/discussions
|
|
12
|
+
Keywords: home,automation,homematic
|
|
13
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
14
|
+
Classifier: Intended Audience :: End Users/Desktop
|
|
15
|
+
Classifier: Intended Audience :: Developers
|
|
16
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
17
|
+
Classifier: Operating System :: OS Independent
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
+
Classifier: Topic :: Home Automation
|
|
20
|
+
Requires-Python: >=3.13.0
|
|
21
|
+
Description-Content-Type: text/markdown
|
|
22
|
+
License-File: LICENSE
|
|
23
|
+
Requires-Dist: aiohttp>=3.10.0
|
|
24
|
+
Requires-Dist: orjson>=3.10.0
|
|
25
|
+
Requires-Dist: python-slugify>=8.0.0
|
|
26
|
+
Requires-Dist: voluptuous>=0.14.0
|
|
27
|
+
Dynamic: license-file
|
|
28
|
+
|
|
29
|
+
# AIO Homematic (hahomematic)
|
|
30
|
+
|
|
31
|
+
A lightweight Python 3 library that powers Home Assistant integrations for controlling and monitoring [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](https://www.homematic-ip.com/en/start.html) devices. Some third‑party devices/gateways (e.g., Bosch, Intertechno) may be supported as well.
|
|
32
|
+
|
|
33
|
+
This project is the modern successor to [pyhomematic](https://github.com/danielperna84/pyhomematic), focusing on automatic entity creation, fewer manual device definitions, and faster startups.
|
|
34
|
+
|
|
35
|
+
## How it works
|
|
36
|
+
|
|
37
|
+
Unlike pyhomematic, which required manual device mappings, aiohomematic automatically creates entities for each relevant parameter on every device channel (unless blacklisted). To achieve this it:
|
|
38
|
+
|
|
39
|
+
- Fetches and caches device paramsets (VALUES) for fast successive startups.
|
|
40
|
+
- Provides hooks for custom entity classes where complex behavior is needed (e.g., thermostats, lights, covers, climate, locks, sirens).
|
|
41
|
+
- Includes helpers for robust operation, such as automatic reconnection after CCU restarts.
|
|
42
|
+
|
|
43
|
+
## Key features
|
|
44
|
+
|
|
45
|
+
- Automatic entity discovery from device/channel parameters.
|
|
46
|
+
- Extensible via custom entity classes for complex devices.
|
|
47
|
+
- Caching of paramsets to speed up restarts.
|
|
48
|
+
- Designed to integrate with Home Assistant.
|
|
49
|
+
|
|
50
|
+
## Quickstart for Home Assistant
|
|
51
|
+
|
|
52
|
+
Use the Home Assistant custom integration "Homematic(IP) Local", which is powered by aiohomematic.
|
|
53
|
+
|
|
54
|
+
1. Prerequisites
|
|
55
|
+
- Home Assistant 2024.6 or newer recommended.
|
|
56
|
+
- A CCU3, RaspberryMatic, or Homegear instance reachable from Home Assistant.
|
|
57
|
+
- For HomematicIP devices, ensure CCU firmware meets the minimum versions listed below.
|
|
58
|
+
2. Install the integration
|
|
59
|
+
- Add the custom repository and install: https://github.com/sukramj/homematicip_local
|
|
60
|
+
- Follow the installation guide: https://github.com/sukramj/homematicip_local/wiki/Installation
|
|
61
|
+
3. Configure via Home Assistant UI
|
|
62
|
+
- In Home Assistant: Settings → Devices & Services → Add Integration → search for "Homematic(IP) Local".
|
|
63
|
+
- Enter the CCU/Homegear host (IP or hostname). If you use HTTPS on the CCU, enable SSL and accept the certificate if self‑signed.
|
|
64
|
+
- Provide credentials if your CCU requires them.
|
|
65
|
+
- Choose which interfaces to enable (HM, HmIP, Virtual). Default ports are typically 2001 (HM), 2010 (HmIP), 9292 (Virtual).
|
|
66
|
+
4. Network callbacks
|
|
67
|
+
- The integration needs to receive XML‑RPC callbacks from the CCU. Make sure Home Assistant is reachable from the CCU (no NAT/firewall blocking). The default callback port is 43439; you can adjust it in advanced options.
|
|
68
|
+
5. Verify
|
|
69
|
+
- After setup, devices should appear under Devices & Services → Homematic(IP) Local. Discovery may take a few seconds after the first connection while paramsets are fetched and cached for faster restarts.
|
|
70
|
+
|
|
71
|
+
If you need to use aiohomematic directly in Python, see the Public API and example below.
|
|
72
|
+
|
|
73
|
+
## Requirements
|
|
74
|
+
|
|
75
|
+
Due to a bug in earlier CCU2/CCU3 firmware, aiohomematic requires at least the following versions when used with HomematicIP devices:
|
|
76
|
+
|
|
77
|
+
- CCU2: 2.53.27
|
|
78
|
+
- CCU3: 3.53.26
|
|
79
|
+
|
|
80
|
+
See details here: https://github.com/jens-maus/RaspberryMatic/issues/843. Other CCU‑like platforms using the buggy HmIPServer version are not supported.
|
|
81
|
+
|
|
82
|
+
## Public API and imports
|
|
83
|
+
|
|
84
|
+
- The public API of aiohomematic is explicitly defined via **all** in each module and subpackage.
|
|
85
|
+
- Backwards‑compatible imports should target these modules:
|
|
86
|
+
- aiohomematic.central: CentralUnit, CentralConfig and related schemas
|
|
87
|
+
- aiohomematic.client: Client, InterfaceConfig, create_client, get_client
|
|
88
|
+
- aiohomematic.model: device/data point abstractions (see subpackages for details)
|
|
89
|
+
- aiohomematic.exceptions: library exception types intended for consumers
|
|
90
|
+
- aiohomematic.const: constants and enums (stable subset; see module **all**)
|
|
91
|
+
- The top‑level package only exposes **version** to avoid import cycles and keep startup lean. Prefer importing from the specific submodules listed above.
|
|
92
|
+
|
|
93
|
+
Example:
|
|
94
|
+
|
|
95
|
+
from aiohomematic.central import CentralConfig
|
|
96
|
+
from aiohomematic import client as hmcl
|
|
97
|
+
|
|
98
|
+
cfg = CentralConfig(
|
|
99
|
+
central_id="ccu-main",
|
|
100
|
+
host="ccu.local",
|
|
101
|
+
username="admin",
|
|
102
|
+
password="secret",
|
|
103
|
+
default_callback_port=43439,
|
|
104
|
+
interface_configs={hmcl.InterfaceConfig(interface=hmcl.Interface.HMIP, port=2010, enabled=True)},
|
|
105
|
+
)
|
|
106
|
+
central = cfg.create_central()
|
|
107
|
+
|
|
108
|
+
## Useful links
|
|
109
|
+
|
|
110
|
+
- Changelog: [see](changelog.md) for release history and latest changes.
|
|
111
|
+
- Definition of calculated data points: [see](docs/calculated_data_points.md)
|
|
112
|
+
- Homematic(IP) Local integration: https://github.com/sukramj/homematicip_local
|
|
113
|
+
- Input select helper: [see](docs/input_select_helper.md) for an overview of how to use the input select helper.
|
|
114
|
+
- Troubleshooting with Home Assistant: [see](docs/homeassistant_troubleshooting.md) for common issues and how to debug them.
|
|
115
|
+
- Unignore mechanism: [see](docs/unignore.md) for how to unignore devices that are ignored by default.
|
|
116
|
+
|
|
117
|
+
## Useful developer links
|
|
118
|
+
|
|
119
|
+
- Architecture overview: [see](docs/architecture.md) for an overview of the architecture of the library.
|
|
120
|
+
- Data flow: [see](docs/data_flow.md) for an overview of how data flows through the library.
|
|
121
|
+
- Extending the model: [see](docs/extension_points.md) for adding custom device profiles and calculated data points.
|
|
122
|
+
- Home Assistant lifecycle (discovery, updates, teardown): [see](docs/homeassistant_lifecycle.md) for details on how the integration works and how to debug issues.
|
|
123
|
+
- RSSI fix: [see](docs/rssi_fix.md) for how RSSI values are fixed for Home Assistant.
|
|
124
|
+
- Sequence diagrams: [see](docs/sequence_diagrams.md) for a sequence diagram of how the library works.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
aiohomematic/__init__.py,sha256=VPESkjzeVserFI2DDVAxD782cgYRlLK0sXJzLrr3e_k,2283
|
|
2
|
+
aiohomematic/async_support.py,sha256=Xc55KkIV0h8rf936QKyU4OHSZsPEZ8TwuV8gVveeRh8,6106
|
|
3
|
+
aiohomematic/const.py,sha256=EdtEgzd6a_XYytFHPLj0hHNxxTxLHuC5j5wcfQbJ2-o,25408
|
|
4
|
+
aiohomematic/context.py,sha256=M7gkA7KFT0dp35gzGz2dzKVXu1PP0sAnepgLlmjyRS4,451
|
|
5
|
+
aiohomematic/converter.py,sha256=QTOL8_B6SoCoqLuRSkjtOlfa7BVFSvOfnSBrDngiinA,3558
|
|
6
|
+
aiohomematic/decorators.py,sha256=Iaq172N68w_RL-isiyJ3_suGM1kj1NaVbDWmlgOmTH8,9569
|
|
7
|
+
aiohomematic/exceptions.py,sha256=o_H3Z0A2TQ0irNxUM9u8bmivq0L_mwPCB7nhxEawDxE,5018
|
|
8
|
+
aiohomematic/hmcli.py,sha256=wHOLq4IJRSY9RJux_ZfDH1gQ1ZqD0k68ua5agyBkkE8,4933
|
|
9
|
+
aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
10
|
+
aiohomematic/support.py,sha256=d70tjuajEQYGFsINJQA9-RkKuCRN8-2Sw33B0bPMym8,21495
|
|
11
|
+
aiohomematic/validator.py,sha256=vChkYQ9dGKCQEigiBMnoeyPkCJDJlIm6DSgR1gmeHH0,3545
|
|
12
|
+
aiohomematic/caches/__init__.py,sha256=_gI30tbsWgPRaHvP6cRxOQr6n9bYZzU-jp1WbHhWg-A,470
|
|
13
|
+
aiohomematic/caches/dynamic.py,sha256=ZrAQqXlzhoCvzjZ9cTEtlWqygvkn5xTzOJ987WcrPBc,21539
|
|
14
|
+
aiohomematic/caches/persistent.py,sha256=YBThIByt0mLQCgcZwBBmqanI8obAhHNcFULz_H-de8o,19932
|
|
15
|
+
aiohomematic/caches/visibility.py,sha256=uZ1sSCfmEQURllPvSbJ3EzFVFE7TU8XcxMDSHRpNmMs,31481
|
|
16
|
+
aiohomematic/central/__init__.py,sha256=vr4JVYbCO0bdgmVw8lHL7DrPjLlAnYtjXNcThuRH5dA,85733
|
|
17
|
+
aiohomematic/central/decorators.py,sha256=Sl-cMDhreiAOKkIHiei-QbIOcvbWGVX-QwB5bLeohak,6904
|
|
18
|
+
aiohomematic/central/xml_rpc_server.py,sha256=dM-gbAS1NpRy4wJKUZTsMI2LJfv_vjd4kvyv3pl86yw,10545
|
|
19
|
+
aiohomematic/client/__init__.py,sha256=hGpdDb518VdMYMHxrBBj2PBpUBN2Ah8ID5vjokd9PAU,69832
|
|
20
|
+
aiohomematic/client/_rpc_errors.py,sha256=vu76ZWMwJJEgB0cnXc10JzK8PaiRU7jYOvj1aC21CqE,2971
|
|
21
|
+
aiohomematic/client/json_rpc.py,sha256=6eHRYM4xcXUS_Ny3tnjSxw7F0GpaRMUjkqwj1HGaT7w,48231
|
|
22
|
+
aiohomematic/client/xml_rpc.py,sha256=OUWQkvYYbw9duFzNAB4CXavwwh-slBtitmMPGWShbNg,8504
|
|
23
|
+
aiohomematic/model/__init__.py,sha256=l1YMXkx1ugdUf7ms8lD8ObVaOzKAhi-4O2TO5s0IMd0,5459
|
|
24
|
+
aiohomematic/model/data_point.py,sha256=N446xJizb9jMtrX8TFW7NQ0wj8VbTxQREFsiVUnArKA,40738
|
|
25
|
+
aiohomematic/model/decorators.py,sha256=JGhDzWx983zBCEKA9UoptjFmIHOGX-UfgozhqXAeZsM,7663
|
|
26
|
+
aiohomematic/model/device.py,sha256=6PDtZPZ6S-3cjEmb20zrnAh6VYG9fMtAIi1OnuV9r5s,51991
|
|
27
|
+
aiohomematic/model/event.py,sha256=vXtqb9OfpumOOmbgj9z6DG-QeVUEHMOvK1gnv0piKDY,7014
|
|
28
|
+
aiohomematic/model/support.py,sha256=TnEpCB8EgJq_-4LoH-et1R0cPT6Lq4LTv7MxmRn5JQU,20767
|
|
29
|
+
aiohomematic/model/update.py,sha256=DemrlE8TleJgaxBwj984NxzZGeLEKpC3xAo0Ew21HLU,5107
|
|
30
|
+
aiohomematic/model/calculated/__init__.py,sha256=BHYLdWMMMjqvDI5T9cQ1sPOyk7t8_q-Ngfm4cFySvJ4,2810
|
|
31
|
+
aiohomematic/model/calculated/climate.py,sha256=BUKXT5kd6mbEE7TAJpRs8-A1K4pVq2d2E5cSfjsOPJw,8515
|
|
32
|
+
aiohomematic/model/calculated/data_point.py,sha256=hspOOnEp-WbXb4VMTcuXkgTWxjy0ug5E46zXZy6YReQ,11493
|
|
33
|
+
aiohomematic/model/calculated/operating_voltage_level.py,sha256=sf5Fy0bSbvee9lvq95-iFC05rSGkHBOKIQkdjQBU_XY,14011
|
|
34
|
+
aiohomematic/model/calculated/support.py,sha256=ODH3a2B1y8Mr9N_3sMt0pyUs1qQ1tDZsD2GthScntbg,6098
|
|
35
|
+
aiohomematic/model/custom/__init__.py,sha256=KNvUy3hZvdr3aRZk9CDyMqJBqRorQedZfOP3M-zwjp8,6066
|
|
36
|
+
aiohomematic/model/custom/climate.py,sha256=te8GoqqDU8wQAEDTf3Pyi8NFdm9MACCe8WyhBG74x28,54018
|
|
37
|
+
aiohomematic/model/custom/const.py,sha256=Kh1pnab6nmwbaY43CfXQy3yrWpPwsrQdl1Ea2aZ6aw0,4961
|
|
38
|
+
aiohomematic/model/custom/cover.py,sha256=dXYZGVzR-cFELbVP2az8tkM8h7jIrvzweUz4yWh7AM8,28552
|
|
39
|
+
aiohomematic/model/custom/data_point.py,sha256=mz143_hLKaF9HzJRhqqqzsoJhouLF0L_9Jo_4oq_6Gc,14109
|
|
40
|
+
aiohomematic/model/custom/definition.py,sha256=1GkUyEsmjJfAdrBCW1ZBmboYZOyb00MctUE_xn4Zyl8,35481
|
|
41
|
+
aiohomematic/model/custom/light.py,sha256=0QC6x6eYuDypNMbk-Ey7CMfVs1B0vgFz2YzFzqQhbzw,44170
|
|
42
|
+
aiohomematic/model/custom/lock.py,sha256=q-jsvMTly6s7kEWDT42rMEfEEJsd9lBIuwzpO2STFBk,11937
|
|
43
|
+
aiohomematic/model/custom/siren.py,sha256=yfWdNj-vEUGLqXBejjURd98RzY8MQv99oXxy35Ul_6U,9726
|
|
44
|
+
aiohomematic/model/custom/support.py,sha256=UvencsvCwgpm4iqRNRt5KRs560tyw1NhYP5ZaqmCT2k,1453
|
|
45
|
+
aiohomematic/model/custom/switch.py,sha256=JSmWUWc_WB8XmZPPgcISB9r3TNNUeg-E4skX46z7vwA,6869
|
|
46
|
+
aiohomematic/model/custom/valve.py,sha256=S5i2ZePa9Jt8JplIykzeJxpJrSBEN5w-3UEmGu0Q5G0,4226
|
|
47
|
+
aiohomematic/model/generic/__init__.py,sha256=OI0-ijDRYS6OkDqVd9C9UOfde2rfcB7WZZ9CLTlX1S0,7613
|
|
48
|
+
aiohomematic/model/generic/action.py,sha256=5SPWVliRqXlPgtb2bI6le0-V6JR5krzw8z_0FaOXu5U,994
|
|
49
|
+
aiohomematic/model/generic/binary_sensor.py,sha256=TI_KNzObiprHFS6rUKb7cYr2EsQQElfNo8Sk7eBY9NQ,884
|
|
50
|
+
aiohomematic/model/generic/button.py,sha256=9wStCwiE3NeGfKHum5IVpLlbq5jRdYOA1bGHSqReY8k,742
|
|
51
|
+
aiohomematic/model/generic/data_point.py,sha256=a7AXyYd0o-AfMOaGIn1qu8Q73ipjjsLLQrxMFJRw5xQ,6019
|
|
52
|
+
aiohomematic/model/generic/number.py,sha256=39paL6us6KMLD5L8GhR7BLl8bKtEiicAIfcd_3HyOw4,2666
|
|
53
|
+
aiohomematic/model/generic/select.py,sha256=vCe5FpMe2iqePQMHFBxKmkIBY6Y99SnTyiatmeZC6dM,1532
|
|
54
|
+
aiohomematic/model/generic/sensor.py,sha256=N2GeZjZQbRyc4s8lX11xvho_TOqIdT6Uqc7LguBF9Ho,2250
|
|
55
|
+
aiohomematic/model/generic/switch.py,sha256=wr6vEBc0iTyCGaRSVdoO_9UY8lt3-NPTyAXEhuZbAqU,1836
|
|
56
|
+
aiohomematic/model/generic/text.py,sha256=vTgQpX_COn1OxExZ5az9jPU410fGZIbq0PajPS8vXgs,851
|
|
57
|
+
aiohomematic/model/hub/__init__.py,sha256=_UEEiNHfUVb0D0qTMcR2_YH1ZcYu1jzgLnUApPWfT2k,13493
|
|
58
|
+
aiohomematic/model/hub/binary_sensor.py,sha256=0cF1SCJY1BRM1_Fx5oYPMaSZu9tDy1GnBMn_UqpqqPk,749
|
|
59
|
+
aiohomematic/model/hub/button.py,sha256=N0QSN-SdnLY38JslCoUaqjI2pcdp0DJY2kxoODUKO0s,889
|
|
60
|
+
aiohomematic/model/hub/data_point.py,sha256=3HscnhIbOQlipWZKliHZPvZulvtpTAF83qS0-4iCzVQ,10645
|
|
61
|
+
aiohomematic/model/hub/number.py,sha256=mj4HVRGgUqoyAyluSzKwlE_0jconltBAx-2nJuL9bhY,1224
|
|
62
|
+
aiohomematic/model/hub/select.py,sha256=s5_nmMCae35I7WtUK2Oo_577JzBt68BSpgv5cTussps,1658
|
|
63
|
+
aiohomematic/model/hub/sensor.py,sha256=Uqqb1rqVmYCemJK4yIkarkllKWZJTpd-VNiyLOKXl3M,1189
|
|
64
|
+
aiohomematic/model/hub/switch.py,sha256=1Dp_jG4qtnAs-itaZDKStmeD4PdiMtdZctDOoGWI-Qg,1391
|
|
65
|
+
aiohomematic/model/hub/text.py,sha256=AQOQB2W0jt8t__FxahDAAEOGhshkAX1pImHIFt_Xwqg,987
|
|
66
|
+
aiohomematic/rega_scripts/fetch_all_device_data.fn,sha256=7uxhHoelAOsH6yYr1n1M1XwIRgDmItiHnWIMhDYEimk,4373
|
|
67
|
+
aiohomematic/rega_scripts/get_program_descriptions.fn,sha256=pGmj377MkqbZi6j-UBKQAsXTphwh1kDwDKqXij8zUBE,835
|
|
68
|
+
aiohomematic/rega_scripts/get_serial.fn,sha256=t1oeo-sB_EuVeiY24PLcxFSkdQVgEWGXzpemJQZFybY,1079
|
|
69
|
+
aiohomematic/rega_scripts/get_system_variable_descriptions.fn,sha256=UKXvC0_5lSApdQ2atJc0E5Stj5Zt3lqh0EcliokYu2c,849
|
|
70
|
+
aiohomematic/rega_scripts/set_program_state.fn,sha256=0bnv7lUj8FMjDZBz325tDVP61m04cHjVj4kIOnUUgpY,279
|
|
71
|
+
aiohomematic/rega_scripts/set_system_variable.fn,sha256=sTmr7vkPTPnPkor5cnLKlDvfsYRbGO1iq2z_2pMXq5E,383
|
|
72
|
+
aiohomematic-2025.8.10.dist-info/licenses/LICENSE,sha256=q-B0xpREuZuvKsmk3_iyVZqvZ-vJcWmzMZpeAd0RqtQ,1083
|
|
73
|
+
aiohomematic_support/__init__.py,sha256=_0YtF4lTdC_k6-zrM2IefI0u0LMr_WA61gXAyeGLgbY,66
|
|
74
|
+
aiohomematic_support/client_local.py,sha256=cvkO3tcxSJKy5ZLVdeqDbvSmeottxqZJNI4ccdxIVD4,12524
|
|
75
|
+
aiohomematic-2025.8.10.dist-info/METADATA,sha256=Srm8S5cBMy77q-GowiujO6AupVIou9CwZ15HZOHODGU,6871
|
|
76
|
+
aiohomematic-2025.8.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
77
|
+
aiohomematic-2025.8.10.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
|
|
78
|
+
aiohomematic-2025.8.10.dist-info/RECORD,,
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: aiohomematic
|
|
3
|
-
Version: 2025.8.8
|
|
4
|
-
Summary: Homematic interface for Home Assistant running on Python 3.
|
|
5
|
-
Home-page: https://github.com/sukramj/aiohomematic
|
|
6
|
-
Author-email: SukramJ <sukramj@icloud.com>, Daniel Perna <danielperna84@gmail.com>
|
|
7
|
-
License: MIT License
|
|
8
|
-
Project-URL: Source Code, https://github.com/sukramj/aiohomematic
|
|
9
|
-
Project-URL: Bug Reports, https://github.com/sukramj/aiohomematic/issues
|
|
10
|
-
Project-URL: Docs: Dev, https://github.com/sukramj/aiohomematic
|
|
11
|
-
Project-URL: Forum, https://github.com/sukramj/aiohomematic/discussions
|
|
12
|
-
Keywords: home,automation,homematic
|
|
13
|
-
Classifier: Development Status :: 5 - Production/Stable
|
|
14
|
-
Classifier: Intended Audience :: End Users/Desktop
|
|
15
|
-
Classifier: Intended Audience :: Developers
|
|
16
|
-
Classifier: License :: OSI Approved :: MIT License
|
|
17
|
-
Classifier: Operating System :: OS Independent
|
|
18
|
-
Classifier: Programming Language :: Python :: 3.13
|
|
19
|
-
Classifier: Topic :: Home Automation
|
|
20
|
-
Requires-Python: >=3.13.0
|
|
21
|
-
Description-Content-Type: text/markdown
|
|
22
|
-
License-File: LICENSE
|
|
23
|
-
Requires-Dist: aiohttp>=3.10.0
|
|
24
|
-
Requires-Dist: orjson>=3.10.0
|
|
25
|
-
Requires-Dist: python-slugify>=8.0.0
|
|
26
|
-
Requires-Dist: voluptuous>=0.14.0
|
|
27
|
-
Dynamic: license-file
|
|
28
|
-
|
|
29
|
-
# AIO Homematic (hahomematic)
|
|
30
|
-
|
|
31
|
-
A lightweight Python 3 library that powers Home Assistant integrations for controlling and monitoring [HomeMatic](https://www.eq-3.com/products/homematic.html) and [HomematicIP](https://www.homematic-ip.com/en/start.html) devices. Some third‑party devices/gateways (e.g., Bosch, Intertechno) may be supported as well.
|
|
32
|
-
|
|
33
|
-
This project is the modern successor to [pyhomematic](https://github.com/danielperna84/pyhomematic), focusing on automatic entity creation, fewer manual device definitions, and faster startups.
|
|
34
|
-
|
|
35
|
-
## How it works
|
|
36
|
-
|
|
37
|
-
Unlike pyhomematic, which required manual device mappings, aiohomematic automatically creates entities for each relevant parameter on every device channel (unless blacklisted). To achieve this it:
|
|
38
|
-
|
|
39
|
-
- Fetches and caches device paramsets (VALUES) for fast successive startups.
|
|
40
|
-
- Provides hooks for custom entity classes where complex behavior is needed (e.g., thermostats, lights, covers, climate, locks, sirens).
|
|
41
|
-
- Includes helpers for robust operation, such as automatic reconnection after CCU restarts.
|
|
42
|
-
|
|
43
|
-
## Key features
|
|
44
|
-
|
|
45
|
-
- Automatic entity discovery from device/channel parameters.
|
|
46
|
-
- Extensible via custom entity classes for complex devices.
|
|
47
|
-
- Caching of paramsets to speed up restarts.
|
|
48
|
-
- Designed to integrate with Home Assistant.
|
|
49
|
-
|
|
50
|
-
## Installation (with Home Assistant)
|
|
51
|
-
|
|
52
|
-
Install via the custom component: [Homematic(IP) Local](https://github.com/sukramj/homematicip_local).
|
|
53
|
-
|
|
54
|
-
Follow the installation guide: https://github.com/sukramj/homematicip_local/wiki/Installation
|
|
55
|
-
|
|
56
|
-
## Requirements
|
|
57
|
-
|
|
58
|
-
Due to a bug in earlier CCU2/CCU3 firmware, aiohomematic requires at least the following versions when used with HomematicIP devices:
|
|
59
|
-
|
|
60
|
-
- CCU2: 2.53.27
|
|
61
|
-
- CCU3: 3.53.26
|
|
62
|
-
|
|
63
|
-
See details here: https://github.com/jens-maus/RaspberryMatic/issues/843. Other CCU‑like platforms using the buggy HmIPServer version are not supported.
|
|
64
|
-
|
|
65
|
-
## Useful links
|
|
66
|
-
|
|
67
|
-
- Examples: see example.py in this repository.
|
|
68
|
-
- Changelog: see changelog.md.
|
|
69
|
-
- Source code and documentation: this repository (docs/ directory may contain additional information).
|
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
aiohomematic/__init__.py,sha256=VoLXfPmEFWVOFseEusar-BcfKhQ8pBthrA7M6_QkWg8,1741
|
|
2
|
-
aiohomematic/async_support.py,sha256=8KzftPu9CHRpxxXU8ElExYYadN9P6rSkMvLK5Ci2Xlo,5476
|
|
3
|
-
aiohomematic/const.py,sha256=yNKhPNxDD4oSsv86RKaMqpkoh0pEaTAyYyAuB7PZq08,23474
|
|
4
|
-
aiohomematic/context.py,sha256=4CNoLd4PQ8MsLED_3D-Gcxo4h2UNlyQNd7QUE_0uvBA,253
|
|
5
|
-
aiohomematic/converter.py,sha256=eZ3iQPCfYZwqxQgUy4q6aMne_Bay-27f1HQuMRdabZ4,2922
|
|
6
|
-
aiohomematic/decorators.py,sha256=YD7zX9jBN-F-NdfKGNn0STqR6cndpoBCMuXaBvgvam4,7088
|
|
7
|
-
aiohomematic/exceptions.py,sha256=uMmbR-rWmCnseqmOPSHZ826YZ10uJrxG1c0w7VCYPZ0,4579
|
|
8
|
-
aiohomematic/hmcli.py,sha256=9oeXjCy50hkjMj7t1c9Cw0bz-LnXzjheKQBQDyGQQRk,4582
|
|
9
|
-
aiohomematic/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
10
|
-
aiohomematic/support.py,sha256=PgtFBHLVllnXS8AweQCNBiekL1__EgEAcGPjPNrqUi8,15741
|
|
11
|
-
aiohomematic/validator.py,sha256=Xxcmf2MzjIvzsDAfJsPR-cSN8S06sub-V3TCn6ronAs,1765
|
|
12
|
-
aiohomematic/caches/__init__.py,sha256=Uco9Y5fVmIPm_iRoLPWJnJNYfs9PY6VL-Jmj_3cT3yE,391
|
|
13
|
-
aiohomematic/caches/dynamic.py,sha256=rvqsLhImFy6J5a_ZJc705-_tDKyboZQNXNE2BlOrTGY,21460
|
|
14
|
-
aiohomematic/caches/persistent.py,sha256=pKWvzOoIB55iFtCD9RoufrxOPsorZU2QH5IcXlRujRY,19586
|
|
15
|
-
aiohomematic/caches/visibility.py,sha256=mEOLz3WMzDtBp6ghh9Y0Gg_DUJBSH1SyqyCivFgY5wM,29843
|
|
16
|
-
aiohomematic/central/__init__.py,sha256=DaEtE_0ODH5GO_HBJt1OzZ2fIDG8r1UhE8odPTTZo0k,84226
|
|
17
|
-
aiohomematic/central/decorators.py,sha256=Lgc9SzvugZ45h_1anPjBNgzTjQ8BgDHnquE1PD48-XY,4899
|
|
18
|
-
aiohomematic/central/xml_rpc_server.py,sha256=xwcb57ow7YEUS4By0HSBwzRSEY8kC9nZ-7hl4M-EWqI,9957
|
|
19
|
-
aiohomematic/client/__init__.py,sha256=n2rNU3L1Xr453xsTCTM2mh5N1alp0yftAIienziB6ak,69753
|
|
20
|
-
aiohomematic/client/json_rpc.py,sha256=HGgCXcp1uCfDkBdHlMNV8OD5O2PfWFRYNmiX5Pv1FO8,46463
|
|
21
|
-
aiohomematic/client/xml_rpc.py,sha256=pUFdJZBtirNyNNyHbeMDOEh2mFkxQf_zrvjd56n1Lv4,8161
|
|
22
|
-
aiohomematic/model/__init__.py,sha256=AbrppmY8X5rJkBV3c7Ggndk16Qvl-1S0uUWJqqxmXUE,5380
|
|
23
|
-
aiohomematic/model/data_point.py,sha256=zi9bKMlt2fxNiquyHpSKBm3e_WdET8_oRF9s5LfOB4A,39622
|
|
24
|
-
aiohomematic/model/decorators.py,sha256=sIxYsoyIE9aqbbrAnuFSvebLhNZC_DaMlEOBe6T_fRA,6718
|
|
25
|
-
aiohomematic/model/device.py,sha256=69seCnB4DzHHtXtGQ_wjNQ8AxJzMMmMQq88RqN8Py10,51812
|
|
26
|
-
aiohomematic/model/event.py,sha256=4dVuW3IBXkXcYhJUBtV8ax8dq4krtomA0wxbvXPuNCc,6935
|
|
27
|
-
aiohomematic/model/support.py,sha256=fXaGvD6ywaOmDihIAHjn-z3AuIn0Q3Wiq7EqcxUV6uc,19630
|
|
28
|
-
aiohomematic/model/update.py,sha256=r7Swejskx2Gg0F3zKaiZv5dBIuG49ZhvE3GlDG4PHB4,4880
|
|
29
|
-
aiohomematic/model/calculated/__init__.py,sha256=vvBAPphiZPnc-ZTIRJ0M4VsDPdxVqQWCA56p8AhAKIM,2731
|
|
30
|
-
aiohomematic/model/calculated/climate.py,sha256=yu3mFBAO6Cb_r68v197uXseOl9P1jz7Dz0tUaCY-6FE,8436
|
|
31
|
-
aiohomematic/model/calculated/data_point.py,sha256=-ZC10Iz5opXqs2nkiwerF3caMIMdWwS9fVwYYaagTE0,11268
|
|
32
|
-
aiohomematic/model/calculated/operating_voltage_level.py,sha256=F09jW2rFtjxrsR25xkN-uZxJAdw_dcDr8hv-xvTiBCs,13932
|
|
33
|
-
aiohomematic/model/calculated/support.py,sha256=ht_KSFUT2Dze9wjw_o0Gp2-PGo4on0W0CZujhCWzwIk,6019
|
|
34
|
-
aiohomematic/model/custom/__init__.py,sha256=6-jN7l6DPIUSCANw15SwNQFyL8aXxn8Me8m8fNHkWKc,5987
|
|
35
|
-
aiohomematic/model/custom/climate.py,sha256=Sd3KofB1G085bKK1JKB7k4uaySD3W4SKbw-Fg9FH0PU,53930
|
|
36
|
-
aiohomematic/model/custom/const.py,sha256=ifJgooQqo43qEqfPQTIcyY7IcUeFvM0-y4WvP-_HgXM,4882
|
|
37
|
-
aiohomematic/model/custom/cover.py,sha256=aU8sSdKnGuiPBAO73GtmOMcYLoU7VmFldBxDf601dII,27474
|
|
38
|
-
aiohomematic/model/custom/data_point.py,sha256=jpDpQlZs2iYeI4dms1kkhzAMa__f9Dacvf93E6ad5xs,13843
|
|
39
|
-
aiohomematic/model/custom/definition.py,sha256=VQ8dROZSAVu-CarYc2jN_KrlvGI1kjhwUqD0ZR1qTUA,35402
|
|
40
|
-
aiohomematic/model/custom/light.py,sha256=IGT98GlqRftNzZpFP8NR_aQG_EQHyr191O5xkcpVaz4,43843
|
|
41
|
-
aiohomematic/model/custom/lock.py,sha256=6_xOeUFfVRJh_BjTY6RVLaCVmIozQo-uUMrbDqASt8g,11858
|
|
42
|
-
aiohomematic/model/custom/siren.py,sha256=5WLiYfUE7vBNVDlV8Whjqh-7PVMiReW-CI5MDH25R0s,9573
|
|
43
|
-
aiohomematic/model/custom/support.py,sha256=Rn6ikcSE2Hcqv34k2h02osXW45poS0hO3GX_wtTpMyE,1374
|
|
44
|
-
aiohomematic/model/custom/switch.py,sha256=XIhlGvtkZaId4jNE1XtYpJfFuvFofzlAN6tUPHzLgTA,6790
|
|
45
|
-
aiohomematic/model/custom/valve.py,sha256=u1mv5-hllX89GVN5Ir_svJcJOGdcS8JNYu0NAZsthTc,4147
|
|
46
|
-
aiohomematic/model/generic/__init__.py,sha256=qYNbPuFlanpDsrw9GKbWAT48pcNaAYWKgERpkv91HzU,7534
|
|
47
|
-
aiohomematic/model/generic/action.py,sha256=NMbMbNX6JSQH56M4CkkYstx1nb1nYuLXtFjZR2wg2UU,915
|
|
48
|
-
aiohomematic/model/generic/binary_sensor.py,sha256=jHyvrkHyFuWdVOQiBWmD25HZqwk6tU6VKuWiZyrt2kU,805
|
|
49
|
-
aiohomematic/model/generic/button.py,sha256=-6W7dEGq4bXvdEtQTtSA-54PurHD6in8umBaUiUtqNA,663
|
|
50
|
-
aiohomematic/model/generic/data_point.py,sha256=QTzbjXSmOmDKrr7nFl1YrRk14gN07Iv7FbFp58Ih69I,5861
|
|
51
|
-
aiohomematic/model/generic/number.py,sha256=6JIFPNED5WjghT1o0hM-OObhUXX42t-Cv7jAhNy52rw,2522
|
|
52
|
-
aiohomematic/model/generic/select.py,sha256=-DUuavyD7-CicNZboA_kAV4kBN6w7mtoP_5Sn_6fNgA,1388
|
|
53
|
-
aiohomematic/model/generic/sensor.py,sha256=dMjI0RSKIl6xI1VnTPFJe5HCUdfOKtfAXHLtX0Hwoiw,2171
|
|
54
|
-
aiohomematic/model/generic/switch.py,sha256=bzJKvLmGN7yBoWSTZCjiXRnq2sBduKvRVGohBGrjKSE,1757
|
|
55
|
-
aiohomematic/model/generic/text.py,sha256=ig-ilSa6CFlf65Sopg-E5jC9rK0Ma1vs2nzBxdprIpQ,772
|
|
56
|
-
aiohomematic/model/hub/__init__.py,sha256=yTX2dLRMdVxyMMpbhDCf5ge6LisWWFUctWcusQsi3zE,13414
|
|
57
|
-
aiohomematic/model/hub/binary_sensor.py,sha256=MG75YRZAkLOCs8ZVj2kr-EFgUte4v6dV_C3vdqZ-4jU,670
|
|
58
|
-
aiohomematic/model/hub/button.py,sha256=3NWWQDjsQ4aIi3WGOVTWNi8Ry2shsvmqdgLNF6SvOGg,810
|
|
59
|
-
aiohomematic/model/hub/data_point.py,sha256=44AXesJ6X9YGpNPDyDwHf6Z0VjB3thdgm040gILxxUc,10427
|
|
60
|
-
aiohomematic/model/hub/number.py,sha256=auwUxR2J5rF_ZKSKSDo4XSiZUcXJ0uYUiCJO94_vmQM,1145
|
|
61
|
-
aiohomematic/model/hub/select.py,sha256=UTng9oNf7y-x-2wMnd7UL8rZ0goyH8GsfQhz8MJrw8o,1579
|
|
62
|
-
aiohomematic/model/hub/sensor.py,sha256=q_QWbkt2rycHeJJ5hlBGJJg0-Rfum8vrLA8BoZZyGq4,1110
|
|
63
|
-
aiohomematic/model/hub/switch.py,sha256=W5iGOgL4A8BWFw5_rEYcfxyRVCnXIYy5tYt5sbpShCg,1312
|
|
64
|
-
aiohomematic/model/hub/text.py,sha256=LGgFQNHgXreCIzMe3j21KFiOjliLv5a0xJrnUb1_P9k,908
|
|
65
|
-
aiohomematic/rega_scripts/fetch_all_device_data.fn,sha256=7uxhHoelAOsH6yYr1n1M1XwIRgDmItiHnWIMhDYEimk,4373
|
|
66
|
-
aiohomematic/rega_scripts/get_program_descriptions.fn,sha256=pGmj377MkqbZi6j-UBKQAsXTphwh1kDwDKqXij8zUBE,835
|
|
67
|
-
aiohomematic/rega_scripts/get_serial.fn,sha256=t1oeo-sB_EuVeiY24PLcxFSkdQVgEWGXzpemJQZFybY,1079
|
|
68
|
-
aiohomematic/rega_scripts/get_system_variable_descriptions.fn,sha256=UKXvC0_5lSApdQ2atJc0E5Stj5Zt3lqh0EcliokYu2c,849
|
|
69
|
-
aiohomematic/rega_scripts/set_program_state.fn,sha256=0bnv7lUj8FMjDZBz325tDVP61m04cHjVj4kIOnUUgpY,279
|
|
70
|
-
aiohomematic/rega_scripts/set_system_variable.fn,sha256=sTmr7vkPTPnPkor5cnLKlDvfsYRbGO1iq2z_2pMXq5E,383
|
|
71
|
-
aiohomematic-2025.8.8.dist-info/licenses/LICENSE,sha256=cKEF-xEwJKQt28HpA6ppSzyqUJ6QF9g5OLacWMCuz8s,1078
|
|
72
|
-
aiohomematic_support/__init__.py,sha256=_0YtF4lTdC_k6-zrM2IefI0u0LMr_WA61gXAyeGLgbY,66
|
|
73
|
-
aiohomematic_support/client_local.py,sha256=cvkO3tcxSJKy5ZLVdeqDbvSmeottxqZJNI4ccdxIVD4,12524
|
|
74
|
-
aiohomematic-2025.8.8.dist-info/METADATA,sha256=TQkyyLZdU99VVqdRjvJPZ7tTlzn5XWEyXFubunhgYrY,3249
|
|
75
|
-
aiohomematic-2025.8.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
76
|
-
aiohomematic-2025.8.8.dist-info/top_level.txt,sha256=5TDRlUWQPThIUwQjOj--aUo4UA-ow4m0sNhnoCBi5n8,34
|
|
77
|
-
aiohomematic-2025.8.8.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|