python-qube-heatpump 1.0.1__tar.gz → 1.2.0__tar.gz

python_qube_heatpump-1.2.0/.gitignore

@@ -0,0 +1,139 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDEs
+.idea/
+.vscode/

{python_qube_heatpump-1.0.1 → python_qube_heatpump-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-qube-heatpump
-Version: 1.0.1
+Version: 1.2.0
 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

python_qube_heatpump-1.2.0/client.py

@@ -0,0 +1,105 @@
+"""Client for Qube Heat Pump."""
+
+import logging
+from typing import Optional
+
+from pymodbus.client import AsyncModbusTcpClient
+from pymodbus.payload import BinaryPayloadDecoder
+from pymodbus.constants import Endian
+
+from . import const
+from .models import QubeState
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class QubeClient:
+    """Qube Modbus Client."""
+
+    def __init__(self, host: str, port: int = 502, unit_id: int = 1):
+        """Initialize."""
+        self.host = host
+        self.port = port
+        self.unit = unit_id
+        self._client = AsyncModbusTcpClient(host, port=port)
+        self._connected = False
+
+    async def connect(self) -> bool:
+        """Connect to the Modbus server."""
+        if not self._connected:
+            self._connected = await self._client.connect()
+        return self._connected
+
+    async def close(self) -> None:
+        """Close connection."""
+        self._client.close()
+        self._connected = False
+
+    async def get_all_data(self) -> QubeState:
+        """Fetch all definition data and return a state object."""
+        # Note: In a real implementation you might want to optimize this
+        # by reading contiguous blocks instead of one-by-one.
+        # For now, we wrap the individual reads for abstraction.
+
+        state = QubeState()
+
+        # Helper to read and assign
+        async def _read(const_def):
+            return await self.read_value(const_def)
+
+        # Fetch basic sensors
+        state.temp_supply = await _read(const.TEMP_SUPPLY)
+        state.temp_return = await _read(const.TEMP_RETURN)
+        state.temp_outside = await _read(const.TEMP_OUTSIDE)
+        state.temp_dhw = await _read(const.TEMP_DHW)
+
+        return state
+
+    async def read_value(self, definition: tuple) -> Optional[float]:
+        """Read a single value based on the constant definition."""
+        address, reg_type, data_type, scale, offset = definition
+
+        count = (
+            2
+            if data_type
+            in (const.DataType.FLOAT32, const.DataType.UINT32, const.DataType.INT32)
+            else 1
+        )
+
+        try:
+            if reg_type == const.ModbusType.INPUT:
+                result = await self._client.read_input_registers(
+                    address, count, slave=self.unit
+                )
+            else:
+                result = await self._client.read_holding_registers(
+                    address, count, slave=self.unit
+                )
+
+            if result.isError():
+                _LOGGER.warning("Error reading address %s", address)
+                return None
+
+            decoder = BinaryPayloadDecoder.fromRegisters(
+                result.registers, byteorder=Endian.Big, wordorder=Endian.Little
+            )
+
+            if data_type == const.DataType.FLOAT32:
+                val = decoder.decode_32bit_float()
+            elif data_type == const.DataType.INT16:
+                val = decoder.decode_16bit_int()
+            elif data_type == const.DataType.UINT16:
+                val = decoder.decode_16bit_uint()
+            else:
+                val = 0
+
+            if scale is not None:
+                val *= scale
+            if offset is not None:
+                val += offset
+
+            return val
+
+        except Exception as e:
+            _LOGGER.error("Exception reading address %s: %s", address, e)
+            return None

python_qube_heatpump-1.2.0/const.py

@@ -0,0 +1,71 @@
+"""Constants for Qube Heat Pump."""
+
+from enum import Enum
+
+
+class ModbusType(str, Enum):
+    """Modbus register type."""
+
+    HOLDING = "holding"
+    INPUT = "input"
+
+
+class DataType(str, Enum):
+    """Data type."""
+
+    FLOAT32 = "float32"
+    INT16 = "int16"
+    UINT16 = "uint16"
+
+
+# Register definitions (Address, Type, Data Type, Scale, Offset)
+# Scale/Offset are None if not used.
+# Format: KEY = (Address, ModbusType, DataType, Scale, Offset)
+
+# --- Sensors (Input Registers) ---
+PCT_USER_PUMP = (4, ModbusType.INPUT, DataType.FLOAT32, -1, 100)
+PCT_SOURCE_PUMP = (6, ModbusType.INPUT, DataType.FLOAT32, -1, 100)
+PCT_SOURCE_VALVE = (8, ModbusType.INPUT, DataType.FLOAT32, None, None)
+REQ_DHW = (14, ModbusType.INPUT, DataType.FLOAT32, None, None)
+REQ_COMPRESSOR = (16, ModbusType.INPUT, DataType.FLOAT32, None, None)
+FLOW_RATE = (18, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_SUPPLY = (20, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_RETURN = (22, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_SOURCE_IN = (24, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_SOURCE_OUT = (26, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_ROOM = (28, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_DHW = (30, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_OUTSIDE = (32, ModbusType.INPUT, DataType.FLOAT32, None, None)
+COP_CALC = (34, ModbusType.INPUT, DataType.FLOAT32, None, None)
+POWER_THERMIC = (36, ModbusType.INPUT, DataType.FLOAT32, None, None)
+STATUS_CODE = (38, ModbusType.INPUT, DataType.UINT16, None, None)
+TEMP_REG_SETPOINT = (39, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_COOL_SETPOINT = (41, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_HEAT_SETPOINT = (43, ModbusType.INPUT, DataType.FLOAT32, None, None)
+COMPRESSOR_SPEED = (45, ModbusType.INPUT, DataType.FLOAT32, 60, None)  # RPM
+TEMP_DHW_SETPOINT = (47, ModbusType.INPUT, DataType.FLOAT32, None, None)
+HOURS_DHW = (50, ModbusType.INPUT, DataType.INT16, None, None)
+HOURS_HEAT = (52, ModbusType.INPUT, DataType.INT16, None, None)
+HOURS_COOL = (54, ModbusType.INPUT, DataType.INT16, None, None)
+HOURS_HEATER_1 = (56, ModbusType.INPUT, DataType.INT16, None, None)
+HOURS_HEATER_2 = (58, ModbusType.INPUT, DataType.INT16, None, None)
+HOURS_HEATER_3 = (60, ModbusType.INPUT, DataType.INT16, None, None)
+POWER_ELECTRIC_CALC = (61, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_PLANT_SETPOINT = (65, ModbusType.INPUT, DataType.FLOAT32, None, None)
+ENERGY_ELECTRIC_TOTAL = (69, ModbusType.INPUT, DataType.FLOAT32, None, None)
+ENERGY_THERMIC_TOTAL = (71, ModbusType.INPUT, DataType.FLOAT32, None, None)
+TEMP_ROOM_MODBUS = (75, ModbusType.INPUT, DataType.FLOAT32, None, None)
+
+# --- Configuration (Holding Registers) ---
+SETPOINT_HEAT_DAY = (27, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+SETPOINT_HEAT_NIGHT = (29, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+SETPOINT_COOL_DAY = (31, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+SETPOINT_COOL_NIGHT = (33, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+DT_DHW = (43, ModbusType.HOLDING, DataType.INT16, None, None)
+MIN_TEMP_DHW = (44, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+TEMP_DHW_PROG = (46, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+MIN_SETPOINT_BUFFER = (99, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+USER_HEAT_SETPOINT = (101, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+USER_COOL_SETPOINT = (103, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+MAX_SETPOINT_BUFFER = (169, ModbusType.HOLDING, DataType.FLOAT32, None, None)
+USER_DHW_SETPOINT = (173, ModbusType.HOLDING, DataType.FLOAT32, None, None)

python_qube_heatpump-1.2.0/models.py

@@ -0,0 +1,37 @@
+"""Models for Qube Heat Pump."""
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class QubeState:
+    """Representation of the Qube Heat Pump state."""
+
+    # Temperatures
+    temp_supply: Optional[float] = None
+    temp_return: Optional[float] = None
+    temp_source_in: Optional[float] = None
+    temp_source_out: Optional[float] = None
+    temp_room: Optional[float] = None
+    temp_dhw: Optional[float] = None
+    temp_outside: Optional[float] = None
+
+    # Power/Energy
+    power_thermic: Optional[float] = None
+    power_electric: Optional[float] = None
+    energy_total_electric: Optional[float] = None
+    energy_total_thermic: Optional[float] = None
+    cop_calc: Optional[float] = None
+
+    # Operation
+    status_code: Optional[int] = None
+    compressor_speed: Optional[float] = None
+    flow_rate: Optional[float] = None
+
+    # Setpoints (Read/Write)
+    setpoint_room_heat_day: Optional[float] = None
+    setpoint_room_heat_night: Optional[float] = None
+    setpoint_room_cool_day: Optional[float] = None
+    setpoint_room_cool_night: Optional[float] = None
+    setpoint_dhw: Optional[float] = None

{python_qube_heatpump-1.0.1 → python_qube_heatpump-1.2.0}/pyproject.toml

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