Initiale Konfiguration
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>
This commit is contained in:
@@ -0,0 +1,169 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user