nwp500-python 7.3.2__tar.gz → 7.3.4__tar.gz

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/CHANGELOG.rst

@@ -2,6 +2,114 @@
 Changelog
 =========
 
+Version 7.3.4 (2026-01-27)
+==========================
+
+Fixed
+-----
+- **Temperature Delta Conversions**: Fixed incorrect Fahrenheit conversion for differential temperature settings (heat pump and heater element on/off thresholds)
+
+  - Created new ``DeciCelsiusDelta`` class for temperature deltas that apply scale factor (9/5) but NOT the +32 offset
+  - Heat pump and heater element differential settings now use ``DeciCelsiusDelta`` instead of ``DeciCelsius``
+  - ``hp_upper_on_diff_temp_setting``, ``hp_lower_on_diff_temp_setting``, ``he_upper_on_diff_temp_setting``, ``he_lower_on_diff_temp_setting``, and related off settings now convert correctly to Fahrenheit
+  - Example: A device value of 5 (representing 0.5°C delta) now correctly converts to 0.9°F delta instead of 32.9°F
+
+- **CLI Output**: Added display of heat pump and heater element differential temperature settings in device status output
+
+Changed
+-------
+- **Internal API**: Added ``div_10_celsius_delta_to_preferred`` converter for temperature delta values in device models
+
+
+Version 7.3.3 (2026-01-27)
+==========================
+
+Breaking Changes
+----------------
+- **Temperature Setpoint Limits**: Replaced hardcoded temperature limits with device-provided values
+
+  - ``set_dhw_temperature()`` now validates against device-specific ``dhw_temperature_min`` and ``dhw_temperature_max`` instead of hardcoded 95-150°F bounds
+  - ``build_reservation_entry()`` changed parameter name from ``temperature_f`` to ``temperature`` (unit-agnostic)
+  - Added optional ``temperature_min`` and ``temperature_max`` parameters to ``build_reservation_entry()`` for device-specific limit overrides
+  - Temperature parameters now accept values in the user's preferred unit (Celsius or Fahrenheit) based on global unit system context
+  - Fixes Home Assistant and other integrations that prefer Celsius unit display
+
+  **Migration guide:**
+
+  .. code-block:: python
+
+     # OLD (hardcoded 95-150°F)
+     await mqtt.control.set_dhw_temperature(device, temperature_f=140.0)
+     entry = build_reservation_entry(
+         enabled=True,
+         days=["Monday"],
+         hour=6,
+         minute=0,
+         mode_id=3,
+         temperature_f=140.0,
+     )
+
+     # NEW (device-provided limits, unit-aware)
+     # Temperature value automatically uses user's preferred unit
+     await mqtt.control.set_dhw_temperature(device, 140.0)
+     
+     # Device features provide min/max in user's preferred unit
+     features = await device_info_cache.get(device.device_info.mac_address)
+     entry = build_reservation_entry(
+         enabled=True,
+         days=["Monday"],
+         hour=6,
+         minute=0,
+         mode_id=3,
+         temperature=140.0,
+         temperature_min=features.dhw_temperature_min,
+         temperature_max=features.dhw_temperature_max,
+     )
+
+Added
+-----
+- **Reservation Temperature Conversion**: New ``reservation_param_to_preferred()`` utility function for unit-aware reservation display
+
+  - Converts device reservation parameters (half-degree Celsius) to user's preferred unit
+  - Respects global unit system context (metric/us_customary)
+  - Enables proper thermostat/reservation scheduling display in Home Assistant and other integrations
+  - Example usage:
+
+  .. code-block:: python
+
+     from nwp500 import reservation_param_to_preferred
+
+     # Display reservation temperature in user's preferred unit
+     param = 120  # Device raw value in half-Celsius
+     temp = reservation_param_to_preferred(param)
+     # Returns: 60.0 (Celsius) or 140.0 (Fahrenheit) based on unit context
+
+- **Unit-Aware Temperature Conversion**: New ``preferred_to_half_celsius()`` utility function
+
+  - Converts temperature from user's preferred unit to half-degree Celsius for device commands
+  - Respects global unit system context (metric/us_customary)
+  - Replaces misleading ``fahrenheit_to_half_celsius()`` in unit-agnostic code paths
+  - Used internally by ``set_dhw_temperature()`` and ``build_reservation_entry()``
+
+Changed
+-------
+- **Unit System Agnostic Display**: All logging and user-facing messages now respect global unit system context
+
+  - Temperature change logs dynamically show °C or °F based on user preference
+  - CLI monitoring and temperature setting messages use correct unit suffix
+  - Event listener documentation updated with unit-aware examples
+  - Reservation schedule examples now use ``reservation_param_to_preferred()`` for proper unit handling
+
+Fixed
+-----
+- **Critical: Temperature Unit Bug in Set Operations**: Fixed incorrect temperature conversion when setting DHW temperature and reservations
+
+  - ``set_dhw_temperature()`` was calling ``fahrenheit_to_half_celsius()`` with unit-agnostic temperature parameter
+  - ``build_reservation_entry()`` had the same issue
+  - **Impact**: If user preferred Celsius, temperature would be interpreted as Fahrenheit, causing wrong setpoints
+  - **Fix**: Use new ``preferred_to_half_celsius()`` that respects unit system context
+  - This was a critical data correctness bug that would cause incorrect device behavior for Celsius users
+
 Version 7.3.2 (2026-01-25)
 ==========================
 

