Huawei Fusion Hub — aggregator integration for Huawei solar systems
If you run a Huawei solar system and have more than one monitoring integration installed (local Modbus + cloud), you’ve probably hit the same problem: the local connection is accurate but sometimes drops, and automations break when entities go unavailable.
Huawei Fusion Hub sits in front of up to three source integrations — Huawei Solar (local Modbus), FusionSolar (Kiosk/OpenAPI) and FusionSolarPlus — and exposes a single stable set of sensor.hf_hub_* entities with automatic priority-based failover. When the local connection drops, the hub transparently switches to the next available source. Your automations keep running.
Key features:
- Priority-based failover, configurable from the UI at any time
- 221 canonical sensors grouped into logical devices: Inverter, Battery, Battery Unit 1/2, Power Meter, Plant
- Stable entity IDs regardless of which source is active
- Automatic unit normalization (W, kWh, °C) across sources
- Dynamic rediscovery when a source comes back — no restart needed
- Source availability alerts via
binary_sensor, HA event bus, and persistent notifications - Optional control proxies (inverter on/off, working modes, power setpoints, SOC limits, forcible charge) — off by default
- Zero extra polling: only reads entity states already published by the source integrations
- Works with any combination of one, two or all three sources
- UI + entity names in English and Italian
Installation:
Available via HACS (custom repository) — or manual copy into custom_components/.
→ GitHub - naked-head/huawei-fusion-hub: Aggregator for various Huawei Fusion Solar entity · GitHub
Full entity correspondence table in ENTITY_MAP.md.
Unofficial project, not affiliated with Huawei. Feedback and issues welcome!