python-qube-heatpump 1.4.8__tar.gz → 1.4.9__tar.gz

python_qube_heatpump-1.4.9/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: python-qube-heatpump
+Version: 1.4.9
+Summary: Async Modbus client for Qube Heat Pumps
+Project-URL: Homepage, https://github.com/MattieGit/python-qube-heatpump
+Project-URL: Bug Tracker, https://github.com/MattieGit/python-qube-heatpump/issues
+Author-email: MattieGit <6250046+MattieGit@users.noreply.github.com>
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.12
+Requires-Dist: pymodbus>=3.11.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-asyncio; extra == 'test'
+Requires-Dist: pytest-mock; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Python Qube Heat Pump Client
+
+Asyncio client for Qube heat pumps via Modbus TCP.
+
+## Installation
+
+```bash
+pip install python-qube-heatpump
+```
+
+## Usage
+
+```python
+import asyncio
+from python_qube_heatpump import QubeClient
+
+async def main():
+    client = QubeClient("192.168.1.100", port=502, unit_id=1)
+    await client.connect()
+
+    state = await client.read_state()
+    print(f"Outside temp: {state.temp_outside}°C")
+    print(f"Supply temp: {state.temp_supply}°C")
+    print(f"DHW temp: {state.temp_dhw}°C")
+
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Async Modbus TCP client** using pymodbus
+- **Entity definitions** for sensors, binary sensors, and switches
+- **FLOAT32 decoding** with big endian (ABCD) byte order
+- **Type-safe dataclasses** for entity definitions
+
+## Entity Definitions
+
+The library provides pre-defined entity definitions for all Qube Modbus registers:
+
+```python
+from python_qube_heatpump.entities import SENSORS, BINARY_SENSORS, SWITCHES
+
+# Access entity definitions by key
+temp_supply = SENSORS["temp_supply"]
+print(f"Address: {temp_supply.address}, Unit: {temp_supply.unit}")
+```
+
+## Vendor Documentation
+
+The official Modbus register documentation from HR-Energy is available at:
+- [docs/202506_modbus-lijst-qube.pdf](docs/202506_modbus-lijst-qube.pdf) (included in this repo)
+- [HR-Energy website](https://www.hr-energy.com/media/m4gavc0p/202506_modbus-lijst-qube.pdf)
+
+## Related Projects
+
+- [qube_heatpump](https://github.com/MattieGit/qube_heatpump) - Home Assistant HACS integration using this library
+
+## License
+
+MIT License

python_qube_heatpump-1.4.9/README.md

@@ -0,0 +1,62 @@
+# Python Qube Heat Pump Client
+
+Asyncio client for Qube heat pumps via Modbus TCP.
+
+## Installation
+
+```bash
+pip install python-qube-heatpump
+```
+
+## Usage
+
+```python
+import asyncio
+from python_qube_heatpump import QubeClient
+
+async def main():
+    client = QubeClient("192.168.1.100", port=502, unit_id=1)
+    await client.connect()
+
+    state = await client.read_state()
+    print(f"Outside temp: {state.temp_outside}°C")
+    print(f"Supply temp: {state.temp_supply}°C")
+    print(f"DHW temp: {state.temp_dhw}°C")
+
+    await client.disconnect()
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Async Modbus TCP client** using pymodbus
+- **Entity definitions** for sensors, binary sensors, and switches
+- **FLOAT32 decoding** with big endian (ABCD) byte order
+- **Type-safe dataclasses** for entity definitions
+
+## Entity Definitions
+
+The library provides pre-defined entity definitions for all Qube Modbus registers:
+
+```python
+from python_qube_heatpump.entities import SENSORS, BINARY_SENSORS, SWITCHES
+
+# Access entity definitions by key
+temp_supply = SENSORS["temp_supply"]
+print(f"Address: {temp_supply.address}, Unit: {temp_supply.unit}")
+```
+
+## Vendor Documentation
+
+The official Modbus register documentation from HR-Energy is available at:
+- [docs/202506_modbus-lijst-qube.pdf](docs/202506_modbus-lijst-qube.pdf) (included in this repo)
+- [HR-Energy website](https://www.hr-energy.com/media/m4gavc0p/202506_modbus-lijst-qube.pdf)
+
+## Related Projects
+
+- [qube_heatpump](https://github.com/MattieGit/qube_heatpump) - Home Assistant HACS integration using this library
+
+## License
+
+MIT License

{python_qube_heatpump-1.4.8 → python_qube_heatpump-1.4.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-qube-heatpump"
-version = "1.4.8"
+version = "1.4.9"
 authors = [
   { name="MattieGit", email="6250046+MattieGit@users.noreply.github.com" },
 ]

{python_qube_heatpump-1.4.8 → python_qube_heatpump-1.4.9}/src/python_qube_heatpump/client.py

@@ -281,6 +281,10 @@ class QubeClient:
             if entity.offset is not None:
                 val = val + entity.offset
 
+            # Apply precision rounding if specified
+            if entity.precision is not None and isinstance(val, float):
+                val = round(val, entity.precision)
+
             return val
 
         except Exception as e:

{python_qube_heatpump-1.4.8 → python_qube_heatpump-1.4.9}/src/python_qube_heatpump/entities/base.py

@@ -75,3 +75,7 @@ class EntityDef:
     # Write capability
     writable: bool = False
     """Whether this entity can be written to."""
+
+    # Value precision
+    precision: int | None = None
+    """Number of decimal places to round to. None for no rounding."""

{python_qube_heatpump-1.4.8 → python_qube_heatpump-1.4.9}/src/python_qube_heatpump/entities/sensors.py

@@ -244,6 +244,7 @@ _SENSOR_DEFS: tuple[EntityDef, ...] = (
         input_type=InputType.INPUT_REGISTER,
         data_type=DataType.FLOAT32,
         platform=Platform.SENSOR,
+        precision=1,
     ),
     EntityDef(
         key="power_thermic",

python_qube_heatpump-1.4.8/PKG-INFO

@@ -1,27 +0,0 @@
-Metadata-Version: 2.4
-Name: python-qube-heatpump
-Version: 1.4.8
-Summary: Async Modbus client for Qube Heat Pumps
-Project-URL: Homepage, https://github.com/MattieGit/python-qube-heatpump
-Project-URL: Bug Tracker, https://github.com/MattieGit/python-qube-heatpump/issues
-Author-email: MattieGit <6250046+MattieGit@users.noreply.github.com>
-License-File: LICENSE
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.12
-Requires-Dist: pymodbus>=3.11.0
-Provides-Extra: test
-Requires-Dist: pytest; extra == 'test'
-Requires-Dist: pytest-asyncio; extra == 'test'
-Requires-Dist: pytest-mock; extra == 'test'
-Description-Content-Type: text/markdown
-
-<<<<<<< HEAD
-# python-qube-heatpump
-Library for Qube heatpump connection
-=======
-# Python Qube Heat Pump Client
-
-Asyncio client for Qube heat pumps via Modbus TCP.
->>>>>>> 8c36d4a (Initial commit)

python_qube_heatpump-1.4.8/README.md

@@ -1,8 +0,0 @@
-<<<<<<< HEAD
-# python-qube-heatpump
-Library for Qube heatpump connection
-=======
-# Python Qube Heat Pump Client
-
-Asyncio client for Qube heat pumps via Modbus TCP.
->>>>>>> 8c36d4a (Initial commit)