pylxpweb 0.1.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

pylxpweb/constants/locations.py

@@ -0,0 +1,227 @@
+"""Constants and mappings for Luxpower/EG4 API.
+
+This module contains mapping tables extracted from the EG4 web interface
+to convert between human-readable API values and the enum values required
+for configuration updates.
+
+These mappings were discovered by analyzing the HTML form at:
+/WManage/web/config/plant/edit/{plant_id}
+"""
+
+from __future__ import annotations
+
+# Timezone mappings: Human-readable (from API) → Form enum (for POST)
+# Source: Analyzed all 28 timezone options from the HTML form
+TIMEZONE_MAP: dict[str, str] = {
+    "GMT -12": "WEST12",
+    "GMT -11": "WEST11",
+    "GMT -10": "WEST10",
+    "GMT -9": "WEST9",
+    "GMT -8": "WEST8",
+    "GMT -7": "WEST7",
+    "GMT -6": "WEST6",
+    "GMT -5": "WEST5",
+    "GMT -4": "WEST4",
+    "GMT -3": "WEST3",
+    "GMT -2": "WEST2",
+    "GMT -1": "WEST1",
+    "GMT 0": "ZERO",
+    "GMT +1": "EAST1",
+    "GMT +2": "EAST2",
+    "GMT +3": "EAST3",
+    "GMT +3:30": "EAST3_30",
+    "GMT +4": "EAST4",
+    "GMT +5": "EAST5",
+    "GMT +5:30": "EAST5_30",
+    "GMT +6": "EAST6",
+    "GMT +6:30": "EAST6_30",
+    "GMT +7": "EAST7",
+    "GMT +8": "EAST8",
+    "GMT +9": "EAST9",
+    "GMT +10": "EAST10",
+    "GMT +11": "EAST11",
+    "GMT +12": "EAST12",
+}
+
+# Reverse mapping: Form enum → Human-readable
+TIMEZONE_REVERSE_MAP: dict[str, str] = {v: k for k, v in TIMEZONE_MAP.items()}
+
+# Country mappings: Human-readable (from API) → Form enum (for POST)
+# Source: Analyzed country options from HTML form (North America region shown)
+# NOTE: This list is incomplete - only shows North American countries
+# Additional countries would appear based on selected continent/region
+COUNTRY_MAP: dict[str, str] = {
+    "Canada": "CANADA",
+    "United States of America": "UNITED_STATES_OF_AMERICA",
+    "Mexico": "MEXICO",
+    "Greenland": "GREENLAND",
+}
+
+# Reverse mapping: Form enum → Human-readable
+COUNTRY_REVERSE_MAP: dict[str, str] = {v: k for k, v in COUNTRY_MAP.items()}
+
+# Continent mappings: Human-readable → Form enum
+# Source: All 6 continent options from HTML form
+CONTINENT_MAP: dict[str, str] = {
+    "Africa": "AFRICA",
+    "Asia": "ASIA",
+    "Europe": "EUROPE",
+    "North America": "NORTH_AMERICA",
+    "Oceania": "OCEANIA",
+    "South America": "SOUTH_AMERICA",
+}
+
+CONTINENT_REVERSE_MAP: dict[str, str] = {v: k for k, v in CONTINENT_MAP.items()}
+
+# Region mappings: Human-readable → Form enum
+# Source: Region options from HTML form (context: North America continent)
+# NOTE: Region options are hierarchical and depend on selected continent
+REGION_MAP: dict[str, str] = {
+    # North America regions (when continent = NORTH_AMERICA)
+    "Caribbean": "CARIBBEAN",
+    "Central America": "CENTRAL_AMERICA",
+    "North America": "NORTH_AMERICA",
+    # Additional regions would be discovered when exploring other continents
+}
+
+REGION_REVERSE_MAP: dict[str, str] = {v: k for k, v in REGION_MAP.items()}
+
+
+def get_timezone_enum(human_readable: str) -> str:
+    """Convert human-readable timezone to API enum.
+
+    Args:
+        human_readable: Timezone string like "GMT -8"
+
+    Returns:
+        API enum like "WEST8"
+
+    Raises:
+        ValueError: If timezone is not recognized
+    """
+    if human_readable in TIMEZONE_MAP:
+        return TIMEZONE_MAP[human_readable]
+    raise ValueError(f"Unknown timezone: {human_readable}")
+
+
+def get_country_enum(human_readable: str) -> str:
+    """Convert human-readable country to API enum.
+
+    Args:
+        human_readable: Country string like "United States of America"
+
+    Returns:
+        API enum like "UNITED_STATES_OF_AMERICA"
+
+    Raises:
+        ValueError: If country is not recognized
+    """
+    if human_readable in COUNTRY_MAP:
+        return COUNTRY_MAP[human_readable]
+    raise ValueError(f"Unknown country: {human_readable}")
+
+
+def get_region_enum(human_readable: str) -> str:
+    """Convert human-readable region to API enum.
+
+    Args:
+        human_readable: Region string like "North America"
+
+    Returns:
+        API enum like "NORTH_AMERICA"
+
+    Raises:
+        ValueError: If region is not recognized
+    """
+    if human_readable in REGION_MAP:
+        return REGION_MAP[human_readable]
+    raise ValueError(f"Unknown region: {human_readable}")
+
+
+def get_continent_enum(human_readable: str) -> str:
+    """Convert human-readable continent to API enum.
+
+    Args:
+        human_readable: Continent string like "North America"
+
+    Returns:
+        API enum like "NORTH_AMERICA"
+
+    Raises:
+        ValueError: If continent is not recognized
+    """
+    if human_readable in CONTINENT_MAP:
+        return CONTINENT_MAP[human_readable]
+    raise ValueError(f"Unknown continent: {human_readable}")
+
+
+# Static mapping for common countries (fast path)
+# This covers the most frequently used countries to avoid API calls
+COUNTRY_TO_LOCATION_STATIC: dict[str, tuple[str, str]] = {
+    # North America
+    "United States of America": ("NORTH_AMERICA", "NORTH_AMERICA"),
+    "Canada": ("NORTH_AMERICA", "NORTH_AMERICA"),
+    "Mexico": ("NORTH_AMERICA", "CENTRAL_AMERICA"),
+    "Greenland": ("NORTH_AMERICA", "NORTH_AMERICA"),
+    # Europe (common)
+    "United Kingdom": ("EUROPE", "WESTERN_EUROPE"),
+    "Germany": ("EUROPE", "CENTRAL_EUROPE"),
+    "France": ("EUROPE", "WESTERN_EUROPE"),
+    "Spain": ("EUROPE", "SOUTHERN_EUROPE"),
+    "Italy": ("EUROPE", "SOUTHERN_EUROPE"),
+    "The Netherlands": ("EUROPE", "WESTERN_EUROPE"),
+    "Belgium": ("EUROPE", "WESTERN_EUROPE"),
+    "Switzerland": ("EUROPE", "CENTRAL_EUROPE"),
+    "Austria": ("EUROPE", "CENTRAL_EUROPE"),
+    "Poland": ("EUROPE", "CENTRAL_EUROPE"),
+    "Sweden": ("EUROPE", "NORDIC_EUROPE"),
+    "Norway": ("EUROPE", "NORDIC_EUROPE"),
+    "Denmark": ("EUROPE", "NORDIC_EUROPE"),
+    # Asia (common)
+    "China": ("ASIA", "EAST_ASIA"),
+    "Japan": ("ASIA", "EAST_ASIA"),
+    "South korea": ("ASIA", "EAST_ASIA"),
+    "India": ("ASIA", "SOUTH_ASIA"),
+    "Singapore": ("ASIA", "SOUTHEAST_ASIA"),
+    "Thailand": ("ASIA", "SOUTHEAST_ASIA"),
+    "Malaysia": ("ASIA", "SOUTHEAST_ASIA"),
+    "Indonesia": ("ASIA", "SOUTHEAST_ASIA"),
+    "Philippines": ("ASIA", "SOUTHEAST_ASIA"),
+    "Vietnam": ("ASIA", "SOUTHEAST_ASIA"),
+    # Oceania
+    "Australia": ("OCEANIA", "OCEANIA"),
+    "New Zealand": ("OCEANIA", "OCEANIA"),
+    # South America
+    "Brazil": ("SOUTH_AMERICA", "SA_EAST"),
+    "Argentina": ("SOUTH_AMERICA", "SA_SOUTHERN_PART"),  # Note: API has "Aregntine" typo
+    "Chile": ("SOUTH_AMERICA", "SA_SOUTHERN_PART"),
+    # Africa (common)
+    "South Africa": ("AFRICA", "SOUTH_AFRICA"),
+    "Egypt": ("AFRICA", "NORTH_AFRICA"),
+}
+
+
+def get_continent_region_from_country(country_human: str) -> tuple[str, str]:
+    """Derive continent and region enums from country name.
+
+    Uses static mapping for common countries (fast path).
+    For unknown countries, requires dynamic fetching from locale API.
+
+    Args:
+        country_human: Human-readable country name from API
+
+    Returns:
+        Tuple of (continent_enum, region_enum)
+
+    Raises:
+        ValueError: If country is not in static mapping (requires dynamic fetch)
+    """
+    # Fast path: check static mapping
+    if country_human in COUNTRY_TO_LOCATION_STATIC:
+        return COUNTRY_TO_LOCATION_STATIC[country_human]
+
+    # Country not in static mapping - requires dynamic fetch
+    raise ValueError(
+        f"Country '{country_human}' not in static mapping. "
+        "Dynamic fetching from locale API required."
+    )

