nwp500-python 1.1.3__tar.gz → 1.1.5__tar.gz

{nwp500_python-1.1.3/src/nwp500_python.egg-info → nwp500_python-1.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 1.1.3
+Version: 1.1.5
 Summary: Add a short description here!
 Home-page: https://github.com/pyscaffold/pyscaffold/
 Author: Emmanuel Levijarvi

{nwp500_python-1.1.3 → nwp500_python-1.1.5}/docs/DEVICE_STATUS_FIELDS.rst

@@ -147,7 +147,7 @@ This document lists the fields found in the ``status`` object of device status m
      - integer
      - °F
      - Target superheat value - the desired temperature difference ensuring complete refrigerant vaporization.
-     - ``raw / 10.0``
+     - ``(raw / 10) * 9/5 + 32`` (decicelsius to Fahrenheit)
    * - ``compUse``
      - bool
      - None
@@ -428,6 +428,11 @@ This document lists the fields found in the ``status`` object of device status m
      - °F
      - Heater element lower off differential temperature setting.
      - ``raw / 10.0``
+   * - ``heatMinOpTemperature``
+     - float
+     - °F
+     - Minimum operating temperature for the heating element. This sets the lower threshold at which the heating element can operate.
+     - ``raw + 20``
    * - ``drOverrideStatus``
      - integer
      - None

{nwp500_python-1.1.3 → nwp500_python-1.1.5}/docs/ENERGY_MONITORING.rst

@@ -79,6 +79,45 @@ Total upper electric heater runtime in minutes -
 ``heater2RunningMinuteTotal`` (int): Total lower electric heater runtime
 in minutes
 
+Historical Energy Usage
+-----------------------
+
+Request detailed daily energy usage data for specific months:
+
+.. code:: python
+
+   from nwp500 import NavienMqttClient, EnergyUsageResponse
+   
+   def on_energy_usage(energy: EnergyUsageResponse):
+       print(f"Total Usage: {energy.total.total_usage} Wh")
+       print(f"Heat Pump: {energy.total.heat_pump_percentage:.1f}%")
+       print(f"Electric: {energy.total.heat_element_percentage:.1f}%")
+       
+       # Daily breakdown
+       for day in energy.daily:
+           print(f"Day {day.day}: {day.total_usage} Wh")
+   
+   # Subscribe to energy usage responses
+   await mqtt_client.subscribe_energy_usage(device, on_energy_usage)
+   
+   # Request energy usage for September 2025
+   await mqtt_client.request_energy_usage(device, year=2025, months=[9])
+   
+   # Request multiple months
+   await mqtt_client.request_energy_usage(device, year=2025, months=[7, 8, 9])
+
+**Key Methods:**
+
+- ``request_energy_usage(device, year, months)``: Request historical data
+- ``subscribe_energy_usage(device, callback)``: Subscribe to energy usage responses
+
+**Response Fields:**
+
+- ``total.total_usage`` (int): Total energy consumption in Wh
+- ``total.heat_pump_percentage`` (float): Percentage from heat pump
+- ``total.heat_element_percentage`` (float): Percentage from electric heaters
+- ``daily`` (list): Daily breakdown of usage per day
+
 Energy Capacity
 ---------------
 

nwp500_python-1.1.5/docs/FIRMWARE_TRACKING.rst

@@ -0,0 +1,146 @@
+
+Firmware Version Tracking
+=========================
+
+This document tracks firmware versions and the device status fields they introduce or modify.
+
+Purpose
+-------
+
+The Navien NWP500 water heater receives firmware updates that may introduce new status fields or modify existing behavior. This tracking system helps:
+
+1. **Graceful Degradation**: The library can handle unknown fields from newer firmware versions without crashing
+2. **User Reporting**: Users can report firmware versions when encountering new fields
+3. **Library Updates**: Maintainers can prioritize adding support for new fields based on firmware adoption
+4. **Documentation**: Track when fields were introduced for better device compatibility documentation
+
+How It Works
+------------
+
+When the library encounters unknown fields in device status messages:
+
+1. It checks if the field is documented in ``constants.KNOWN_FIRMWARE_FIELD_CHANGES``
+2. If the field is known but not implemented, it logs an INFO message
+3. If the field is completely unknown, it logs a WARNING message asking users to report their firmware version
+4. The unknown field is safely ignored, and the library continues to function
+
+Known Firmware Field Changes
+-----------------------------
+
+The following table tracks known fields that have been introduced in firmware updates:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 15 15 50
+
+   * - Field Name
+     - First Observed
+     - Conversion
+     - Description
+   * - ``heatMinOpTemperature``
+     - Controller: 184614912, WiFi: 34013184
+     - ``raw + 20``
+     - Minimum operating temperature for the heating element. Sets the lower threshold at which the heating element can operate.
+
+Reporting New Fields
+--------------------
+
+If you see a warning message about unknown fields, please help us improve the library by reporting:
+
+1. **The unknown field name(s)** from the warning message
+2. **Your device firmware versions**:
+   
+   - Controller SW Version (``controllerSwVersion``)
+   - Panel SW Version (``panelSwVersion``)
+   - WiFi SW Version (``wifiSwVersion``)
+
+3. **Sample raw values** for the unknown field (if possible)
+4. **Your device model** (e.g., NWP500)
+
+You can get your firmware versions by running:
+
+.. code-block:: python
+
+   from nwp500.mqtt_client import NavienMQTTClient
+   from nwp500.auth import NavienAuthClient
+   from nwp500.api_client import NavienAPIClient
+   import asyncio
+   import os
+
+   async def get_firmware():
+       async with NavienAuthClient(
+           os.getenv("NAVIEN_EMAIL"),
+           os.getenv("NAVIEN_PASSWORD")
+       ) as auth:
+           api = NavienAPIClient(auth)
+           devices = await api.get_devices()
+           device = devices[0]
+           
+           mqtt = NavienMQTTClient(auth, device.mac_address, device.device_type)
+           await mqtt.connect()
+           
+           def feature_callback(feature):
+               print(f"Controller SW: {feature.controllerSwVersion}")
+               print(f"Panel SW: {feature.panelSwVersion}")
+               print(f"WiFi SW: {feature.wifiSwVersion}")
+           
+           await mqtt.request_device_info(feature_callback)
+           await asyncio.sleep(2)
+           await mqtt.disconnect()
+
+   asyncio.run(get_firmware())
+
+Or using the CLI (if implemented):
+
+.. code-block:: bash
+
+   nwp-cli --device-info
+
+Please report issues at: https://github.com/eman/nwp500-python/issues
+
+Adding New Fields
+-----------------
+
+When adding support for a newly discovered field:
+
+1. Add the field to ``DeviceStatus`` dataclass in ``models.py``
+2. Add appropriate conversion logic in ``DeviceStatus.from_dict()``
+3. Document the field in ``DEVICE_STATUS_FIELDS.rst``
+4. Update ``constants.KNOWN_FIRMWARE_FIELD_CHANGES`` with field metadata
+5. Update this tracking document with firmware version information
+6. Remove the field from ``KNOWN_FIRMWARE_FIELD_CHANGES`` once implemented
+
+Example entry in ``constants.py``:
+
+.. code-block:: python
+
+   KNOWN_FIRMWARE_FIELD_CHANGES = {
+       "newFieldName": {
+           "introduced_in": "controller: 123, panel: 456, wifi: 789",
+           "description": "What this field represents",
+           "conversion": "raw + 20",  # or "raw / 10.0", "bool (1=OFF, 2=ON)", etc.
+       },
+   }
+
+Firmware Version History
+------------------------
+
+This section tracks observed firmware versions and their associated changes.
+
+**Latest Known Versions** (as of 2025-10-15):
+
+- Controller SW Version: 184614912
+- Panel SW Version: 0 (not used on NWP500 devices)
+- WiFi SW Version: 34013184
+
+**Observed Features:**
+
+- These versions include support for ``heatMinOpTemperature`` field
+- Recirculation pump fields (``recirc*``) are present but not yet documented
+
+*Note: This tracking system was implemented on 2025-10-15. Historical firmware information is not available.*
+
+Contributing
+------------
+
+If you have information about different firmware versions or field changes, please submit a pull request or open an issue. Your contributions help make this library more robust and compatible with different device configurations.

{nwp500_python-1.1.3 → nwp500_python-1.1.5}/docs/MQTT_CLIENT.rst

@@ -396,6 +396,41 @@ Publish a message to an MQTT topic.
 Device Command Methods
 ^^^^^^^^^^^^^^^^^^^^^^
 
+Complete MQTT API Reference
+''''''''''''''''''''''''''''
+
+This section provides a comprehensive reference of all available MQTT client methods for requesting data and controlling devices.
+
+**Request Methods & Corresponding Subscriptions**
+
++------------------------------------+---------------------------------------+----------------------------------------+
+| Request Method                     | Subscribe Method                      | Response Type                          |
++====================================+=======================================+========================================+
+| ``request_device_status()``        | ``subscribe_device_status()``         | ``DeviceStatus`` object                |
++------------------------------------+---------------------------------------+----------------------------------------+
+| ``request_device_info()``          | ``subscribe_device_feature()``        | ``DeviceFeature`` object               |
++------------------------------------+---------------------------------------+----------------------------------------+
+| ``request_energy_usage()``         | ``subscribe_energy_usage()``          | ``EnergyUsageResponse`` object         |
++------------------------------------+---------------------------------------+----------------------------------------+
+| ``set_power()``                    | ``subscribe_device_status()``         | Updated ``DeviceStatus``               |
++------------------------------------+---------------------------------------+----------------------------------------+
+| ``set_dhw_mode()``                 | ``subscribe_device_status()``         | Updated ``DeviceStatus``               |
++------------------------------------+---------------------------------------+----------------------------------------+
+| ``set_dhw_temperature()``          | ``subscribe_device_status()``         | Updated ``DeviceStatus``               |
++------------------------------------+---------------------------------------+----------------------------------------+
+| ``set_dhw_temperature_display()``  | ``subscribe_device_status()``         | Updated ``DeviceStatus``               |
++------------------------------------+---------------------------------------+----------------------------------------+
+
+**Generic Subscriptions**
+
++------------------------------------+---------------------------------------+----------------------------------------+
+| Method                             | Purpose                               | Response Type                          |
++====================================+=======================================+========================================+
+| ``subscribe_device()``             | Subscribe to all device messages      | Raw ``dict`` (all message types)       |
++------------------------------------+---------------------------------------+----------------------------------------+
+| ``subscribe()``                    | Subscribe to any MQTT topic           | Raw ``dict``                           |
++------------------------------------+---------------------------------------+----------------------------------------+
+
 request_device_status()
 '''''''''''''''''''''''
 
@@ -403,12 +438,26 @@ request_device_status()
 
    await mqtt_client.request_device_status(device: Device) -> int
 
-Request current device status.
+Request current device status including temperatures, operation mode, power consumption, and error codes.
 
 **Command:** ``16777219``
 
 **Topic:** ``cmd/{device_type}/navilink-{device_id}/st``
 
+**Response:** Subscribe with ``subscribe_device_status()`` to receive ``DeviceStatus`` objects
+
+**Example:**
+
+.. code:: python
+
+   def on_status(status: DeviceStatus):
+       print(f"Water Temp: {status.dhwTemperature}°F")
+       print(f"Mode: {status.operationMode}")
+       print(f"Power: {status.currentInstPower}W")
+   
+   await mqtt_client.subscribe_device_status(device, on_status)
+   await mqtt_client.request_device_status(device)
+
 request_device_info()
 '''''''''''''''''''''
 
@@ -416,12 +465,59 @@ request_device_info()
 
    await mqtt_client.request_device_info(device: Device) -> int
 
-Request device information.
+Request device information including firmware version, serial number, temperature limits, and capabilities.
 
 **Command:** ``16777217``
 
 **Topic:** ``cmd/{device_type}/navilink-{device_id}/st/did``
 
+**Response:** Subscribe with ``subscribe_device_feature()`` to receive ``DeviceFeature`` objects
+
+**Example:**
+
+.. code:: python
+
+   def on_feature(feature: DeviceFeature):
+       print(f"Firmware: {feature.controllerSwVersion}")
+       print(f"Serial: {feature.controllerSerialNumber}")
+       print(f"Temp Range: {feature.dhwTemperatureMin}-{feature.dhwTemperatureMax}°F")
+   
+   await mqtt_client.subscribe_device_feature(device, on_feature)
+   await mqtt_client.request_device_info(device)
+
+request_energy_usage()
+''''''''''''''''''''''
+
+.. code:: python
+
+   await mqtt_client.request_energy_usage(device: Device, year: int, months: list[int]) -> int
+
+Request historical daily energy usage data for specified month(s). Returns heat pump and electric heating element consumption with daily breakdown.
+
+**Command:** ``16777225``
+
+**Topic:** ``cmd/{device_type}/navilink-{device_id}/st/energy-usage-daily-query/rd``
+
+**Response:** Subscribe with ``subscribe_energy_usage()`` to receive ``EnergyUsageResponse`` objects
+
+**Parameters:**
+
+- ``year``: Year to query (e.g., 2025)
+- ``months``: List of months to query (1-12). Can request multiple months.
+
+**Example:**
+
+.. code:: python
+
+   def on_energy(energy: EnergyUsageResponse):
+       print(f"Total Usage: {energy.total.total_usage} Wh")
+       print(f"Heat Pump: {energy.total.heat_pump_percentage:.1f}%")
+       for day in energy.daily:
+           print(f"Day {day.day}: {day.total_usage} Wh")
+   
+   await mqtt_client.subscribe_energy_usage(device, on_energy)
+   await mqtt_client.request_energy_usage(device, year=2025, months=[9])
+
 set_power()
 '''''''''''
 
@@ -435,6 +531,8 @@ Turn device on or off.
 
 **Mode:** ``power-on`` or ``power-off``
 
+**Response:** Device status is updated; subscribe with ``subscribe_device_status()`` to see changes
+
 set_dhw_mode()
 ''''''''''''''
 
@@ -456,6 +554,8 @@ Set DHW (Domestic Hot Water) operation mode. This sets the ``dhwOperationSetting
 * ``4``: High Demand (faster recovery - Hybrid: Boost)
 * ``5``: Vacation (suspend heating for 0-99 days)
 
+**Response:** Device status is updated; subscribe with ``subscribe_device_status()`` to see changes
+
 **Important:** Setting the mode updates ``dhwOperationSetting`` but does not immediately change ``operationMode``. The ``operationMode`` field reflects the device's current operational state and changes automatically when the device starts/stops heating. See :doc:`DEVICE_STATUS_FIELDS` for details on the relationship between these fields.
 
 set_dhw_temperature()
@@ -465,13 +565,44 @@ set_dhw_temperature()
 
    await mqtt_client.set_dhw_temperature(device: Device, temperature: int) -> int
 
-Set DHW target temperature.
+Set DHW target temperature using the **MESSAGE value** (20°F lower than display).
 
 **Command:** ``33554433``
 
 **Mode:** ``dhw-temperature``
 
-**Parameters:** - ``temperature``: Target temperature in Fahrenheit
+**Parameters:** 
+
+- ``temperature``: Target temperature in Fahrenheit (message value, not display value)
+
+**Response:** Device status is updated; subscribe with ``subscribe_device_status()`` to see changes
+
+**Important:** The temperature in the message is 20°F lower than what displays on the device/app:
+
+- Message value 120°F → Display shows 140°F
+- Message value 130°F → Display shows 150°F
+
+set_dhw_temperature_display()
+''''''''''''''''''''''''''''''
+
+.. code:: python
+
+   await mqtt_client.set_dhw_temperature_display(device: Device, display_temperature: int) -> int
+
+Set DHW target temperature using the **DISPLAY value** (what you see on device/app). This is a convenience method that automatically converts display temperature to message value.
+
+**Parameters:**
+
+- ``display_temperature``: Target temperature as shown on display/app (Fahrenheit)
+
+**Response:** Device status is updated; subscribe with ``subscribe_device_status()`` to see changes
+
+**Example:**
+
+.. code:: python
+
+   # Set display temperature to 140°F (sends 120°F in message)
+   await mqtt_client.set_dhw_temperature_display(device, 140)
 
 signal_app_connection()
 '''''''''''''''''''''''
@@ -484,6 +615,85 @@ Signal that the app has connected.
 
 **Topic:** ``evt/{device_type}/navilink-{device_id}/app-connection``
 
+Subscription Methods
+''''''''''''''''''''
+
+subscribe_device_status()
+.........................
+
+.. code:: python
+
+   await mqtt_client.subscribe_device_status(
+       device: Device,
+       callback: Callable[[DeviceStatus], None]
+   ) -> int
+
+Subscribe to device status messages with automatic parsing into ``DeviceStatus`` objects. Use this after calling ``request_device_status()`` or any control commands to receive updates.
+
+**Emits Events:**
+
+- ``status_received``: Every status update (DeviceStatus)
+- ``temperature_changed``: Temperature changed (old_temp, new_temp)
+- ``mode_changed``: Operation mode changed (old_mode, new_mode)
+- ``power_changed``: Power consumption changed (old_power, new_power)
+- ``heating_started``: Device started heating (status)
+- ``heating_stopped``: Device stopped heating (status)
+- ``error_detected``: Error code detected (error_code, status)
+- ``error_cleared``: Error code cleared (error_code)
+
+subscribe_device_feature()
+..........................
+
+.. code:: python
+
+   await mqtt_client.subscribe_device_feature(
+       device: Device,
+       callback: Callable[[DeviceFeature], None]
+   ) -> int
+
+Subscribe to device feature/info messages with automatic parsing into ``DeviceFeature`` objects. Use this after calling ``request_device_info()`` to receive device capabilities and firmware info.
+
+**Emits Events:**
+
+- ``feature_received``: Feature/info received (DeviceFeature)
+
+subscribe_energy_usage()
+........................
+
+.. code:: python
+
+   await mqtt_client.subscribe_energy_usage(
+       device: Device,
+       callback: Callable[[EnergyUsageResponse], None]
+   ) -> int
+
+Subscribe to energy usage query responses with automatic parsing into ``EnergyUsageResponse`` objects. Use this after calling ``request_energy_usage()`` to receive historical energy data.
+
+subscribe_device()
+..................
+
+.. code:: python
+
+   await mqtt_client.subscribe_device(
+       device: Device,
+       callback: Callable[[str, dict], None]
+   ) -> int
+
+Subscribe to all messages from a device (no parsing). Receives all message types as raw dictionaries. Use the specific subscription methods above for automatic parsing.
+
+subscribe()
+...........
+
+.. code:: python
+
+   await mqtt_client.subscribe(
+       topic: str,
+       callback: Callable[[str, dict], None],
+       qos: mqtt.QoS = mqtt.QoS.AT_LEAST_ONCE
+   ) -> int
+
+Subscribe to any MQTT topic. Supports wildcards (``#``, ``+``). Receives raw dictionary messages.
+
 Periodic Request Methods (Optional)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

{nwp500_python-1.1.3 → nwp500_python-1.1.5}/docs/index.rst

@@ -325,6 +325,7 @@ Documentation
    Device Feature Fields <DEVICE_FEATURE_FIELDS>
    Error Codes <ERROR_CODES>
    MQTT Messages <MQTT_MESSAGES>
+   Firmware Tracking <FIRMWARE_TRACKING>
 
 .. toctree::
    :maxdepth: 2

nwp500_python-1.1.5/src/nwp500/constants.py

@@ -0,0 +1,31 @@
+"""
+This module defines constants for the Navien API.
+"""
+
+# MQTT Command Codes
+CMD_STATUS_REQUEST = 16777219
+CMD_DEVICE_INFO_REQUEST = 16777217
+CMD_POWER_ON = 33554434
+CMD_POWER_OFF = 33554433
+CMD_DHW_MODE = 33554437
+CMD_DHW_TEMPERATURE = 33554464
+CMD_ENERGY_USAGE_QUERY = 16777225
+
+# Known Firmware Versions and Field Changes
+# Track firmware versions where new fields were introduced to help with debugging
+KNOWN_FIRMWARE_FIELD_CHANGES = {
+    # Format: "field_name": {"introduced_in": "version", "description": "what it does"}
+    "heatMinOpTemperature": {
+        "introduced_in": "Controller: 184614912, WiFi: 34013184",
+        "description": "Minimum operating temperature for heating element",
+        "conversion": "raw + 20",
+    },
+}
+
+# Latest known firmware versions (as of 2025-10-15)
+# These versions have been observed with heatMinOpTemperature field
+LATEST_KNOWN_FIRMWARE = {
+    "controllerSwVersion": 184614912,  # Observed on NWP500 device
+    "panelSwVersion": 0,  # Panel SW version not used on this device
+    "wifiSwVersion": 34013184,  # Observed on NWP500 device
+}

{nwp500_python-1.1.3 → nwp500_python-1.1.5}/src/nwp500/models.py

@@ -10,6 +10,8 @@ from dataclasses import dataclass, field
 from enum import Enum
 from typing import Any, Optional, Union
 
+from . import constants
+
 _logger = logging.getLogger(__name__)
 
 
@@ -303,6 +305,7 @@ class DeviceStatus:
     heUpperOffDiffTempSetting: float
     heLowerOnDiffTempSetting: float
     heLowerOffDiffTempSetting: float
+    heatMinOpTemperature: float
     drOverrideStatus: int
     touOverrideStatus: int
     totalEnergyCapacity: float
@@ -317,6 +320,9 @@ class DeviceStatus:
         # Copy data to avoid modifying the original dictionary
         converted_data = data.copy()
 
+        # Get valid field names for this class
+        valid_fields = {f.name for f in cls.__dataclass_fields__.values()}
+
         # Handle key typo from documentation/API
         if "heLowerOnTDiffempSetting" in converted_data:
             converted_data["heLowerOnDiffTempSetting"] = converted_data.pop(
@@ -373,6 +379,7 @@ class DeviceStatus:
             "heUpperOffTempSetting",
             "heLowerOnTempSetting",
             "heLowerOffTempSetting",
+            "heatMinOpTemperature",
         ]
         for field_name in add_20_fields:
             if field_name in converted_data:
@@ -380,7 +387,6 @@ class DeviceStatus:
 
         # Convert fields with 'raw / 10.0' formula (non-temperature fields)
         div_10_fields = [
-            "targetSuperHeat",
             "currentInletTemperature",
             "currentDhwFlowRate",
             "hpUpperOnDiffTempSetting",
@@ -414,6 +420,7 @@ class DeviceStatus:
             "evaporatorTemperature",
             "ambientTemperature",
             "currentSuperHeat",
+            "targetSuperHeat",
         ]
         for field_name in heat_pump_temp_fields:
             if field_name in converted_data:
@@ -457,6 +464,34 @@ class DeviceStatus:
                 # Default to FAHRENHEIT for unknown temperature types
                 converted_data["temperatureType"] = TemperatureUnit.FAHRENHEIT
 
+        # Filter out any unknown fields not defined in the dataclass
+        # This handles new fields added by firmware updates gracefully
+        unknown_fields = set(converted_data.keys()) - valid_fields
+        if unknown_fields:
+            # Check if any unknown fields are documented in constants
+            known_firmware_fields = set(constants.KNOWN_FIRMWARE_FIELD_CHANGES.keys())
+            known_new_fields = unknown_fields & known_firmware_fields
+            truly_unknown = unknown_fields - known_firmware_fields
+
+            if known_new_fields:
+                _logger.info(
+                    "Ignoring known new fields from recent firmware: %s. "
+                    "These fields are documented but not yet implemented in DeviceStatus. "
+                    "Please report this with your firmware version to help us track field changes.",
+                    known_new_fields,
+                )
+
+            if truly_unknown:
+                _logger.warning(
+                    "Discovered new unknown fields from device status: %s. "
+                    "This may indicate a firmware update. Please report this issue with your "
+                    "device firmware version (controllerSwVersion, panelSwVersion, wifiSwVersion) "
+                    "so we can update the library. See constants.KNOWN_FIRMWARE_FIELD_CHANGES.",
+                    truly_unknown,
+                )
+
+            converted_data = {k: v for k, v in converted_data.items() if k in valid_fields}
+
         return cls(**converted_data)
 
 
@@ -518,6 +553,9 @@ class DeviceFeature:
         # Copy data to avoid modifying the original dictionary
         converted_data = data.copy()
 
+        # Get valid field names for this class
+        valid_fields = {f.name for f in cls.__dataclass_fields__.values()}
+
         # Convert temperature fields with 'raw + 20' formula (same as DeviceStatus)
         temp_add_20_fields = [
             "dhwTemperatureMin",
@@ -543,6 +581,16 @@ class DeviceFeature:
                 # Default to FAHRENHEIT for unknown temperature types
                 converted_data["temperatureType"] = TemperatureUnit.FAHRENHEIT
 
+        # Filter out any unknown fields (similar to DeviceStatus)
+        unknown_fields = set(converted_data.keys()) - valid_fields
+        if unknown_fields:
+            _logger.info(
+                "Ignoring unknown fields from device feature: %s. "
+                "This may indicate new device capabilities from a firmware update.",
+                unknown_fields,
+            )
+            converted_data = {k: v for k, v in converted_data.items() if k in valid_fields}
+
         return cls(**converted_data)
 
 

{nwp500_python-1.1.3 → nwp500_python-1.1.5/src/nwp500_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nwp500-python
-Version: 1.1.3
+Version: 1.1.5
 Summary: Add a short description here!
 Home-page: https://github.com/pyscaffold/pyscaffold/
 Author: Emmanuel Levijarvi

{nwp500_python-1.1.3 → nwp500_python-1.1.5}/src/nwp500_python.egg-info/SOURCES.txt

@@ -26,6 +26,7 @@ docs/DEVICE_STATUS_FIELDS.rst
 docs/ENERGY_MONITORING.rst
 docs/ERROR_CODES.rst
 docs/EVENT_EMITTER.rst
+docs/FIRMWARE_TRACKING.rst
 docs/MQTT_CLIENT.rst
 docs/MQTT_MESSAGES.rst
 docs/Makefile

nwp500_python-1.1.3/src/nwp500/constants.py

@@ -1,12 +0,0 @@
-"""
-This module defines constants for the Navien API.
-"""
-
-# MQTT Command Codes
-CMD_STATUS_REQUEST = 16777219
-CMD_DEVICE_INFO_REQUEST = 16777217
-CMD_POWER_ON = 33554434
-CMD_POWER_OFF = 33554433
-CMD_DHW_MODE = 33554437
-CMD_DHW_TEMPERATURE = 33554464
-CMD_ENERGY_USAGE_QUERY = 16777225