Intégration domotique evcc, gratuite et open source
Recharge solaire avec evcc : flux d'énergie, points de charge, véhicules, modes et limites.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration amène evcc dans Gladys. evcc pilote la recharge des véhicules électriques avec le surplus solaire, les tarifs dynamiques ou un plan de charge. Gladys suit evcc en direct (production solaire, maison, réseau, batterie, points de charge, véhicules), change le mode de charge et les limites, et déclenche des scènes quand un véhicule est branché ou qu'une charge se termine.
L'intégration parle à evcc sur votre réseau local, sans cloud. Elle a été développée et testée contre le mode démo d'evcc (versions 0.210 et 0.317), sans borne réelle : vos retours sont les bienvenus.
Prérequis
- Gladys Assistant 5.1 ou plus récent.
- Un evcc qui tourne sur votre réseau (Raspberry Pi, Docker, Home Assistant…), version 0.200 ou plus récente conseillée. Les versions plus anciennes sont lues au mieux.
- L'adresse d'evcc, telle que vous l'ouvrez dans votre navigateur, par exemple
http://192.168.1.20:7070. Gladys doit pouvoir la joindre.
Configuration
- Intégrations → evcc, puis Configuration.
- Adresse d'evcc : l'adresse de son interface web. Sans port, le 7070 est utilisé. Derrière un
proxy inverse, un chemin est accepté (
https://exemple.org/evcc). - Mot de passe administrateur : facultatif. Les versions récentes d'evcc changent le mode et les limites sans lui. Si votre evcc (ou votre proxy) répond « non autorisé », saisissez-le.
- Langue des noms de fonctionnalités : le français par défaut. Les noms sont figés quand vous ajoutez l'appareil.
- Enregistrez, puis cliquez sur Tester la connexion : la version d'evcc et le nombre de points de charge et de véhicules s'affichent.
- Dans l'onglet Découverte, ajoutez les appareils voulus.
L'intégration suit evcc par son websocket : les valeurs arrivent à chaque cycle d'evcc (30 s par défaut). Si le websocket tombe, elle relit l'état toutes les 30 s et le reconnecte seule.
Les appareils
Site
Un appareil au nom de votre site evcc, avec ce que evcc mesure :
| Fonctionnalité | Détail |
|---|---|
| Production solaire | W, si evcc a un compteur photovoltaïque |
| Consommation maison | W |
| Réseau | W, positif quand la maison soutire, négatif quand elle injecte |
| Batterie maison | niveau en %, puissance de charge et de décharge en W, s'il y a une batterie |
| Prix du réseau | prix courant du kWh, si un tarif est configuré dans evcc |
Point de charge
Un appareil par point de charge d'evcc :
| Fonctionnalité | Détail |
|---|---|
| Mode | pilotable : Arrêt, Solaire, Min + solaire, Rapide |
| État de la charge | en charge, branché, en attente (evcc attend le soleil ou un créneau), pause (véhicule plein), inactif |
| Véhicule branché | oui ou non |
| Puissance de charge | kW |
| Intensité de charge | A |
| Énergie de la session | kWh chargés depuis le branchement |
| Temps restant | minutes, estimation d'evcc pendant la charge |
| Limite de charge | pilotable : niveau de batterie visé pour cette session, en % |
| Véhicule | nom du véhicule identifié par evcc |
| Charge au prix bas | evcc charge parce que le réseau est bon marché (tarif dynamique) |
| Compteur de la borne | index en kWh, si la borne a un compteur : Gladys en déduit la consommation et son coût dans le suivi d'énergie |
Depuis evcc 0.317, le mode « Solaire » s'appelle Smart dans evcc, et « Min + solaire » est Smart avec l'option Toujours charger. L'intégration garde les quatre modes historiques, compris par toutes les versions d'evcc.
Un équipement intégré (pompe à chaleur, prise pilotée par evcc) n'a que le mode, l'état, la puissance, l'énergie et le compteur.
Véhicule
Un appareil par véhicule configuré dans evcc :
| Fonctionnalité | Détail |
|---|---|
| Niveau de batterie | %, connu quand le véhicule est branché (la dernière valeur reste) |
| Autonomie | km, idem |
| Limite de charge | pilotable : niveau de batterie maximum du véhicule dans evcc, en % |
| Branché | le véhicule est branché sur un point de charge |
| Plan de charge | le prochain plan (niveau et heure), ou « Aucun plan » |
Widget de tableau de bord
Le widget evcc montre le flux d'énergie (solaire, maison, réseau en kW), la batterie maison, le prix du réseau et une ligne par point de charge (état, puissance, mode). Quatre boutons changent le mode d'un point de charge : celui choisi dans les réglages du widget, sinon le premier. Le mode courant porte une coche. Si evcc ne répond plus, le widget montre les dernières valeurs connues, sans boutons.
Déclencheurs de scène
| Déclencheur | Quand | Variables |
|---|---|---|
| Véhicule branché | un véhicule est branché, une fois identifié par evcc (2 minutes au plus) | point de charge, véhicule |
| Véhicule débranché | un véhicule est débranché | point de charge, véhicule, énergie chargée (kWh), durée branché (minutes) |
| Charge démarrée | une charge démarre ; une courte pause (nuages) n'est pas une nouvelle charge | point de charge, véhicule, mode |
| Charge terminée | la charge est arrêtée depuis 10 minutes, ou le véhicule est débranché | point de charge, véhicule, énergie (kWh), durée de charge (minutes), part solaire (%) |
| Mode de charge changé | le mode d'un point de charge change, dans evcc ou depuis Gladys | point de charge, nouveau mode, mode précédent |
Dans un message, une variable s'écrit {{triggerEvent.data.vehicle}}, {{triggerEvent.data.energy_kwh}}…
Chaque déclencheur peut être limité à un point de charge et, sauf le changement de mode, à un véhicule. Le changement de mode peut être limité à un mode.
Actions de scène
| Action | Effet |
|---|---|
| Changer le mode de charge | Arrêt, Solaire, Min + solaire ou Rapide sur un point de charge |
| Régler une limite de charge | niveau de batterie (%) d'un point de charge ou d'un véhicule, ou énergie (kWh) d'un point de charge ; 0 retire la limite |
Une action refusée (evcc injoignable, valeur hors bornes, appareil qui n'est pas un point de charge) échoue avec un message clair, et la scène continue.
Exemples de scènes
- Charge rapide le soir si la batterie est basse : à 21 h, si le niveau de batterie du véhicule est sous 30 %, changer le mode du point de charge en Rapide, puis régler la limite à 60 %.
- Prévenir quand la voiture est pleine : déclencheur « Charge terminée » sur votre véhicule,
envoyer « Charge terminée :
{{triggerEvent.data.energy_kwh}}kWh, dont{{triggerEvent.data.solar_percent}}% de solaire ». - Retour au solaire au départ : déclencheur « Véhicule débranché », changer le mode en Solaire pour que la prochaine charge reparte sur le surplus.
Dépannage
- « evcc ne répond pas à l'adresse configurée » : ouvrez l'adresse dans un navigateur depuis le réseau de Gladys. Vérifiez le port (7070 par défaut) et qu'aucun pare-feu ne bloque Gladys.
- « L'adresse configurée ne répond pas comme evcc » : l'adresse pointe vers un autre service, ou un proxy renvoie une page d'erreur.
- « evcc demande son mot de passe administrateur » : saisissez-le dans la configuration.
- Le niveau de batterie d'un véhicule ne bouge pas : evcc ne lit le véhicule que lorsqu'il est branché (ou s'il a une intégration constructeur). La dernière valeur reste affichée.
- « Véhicule branché » arrive avec un véhicule vide : evcc n'a pas identifié le véhicule en 2 minutes. Vérifiez l'identification dans evcc, ou associez un véhicule par défaut au point de charge.
- Journaux détaillés : ajoutez la variable
LOG_LEVEL=debugau conteneur.
Limites
- Une seule instance evcc par installation de l'intégration.
- Les plans de charge se lisent mais ne se créent pas depuis Gladys (utilisez evcc).
- Les plans répétitifs (chaque jour de la semaine) ne sont pas affichés.
- Le nombre de phases, le courant minimum et maximum, la batterie maison et les réglages avancés restent dans evcc.
- Développée sans borne réelle, contre le mode démo d'evcc : vos retours sont les bienvenus sur le forum de Gladys.
- Projet indépendant, non affilié à evcc.
Paramètres de configuration
Voici les paramètres demandés par evcc dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter votre evcc | section | Non | Saisissez l'adresse d'evcc telle que vous l'ouvrez dans votre navigateur (port 7070 par défaut). L'intégration suit evcc en direct par son websocket. Le mot de passe administrateur n'est utile que si votre evcc le demande pour changer un mode ou une limite. |
| Adresse d'evcc | string | Oui | Sans port, 7070 est utilisé. Un chemin est accepté derrière un proxy inverse. |
| Mot de passe administrateur (facultatif) | secret | Non | Les versions récentes d'evcc changent modes et limites sans lui. |
| Langue des noms de fonctionnalités | select | Non |
Comment installer evcc dans Gladys
- Dans Gladys, ouvrez Intégrations : evcc apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-evcc:1.0.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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-evcc.
evcc 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
evcc 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 guim31, 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