Intégration domotique Victron VRM, gratuite et open source

Installations Victron Energy via VRM : batterie, solaire, réseau, alarmes et prévisions.

• Publiée par William-De71
• Appareils
• Version 0.1.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Présentation

Cette intégration amène dans Gladys les installations Victron Energy de votre compte VRM (vrm.victronenergy.com), via l’API VRM officielle et un jeton d’accès personnel. Elle ne fait que lire : elle ne modifie jamais un réglage de votre installation. Elle n’est pas affiliée à Victron Energy.

• Un appareil par installation : niveau de batterie, puissances de charge et de décharge de la batterie, tension de la batterie, puissance solaire et production solaire du jour, puissance du réseau électrique (import +, export −), consommation AC et consommation du jour, puissance du groupe électrogène.
• Quatre widgets de tableau de bord : flux d’énergie en direct, aujourd’hui (avec un graphique par heure), la prévision VRM, les alarmes VRM.
• Déclencheurs de scène : alarme VRM levée ou terminée, batterie faible ou pleine, réseau perdu ou rétabli, installation hors ligne ou de retour, accès refusé.
• Actions de scène : les énergies du jour, la prévision solaire et de consommation d’aujourd’hui et de demain.

Transport : cloud. Le jeton d’accès part vers VRM (vrmapi.victronenergy.com) et les données de vos installations viennent du cloud de Victron, qui les reçoit de l’appareil GX (Cerbo GX, Venus GX, Ekrano…) de chaque installation.

Prérequis

• Gladys Assistant 5.1.0 ou plus récent.
• Une installation Victron avec un appareil GX qui envoie ses données à VRM (elle apparaît sur vrm.victronenergy.com).
• Un jeton d’accès VRM : dans VRM, ouvrez Preferences → Integrations → Access tokens (lien direct), créez un jeton et copiez-le. Un jeton ouvre tout le compte (gardez-le secret) ; l’intégration ne fait que lire avec.
• Pour les prévisions : des panneaux solaires, la position de l’installation dans VRM et environ 30 jours d’historique (règle de VRM).

Fraîcheur des données : VRM reçoit les données d’une installation à l’intervalle de journalisation de son appareil GX (Paramètres → Portail VRM en ligne → Intervalle de journalisation ; souvent 15 minutes, 1 minute au mieux). Lire VRM plus souvent n’apporte rien de neuf.

Configuration

Champ	Rôle
Jeton d’accès	Le jeton créé dans VRM (un secret, jamais réaffiché ni écrit dans les journaux)
Lecture des installations	Toutes les 1, 2, 5 (par défaut), 10 ou 15 minutes : une seule requête lit toutes les installations
Niveau du déclencheur « batterie faible »	De 10 à 50 % (20 % par défaut)
Installation hors ligne après	30 min, 1 h (par défaut), 2 h ou 4 h sans nouvelles données dans VRM
Langue des textes	Noms des fonctionnalités, textes des scènes et erreurs ; automatique suit la langue du dernier widget

Boutons :

• Tester la connexion vérifie le jeton et liste les installations du compte, avec l’heure de leurs dernières données.
• Diagnostic écrit l’état de l’intégration dans ses journaux, sans le jeton.

Utilisation

Appareils

Ouvrez Découvrir et ajoutez vos installations. Un appareil d’installation a :

• Niveau de batterie (%), Puissance de charge de la batterie et Puissance de décharge de la batterie (W, toutes deux positives : VRM donne la tension et le courant, la puissance est leur produit), Tension de la batterie (V) ;
• Production solaire (W) et Production solaire du jour (kWh), si l’installation a du solaire ;
• Réseau électrique (W, positif en import, négatif en export), si elle a une entrée réseau ou quai ;
• Consommation AC (W) et Consommation du jour (kWh) ;
• Puissance du groupe électrogène (W), si VRM indique un groupe.

Aucune de ces fonctionnalités n’est comptée comme la consommation de votre maison : un Linky ou un autre compteur continue d’alimenter seul le tableau de bord énergie, sans double comptage. Quand VRM ne reçoit plus rien d’une installation pendant le délai de la configuration, ses valeurs ne sont plus publiées (elles gardent leur dernière valeur et leur heure dans Gladys).

Widgets de tableau de bord

• Victron en direct : niveau de batterie, solaire, consommation AC, réseau (vers ou depuis), batterie (en charge ou en décharge), groupe électrogène quand il tourne ; l’état du système, la tension de la batterie, les alarmes actives et l’heure des dernières données reçues par VRM.
• Victron aujourd’hui : solaire, consommation, import et export réseau du jour, autonomie, un graphique par heure de la production solaire et de la consommation, la batterie chargée et déchargée.
• Prévision Victron : la production solaire attendue aujourd’hui, ce qui reste à venir, demain, la consommation attendue demain, et leur graphique par heure.
• Alarmes Victron : le journal des alarmes VRM, les actives d’abord, puis les dernières terminées.

