Update firmware versions with live device data and add DeviceFeature unknown field handling

- Query live device to populate LATEST_KNOWN_FIRMWARE with actual versions:
  - Controller SW: 184614912
  - Panel SW: 0 (not used on NWP500)
  - WiFi SW: 34013184

- Add unknown field filtering to DeviceFeature.from_dict()
  - Prevents crashes when new feature fields appear (e.g., recirculationUse)
  - Consistent with DeviceStatus handling
  - Logs info message about ignored fields

- Update FIRMWARE_TRACKING.rst with observed versions and features
  - Document heatMinOpTemperature was observed with these versions
  - Note presence of recirc* fields for future implementation

All firmware data collected from live NWP500 device on 2025-10-15.

Author: eman

docs/FIRMWARE_TRACKING.rst

@@ -38,7 +38,7 @@ The following table tracks known fields that have been introduced in firmware up
      - Conversion
      - Description
    * - ``heatMinOpTemperature``
-     - Unknown version
+     - Controller: 184614912, WiFi: 34013184
      - ``raw + 20``
      - Minimum operating temperature for the heating element. Sets the lower threshold at which the heating element can operate.
 
@@ -125,13 +125,18 @@ Example entry in ``constants.py``:
 Firmware Version History
 ------------------------
 
-This section will be updated as we learn about firmware versions and their changes.
+This section tracks observed firmware versions and their associated changes.
 
-**Latest Known Versions** (as of last update):
+**Latest Known Versions** (as of 2025-10-15):
 
-- Controller SW Version: TBD
-- Panel SW Version: TBD  
-- WiFi SW Version: TBD
+- 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.*
 

src/nwp500/constants.py

@@ -16,15 +16,16 @@
 KNOWN_FIRMWARE_FIELD_CHANGES = {
     # Format: "field_name": {"introduced_in": "version", "description": "what it does"}
     "heatMinOpTemperature": {
-        "introduced_in": "unknown",  # First observed in production devices
+        "introduced_in": "Controller: 184614912, WiFi: 34013184",
         "description": "Minimum operating temperature for heating element",
         "conversion": "raw + 20",
     },
 }
 
-# Latest known firmware versions (update as new versions are discovered)
+# Latest known firmware versions (as of 2025-10-15)
+# These versions have been observed with heatMinOpTemperature field
 LATEST_KNOWN_FIRMWARE = {
-    "controllerSwVersion": None,  # Update when firmware version is observed
-    "panelSwVersion": None,
-    "wifiSwVersion": None,
+    "controllerSwVersion": 184614912,  # Observed on NWP500 device
+    "panelSwVersion": 0,  # Panel SW version not used on this device
+    "wifiSwVersion": 34013184,  # Observed on NWP500 device
 }

src/nwp500/models.py

@@ -553,6 +553,9 @@ def from_dict(cls, data: dict):
         # 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",
@@ -578,6 +581,16 @@ def from_dict(cls, data: dict):
                 # 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)