À propos
GoodWe Wallbox est une intégration personnalisée qui permet de surveiller et de contrôler les chargeurs EV GoodWe depuis Home Assistant. Elle prend en charge l'accès cloud via le portail SEMS, le Modbus TCP local et une connexion TCP native facultative, signalée comme en développement. Elle ajoute un capteur binaire d'état de charge, un bouton d'actualisation, des commandes numériques pour la puissance de charge, le courant d'importation, l'énergie de la session et le SOC de la batterie, des sélecteurs pour le mode et la durée de charge, des interrupteurs, ainsi que des capteurs pour l'état, la puissance, l'énergie, la tension et le courant. Les interrupteurs couvrent la charge, Plug & Charge, la gestion dynamique de la charge, la commutation de phase et la connexion TCP locale, leur disponibilité dépendant du modèle et des valeurs que l'API renvoie. Une option peut rétablir le mode de charge sélectionné en dernier dans Home Assistant avant chaque démarrage depuis Home Assistant, et la liaison TCP native peut prendre le relais automatiquement quand le cloud échoue. La configuration se fait dans l'interface, et un téléchargement de diagnostics est disponible pour les rapports de bogue.
Résumé automatique du README et du code de prezervos/goodwe-wallbox-sems-home-assistant, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Installations au fil du temps
N° 1 426 sur 1 483 intégrations de la Marketplace. Installations partageant leurs statistiques.
Prise en charge
- Fonctionne en localCommunique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
- Depuis la MarketplaceS’installe depuis la Marketplace, anciennement HACS.
- Maintenance activeSon auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Interrupteurs
- Capteurs
Mise en place
Installe l’intégration depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Type de connexion
- Type de connexion
- Rétablir le mode sélectionné dans HA avant la chargeActivé : avant Start from HA, rétablit et vérifie le dernier mode de charge sélectionné dans HA. La préférence enregistrée est conservée lors des rechargements de l’intégration et des redémarrages de HA. Si aucune préférence n’a été enregistrée, le mode signalé par la wallbox est conservé. Désactivé : conserve le mode actuel de la wallbox. Les changements faits dans SolarGo ne remplacent pas la préférence HA enregistrée. Aucun mode n’est imposé au démarrage ni périodiquement. La protection TCP de limite de puissance reste active indépendamment.
Se connecter au portail SEMS
- Nom d’utilisateur (e-mail)
- Mot de passe
Modbus TCP local
- Adresse IP ou nom d’hôte
- Port
- ID d’appareil Modbus (0 = détection automatique)Laisse 0 pour la détection automatique. GoodWe Wallbox Gen2 utilise 247 (0xF7).
Sélectionner l’installation / la station
- Installation / station
Sélectionner la wallbox
- Wallbox
Saisir le numéro de série de la wallbox
- Numéro de série de la wallbox
- ID de l’installation (facultatif)
Modèle du produit
- Modèle du produit (p. ex. GW11K-HCA)
Connexion TCP native
- Adresse IPv4 de la wallbox
- Adresse IPv4 de Home Assistant joignable depuis la wallbox
- Port d’écoute TCP
- Vérifier l’identité par découverte sur le réseau local
- Numéro de série (facultatif avec la découverte)
- IPv4 du proxy TCP de confiance (facultatif ; uniquement pour le NAT source de Docker)
- Utiliser automatiquement le TCP quand le cloud tombe en panneNécessite un compte cloud. La prise de relais automatique exige au moins trois échecs et 90 secondes depuis le premier échec détecté. Un essai de retour est tenté après 30 minutes à l’arrêt et après une vérification préliminaire réussie ; de nouvelles données cloud doivent arriver dans les 60 secondes. Les essais échoués augmentent le délai jusqu’à deux heures. Le TCP manuel reste sélectionné d’un rechargement à l’autre et suspend le retour automatique jusqu’à ce que tu sélectionnes le cloud. Sélectionner le cloud manuellement suspend le basculement automatique jusqu’au rechargement.
Après la mise en place
- Intervalle de mise à jour à l’arrêt (secondes)Intervalle d’interrogation normal du cloud/Modbus à l’arrêt. Le TCP local utilise 5 secondes, ou 2 secondes lorsque la protection de puissance est active. La télémétrie MQTT vérifiée peut temporairement doubler l’intervalle HTTP de secours ; les actions de commande peuvent demander une mise à jour plus tôt.
- Intervalle de mise à jour pendant la charge (secondes)Intervalle d’interrogation normal du cloud/Modbus pendant la charge. Le TCP local utilise sa propre interrogation de sécurité de 2/5 secondes. La télémétrie MQTT vérifiée peut temporairement doubler l’intervalle HTTP de secours.
- ID de l’installationAffiche la valeur connue ou saisie manuellement. Tu peux la modifier ; laisse vide pour utiliser la détection automatique.
- Modèle du produitAffiche la valeur connue ou saisie manuellement. Tu peux la modifier ; laisse vide pour utiliser la détection automatique.
- Rétablir le mode sélectionné dans HA avant la chargeQuand tu actives cette option, le mode actuellement signalé par la wallbox devient la préférence enregistrée ; s’il ne peut pas être lu, le changement n’est pas enregistré. Ensuite, chaque Start from HA rétablit et vérifie le mode enregistré. Sélectionner un mode dans HA met à jour cette préférence. Les changements faits dans SolarGo ne la remplacent pas. La préférence est conservée lors des rechargements/redémarrages. Désactivé : conserve le mode actuel de la wallbox. Aucun mode n’est imposé au démarrage ni périodiquement. La protection de puissance TCP reste active indépendamment.
- Activer les commandes TCP natives (développement)Activé : passe aux réglages TCP et de basculement automatique à la page 2. Désactivé : enregistre sur cette page.
- Adresse IPv4 de la wallbox
- Adresse IPv4 de Home Assistant joignable depuis la wallbox
- Port d’écoute TCP
- Vérifier l’identité par découverte sur le réseau local
- Numéro de série (facultatif avec la découverte)
- IPv4 du proxy TCP de confiance (facultatif ; uniquement pour le NAT source de Docker)
- Utiliser automatiquement le TCP quand le cloud tombe en panneNécessite un compte cloud. La prise de relais automatique exige au moins trois échecs et 90 secondes depuis le premier échec détecté. Un essai de retour est tenté après 30 minutes à l’arrêt et après une vérification préliminaire réussie ; de nouvelles données cloud doivent arriver dans les 60 secondes. Les essais échoués augmentent le délai jusqu’à deux heures. Le TCP manuel reste sélectionné d’un rechargement à l’autre et suspend le retour automatique jusqu’à ce que tu sélectionnes le cloud. Sélectionner le cloud manuellement suspend le basculement automatique jusqu’au rechargement.
Textes issus du code de prezervos/goodwe-wallbox-sems-home-assistant. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesÉtat de charge
- BoutonsActualiser
- NombresPuissance de charge max., Limite du courant d’import, Énergie max. de session, Énergie min. de session, SOC min. de la batterie, Limite de puissance de sortie
- SélecteursMode de charge, Durée de charge
- CapteursÉtat de la Wallbox, État du véhicule, Puissance de charge, Énergie de la session, Limite de puissance signalée par la Wallbox, Durée de charge, État de la borne de charge, Connexion du véhicule, Tension de la phase A, Tension de la phase B, Tension de la phase C, Courant de la phase A et 12 autres
- InterrupteursCharge, Garantir la puissance de charge minimale, Plug & Charge, Gestion dynamique de la charge, Changement de phase automatique, Mode de puissance minimale EMS, Connexion TCP locale
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Extrait du README
Home Assistant custom integration for the GoodWe Wallbox.
3.0.7 also handles transient cloud state after Stop. It addresses cloud data changes after the SEMS update, adds bounded B0001 read recovery and improves opted-in native TCP control fallback. Beta availability does not mean GoodWe's cloud command backend is fixed. See release notes for validation and known limitations.
Informations
- Installations
- 55 partagent leurs statistiques
- Étoiles GitHub
- 13
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- 3.0.7,
- Catégorie
- Énergie, Recharge de véhicules électriques
- Type
- Intégration de la Marketplace
- Marque
- GoodWe
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
sems_wallbox- Problèmes
- Signaler un problème















