Repo-Struktur: ShineWifi-X Ordner + ShineLAN-X releases/ vorbereitet

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 13:52:30 +02:00
parent 27bc3f3f39
commit e27a47791a
8 changed files with 0 additions and 0 deletions
@@ -0,0 +1,212 @@
+esphome:
+  name: growatt-mic-1500
+  friendly_name: Growatt MIC 1500 TL-X
+
+esp8266:
+  board: esp07s
+
+logger:
+
+api:
+  encryption:
+    key: "HIER_API_KEY_EINTRAGEN"  # 32-Byte Base64-Key, wird in der ESPHome-UI automatisch generiert
+
+ota:
+  - platform: esphome
+    password: "HIER_OTA_PASSWORT_EINTRAGEN"  # Beliebiges Passwort für Over-the-Air Updates
+
+wifi:
+  ssid: "HIER_WLAN_NAME_EINTRAGEN"      # Name deines WLANs (SSID)
+  password: "HIER_WLAN_PASSWORT_EINTRAGEN"  # Passwort deines WLANs
+  ap:
+    ssid: "Growatt MIC 1500 TL-X Fallback Hotspot"
+    password: "HIER_HOTSPOT_PASSWORT_EINTRAGEN"  # Passwort für den Notfall-Hotspot (min. 8 Zeichen)
+
+captive_portal:
+
+time:
+  - platform: homeassistant
+    id: homeassistant_time
+
+output:
+  - id: light_bl  # Blaue LED
+    platform: gpio
+    pin: 16
+  - id: light_gr  # Grüne LED
+    platform: gpio
+    pin: 0
+  - id: light_rd  # Rote LED
+    platform: gpio
+    pin: 2
+
+uart:
+  id: mod_bus
+  tx_pin: 1
+  rx_pin: 3
+  baud_rate: 115200
+
+modbus:
+  id: modbus1
+  uart_id: mod_bus
+
+modbus_controller:
+  - id: growatt
+    address: 1
+    modbus_id: modbus1
+    setup_priority: -10
+    on_online:
+      then:
+        - output.turn_on: light_gr
+    on_offline:
+      then:
+        - output.turn_off: light_gr
+
+script:
+  - id: blink_blue
+    mode: single
+    then:
+      - output.turn_on: light_bl
+      - delay: 200ms
+      - output.turn_off: light_bl
+
+sensor:
+  # --- PV Eingang ---
+
+  - platform: modbus_controller
+    name: "PV Voltage"
+    address: 3
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+    on_value:
+      then:
+        - script.execute: blink_blue
+
+  - platform: modbus_controller
+    name: "PV Current"
+    address: 4
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV Power"
+    address: 5
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- AC Ausgang / Netz ---
+
+  - platform: modbus_controller
+    name: "Grid Frequency"
+    address: 37
+    register_type: read
+    unit_of_measurement: Hz
+    device_class: frequency
+    state_class: measurement
+    icon: mdi:sine-wave
+    value_type: U_WORD
+    accuracy_decimals: 2
+    filters:
+      - multiply: 0.01
+
+  - platform: modbus_controller
+    name: "Grid Voltage"
+    address: 38
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current"
+    address: 39
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "AC Output Power"
+    address: 40
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Energie (PV Erzeugung) ---
+
+  - platform: modbus_controller
+    name: "Energy Today"
+    address: 53
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Energy Total"
+    address: 55
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Temperatur ---
+
+  - platform: modbus_controller
+    name: "Inverter Temperature"
+    address: 93
+    register_type: read
+    unit_of_measurement: "°C"
+    device_class: temperature
+    state_class: measurement
+    icon: mdi:thermometer
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
@@ -0,0 +1,212 @@
+esphome:
+  name: growatt-mic-2000
+  friendly_name: Growatt MIC 2000 TL-X
+
+esp8266:
+  board: esp07s
+
+logger:
+
+api:
+  encryption:
+    key: "HIER_API_KEY_EINTRAGEN"
+
+ota:
+  - platform: esphome
+    password: "HIER_OTA_PASSWORT_EINTRAGEN"
+
+wifi:
+  ssid: "HIER_WLAN_NAME_EINTRAGEN"
+  password: "HIER_WLAN_PASSWORT_EINTRAGEN"
+  ap:
+    ssid: "Growatt MIC 2000 TL-X Fallback Hotspot"
+    password: "HIER_HOTSPOT_PASSWORT_EINTRAGEN"
+
+captive_portal:
+
+time:
+  - platform: homeassistant
+    id: homeassistant_time
+
+output:
+  - id: light_bl
+    platform: gpio
+    pin: 16
+  - id: light_gr
+    platform: gpio
+    pin: 0
+  - id: light_rd
+    platform: gpio
+    pin: 2
+
+uart:
+  id: mod_bus
+  tx_pin: 1
+  rx_pin: 3
+  baud_rate: 115200
+
+modbus:
+  id: modbus1
+  uart_id: mod_bus
+
+modbus_controller:
+  - id: growatt
+    address: 1
+    modbus_id: modbus1
+    setup_priority: -10
+    on_online:
+      then:
+        - output.turn_on: light_gr
+    on_offline:
+      then:
+        - output.turn_off: light_gr
+
+script:
+  - id: blink_blue
+    mode: single
+    then:
+      - output.turn_on: light_bl
+      - delay: 200ms
+      - output.turn_off: light_bl
+
+sensor:
+  # --- PV Eingang ---
+
+  - platform: modbus_controller
+    name: "PV Voltage"
+    address: 3
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+    on_value:
+      then:
+        - script.execute: blink_blue
+
+  - platform: modbus_controller
+    name: "PV Current"
+    address: 4
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV Power"
+    address: 5
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- AC Ausgang / Netz ---
+
+  - platform: modbus_controller
+    name: "Grid Frequency"
+    address: 37
+    register_type: read
+    unit_of_measurement: Hz
+    device_class: frequency
+    state_class: measurement
+    icon: mdi:sine-wave
+    value_type: U_WORD
+    accuracy_decimals: 2
+    filters:
+      - multiply: 0.01
+
+  - platform: modbus_controller
+    name: "Grid Voltage"
+    address: 38
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current"
+    address: 39
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "AC Output Power"
+    address: 40
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Energie (PV Erzeugung) ---
+
+  - platform: modbus_controller
+    name: "Energy Today"
+    address: 53
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Energy Total"
+    address: 55
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Temperatur ---
+
+  - platform: modbus_controller
+    name: "Inverter Temperature"
+    address: 93
+    register_type: read
+    unit_of_measurement: "°C"
+    device_class: temperature
+    state_class: measurement
+    icon: mdi:thermometer
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
@@ -0,0 +1,50 @@
+# Growatt MIC 2000 TL-X — ESPHome Konfiguration
+
+Modbus-RTU Integration des Growatt MIC 2000 TL-X (einphasiger String-Wechselrichter) über einen Growatt SuniStick mit ESPHome-Firmware.
+
+Gleiche Registerstruktur wie der MIC 1500 TL-X — die MIC TL-X Familie verwendet ein einheitliches Protokoll.
+
+---
+
+## 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 |
+|------|---------|-----|---------------|---------|
+| PV Voltage | 3 | U_WORD | 0.1 | V |
+| PV Current | 4 | U_WORD | 0.1 | A |
+| PV Power | 5 | U_DWORD | 0.1 | W |
+
+### AC Ausgang / Netz
+
+| Name | Adresse | Typ | Multiplikator | Einheit |
+|------|---------|-----|---------------|---------|
+| Grid Frequency | 37 | U_WORD | **0.01** | Hz |
+| Grid Voltage | 38 | U_WORD | 0.1 | V |
+| Grid Current | 39 | U_WORD | 0.1 | A |
+| AC Output Power | 40 | U_DWORD | 0.1 | W |
+
+### 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 |
+
+---
+
+## Hinweise
+
+- **Einphasig, kein Hybrid, kein Batterie-Interface** — keine Register >100 vorhanden.
+- Register identisch mit MIC 1500 TL-X. Andere MIC TL-X Modelle (1000W, 1500W, 2000W) verwenden dieselbe Registerstruktur.
+- Passwörter und API-Keys sind durch Platzhalter ersetzt und müssen vor dem Einsatz angepasst werden.
@@ -0,0 +1,331 @@
+esphome:
+  name: growatt-mod-6000
+  friendly_name: Growatt MOD 6000 TL3-XH
+
+esp8266:
+  board: esp07s
+
+logger:
+
+api:
+  encryption:
+    key: "HIER_API_KEY_EINTRAGEN"
+
+ota:
+  - platform: esphome
+    password: "HIER_OTA_PASSWORT_EINTRAGEN"
+
+wifi:
+  ssid: "HIER_WLAN_NAME_EINTRAGEN"
+  password: "HIER_WLAN_PASSWORT_EINTRAGEN"
+  ap:
+    ssid: "Growatt MOD 6000 Fallback Hotspot"
+    password: "HIER_HOTSPOT_PASSWORT_EINTRAGEN"
+
+captive_portal:
+
+time:
+  - platform: homeassistant
+    id: homeassistant_time
+
+output:
+  - id: light_bl
+    platform: gpio
+    pin: 16
+  - id: light_gr
+    platform: gpio
+    pin: 0
+  - id: light_rd
+    platform: gpio
+    pin: 2
+
+uart:
+  id: mod_bus
+  tx_pin: 1
+  rx_pin: 3
+  baud_rate: 115200
+
+modbus:
+  id: modbus1
+  uart_id: mod_bus
+
+modbus_controller:
+  - id: growatt
+    address: 1
+    modbus_id: modbus1
+    setup_priority: -10
+    on_online:
+      then:
+        - output.turn_on: light_gr
+    on_offline:
+      then:
+        - output.turn_off: light_gr
+
+script:
+  - id: blink_blue
+    mode: single
+    then:
+      - output.turn_on: light_bl
+      - delay: 200ms
+      - output.turn_off: light_bl
+
+sensor:
+  # --- PV Eingang ---
+
+  - platform: modbus_controller
+    name: "PV1 Voltage"
+    address: 3003
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+    on_value:
+      then:
+        - script.execute: blink_blue
+
+  - platform: modbus_controller
+    name: "PV1 Current"
+    address: 3004
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV1 Power"
+    address: 3005
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV2 Voltage"
+    address: 3007
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV2 Current"
+    address: 3008
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV2 Power"
+    address: 3009
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- AC Ausgang / Netz (dreiphasig) ---
+
+  - platform: modbus_controller
+    name: "AC Output Power Total"
+    address: 3023
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Frequency"
+    address: 3025
+    register_type: read
+    unit_of_measurement: Hz
+    device_class: frequency
+    state_class: measurement
+    icon: mdi:sine-wave
+    value_type: U_WORD
+    accuracy_decimals: 2
+    filters:
+      - multiply: 0.01
+
+  - platform: modbus_controller
+    name: "Grid Voltage L1"
+    address: 3026
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current L1"
+    address: 3027
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Voltage L2"
+    address: 3030
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current L2"
+    address: 3031
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Voltage L3"
+    address: 3034
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current L3"
+    address: 3035
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Energie (PV Erzeugung) ---
+
+  - platform: modbus_controller
+    name: "Energy Today"
+    address: 3049
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Energy Total"
+    address: 3051
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Temperatur ---
+
+  - platform: modbus_controller
+    name: "Inverter Temperature"
+    address: 3093
+    register_type: read
+    unit_of_measurement: "°C"
+    device_class: temperature
+    state_class: measurement
+    icon: mdi:thermometer
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Smartmeter (optional, nur wenn Smartmeter angeschlossen) ---
+
+  - platform: modbus_controller
+    name: "Power To User"
+    address: 3041
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:transmission-tower-import
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Power To Grid"
+    address: 3043
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:transmission-tower-export
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
@@ -0,0 +1,67 @@
+# Growatt MOD 6000 TL3-XH — ESPHome Konfiguration
+
+Modbus-RTU Integration des Growatt MOD 6000 TL3-XH (dreiphasiger String-Wechselrichter, kein Hybrid) ü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`
+
+> **Wichtig:** Die MOD TL3-XH Serie verwendet 3000er-Register — nicht die kleinen Register der MIC/MIN-Serie.
+
+### PV Eingang
+
+| Name | Adresse | Typ | Multiplikator | Einheit |
+|------|---------|-----|---------------|---------|
+| PV1 Voltage | 3003 | U_WORD | 0.1 | V |
+| PV1 Current | 3004 | U_WORD | 0.1 | A |
+| PV1 Power | 3005 | U_DWORD | 0.1 | W |
+| PV2 Voltage | 3007 | U_WORD | 0.1 | V |
+| PV2 Current | 3008 | U_WORD | 0.1 | A |
+| PV2 Power | 3009 | U_DWORD | 0.1 | W |
+
+### AC Ausgang / Netz (dreiphasig)
+
+| Name | Adresse | Typ | Multiplikator | Einheit |
+|------|---------|-----|---------------|---------|
+| AC Output Power Total | 3023 | U_DWORD | 0.1 | W |
+| Grid Frequency | 3025 | U_WORD | **0.01** | Hz |
+| Grid Voltage L1 | 3026 | U_WORD | 0.1 | V |
+| Grid Current L1 | 3027 | U_WORD | 0.1 | A |
+| Grid Voltage L2 | 3030 | U_WORD | 0.1 | V |
+| Grid Current L2 | 3031 | U_WORD | 0.1 | A |
+| Grid Voltage L3 | 3034 | U_WORD | 0.1 | V |
+| Grid Current L3 | 3035 | U_WORD | 0.1 | A |
+
+### Energie (PV Erzeugung)
+
+| Name | Adresse | Typ | Multiplikator | Einheit |
+|------|---------|-----|---------------|---------|
+| Energy Today | 3049 | U_DWORD | 0.1 | kWh |
+| Energy Total | 3051 | U_DWORD | 0.1 | kWh |
+
+### Temperatur
+
+| Name | Adresse | Typ | Multiplikator | Einheit |
+|------|---------|-----|---------------|---------|
+| Inverter Temperature | 3093 | U_WORD | 0.1 | °C |
+
+### Smartmeter (optional)
+
+Nur relevant wenn ein Smartmeter am Wechselrichter angeschlossen ist.
+
+| Name | Adresse | Typ | Multiplikator | Einheit |
+|------|---------|-----|---------------|---------|
+| Power To User (Bezug) | 3041 | U_DWORD | 0.1 | W |
+| Power To Grid (Einspeisung) | 3043 | U_DWORD | 0.1 | W |
+
+---
+
+## Hinweise
+
+- **Dreiphasig, kein Hybrid, kein Batterie-Interface.**
+- Registerstruktur verifiziert gegen Growatt MOD TL3-XH Modbus-Protokoll (gleiche Familie wie MOD 7000 TL3-XH).
+- Ohne angeschlossenen Smartmeter liefern Register 3041/3043 Nullwerte — diese Sensoren können dann entfernt werden.
+- Passwörter und API-Keys sind durch Platzhalter ersetzt und müssen vor dem Einsatz angepasst werden.
@@ -0,0 +1,452 @@
+esphome:
+  name: growatt-sph5000
+  friendly_name: Growatt SPH 5000 TL3-BH-UP
+
+esp8266:
+  board: esp07s
+
+logger:
+
+api:
+  encryption:
+    key: "HIER_API_KEY_EINTRAGEN"  # 32-Byte Base64-Key, wird in der ESPHome-UI automatisch generiert
+
+ota:
+  - platform: esphome
+    password: "HIER_OTA_PASSWORT_EINTRAGEN"  # Beliebiges Passwort für Over-the-Air Updates
+
+wifi:
+  ssid: "HIER_WLAN_NAME_EINTRAGEN"      # Name deines WLANs (SSID)
+  password: "HIER_WLAN_PASSWORT_EINTRAGEN"  # Passwort deines WLANs
+  ap:
+    ssid: "Growatt-SPH5000 Fallback Hotspot"
+    password: "HIER_HOTSPOT_PASSWORT_EINTRAGEN"  # Passwort für den Notfall-Hotspot (min. 8 Zeichen)
+
+captive_portal:
+
+time:
+  - platform: homeassistant
+    id: homeassistant_time
+
+output:
+  - id: light_bl
+    platform: gpio
+    pin: 16
+  - id: light_gr
+    platform: gpio
+    pin: 0
+  - id: light_rd
+    platform: gpio
+    pin: 2
+
+uart:
+  id: mod_bus
+  tx_pin: 1
+  rx_pin: 3
+  baud_rate: 115200
+
+modbus:
+  id: modbus1
+  uart_id: mod_bus
+
+modbus_controller:
+  - id: growatt
+    address: 1
+    modbus_id: modbus1
+    setup_priority: -10
+    on_online:
+      then:
+        - output.turn_on: light_gr
+    on_offline:
+      then:
+        - output.turn_off: light_gr
+
+script:
+  - id: blink_blue
+    mode: single
+    then:
+      - output.turn_on: light_bl
+      - delay: 200ms
+      - output.turn_off: light_bl
+
+sensor:
+  # --- PV Eingang ---
+
+  - platform: modbus_controller
+    name: "PV1 Voltage"
+    address: 3
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+    on_value:
+      then:
+        - script.execute: blink_blue
+
+  - platform: modbus_controller
+    name: "PV1 Current"
+    address: 4
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV1 Power"
+    address: 5
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV2 Voltage"
+    address: 7
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV2 Current"
+    address: 8
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "PV2 Power"
+    address: 9
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:solar-panel
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- AC Ausgang / Netz ---
+
+  - platform: modbus_controller
+    name: "AC Output Power Total"
+    address: 35
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Frequency"
+    address: 37
+    register_type: read
+    unit_of_measurement: Hz
+    device_class: frequency
+    state_class: measurement
+    icon: mdi:sine-wave
+    value_type: U_WORD
+    accuracy_decimals: 2
+    filters:
+      - multiply: 0.01
+
+  - platform: modbus_controller
+    name: "Grid Voltage L1"
+    address: 38
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current L1"
+    address: 39
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Voltage L2"
+    address: 42
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current L2"
+    address: 43
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Voltage L3"
+    address: 46
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Grid Current L3"
+    address: 47
+    register_type: read
+    unit_of_measurement: A
+    device_class: current
+    state_class: measurement
+    icon: mdi:flash
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Energie (PV Erzeugung) ---
+
+  - platform: modbus_controller
+    name: "Energy Today"
+    address: 53
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Energy Total"
+    address: 55
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:solar-power
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Temperatur ---
+
+  - platform: modbus_controller
+    name: "Inverter Temperature"
+    address: 93
+    register_type: read
+    unit_of_measurement: "°C"
+    device_class: temperature
+    state_class: measurement
+    icon: mdi:thermometer
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Batterie ---
+
+  - platform: modbus_controller
+    name: "Battery Discharge Power"
+    address: 1009
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:battery-minus
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Battery Charge Power"
+    address: 1011
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:battery-plus
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Battery Voltage"
+    address: 1013
+    register_type: read
+    unit_of_measurement: V
+    device_class: voltage
+    state_class: measurement
+    icon: mdi:battery
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Battery State of Charge"
+    address: 1014
+    register_type: read
+    unit_of_measurement: "%"
+    device_class: battery
+    state_class: measurement
+    icon: mdi:battery
+    value_type: U_WORD
+    accuracy_decimals: 0
+
+  - platform: modbus_controller
+    name: "Battery Temperature"
+    address: 1040
+    register_type: read
+    unit_of_measurement: "°C"
+    device_class: temperature
+    state_class: measurement
+    icon: mdi:thermometer
+    value_type: U_WORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Batterie Energie (kWh Zähler für Energie-Dashboard) ---
+
+  - platform: modbus_controller
+    name: "Battery Discharge Total"
+    address: 1054
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:battery-minus
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Battery Charge Total"
+    address: 1058
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:battery-plus
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Smartmeter Momentanleistung ---
+
+  - platform: modbus_controller
+    name: "Power To Grid"
+    address: 1021
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:transmission-tower-export
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Power To User"
+    address: 1029
+    register_type: read
+    unit_of_measurement: W
+    device_class: power
+    state_class: measurement
+    icon: mdi:transmission-tower-import
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  # --- Netzenergie Import / Export (kWh Zähler für Energie-Dashboard) ---
+
+  - platform: modbus_controller
+    name: "Energy Import Total"
+    address: 1046
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:transmission-tower-import
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
+
+  - platform: modbus_controller
+    name: "Energy Export Total"
+    address: 1050
+    register_type: read
+    unit_of_measurement: kWh
+    device_class: energy
+    state_class: total_increasing
+    icon: mdi:transmission-tower-export
+    value_type: U_DWORD
+    accuracy_decimals: 1
+    filters:
+      - multiply: 0.1
@@ -0,0 +1,92 @@
+# 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.
+
+### Smartmeter — Momentanleistung
+
+| Name | Adresse | Typ | Multiplikator | Einheit |
+|------|---------|-----|---------------|---------|
+| Power To Grid | 1021 | U_DWORD | 0.1 | W |
+| Power To User | 1029 | U_DWORD | 0.1 | W |
+
+> **Hinweis:** Beide Werte sind immer positiv (unsigned). "To Grid" = Einspeisung, "To User" = Bezug vom Netz.
+
+### 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.