Marstek Venus Energy Manager
Ouvrir dans Home Assistant
Sur Home Assistant 2026.11 ou une version ultérieure ? L’ouvrir dans la Marketplace
- Installations
- 79 partagent leurs statistiques
- Étoiles GitHub
- 148
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.1.1,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Marque
- Marstek
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
marstek_venus_energy_manager- Problèmes
- Signaler un problème
Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.
Captures d’écran Extraites du README de ffunes/Marstek-Venus-Energy-Manager.
À propos
Marstek Venus Energy Manager surveille et pilote les batteries Marstek Venus E, A et D en local via Modbus TCP. Il ajoute un régulateur proportionnel-dérivé qui ajuste la puissance de la batterie pour maintenir l'import et l'export réseau proches de zéro, avec des profils de réglage au choix et un capteur de qualité de régulation. La charge prédictive depuis le réseau utilise un capteur de prévision solaire pour charger depuis le réseau lorsque la prévision et la batterie ne couvriront pas le jour suivant, et un délai de charge la retient tant que le solaire peut encore la couvrir. Des plages horaires par batterie définissent quand la charge ou la décharge est autorisée, avec des limites facultatives sur le niveau de charge et la puissance, et un mode manuel qui impose une puissance fixe. Parmi les autres fonctions, on trouve l'écrêtage des pics, la charge complète hebdomadaire pour l'équilibrage des cellules, l'exclusion de charges pour les appareils de forte puissance et la prise en charge de plusieurs batteries. L'avis de correction indique que l'intégration est abandonnée et renvoie vers Omnibattery, et la configuration se fait dans l'interface.
Résumé automatique du README et du code de ffunes/Marstek-Venus-Energy-Manager, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Détection automatique Home Assistant la repère sur le réseau et propose de l’ajouter.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Configurer Marstek Venus Energy Manager
- Capteur de consommation réseauCapteur qui indique la puissance importée (+) ou exportée (-) vers le réseau. Le contrôleur ajustera les batteries pour maintenir cette valeur proche de 0W.
- Capteur de prévision solaire (optionnel)Capteur fournissant la prévision de production solaire en kWh (ex : Solcast). S'il est configuré ici, il sera utilisé automatiquement pour la charge prédictive et le retard de charge solaire.
- Capteur de production solaire (optionnel)Capteur de puissance de production photovoltaïque en temps réel (W/kW) d'un onduleur externe non raccordé aux entrées MPPT de la batterie. Utilisé pour afficher le nœud Solaire dans le diagramme de flux d'énergie du tableau de bord. Laissez vide si vos panneaux alimentent directement le MPPT de la batterie.
- Signe du compteur inverséActivez cette option si votre compteur utilise la convention opposée : positif = exportation, négatif = importation. L'unité (W/kW) est détectée automatiquement.
- Puissance maximale souscrite (W)Puissance totale souscrite en watts. Le système ne dépassera pas cette limite lors de la charge pour éviter de déclencher le disjoncteur
Nombre de batteries
- Nombre de batteries
Étape 3
- NomNom descriptif pour identifier cette batterie
- Adresse IPAdresse IP de la batterie sur votre réseau local
- Port ModbusPort Modbus (généralement 502)
- ID esclave ModbusID d'esclave ou d'unité Modbus (1 par défaut). Ne le modifie que si un proxy Modbus associe plusieurs batteries à une même adresse IP:port en utilisant des ID d'esclave distincts.
- Modèle de batterieSélectionnez la version du modèle de votre batterie. Ev2 pour les anciens modèles, Ev3 pour les nouveaux modèles avec cartographie mise à jour, A (Venus A) ou D (Venus D) pour les onduleurs hybrides
Étape 4
- Puissance de charge maximale (W)Puissance maximale autorisée pour charger la batterie
- Puissance de décharge maximale (W)Puissance maximale autorisée pour décharger la batterie
- SOC maximum (%)État de charge maximum - la batterie ne se chargera pas au-dessus de cette valeur
- SOC minimum (%)État de charge minimum - la batterie ne se déchargera pas en dessous de cette valeur
- Activer l'hystérésis de chargeEmpêche la batterie de se charger lorsque le SOC est proche du maximum
- Pourcentage d'hystérésis (%)La batterie ne se chargera pas tant que le SOC ne descend pas à (max_soc - hystérésis). Ex : SOC max 100% avec 5% d'hystérésis = pas de charge avant 95%
- Seuil de charge hors réseau de secours (W)Une charge hors réseau supérieure à cette valeur est traitée comme un événement de secours actif, excluant la batterie du contrôle PD. Augmenter si des charges permanentes (routeur, caméras) sont connectées au port hors réseau.
- Activer la réduction de charge à 100% par tensionLorsque la cible est 100%, limite la charge à 95 W à partir de 3.48 V de tension maximale de cellule et s'arrête à 3.58 V pour mesurer le déséquilibre après 60 secondes.
Plages horaires de décharge
- Configurer les plages horaires
Étape 6
- Heure de débutHeure de début (24h). Le passage à minuit est pris en charge.
- Heure de finHeure de fin (24h).
- Jours de la semaineJours où cette plage s'applique.
- Batterie concernéeSélectionnez 'all' pour toutes les batteries ou une batterie spécifique.
- Autoriser la chargeSi coché, la charge est autorisée pendant la plage. Si AUCUNE plage n'autorise la charge, elle est libre par défaut.
- Autoriser la déchargeSi coché, la décharge est autorisée pendant la plage. Si AUCUNE plage n'autorise la décharge, elle est libre par défaut.
- Contrôler le SOC max/min de la plageSi coché, la plage remplace le SOC max/min de la batterie dans la fenêtre.
- Contrôler la puissance max de charge/déchargeSi coché, la plage limite ou force la puissance maximale.
- Mode de fonctionnementPD : l'algorithme prédictif ajuste la puissance avec le plafond de la plage. Manuel : décharge ou charge forcée à la puissance indiquée.
Étape 7
- Batterie 1 — SOC min. (%)
- Batterie 1 — SOC max. (%)
- Batterie 1 — Puissance max. charge (W)
- Batterie 1 — Puissance max. décharge (W)
- Batterie 2 — SOC min. (%)
- Batterie 2 — SOC max. (%)
- Batterie 2 — Puissance max. charge (W)
- Batterie 2 — Puissance max. décharge (W)
- Batterie 3 — SOC min. (%)
- Batterie 3 — SOC max. (%)
- Batterie 3 — Puissance max. charge (W)
- Batterie 3 — Puissance max. décharge (W)
- Batterie 4 — SOC min. (%)
- Batterie 4 — SOC max. (%)
- Batterie 4 — Puissance max. charge (W)
Ajouter d'autres plages horaires
- Ajouter une autre plage horaire
Après la mise en place
- Capteur de consommation réseauCapteur qui indique la puissance importée (+) ou exportée (-) vers le réseau.
- Capteur de prévision solaire (optionnel)Capteur fournissant la prévision de production solaire en kWh (ex : Solcast). S'il est configuré ici, il sera utilisé automatiquement pour la charge prédictive et le retard de charge solaire.
- Capteur de production solaire (optionnel)Capteur de puissance de production photovoltaïque en temps réel (W/kW) d'un onduleur externe non raccordé aux entrées MPPT de la batterie. Utilisé pour afficher le nœud Solaire dans le diagramme de flux d'énergie du tableau de bord. Laissez vide si vos panneaux alimentent directement le MPPT de la batterie.
- Signe du compteur inverséActivez cette option si votre compteur utilise la convention opposée : positif = exportation, négatif = importation. L'unité (W/kW) est détectée automatiquement.
- Puissance maximale souscrite (W)Puissance totale souscrite en watts. Le système ne dépassera pas cette limite lors de la charge pour éviter de déclencher le disjoncteur
- Nombre de batteries
- NomNom descriptif pour identifier cette batterie
- Adresse IPAdresse IP de la batterie sur votre réseau local
- Port ModbusPort Modbus (généralement 502)
- ID esclave ModbusID d'esclave ou d'unité Modbus (1 par défaut). Ne le modifie que si un proxy Modbus associe plusieurs batteries à une même adresse IP:port en utilisant des ID d'esclave distincts.
- Modèle de batterieSélectionnez la version du modèle de votre batterie. Ev2 pour les anciens modèles, Ev3 pour les nouveaux modèles avec cartographie mise à jour, A (Venus A) ou D (Venus D) pour les onduleurs hybrides
- Puissance de charge maximale (W)Puissance maximale autorisée pour charger la batterie
- Puissance de décharge maximale (W)Puissance maximale autorisée pour décharger la batterie
- SOC maximum (%)État de charge maximum
- SOC minimum (%)État de charge minimum
- Activer l'hystérésis de chargeEmpêche la batterie de se charger lorsque le SOC est proche du maximum
- Pourcentage d'hystérésis (%)La batterie ne se chargera pas tant que le SOC ne descend pas à (max_soc - hystérésis). Ex : SOC max 100% avec 5% d'hystérésis = pas de charge avant 95%
- Seuil de charge hors réseau de secours (W)Une charge hors réseau supérieure à cette valeur est traitée comme un événement de secours actif, excluant la batterie du contrôle PD. Augmenter si des charges permanentes (routeur, caméras) sont connectées au port hors réseau.
- Activer la réduction de charge à 100% par tensionLorsque la cible est 100%, limite la charge à 95 W à partir de 3.48 V de tension maximale de cellule et s'arrête à 3.58 V pour mesurer le déséquilibre après 60 secondes.
- Configurer les plages horaires
- Heure de débutHeure de début (24h). Le passage à minuit est pris en charge.
- Heure de finHeure de fin (24h).
- Jours de la semaineJours où cette plage s'applique.
- Batterie concernéeSélectionnez 'all' pour toutes les batteries ou une batterie spécifique.
- Autoriser la chargeSi coché, la charge est autorisée pendant la plage. Si AUCUNE plage n'autorise la charge, elle est libre par défaut.
- Autoriser la déchargeSi coché, la décharge est autorisée pendant la plage. Si AUCUNE plage n'autorise la décharge, elle est libre par défaut.
- Contrôler le SOC max/min de la plageSi coché, la plage remplace le SOC max/min de la batterie dans la fenêtre.
- Contrôler la puissance max de charge/déchargeSi coché, la plage limite ou force la puissance maximale.
- Mode de fonctionnementPD : l'algorithme prédictif ajuste la puissance avec le plafond de la plage. Manuel : décharge ou charge forcée à la puissance indiquée.
- Batterie 1 — SOC min. (%)
- Batterie 1 — SOC max. (%)
- Batterie 1 — Puissance max. charge (W)
- Batterie 1 — Puissance max. décharge (W)
- Batterie 2 — SOC min. (%)
- Batterie 2 — SOC max. (%)
- Batterie 2 — Puissance max. charge (W)
- Batterie 2 — Puissance max. décharge (W)
- Batterie 3 — SOC min. (%)
- Batterie 3 — SOC max. (%)
- Batterie 3 — Puissance max. charge (W)
- Batterie 3 — Puissance max. décharge (W)
- Batterie 4 — SOC min. (%)
- Batterie 4 — SOC max. (%)
- Batterie 4 — Puissance max. charge (W)
- Ajouter une autre plage horaire
Textes issus du code de ffunes/Marstek-Venus-Energy-Manager. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesÉcrêtement de Pointe Actif, Charge Prédictive Active, État WiFi, État Cloud, Mode d'Équilibrage, Hystérésis de Charge
- BoutonsRéinitialiser l'Appareil
- NombresPuissance de Charge, Puissance de Décharge, Puissance de Charge Max., Puissance de Décharge Max., SOC Limite de Charge, SOC Limite de Décharge, Charger jusqu'à SOC, PD Kp, PD Kd, PD Bande Morte, PD Changement de Puissance Max., PD Hystérésis de Direction et 16 autres
- SélecteursMode Forcé, Mode de Fonctionnement, Jour de Charge Complète Hebdomadaire, Profil de Réglage PD
- CapteursFenêtre de Décharge, Batteries Actives, Puissance de cellule batterie du système, Puissance Solaire Totale, Production Solaire Quotidienne, Consommation Domestique Quotidienne, Qualité du Contrôle PD, Consommation Domestique, Importation Réseau Quotidienne, Exportation Réseau Quotidienne, Batteries Non Réactives, Résumé de Configuration et 54 autres
- InterrupteursMode Manuel, Charge Prédictive, Délai de Charge, Écrêtement de Pointe, Fonction de Secours, Mode de Contrôle RS485, Autoriser la Charge, Autoriser la Decharge, Réduction Charge 100% par Tension, Mode d'Équilibrage Actif, Charge par Prix Externe, Bilan Net
- HeuresFin de Charge Externe
Dépannage
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Cette intégration est abandonnée — migrez vers Omnibattery
Extrait du README
The Marstek Venus Energy Manager is a comprehensive Home Assistant integration designed to monitor and control Marstek Venus E and C series batteries (v2 and v3) and Venus D and Venus A series batteries via Modbus TCP. It provides advanced energy management features including predictive grid charging, customizable time slots for discharge control, and device load exclusion logic.
- Zero Export/Import PD Controller: Keeps grid exchange near zero using a Proportional-Derivative algorithm.
- Oscillation Prevention: Deadband and derivative gain prevent rapid charge/discharge cycling.
- One-Click PD Profiles + Quality Sensor: Pick a tuning profile (Very smooth → Very aggressive) instead of tuning gains by hand; a control-quality sensor reports whether the result is stable,…
- Multi-Battery Support: Manage up to 6 batteries with intelligent load sharing and SOC-based priority.
- Predictive Grid Charging: Automatically charges from the grid when solar forecast + battery won't cover tomorrow's consumption. Supports fixed time slots, dynamic pricing, and real-time pricing…
- Time Slots (v2): Per-battery windows with independent charge/discharge ticks, optional SOC and power overrides, and a manual mode that forces a fixed charge or discharge power. Up to 8 slots per…
- Weekly Full Charge: Forces 100% SOC once a week for LFP cell balancing.
- Solar-Aware Charge Delay: Holds back grid charging while solar can still cover the required energy.
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 79 partagent leurs statistiques
- Étoiles GitHub
- 148
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.1.1,
- Catégorie
- Énergie, Solaire et batteries
- Type
- Intégration de la Marketplace
- Marque
- Marstek
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
marstek_venus_energy_manager- Problèmes
- Signaler un problème
