# 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.