Plusieurs batteries, une cible réseau
Centralisez les Marstek par entités, les Hoymiles MS-A2 par MQTT et les batteries génériques en surveillance seule. Les besoins sont répartis entre les batteries actives selon leurs limites disponibles.
Intégration Home Assistant · v0.5.5 bêta
Battery Manager
Surveillez et pilotez collectivement plusieurs batteries de marques différentes. Programmez la semaine selon la météo, gérez les protections et le Backup, recevez vos notifications et retrouvez chaque action dans les journaux.
L’interface
Toutes les commandes au même endroit
Sept vues pour suivre vos batteries, régler les protections, programmer la semaine, adapter les profils à la météo et consulter les notifications et les journaux. Les captures défilent automatiquement ; sélectionnez un onglet ou cliquez sur une image pour l’agrandir.
Fonctionnalités · v0.5.5
Un pilotage réellement collectif
De la programmation météo au suivi des commandes, chaque batterie garde ses limites et ses réglages dans une interface commune.
Planificateur hebdomadaire
Sept jours avec 96 créneaux de 15 minutes par jour et par batterie : charge, décharge, autoconsommation collective, charge solaire, veille, retour au mode par défaut ou autoconsommation native Marstek.
Édition et profils personnalisés
Sélectionnez une plage par glisser-déposer, une journée, une heure sur toute la semaine ou la semaine complète. Personnalisez les profils et exportez ou importez les paramètres de planification en JSON.
Météo et prévisions
Choisissez les profils Ensoleillé, Nuageux et Pluvieux manuellement ou automatiquement. Réglez les seuils de couverture nuageuse, l’hystérésis, le décalage de prévision et l’intervalle d’actualisation.
Précipitations mieux interprétées
Le seuil de pluie est réglable, à 0,5 mm/h par défaut. Sous ce seuil, une pluie faible laisse la couverture nuageuse choisir le profil ; les phénomènes importants gardent la priorité Pluvieux. Le diagnostic précise les données et le motif retenu.
Tableau de bord détaillé
SOC, flux, puissance réseau, moyennes sur une et quinze minutes, tendance, consignes et commandes réelles. Consultez le rendement AC/DC, les températures du jour, l’énergie stockée, les cycles et les tensions des cellules lorsque disponibles.
Prévision de fin de charge
L’heure estimée d’atteinte du SOC maximal est actualisée chaque minute à partir d’une moyenne glissante et des paliers SOC. Les mesures et les commandes liées à une entité ouvrent son historique Home Assistant au clic.
Modes rapides persistants
Passez en Charge, Autoconsommation collective ou native Marstek, Charge solaire, En attente, Désactivé ou Backup Marstek lorsque configuré. Revenez au Planificateur sans modifier ses créneaux ; le choix est conservé après redémarrage.
Protections et paliers
Définissez les SOC minimal et maximal, leurs seuils de reprise et jusqu’à huit paliers de charge. Les limites de puissance du programme, du matériel et du palier actif restent prises en compte.
Réglages de régulation
Adaptez les conventions de signe, le zéro réseau, la zone morte, l’hystérésis, les compensations et la retransmission des commandes. Le calcul est suspendu si les mesures indispensables du réseau ou du SOC sont indisponibles.
Configuration Marstek
Récupérez automatiquement les entités Venus Modbus et consultez leur diagnostic. Choisissez un modèle illustré sans changer les paramètres de pilotage ; les mesures supplémentaires dépendent des entités disponibles.
Hoymiles MS-A2 par MQTT
Configurez les sujets de mode EMS et de consigne. La retransmission périodique maintient le contrôle MQTT de la MS-A2, avec un retour configurable à sa logique native.
Perte et retour du réseau
Le pilotage peut être suspendu après 60 secondes de tension Grid numérique hors de 200 à 250 V. La reprise automatique en Programmation est optionnelle, si le réseau revient dans un délai maximal de quatre heures.
Backup Marstek et actions
Lorsque Backup Function est actif, les commandes s’arrêtent et la gestion rapide se verrouille. Désactivez une entité à l’entrée en Backup et restaurez facultativement son état initial au retour du Grid, même après un redémarrage de Home Assistant.
37 notifications au choix
Créez, testez et gérez vos destinations notify.mobile_app_*. Choisissez les batteries, les seuils et les destinataires de chaque alerte. Les seuils peuvent suivre la Configuration ou être personnalisés ; aucun envoi sans destinataire sélectionné.
Horaires et réarmement
Un créneau quotidien par destination, de 07:00 à 22:00 par défaut, sans passage à minuit. Confirmation, délai minimal et réarmement évitent les répétitions ; une alerte persistante est envoyée à l’ouverture si sa condition reste présente.
Journaux persistants
Retrouvez les consignes, le planificateur, la gestion météo, les notifications et les actions utilisateurs avec date, heure, type et contenu. Recherche, pagination et purge automatique : 30 jours et 50 Mo au total.
Interface et aide intégrée
Interface en français, anglais et espagnol, adaptée au thème sombre, aux tablettes et aux téléphones. Les sections Commandes réelles et Consigne en cours sont repliables, avec une disposition mémorisée par batterie et appareil. Le panneau À propos contient la documentation.
Sécurité de fonctionnement
Commencez en surveillance seule
La gestion réelle est désactivée par défaut. Vérifiez d’abord les noms de modes, le signe des puissances, les limites et les réactions de chaque batterie.
Important
Battery Manager n’est pas un dispositif de sécurité électrique. Il ne remplace ni le BMS, ni les disjoncteurs, ni les limites définies par le constructeur.
Battery Manager n’est pas un dispositif de sécurité électrique. Il ne remplace ni le BMS, ni les disjoncteurs, ni les limites définies par le constructeur.
Autoconsommation
Une cible réseau, plusieurs batteries
La puissance positive du capteur réseau correspond par défaut à l’importation depuis le réseau, et la valeur négative à l’injection. L’option d’inversion accepte la convention opposée.
Le calcul collectif répartit la cible entre les batteries actives. Si une unité est bloquée par son SOC ou sa limite de puissance, le reliquat est redistribué aux autres.
Mesure réseauLecture de la consommation ou du surplus depuis le capteur global.
Calcul collectifApplication de la zone morte, des actions programmées et des protections SOC.
RépartitionDistribution de la puissance dans les limites encore disponibles.
CommandesEnvoi des consignes adaptées à chaque Marstek ou Hoymiles.
Installation
Avec HACS ou manuellement
Battery Manager est une intégration personnalisée Home Assistant. Ce n’est pas un module complémentaire de l’Add-on Store.
- Ajoutez le dépôt personnalisé dans HACS ou copiez
custom_components/battery_managerdans/config/custom_components/. - Redémarrez Home Assistant.
- Ajoutez l’intégration « Battery Manager » ou « Gestionnaire de batteries ».
- Sélectionnez le capteur global de puissance réseau.
- Ouvrez le panneau « Gestion batteries » dans la barre latérale.
Version 0.5.5
Notifications, journaux, Backup et nouvelle interface
Les versions 0.5.x enrichissent le pilotage quotidien et son suivi, avec une météo plus précise et une configuration entièrement revue.
Météo affinée
La v0.5.5 ajoute le seuil de précipitations, les quantités prévues et le motif détaillé du profil choisi. Si les quantités ne sont pas disponibles, la condition météo reste la solution de secours.
Notifications et journaux
Depuis la v0.5.0 : 37 notifications et cinq catégories de journaux. La v0.5.2 ajoute un réarmement par batterie et destination, fixé à 14 heures par défaut pour les débuts de charge et de décharge.
Backup et actions associées
Depuis la v0.5.2 : protection Backup Marstek et actions sur une entité. Le mode précédent reprend après désactivation du Backup et 30 secondes de tension Grid stable entre 200 et 250 V.
Suivi de la charge
Depuis la v0.5.1 : estimation de l’heure d’atteinte du SOC maximal. Les motifs météo sont traduits dans le diagnostic et les journaux.
Configuration repensée
Les v0.5.3 et v0.5.4 apportent des modèles illustrés, une nouvelle présentation des paliers, des contrôles harmonisés et une configuration mieux alignée sur ordinateur et mobile.
Vue d’ensemble plus compacte
En v0.5.5 : navigation mobile corrigée, commandes réelles repliées par défaut et consigne en cours repliable. Chaque navigateur conserve l’ouverture des sections pour chaque batterie.
Fonctions encore à venir
La limitation thermique active et la charge complète périodique pour l’équilibrage du BMS ne sont pas encore disponibles. Le firmware ou le BMS peut imposer ses propres limites de puissance.
La limitation thermique active et la charge complète périodique pour l’équilibrage du BMS ne sont pas encore disponibles. Le firmware ou le BMS peut imposer ses propres limites de puissance.