README.de.md

Huawei Solar Modbus zu Home Assistant via MQTT + Auto-Discovery

🇬🇧 English | 🇩🇪 Deutsch

67 essenzielle Register • 68 Entitäten • optionaler MQTT-Heartbeat • 30s Polling
Changelog: CHANGELOG.md

⚠️ WICHTIG: Nur EINE Modbus-Verbindung möglich Huawei-Wechselrichter erlauben nur EINE aktive Modbus TCP-Verbindung.

• ✅ Entferne alle anderen Huawei Solar Integrationen (wlcrs/huawei_solar, HACS, etc.)
• ✅ Deaktiviere Monitoring-Tools und Apps mit Modbus-Zugriff
• ✅ Hinweis: FusionSolar Cloud zeigt möglicherweise "Abnormale Kommunikation" - das ist normal

Features

• Automatische Slave ID-Erkennung: Probiert automatisch gängige Werte (1, 2, 100)
• Modbus TCP → MQTT: 68 Entitäten mit Auto-Discovery
• Vollständiges Monitoring: Batterie, PV (1-4), Netz (3-Phasen), Energie-Counter
• Total Increasing Filter: Verhindert falsche Counter-Resets in Energie-Statistiken
• Auto MQTT-Konfiguration: Nutzt automatisch Home Assistant MQTT-Zugangsdaten
• Batch-Modus (v1.10.0+): Optionaler Modus für 75% schnellere Modbus-Zyklen mit automatischem Fallback
• Performance-Diagnostik: Per-Register-Timing-Analyse im DEBUG-Modus zur Engpass-Identifikation
• TRACE Log Level: Ultra-detailliertes Debugging mit Modbus-Byte-Arrays
• Umfassende Test-Suite: 89% Code-Coverage
• Performance: ~2-5s Lesezyklus, konfigurierbares Poll-Intervall (30-60s empfohlen)
• Plattformübergreifend: Alle gängigen Architekturen (aarch64, amd64, armhf, armv7, i386)
• Multi-Architektur: Home-Assistant-Add-ons werden über eine explizite build.yaml-Basisabbildzuordnung erstellt

🚀 Schnellstart

1. 
2. "huABus | Huawei Solar Modbus to MQTT" installieren
3. Minimale Konfiguration:

   modbus_host: 192.168.1.100
   modbus_auto_detect_slave_id: true
   log_level: INFO
   

4. Addon starten → Einstellungen → Geräte & Dienste → MQTT → "Huawei Solar Inverter"

Batch-Lesemodus (v1.10.0+)

Liest alle 67 Register in 3-5 Batches statt einzeln. Performance-Verbesserung: 75% schneller bei hoher Latenz. Automatisches Fallback zum sequenziellen Modus bei Fehlern.

Konfiguration:

enable_batching: true        # Standard: intelligentes Batching aktiviert
batch_max_gap: 100           # Max. Adresslücke pro Batch

EVCC Integration (Kein Modbus Proxy!)

huABus stellt alle Daten in einem einzigen MQTT-Topic (huawei-solar) bereit, für direkte EVCC-Integration ohne Modbus-Proxy oder Konflikte.

Voraussetzung: MQTT im evcc HA Addon aktivieren (evcc UI → Settings → MQTT).

Netzzähler:

power:
  source: mqtt
  topic: huawei-solar
  jq: "(.meter_power_active * -1)"

PV-Zähler:

power:
  source: mqtt
  topic: huawei-solar
  jq: ".power_input"

Batterie (optional):

power:
  source: mqtt
  topic: huawei-solar
  jq: "(.battery_power * -1)"
soc:
  source: mqtt
  topic: huawei-solar
  jq: ".battery_soc"
capacity: 10

Vergleich: wlcrs/huawei_solar vs. dieses Addon

Feature	wlcrs/huawei_solar (Integration)	Dieses Addon (MQTT-Bridge)
Batterie-Steuerung	✅	❌ (read-only)
MQTT-nativ	❌	✅
Batch-Modus	❌	✅ (optional, Auto-Fallback)
Auto Slave ID-Erkennung	❌	✅
Total Increasing Filter	❌	✅
Externe Integrationen	Begrenzt	✅ (EVCC, Node-RED, Grafana)
Error Tracking	Basis	Advanced

Beide teilen die gleiche Limitierung - nur EINE Modbus-Verbindung. Für gleichzeitige Nutzung wird ein Modbus Proxy benötigt.

Screenshots

Konfiguration

• Modbus Host: Inverter IP-Adresse (z.B. 192.168.1.100)
• Modbus Port: Standard: 502
• Auto-Erkennung Slave ID: Standard: true (probiert automatisch 1, 2, 100)
• Slave ID (manuell): Nur genutzt wenn Auto-Erkennung deaktiviert
• MQTT Broker: Standard: core-mosquitto (leer lassen für Auto-Config)
• MQTT Port: Standard: 1883
• MQTT Benutzername/Passwort: Optional (leer lassen für HA MQTT-Zugangsdaten)
• MQTT Topic: Standard: huawei-solar
• Log-Level: TRACE | DEBUG | INFO (empfohlen) | WARNING | ERROR
• Status Timeout: Standard: 180s
• Abfrageintervall: Standard: 30s (empfohlen: 30-60s)

Fehlerbehebung

Mehrere Modbus-Verbindungen (häufigster Fehler!): Alle anderen Huawei-Integrationen und Monitoring-Tools deaktivieren. Nur EINE Verbindung erlaubt.

Alle Slave IDs schlagen fehl: Modbus TCP im Wechselrichter aktivieren, IP-Adresse prüfen, Firewall checken.

MQTT Fehler: Broker auf core-mosquitto setzen, Credentials leer lassen.

Logs: Addon → Huawei Solar Modbus to MQTT → Log-Tab
Debug-Modus: log_level: DEBUG setzen

Aktuelle Updates

Siehe CHANGELOG.md für detaillierte Release-Notes.

• ✅ v1.10.0: Batch-Modus für bis zu 75% schnellere Modbus-Zyklen (Opt-in Beta)
• ✅ v1.9.0: Performance-Diagnostik mit Per-Register-Timing-Analyse im DEBUG-Modus
• ✅ v1.8.5: Multi-Arch-Build-Konfiguration ergänzt und Dockerfile vereinfacht
• ✅ v1.8.4: Fix: Poll-Intervall wurde im Main Loop nicht eingehalten
• ✅ v1.8.3: Fix für intermittierenden Slave ID Auto-Detection Fehler (Request cancelled outside library)
• ✅ v1.8.2: CI-Migration zu uv (40% schnellere Builds)
• ✅ v1.8.1: Fix für Home Assistant 2025.1 Modbus Slave ID Handling
• ✅ v1.8.0: Automatische Slave ID-Erkennung

Credits

Basiert auf: mjaschen/huawei-solar-modbus-to-mqtt
Verwendet Library: wlcrs/huawei-solar-lib
Entwickelt von: arboeh | Lizenz: MIT