fix: EVC cumulative energy word order + unreachable modbus_min=101 gates

1. EV charger cumulative energy (0x0010 EQ_Total, input u32): the charger
   transmits this register high-word-first, contradicting the doc
   (EVC_Modbus_V3.5: 0x10=Lo / 0x11=Hi) and the same counter's
   little-ordered holding copy at 0x0619. Raw 3 (0.3 kWh) displayed as
   19660.8 kWh. Adds an optional per-sensor order32 override to
   BaseModbusSensorEntityDescription (the read path already honored it via
   getattr; only the dataclass field was missing) and sets order32="big"
   on charge_added_cum.

2. modbus_min=101 gates made a dozen entities unreachable: register 0x82
   reports the protocol version (100 = V001.00) and no known device
   returns more than 100 - the 101/102 values conflated the protocol
   register with the document revision (see the discussion on #2064).
   Raw register reads on a real protocol-100 device confirm all affected
   registers respond with sensible data (bias_power, peakshaving
   discharge limits, EV charger / AdapterBox communication states - the
   latter correctly reporting an actually-connected EV charger). Gates
   relaxed to 100 and the misleading dataclass comments corrected.
   The reactive-power registers (0xDE/0xE0, modbus_min=102) are
   intentionally NOT touched: relaxing them requires resolving their
   overlap with the 0xC0/0xC2 S32 variants, which needs hardware
   coverage this PR does not have.

Verified live on X3 EVC 11kW and X3-Hybrid-G4 15kW.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: Bl00d-B0b

custom_components/solax_modbus/const.py

@@ -204,8 +204,9 @@ class BaseModbusSensorEntityDescription(SensorEntityDescription):
     """Base class for modbus sensor declarations."""
 
     allowedtypes: int = 0  # overload with ALLDEFAULT from plugin
-    modbus_min: int | None = None  # Minimum supported Modbus protocol document version, e.g. 102 for V001.02.
-    modbus_max: int | None = None  # Maximum supported Modbus protocol document version.
+    order32: str | None = None  # per-sensor 32-bit word order override ("big"/"little"); None = plugin default
+    modbus_min: int | None = None  # Minimum protocol version as reported by register 0x82 (e.g. 100 for V001.00); not the document revision.
+    modbus_max: int | None = None  # Maximum protocol version as reported by register 0x82.
     scale: float | dict[Any, Any] | Callable[[Any, Any, dict[str, Any]], Any] = (
         1  # can be float, dictionary or callable function(initval, descr, datadict)
     )
@@ -252,8 +253,8 @@ class BaseModbusButtonEntityDescription(ButtonEntityDescription):
     """Base class for modbus button declarations."""
 
     allowedtypes: int = 0  # overload with ALLDEFAULT from plugin
-    modbus_min: int | None = None  # Minimum supported Modbus protocol document version, e.g. 102 for V001.02.
-    modbus_max: int | None = None  # Maximum supported Modbus protocol document version.
+    modbus_min: int | None = None  # Minimum protocol version as reported by register 0x82 (e.g. 100 for V001.00); not the document revision.
+    modbus_max: int | None = None  # Maximum protocol version as reported by register 0x82.
     register: int | None = None
     command: int | None = None
     blacklist: list[str] | None = None  # none or list of serial number prefixes
@@ -268,8 +269,8 @@ class BaseModbusSelectEntityDescription(SelectEntityDescription):
     """Base class for modbus select declarations."""
 
     allowedtypes: int = 0  # overload with ALLDEFAULT from plugin
-    modbus_min: int | None = None  # Minimum supported Modbus protocol document version, e.g. 102 for V001.02.
-    modbus_max: int | None = None  # Maximum supported Modbus protocol document version.
+    modbus_min: int | None = None  # Minimum protocol version as reported by register 0x82 (e.g. 100 for V001.00); not the document revision.
+    modbus_max: int | None = None  # Maximum protocol version as reported by register 0x82.
     register: int | None = None
     option_dict: dict[int, str] | None = None
     reverse_option_dict: dict[str, int] | None = None  # autocomputed
@@ -288,8 +289,8 @@ class BaseModbusSwitchEntityDescription(SwitchEntityDescription):
     """Base class for modbus switch declarations."""
 
     allowedtypes: int = 0  # overload with ALLDEFAULT from plugin
-    modbus_min: int | None = None  # Minimum supported Modbus protocol document version, e.g. 102 for V001.02.
-    modbus_max: int | None = None  # Maximum supported Modbus protocol document version.
+    modbus_min: int | None = None  # Minimum protocol version as reported by register 0x82 (e.g. 100 for V001.00); not the document revision.
+    modbus_max: int | None = None  # Maximum protocol version as reported by register 0x82.
     register: int | None = None
     register_bit: int | None = None
     blacklist: list[str] | None = None  # none or list of serial number prefixes
@@ -307,8 +308,8 @@ class BaseModbusTimeEntityDescription(TimeEntityDescription):
     """Base class for modbus time declarations."""
 
     allowedtypes: int = 0  # overload with ALLDEFAULT from plugin
-    modbus_min: int | None = None  # Minimum supported Modbus protocol document version, e.g. 102 for V001.02.
-    modbus_max: int | None = None  # Maximum supported Modbus protocol document version.
+    modbus_min: int | None = None  # Minimum protocol version as reported by register 0x82 (e.g. 100 for V001.00); not the document revision.
+    modbus_max: int | None = None  # Maximum protocol version as reported by register 0x82.
     scale: float | dict[Any, Any] | Callable[[Any, Any, dict[str, Any]], Any] = 1
     read_scale_exceptions: list[Any] | None = None
     read_scale: float = 1
@@ -336,8 +337,8 @@ class BaseModbusNumberEntityDescription(NumberEntityDescription):
     """Base class for modbus number declarations."""
 
     allowedtypes: int = 0  # overload with ALLDEFAULT from plugin
-    modbus_min: int | None = None  # Minimum supported Modbus protocol document version, e.g. 102 for V001.02.
-    modbus_max: int | None = None  # Maximum supported Modbus protocol document version.
+    modbus_min: int | None = None  # Minimum protocol version as reported by register 0x82 (e.g. 100 for V001.00); not the document revision.
+    modbus_max: int | None = None  # Maximum protocol version as reported by register 0x82.
     register: int | None = None
     read_scale_exceptions: list[Any] | None = None
     read_scale: float = 1

custom_components/solax_modbus/plugin_solax.py

@@ -2283,7 +2283,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         native_unit_of_measurement=UnitOfPower.WATT,
         device_class=NumberDeviceClass.POWER,
         allowedtypes=AC | HYBRID | GEN4 | GEN5,
-        modbus_min=101,
+        modbus_min=100,
         entity_category=EntityCategory.CONFIG,
         entity_registry_enabled_default=False,
         icon="mdi:tune-variant",
@@ -2511,7 +2511,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         native_unit_of_measurement=UnitOfPower.WATT,
         device_class=NumberDeviceClass.POWER,
         allowedtypes=HYBRID | GEN4 | GEN5 | X1,
-        modbus_min=101,
+        modbus_min=100,
     ),
     SolaxModbusNumberEntityDescription(
         name="PeakShaving Discharge Limit 1",
@@ -2525,7 +2525,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         device_class=NumberDeviceClass.POWER,
         scale=0.1,
         allowedtypes=HYBRID | GEN4 | GEN5 | X3,
-        modbus_min=101,
+        modbus_min=100,
     ),
     SolaxModbusNumberEntityDescription(
         name="PeakShaving Discharge Limit 2",
@@ -2551,7 +2551,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         native_unit_of_measurement=UnitOfPower.WATT,
         device_class=NumberDeviceClass.POWER,
         allowedtypes=HYBRID | GEN4 | GEN5 | X1,
-        modbus_min=101,
+        modbus_min=100,
     ),
     SolaxModbusNumberEntityDescription(
         name="PeakShaving Discharge Limit 2",
@@ -2565,7 +2565,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         device_class=NumberDeviceClass.POWER,
         scale=0.1,
         allowedtypes=HYBRID | GEN4 | GEN5 | X3,
-        modbus_min=101,
+        modbus_min=100,
     ),
     SolaxModbusNumberEntityDescription(
         name="PeakShaving Discharge Limit 2",
@@ -4421,7 +4421,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         native_unit_of_measurement=UnitOfPower.WATT,
         device_class=SensorDeviceClass.POWER,
         allowedtypes=AC | HYBRID | GEN4 | GEN5,
-        modbus_min=101,
+        modbus_min=100,
         internal=True,
     ),
     SolaXModbusSensorEntityDescription(
@@ -5230,15 +5230,15 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         key="peakshaving_discharge_limit_1",
         register=0x153,
         allowedtypes=AC | HYBRID | GEN4 | GEN5 | X1,
-        modbus_min=101,
+        modbus_min=100,
         internal=True,
     ),
     SolaXModbusSensorEntityDescription(
         key="peakshaving_discharge_limit_1",
         register=0x153,
         scale=0.1,
         allowedtypes=AC | HYBRID | GEN4 | GEN5 | X3,
-        modbus_min=101,
+        modbus_min=100,
         internal=True,
     ),
     SolaXModbusSensorEntityDescription(
@@ -5252,15 +5252,15 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
         key="peakshaving_discharge_limit_2",
         register=0x154,
         allowedtypes=AC | HYBRID | GEN4 | GEN5 | X1,
-        modbus_min=101,
+        modbus_min=100,
         internal=True,
     ),
     SolaXModbusSensorEntityDescription(
         key="peakshaving_discharge_limit_2",
         register=0x154,
         scale=0.1,
         allowedtypes=AC | HYBRID | GEN4 | GEN5 | X3,
-        modbus_min=101,
+        modbus_min=100,
         internal=True,
     ),
     SolaXModbusSensorEntityDescription(
@@ -7692,7 +7692,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
             1: "Connected",
         },
         allowedtypes=AC | HYBRID | GEN4 | GEN5 | GEN6,
-        modbus_min=101,
+        modbus_min=100,
         entity_registry_enabled_default=False,
         entity_category=EntityCategory.DIAGNOSTIC,
     ),
@@ -7706,7 +7706,7 @@ def value_function_bms_2_max_charge(initval: int, descr: Any, datadict: dict[str
             1: "Connected",
         },
         allowedtypes=AC | HYBRID | GEN4 | GEN5 | GEN6,
-        modbus_min=101,
+        modbus_min=100,
         entity_registry_enabled_default=False,
         entity_category=EntityCategory.DIAGNOSTIC,
     ),

custom_components/solax_modbus/plugin_solax_ev_charger.py

@@ -1135,6 +1135,7 @@ def value_function_sync_rtc_evc(initval: Any, descr: Any, datadict: dict[str, An
         register=0x10,
         register_type=REG_INPUT,
         register_data_type=REGISTER_U32,
+        order32="big",  # device sends this u32 high-word-first (see holding twin 0x619)
         scale=0.1,
         native_unit_of_measurement=UnitOfEnergy.KILO_WATT_HOUR,
         device_class=SensorDeviceClass.ENERGY,