Homebridge Plugin for Sungrow SG Series Inverters

This Homebridge plugin leverages Modbus protocol with Sungrow AES encryption support to display on/off state and current power of your Sungrow SG inverters.

✨ New in v0.0.2

• ✅ Sungrow AES Encryption Support - Works with newer Sungrow inverters that require encrypted Modbus communication
• ✅ Automatic encryption detection and key exchange
• ✅ Backward compatible with older non-encrypted inverters
• ✅ Connect-on-demand pattern - Connects, reads, and disconnects each poll (no persistent connection)
• ✅ Test harness included for connection testing

After you've got your homebridge up and running:

npm i -g homebridge-sungrow

Then edit the config.json of your homebridge. Please find below an example -

{
  "accessory": "SungrowInverter",
  "name": "My Solar Panels",
  "ipAddress": "xxx.xxx.xxx.xxx",
  "port": 502,
  "model": "SG2KTL-S",
  "serialNumber": "Axxxxxxxxx",
  "refreshInterval": 1
}

• ipAddress - You can find it from the router which you connect your inverter's wifi dongle to.
• port - The default for Sungrow wifi dongle is 502.
• model - Whatever you like ...
• serialNumber - Whatever you like ...
• refreshInterval - The polling interval in minutes.

The power data is pretty much real-time because it's from the inverter directly. Please note Apple Home app can only show on/off state. You'll need EVE to view the power data and set interesting automation rules. For example - it's raining hard and quite dark during the daytime. The power of the inverter is low and you can automate your lighting based on it.

One thing tricky here - After sunset, the inverter enters standby mode and stops generating power. The accessory will be switched off automatically when power drops to zero. You can setup a daily automation rule to switch it back on about 30min after sunrise when the inverter starts generating power again.

Testing Your Connection

Before using with Homebridge, test your connection:

# Test with your inverter IP (works best during daylight hours)
node test-harness.js --ip YOUR_INVERTER_IP --duration 30 --interval 5

# You should see:
# - "Sungrow encryption enabled" (confirms encryption is working)
# - Power readings in Watts during daytime
# - The accessory works with register 5030 for SG5K-D models

This is my second homebridge plugin. Please pardon me on the immature code. Only got a few hours to work on it.

Thank all the relevant package developers who made this little plugin possible.