lifx-emulator 1.0.0__tar.gz → 1.0.2__tar.gz

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/.github/workflows/ci.yml

@@ -17,15 +17,15 @@ jobs:
     name: Code Quality
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -57,15 +57,15 @@ jobs:
         os: [ubuntu-latest, macos-latest]
         python-version: ['3.11', '3.12', '3.13', '3.14']
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ matrix.python-version }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ matrix.python-version }}
@@ -79,15 +79,15 @@ jobs:
 
     - name: Upload coverage to Codecov
       if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
-      uses: codecov/codecov-action@v5
+      uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
       with:
-        slug: Djelibeybi/lifx-async
+        slug: Djelibeybi/lifx-emulator
         token: ${{ secrets.CODECOV_TOKEN }}
         fail_ci_if_error: false
 
     - name: Upload test results to Codecov
       if: ${{ !cancelled() }}
-      uses: codecov/test-results-action@v1
+      uses: codecov/test-results-action@47f89e9acb64b76debcd5ea40642d25a4adced9f # v1
       with:
         fail_ci_if_error: false
         token: ${{ secrets.CODECOV_TOKEN }}
@@ -112,19 +112,19 @@ jobs:
 
     steps:
     - name: Checkout repository on release branch
-      uses: actions/checkout@v5
+      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       with:
         ref: ${{ github.head_ref || github.ref_name }}
         fetch-depth: 0
         ssh-key: ${{ secrets.DEPLOY_KEY }}
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -153,7 +153,7 @@ jobs:
         uv run --with python-semantic-release semantic-release version
 
     - name: Upload Distribution Artifacts
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
       with:
         name: distribution-artifacts
         path: dist
@@ -174,7 +174,7 @@ jobs:
 
     steps:
     - name: Download Build Artifacts
-      uses: actions/download-artifact@v6
+      uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
       id: artifact-download
       with:
         name: distribution-artifacts

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/.github/workflows/docs.yml

@@ -25,17 +25,17 @@ jobs:
   build-docs:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       with:
         fetch-depth: 0    # Fetch all history for git-revision-date-localized
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -49,7 +49,7 @@ jobs:
 
     - name: Upload docs artifact
       if: github.event_name == 'pull_request'
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
       with:
         name: docs
         path: site/
@@ -59,17 +59,17 @@ jobs:
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     needs: build-docs
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
       with:
         fetch-depth: 0
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}
@@ -89,15 +89,15 @@ jobs:
   validate-links:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
 
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
       with:
         python-version: ${{ env.PYTHON_VERSION }}
 
     - name: Install uv
-      uses: astral-sh/setup-uv@v7
+      uses: astral-sh/setup-uv@85856786d1ce8acfbcc2f13a5f3fbd6b938f9f41 # v7
       with:
         version: ${{ env.UV_VERSION }}
         python-version: ${{ env.PYTHON_VERSION }}

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/CLAUDE.md

@@ -553,6 +553,48 @@ All factory functions now use the specs system to load product-specific defaults
 - Tile dimensions (e.g., 8x8 for Tiles, 5x6 for Candles)
 - Users can override these defaults by passing explicit parameters
 
