Octopus.Energy 🐙 referral code. You get £50 credit for joining and I get £50 credit.
SolaX Power Modbus custom_component for Home Assistant Support Modbus over RS485 & TCP
You can have multiple instances of this Integration, just change the default Prefix from SolaX to something else. Ie SolaX Main or SolaX Southwest
Supports:
- Gen2 Hybrid
- Gen3 Hybrid
- Gen4 Hybrid
Gen2, Gen3 & Gen4
- Battery Awaken
- Charge / Discharge rate of battery
- Charger Start / End times
- Charger Use Mode
Gen2 & Gen3
- Allow Grid Charge
- Charge periods in Force Time Use Mode
- Min Battery Capacity
Gen3 & Gen4
- Sensors support the "Energy" Dashboard in 2021.08.x and onwards.
Gen3
- ForceTime Period 1 Max Capacity
- ForceTime Period 2 Max Capacity
Gen4
- Backup Discharge Min SOC
- Backup Nightcharge Upper SOC
- Charge / Discharge rate of battery
- Charge and Discharge Period2 Enable
- Discharger Start / End time
- Export Control User Limit
- Feedin Discharge Min SOC
- Feedin Nightcharge Upper SOC
- Manual Mode Select
- Selfuse Discharge Min SOC
- Selfuse Night Charge Enable
- Selfuse Nightcharge Upper SOC
Untested: Non Hybrid Models ie Solar PV only
For further Documentation please refer to the Wiki
Some of the topics that will be covered (WIP):
- Gen2 & Gen3 Modes of Operation
- Gen4 Modes of Operation
- Gen4 Connection methods
Preferred Option
You can add this custom_component directly through HACS, if you have HACS installed on your Home Assistant instance.
Alternatively
Download the zip / tar.gz from the release page.
- Extract the contents of solax_modbus into to your home-assistant config/custom_components folder.
If you manually clone the repository you may end up mid code update!
Copy the folder and contents of solax_modbus into to your home-assistant config/custom_components folder.
Post Installation
After reboot of Home-Assistant, this integration can be configured through the integration setup UI
Any manual updates / HACS updates require a restart of Home Assistant to take effect.
- Any major changes might require deleting the Integration from the Integration page and adding again. If you name the Integration exactly the same including the Area if set, you should retain the same entity naming bar any name changes in the release. (Refer to the release notes for any naming change)
Inverter never connected to the Cloud / possibly after a firmware update:
- If you can read values, but unable to adjust select / number you need to press the "Unlock Inverter" button.
- Might need performing again following a full Power Cycle
- You can only have one connection to the inverter, so you can't use this and one of my yaml packages at the same time for writing to registers.
- Possible Warnings about blocking call in the event loop (in systems with serial modbus connection).
- Please check the Todo List under discussions for other known issues and what's being worked on.
- You need to manually add select and number entries to your lovelace card if you manually control your front end.
Gen2, Gen3 & Gen4
Entities to manually add
- button.solax_battery_awaken
- button.solax_unlock_inverter
- number.solax_battery_charge_max_current
- number.solax_battery_discharge_max_current
- select.solax_charger_end_time_1
- select.solax_charger_end_time_2
- select.solax_charger_start_time_1
- select.solax_charger_start_time_2
- select.solax_charger_use_mode
Gen2 & Gen3
Entities to manually add
- number.solax_battery_minimum_capacity
- select.solax_allow_grid_charge
- select.solax_discharger_start_time_1
- select.solax_discharger_end_time_1
- select.solax_discharger_start_time_2
- select.solax_discharger_end_time_2
Gen3
Entities to manually add
- number.solax_forcetime_period_1_max_capacity
- number.solax_forcetime_period_2_max_capacity
Gen4
Entities to manually add
- number.solax_backup_discharge_min_soc
- number.solax_backup_nightcharge_upper_soc
- number.solax_charge_discharge_rate_of_battery
- number.solax_export_control_user_limit
- number.solax_feedin_discharge_min_soc
- number.solax_feedin_nightcharge_upper_soc
- number.solax_selfuse_discharge_min_soc
- number.solax_selfuse_nightcharge_upper_soc
- select.solax_charge_and_discharge_period2_enable
- select.solax_discharger_end_time_1
- select.solax_discharger_end_time_2
- select.solax_discharger_start_time_1
- select.solax_discharger_start_time_2
- select.solax_manual_mode_select
- select.solax_selfuse_night_charge_enable