Bump version to v1.1.0 — SPE 8000-12000 ES grid-tie controls (#322)

- Add SPE grid export energy sensors: reg 45 (today, single 16-bit per Protocol V0.26),
  regs 46/47 (total, 32-bit pair). Fixes earlier incorrect assumption that reg 44 was
  the high word of today's export — reg 44 = DTC per Off-Grid Protocol V0.26.
- Add coordinator fallback to find standalone energy_to_grid_today register (no _low suffix)
  so SPE's single-register reading is picked up correctly.
- Add SPE grid-tie holding register controls (115-124): grid export enable, output priority,
  feed range (region), battery export enable, export power limit, battery export current,
  battery voltage loss/back thresholds, SOC loss/back points.
- Valid ranges taken from Off-Grid Protocol V0.26: reg 120=0-400A, reg 123=5-90%,
  reg 124=15-100% (corrected from nicauswu's ZIP which had all three as 0-100).
- Add only_profiles/not_profiles filter to WRITABLE_REGISTERS; applied in number.py and
  select.py to prevent reg 123 cross-contamination between SPH (export_limit_power) and
  SPE (export_min_soc) which share the same register address.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 0xAHA

README.md

@@ -3,7 +3,7 @@
 # Growatt Modbus Integration for Home Assistant ☀️
 
 ![HACS Badge](https://img.shields.io/badge/HACS-Custom-orange.svg)
-![Version](https://img.shields.io/badge/Version-1.0.9-blue.svg)
+![Version](https://img.shields.io/badge/Version-1.1.0-blue.svg)
 [![GitHub Issues](https://img.shields.io/github/issues/0xAHA/Growatt_ModbusTCP.svg)](https://github.com/0xAHA/Growatt_ModbusTCP/issues)
 [![GitHub Stars](https://img.shields.io/github/stars/0xAHA/Growatt_ModbusTCP.svg?style=social)](https://github.com/0xAHA/Growatt_ModbusTCP)
 

RELEASENOTES.md

@@ -4,6 +4,42 @@
 
 ---
 
+## v1.1.0
+
+Issues: #322
+
+- **New: SPE 8000-12000 ES grid-tie export sensors (#322):**
+  Added grid export energy sensors for the SPE 8000-12000 ES single-phase hybrid inverter:
+  - **Energy to Grid Today** — input reg 45, single 16-bit register, 0.1 kWh resolution
+    (confirmed per Off-Grid Protocol V0.26; prior implementation incorrectly used a 32-bit pair)
+  - **Energy to Grid Total** — input regs 46/47, 32-bit pair, 0.1 kWh resolution
+
+- **New: SPE 8000-12000 ES grid-tie controls (#322):**
+  Added ten writable holding registers for SPE grid-tied export configuration:
+  | Register | Name | Description |
+  |----------|------|-------------|
+  | 115 | Grid Export Enable | Enable/disable grid feed |
+  | 116 | Output Priority | Charge First / Load First / Feed First |
+  | 117 | Feed Range | Grid compliance region (Asia/Europe/S.America/S.Africa) |
+  | 118 | Battery Export Enable | Enable battery-to-grid export |
+  | 119 | Export Power Limit | Max export power (0–12 kW) |
+  | 120 | Battery Export Max Current | Max battery current for export (0–400 A) |
+  | 121 | Battery Feed Voltage Loss | Voltage at which export stops (42–54V) |
+  | 122 | Battery Feed Voltage Back | Voltage to resume export (44–56V) |
+  | 123 | Export Min SOC | Minimum SOC to allow export (5–90%) |
+  | 124 | Export Back SOC | SOC to resume export after stopping (15–100%) |
+
+  All controls are SPE-specific and will not appear on other profiles.
+  Valid ranges are taken from Off-Grid Protocol V0.26; some differ from nicauswu's original
+  implementation (regs 120, 123, 124) and are pending field validation.
+
+- **Fix: profile-specific writable register filtering (#322):**
+  Register 123 is `export_limit_power` on SPH/XH but `export_min_soc` on SPE. A new
+  `only_profiles` / `not_profiles` filter on `WRITABLE_REGISTERS` entries prevents
+  cross-profile contamination. The filter is applied in both `number.py` and `select.py`.
+
+---
+
 ## v1.0.9
 
 Issues: #351

custom_components/growatt_modbus/const.py

@@ -149,6 +149,7 @@
     },
     'export_limit_power': {
         'register': 123,
+        'not_profiles': ['SPE_8000_12000_ES'],  # SPE reg 123 = export_min_soc (different semantic)
         'scale': 0.1,  # Store as 0-1000, display as 0-100.0%
         'valid_range': (0, 1000),  # 0 = 0%, 1000 = 100%
         'unit': '%'
@@ -343,6 +344,93 @@
         'battery_dependent': True
     },
 
+    # SPE 8000-12000 ES Grid-Tie Export Controls (confirmed working via nicauswu field data, Issue #322)
+    # These registers are SPE-only (only_profiles guard prevents cross-profile contamination).
+    'spe_grid_export_enable': {
+        'register': 115,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 1,
+        'valid_range': (0, 1),
+        'options': {0: 'Disabled', 1: 'Enabled'},
+        'desc': 'Grid export enable/disable',
+    },
+    'spe_battery_export_enable': {
+        'register': 118,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 1,
+        'valid_range': (0, 1),
+        'options': {0: 'Disabled', 1: 'Enabled'},
+        'desc': 'Battery-to-grid export enable/disable',
+    },
+    'spe_export_limit_power': {
+        'register': 119,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 0.1,
+        'valid_range': (0, 120),
+        'unit': 'kW',
+        'desc': 'Grid export power limit (0-12kW, stored as 0-120 × 0.1 kW)',
+    },
+    'spe_output_priority': {
+        'register': 116,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 1,
+        'valid_range': (0, 2),
+        'options': {0: 'Charge First', 1: 'Load First', 2: 'Feed First'},
+        'desc': 'Output priority (uwLoadFirst): charge first / load first / feed first',
+    },
+    'spe_feed_range': {
+        'register': 117,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 1,
+        'valid_range': (0, 3),
+        'options': {0: 'Asia', 1: 'Europe', 2: 'South America', 3: 'South Africa'},
+        'desc': 'Grid compliance region (uwFeedRange)',
+    },
+    'spe_battery_export_max_current': {
+        'register': 120,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 1,
+        'valid_range': (0, 400),
+        'unit': 'A',
+        'desc': 'Max battery current for grid export (uwBatFeedCurr): 0-400 A per Protocol V0.26',
+    },
+    'spe_bat_feed_vloss': {
+        'register': 121,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 0.1,
+        'valid_range': (420, 540),
+        'unit': 'V',
+        'desc': 'Battery voltage loss point to stop export (uwBatFeedVLoss): raw 420-540 = 42-54V',
+    },
+    'spe_bat_feed_vback': {
+        'register': 122,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 0.1,
+        'valid_range': (440, 560),
+        'unit': 'V',
+        'desc': 'Battery voltage back point to resume export (uwBatFeedVBack): raw 440-560 = 44-56V',
+    },
+    # SPE reg 123 = export min SOC. Separate from SPH reg 123 = export_limit_power (%).
+    # The not_profiles guard on export_limit_power prevents cross-contamination.
+    # Protocol V0.26 valid range is 5-90, not 0-100.
+    'spe_export_min_soc': {
+        'register': 123,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 1,
+        'valid_range': (5, 90),
+        'unit': '%',
+        'desc': 'Min battery SOC to allow export (uwBatFeedSocLoss): 5-90% per Protocol V0.26',
+    },
+    # Protocol V0.26 valid range is 15-100.
+    'spe_export_back_soc': {
+        'register': 124,
+        'only_profiles': ['SPE_8000_12000_ES'],
+        'scale': 1,
+        'valid_range': (15, 100),
+        'unit': '%',
+        'desc': 'SOC back point to resume export (uwBatFeedSocBack): 15-100% per Protocol V0.26',
+    },
+
     'discharge_power_rate': {
         'register': 1070,
         'scale': 1,

custom_components/growatt_modbus/growatt_modbus.py

@@ -2498,10 +2498,13 @@ def _read_energy_breakdown(self, data: GrowattData) -> None:
                 data.energy_to_user_total = self._get_register_value(addr) or 0.0
 
             # Energy to grid
-            addr = self._find_register_by_name('energy_to_grid_today_low')
+            # Prefer 32-bit pair (_low suffix); fall back to standalone single register.
+            # SPE uses a single 16-bit register for today (Protocol V0.26 reg 45).
+            addr = self._find_register_by_name('energy_to_grid_today_low') or \
+                   self._find_register_by_name('energy_to_grid_today')
             if addr:
                 data.energy_to_grid_today = self._get_register_value(addr) or 0.0
-            
+
             addr = self._find_register_by_name('energy_to_grid_total_low')
             if addr:
                 data.energy_to_grid_total = self._get_register_value(addr) or 0.0

custom_components/growatt_modbus/manifest.json

@@ -12,5 +12,5 @@
     "pymodbus>=3.0.0",
     "pyserial>=3.4"
   ],
-  "version": "1.0.9"
+  "version": "1.1.0"
 }

custom_components/growatt_modbus/number.py

@@ -102,6 +102,14 @@ async def async_setup_entry(
         if register_num not in holding_registers:
             continue  # Skip if register not in this profile
 
+        # Profile-specific filter: only_profiles restricts to named maps; not_profiles excludes them
+        _only = control_config.get('only_profiles')
+        if _only and register_map_name not in _only:
+            continue
+        _not = control_config.get('not_profiles')
+        if _not and register_map_name in _not:
+            continue
+
         # VPP export limit requires live confirmation that the inverter responds to 30200-30201
         if control_name == 'vpp_export_limit_power_rate':
             if coordinator.data is None or not coordinator.data.vpp_export_limit_available:

custom_components/growatt_modbus/profiles/spe.py

@@ -25,6 +25,10 @@
   * Regs 92-97: Generator registers — SPE has no generator input, all zero
 - offgrid_protocol flag prevents reading VPP registers (30000+) which return garbage on this firmware
 
+Grid-Tie Export Controls (confirmed via nicauswu field data, Issue #322):
+- Holding regs 115-124 control grid-tied export behaviour (not present on SPF)
+- Cross-referenced against Off-Grid Protocol V0.26 (docs/developer/protocol-offgrid.md)
+
 DTC Identification:
 - This device returned DTC 64541 (unknown, not in standard mapping) in the Issue #212 scan
 - Auto-detection falls back to legacy range analysis for this device
@@ -56,6 +60,28 @@
 for _addr in (92, 93, 94, 95, 96, 97):
     _spe_input_regs.pop(_addr, None)
 
+# ── Add grid export energy registers (SPE grid-tied, not present in SPF) ─────
+# Reg 44 = DTC (Device Type Code) per Off-Grid Protocol V0.26 — NOT overridden here.
+# Reg 45 = Export to Grid Today — single 16-bit register (scale 0.1 kWh) per V0.26.
+#   Nicauswu's implementation also reads this as a standalone register. Max 6553.5 kWh
+#   is sufficient for daily totals.
+# Regs 46/47 = Export to Grid Total — 32-bit pair, combined scale 0.1 kWh per V0.26.
+_spe_input_regs.update({
+    45: {
+        'name': 'energy_to_grid_today', 'scale': 0.1, 'unit': 'kWh',
+        'desc': 'Grid export energy today (single 16-bit register). Protocol V0.26 reg 45.',
+    },
+    46: {
+        'name': 'energy_to_grid_total_high', 'scale': 1, 'unit': '', 'pair': 47,
+        'desc': 'Grid export energy total (HIGH word). Protocol V0.26 reg 46.',
+    },
+    47: {
+        'name': 'energy_to_grid_total_low', 'scale': 1, 'unit': '', 'pair': 46,
+        'combined_scale': 0.1, 'combined_unit': 'kWh',
+        'desc': 'Grid export energy total (LOW word). Protocol V0.26 reg 47.',
+    },
+})
+
 # ── Remap energy registers: SPF names are semantically wrong for SPE ──────────
 
 # Regs 64/65: SPF labels these "AC discharge energy today" (battery-to-load via inverter).
@@ -123,10 +149,13 @@
     'description': 'Single-phase hybrid inverter with battery storage (8-12kW)',
     'notes': (
         'Uses SPF-compatible 0-97 register range with key remapping. '
+        'Reg 45 = grid export energy today (single 16-bit, 0.1 kWh). '
+        'Regs 46/47 = grid export energy total (32-bit pair). '
         'Regs 64/65 = grid import energy (not AC discharge), '
         'Regs 85-88 = load energy today/total (not operational discharge). '
         'Regs 36/37 (ac_input_power) excluded — produces 429GW overflow. '
-        'No generator input. PV register validation pending daytime scan.'
+        'No generator input. '
+        'Grid-tie controls at holding regs 115-124 (confirmed via Issue #322, Protocol V0.26).'
     ),
     # NOTE: offgrid_protocol refers to the REGISTER LAYOUT (SPF-style 0-97),
     # not the inverter's grid capability. The SPE supports grid-tied operation
@@ -139,6 +168,66 @@
         # entity values seen in Issue #212 scan (charge_current, battery_type,
         # ac_input_mode, output_config, charge_config all reading correctly).
         **SPF_3000_6000_ES_PLUS['holding_registers'],
+
+        # ── SPE grid-tie export controls ──────────────────────────────────────
+        # All confirmed via nicauswu field data (Issue #322).
+        # Cross-referenced against Off-Grid Protocol V0.26 holding register table.
+        # Ranges and names from V0.26 unless noted.
+
+        # 115: uwFeedEn — grid feed enable
+        115: {'name': 'spe_grid_export_enable', 'scale': 1, 'unit': '', 'access': 'RW',
+              'desc': 'Grid export enable (uwFeedEn): 0=Disabled, 1=Enabled',
+              'values': {0: 'Disabled', 1: 'Enabled'}},
+
+        # 116: uwLoadFirst — output priority: charge first / load first / feed first
+        116: {'name': 'spe_output_priority', 'scale': 1, 'unit': '', 'access': 'RW',
+              'desc': 'Output priority (uwLoadFirst): 0=Charge first, 1=Load first, 2=Feed first',
+              'values': {0: 'Charge First', 1: 'Load First', 2: 'Feed First'}},
+
+        # 117: uwFeedRange — grid compliance region
+        117: {'name': 'spe_feed_range', 'scale': 1, 'unit': '', 'access': 'RW',
+              'desc': 'Grid compliance region (uwFeedRange): 0=Asia, 1=Europe, 2=S.America, 3=S.Africa',
+              'values': {0: 'Asia', 1: 'Europe', 2: 'South America', 3: 'South Africa'}},
+
+        # 118: uwBatFeedEn — battery-to-grid export enable
+        118: {'name': 'spe_battery_export_enable', 'scale': 1, 'unit': '', 'access': 'RW',
+              'desc': 'Battery-to-grid export enable (uwBatFeedEn): 0=Disabled, 1=Enabled',
+              'values': {0: 'Disabled', 1: 'Enabled'}},
+
+        # 119: uwFeedPow — feed power limit (0-120 raw = 0-12.0 kW)
+        119: {'name': 'spe_export_limit_power', 'scale': 0.1, 'unit': 'kW', 'access': 'RW',
+              'valid_range': (0, 120),
+              'desc': 'Grid export power limit (uwFeedPow): 0-12 kW (raw 0-120, scale 0.1)'},
+
+        # 120: uwBatFeedCurr — max battery current for grid export (0-400 A per V0.26)
+        # NOTE: nicauswu had this as 0-100; protocol V0.26 states 0-400.
+        # Pending validation from nicauswu register scan.
+        120: {'name': 'spe_battery_export_max_current', 'scale': 1, 'unit': 'A', 'access': 'RW',
+              'valid_range': (0, 400),
+              'desc': 'Max battery current for grid export (uwBatFeedCurr): 0-400 A (Protocol V0.26)'},
+
+        # 121: uwBatFeedVLoss — battery voltage at which export stops (420-540, units: 0.1V = 42-54V)
+        121: {'name': 'spe_bat_feed_vloss', 'scale': 0.1, 'unit': 'V', 'access': 'RW',
+              'valid_range': (420, 540),
+              'desc': 'Battery voltage loss point to stop export (uwBatFeedVLoss): 42-54V (raw 420-540)'},
+
+        # 122: uwBatFeedVBack — battery voltage at which export resumes (440-560, units: 0.1V = 44-56V)
+        122: {'name': 'spe_bat_feed_vback', 'scale': 0.1, 'unit': 'V', 'access': 'RW',
+              'valid_range': (440, 560),
+              'desc': 'Battery voltage back point to resume export (uwBatFeedVBack): 44-56V (raw 440-560)'},
+
+        # 123: uwBatFeedSocLoss — minimum SOC to allow export (5-90 %)
+        # NOTE: SPH reg 123 = export_limit_power (%). WRITABLE_REGISTERS carries
+        # not_profiles=['SPE_8000_12000_ES'] on that entry to prevent cross-contamination.
+        # Protocol V0.26 valid range is 5-90 (not 0-100 as nicauswu had).
+        123: {'name': 'spe_export_min_soc', 'scale': 1, 'unit': '%', 'access': 'RW',
+              'valid_range': (5, 90),
+              'desc': 'Min battery SOC to allow export (uwBatFeedSocLoss): 5-90% (Protocol V0.26)'},
+
+        # 124: uwBatFeedSocBack — SOC hysteresis to re-enable export (15-100 %)
+        124: {'name': 'spe_export_back_soc', 'scale': 1, 'unit': '%', 'access': 'RW',
+              'valid_range': (15, 100),
+              'desc': 'SOC back point to resume export (uwBatFeedSocBack): 15-100% (Protocol V0.26)'},
     },
 }
 

custom_components/growatt_modbus/select.py

@@ -86,6 +86,14 @@ async def async_setup_entry(
         if register_num not in holding_registers:
             continue  # Skip if register not in this profile
 
+        # Profile-specific filter: only_profiles restricts to named maps; not_profiles excludes them
+        _only = control_config.get('only_profiles')
+        if _only and register_map_name not in _only:
+            continue
+        _not = control_config.get('not_profiles')
+        if _not and register_map_name in _not:
+            continue
+
         # allow_grid_charge is handled by GrowattModAllowGridChargeSelect below
         if control_name == 'allow_grid_charge':
             continue