{"id":48645670,"url":"https://github.com/arboeh/huABus","last_synced_at":"2026-04-25T22:00:40.484Z","repository":{"id":327943198,"uuid":"1109110844","full_name":"arboeh/huABus","owner":"arboeh","description":"MQTT bridge for Huawei solar inverters (SUN2000/3000/5000) → Home Assistant","archived":false,"fork":false,"pushed_at":"2026-03-18T08:03:16.000Z","size":2196,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-18T23:37:07.718Z","etag":null,"topics":["evcc","home-assistant","home-automation","huawei-solar","modbus","mqtt","solar-inverter","sun2000"],"latest_commit_sha":null,"homepage":"https://github.com/arboeh/huABus","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arboeh.png","metadata":{"files":{"readme":"README.de.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-03T10:57:52.000Z","updated_at":"2026-03-18T08:02:57.000Z","dependencies_parsed_at":"2026-01-29T08:03:41.402Z","dependency_job_id":null,"html_url":"https://github.com/arboeh/huABus","commit_stats":null,"previous_names":["arboeh/homeassistant-huawei-solar-addon","arboeh/huabus"],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/arboeh/huABus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arboeh%2FhuABus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arboeh%2FhuABus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arboeh%2FhuABus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arboeh%2FhuABus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arboeh","download_url":"https://codeload.github.com/arboeh/huABus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arboeh%2FhuABus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32278249,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["evcc","home-assistant","home-automation","huawei-solar","modbus","mqtt","solar-inverter","sun2000"],"created_at":"2026-04-10T04:00:21.202Z","updated_at":"2026-04-25T22:00:40.477Z","avatar_url":"https://github.com/arboeh.png","language":"Python","funding_links":[],"categories":["Interfaces"],"sub_categories":["Smart Home Hardware Interfaces"],"readme":"\u003cimg src=\"images/heading.svg\" alt=\"huABus\" height=\"40\"/\u003e\n\n### Huawei Solar Modbus zu Home Assistant via MQTT + Auto-Discovery\n\n[🇬🇧 English](README.md) | 🇩🇪 **Deutsch**\n\n[![Home Assistant](https://img.shields.io/badge/Home%20Assistant-Add--on-41BDF5?logo=home-assistant)](https://www.home-assistant.io/)\n[![release](https://img.shields.io/github/v/release/arboeh/huABus?display_name=tag)](https://github.com/arboeh/huABus/releases/latest)\n[![Tests](https://github.com/arboeh/huABus/workflows/Tests/badge.svg)](https://github.com/arboeh/huABus/actions)\n[![codecov](https://codecov.io/gh/arboeh/huABus/branch/main/graph/badge.svg)](https://codecov.io/gh/arboeh/huABus)\n[![Security](https://img.shields.io/badge/Security-Policy-blue?logo=github)](https://github.com/arboeh/huABus/blob/main/SECURITY.md)  \n[![maintained](https://img.shields.io/maintenance/yes/2026)](https://github.com/arboeh/huABus/graphs/commit-activity)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/arboeh/huABus/blob/main/LICENSE)  \n[![aarch64](https://img.shields.io/badge/aarch64-yes-green.svg)](https://github.com/arboeh/huABus)\n[![amd64](https://img.shields.io/badge/amd64-yes-green.svg)](https://github.com/arboeh/huABus)\n[![armhf](https://img.shields.io/badge/armhf-yes-green.svg)](https://github.com/arboeh/huABus)\n[![armv7](https://img.shields.io/badge/armv7-yes-green.svg)](https://github.com/arboeh/huABus)\n[![i386](https://img.shields.io/badge/i386-yes-green.svg)](https://github.com/arboeh/huABus)\n\n**67 essenzielle Register • 69+ Entitäten • optionaler MQTT-Heartbeat • 30s Polling**  \n**Changelog:** [CHANGELOG.md](huawei_solar_modbus_mqtt/CHANGELOG.md)\n\n\u003e **⚠️ WICHTIG: Nur EINE Modbus-Verbindung möglich**\n\u003e Huawei-Wechselrichter erlauben **nur EINE aktive Modbus TCP-Verbindung**.\n\u003e\n\u003e - ✅ Entferne alle anderen Huawei Solar Integrationen (wlcrs/huawei_solar, HACS, etc.)\n\u003e - ✅ Deaktiviere Monitoring-Tools und Apps mit Modbus-Zugriff\n\u003e - ✅ Hinweis: FusionSolar Cloud zeigt möglicherweise \"Abnormale Kommunikation\" - das ist normal\n\n## Features\n\n- **Automatische Slave ID-Erkennung:** Probiert automatisch gängige Werte (1, 2, 100)\n- **Modbus TCP → MQTT:** 69+ Entitäten mit Auto-Discovery\n- **Vollständiges Monitoring:** Batterie, PV (1-4), Netz (3-Phasen), Energie-Counter\n- **Total Increasing Filter:** Verhindert falsche Counter-Resets in Energie-Statistiken\n- **Auto MQTT-Konfiguration:** Nutzt automatisch Home Assistant MQTT-Zugangsdaten\n- **TRACE Log Level:** Ultra-detailliertes Debugging mit Modbus-Byte-Arrays\n- **Umfassende Test-Suite:** 89% Code-Coverage\n- **Performance:** ~2-5s Lesezyklus, konfigurierbares Poll-Intervall (30-60s empfohlen)\n- **Plattformübergreifend:** Alle gängigen Architekturen (aarch64, amd64, armhf, armv7, i386)\n\n## 🚀 Schnellstart\n\n1. [![Repository hinzufügen](https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg)](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Farboeh%2FhuABus)\n2. \"huABus | Huawei Solar Modbus to MQTT\" installieren\n3. **Minimale Konfiguration:**\n   ```yaml\n   modbus_host: 192.168.1.100\n   modbus_auto_detect_slave_id: true\n   log_level: INFO\n   ```\n4. Addon starten → **Einstellungen → Geräte \u0026 Dienste → MQTT → \"Huawei Solar Inverter\"**\n\n## EVCC Integration (Kein Modbus Proxy!)\n\nhuABus stellt alle Daten in einem einzigen MQTT-Topic (`huawei-solar`) bereit, für direkte EVCC-Integration ohne Modbus-Proxy oder Konflikte.\n\n**Voraussetzung:** MQTT im [evcc HA Addon](https://github.com/evcc-io/hassio-addon) aktivieren (evcc UI → Settings → MQTT).\n\n**Netzzähler:**\n\n```yaml\npower:\n  source: mqtt\n  topic: huawei-solar\n  jq: \"(.meter_power_active * -1)\"\n```\n\n**PV-Zähler:**\n\n```yaml\npower:\n  source: mqtt\n  topic: huawei-solar\n  jq: \".power_input\"\n```\n\n**Batterie (optional):**\n\n```yaml\npower:\n  source: mqtt\n  topic: huawei-solar\n  jq: \"(.battery_power * -1)\"\nsoc:\n  source: mqtt\n  topic: huawei-solar\n  jq: \".battery_soc\"\ncapacity: 10\n```\n\n![EVCC Netzzähler Konfiguration](images/evcc_grid.png)  \n![EVCC PV-Zähler Konfiguration](images/evcc_solar.png)  \n![EVCC Batterie Konfiguration](images/evcc_battery.png)\n\n## Vergleich: wlcrs/huawei_solar vs. dieses Addon\n\n| Feature                 | wlcrs/huawei_solar\u003cbr\u003e(Integration) | Dieses Addon\u003cbr\u003e(MQTT-Bridge) |\n| ----------------------- | ----------------------------------- | ----------------------------- |\n| Batterie-Steuerung      | ✅                                  | ❌ (read-only)                |\n| MQTT-nativ              | ❌                                  | ✅                            |\n| Auto Slave ID-Erkennung | ❌                                  | ✅                            |\n| Total Increasing Filter | ❌                                  | ✅                            |\n| Externe Integrationen   | Begrenzt                            | ✅ (EVCC, Node-RED, Grafana)  |\n| Error Tracking          | Basis                               | Advanced                      |\n\nBeide teilen die gleiche Limitierung - nur **EINE Modbus-Verbindung**. Für gleichzeitige Nutzung wird ein Modbus Proxy benötigt.\n\n## Screenshots\n\n![Diagnostic Entities](images/diagnostics.png)  \n![Sensor Overview](images/sensors.png)  \n![MQTT Device Info](images/mqtt_info.png)\n\n## Konfiguration\n\n- **Modbus Host:** Inverter IP-Adresse (z.B. `192.168.1.100`)\n- **Modbus Port:** Standard: `502`\n- **Auto-Erkennung Slave ID:** Standard: `true` (probiert automatisch 1, 2, 100)\n- **Slave ID (manuell):** Nur genutzt wenn Auto-Erkennung deaktiviert\n- **MQTT Broker:** Standard: `core-mosquitto` (leer lassen für Auto-Config)\n- **MQTT Port:** Standard: `1883`\n- **MQTT Benutzername/Passwort:** Optional (leer lassen für HA MQTT-Zugangsdaten)\n- **MQTT Topic:** Standard: `huawei-solar`\n- **Log-Level:** `TRACE` | `DEBUG` | `INFO` (empfohlen) | `WARNING` | `ERROR`\n- **Status Timeout:** Standard: `180s`\n- **Abfrageintervall:** Standard: `30s` (empfohlen: 30-60s)\n\n## Fehlerbehebung\n\n**Mehrere Modbus-Verbindungen** (häufigster Fehler!): Alle anderen Huawei-Integrationen und Monitoring-Tools deaktivieren. Nur EINE Verbindung erlaubt.\n\n**Alle Slave IDs schlagen fehl:** Modbus TCP im Wechselrichter aktivieren, IP-Adresse prüfen, Firewall checken.\n\n**MQTT Fehler:** Broker auf `core-mosquitto` setzen, Credentials leer lassen.\n\n**Logs:** Addon → Huawei Solar Modbus to MQTT → Log-Tab  \n**Debug-Modus:** `log_level: DEBUG` setzen\n\n## Aktuelle Updates\n\nSiehe [CHANGELOG.md](huawei_solar_modbus_mqtt/CHANGELOG.md) für detaillierte Release-Notes.\n\n- ✅ **v1.8.4:** Fix: Poll-Intervall wurde im Main Loop nicht eingehalten\n- ✅ **v1.8.3:** Fix für intermittierenden Slave ID Auto-Detection Fehler (`Request cancelled outside library`)\n- ✅ **v1.8.2:** CI-Migration zu `uv` (40% schnellere Builds)\n- ✅ **v1.8.1:** Fix für Home Assistant 2025.1 Modbus Slave ID Handling\n- ✅ **v1.8.0:** Automatische Slave ID-Erkennung\n\n## Credits\n\n**Basiert auf:** [mjaschen/huawei-solar-modbus-to-mqtt](https://github.com/mjaschen/huawei-solar-modbus-to-mqtt)  \n**Verwendet Library:** [wlcrs/huawei-solar-lib](https://github.com/wlcrs/huawei-solar-lib)  \n**Entwickelt von:** [arboeh](https://github.com/arboeh) | **Lizenz:** MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farboeh%2FhuABus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farboeh%2FhuABus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farboeh%2FhuABus/lists"}