Skip to content

README.de-PRODUCTION.md

Latest commit

 

History

History
154 lines (118 loc) · 7.14 KB

README.de-PRODUCTION.md

File metadata and controls

154 lines (118 loc) · 7.14 KB

huABus

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

🇬🇧 English | 🇩🇪 Deutsch

Home Assistant release Tests codecov Security
maintained License: MIT
aarch64 amd64 armhf armv7 i386

67 essenzielle Register • 69+ 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: 69+ 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
  • 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)

🚀 Schnellstart

  1. Repository hinzufügen
  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"

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

EVCC Netzzähler Konfiguration
EVCC PV-Zähler Konfiguration
EVCC Batterie Konfiguration

Vergleich: wlcrs/huawei_solar vs. dieses Addon

Feature wlcrs/huawei_solar
(Integration)		 Dieses Addon
(MQTT-Bridge)
Batterie-Steuerung ✅ ❌ (read-only)
MQTT-nativ ❌ ✅
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

Diagnostic Entities
Sensor Overview
MQTT Device Info

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