# Growatt SPH 5000 TL3-BH-UP — ESPHome Konfiguration

Modbus-RTU Integration des Growatt SPH 5000 TL3-BH-UP (3-phasiger Hybrid-Wechselrichter mit Batterie) über einen Growatt SuniStick mit ESPHome-Firmware.

---

## Modbus-Register Übersicht

Alle Register sind **Input Register** (Modbus Funktionscode 04, `register_type: "read"`).  
Modbus-Adresse des Geräts: `0x01`

### PV Eingang

| Name | Adresse | Typ | Multiplikator | Einheit |
|------|---------|-----|---------------|---------|
| PV1 Voltage | 3 | U_WORD | 0.1 | V |
| PV1 Current | 4 | U_WORD | 0.1 | A |
| PV1 Power | 5 | U_DWORD | 0.1 | W |
| PV2 Voltage | 7 | U_WORD | 0.1 | V |
| PV2 Current | 8 | U_WORD | 0.1 | A |
| PV2 Power | 9 | U_DWORD | 0.1 | W |

### AC Ausgang / Netz

| Name | Adresse | Typ | Multiplikator | Einheit |
|------|---------|-----|---------------|---------|
| AC Output Power Total | 35 | U_DWORD | 0.1 | W |
| Grid Frequency | 37 | U_WORD | **0.01** | Hz |
| Grid Voltage L1 | 38 | U_WORD | 0.1 | V |
| Grid Current L1 | 39 | U_WORD | 0.1 | A |
| Grid Voltage L2 | 42 | U_WORD | 0.1 | V |
| Grid Current L2 | 43 | U_WORD | 0.1 | A |
| Grid Voltage L3 | 46 | U_WORD | 0.1 | V |
| Grid Current L3 | 47 | U_WORD | 0.1 | A |

> **Wichtig:** Grid Frequency hat Multiplikator `0.01` — der Rohwert ist z.B. `5000` = 50,00 Hz.

### Energie (PV Erzeugung)

| Name | Adresse | Typ | Multiplikator | Einheit |
|------|---------|-----|---------------|---------|
| Energy Today | 53 | U_DWORD | 0.1 | kWh |
| Energy Total | 55 | U_DWORD | 0.1 | kWh |

### Temperatur

| Name | Adresse | Typ | Multiplikator | Einheit |
|------|---------|-----|---------------|---------|
| Inverter Temperature | 93 | U_WORD | 0.1 | °C |

### Batterie — Momentanleistung

| Name | Adresse | Typ | Multiplikator | Einheit |
|------|---------|-----|---------------|---------|
| Battery Discharge Power | 1009 | U_DWORD | 0.1 | W |
| Battery Charge Power | 1011 | U_DWORD | 0.1 | W |
| Battery Voltage | 1013 | U_WORD | 0.1 | V |
| Battery State of Charge | 1014 | U_WORD | 1 | % |
| Battery Temperature | 1040 | U_WORD | 0.1 | °C |

### Batterie — Energie (für Energie-Dashboard)

| Name | Adresse | Typ | Multiplikator | Einheit |
|------|---------|-----|---------------|---------|
| Battery Discharge Total | 1054 | U_DWORD | 0.1 | kWh |
| Battery Charge Total | 1058 | U_DWORD | 0.1 | kWh |

> **Wichtig:** 1009/1011 = Momentanleistung in **Watt**. 1054/1058 = kumulierte Energie in **kWh** für das HA Energie-Dashboard.

### Netzenergie Import / Export (für Energie-Dashboard)

| Name | Adresse | Typ | Multiplikator | Einheit |
|------|---------|-----|---------------|---------|
| Energy Import Total | 1046 | U_DWORD | 0.1 | kWh |
| Energy Export Total | 1050 | U_DWORD | 0.1 | kWh |

---

## Hinweise

- **U_DWORD** = 32-Bit-Wert über 2 aufeinanderfolgende Register. ESPHome liest diese automatisch korrekt, wenn `value_type: U_DWORD` gesetzt ist.
- Passwörter und API-Keys sind durch `#` ersetzt und müssen vor dem Einsatz angepasst werden.
- Diese Config wurde für den SPH 5000 TL3-BH-UP verifiziert. Andere SPH-Modelle (SPH 3000, SPH 6000 usw.) verwenden dieselbe Registerstruktur.