python-pooldose 0.7.0__tar.gz → 0.7.6__tar.gz

{python_pooldose-0.7.0 → python_pooldose-0.7.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-pooldose
-Version: 0.7.0
+Version: 0.7.6
 Summary: Unoffical async Python client for SEKO PoolDose devices
 Author-email: Lukas Maertin <pypi@lukas-maertin.de>
 License-Expression: MIT
@@ -19,10 +19,12 @@ Dynamic: license-file
 
 # python-pooldose
 
-Unofficial async Python client for [SEKO](https://www.seko.com/) Pooldosing systems. SEKO is a manufacturer of various monitoring and control devices for pools and spas.
+Unofficial async Python client for [SEKO](https://www.seko.com/) Pooldosing systems. SEKO is a manufacturer of various monitoring and control devices for pools and spas. Some devices from [VÁGNER POOL](https://www.vagnerpool.com/web/en/) are compatible as well.
 
 This client uses an undocumented local HTTP API. It provides live readings for pool sensors such as temperature, pH, ORP/Redox, as well as status information and control over the dosing logic.
 
+> **Disclaimer:** Use at your own risk. No liability for damages or malfunctions.
+
 ## Features
 
 - **Async/await support** for non-blocking operations
@@ -47,7 +49,7 @@ This client uses an undocumented local HTTP API. It provides live readings for p
    │   ├── WiFi Station Info (optional)
    │   ├── Access Point Info (optional)
    │   └── Network Info
-   └── Load Mapping JSON (based on MODEL_ID + FW_CODE)
+        └── Load mapping JSON (based on model_id + fw_code)
 
 2. Get Static Values
    └── Device information and configuration
@@ -251,8 +253,8 @@ The analyzer provides comprehensive information about your device:
 ```
 === DEVICE ANALYSIS ===
 Device: 01234567890A_DEVICE
-Model: PDPR1H1HAW***  
-Firmware: FW53****
+Model ID: PDZZ1H1HATEST1V1  
+Firmware Code: 654321
 
 === WIDGETS (Visible UI Elements) ===
 
@@ -296,8 +298,8 @@ pooldose --host 192.168.1.100 --analyze
 
 # Output shows:
 # Device: 01987654321B_DEVICE  
-# Model: PDPR2H2XYZ***        ← New model not yet supported
-# Firmware: FW54****          ← New firmware version
+# Model ID: PDZZ1H1HATEST1V1     ← New model not yet supported
+# Firmware Code: 654321            ← New firmware version
 # 
 # Widgets discovered: 15 sensors, 8 controls, 12 settings
 ```
@@ -307,7 +309,40 @@ With this information, you can:
 - Share the widget structure for mapping development
 - Help expand device support for the community
 
-The device analyzer makes python-pooldose extensible and helps build support for the growing ecosystem of SEKO PoolDose devices.
+The device analyzer makes python-pooldose extensible and helps build support for the growing ecosystem of SEKO PoolDose or VÁGNER POOL devices.
+
+### How to request support for a new device
+
+If your device is not yet supported, please help us by creating a GitHub issue and providing the following information:
+
+1. **Run low-level analysis and share the output files:**
+    - Use the following curl commands. 
+    - Replace the IP address and DeviceId (get the id from the header of the instantvalues.json file, e.g., '012345679_DEVICE') as needed:
+    
+    - Download debug config info:
+      ```bash
+      curl http://<YOUR_DEVICE_IP>/api/v1/debug/config/info -o debuginfo.json
+      ```
+      **Important:** Before uploading, open `debuginfo.json` and remove any WiFi credentials.
+    - Download instant values
+      ```bash
+      curl --location --request POST http://<YOUR_DEVICE_IP>/api/v1/DWI/getInstantValues -o instantvalues.json
+      ```
+    - Download device language strings
+      ```bash
+      curl --location http://<YOUR_DEVICE_IP>/api/v1/DWI/getDeviceLanguage --data-raw '{"DeviceId":"YOUR_DEVICE_ID","LANG":"en"}' -o strings.json
+      ```
+2. **Optional: Run the analyzer and share the output:**
+    - Run this command if you set up python-pooldose already:
+      ```bash
+      pooldose --host <YOUR_DEVICE_IP> --analyze
+      ```
+    - Copy and paste the full output into your issue (remove any sensitive data).
+
+3. **Create a GitHub issue:**
+    - Attach the the 3 JSON files from above.
+    - Optionally attach the analyzer output if available.
+    - This will help us add support for your device faster!
 
 ## Examples
 
@@ -393,8 +428,13 @@ You can use the mock client with custom JSON files via the command line:
 # Use mock client with JSON file
 pooldose --mock path/to/your/data.json
 
+
+# Use mock client with model and firmware code (Beispiel mit Fantasiewerten)
+pooldose --mock path/to/your/data.json --model-id PDZZ1H1HATEST1V1 --fw-code 654321
+
 # Or as Python module
 python -m pooldose --mock path/to/your/data.json
+python -m pooldose --mock path/to/your/data.json --model-id PDZZ1H1HATEST1V1 --fw-code 654321
 ```
 
 ### JSON Data Format
@@ -737,13 +777,13 @@ Mapping Discovery Process:
          │
          ▼
 ┌─────────────────┐
-│ Get MODEL_ID    │ ──────► PDPR1H1HAW***
-│ Get FW_CODE     │ ──────► 53****
+│ Get Model ID    │ ──────► PDZZ1H1HATEST1V1
+│ Get Firmware Code     │ ──────► 654321
 └─────────────────┘
          │
          ▼
 ┌─────────────────┐
-│ Load JSON File  │ ──────► model_PDPR1H1HAW***_FW53****.json
+│ Load JSON file  │ ──────► model_PDZZ1H1HATEST1V1_FW654321.json
 └─────────────────┘
          │
          ▼
@@ -862,10 +902,11 @@ The `instant_values_structured()` method returns data organized by type:
 
 This client has been tested with:
 
-- **SEKO PoolDose Double/Dual WiFi** (Model: PDPR1H1HAW***, FW: 53****)
-- **VA dos BASIC Chlor - pH/ORP Wi-Fi** (Model: PDPR1H1HAR***, FW: 53****)
+- **SEKO PoolDose Double** (Model: PDPR1H1HAW100, FW: 539187)
+- **VÁGNER POOL VA DOS BASIC** (Model: PDHC1H1HAR1V0, FW: 539224)
+- **VÁGNER POOL VA DOS EXACT** (Model: PDHC1H1HAR1V1, FW: 539224)
 
-Other SEKO PoolDose models may work but are untested. The client uses JSON mapping files to adapt to different device models and firmware versions (see e.g. `src/pooldose/mappings/model_PDPR1H1HAW***_FW53****.json`).
+Other SEKO or VÁGNER POOL models may work but are untested. The client uses JSON mapping files to adapt to different device models and firmware versions (see e.g. `src/pooldose/mappings/model_PDPR1H1HAW100_FW539187.json`).
 
 > **Note:** The JSON files in the mappings directory define the device-specific data keys and their human-readable names for different PoolDose models and firmware versions.
 
@@ -944,9 +985,6 @@ Data Classification:
 
 For detailed release notes and version history, please see [CHANGELOG.md](CHANGELOG.md).
 
-### Latest Release (0.7.0)
+### Latest Release (0.7.6)
 
-- **Connection Handling**: Improved session management for more reliable connections
-- **RequestHandler**: Centralized session management with internal _get_session method
-- **Performance**: Reduced connection overhead for multiple consecutive API calls
-- **Error Handling**: Better cleanup of HTTP sessions in error cases
+- Added `--print-payload` option for debugging HTTP payloads

{python_pooldose-0.7.0 → python_pooldose-0.7.6}/README.md

@@ -1,9 +1,11 @@
 # python-pooldose
 
-Unofficial async Python client for [SEKO](https://www.seko.com/) Pooldosing systems. SEKO is a manufacturer of various monitoring and control devices for pools and spas.
+Unofficial async Python client for [SEKO](https://www.seko.com/) Pooldosing systems. SEKO is a manufacturer of various monitoring and control devices for pools and spas. Some devices from [VÁGNER POOL](https://www.vagnerpool.com/web/en/) are compatible as well.
 
 This client uses an undocumented local HTTP API. It provides live readings for pool sensors such as temperature, pH, ORP/Redox, as well as status information and control over the dosing logic.
 
+> **Disclaimer:** Use at your own risk. No liability for damages or malfunctions.
+
 ## Features
 
 - **Async/await support** for non-blocking operations
@@ -28,7 +30,7 @@ This client uses an undocumented local HTTP API. It provides live readings for p
    │   ├── WiFi Station Info (optional)
    │   ├── Access Point Info (optional)
    │   └── Network Info
-   └── Load Mapping JSON (based on MODEL_ID + FW_CODE)
+        └── Load mapping JSON (based on model_id + fw_code)
 
 2. Get Static Values
    └── Device information and configuration
@@ -232,8 +234,8 @@ The analyzer provides comprehensive information about your device:
 ```
 === DEVICE ANALYSIS ===
 Device: 01234567890A_DEVICE
-Model: PDPR1H1HAW***  
-Firmware: FW53****
+Model ID: PDZZ1H1HATEST1V1  
+Firmware Code: 654321
 
 === WIDGETS (Visible UI Elements) ===
 
@@ -277,8 +279,8 @@ pooldose --host 192.168.1.100 --analyze
 
 # Output shows:
 # Device: 01987654321B_DEVICE  
-# Model: PDPR2H2XYZ***        ← New model not yet supported
-# Firmware: FW54****          ← New firmware version
+# Model ID: PDZZ1H1HATEST1V1     ← New model not yet supported
+# Firmware Code: 654321            ← New firmware version
 # 
 # Widgets discovered: 15 sensors, 8 controls, 12 settings
 ```
@@ -288,7 +290,40 @@ With this information, you can:
 - Share the widget structure for mapping development
 - Help expand device support for the community
 
-The device analyzer makes python-pooldose extensible and helps build support for the growing ecosystem of SEKO PoolDose devices.
+The device analyzer makes python-pooldose extensible and helps build support for the growing ecosystem of SEKO PoolDose or VÁGNER POOL devices.
+
+### How to request support for a new device
+
+If your device is not yet supported, please help us by creating a GitHub issue and providing the following information:
+
+1. **Run low-level analysis and share the output files:**
+    - Use the following curl commands. 
+    - Replace the IP address and DeviceId (get the id from the header of the instantvalues.json file, e.g., '012345679_DEVICE') as needed:
+    
+    - Download debug config info:
+      ```bash
+      curl http://<YOUR_DEVICE_IP>/api/v1/debug/config/info -o debuginfo.json
+      ```
+      **Important:** Before uploading, open `debuginfo.json` and remove any WiFi credentials.
+    - Download instant values
+      ```bash
+      curl --location --request POST http://<YOUR_DEVICE_IP>/api/v1/DWI/getInstantValues -o instantvalues.json
+      ```
+    - Download device language strings
+      ```bash
+      curl --location http://<YOUR_DEVICE_IP>/api/v1/DWI/getDeviceLanguage --data-raw '{"DeviceId":"YOUR_DEVICE_ID","LANG":"en"}' -o strings.json
+      ```
+2. **Optional: Run the analyzer and share the output:**
+    - Run this command if you set up python-pooldose already:
+      ```bash
+      pooldose --host <YOUR_DEVICE_IP> --analyze
+      ```
+    - Copy and paste the full output into your issue (remove any sensitive data).
+
+3. **Create a GitHub issue:**
+    - Attach the the 3 JSON files from above.
+    - Optionally attach the analyzer output if available.
+    - This will help us add support for your device faster!
 
 ## Examples
 
@@ -374,8 +409,13 @@ You can use the mock client with custom JSON files via the command line:
 # Use mock client with JSON file
 pooldose --mock path/to/your/data.json
 
+
+# Use mock client with model and firmware code (Beispiel mit Fantasiewerten)
+pooldose --mock path/to/your/data.json --model-id PDZZ1H1HATEST1V1 --fw-code 654321
+
 # Or as Python module
 python -m pooldose --mock path/to/your/data.json
+python -m pooldose --mock path/to/your/data.json --model-id PDZZ1H1HATEST1V1 --fw-code 654321
 ```
 
 ### JSON Data Format
@@ -718,13 +758,13 @@ Mapping Discovery Process:
          │
          ▼
 ┌─────────────────┐
-│ Get MODEL_ID    │ ──────► PDPR1H1HAW***
-│ Get FW_CODE     │ ──────► 53****
+│ Get Model ID    │ ──────► PDZZ1H1HATEST1V1
+│ Get Firmware Code     │ ──────► 654321
 └─────────────────┘
          │
          ▼
 ┌─────────────────┐
-│ Load JSON File  │ ──────► model_PDPR1H1HAW***_FW53****.json
+│ Load JSON file  │ ──────► model_PDZZ1H1HATEST1V1_FW654321.json
 └─────────────────┘
          │
          ▼
@@ -843,10 +883,11 @@ The `instant_values_structured()` method returns data organized by type:
 
 This client has been tested with:
 
-- **SEKO PoolDose Double/Dual WiFi** (Model: PDPR1H1HAW***, FW: 53****)
-- **VA dos BASIC Chlor - pH/ORP Wi-Fi** (Model: PDPR1H1HAR***, FW: 53****)
+- **SEKO PoolDose Double** (Model: PDPR1H1HAW100, FW: 539187)
+- **VÁGNER POOL VA DOS BASIC** (Model: PDHC1H1HAR1V0, FW: 539224)
+- **VÁGNER POOL VA DOS EXACT** (Model: PDHC1H1HAR1V1, FW: 539224)
 
-Other SEKO PoolDose models may work but are untested. The client uses JSON mapping files to adapt to different device models and firmware versions (see e.g. `src/pooldose/mappings/model_PDPR1H1HAW***_FW53****.json`).
+Other SEKO or VÁGNER POOL models may work but are untested. The client uses JSON mapping files to adapt to different device models and firmware versions (see e.g. `src/pooldose/mappings/model_PDPR1H1HAW100_FW539187.json`).
 
 > **Note:** The JSON files in the mappings directory define the device-specific data keys and their human-readable names for different PoolDose models and firmware versions.
 
@@ -925,9 +966,6 @@ Data Classification:
 
 For detailed release notes and version history, please see [CHANGELOG.md](CHANGELOG.md).
 
-### Latest Release (0.7.0)
+### Latest Release (0.7.6)
 
-- **Connection Handling**: Improved session management for more reliable connections
-- **RequestHandler**: Centralized session management with internal _get_session method
-- **Performance**: Reduced connection overhead for multiple consecutive API calls
-- **Error Handling**: Better cleanup of HTTP sessions in error cases
+- Added `--print-payload` option for debugging HTTP payloads

{python_pooldose-0.7.0 → python_pooldose-0.7.6}/src/pooldose/__init__.py

@@ -1,5 +1,5 @@
 """Async API client for SEKO Pooldose."""
 from .client import PooldoseClient
 
-__version__ = "0.7.0"
+__version__ = "0.7.6"
 __all__ = ["PooldoseClient"]

{python_pooldose-0.7.0 → python_pooldose-0.7.6}/src/pooldose/__main__.py

@@ -5,6 +5,7 @@ import argparse
 import asyncio
 import sys
 from pathlib import Path
+from typing import Optional
 
 from pooldose import __version__
 from pooldose.client import PooldoseClient, RequestStatus
@@ -12,7 +13,7 @@ from pooldose.device_analyzer import DeviceAnalyzer
 from pooldose.mock_client import MockPooldoseClient
 from pooldose.request_handler import RequestHandler
 
-# pylint: disable=line-too-long
+# pylint: disable=line-too-long, too-many-locals)
 
 # Import demo utilities if available
 try:
@@ -109,7 +110,7 @@ async def run_device_analyzer(host: str, use_ssl: bool, port: int, show_all: boo
         print(f"Error during analysis: {e}")
 
 
-async def run_real_client(host: str, use_ssl: bool, port: int) -> None:
+async def run_real_client(host: str, use_ssl: bool, port: int, print_payload: bool = False) -> None:
     """Run the real PooldoseClient."""
     print(f"Connecting to PoolDose device at {host}")
     if use_ssl:
@@ -117,12 +118,14 @@ async def run_real_client(host: str, use_ssl: bool, port: int) -> None:
     else:
         print(f"Using HTTP on port {port}")
 
+    # pylint: disable=no-value-for-parameter
     client = PooldoseClient(
         host=host,
         include_mac_lookup=True,
         use_ssl=use_ssl,
         port=port if port != 0 else None,
-        timeout=30
+        timeout=30,
+        debug_payload=print_payload
     )
 
     try:
@@ -152,7 +155,7 @@ async def run_real_client(host: str, use_ssl: bool, port: int) -> None:
         print(f"Error during connection: {e}")
 
 
-async def run_mock_client(json_file: str) -> None:
+async def run_mock_client(json_file: str, model_id: Optional[str] = None, fw_code: Optional[str] = None, print_payload: bool = False) -> None:
     """Run the MockPooldoseClient."""
     json_path = Path(json_file)
     if not json_path.exists():
@@ -161,9 +164,18 @@ async def run_mock_client(json_file: str) -> None:
 
     print(f"Loading mock data from: {json_file}")
 
+    # Create explicit arguments for MockPooldoseClient
+    json_file_path = json_path
+    include_sensitive_data = True
+    model_id_val = model_id if model_id is not None else "MOCK_MODEL"
+    fw_code_val = fw_code if fw_code is not None else "MOCK_FW"
+
     client = MockPooldoseClient(
-        json_file_path=json_path,
-        include_sensitive_data=True
+        json_file_path=json_file_path,
+        model_id=model_id_val,
+        fw_code=fw_code_val,
+        include_sensitive_data=include_sensitive_data,
+        inspect_payload=print_payload,
     )
 
     try:
@@ -193,8 +205,8 @@ async def run_mock_client(json_file: str) -> None:
         print(f"Error during mock demo: {e}")
 
 
-def main() -> None:
-    """Main entry point for command-line interface."""
+def main():  # pylint: disable=too-many-locals
+    """Main CLI function."""
     parser = argparse.ArgumentParser(
         description="Python PoolDose Client - Connect to SEKO PoolDose devices",
         epilog="""
@@ -213,6 +225,12 @@ Examples:
 
   # Use mock client with JSON file
   python -m pooldose --mock path/to/your/data.json
+
+  # Use mock client with payload inspection
+  python -m pooldose --mock path/to/your/data.json --print-payload
+
+  # Connect to real device with payload inspection
+  python -m pooldose --host 192.168.1.100 --print-payload
         """,
         formatter_class=argparse.RawDescriptionHelpFormatter
     )
@@ -231,6 +249,20 @@ Examples:
         help="Path to JSON file for mock mode"
     )
 
+    # Additional mock parameters
+    parser.add_argument(
+        "--model-id",
+        type=str,
+        default=None,
+        help="Optional: Model ID for mock client (overrides JSON)"
+    )
+    parser.add_argument(
+        "--fw-code",
+        type=str,
+        default=None,
+        help="Optional: Firmware code for mock client (overrides JSON)"
+    )
+
     # Connection options
     parser.add_argument(
         "--ssl",
@@ -253,6 +285,11 @@ Examples:
         action="store_true",
         help="Analyze unknown device including hidden widgets (implies --analyze)"
     )
+    parser.add_argument(
+        "--print-payload",
+        action="store_true",
+        help="Enable payload debugging logging (for development/debugging only)"
+    )
     parser.add_argument(
         "--version",
         action="version",
@@ -286,10 +323,15 @@ Examples:
                     args.host, args.ssl, port, show_all=args.analyze_all))
             else:
                 # Normal client mode
-                asyncio.run(run_real_client(args.host, args.ssl, port))
+                asyncio.run(run_real_client(args.host, args.ssl, port, args.print_payload))
         elif args.mock:
             # Mock mode
-            asyncio.run(run_mock_client(args.mock))
+            asyncio.run(run_mock_client(
+                args.mock,
+                model_id=args.model_id,
+                fw_code=args.fw_code,
+                print_payload=args.print_payload
+            ))
 
     except KeyboardInterrupt:
         print("\nOperation cancelled by user.")

{python_pooldose-0.7.0 → python_pooldose-0.7.6}/src/pooldose/client.py

@@ -4,16 +4,11 @@ from __future__ import annotations
 
 import asyncio
 import logging
-from typing import Optional, Tuple
+from typing import Optional, Tuple, Any, Dict
 
 import aiohttp
 from getmac import get_mac_address
 
-from pooldose.type_definitions import (
-    APIVersionResponse,
-    DeviceInfoDict,
-    StructuredValuesDict,
-)
 
 from pooldose.constants import get_default_device_info
 from pooldose.mappings.mapping_info import MappingInfo
@@ -34,7 +29,7 @@ class PooldoseClient:
     All getter methods return (status, data) and log errors.
     """
 
-    def __init__(self, host: str, timeout: int = 30, *, websession: Optional[aiohttp.ClientSession] = None, include_sensitive_data: bool = False, include_mac_lookup: bool = False, use_ssl: bool = False, port: Optional[int] = None, ssl_verify: bool = True) -> None:  # pylint: disable=too-many-arguments
+    def __init__(self, host: str, timeout: int = 30, *, websession: Optional[aiohttp.ClientSession] = None, include_sensitive_data: bool = False, include_mac_lookup: bool = False, use_ssl: bool = False, port: Optional[int] = None, ssl_verify: bool = True, debug_payload: bool = False) -> None:  # pylint: disable=too-many-arguments
         """
         Initialize the Pooldose client.
 
@@ -48,6 +43,7 @@ class PooldoseClient:
             use_ssl (bool): If True, use HTTPS instead of HTTP.
             port (Optional[int]): Custom port for connections. Defaults to 80 for HTTP, 443 for HTTPS.
             ssl_verify (bool): If True, verify SSL certificates. Only used when use_ssl=True.
+            debug_payload (bool): If True, log and store payloads sent to device for debugging.
         """
         self._host = host
         self._timeout = timeout
@@ -56,12 +52,13 @@ class PooldoseClient:
         self._use_ssl = use_ssl
         self._port = port
         self._ssl_verify = ssl_verify
+        self._debug_payload = debug_payload
         self._last_data = None
         self._websession = websession
         self._request_handler: RequestHandler | None = None
 
         # Initialize device info with default or placeholder values
-        self.device_info: DeviceInfoDict = get_default_device_info()
+        self.device_info: Dict[str, Any] = get_default_device_info()
 
         # Mapping-Status und Mapping-Cache
         self._mapping_status = None
@@ -81,7 +78,8 @@ class PooldoseClient:
             websession=self._websession if hasattr(self, '_websession') else None,
             use_ssl=self._use_ssl,
             port=self._port,
-            ssl_verify=self._ssl_verify
+            ssl_verify=self._ssl_verify,
+            debug_payload=self._debug_payload
         )
         status = await self._request_handler.connect()
         if status != RequestStatus.SUCCESS:
@@ -105,7 +103,7 @@ class PooldoseClient:
             raise RuntimeError("Client not connected. Call connect() first.")
         return self._request_handler
 
-    def check_apiversion_supported(self) -> Tuple[RequestStatus, APIVersionResponse]:
+    def check_apiversion_supported(self) -> Tuple[RequestStatus, Dict[str, Optional[str]]]:
         """
         Check if the loaded API version matches the supported version.
 
@@ -155,12 +153,16 @@ class PooldoseClient:
             self.device_info["SERIAL_NUMBER"] = gateway.get("DID")
             self.device_info["NAME"] = gateway.get("NAME")
             self.device_info["SW_VERSION"] = gateway.get("FW_REL")
-        if (device := debug_config.get("DEVICES")[0]) is not None:
-            self.device_info["DEVICE_ID"] = device.get("DID")
-            self.device_info["MODEL"] = device.get("NAME")
-            self.device_info["MODEL_ID"] = device.get("PRODUCT_CODE")
-            self.device_info["FW_VERSION"] = device.get("FW_REL")
-            self.device_info["FW_CODE"] = device.get("FW_CODE")
+
+        devices = debug_config.get("DEVICES")
+        if devices and len(devices) > 0:
+            device = devices[0]
+            if device is not None:
+                self.device_info["DEVICE_ID"] = device.get("DID")
+                self.device_info["MODEL"] = device.get("NAME")
+                self.device_info["MODEL_ID"] = device.get("PRODUCT_CODE")
+                self.device_info["FW_VERSION"] = device.get("FW_REL")
+                self.device_info["FW_CODE"] = device.get("FW_CODE")
         await asyncio.sleep(0.5)
 
         # Load mapping information
@@ -231,6 +233,7 @@ class PooldoseClient:
             tuple: (RequestStatus, StaticValues|None) - Status and static values object.
         """
         try:
+            # Device info is already Dict[str, Any]
             return RequestStatus.SUCCESS, StaticValues(self.device_info)
         except (ValueError, TypeError, KeyError) as err:
             _LOGGER.warning("Error creating StaticValues: %s", err)
@@ -258,13 +261,16 @@ class PooldoseClient:
             device_raw_data = raw_data.get("devicedata", {}).get(device_id, {})
             model_id = str(self.device_info.get("MODEL_ID", ""))
             fw_code = str(self.device_info.get("FW_CODE", ""))
+            if model_id == 'PDHC1H1HAR1V1' and fw_code == '539224':
+                #due to identifier issue in device firmware, use mapping prefix of PDPR1H1HAR1V0
+                model_id = 'PDPR1H1HAR1V0'
             prefix = f"{model_id}_FW{fw_code}_"
             return RequestStatus.SUCCESS, InstantValues(device_raw_data, mapping, prefix, device_id, self._request_handler)
         except (KeyError, TypeError, ValueError) as err:
             _LOGGER.warning("Error creating InstantValues: %s", err)
             return RequestStatus.UNKNOWN_ERROR, None
 
-    async def instant_values_structured(self) -> Tuple[RequestStatus, StructuredValuesDict]:
+    async def instant_values_structured(self) -> Tuple[RequestStatus, Dict[str, Any]]:
         """
         Get instant values in structured JSON format with types as top-level keys.
 
@@ -284,3 +290,35 @@ class PooldoseClient:
         except (KeyError, TypeError, ValueError) as err:
             _LOGGER.error("Error creating structured instant values: %s", err)
             return RequestStatus.UNKNOWN_ERROR, {}
+
+    # Convenience setters -------------------------------------------------
+    async def set_switch(self, key: str, value: bool) -> bool:
+        """Set a mapped switch value without manually fetching InstantValues.
+
+        This convenience wrapper fetches the current InstantValues and
+        delegates the operation to its typed setter. Returns True on success.
+        """
+        status, iv = await self.instant_values()
+        if status != RequestStatus.SUCCESS or iv is None:
+            return False
+        return await iv.set_switch(key, value)
+
+    async def set_number(self, key: str, value: Any) -> bool:
+        """Set a mapped numeric value without manually fetching InstantValues."""
+        status, iv = await self.instant_values()
+        if status != RequestStatus.SUCCESS or iv is None:
+            return False
+        return await iv.set_number(key, value)
+
+    async def set_select(self, key: str, value: Any) -> bool:
+        """Set a mapped select option without manually fetching InstantValues."""
+        status, iv = await self.instant_values()
+        if status != RequestStatus.SUCCESS or iv is None:
+            return False
+        return await iv.set_select(key, value)
+
+    def get_last_payload(self) -> Optional[str]:
+        """Get the last payload sent to the device (if debug_payload is enabled)."""
+        if self._request_handler:
+            return self._request_handler.get_last_payload()
+        return None