homeassistant-solax-modbus

WARNING Integration version 2024.09.x is only compatible with HA 2024.9.0 and newer

General:

• Fixed "KeyError: 'support-battery'" #968 #976 #977 #1015 #1054

WARNING Integration version 2024.09.1 is only compatible with HA 2024.9.0 and newer

Sofar:

• Correctly defined HYD5...8KTL-3P with Serial starting 'SH1' #1034

SolaX:

• Added Inverter rating to Device info panel
• Added X3 Ultra Inverter with Serial starting 'H3BF' https://github.com/wills106/homeassistant-solax-modbus/discussions/520#discussioncomment-10595436
• Updated X3 Ultra to 60A for Charge / Discharge #1044

WARNING Integration version 2024.09.1 is only compatible with HA 2024.9.0 and newer

General:

• Corrected Detect incorrect local data file content #1037 by @PatrikTrestik in https://github.com/wills106/homeassistant-solax-modbus/pull/1038
• Corrected SLEEPMODE_LASTAWAKE #980 by @KestasG in https://github.com/wills106/homeassistant-solax-modbus/pull/1036
• Corrected "POWER_VOLT_AMPERE_REACTIVE deprecated from HA Core 2025.9" #1042 Warning Integration no longer compatible with HA 2024.8.x and older

Growatt TL-XH:

• Corrected Discharging rate and SOC #1022 by @TonyMathiesen in https://github.com/wills106/homeassistant-solax-modbus/pull/1026

Solis:

• Added support for Inverters with Serial starting '160F4' https://github.com/wills106/homeassistant-solax-modbus/discussions/521#discussioncomment-10542151
• Added support for MPPT3 & MPPT4 for Inverters with Serial starting '1033' #1043 Warning may cause other Inverters with Serial starting '1033' to stop being detected. Please report with the next two digits and Inverter size and number of MPPT's available. Report in #1043
• Corrected button functions #1028 @timstephenson20 in https://github.com/wills106/homeassistant-solax-modbus/pull/1032

SolaX EV Charger:

• Corrected value mapping "battery_to_ev_charger" #924 by @PatrikTrestik in https://github.com/wills106/homeassistant-solax-modbus/pull/1033

SolaX Hybrid Gen4 & Gen5:

• Added "Battery Voltage Cell Difference" #1041

General:

• Corrected Inverter Inverter Inverter... #987 #1023

Growatt MOD & TL-XH: #1025

• Added:

  • EMS Discharging Rate
  • EMS Discharging Stop SOC
  • EMS Charging Rate
  • EMS Charging Stop SOC
  • EPS Switch (for MOD series)
  • Total Grid Export (for MOD series)

• Corrected:

  • Typo in naming of: bettery_combined_power to battery_combined_power
  • Battery Voltage change scale to match APX HV specs range 600-980V for system module
  • Battery Current adds REGISTER_S16 to correct value.

• Removed:

  • "Battery First Maximum SOC" & "Charger Upper SOC" (Replaced by EMS controls above)
  • "Limit Grid Export" (Priority mode select) as this is not for changing run mode for TL-XH.
  • "Total Load" as not for TL-XH
  • Commented out register 3000 for “Inverter State” and “Run mode” until issue is fixed #791

Sofar:

• Added missing auto_block_ignore_readerror = True should allow Integration to carry on reading Registers if a read error occurs on a register
• Set "Passive Desired Grid Power" steps to 10 #1020

SolaX Hybrid Gen4:

• Corrected scale of "EPS Yield Total" #864 #1024

Solis:

• Added missing auto_block_ignore_readerror = True should allow Integration to carry on reading Registers if a read error occurs on a register

Swatten:

• Added missing auto_block_ignore_readerror = True should allow Integration to carry on reading Registers if a read error occurs on a register

Growatt:

• Removed "Inverter State" & "Run Mode" from MOD TL-XH #979

Growatt:

• Removed "Inverter Module" #831 #971

General:

• Removed unused parameter for Serial connections #1008 #1013

General:

• Removed unneeded await self.async_connect() #993 #1006

Solinteg:

• Fixed value_function_house_load where using Meter 2 #1005

