An easy-to-use YAML-based integration for several Sungrow inverters for Home Assistant.
After five years of continuous development with maintained backwards compatibility, this integration reached its limits. With the help of @theunknown86 and several others, this yaml-based integration was rebased on a better and more flexible codebase. It still remains yaml-based and not a "full" Home Assistant integration, but can now support different Sungrow models with their specific features ("quirks"). As long there is no "real integration" available, I will continue to maintain the new yaml file.
The migration to the new version requires a few manual steps, see migration guide.
The old version will be archived in the separate branch 2025-legacy. The "dev"-branch which was tested now by several users is now the "main"-branch.
- 1. Overview
- 2. Documentation
- 3. Support
- 4. Visual impressions
- 5. Tested configurations
- 6. Status and future work
- 7. Contributions
- 8. Related work
This integration lets you gather sensor data and control the EMS (Energy Management System) of a wide range of Sungrow inverters, including, but not limited to: SH3.6RS, SH4.6RS, SH5.0RS, SH5.0RT, SH6.0RS, SH8.0RT, SH8.0RT-V112, SH6.0RT, SH10RT, SH10RT-V112, SH5K-20, SH3K6, SH4K6, SH5K-V13, SH5K-30. A battery is not required, but several sensors will not be available without one.
If available on your inverter, connect the inverter to the Home Assistant network using the inverters internal LAN port. The WiNet-S Ethernet port and the WiNet-S Wi-Fi also work, but sometimes slightly slower and with some restrictions imposed by Sungrow on which data is available.
My personal time is quite limited, but there are several nice people here who like to help.
If you need any kind of assistance, you have three options:
-
Use the GitHub discussions.
-
Join the Discord server
.
-
Only if code-related (bugs / contributions): Open a GitHub issue or create a pull request.
I have a Sungrow SH10.RT inverter and a PylonTech Force H1 battery with 14.4 kWh, updating frequently to the latest available firmware and Home Assistant. I try to thoroughly test features before releasing them, but I cannot test everything (e.g., backup capabilities, DO-related, sungrow-battery-specifics ...)
The Modbus register mapping is based on Sungrow's official Modbus communication protocol specification. These documents are available from Sungrow support. They are only updated sporadically. If you have a newer version, let me know in the GitHub discussions!
TI_20251119_Communication_Protocol_of_Residential_Hybrid_Inverter_V1.1.11_EN.pdf
TI_20230117_Communication.Protocol.of.Residential.and.Commerical.PV.Grid-connected.Inverter_V1.1.53_EN.pdf
This is meant to be a simple, straight-forward YAML-based integration. If you need more than this, I recommend having a look at other projects:
We are happy to share our experiences - feel encouraged to share yours with us, too!
If you have any questions, feature requests, found any bugs or have some hints how to update the documentation, a low-threshold way is to join the 
- HA Modbus Manager
- Sungrow Wallbox
- Sungrow Logger 1000a
- Chint DTSU666 Modbus
- EVCC
- Sungrow document collections by bohdan-s and by Gnarfoz
Thanks to all the people, who are actively contributing to this project! Special thanks to Gnarfoz, Louisbertelsmann, dylan09, elektrinis and many more!