+### Product Registry
+
+**Product Registry** (`src/lifx_emulator/products/registry.py`):
+- Auto-generated from official LIFX products.json (https://github.com/LIFX/products)
+- Contains 137+ product definitions with capabilities, temperature ranges, and firmware requirements
+- Pre-built `ProductInfo` instances for efficient runtime lookups
+- Capability flags: `COLOR`, `INFRARED`, `MULTIZONE`, `CHAIN`, `MATRIX`, `RELAYS`, `BUTTONS`, `HEV`, `EXTENDED_MULTIZONE`
+- Never edit this file manually - regenerate using the generator
+
+**Product Registry Generator** (`src/lifx_emulator/products/generator.py`):
+- Downloads latest products.json from LIFX GitHub repository
+- Generates optimized Python code with pre-built product definitions
+- Handles extended multizone capability detection:
+  - **Native support**: Products with `extended_multizone: true` in features (no firmware requirement)
+    - Examples: LIFX Z US (PID 117), LIFX Beam US (PID 119), LIFX Neon, LIFX Permanent Outdoor
+  - **Firmware upgrade**: Products with `extended_multizone` in upgrades section (requires minimum firmware)
+    - Examples: LIFX Z (PID 32, requires firmware 2.77+), LIFX Beam (PID 38, requires firmware 2.77+)
+- Updates specs.yml with templates for new multizone/matrix products
+- Run with: `python -m lifx_emulator.products.generator`
+
+**Product Specs** (`src/lifx_emulator/products/specs.yml`):
+- Product-specific configuration not available in upstream products.json
+- Default zone counts, tile configurations, and device-specific defaults
+- Used by factory functions to create realistic device configurations
+- Manually maintained for accurate product specifications
+
+**ProductInfo API:**
+```python
+from lifx_emulator.products.registry import get_product
+
+product = get_product(117)  # LIFX Z US
+product.has_extended_multizone  # True
+product.min_ext_mz_firmware     # None (native support)
+product.supports_extended_multizone()  # True
+
+product = get_product(32)  # LIFX Z (older model)
+product.has_extended_multizone  # True
+product.min_ext_mz_firmware     # 131149 (firmware 2.77)
+product.supports_extended_multizone(131149)  # True (meets requirement)
+product.supports_extended_multizone(131148)  # False (below requirement)
+```
+
 ## Key Implementation Details
 
 ### MultiZone Handling

lifx_emulator-1.0.2/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: lifx-emulator
+Version: 1.0.2
+Summary: LIFX Emulator for testing LIFX LAN protocol libraries
+Author-email: Avi Miller <me@dje.li>
+Maintainer-email: Avi Miller <me@dje.li>
+License-Expression: UPL-1.0
+License-File: LICENSE
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: cyclopts>=4.2.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=14.2.0
+Requires-Dist: uvicorn>=0.34.0
+Description-Content-Type: text/markdown
+
+# LIFX Emulator
+
+> A comprehensive LIFX device emulator for testing LIFX LAN protocol libraries
+
+[![Codecov](https://codecov.io/gh/Djelibeybi/lifx-emulator/branch/main/graph/badge.svg)](https://codecov.io/gh/Djelibeybi/lifx-emulator)
+[![CI](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml/badge.svg)](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml)
+[![Docs](https://github.com/Djelibeybi/lifx-emulator/workflows/Documentation/badge.svg)](https://Djelibeybi.github.io/lifx-emulator/)
+
+[![GitHub](https://img.shields.io/github/v/release/Djelibeybi/lifx-emulator)](https://github.com/Djelibeybi/lifx-emulator/releases)
+[![PyPI](https://img.shields.io/pypi/v/lifx-emulator)](https://pypi.org/project/lifx-emulator/)
+[![License](https://img.shields.io/badge/License-UPL--1.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%20|%203.12%20|%203.13%20|%203.14-blue)](https://www.python.org)
+## Overview
+
+LIFX Emulator implements the complete binary UDP protocol from [lan.developer.lifx.com](https://lan.developer.lifx.com) by providing virtual LIFX devices for testing without physical hardware. The emulator includes a basic web interface and OpenAPI-compliant REST API for device and scenario management at runtime.
+
+## Features
+
+- **Complete Protocol Support**: 44+ packet types from the LIFX LAN protocol
+- **Multiple Device Types**: Color lights, infrared, HEV, multizone strips, matrix tiles
+- **REST API and Web Interface**:  Monitor and manage your virtual devices during testing
+- **Testing Scenarios**: Built-in support for packet loss, delays, malformed responses
+- **Easy Integration**: Simple Python API and comprehensive CLI
+
+
+## Documentation
+
+- **[Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)** - Get started
+- **[Quick Start](https://djelibeybi.github.io/lifx-emulator/getting-started/quickstart/)** - Your first emulated device
+- **[User Guide](https://djelibeybi.github.io/lifx-emulator/guide/overview/)** - Product specifications and testing scenarios
+- **[Advanced Topics](https://djelibeybi.github.io/lifx-emulator/advanced/device-management-api/)** - REST API and persistent storage
+- **[CLI Reference](https://djelibeybi.github.io/lifx-emulator/getting-started/cli/)** - All CLI options
+- **[Device Types](https://djelibeybi.github.io/lifx-emulator/guide/device-types/)** - Supported devices
+- **[API Reference](https://djelibeybi.github.io/lifx-emulator/api/)** - Complete API docs
+- **[Architecture](https://djelibeybi.github.io/lifx-emulator/architecture/overview/)** - How it works
+
+
+## Use Cases
+
+- **Library Testing**: Test your LIFX library without physical devices
+- **CI/CD Integration**: Run automated tests in pipelines
+- **Protocol Development**: Experiment with LIFX protocol features
+- **Error Simulation**: Test error handling with configurable scenarios
+- **Performance Testing**: Test concurrent device handling
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/Djelibeybi/lifx-emulator.git
+cd lifx-emulator
+
+# Install with uv (recommended)
+uv sync
+
+# Or with pip
+pip install -e ".[dev]"
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run ruff check .
+
+# Build docs
+uv run mkdocs serve
+```
+
+
+## License
+
+[UPL-1.0](LICENSE)
+
+## Links
+
+- **Documentation**: https://djelibeybi.github.io/lifx-emulator
+- **GitHub**: https://github.com/Djelibeybi/lifx-emulator
+- **PyPI**: https://pypi.org/project/lifx-emulator/
+- **LIFX Protocol**: https://lan.developer.lifx.com

lifx_emulator-1.0.2/README.md

@@ -0,0 +1,79 @@
+# LIFX Emulator
+
+> A comprehensive LIFX device emulator for testing LIFX LAN protocol libraries
+
+[![Codecov](https://codecov.io/gh/Djelibeybi/lifx-emulator/branch/main/graph/badge.svg)](https://codecov.io/gh/Djelibeybi/lifx-emulator)
+[![CI](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml/badge.svg)](https://github.com/Djelibeybi/lifx-emulator/actions/workflows/ci.yml)
+[![Docs](https://github.com/Djelibeybi/lifx-emulator/workflows/Documentation/badge.svg)](https://Djelibeybi.github.io/lifx-emulator/)
+
+[![GitHub](https://img.shields.io/github/v/release/Djelibeybi/lifx-emulator)](https://github.com/Djelibeybi/lifx-emulator/releases)
+[![PyPI](https://img.shields.io/pypi/v/lifx-emulator)](https://pypi.org/project/lifx-emulator/)
+[![License](https://img.shields.io/badge/License-UPL--1.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%20|%203.12%20|%203.13%20|%203.14-blue)](https://www.python.org)
+## Overview
+
+LIFX Emulator implements the complete binary UDP protocol from [lan.developer.lifx.com](https://lan.developer.lifx.com) by providing virtual LIFX devices for testing without physical hardware. The emulator includes a basic web interface and OpenAPI-compliant REST API for device and scenario management at runtime.
+
+## Features
+
+- **Complete Protocol Support**: 44+ packet types from the LIFX LAN protocol
+- **Multiple Device Types**: Color lights, infrared, HEV, multizone strips, matrix tiles
+- **REST API and Web Interface**:  Monitor and manage your virtual devices during testing
+- **Testing Scenarios**: Built-in support for packet loss, delays, malformed responses
+- **Easy Integration**: Simple Python API and comprehensive CLI
+
+
+## Documentation
+
+- **[Installation Guide](https://djelibeybi.github.io/lifx-emulator/getting-started/installation/)** - Get started
+- **[Quick Start](https://djelibeybi.github.io/lifx-emulator/getting-started/quickstart/)** - Your first emulated device
+- **[User Guide](https://djelibeybi.github.io/lifx-emulator/guide/overview/)** - Product specifications and testing scenarios
+- **[Advanced Topics](https://djelibeybi.github.io/lifx-emulator/advanced/device-management-api/)** - REST API and persistent storage
+- **[CLI Reference](https://djelibeybi.github.io/lifx-emulator/getting-started/cli/)** - All CLI options
+- **[Device Types](https://djelibeybi.github.io/lifx-emulator/guide/device-types/)** - Supported devices
+- **[API Reference](https://djelibeybi.github.io/lifx-emulator/api/)** - Complete API docs
+- **[Architecture](https://djelibeybi.github.io/lifx-emulator/architecture/overview/)** - How it works
+
+
+## Use Cases
+
+- **Library Testing**: Test your LIFX library without physical devices
+- **CI/CD Integration**: Run automated tests in pipelines
+- **Protocol Development**: Experiment with LIFX protocol features
+- **Error Simulation**: Test error handling with configurable scenarios
+- **Performance Testing**: Test concurrent device handling
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/Djelibeybi/lifx-emulator.git
+cd lifx-emulator
+
+# Install with uv (recommended)
+uv sync
+
+# Or with pip
+pip install -e ".[dev]"
+
+# Run tests
+uv run pytest
+
+# Run linter
+uv run ruff check .
+
+# Build docs
+uv run mkdocs serve
+```
+
+
+## License
+
+[UPL-1.0](LICENSE)
+
+## Links
+
+- **Documentation**: https://djelibeybi.github.io/lifx-emulator
+- **GitHub**: https://github.com/Djelibeybi/lifx-emulator
+- **PyPI**: https://pypi.org/project/lifx-emulator/
+- **LIFX Protocol**: https://lan.developer.lifx.com

lifx_emulator-1.0.2/docs/changelog.md

@@ -0,0 +1,28 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v1.0.2 (2025-11-10)
+
+### Bug Fixes
+
+- Extended_multizone added to products correctly by generator
+  ([`b6c4f78`](https://github.com/Djelibeybi/lifx-emulator/commit/b6c4f78c7353313b961acdb4283023a595141151))
+
+
+## v1.0.1 (2025-11-10)
+
+### Bug Fixes
+
+- Scenarios are now properly applied to initial devices
+  ([`4808512`](https://github.com/Djelibeybi/lifx-emulator/commit/480851231dbfe6c01b215e3938fa8067c9864227))
+
+### Documentation
+
+- Replace lifx-async with lifx-emulator and update README.md
+  ([`64ab6b6`](https://github.com/Djelibeybi/lifx-emulator/commit/64ab6b62dae6422774d8dc72f8f8020f0b6bb705))
+
+
+## v1.0.0 (2025-11-06)
+
+- Initial Release

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lifx-emulator"
-version = "1.0.0"
+version = "1.0.2"
 description = "LIFX Emulator for testing LIFX LAN protocol libraries"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -103,6 +103,14 @@ addopts = """\
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 
+[tool.coverage.run]
+omit = [
+    "src/lifx_emulator/protocol/generator.py",
+    "src/lifx_emulator/protocol/protocol_types.py",
+    "src/lifx_emulator/products/generator.py",
+    "src/lifx_emulator/products/registry.py",
+]
+
 [tool.coverage.report]
 exclude_lines = [
     "pragma: no cover",

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/renovate.json

@@ -156,6 +156,6 @@
   },
   "dependencyDashboard": true,
   "dependencyDashboardTitle": "Dependency Dashboard",
-  "dependencyDashboardHeader": "This dashboard shows all pending dependency updates for lifx-async.",
+  "dependencyDashboardHeader": "This dashboard shows all pending dependency updates for lifx-emulator.",
   "dependencyDashboardFooter": "Configure Renovate by editing `renovate.json`"
 }

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/src/lifx_emulator/__main__.py

@@ -102,10 +102,12 @@ def _format_product_capabilities(product: ProductInfo) -> str:
     # Add additional capabilities
     if product.has_infrared:
         caps.append("infrared")
-    if product.has_multizone:
-        caps.append("multizone")
+    # Extended multizone is backwards compatible with multizone,
+    # so only show multizone if extended multizone is not present
     if product.has_extended_multizone:
         caps.append("extended-multizone")
+    elif product.has_multizone:
+        caps.append("multizone")
     if product.has_matrix:
         caps.append("matrix")
     if product.has_hev:

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/src/lifx_emulator/api.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING
 
 from fastapi import FastAPI, HTTPException
 from fastapi.responses import HTMLResponse
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, field_validator
 
 if TYPE_CHECKING:
     from lifx_emulator.server import EmulatedLifxServer
@@ -133,6 +133,22 @@ class ScenarioConfigModel(BaseModel):
         False, description="Send unhandled message responses for unknown packet types"
     )
 
+    @field_validator("drop_packets", mode="before")
+    @classmethod
+    def convert_drop_packets_keys(cls, v):
+        """Convert string keys to integers for drop_packets."""
+        if isinstance(v, dict):
+            return {int(k): float(val) for k, val in v.items()}
+        return v
+
+    @field_validator("response_delays", mode="before")
+    @classmethod
+    def convert_response_delays_keys(cls, v):
+        """Convert string keys to integers for response_delays."""
+        if isinstance(v, dict):
+            return {int(k): float(val) for k, val in v.items()}
+        return v
+
 
 class ScenarioResponse(BaseModel):
     """Response model for scenario operations."""

{lifx_emulator-1.0.0 → lifx_emulator-1.0.2}/src/lifx_emulator/products/generator.py

@@ -97,16 +97,22 @@ def generate_product_definitions(
             if features.get("hev"):
                 capabilities.append("ProductCapability.HEV")
 
-            # Check for extended multizone in upgrades
+            # Check for extended multizone capability
             min_ext_mz_firmware = None
-            for upgrade in product.get("upgrades", []):
-                if upgrade.get("features", {}).get("extended_multizone"):
-                    capabilities.append("ProductCapability.EXTENDED_MULTIZONE")
-                    # Parse firmware version (major.minor format)
-                    major = upgrade.get("major", 0)
-                    minor = upgrade.get("minor", 0)
-                    min_ext_mz_firmware = (major << 16) | minor
-                    break
+
+            # First check if it's a native feature (no firmware requirement)
+            if features.get("extended_multizone"):
+                capabilities.append("ProductCapability.EXTENDED_MULTIZONE")
+            else:
+                # Check if it's available as an upgrade (requires minimum firmware)
+                for upgrade in product.get("upgrades", []):
+                    if upgrade.get("features", {}).get("extended_multizone"):
+                        capabilities.append("ProductCapability.EXTENDED_MULTIZONE")
+                        # Parse firmware version (major.minor format)
+                        major = upgrade.get("major", 0)
+                        minor = upgrade.get("minor", 0)
+                        min_ext_mz_firmware = (major << 16) | minor
+                        break
 
             # Build capabilities expression
             if capabilities:
@@ -357,16 +363,22 @@ class ProductRegistry:
                 if features.get("hev"):
                     capabilities |= ProductCapability.HEV
 
-                # Check for extended multizone in upgrades
+                # Check for extended multizone capability
                 min_ext_mz_firmware = None
-                for upgrade in product.get("upgrades", []):
-                    if upgrade.get("features", {}).get("extended_multizone"):
-                        capabilities |= ProductCapability.EXTENDED_MULTIZONE
-                        # Parse firmware version (major.minor format)
-                        major = upgrade.get("major", 0)
-                        minor = upgrade.get("minor", 0)
-                        min_ext_mz_firmware = (major << 16) | minor
-                        break
+
+                # First check if it's a native feature (no firmware requirement)
+                if features.get("extended_multizone"):
+                    capabilities |= ProductCapability.EXTENDED_MULTIZONE
+                else:
+                    # Check if it's available as an upgrade (requires minimum firmware)
+                    for upgrade in product.get("upgrades", []):
+                        if upgrade.get("features", {}).get("extended_multizone"):
+                            capabilities |= ProductCapability.EXTENDED_MULTIZONE
+                            # Parse firmware version (major.minor format)
+                            major = upgrade.get("major", 0)
+                            minor = upgrade.get("minor", 0)
+                            min_ext_mz_firmware = (major << 16) | minor
+                            break
 
                 # Parse temperature range
                 temp_range = None