Growatt Wechselrichter → Home Assistant (ohne Cloud)

Dieses Repository enthält ESPHome-Konfigurationen für Growatt Wechselrichter, die über den Growatt SuniStick (ESP8266) per Modbus RTU direkt in Home Assistant OS integriert werden — vollständig ohne die Growatt-App oder Cloud.

---

Funktionsprinzip

PV-Anlage
    │
[Growatt Wechselrichter]
    │  RS485 / Modbus RTU
[Growatt SuniStick]  ← ESP8266 mit ESPHome-Firmware
    │  Wi-Fi
[Home Assistant OS]

Der SuniStick steckt im RS485-Port des Wechselrichters und kommuniziert per Modbus RTU (115200 Baud). ESPHome liest die Register aus und stellt sie als Sensoren in HAOS bereit. Keine Cloud, keine App, kein Intermediär.

---

Unterstützte Modelle

Modell	Typ	Phasen	Batterie	Status
Growatt MIC 1500 TL-X	String-WR	1-phasig	Nein	Getestet ✓
Growatt SPH 5000 TL3-BH-UP	Hybrid-WR	3-phasig	Ja	Getestet ✓

Andere Growatt-Modelle verwenden teilweise dieselben Register — die Konfigurationen können als Ausgangsbasis dienen, die Adressen müssen aber anhand des jeweiligen Datenblatts geprüft werden.

---

Hardware: Growatt SuniStick

Der SuniStick ist ein offizielles Growatt-Zubehör und enthält einen ESP8266-Chip (Board: esp07s). Er wird direkt in den RS485-Port des Wechselrichters gesteckt.

UART-Pinbelegung (intern):

• TX: GPIO 1
• RX: GPIO 3
• Baud: 115200

LED-Pinbelegung:

• Blau: GPIO 16
• Grün: GPIO 0
• Rot: GPIO 2

---

SuniStick flashen

Der SuniStick muss einmalig mit ESPHome-Firmware geflasht werden. Danach sind OTA-Updates möglich.

Voraussetzungen

• ESPHome installiert (z.B. als HAOS Add-on oder per pip)
• USB-zu-Serial-Adapter (3,3 V!) zum erstmaligen Flashen
• SuniStick geöffnet (4 Schrauben) und mit dem Adapter verbunden

Verkabelung zum Flashen

SuniStick	USB-Serial-Adapter
TX	RX
RX	TX
GND	GND
3,3 V	3,3 V

GPIO 0 muss beim Start auf GND gezogen werden (Flash-Modus).

YAML vorbereiten

1. Passende YAML aus diesem Repository kopieren
2. Die vier markierten Platzhalter durch eigene Werte ersetzen:

api:
  encryption:
    key: "HIER_API_KEY_EINTRAGEN"       # In der ESPHome-UI auf "Generate" klicken → Key kopieren

ota:
  - platform: esphome
    password: "HIER_OTA_PASSWORT_EINTRAGEN"  # Frei wählbar, z.B. "meinOTApasswort123"

wifi:
  ssid: "HIER_WLAN_NAME_EINTRAGEN"          # Genauer WLAN-Name (Groß-/Kleinschreibung beachten)
  password: "HIER_WLAN_PASSWORT_EINTRAGEN"  # WLAN-Passwort
  ap:
    password: "HIER_HOTSPOT_PASSWORT_EINTRAGEN"  # Min. 8 Zeichen — für den Notfall-Hotspot

Der API-Key wird in der ESPHome-UI automatisch generiert, wenn man eine neue Config anlegt. Alternativ kann man einen beliebigen 32-Byte Base64-String verwenden.

Flashen (Erstinstallation)

esphome run growatt-mic-1500.yaml

oder über die ESPHome-Web-UI im HAOS Add-on.

Nach dem ersten Flash sind alle weiteren Updates per OTA über Wi-Fi möglich — kein Aufschrauben mehr nötig.

---

Integration in Home Assistant

Nach dem ersten Start verbindet sich ESPHome automatisch mit HAOS. Home Assistant erkennt das Gerät per mDNS und zeigt eine Benachrichtigung zur Integration an.

Einstellungen → Geräte & Dienste → ESPHome → Gerät hinzufügen

Alle konfigurierten Sensoren erscheinen danach automatisch als Entitäten.

Energie-Dashboard

Für das HA Energie-Dashboard werden kumulative kWh-Sensoren benötigt (state_class: total_increasing). Diese sind in den Konfigurationen bereits korrekt gesetzt.

Einstellungen → Energie → Konfigurieren:

Dashboard-Feld	Sensor (SPH)	Sensor (MIC)
Solar-Erzeugung	Energy Total	EnergyTotal
Netzbezug	Energy Import Total	—
Netzeinspeisung	Energy Export Total	—
Batterie laden	Battery Charge Total	—
Batterie entladen	Battery Discharge Total	—

---

Modbus-Adressen: Modellunterschiede

Growatt verwendet je nach Wechselrichter-Serie unterschiedliche Register-Maps. Die Adressen aus einer Config lassen sich nicht 1:1 auf andere Modelle übertragen.

Serie	Typische Modelle	Besonderheit
MIC	MIC 600–2000 TL-X	1-phasig, kein Batterie-Bereich
MIN	MIN 2500–6000 TL-XH	1-phasig, Hybrid
SPH	SPH 3000–6000 TL3-BH	3-phasig, Hybrid, Batterie im 1000er-Bereich
MOD	MOD 5000–15000 TL3-XH	3-phasig, Hybrid, abweichende Map

---

Struktur des Repositories

.
├── README.md                          ← Diese Datei
├── Growatt MIC 1500 TL-X/
│   └── Growatt MIC 1500 TL-X.yaml    ← ESPHome Config
└── Growatt SPH 5000 TL3/
    ├── Growatt SPH 5000 TL3-BH-UP.yaml
    └── README.md                      ← Modbus-Registertabelle

---

Beitragen

Wer eine eigene Growatt-Config ergänzen möchte:

1. Neuen Ordner nach Schema Growatt MODELL/ anlegen
2. YAML-Config mit korrekten Modbus-Adressen (aus dem offiziellen Datenblatt oder verifiziert) einfügen
3. README mit Registertabelle dazulegen (Vorlage: Growatt SPH 5000 TL3/README.md)

---

Lizenz

Frei verwendbar und anpassbar. Passwörter, API-Keys und WLAN-Daten sind in allen Configs durch sprechende Platzhalter (HIER_..._EINTRAGEN) markiert — diese müssen vor dem Einsatz individuell gesetzt werden.