A native Home Assistant integration for Growatt solar inverters using direct Modbus RTU/TCP communication. Real-time data straight from your inverter — no cloud, no ShineWiFi, no dependency on Growatt's servers.
The documentation site covers supported models, sensor reference, inverter controls, energy dashboard setup, troubleshooting, and developer guides.
- Open HACS → ⋮ menu → Custom repositories
- Add URL
https://github.com/0xAHA/Growatt_ModbusTCP, category: Integration - Search "Growatt Modbus" in HACS → Download
- Restart Home Assistant
- Settings → Devices & Services → Add Integration → search "Growatt Modbus"
- Download the latest release and extract
- Copy
growatt_modbus/intoconfig/custom_components/ - Restart Home Assistant and add via Settings → Devices & Services
The setup wizard runs auto-detection automatically for VPP-capable inverters. For legacy models, select the profile manually based on your inverter's power range.
| Parameter | TCP | Serial |
|---|---|---|
| Host / Device | IP address (e.g. 192.168.1.100) |
Path (e.g. /dev/ttyUSB0) |
| Port / Baudrate | 502 |
9600 |
| Slave ID | 1 (usually) |
1 (usually) |
- Issues & bug reports: GitHub Issues
- Community: Home Assistant Forum
MIT License — see LICENSE
Made with ☀️ and ☕ by @0xAHA
The following community members contributed live hardware testing, field diagnostics, and official protocol documentation that directly shaped this integration:
| Contributor | Hardware | Contribution |
|---|---|---|
| @Wojak129 | WIT 15KTL3 + DIY 32 kWh battery (EVE 314Ah / JK BMS) | DTC 5603 field-confirmation, VPP register scanning, safety limit discovery (reg 30201 fault trigger), official VPP protocol documentation obtained from Growatt service |