SolaX:

• Fixed X3-Ultra Export control scaling https://github.com/wills106/homeassistant-solax-modbus/issues/998#issuecomment-2295229198 #1004

Warning Potential Breaking Change if moving from pre 2024.08.x to 2024.08.x

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

General:

• Removed retry loop for client.connect
• Increased Modbus retries from default 3 to 6

SolaX:

• Added 3rd MPPT for X1-IES (Gen5 Hybrid)
• Added max_currents for X1-IES, X3-IES & X3-Ultra
• Added support for X3-IES (Gen5 Hybrid)
• Increased "Config Max Export" to 60kW

Warning Potential Breaking Change if moving from pre 2024.08.x to 2024.08.x

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

General:

• Increase Modbus connection retries from 3 to 6

SolaX:

• Added support for X1-IES (Gen5 Hybrid)
• Added support for X1-SMART-G2 with 3rd MPPT
• Added "Lock State" to X1 & X3 string Inverters (Not Mega / Forth)

Warning Potential Breaking Change if moving from pre 2024.08.x to 2024.08.x

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

Sofar Old:

• Added serial for AZZURRO 1PH 3000TL-V3 #981

SolaX Hybrid Gen2:

• Corrected "Today's Solar Energy" & "Total Solar Energy"

SolaX X3 MIC:

• Added Number "Active Power Limit" & Select "Q Curve" (Untested)

Solinteg:

• Fixed initialisation + other small changes #982

Warning Potential Breaking Change if moving from pre 2024.08.x to 2024.08.x

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

SolaX Mega Forth:

• Corrected missing MPPT's #944

Warning Potential Breaking Change if moving from pre 2024.08.x to 2024.08.x

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

SolaX Mega Forth:

• Added support for MPPT 5 - 12 #944
  Serial Number detection might need correcting for 75kW and above Inverters

Warning Potential Breaking Change if moving from pre 2024.08.x to 2024.08.x

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

Growatt:

• Corrected duplicate values #791
• Corrected name changes from 2024.08.1

SolaX Mega Forth:

• Corrected duplicate values #944

Warning Potential Breaking Change if moving from pre 2024.08.x to 2024.08.x

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

Growatt:

• Added "Inverter State" and "Run Mode" to TL3-X / TL3-XH #791

SolaX Mega Forth:

• Further work on Mega / Forth #944

Warning Potential Breaking Change

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

SolaX:

• Corrected duplicate name #975

Warning Potential Breaking Change

Due to a number of changes to the config_flow and the way Device info is populated it is recommended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

General:

• Changed Drop-Down Time selectors from 15m to 5m Intervals.
• Corrected "Detected blocking call to open inside the event loop" #920 #946
• Corrected "Detected code that calls async_forward_entry_setup" #948
• Wrap ConnectionException and ModbusIOException in a HomeAssistantError #937 #938

Sofar:

• Added following to scangroup_fast: #915
  (Allows scanning at a faster rate than default)
  • "Active Power PCC Total"
  • "Voltage L1"
  • "Voltage L2"
  • "Voltage L3"
  • "Off-Grid Voltage L1"
  • "Off-Grid Voltage L2"
  • "Off-Grid Voltage L3"
  • "PV Power 1"
  • "PV Power 2"
  • "Battery Power 1"
  • "Battery Power 2"
• Add battery pack info as extra devices (BTS-5k) #926

SolaX:

• Added support for X3-PRO G2
• Altered Export Limit scale for more Inverters with serial starting 'H3UE' #922
• Corrected Device info for multiple Inverters #934
• Device info now has live firmware versions #909 #913
• Initial support for X3 Mega Inverters #944

Warning Potential Breaking Change

Due to a number of changes to the config_flow and the way Device info is populated it is recomended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

Beta 1:

General:

• Changed Drop-Down Time selectors from 15m to 5m Intervals.
• Corrected "Detected blocking call to open inside the event loop" #920 #946
• Wrap ConnectionException and ModbusIOException in a HomeAssistantError #937 #938

Sofar:

