🇬🇧 English | 🇩🇪 Deutsch

HMIP HCU Plugin: Sun2000 / FusionSolar

📦 Download latest plugin .tar.gz — install via HCUweb → Developer mode → Plugins → Install from file.

🆘 Stuck? See docs/TROUBLESHOOTING.md — covers the SDongle Modbus-TCP setup, dongle firmware bugs, the FusionSolar app paths, and how to escalate to Huawei support.

GitHub: https://github.com/fabiorenner-hub/hmip-hcu-fusionsolar

A Homematic IP HCU plugin that reads (and where supported, controls) a Huawei Sun2000 PV system locally via Modbus TCP, with optional FusionSolar cloud fallback. Includes an extensive debug dashboard.

Support

If this plugin is useful to you, please consider a small donation — it helps me keep the lights on while building more HCU plugins: Donate via PayPal.

Install on your HCU

1. Download hmip-hcu-fusionsolar-<version>.tar.gz from the Releases.
2. In HCUweb open Developer mode → Plugins → Install from file and upload it.
3. Configure the plugin and (optionally) open the local debug dashboard at http://<hcu-ip>:8088.

Build it yourself

./build.ps1   # Windows

chmod +x build.sh
./build.sh    # macOS / Linux

What it does

• Modbus TCP polling of the Sun2000 inverter, LUNA2000 battery and DTSU666-H smart meter.
• Connect API integration: virtual INVERTER, BATTERY, GRID_CONNECTION_POINT, ENERGY_METER devices.
• Optional virtual SWITCH devices for battery forced-charge / forced-discharge.
• Optional FusionSolar cloud fallback (read-only).
• HCUweb config page with grouped properties.
• Local debug dashboard on port 8088 with live values, register browser, write-register tool, energy-flow diagram.

Troubleshooting

Having trouble? Plugin connects to the dongle but reads time out, or values stay at 0 W? Connection drops every 10 s with socket closed by peer?

→ See docs/TROUBLESHOOTING.md for a structured walkthrough (DE + EN), including dongle firmware bugs, the FusionSolar app settings that matter, and how to escalate to Huawei support.

Author

Issued by Fabio Renner.

Third-party components

• modbus-serial by Yaacov Zamir and contributors — Modbus client for Node.js (ISC).
• express — HTTP server for the local debug dashboard (MIT).
• Sun2000, LUNA2000 and the FusionSolar cloud are products of Huawei Technologies; this plugin is not affiliated with or endorsed by Huawei. The DTSU666-H is a CHINT meter exposed via the Huawei smart-meter Modbus map.
• Built against the Homematic IP Connect API 1.0.1 by eQ-3.

License

Apache-2.0