Choisissez l’installation dans les réglages du widget (vide : la première).

Scènes

Déclencheurs (une fois par changement, jamais à la première lecture) :

• Victron VRM : alarme levée / alarme terminée : une entrée du journal des alarmes VRM (batterie faible, réseau perdu, surcharge, température élevée, erreur d’onduleur…). Variables : le texte de l’alarme, l’appareil Victron, les heures de début et de fin, la durée.
• Victron VRM : batterie faible : la batterie atteint le niveau de la configuration (à nouveau après 5 points de plus). Batterie pleine : 100 % (à nouveau après être repassée sous 95 %).
• Victron VRM : réseau perdu / réseau rétabli : l’alarme réseau du système (secteur ou quai).
• Victron VRM : installation hors ligne / de retour : pas de nouvelles données dans VRM pendant le délai de la configuration.
• Victron VRM : accès refusé : VRM refuse le jeton (révoqué, expiré ou erroné).

Actions :

• Victron VRM : énergies du jour : solaire, consommation, import, export, batterie chargée et déchargée, groupe électrogène, autonomie, niveau de batterie et une phrase, d’après les dernières lectures (sans requête).
• Victron VRM : prévision solaire : solaire du jour, restant aujourd’hui, demain, consommation du jour et de demain (kWh), et une phrase.

Exemples :

• Quand Victron VRM : réseau perdu → envoyer une notification « Coupure de courant, batterie à {{triggerEvent.data.battery_level}} % » et éteindre les radiateurs branchés sur l’onduleur.
• Chaque soir à 21:00 → Victron VRM : prévision solaire ; si solaire demain est sous 5 kWh → allumer le chauffe-eau en heures creuses cette nuit.
• Quand Victron VRM : alarme levée → envoyer une notification avec {{triggerEvent.data.description}}.

Dépannage

• « VRM refuse le jeton d’accès » : le jeton a été supprimé ou mal copié. Créez-en un nouveau dans VRM et collez-le à nouveau (avec ou sans le préfixe Token ).
• Aucune installation : le jeton appartient à un compte qui ne voit aucune installation ; vérifiez sur vrm.victronenergy.com avec le même compte.
• Des valeurs qui ne bougent que toutes les 15 minutes : VRM lui-même reçoit les données à l’intervalle de journalisation de l’appareil GX ; baissez-le sur l’appareil GX (1 minute) si besoin.
• « Pas de prévision » : VRM demande des panneaux solaires, la position de l’installation et environ 30 jours d’historique.
• Pas de journal des alarmes : certains comptes (installations partagées, niveau d’accès faible) peuvent se voir refuser le journal ; le widget l’indique et il est redemandé une fois par jour.
• « VRM demande de ralentir » : VRM a répondu 429 ; l’intégration attend le délai indiqué par VRM (Retry-After), puis reprend toute seule.
• Appuyez sur Diagnostic et regardez les journaux de l’intégration (sans le jeton). Pour un bug, ouvrez une issue sur GitHub avec les versions de Gladys et de l’intégration, et les journaux avec DEBUG=gladys-integration-sdk.

Paramètres de configuration

Voici les paramètres demandés par Victron VRM dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Jeton d’accès VRM	section	Non	Connectez-vous à vrm.victronenergy.com, ouvrez Preferences → Integrations → Access tokens, créez un jeton et collez-le ci-dessous. Un jeton ouvre tout le compte (gardez-le secret) ; cette intégration ne fait que lire. Les données passent par le cloud de Victron. Cette intégration n’est pas affiliée à Victron Energy.
Jeton d’accès	secret	Oui
Lectures et déclencheurs	section	Non	VRM reçoit les données d’une installation à l’intervalle de journalisation de son appareil GX (Paramètres → Portail VRM en ligne → Intervalle de journalisation, souvent 15 minutes) : lire plus souvent n’apporte rien de neuf.
Lecture des installations	select	Non	Fréquence de lecture des dernières valeurs de toutes les installations (une seule requête).
Niveau du déclencheur « batterie faible »	select	Non
Installation hors ligne après	select	Non	Sans nouvelles données dans VRM pendant ce délai, l’installation est hors ligne (déclencheur, widgets) et ses valeurs ne sont plus publiées.
Langue des textes	select	Non	Noms des fonctionnalités, textes des scènes et erreurs. Automatique : la langue du dernier widget affiché.

Comment installer Victron VRM dans Gladys

1. Dans Gladys, ouvrez Intégrations : Victron VRM apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/william-de71/gladys-victron-vrm:0.1.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/William-De71/gladys-victron-vrm.

Victron VRM nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Victron VRM est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par William-De71, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