{nwp500_python-7.3.2/src/nwp500_python.egg-info → nwp500_python-7.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 7.3.2
+Version: 7.3.4
 Summary: A library for controlling Navien NWP500 Water Heaters via NaviLink
 Home-page: https://github.com/eman/nwp500-python
 Author: Emmanuel Levijarvi

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/docs/api/nwp500.rst

@@ -149,6 +149,14 @@ nwp500.topic\_builder module
    :show-inheritance:
    :undoc-members:
 
+nwp500.unit\_system module
+--------------------------
+
+.. automodule:: nwp500.unit_system
+   :members:
+   :show-inheritance:
+   :undoc-members:
+
 nwp500.utils module
 -------------------
 

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/docs/guides/reservations.rst

@@ -44,14 +44,14 @@ Here's a simple example that sets up a weekday morning reservation:
            device = await api.get_first_device()
 
            # Build reservation entry
-           weekday_morning = NavienAPIClient.build_reservation_entry(
+           weekday_morning = build_reservation_entry(
                enabled=True,
                days=["Monday", "Tuesday", "Wednesday", "Thursday",
                      "Friday"],
                hour=6,
                minute=30,
                mode_id=4,  # High Demand
-               temperature_f=140.0  # Temperature in Fahrenheit
+               temperature=140.0  # Temperature in user's preferred unit
            )
 
            # Send to device
@@ -149,8 +149,8 @@ Field Descriptions
    (e.g., ``98`` for 120°F) for consistency.
 
    **Note:** When using ``build_reservation_entry()``, you don't need to
-   calculate the param value manually - just pass ``temperature_f`` in
-   Fahrenheit and the conversion is handled automatically.
+   calculate the param value manually - just pass ``temperature`` in
+   your user's preferred unit and the conversion is handled automatically.
 
 Helper Functions
 ================
@@ -161,33 +161,33 @@ Building Reservation Entries
 -----------------------------
 
 Use ``build_reservation_entry()`` to create properly formatted entries.
-The function accepts temperature in Fahrenheit and handles the conversion
+The function accepts temperature in your user's preferred unit and handles the conversion
 to the device's internal format automatically:
 
 .. code-block:: python
 
    from nwp500 import build_reservation_entry
 
-   # Weekday morning - High Demand mode at 140°F
+   # Weekday morning - High Demand mode at 140 (°F or °C based on unit preference)
    entry = build_reservation_entry(
        enabled=True,
        days=["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
        hour=6,
        minute=30,
        mode_id=4,  # High Demand
-       temperature_f=140.0  # Temperature in Fahrenheit
+       temperature=140.0  # Temperature in user's preferred unit
    )
    # Returns: {'enable': 1, 'week': 62, 'hour': 6, 'min': 30,
    #           'mode': 4, 'param': 120}
 
-   # Weekend - Energy Saver mode at 120°F
+   # Weekend - Energy Saver mode at 120 (°F or °C)
    entry2 = build_reservation_entry(
        enabled=True,
        days=["Saturday", "Sunday"],
        hour=8,
        minute=0,
        mode_id=3,  # Energy Saver
-       temperature_f=120.0
+       temperature=120.0
    )
 
    # You can also use day indices (0=Sunday, 6=Saturday)
@@ -197,7 +197,7 @@ to the device's internal format automatically:
        hour=18,
        minute=0,
        mode_id=1,  # Heat Pump Only
-       temperature_f=130.0
+       temperature=130.0
    )
 
 Temperature Conversion Utility
@@ -269,7 +269,7 @@ Send a new reservation schedule to the device:
 
            # Build multiple reservation entries
            reservations = [
-               # Weekday morning: High Demand at 140°F
+               # Weekday morning: High Demand at 140 (user's preferred unit)
                build_reservation_entry(
                    enabled=True,
                    days=["Monday", "Tuesday", "Wednesday", "Thursday",
@@ -277,9 +277,9 @@ Send a new reservation schedule to the device:
                    hour=6,
                    minute=30,
                    mode_id=4,
-                   temperature_f=140.0
+                   temperature=140.0
                ),
-               # Weekday evening: Energy Saver at 130°F
+               # Weekday evening: Energy Saver at 130 (user's preferred unit)
                build_reservation_entry(
                    enabled=True,
                    days=["Monday", "Tuesday", "Wednesday", "Thursday",
@@ -287,16 +287,16 @@ Send a new reservation schedule to the device:
                    hour=18,
                    minute=0,
                    mode_id=3,
-                   temperature_f=130.0
+                   temperature=130.0
                ),
-               # Weekend: Heat Pump Only at 120°F
+               # Weekend: Heat Pump Only at 120 (user's preferred unit)
                build_reservation_entry(
                    enabled=True,
                    days=["Saturday", "Sunday"],
                    hour=8,
                    minute=0,
                    mode_id=1,
-                   temperature_f=120.0
+                   temperature=120.0
                ),
            ]
 
@@ -439,7 +439,7 @@ Different settings for work days and weekends:
            hour=5,
            minute=30,
            mode_id=4,  # High Demand
-           temperature_f=140.0
+           temperature=140.0
        ),
        # Weekend morning: later start, energy saver
        build_reservation_entry(
@@ -448,7 +448,7 @@ Different settings for work days and weekends:
            hour=8,
            minute=0,
            mode_id=3,  # Energy Saver
-           temperature_f=130.0
+           temperature=130.0
        ),
    ]
 
@@ -467,7 +467,7 @@ Minimize energy use during peak hours:
            hour=6,
            minute=0,
            mode_id=4,
-           temperature_f=140.0
+           temperature=140.0
        ),
        # Day: 9:00 AM - Switch to Energy Saver
        build_reservation_entry(
@@ -476,7 +476,7 @@ Minimize energy use during peak hours:
            hour=9,
            minute=0,
            mode_id=3,
-           temperature_f=120.0
+           temperature=120.0
        ),
        # Evening: 5:00 PM - Heat Pump Only (before peak pricing)
        build_reservation_entry(
@@ -485,7 +485,7 @@ Minimize energy use during peak hours:
            hour=17,
            minute=0,
            mode_id=1,
-           temperature_f=130.0
+           temperature=130.0
        ),
        # Night: 10:00 PM - Back to Energy Saver
        build_reservation_entry(
@@ -494,7 +494,7 @@ Minimize energy use during peak hours:
            hour=22,
            minute=0,
            mode_id=3,
-           temperature_f=120.0
+           temperature=120.0
        ),
    ]
 
