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

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

ShineWifi-X/Growatt SPH 5000 TL3/Growatt SPH 5000 TL3-BH-UP.yaml

@@ -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

ShineWifi-X/Growatt SPH 5000 TL3/README.md

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