Points clés
- Trois protocoles locaux couvrent presque toutes les marques : Modbus TCP, pont MQTT et API REST locale. Le bon choix dépend du modèle exact de l'appareil.
- Modbus TCP est le chemin hors ligne le plus fiable — fonctionne sans internet ni broker cloud, via lecture directe de registres sur le réseau local.
- Les intégrations pont MQTT (Zendure, Marstek, Deye) fonctionnent en local pointées vers un broker auto-hébergé comme Mosquitto, mais nécessitent un script adaptateur ou une intégration HACS.
- EcoFlow PowerStream est l'exception majeure : aucun chemin Modbus TCP ou MQTT local disponible à la date de vérification (2026-07-03). Tout passe par le cloud EcoFlow.
- Victron Cerbo GX offre le meilleur support local : intégration HA officielle (depuis HA 2026.5), Modbus TCP documenté et MQTT local entièrement hors ligne.
- Le support des interfaces locales peut changer avec les mises à jour firmware — vérifier le dépôt d'intégration actuel avant tout achat.
Trois chemins protocolaires pour l'intégration locale
Modbus TCP lit les registres de l'appareil directement sur le réseau local — sans compte cloud, broker ni logiciel adaptateur. L'appareil (ou sa passerelle locale) écoute sur un port TCP (généralement 502 ou 8899) et répond aux commandes de lecture de registres. L'intégration Modbus native de Home Assistant ou un composant HACS gère l'interrogation. Ce chemin continue à fonctionner même si la connexion internet est coupée.
Les intégrations pont MQTT s'intercalent entre l'appareil et Home Assistant. L'appareil publie des données sur un topic — soit sur le broker cloud du fabricant, soit sur une instance Mosquitto locale. Quand le broker est local, le tout fonctionne hors ligne. Si l'appareil se connecte uniquement au broker cloud, internet reste nécessaire.
Les chemins API REST locale utilisent des appels HTTP GET/POST vers l'appareil ou sa passerelle sur le réseau local. Zendure SolarFlow 800 Pro l'expose nativement. Marstek le propose via Marstek Local API (HACS). Kostal Plenticore utilise la même API REST que son interface web intégrée.
📍 En une phrase
Modbus TCP lit les registres directement sur le réseau local, le pont MQTT utilise un broker pub/sub, et l'API REST locale répond aux requêtes HTTP directement sur l'appareil.
💬 En termes simples
Modbus TCP = connexion directe sur le réseau local ; MQTT = système de messagerie avec broker intermédiaire ; API REST = l'appareil répond comme un site web.
Matrice de compatibilité par marque
Toutes les cellules ont été vérifiées le 2026-07-03 contre les dépôts d'intégration GitHub actifs et la documentation fabricant. Le support des interfaces locales évolue avec les firmware — utiliser ce tableau comme point de départ et vérifier l'état actuel avant tout achat.
| Marque / Produit | Modbus TCP | MQTT local | API REST locale | Hors ligne ? | Intégration HA |
|---|---|---|---|---|---|
| Anker SOLIX (stockage) | ✅ port 502, officiel | ⚠️ pont cloud seulement | — | ✅ via Modbus | ha-anker-solix-official (HACS) |
| Zendure SolarFlow 800 Pro | — | ✅ HTTP + MQTT local | ✅ HTTP local | ✅ | Zendure/Zendure-HA (officiel) |
| Zendure Hub 1200/2000, Hyper 2000 | — | ⚠️ MQTT cloud seulement | — | ❌ | z-master42/solarflow (communauté) |
| Hoymiles HMS/HMT (via DTU-Pro) | ✅ via DTU-Pro | ✅ OpenDTU / hoymiles-mqtt | — | ✅ | hoymiles-mqtt-integration (HACS) |
| Marstek B2500 / Jupiter / Venus | ⚠️ RS485 sur Venus uniquement | ✅ hame-relay + hm2mqtt | ✅ Marstek Local API | ✅ | Marstek Local API v1.0.0 (HACS) |
| Growatt NOAH 2000 / onduleurs | ✅ Modbus TCP local | ✅ noah-mqtt / growatt2mqtt | — | ✅ | Homeassistant-Growatt-Local-Modbus (HACS) |
| Deye SUN600G3 (micro-onduleur) | ✅ port 8899 (non documenté) | ✅ SolarmanV5 / deye-inverter-mqtt | — | ✅ | Solarman HACS |
| Victron Cerbo GX | ✅ officiel, documenté | ✅ officiel (HA 2026.5+) | — | ✅ | Intégration HA officielle |
| Sungrow série SH-RT | ✅ communauté | ✅ ModbusTCP2MQTT | — | ✅ | Sungrow-SHx-Inverter-Modbus (HACS) |
| Kostal Plenticore (G3+) | ✅ HACS | — | ✅ API REST officielle | ✅ | Intégration HA officielle (REST) |
| EcoFlow PowerStream | ❌ | ❌ MQTT cloud uniquement | ❌ | ❌ | tolwi/hassio-ecoflow-cloud (cloud) |
Vérifié le 2026-07-03. Les mises à jour firmware peuvent ajouter ou supprimer l'accès local — vérifier avant tout achat.
Chemin A : Configuration Modbus TCP
Modbus TCP nécessite trois conditions : l'appareil sur le même réseau local que Home Assistant, l'interface Modbus activée, et la cartographie des registres pour le modèle. La plupart des intégrations HACS communautaires intègrent la cartographie — il suffit de renseigner l'adresse IP.
- 1Activer Modbus TCP sur l'appareil : Anker SOLIX → app Anker → paramètres → activer Modbus. Hoymiles → interface web DTU-Pro. Growatt → actif par défaut. Deye → aucun réglage nécessaire, port 8899 toujours ouvert.
- 2Attribuer une adresse IP statique à l'appareil sur le routeur (ou réservation DHCP) pour que l'adresse reste stable dans l'intégration HA.
- 3Installer l'intégration HACS correspondante : ha-anker-solix-official pour Anker, hoymiles-mqtt-integration pour Hoymiles, Homeassistant-Growatt-Local-Modbus pour Growatt, Solarman pour Deye, intégration Victron GX officielle pour Victron.
- 4Saisir l'IP de l'appareil et le port dans les paramètres d'intégration. Port Modbus standard : 502 ; Deye utilise 8899.
- 5Vérifier les entités de capteurs dans HA — la puissance de sortie actuelle doit se mettre à jour sous 5 à 10 secondes. Si les entités affichent « indisponible », vérifier l'IP, l'activation Modbus et les règles de pare-feu.
Chemin B : Configuration du pont MQTT
Les intégrations pont MQTT fonctionnent via un petit script adaptateur (ou add-on HA) qui interroge l'appareil ou reçoit ses données push et les republique sur le broker Mosquitto local. Home Assistant s'abonne ensuite à ces topics via l'intégration MQTT. Ce chemin est entièrement hors ligne une fois l'adaptateur configuré sur un broker local.
- 1Installer le broker Mosquitto en tant qu'add-on HA (Paramètres → Add-ons → Mosquitto Broker) et configurer identifiant et mot de passe.
- 2Configurer l'intégration MQTT dans HA (Paramètres → Appareils & services → Ajouter une intégration → MQTT) et la connecter au broker local.
- 3Installer l'adaptateur spécifique à l'appareil : noah-mqtt pour Growatt NOAH 2000, hame-relay + hm2mqtt pour Marstek, hoymiles-mqtt pour Hoymiles, deye-inverter-mqtt pour Deye ou Zendure-HA pour Zendure. Exécuter en conteneur Docker ou en add-on HA.
- 4Pointer l'adaptateur vers l'IP de l'appareil et, si possible, vers le broker Mosquitto local plutôt que le broker cloud du fabricant.
- 5Confirmer le flux de données : les entités doivent apparaître automatiquement via la découverte MQTT, ou vérifier les topics entrants dans la section MQTT de HA.
Chemin C : API REST locale
Une API REST locale signifie que l'appareil fait tourner un serveur HTTP sur le réseau local — aucun adaptateur séparé nécessaire. Zendure SolarFlow 800 Pro, Marstek (via Marstek Local API HACS) et Kostal Plenticore utilisent ce chemin.
- 1Confirmer la disponibilité de l'API locale pour le modèle : README de l'intégration HACS ou portail développeur du fabricant.
- 2Installer l'intégration via HACS : rechercher « Marstek Local API » ou « Kostal Plenticore ». Zendure-HA (officiel) gère les deux chemins local et MQTT cloud.
- 3Saisir l'IP de l'appareil et, si nécessaire, le mot de passe administrateur (Kostal utilise le mot de passe de l'interface web).
- 4Vérifier les entités et les commandes — pour Kostal et Marstek, cela inclut le contrôle de la limite de charge de la batterie, pas seulement la supervision.
Intégration EVCC
EVCC (contrôleur de charge VE open source) peut consommer les données de production locale du solaire balcon pour synchroniser la charge du véhicule électrique avec les pics solaires. EVCC supporte Modbus TCP et MQTT nativement.
Dans evcc.yaml, configurer l'appareil solaire balcon comme compteur avec type: modbus ou type: mqtt. Des exemples de configuration communautaires pour Hoymiles via OpenDTU et Deye via SolarmanV5 sont disponibles dans les discussions du dépôt evcc-io/evcc sur GitHub.
Questions fréquentes
L'activation de Modbus TCP sur Anker SOLIX désactive-t-elle l'app Anker ?
Non. L'intégration Modbus officielle Anker SOLIX fonctionne en parallèle avec l'app Anker et le cloud. Activer Modbus TCP dans les paramètres de l'app ajoute un accès local aux registres sans supprimer les fonctionnalités cloud.
Pourquoi la matrice montre-t-elle deux lignes différentes pour Zendure ?
Le Zendure SolarFlow 800 Pro dispose d'une API HTTP/MQTT locale fonctionnant sans connexion internet. Les anciens modèles Zendure (Hub 1200, Hub 2000, Hyper 2000, Ace 1500) ne communiquent qu'avec le broker MQTT cloud de Zendure — Home Assistant peut s'abonner à ces topics, mais l'appareil a besoin d'internet pour publier. L'intégration officielle Zendure-HA gère les deux chemins.
EcoFlow PowerStream obtiendra-t-il un contrôle local ?
EcoFlow a déclaré mi-2025 que des solutions locales étaient en développement, sans date de sortie. Aucun chemin API local ou Modbus TCP vérifié pour PowerStream n'existait à la date de vérification (2026-07-03). Consulter la communauté développeurs EcoFlow ou le dépôt hassio-ecoflow-cloud pour l'état actuel.
Quelle marque offre le meilleur contrôle local dans l'ensemble ?
Victron Cerbo GX a le meilleur support local : intégration officielle dans le cœur de Home Assistant (depuis HA 2026.5), Modbus TCP documenté avec cartographie des registres publiée et MQTT local entièrement hors ligne. Anker SOLIX suit avec une intégration HACS communautaire officielle et Modbus TCP sur le port 502 fonctionnant en parallèle du cloud.
Puis-je utiliser Modbus TCP et MQTT simultanément sur le même appareil ?
Oui pour les protocoles en lecture seule. Modbus TCP et API REST sont des protocoles d'interrogation non exclusifs — l'intégration HA et evcc.yaml peuvent pointer vers le même appareil simultanément. Pour MQTT, éviter deux adaptateurs publiant sur les mêmes topics, mais plusieurs abonnés (HA, EVCC) peuvent lire les mêmes topics.