@@ -512,7 +512,7 @@ Automatically enable vacation mode during a trip:
        hour=20,
        minute=0,
        mode_id=5,  # Vacation Mode
-       temperature_f=120.0  # Temperature doesn't matter for vacation mode
+       temperature=120.0  # Temperature doesn't matter for vacation mode
    )
 
    # Return to normal operation when you get back
@@ -522,7 +522,7 @@ Automatically enable vacation mode during a trip:
        hour=14,
        minute=0,
        mode_id=3,  # Energy Saver
-       temperature_f=130.0
+       temperature=130.0
    )
 
    reservations = [start_vacation, end_vacation]
@@ -533,11 +533,12 @@ Important Notes
 Temperature Conversion
 -----------------------
 
-When using ``build_reservation_entry()``, pass temperatures in Fahrenheit
-using the ``temperature_f`` parameter. The function automatically converts
-to the device's internal format (half-degrees Celsius).
+When using ``build_reservation_entry()``, pass temperatures in your user's
+preferred unit (Celsius or Fahrenheit) using the ``temperature`` parameter.
+The function automatically converts to the device's internal format
+(half-degrees Celsius).
 
-The valid temperature range is 95°F to 150°F.
+The valid temperature range is 35°C to 65.5°C (95°F to 150°F).
 
 For reading reservation responses from the device, the ``param`` field
 contains the raw half-degrees Celsius value. Convert to Fahrenheit with:
