retr0
cc67e9843c
ESPHome-Configs für Growatt MIC 1500 TL-X und SPH 5000 TL3-BH-UP mit Modbus-RTU Integration über den Growatt SuniStick. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
170 lines
5.5 KiB
Markdown
170 lines
5.5 KiB
Markdown
# 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](./Growatt%20MIC%201500%20TL-X/) | String-WR | 1-phasig | Nein | Getestet ✓ |
|
||
| [Growatt SPH 5000 TL3-BH-UP](./Growatt%20SPH%205000%20TL3/) | 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](https://esphome.io) 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:
|
||
|
||
```yaml
|
||
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)
|
||
|
||
```bash
|
||
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](./Growatt%20SPH%205000%20TL3/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.
|