python-qube-heatpump 1.4.7__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.7 → python_qube_heatpump-1.4.9}/pyproject.toml

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

{python_qube_heatpump-1.4.7 → 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:
@@ -448,7 +452,9 @@ class QubeClient:
                     entity.address, int(write_value), device_id=self.unit
                 )
             else:
-                _LOGGER.warning("Unsupported data type for writing: %s", entity.data_type)
+                _LOGGER.warning(
+                    "Unsupported data type for writing: %s", entity.data_type
+                )
                 return False
 
             if result.isError():

{python_qube_heatpump-1.4.7 → 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.7 → 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.7 → python_qube_heatpump-1.4.9}/tests/test_client.py

@@ -24,13 +24,12 @@ async def test_read_value(mock_modbus_client):
     mock_instance.connected = True
 
     # Mock response for reading holding registers (FLOAT32)
-    # 24.5 = 0x41C40000 -> 16836 (0x41C4), 0 (0x0000) (Big Endian)
-    # Our decoder expects [0, 16836] for Little Endian Word Order?
-    # Logic in client.py: int_val = (regs[1] << 16) | regs[0]
-    # To get 0x41C40000: regs[1]=0x41C4, regs[0]=0x0000
+    # 24.5 = 0x41C40000 -> Big Endian word order (ABCD)
+    # Logic in client.py: int_val = (regs[0] << 16) | regs[1]
+    # regs[0]=0x41C4=16836 (MSW), regs[1]=0x0000=0 (LSW)
     mock_resp = MagicMock()
     mock_resp.isError.return_value = False
-    mock_resp.registers = [0, 16836]
+    mock_resp.registers = [16836, 0]
 
     mock_instance.read_holding_registers = AsyncMock(return_value=mock_resp)
     client._client = mock_instance
@@ -80,10 +79,11 @@ async def test_read_sensor(mock_modbus_client):
     mock_instance = mock_modbus_client.return_value
 
     # Mock response for temp_supply (FLOAT32) = 35.5°C
-    # 35.5 = 0x420E0000 -> regs[1]=0x420E=16910, regs[0]=0x0000
+    # 35.5 = 0x420E0000 -> Big Endian word order (ABCD)
+    # regs[0]=0x420E=16910 (MSW), regs[1]=0x0000=0 (LSW)
     mock_resp = MagicMock()
     mock_resp.isError.return_value = False
-    mock_resp.registers = [0, 16910]
+    mock_resp.registers = [16910, 0]
 
     mock_instance.read_input_registers = AsyncMock(return_value=mock_resp)
     client._client = mock_instance

python_qube_heatpump-1.4.7/PKG-INFO

@@ -1,27 +0,0 @@
-Metadata-Version: 2.4
-Name: python-qube-heatpump
-Version: 1.4.7
-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.7/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)