@@ -619,7 +620,7 @@ Full working example with error handling and response monitoring:
                    hour=6,
                    minute=30,
                    mode_id=4,  # High Demand
-                   temperature_f=140.0
+                   temperature=140.0
                ),
                # Weekday day
                build_reservation_entry(
@@ -629,7 +630,7 @@ Full working example with error handling and response monitoring:
                    hour=9,
                    minute=0,
                    mode_id=3,  # Energy Saver
-                   temperature_f=120.0
+                   temperature=120.0
                ),
                # Weekend morning
                build_reservation_entry(
@@ -638,7 +639,7 @@ Full working example with error handling and response monitoring:
                    hour=8,
                    minute=0,
                    mode_id=3,  # Energy Saver
-                   temperature_f=130.0
+                   temperature=130.0
                ),
            ]
 

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/docs/protocol/data_conversions.rst

@@ -34,9 +34,17 @@ The device uses several encoding schemes to minimize transmission overhead:
    - Applied to decimal precision values
    - Formula: ``displayed_value = raw_value / 10.0``
    - Purpose: Preserve decimal precision in integer storage
-   - Common for flow rates and differential temperatures
+   - Common for flow rates
    - Example: Raw 125 → 12.5 GPM
 
+3.5. **Temperature Delta (Decicelsius)** (div_10_celsius_delta)
+   - Applied to differential temperature settings (heat pump and element hysteresis)
+   - Formula: ``displayed_value_celsius = raw_value / 10.0``, ``displayed_value_fahrenheit = (raw_value / 10.0) * 9/5`` (NO +32 offset)
+   - Purpose: Represents temperature DIFFERENCES/DELTAS, not absolute temperatures
+   - Key difference from absolute temperature conversion: No +32 offset applied when converting to Fahrenheit
+   - Example: Raw 5 → 0.5°C delta → 0.9°F delta (NOT 32.9°F)
+   - Used for: Heat pump on/off differential, heating element on/off differential
+
 4. **Boolean Encoding** (device_bool)
    - Applied to all status flags
    - Formula: ``displayed_value = (raw_value == 2)``