pylxpweb/{constants.py → constants/registers.py}

@@ -1,232 +1,14 @@
-"""Constants and mappings for Luxpower/EG4 API.
+"""Inverter parameter register definitions and mappings.
 
-This module contains mapping tables extracted from the EG4 web interface
-to convert between human-readable API values and the enum values required
-for configuration updates.
+This module contains all hold register (configuration) and input register
+(runtime data) definitions for Luxpower/EG4 inverters, plus GridBOSS/MID
+device parameters.
 
-These mappings were discovered by analyzing the HTML form at:
-/WManage/web/config/plant/edit/{plant_id}
+Source: EG4-18KPV-12LV Modbus Protocol specification
 """
 
 from __future__ import annotations
 
-# Timezone mappings: Human-readable (from API) → Form enum (for POST)
-# Source: Analyzed all 28 timezone options from the HTML form
-TIMEZONE_MAP: dict[str, str] = {
-    "GMT -12": "WEST12",
-    "GMT -11": "WEST11",
-    "GMT -10": "WEST10",
-    "GMT -9": "WEST9",
-    "GMT -8": "WEST8",
-    "GMT -7": "WEST7",
-    "GMT -6": "WEST6",
-    "GMT -5": "WEST5",
-    "GMT -4": "WEST4",
-    "GMT -3": "WEST3",
-    "GMT -2": "WEST2",
-    "GMT -1": "WEST1",
-    "GMT 0": "ZERO",
-    "GMT +1": "EAST1",
-    "GMT +2": "EAST2",
-    "GMT +3": "EAST3",
-    "GMT +3:30": "EAST3_30",
-    "GMT +4": "EAST4",
-    "GMT +5": "EAST5",
-    "GMT +5:30": "EAST5_30",
-    "GMT +6": "EAST6",
-    "GMT +6:30": "EAST6_30",
-    "GMT +7": "EAST7",
-    "GMT +8": "EAST8",
-    "GMT +9": "EAST9",
-    "GMT +10": "EAST10",
-    "GMT +11": "EAST11",
-    "GMT +12": "EAST12",
-}
-
-# Reverse mapping: Form enum → Human-readable
-TIMEZONE_REVERSE_MAP: dict[str, str] = {v: k for k, v in TIMEZONE_MAP.items()}
-
-# Country mappings: Human-readable (from API) → Form enum (for POST)
-# Source: Analyzed country options from HTML form (North America region shown)
-# NOTE: This list is incomplete - only shows North American countries
-# Additional countries would appear based on selected continent/region
-COUNTRY_MAP: dict[str, str] = {
-    "Canada": "CANADA",
-    "United States of America": "UNITED_STATES_OF_AMERICA",
-    "Mexico": "MEXICO",
-    "Greenland": "GREENLAND",
-}
-
-# Reverse mapping: Form enum → Human-readable
-COUNTRY_REVERSE_MAP: dict[str, str] = {v: k for k, v in COUNTRY_MAP.items()}
-
-# Continent mappings: Human-readable → Form enum
-# Source: All 6 continent options from HTML form
-CONTINENT_MAP: dict[str, str] = {
-    "Africa": "AFRICA",
-    "Asia": "ASIA",
-    "Europe": "EUROPE",
-    "North America": "NORTH_AMERICA",
-    "Oceania": "OCEANIA",
-    "South America": "SOUTH_AMERICA",
-}
-
-CONTINENT_REVERSE_MAP: dict[str, str] = {v: k for k, v in CONTINENT_MAP.items()}
-
-# Region mappings: Human-readable → Form enum
-# Source: Region options from HTML form (context: North America continent)
-# NOTE: Region options are hierarchical and depend on selected continent
-REGION_MAP: dict[str, str] = {
-    # North America regions (when continent = NORTH_AMERICA)
-    "Caribbean": "CARIBBEAN",
-    "Central America": "CENTRAL_AMERICA",
-    "North America": "NORTH_AMERICA",
-    # Additional regions would be discovered when exploring other continents
-}
-
-REGION_REVERSE_MAP: dict[str, str] = {v: k for k, v in REGION_MAP.items()}
-
-
-def get_timezone_enum(human_readable: str) -> str:
-    """Convert human-readable timezone to API enum.
-
-    Args:
-        human_readable: Timezone string like "GMT -8"
-
-    Returns:
-        API enum like "WEST8"
-
-    Raises:
-        ValueError: If timezone is not recognized
-    """
-    if human_readable in TIMEZONE_MAP:
-        return TIMEZONE_MAP[human_readable]
-    raise ValueError(f"Unknown timezone: {human_readable}")
-
-
-def get_country_enum(human_readable: str) -> str:
-    """Convert human-readable country to API enum.
-
-    Args:
-        human_readable: Country string like "United States of America"
-
-    Returns:
-        API enum like "UNITED_STATES_OF_AMERICA"
-
-    Raises:
-        ValueError: If country is not recognized
-    """
-    if human_readable in COUNTRY_MAP:
-        return COUNTRY_MAP[human_readable]
-    raise ValueError(f"Unknown country: {human_readable}")
-
-
-def get_region_enum(human_readable: str) -> str:
-    """Convert human-readable region to API enum.
-
-    Args:
-        human_readable: Region string like "North America"
-
-    Returns:
-        API enum like "NORTH_AMERICA"
-
-    Raises:
-        ValueError: If region is not recognized
-    """
-    if human_readable in REGION_MAP:
-        return REGION_MAP[human_readable]
-    raise ValueError(f"Unknown region: {human_readable}")
-
-
-def get_continent_enum(human_readable: str) -> str:
-    """Convert human-readable continent to API enum.
-
-    Args:
-        human_readable: Continent string like "North America"
-
-    Returns:
-        API enum like "NORTH_AMERICA"
-
-    Raises:
-        ValueError: If continent is not recognized
-    """
-    if human_readable in CONTINENT_MAP:
-        return CONTINENT_MAP[human_readable]
-    raise ValueError(f"Unknown continent: {human_readable}")
-
-
-# Static mapping for common countries (fast path)
-# This covers the most frequently used countries to avoid API calls
-COUNTRY_TO_LOCATION_STATIC: dict[str, tuple[str, str]] = {
-    # North America
-    "United States of America": ("NORTH_AMERICA", "NORTH_AMERICA"),
-    "Canada": ("NORTH_AMERICA", "NORTH_AMERICA"),
-    "Mexico": ("NORTH_AMERICA", "CENTRAL_AMERICA"),
-    "Greenland": ("NORTH_AMERICA", "NORTH_AMERICA"),
-    # Europe (common)
-    "United Kingdom": ("EUROPE", "WESTERN_EUROPE"),
-    "Germany": ("EUROPE", "CENTRAL_EUROPE"),
-    "France": ("EUROPE", "WESTERN_EUROPE"),
-    "Spain": ("EUROPE", "SOUTHERN_EUROPE"),
-    "Italy": ("EUROPE", "SOUTHERN_EUROPE"),
-    "The Netherlands": ("EUROPE", "WESTERN_EUROPE"),
-    "Belgium": ("EUROPE", "WESTERN_EUROPE"),
-    "Switzerland": ("EUROPE", "CENTRAL_EUROPE"),
-    "Austria": ("EUROPE", "CENTRAL_EUROPE"),
-    "Poland": ("EUROPE", "CENTRAL_EUROPE"),
-    "Sweden": ("EUROPE", "NORDIC_EUROPE"),
-    "Norway": ("EUROPE", "NORDIC_EUROPE"),
-    "Denmark": ("EUROPE", "NORDIC_EUROPE"),
-    # Asia (common)
-    "China": ("ASIA", "EAST_ASIA"),
-    "Japan": ("ASIA", "EAST_ASIA"),
-    "South korea": ("ASIA", "EAST_ASIA"),
-    "India": ("ASIA", "SOUTH_ASIA"),
-    "Singapore": ("ASIA", "SOUTHEAST_ASIA"),
-    "Thailand": ("ASIA", "SOUTHEAST_ASIA"),
-    "Malaysia": ("ASIA", "SOUTHEAST_ASIA"),
-    "Indonesia": ("ASIA", "SOUTHEAST_ASIA"),
-    "Philippines": ("ASIA", "SOUTHEAST_ASIA"),
-    "Vietnam": ("ASIA", "SOUTHEAST_ASIA"),
-    # Oceania
-    "Australia": ("OCEANIA", "OCEANIA"),
-    "New Zealand": ("OCEANIA", "OCEANIA"),
-    # South America
-    "Brazil": ("SOUTH_AMERICA", "SA_EAST"),
-    "Argentina": ("SOUTH_AMERICA", "SA_SOUTHERN_PART"),  # Note: API has "Aregntine" typo
-    "Chile": ("SOUTH_AMERICA", "SA_SOUTHERN_PART"),
-    # Africa (common)
-    "South Africa": ("AFRICA", "SOUTH_AFRICA"),
-    "Egypt": ("AFRICA", "NORTH_AFRICA"),
-}
-
-
-def get_continent_region_from_country(country_human: str) -> tuple[str, str]:
-    """Derive continent and region enums from country name.
-
-    Uses static mapping for common countries (fast path).
-    For unknown countries, requires dynamic fetching from locale API.
-
-    Args:
-        country_human: Human-readable country name from API
-
-    Returns:
-        Tuple of (continent_enum, region_enum)
-
-    Raises:
-        ValueError: If country is not in static mapping (requires dynamic fetch)
-    """
-    # Fast path: check static mapping
-    if country_human in COUNTRY_TO_LOCATION_STATIC:
-        return COUNTRY_TO_LOCATION_STATIC[country_human]
-
-    # Country not in static mapping - requires dynamic fetch
-    raise ValueError(
-        f"Country '{country_human}' not in static mapping. "
-        "Dynamic fetching from locale API required."
-    )
-
-
 # ============================================================================
 # INVERTER PARAMETER MAPPINGS (Hold Registers)
 # ============================================================================
@@ -242,7 +24,7 @@ FUNC_EN_BIT_FORCED_DISCHG_EN = 10  # Forced discharge enable
 FUNC_EN_BIT_FORCED_CHG_EN = 11  # Force charge enable
 
 # AC Charge Parameters
-HOLD_AC_CHARGE_POWER_CMD = 66  # AC charge power (0-100%)
+HOLD_AC_CHARGE_POWER_CMD = 66  # AC charge power (0.0-15.0 kW)
 HOLD_AC_CHARGE_SOC_LIMIT = 67  # AC charge SOC limit (0-100%)
 HOLD_AC_CHARGE_START_HOUR_1 = 68  # Time period 1 start hour (0-23)
 HOLD_AC_CHARGE_START_MIN_1 = 69  # Time period 1 start minute (0-59)
@@ -327,22 +109,22 @@ INPUT_P_EPS = (30, 31)  # EPS output power (W, 2 registers)
 INPUT_S_EPS = 32  # EPS status
 INPUT_P_TO_GRID = 33  # Export to grid power (W)
 INPUT_P_TO_USER = (34, 35)  # Load consumption power (W, 2 registers)
-INPUT_E_INV_ALL = 36  # Total inverter energy (kWh, /10)
-INPUT_E_REC_ALL = 37  # Total grid import energy (kWh, /10)
-INPUT_E_CHG_ALL = 38  # Total charge energy (kWh, /10)
-INPUT_E_DISCHG_ALL = 39  # Total discharge energy (kWh, /10)
-INPUT_E_EPS_ALL = 40  # Total EPS energy (kWh, /10)
-INPUT_E_TO_GRID_ALL = 41  # Total export energy (kWh, /10)
-INPUT_E_TO_USER_ALL = 42  # Total load energy (kWh, /10)
+INPUT_E_INV_ALL = 36  # Total inverter energy (Wh after /10, divide by 10 for Wh)
+INPUT_E_REC_ALL = 37  # Total grid import energy (Wh after /10, divide by 10 for Wh)
+INPUT_E_CHG_ALL = 38  # Total charge energy (Wh after /10, divide by 10 for Wh)
+INPUT_E_DISCHG_ALL = 39  # Total discharge energy (Wh after /10, divide by 10 for Wh)
+INPUT_E_EPS_ALL = 40  # Total EPS energy (Wh after /10, divide by 10 for Wh)
+INPUT_E_TO_GRID_ALL = 41  # Total export energy (Wh after /10, divide by 10 for Wh)
+INPUT_E_TO_USER_ALL = 42  # Total load energy (Wh after /10, divide by 10 for Wh)
 INPUT_V_BUS1 = 43  # Bus 1 voltage (V, /10)
 INPUT_V_BUS2 = 44  # Bus 2 voltage (V, /10)
-INPUT_E_INV_DAY = (45, 46)  # Daily inverter energy (kWh, /10, 2 registers)
-INPUT_E_REC_DAY = (47, 48)  # Daily grid import (kWh, /10, 2 registers)
-INPUT_E_CHG_DAY = (49, 50)  # Daily charge energy (kWh, /10, 2 registers)
-INPUT_E_DISCHG_DAY = (51, 52)  # Daily discharge energy (kWh, /10, 2 registers)
-INPUT_E_EPS_DAY = (53, 54)  # Daily EPS energy (kWh, /10, 2 registers)
-INPUT_E_TO_GRID_DAY = (55, 56)  # Daily export energy (kWh, /10, 2 registers)
-INPUT_E_TO_USER_DAY = (57, 58)  # Daily load energy (kWh, /10, 2 registers)
+INPUT_E_INV_DAY = (45, 46)  # Daily inverter energy (Wh after /10, 2 registers)
+INPUT_E_REC_DAY = (47, 48)  # Daily grid import (Wh after /10, 2 registers)
+INPUT_E_CHG_DAY = (49, 50)  # Daily charge energy (Wh after /10, 2 registers)
+INPUT_E_DISCHG_DAY = (51, 52)  # Daily discharge energy (Wh after /10, 2 registers)
+INPUT_E_EPS_DAY = (53, 54)  # Daily EPS energy (Wh after /10, 2 registers)
+INPUT_E_TO_GRID_DAY = (55, 56)  # Daily export energy (Wh after /10, 2 registers)
+INPUT_E_TO_USER_DAY = (57, 58)  # Daily load energy (Wh after /10, 2 registers)
 INPUT_V_BAT_LIMIT = 59  # Max charge voltage (V, /100)
 INPUT_I_BAT_LIMIT = 60  # Max charge current (A, /10)
 
@@ -1135,6 +917,58 @@ GRIDBOSS_STATS = {
     "midbox_specific_parameters": 159,  # Smart Load, AC Coupling, Generator control
 }
 
+# ============================================================================
+# MODEL-SPECIFIC PARAMETER KEYS
+# ============================================================================
+# These parameters are only available on specific inverter model families.
+# The feature detection system uses these to identify model capabilities.
+
+# SNA Series (Split-phase, North America) - Device Type Code: 54
+# These parameters are unique to SNA models like SNA12K-US
+SNA_PARAMETERS = [
+    # Discharge recovery hysteresis (prevents oscillation at SOC cutoff)
+    "HOLD_DISCHG_RECOVERY_LAG_SOC",  # SOC hysteresis percentage
+    "HOLD_DISCHG_RECOVERY_LAG_VOLT",  # Voltage hysteresis (÷10)
+    # Quick charge configuration
+    "SNA_HOLD_QUICK_CHARGE_MINUTE",  # Quick charge duration in minutes
+    # Off-grid specific
+    "OFF_GRID_HOLD_EPS_VOLT_SET",
+    "OFF_GRID_HOLD_EPS_FREQ_SET",
+]
+
+# PV Series (High-voltage DC, US) - Device Type Code: 2092
+# These parameters are available on 18KPV and similar models
+PV_SERIES_PARAMETERS = [
+    # Volt-Watt curve parameters
+    "HOLD_VW_V1",
+    "HOLD_VW_V2",
+    "HOLD_VW_V3",
+    "HOLD_VW_V4",
+    "HOLD_VW_P1",
+    "HOLD_VW_P2",
+    "HOLD_VW_P3",
+    "HOLD_VW_P4",
+    # Grid peak shaving
+    "_12K_HOLD_GRID_PEAK_SHAVING_POWER",
+    # Parallel operation
+    "HOLD_PARALLEL_REGISTER",
+]
+
+# LXP-EU Series (European) - Device Type Code: 12
+# These parameters are available on LXP-EU 12K and similar models
+LXP_EU_PARAMETERS = [
+    # EU grid compliance
+    "HOLD_EU_GRID_CODE",
+    "HOLD_EU_COUNTRY_CODE",
+]
+
+# Device Type Code Constants (HOLD_DEVICE_TYPE_CODE register 19)
+# These identify the specific inverter model/variant
+DEVICE_TYPE_CODE_SNA = 54  # SNA Series (e.g., SNA12K-US)
+DEVICE_TYPE_CODE_PV_SERIES = 2092  # PV Series (e.g., 18KPV)
+DEVICE_TYPE_CODE_LXP_EU = 12  # LXP-EU Series (e.g., LXP-EU 12K)
+
+
 # ============================================================================
 # HELPER FUNCTIONS FOR PARAMETER OPERATIONS
 # ============================================================================