• Added following to scangroup_fast: #915
  (Allows scanning at a faster rate than default)
  • "Active Power PCC Total"
  • "Voltage L1"
  • "Voltage L2"
  • "Voltage L3"
  • "Off-Grid Voltage L1"
  • "Off-Grid Voltage L2"
  • "Off-Grid Voltage L3"
  • "PV Power 1"
  • "PV Power 2"
  • "Battery Power 1"
  • "Battery Power 2"
• Add battery pack info as extra devices (BTS-5k) #926

SolaX:

• Added support for X3-PRO G2
• Altered Export Limit scale for more Inverters with serial starting 'H3UE' #922
• Corrected Device info for multiple Inverters #934
• Device info now has live firmware versions #909 #913
• Initial support for X3 Mega Inverters #944

Beta 2:

Resolved #948

Beta 3:

Corrected many entity name changed from Beta 1&2 on SolaX Inverters #949

Beta 4:

Corrected today_s_import_energy on SolaX Hybrid Inverters Gen3-5 and corrected today_s_yield on SolaX Hybrid Gen2 #949

Beta 5:

SolaX X1 Air:

• Added serial

SolaX X3 MIC Pro:

• Made serial detection more generic

SolaX X3 MEGA / FORTH G2:

• Attempt to Support Inverter

Warning Potential Breaking Change

Due to a number of changes to the config_flow and the way Device info is populated it is recomended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

Beta 1:

General:

• Changed Drop-Down Time selectors from 15m to 5m Intervals.
• Corrected "Detected blocking call to open inside the event loop" #920 #946
• Wrap ConnectionException and ModbusIOException in a HomeAssistantError #937 #938

Sofar:

• Added following to scangroup_fast: #915
  (Allows scanning at a faster rate than default)
  • "Active Power PCC Total"
  • "Voltage L1"
  • "Voltage L2"
  • "Voltage L3"
  • "Off-Grid Voltage L1"
  • "Off-Grid Voltage L2"
  • "Off-Grid Voltage L3"
  • "PV Power 1"
  • "PV Power 2"
  • "Battery Power 1"
  • "Battery Power 2"
• Add battery pack info as extra devices (BTS-5k) #926

SolaX:

• Added support for X3-PRO G2
• Altered Export Limit scale for more Inverters with serial starting 'H3UE' #922
• Corrected Device info for multiple Inverters #934
• Device info now has live firmware versions #909 #913
• Initial support for X3 Mega Inverters #944

Beta 2:

Resolved #948

Beta 3:

Corrected many entity name changed from Beta 1&2 on SolaX Inverters #949

Beta 4:

Corrected today_s_import_energy on SolaX Hybrid Inverters Gen3-5 and corrected today_s_yield on SolaX Hybrid Gen2 #949

Warning Potential Breaking Change

Due to a number of changes to the config_flow and the way Device info is populated it is recomended to remove the Inverter(s) from the Integration before updating, restarting HA and adding the Inverter(s) back in again
Naming the Inverter(s) exactly the same as before will retain their history

Beta 1:

General:

• Changed Drop-Down Time selectors from 15m to 5m Intervals.
• Corrected "Detected blocking call to open inside the event loop" #920 #946
• Wrap ConnectionException and ModbusIOException in a HomeAssistantError #937 #938

Sofar:

• Added following to scangroup_fast: #915
  (Allows scanning at a faster rate than default)
  • "Active Power PCC Total"
  • "Voltage L1"
  • "Voltage L2"
  • "Voltage L3"
  • "Off-Grid Voltage L1"
  • "Off-Grid Voltage L2"
  • "Off-Grid Voltage L3"
  • "PV Power 1"
  • "PV Power 2"
  • "Battery Power 1"
  • "Battery Power 2"
• Add battery pack info as extra devices (BTS-5k) #926

SolaX:

• Added support for X3-PRO G2
• Altered Export Limit scale for more Inverters with serial starting 'H3UE' #922
• Corrected Device info for multiple Inverters #934
• Device info now has live firmware versions #909 #913
• Initial support for X3 Mega Inverters #944

Beta 2:

Resolved #948

Beta 3:

Corrected many entity name changed from Beta 1&2 on SolaX Inverters #949