@@ -181,21 +189,21 @@ Electric heating elements are controlled via thermostat ranges. Two sensors (upp
      - °F
      - **Lower element OFF threshold**. Lower tank temp rises above this to deactivate lower element.
    * - ``heUpperOnDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Upper element differential** (ON-OFF difference). Hysteresis width to prevent rapid cycling. Typically 2-5°F.
+     - **Upper element differential** (ON-OFF hysteresis width). Temperature delta to prevent rapid cycling. Typically 2-5°F. This is a DELTA value, not an absolute temperature (0 delta = 0°F difference).
    * - ``heUpperOffDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Upper element differential** variation (advanced tuning). May vary based on mode.
+     - **Upper element OFF differential** (advanced tuning). May vary based on mode. DELTA value.
    * - ``heLowerOnDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Lower element differential** (ON-OFF difference).
+     - **Lower element differential** (ON-OFF hysteresis width). DELTA value.
    * - ``heLowerOffDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Lower element differential** variation.
+     - **Lower element OFF differential** variation. DELTA value.
    * - ``heatMinOpTemperature``
      - HalfCelsiusToF
      - °F
@@ -231,21 +239,21 @@ Heat pump stages are similarly controlled via thermostat ranges:
      - °F
      - **Lower heat pump OFF**. Lower tank rises above this to stop lower tank heat pump operation.
    * - ``hpUpperOnDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Heat pump upper differential** (ON-OFF hysteresis). Prevents rapid cycling.
+     - **Heat pump upper differential** (ON-OFF hysteresis). Temperature delta to prevent rapid cycling. DELTA value.
    * - ``hpUpperOffDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Heat pump upper differential** variation.
+     - **Heat pump upper OFF differential** variation. DELTA value.
    * - ``hpLowerOnDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Heat pump lower differential**.
+     - **Heat pump lower ON differential**. DELTA value.
    * - ``hpLowerOffDiffTempSetting``
-     - div_10
+     - div_10_celsius_delta
      - °F
-     - **Heat pump lower differential** variation.
+     - **Heat pump lower OFF differential** variation. DELTA value.
 
 Freeze Protection Temperatures
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/docs/protocol/mqtt_protocol.rst

@@ -422,7 +422,7 @@ DHW Temperature
    Temperature values are encoded in **half-degrees Celsius**. 
    Use formula: ``fahrenheit = (param / 2.0) * 9/5 + 32``
    For 140°F, send ``param=120`` (which is 60°C × 2).
-   Valid range: 95-150°F (70-150 raw value).
+   Valid range: Device-specific (see device features for ``dhw_temperature_min`` and ``dhw_temperature_max``).
 
 Anti-Legionella
 ---------------

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/docs/python_api/device_control.rst

@@ -220,7 +220,7 @@ Temperature Control
 set_dhw_temperature()
 ^^^^^^^^^^^^^^^^^^^^^
 
-.. py:method:: set_dhw_temperature(device, temperature_f)
+.. py:method:: set_dhw_temperature(device, temperature)
 
    Set DHW target temperature.
 
@@ -228,24 +228,25 @@ set_dhw_temperature()
 
    :param device: Device object
    :type device: Device
-   :param temperature_f: Target temperature in Fahrenheit (95-150°F)
-   :type temperature_f: float
+   :param temperature: Target temperature in user's preferred unit (Celsius or Fahrenheit)
+   :type temperature: float
    :return: Publish packet ID
    :rtype: int
-   :raises RangeValidationError: If temperature is outside 95-150°F range
+   :raises RangeValidationError: If temperature is outside valid range
    :raises DeviceCapabilityError: If device doesn't support temperature control
 
    The temperature is automatically converted to the device's internal format
-   (half-degrees Celsius).
+   (half-degrees Celsius). The valid range depends on the device's
+   temperature preference and configuration.
 
    **Example:**
 
    .. code-block:: python
 
-      # Set temperature to 140°F
+      # Set temperature (interpreted in device's preferred unit)
       await mqtt.control.set_dhw_temperature(device, 140.0)
       
-      # Common temperatures
+      # Common temperatures (device-dependent units)
       await mqtt.control.set_dhw_temperature(device, 120.0)  # Standard
       await mqtt.control.set_dhw_temperature(device, 130.0)  # Medium
       await mqtt.control.set_dhw_temperature(device, 140.0)  # Hot

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/docs/python_api/mqtt_client.rst

@@ -49,8 +49,9 @@ Basic Monitoring
            
            # Subscribe to status updates
            def on_status(status):
-               print(f"Water Temp: {status.dhw_temperature}°F")
-               print(f"Target: {status.dhw_temperature_setting}°F")
+               unit = status.get_field_unit('dhw_temperature')
+               print(f"Water Temp: {status.dhw_temperature}{unit}")
+               print(f"Target: {status.dhw_temperature_setting}{unit}")
                print(f"Power: {status.current_inst_power}W")
                print(f"Mode: {status.dhw_operation_setting.name}")
            
@@ -87,7 +88,7 @@ control method reference, capability checking, and advanced features.
            # Control operations (with automatic capability checking)
            await mqtt.control.set_power(device, power_on=True)
            await mqtt.control.set_dhw_mode(device, mode_id=3)  # Energy Saver
-           await mqtt.control.set_dhw_temperature(device, 140.0)
+           await mqtt.control.set_dhw_temperature(device, 140.0)  # Temperature in user's preferred unit
            
            await mqtt.disconnect()
 
@@ -442,29 +443,30 @@ set_dhw_mode()
 set_dhw_temperature()
 ^^^^^^^^^^^^^^^^^^^^^
 
-.. py:method:: set_dhw_temperature(device, temperature_f)
+.. py:method:: set_dhw_temperature(device, temperature)
 
    Set target DHW temperature.
 
    :param device: Device object
    :type device: Device
-   :param temperature_f: Temperature in Fahrenheit (95-150°F)
-   :type temperature_f: float
+   :param temperature: Temperature in user's preferred unit (Celsius or Fahrenheit)
+   :type temperature: float
    :return: Publish packet ID
    :rtype: int
-   :raises RangeValidationError: If temperature is outside 95-150°F range
+   :raises RangeValidationError: If temperature is outside valid range
 
    The temperature is automatically converted to the device's internal
-   format (half-degrees Celsius).
+   format (half-degrees Celsius). The actual valid range depends on the
+   device's temperature preference and configuration.
 
    **Example:**
 
    .. code-block:: python
 
-      # Set temperature to 140°F
+      # Set temperature (value interpreted in device's preferred unit)
       await mqtt.control.set_dhw_temperature(device, 140.0)
       
-      # Common temperatures
+      # Common temperatures (device-dependent units)
       await mqtt.control.set_dhw_temperature(device, 120.0)  # Standard
       await mqtt.control.set_dhw_temperature(device, 130.0)  # Medium
       await mqtt.control.set_dhw_temperature(device, 140.0)  # Hot

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/examples/advanced/combined_callbacks.py

@@ -86,9 +86,10 @@ async def main():
                 # Callback for status updates
                 def on_status(status: DeviceStatus):
                     counts["status"] += 1
+                    unit = status.get_field_unit("dhw_temperature")
                     print(f"\n📊 Status Update #{counts['status']}")
                     print(f"  Mode: {status.operation_mode.name}")
-                    print(f"  DHW Temp: {status.dhw_temperature:.1f}°F")
+                    print(f"  DHW Temp: {status.dhw_temperature:.1f}{unit}")
                     print(f"  DHW Charge: {status.dhw_charge_per:.1f}%")
                     print(f"  Compressor: {'On' if status.comp_use else 'Off'}")
 
@@ -98,8 +99,9 @@ async def main():
                     print(f"\n📋 Feature Info #{counts['feature']}")
                     print(f"  Serial: {feature.controller_serial_number}")
                     print(f"  FW Version: {feature.controller_sw_version}")
+                    unit_suffix = feature.get_field_unit("dhw_temperature_min")
                     print(
-                        f"  Temp Range: {feature.dhw_temperature_min}-{feature.dhw_temperature_max}°F"
+                        f"  Temp Range: {feature.dhw_temperature_min}-{feature.dhw_temperature_max}{unit_suffix}"
                     )
                     print(
                         f"  Heat Pump: {'Yes' if feature.heatpump_use == OnOffFlag.ON else 'No'}"

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/examples/advanced/demand_response.py

@@ -48,8 +48,9 @@ async def demand_response_example():
                 nonlocal current_status
                 current_status = status
                 logger.info(f"Current operation mode: {status.operation_mode.name}")
+                unit = status.get_field_unit("dhw_target_temperature_setting")
                 logger.info(
-                    f"Current DHW temperature setting: {status.dhw_target_temperature_setting}°F"
+                    f"Current DHW temperature setting: {status.dhw_target_temperature_setting}{unit}"
                 )
 
             await mqtt_client.subscribe_device_status(device, on_current_status)

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/examples/advanced/device_capabilities.py

@@ -138,13 +138,14 @@ async def main():
                     )
 
                     print("\nConfiguration:")
+                    unit_suffix = feature.get_field_unit("dhw_temperature_min")
                     print(f"  Temperature Unit:   {feature.temperature_type.name}")
                     print(f"  Temp Formula Type:  {feature.temp_formula_type}")
                     print(
-                        f"  DHW Temp Range:     {feature.dhw_temperature_min}°F - {feature.dhw_temperature_max}°F"
+                        f"  DHW Temp Range:     {feature.dhw_temperature_min}{unit_suffix} - {feature.dhw_temperature_max}{unit_suffix}"
                     )
                     print(
-                        f"  Freeze Prot Range:  {feature.freeze_protection_temp_min}°F - {feature.freeze_protection_temp_max}°F"
+                        f"  Freeze Prot Range:  {feature.freeze_protection_temp_min}{unit_suffix} - {feature.freeze_protection_temp_max}{unit_suffix}"
                     )
 
                     print("\nFeature Support:")

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/examples/advanced/device_status_debug.py

@@ -129,10 +129,11 @@ async def main():
                 def on_device_status(status: DeviceStatus):
                     """Parsed status callback."""
                     message_count["status"] += 1
+                    unit = status.get_field_unit("dhw_temperature")
                     print(
                         f"\n[SUCCESS] PARSED Status Update #{message_count['status']}"
                     )
-                    print(f"   DHW Temperature: {status.dhw_temperature:.1f}°F")
+                    print(f"   DHW Temperature: {status.dhw_temperature:.1f}{unit}")
                     print(f"   Operation Mode: {status.operation_mode.name}")
                     print(f"   Compressor: {status.comp_use}")
 

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/examples/advanced/power_control.py

@@ -48,7 +48,8 @@ async def power_control_example():
                 nonlocal current_status
                 current_status = status
                 logger.info(f"Current operation mode: {status.operation_mode.name}")
-                logger.info(f"Current DHW temperature: {status.dhw_temperature}°F")
+                unit = status.get_field_unit("dhw_temperature")
+                logger.info(f"Current DHW temperature: {status.dhw_temperature}{unit}")
 
             await mqtt_client.subscribe_device_status(device, on_current_status)
             await mqtt_client.control.request_device_status(device)

{nwp500_python-7.3.2 → nwp500_python-7.3.4}/examples/advanced/reconnection_demo.py

@@ -89,8 +89,9 @@ async def main():
         def on_status(status):
             nonlocal status_count
             status_count += 1
+            unit = status.get_field_unit("dhw_temperature")
             print(f"\n📊 Status update #{status_count}:")
-            print(f"   Temperature: {status.dhw_temperature}°F")
+            print(f"   Temperature: {status.dhw_temperature}{unit}")
             print(f"   Connected: {mqtt_client.is_connected}")
             if mqtt_client.is_reconnecting:
                 print(f"   Reconnecting: attempt {mqtt_client.reconnect_attempts}...")