homeassistant-solax-modbus

(0.5.3a corrects typo in H34T detection)

Added support for the following Inverter:

X3-Hybrid Gen4 with Serial starting H34B

Added support for the following Inverter:

• X3-Hybrid Gen4 with Serial starting H34B

Added initial support for the X1-Mini.
The X1-Mini & the X3 MIC still have the possibility they don't work with the current Integration.

Gen3:

Following sensors have been set to disabled by default. Not all Gen3's contain them:

• inverter_model_number

X3 MIC / X1-Mini:

Added the following PV sensors (may or may not work, as I don't know if they are in the same location as Hybrid Inverters):

• pv_current
• pv_power
• pv_voltage

Gen3 & Gen4:

Following sensors have been added to X3:

• disch_cut_off_point_different
• disch_cut_off_voltage_grid_mode

Following sensors have been removed as they don't exist:

• battery_package_number
• battery_soh
• disch_cut_off_capacity_grid_mode

Before upgrading from 0.4.x I strongly suggest you remove the current Integration from the Integration page before upgrading!
When you re add the Integration following the code upgrade, if you name the Integration the same you shouldn't affect any sensor names or automations other than the mentioned name changes.

If the Integration fails to load with the following error in your log "unrecognized inverter type - serial number : {your_serial_number_here}" Please see https://github.com/wills106/homsassistant-solax-modbus/discussions/26 providing the details asked for.

Added the following Inverters:

Gen3 X1 3.7kW serial starting XRE3 (Should also work for 3.0kW)
Gen3 X3 serial starting H3DE or H3PE
Gen4 X1 7.5kW serial starting with H475

Untested:

Gen4 X1 6kW serial starting with H460 (I am assuming this based on the naming of the Gen4 X1 5kW & Gen4 X1 7.5kW)

X3 MIC 10kW based on serial starting MC10 this might still fail with "unrecognized inverter type - serial number : {your_serial_number_here}" as I believe the MIC Pro has the registers at a different location compared to the GenX Inverters.

Where to start?

This release has undertaken a massive code change. With the help of @infradom we now have the ability for the Integration to detect what Inverter you are using based on the Serial Number provided by User feedback from Discussion #26

All Tick boxes upon initial setup have been removed other than the EPS one.

As the Integration is now configured based on the Serial Number individual parameters can be defined. The Gen2 SK-SU sets the Charge / Discharge to 50A and the Gen2 SK-TL sets the same Charge / Discharge to the appropriate 100A. The X1AC configures as a Gen3 Inverter but drops the PV Sensors which are not present.

Before upgrading I strongly suggest you remove the current Integration from the Integration page before upgrading!
When you re add the Integration following the code upgrade, if you name the Integration the same you shouldn't affect any sensor names or automations other than the mentioned name changes.

If the Integration fails to load with the following error in your log "unrecognized inverter type - serial number : {your_serial_number_here}" Please see #26 providing the details asked for.

Notable Changes:

Gen2 - Gen4:

Renamed the following:

• battery_input_energy to battery_input_energy (Can be used in the Energy Dashboard)
• battery_output_energy to battery_output_energy (Can be used in the Energy Dashboard)

Following Sensors are removed:

• factoryname
• modulename

Added the following button:

• unlock_inverter_advanced (Unlocks the Inverter to the higher level)

Gen2:

Renamed the following

• today_s_yield to today_s_solar_energy (Todays Solar PV yield for Energy Dashboard)
• total_yield to total_solar_energy (Matches gen3 & gen4)
• today_s_yield (Now only on U50ED which is Solar PV + Battery Yield)

Gen3:

Added the following: (Hybrid only)

• sensor "battery_install_capacity"
• sensor "inverter_model_number"
• number "battery_minimum_capacity_gridtied"

Renamed the following: (Hybrid only)

• disch_cut_off_capacity_grid_mode to battery_minimum_capacity_gridtied

Removed the following sensors: (Hybrid & AC)

• discharger_start_time_x
• discharger_end_time_x

Pre-release:

(0.5.0b9ab Should fix Hybrid / AC detection for sensors)

All:

Reduced EPS Tick box down to one for both X1 & X3 when setting up Integration (EPS not available on AC Models)
Gen2:

Renamed:

"Total Yield" to "Total Solar Energy" as per gen3 & gen4
Gen3:

Added: (Hybrid only)

sensor "battery_install_capacity"
sensor "inverter_model_number"
number "battery_minimum_capacity_gridtied"
Renamed: (Hybrid only)

"disch_cut_off_capacity_grid_mode" to "battery_minimum_capacity_gridtied"
Removed: (Hybrid & AC)

"discharger_end_time_x"
Hopefully this is the last Pre-release before 0.5.0 ?

Pre-release:

(0.5.0b9a Should fix Gen2 & AC issue starting Integration)

All:

Reduced EPS Tick box down to one for both X1 & X3 when setting up Integration (EPS not available on AC Models)
Gen2:

Renamed:

"Total Yield" to "Total Solar Energy" as per gen3 & gen4
Gen3:

Added: (Hybrid only)

sensor "battery_install_capacity"
sensor "inverter_model_number"
number "battery_minimum_capacity_gridtied"
Renamed: (Hybrid only)

"disch_cut_off_capacity_grid_mode" to "battery_minimum_capacity_gridtied"
Removed: (Hybrid & AC)

"discharger_end_time_x"
Hopefully this is the last Pre-release before 0.5.0 ?

Pre-release:

Warning do not use on Gen2
Gen2 await 0.5.0b9a

All:

• Reduced EPS Tick box down to one for both X1 & X3 when setting up Integration (EPS not available on AC Models)

Gen2:

Renamed:

• "Total Yield" to "Total Solar Energy" as per gen3 & gen4

Gen3:

Added: (Hybrid only)

• sensor "battery_install_capacity"
• sensor "inverter_model_number"
• number "battery_minimum_capacity_gridtied"

Renamed: (Hybrid only)

• "disch_cut_off_capacity_grid_mode" to "battery_minimum_capacity_gridtied"

Removed: (Hybrid & AC)

• "discharger_end_time_x"

Hopefully this is the last Pre-release before 0.5.0 ?

Pre-release:
(0.5.0b8a fixes config flow from 0.5.0b8)

Removed redundant Tick boxes for configuration.
Only X1 EPS & X3 EPS remain.

Gen2:

Today's Yield has been correctly named Today's Solar Energy for Gen2 which is the Solar PV yield

Today's Yield is now only on U50ED which is Solar PV + Battery Yield

Pre-release:

Removed redundant Tick boxes for configuration.
Only X1 EPS & X3 EPS remain.

Gen2:

• Today's Yield has been correctly named Today's Solar Energy for Gen2 which is the Solar PV yield

• Today's Yield is now only on U50ED which is Solar PV + Battery Yield

Pre-release:

(0.5.0b7a corrects a typo in the Hybrid / AC Inverter detection, resulting in the AC (X1AC etc) Inverter showing PV sensors)

All Inverters:

Removed the following sensors:

factoryname
modulename
Added the following sensor:

group_read_test
Test to see if multiple Inverter connected via Modbus but not in Master/Slave setup report the other Inverters values or not?

Added the following button:

unlock_inverter_advanced
Might provide the Gen3 the ability to awaken the battery when the Inverter goes idle? (Press before "Battery Awaken" should only be needed once per power Cycle)

X1AC / X3AC

Hopefully added correct detection for the X1AC 3.6kWh

Upcoming in 0.5.0b8 Pre-release

Correct the Gen2 Sensors for Solar PV on Energy Dashboard

Pre-release:

All Inverters:

Removed the following sensors:

• factoryname
• modulename

Added the following sensor:

• group_read_test

Test to see if multiple Inverter connected via Modbus but not in Master/Slave setup report the other Inverters values or not?

Added the following button:

• unlock_inverter_advanced

Might provide the Gen3 the ability to awaken the battery when the Inverter goes idle? (Press before "Battery Awaken" should only be needed once per power Cycle)

X1AC / X3AC

Hopefully added correct detection for the X1AC 3.6kWh

Upcoming in 0.5.0b8 Pre-release

Correct the Gen2 Sensors for Solar PV on Energy Dashboard

Pre-release:

First attempt at complete setup other than EPS modes based off the Serial Number. (Thanks for everyone who submitted serial Numbers and Charge/Discharge Values over at https://github.com/wills106/homsassistant-solax-modbus/discussions/26)

I would recommend removing the Integration from the Integration page before updating.
If you rename it the same after re-adding it, your sensor names should not be affected.

On first try do not set any of the tick boxes for Machine type.
ie Gen2 X1 or Gen3 X3 etc, leave them all blank.

Charge / Discharge rate now set based on Serial.
So SK-SU & SK-TL no longer share 50A the SK-TL should now self configure to 100A

"Total Solar Energy" for the Gen2 is on by Default other than for the earlier U50EC which is removed from the Integration.
"Total Solar Energy" Can now be used for the Energy Dashboard on the Gen2

Gen2 Users should now have a complete set of sensors for the Energy Dashboard other than the U50EC

X1-AC has been setup the same as a normal Gen3 X1 for now. All the PV related sensors will either show 0 or Unknown. This will be later cleaned up.

If the Integration fails to load with the following error in your log "unrecognized inverter type - serial number : {your_serial_number_here}"
Please see https://github.com/wills106/homsassistant-solax-modbus/discussions/26 providing the details asked for.

Massive thanks to @infradom for helping in achieving my goal of moving away from Tick Boxes on Integration Setup.
I really appreciate all the help you have provided 🥇

Pre-release:

Attempt to add "Total Solar Energy" to the Gen2 for use in the Energy Dashboard.

"grid_power_s" & "grid_frequency_s" should still read correct for X1 & X3 on the Gen3 & Gen4 Inverters...

Pre-release:

Corrected Gen2 Today's Yield

Pre-release:

Second half of code restructure all the buttons, number, selects & sensors appear to be exactly the same as before.

Code change will allow easier reuse of code between Invert Generations and types.
It will also allow us to taylor the values to individual Inverter Types in the future.

Pre-release:

Fix the following buttons due to formatting error:

• battery_awaken
• unlock_inverter

Pre-release version:

Code restructure to remove the duplication of code used between the Various Generations and sub models of Inverters.

At the moment there should be no difference in operation, but going forward it should allow for more control over sub models. Ie the charge / discharge between the two Gen2 Inverters SK-TL & SK-SU.

Code updated which should allow multiple Inverters to coexist on the same ip address when using a Waveshare for example.

DON'T USE THIS VERSION USE V2!!!

Corrected wrongly formatted DE translation json