Zendure EV Guard
Protegez vos batteries Zendure pendant la charge de votre voiture electrique
Compatible Zendure SolarFlow 2400 AC • Shelly Pro 3EM • Smappee • Windows, Linux, macOS
Vous avez des batteries Zendure et une voiture electrique ?
Vous le savez : quand votre voiture se branche sur la wallbox, elle aspire tout. Vos batteries Zendure se vident a toute vitesse, les cycles s'accumulent, et la duree de vie de vos precieuses cellules fond comme neige au soleil.
Si votre voiture est un vehicule de societe et que l'electricite est payee par votre employeur, c'est dommage de vider vos batteries pour la recharger alors qu'il ne vous restera plus rien le soir pour l'autoconsommation de votre maison.
Autre cas de figure : meme s'il ne s'agit pas d'une voiture de societe, vous souhaitez peut-etre simplement empecher vos batteries de se vider pendant la charge, afin de profiter pleinement de l'electricite produite par vos panneaux solaires en plein soleil, sans puiser dans vos batteries Zendure.
Zendure EV Guard resout ce probleme automatiquement. Des que la charge de votre voiture est detectee, le programme met vos batteries en pause. Quand la charge est terminee, il les reactive. Simple, automatique, sans risque.
Comment ca fonctionne ?
1. Detection
Votre Shelly Pro 3EM (ou Smappee) mesure la consommation. Quand la puissance depasse le seuil (ex: 5000W), le programme sait que votre voiture charge.
2. Protection
Les batteries Zendure passent en mode OFF instantanement. Elles ne se dechargent plus, vos cycles sont preserves.
3. Reprise
Charge terminee ? Le programme reactive vos batteries automatiquement avec vos parametres d'origine. Aucune intervention manuelle.
🔒 100% sans danger pour vos batteries
Zendure EV Guard utilise exclusivement l'API locale HTTP de votre hub Zendure. Il ne touche qu'a deux reglages, ceux-la memes que vous voyez dans l'application Zendure : le minSoc (le plancher de decharge) et l'outputLimit (la puissance de sortie). Pour mettre en pause, il monte le minSoc a 100% et descend la sortie a 0 W. Pour reprendre, il restaure vos valeurs habituelles.
Pourquoi les deux ? Parce qu'un seul ne suffit pas toujours. Si votre hub tourne en mode HEMS, il lui arrive de rouvrir sa sortie tout seul pendant la pause. Le programme s'en apercoit en quelques secondes et referme. Mesure faite chez moi le 22 aout 2026, batterie a 30%, voiture a 18 kW : deux ouvertures, refermees en 10 puis 5 secondes, 2 Wh au total.
Aucun firmware modifie, aucun acces cloud, aucun risque. C'est exactement la meme chose que si vous changiez le reglage manuellement dans l'app Zendure, mais automatiquement et au bon moment.
Nouveau dans la 1.3.12
- Le programme parle francais. Tout ce que vous lisez (mails, Pushover, Telegram, rapports de charge) existe en francais et en anglais. Une cle de configuration,
Messages:Language, et c'est tout. Les journaux techniques restent en anglais, volontairement. - Un rapport a la fin de chaque charge. Combien de kWh sont passes au compteur, combien pour la voiture, la duree, la pointe, la moyenne. Et le cout indicatif, si vous donnez le prix de votre kWh dans
Energy:PricePerKwhCents. - La fuite de pause est mesuree et refermee. Un hub en mode HEMS peut rouvrir sa sortie pendant la pause. Le programme le voit, le chiffre, referme, et vous alerte si ca dure.
- L'archive contient de quoi installer. Un script pour Linux, un pour macOS, un pour Windows, plus le guide utilisateur en francais et en anglais. Plus besoin de recopier un fichier de service a la main.
- Une pause de precaution si le compteur devient muet. Aveugle, le programme ne peut plus voir votre voiture se brancher : il met les batteries a l'abri et les relache a la premiere mesure valide.
- Vos batteries sont remises en service avant l'arret, y compris quand c'est le systeme qui arrete le programme.
Prerequis
| Equipement | Details |
|---|---|
| Zendure SolarFlow 2400 AC | Hub avec API locale HTTP activee (port 80) |
| Shelly Pro 3EM ou Smappee1 requis | Pince amperemetrique (Shelly, temps reel) ou moniteur energetique Smappee (cloud API, blocs de 5 min) pour mesurer la consommation |
| Wallbox / Borne de charge | N'importe quelle borne : la detection se base sur la consommation, pas sur la borne elle-meme |
| PC, Serveur ou NAS | Windows, Linux ou macOS, le programme tourne en arriere-plan 24h/24 |
Installation
1. Dezippez l'archive
Extrayez le contenu du fichier ZIP dans le repertoire de votre choix, par exemple :
- Windows :
C:\ZendureEvGuard\ - Linux :
/home/ZendureEvGuard/ - macOS :
/Applications/ZendureEvGuard/
2. Droits d'execution (Linux / macOS uniquement)
Sur Linux et macOS, vous devez rendre le fichier executable avant de le lancer :
chmod +x ZendureEvGuard
./ZendureEvGuard3. Configurez appsettings.json
Ouvrez le fichier appsettings.json situe a cote de l'executable et remplissez vos parametres (voir la section ci-dessous).
4. Lancez le programme
# Windows
ZendureEvGuard.exe
# Linux / macOS
./ZendureEvGuardLe programme affiche les informations de connexion au demarrage. Utilisez P pour mettre en pause manuellement, R pour reprendre, et Ctrl+C deux fois pour arreter proprement.
5. Installez-le en service (recommande)
Le programme ne protege vos batteries que s'il tourne. Depuis la 1.3.12, l'archive contient un script par systeme : il installe le service, l'active au demarrage et le lance, depuis le dossier ou vous avez dezippe. Rien n'est copie ailleurs.
# Linux
sudo sh install-linux.sh
# macOS
sudo sh install-macos.sh
# Windows (PowerShell en tant qu'administrateur)
powershell -ExecutionPolicy Bypass -File .\install-windows.ps1Sur Windows, le service tourne sous le compte SYSTEM, qui n'a pas le meme espace de donnees que votre session : renseignez bien Subscription.SecretKey dans appsettings.json avant d'installer.
Le fichier README.txt livre dans l'archive detaille chaque commande, la desinstallation et la mise a jour. Et USER_GUIDE_FR.md reprend tous les reglages, hors ligne.
Vous preferez ecrire le service vous-meme ? Sur Linux, voici l'unite que le script installe. Deux lignes ne sont pas decoratives : TimeoutStopSec=120 laisse au programme le temps de remettre vos batteries en service avant que systemd ne le tue, et network-online.target evite qu'il demarre avant que le reseau ne soit reellement la.
[Unit]
Description=ZendureEvGuard - EV Charging Battery Protection Daemon
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
WorkingDirectory=/home/ZendureEvGuard
ExecStart="/home/ZendureEvGuard/ZendureEvGuard"
Restart=on-failure
RestartSec=10
TimeoutStopSec=120
SyslogIdentifier=zendure-evguard
Environment=DOTNET_ENVIRONMENT=Production
[Install]
WantedBy=multi-user.targetPuis les commandes habituelles :
sudo systemctl daemon-reload
sudo systemctl enable --now zendure-evguard
# Voir le statut
sudo systemctl status zendure-evguard
# Voir les logs en temps reel
sudo journalctl -u zendure-evguard -f
# Redemarrer apres une mise a jour
sudo systemctl restart zendure-evguardNe mettez pas de User= dedie sans y avoir reflechi : le programme ecrit ses journaux et son etat de pause a cote de l'executable, et un compte sans droits sur ce dossier le fait echouer au premier redemarrage.
Configuration : appsettings.json
Voici tous les parametres que vous pouvez configurer. Les sections Shelly et ZendureDevice sont obligatoires.
Messages nouveau en 1.3.12
La langue de tout ce que vous lisez : mails, Pushover, Telegram, rapports de fin de charge. Les journaux techniques restent en anglais, pour qu'un message d'erreur reste cherchable.
| Parametre | Description | Defaut |
|---|---|---|
Language | Langue des messages : "en" ou "fr". Toute autre valeur retombe sur l'anglais, sans empecher le demarrage | "en" |
Attention au placement : cette cle va sous la section Messages, jamais a la racine du fichier. Sur Linux, une cle Language posee a la racine est ecrasee par la variable d'environnement LANGUAGE du systeme, et vos messages repassent en anglais sans prevenir.
"Messages": {
"Language": "fr"
}⚡ Shelly requis
Configuration de votre Shelly Pro 3EM. C'est le capteur qui mesure la consommation electrique de votre maison.
| Parametre | Description | Exemple |
|---|---|---|
Enabled | Activer le Shelly comme source de mesure | true |
Host | Adresse IP de votre Shelly Pro 3EM sur votre reseau local | "192.168.1.50" |
UseDigestAuth | Activer si vous avez protege votre Shelly par un mot de passe | false |
Username | Nom d'utilisateur (si auth activee) | "admin" |
Password | Mot de passe (si auth activee) | "monmotdepasse" |
🔌 Borne Smappee optionnel
La borne energetique Smappee peut etre utilise de deux facons :
- Comme source de detection EV (alternative au Shelly) : si le Shelly est desactive, Smappee devient la source de mesure de puissance pour detecter la charge EV. La detection se fait via l'API cloud Smappee (blocs de 5 minutes, moins reactif que le Shelly en temps reel).
- En parallele du Shelly : si le Shelly est actif comme source de detection, Smappee peut quand meme etre active pour afficher en continu les informations de consommation (solaire, maison, reseau) et de votre borne Smappee EV Wall (puissance de charge, etat, etc.) dans les logs.
| Parametre | Description | Exemple |
|---|---|---|
Enabled | Activer Smappee (source de detection si Shelly desactive, ou affichage des infos consommation/borne EV en parallele) | false |
ClientId | Client ID de votre application Smappee (API v3) | "votre-client-id" |
ClientSecret | Client Secret de votre application Smappee | "votre-client-secret" |
Username | Nom d'utilisateur de votre compte Smappee | "user@email.com" |
Password | Mot de passe de votre compte Smappee | "motdepasse" |
ServiceLocationId | ID de votre emplacement Smappee (visible dans le dashboard Smappee, ce n'est pas le numero de serie) | "190802" |
PollingIntervalSeconds | Frequence d'interrogation de l'API Smappee | 30 |
🔋 Batterie Zendure requis
Configuration de votre hub Zendure SolarFlow 2400 AC ou autres. L'adresse IP se trouve dans l'app Zendure.
| Parametre | Description | Exemple |
|---|---|---|
Host | Adresse IP de votre hub Zendure sur le reseau local | "192.168.1.127" |
Port | Port HTTP de l'API locale (80 par defaut) | 80 |
DefaultOutputLimit | Puissance max de sortie en watts a restaurer apres la charge EV | 2400 |
DefaultMinSoc | Plancher de decharge a restaurer apres la charge : le niveau sous lequel vos batteries ne se dechargeront plus (la valeur est ×10 : 100 = 10%, 200 = 20%). Ce n'est pas le niveau de charge maximum. | 100 |
TimeoutSeconds | Delai d'attente pour les requetes vers le hub | 10 |
💡 Comprendre le DefaultMinSoc
Ce parametre definit le plancher de decharge de vos batteries : le niveau sous lequel le hub ne les laissera plus se vider. La valeur est multipliee par 10 dans l'API Zendure :
100= les batteries peuvent descendre jusqu'a 10%200= les batteries peuvent descendre jusqu'a 20%500= les batteries s'arretent a 50%, et la moitie de votre capacite ne sert plus a rien
A ne pas confondre avec le plafond de charge. Le niveau auquel vos batteries arretent de se charger, c'est socSet, un autre reglage, celui que vous voyez dans l'application Zendure. Mettre 950 ici ne veut donc pas dire "charge jusqu'a 95%" mais "ne descends jamais sous 95%" : vos batteries deviennent inutilisables. Depuis la 1.3.0, le programme refuse de demarrer avec une valeur hors de 1 a 999, et vous previent au-dela de 500.
A vous de choisir ! Plus la valeur est basse, plus vous utilisez vos batteries ; plus elle est haute, plus vous menagez les cellules, au prix de la capacite disponible. La plupart des utilisateurs choisissent entre 100 (10%) et 200 (20%).
🚗 EvDetection
Reglages de la detection de charge de votre vehicule electrique. L'algorithme utilise une hysterese : il faut plusieurs lectures consecutives au-dessus du seuil pour confirmer une charge, et plusieurs lectures en-dessous pour confirmer l'arret.
| Parametre | Description | Defaut |
|---|---|---|
PowerThresholdWatts | Seuil de puissance (en watts) au-dela duquel le programme considere qu'une voiture charge. Adaptez-le a votre wallbox. | 5000 |
ConfirmationReadings | Nombre de lectures consecutives au-dessus du seuil pour confirmer le debut de la charge | 2 |
ReleaseReadings | Nombre de lectures consecutives sous le seuil pour confirmer la fin de la charge (24 = ~2 minutes a 5s/lecture) | 24 |
PollingIntervalSeconds | Frequence de mesure en secondes | 5 |
PauseOnSourceUnreachableMinutes | Nouveau en 1.3.0. Duree pendant laquelle le compteur peut rester injoignable avant que les batteries soient mises en pause par precaution : aveugle, le programme ne peut plus voir votre voiture se brancher. La pause est levee des la premiere mesure valide. Mettez 0 pour desactiver ce garde-fou. | 3 |
NotifyPrecautionaryPauseAfterMinutes | Une pause de precaution s'applique tout de suite, mais elle ne vous est annoncee qu'au-dela de cette duree : un compteur qui cligne trois secondes ne vaut pas un mail | 30 |
SourceUnreachableReleaseMinutes | Duree au-dela de laquelle une pause de precaution est relachee alors que le compteur est toujours muet | 10 |
ReleaseHysteresisWatts | Marge sous le seuil a repasser pour confirmer la fin de charge. Evite le va-et-vient quand la consommation oscille juste autour du seuil | 500 |
PostResumeCooldownSeconds | Delai apres une reprise pendant lequel une nouvelle detection est ignoree | 60 |
Energy nouveau en 1.3.12
A la fin de chaque charge, le programme vous dit combien de kWh sont passes. Donnez-lui le prix de votre kWh et il ajoute le montant. C'est indicatif, pas une facture : personne ne mesure la borne elle-meme, et le prix est fixe alors que le votre ne l'est peut-etre pas.
L'usage auquel je pense : plusieurs voitures se branchent chez vous, et chacune doit savoir ce qu'elle a consomme.
| Parametre | Description | Defaut |
|---|---|---|
PricePerKwhCents | Prix du kWh en centimes entiers (28 = 0,28 EUR). Mettez 0 pour ne rien afficher. Un nombre a virgule est refuse et lu comme 0, sans empecher le demarrage | 28 |
Le rapport chiffre deux energies. Celle mesuree au compteur, qui est un fait. Et la part estimee du vehicule, qui retire la consommation habituelle de la maison : une estimation, et un maximum quand vos panneaux exportaient au moment de brancher.
Charge terminee : 1h03 | 11,30 kWh au compteur (3,16 EUR) |
~11,30 kWh pour le vehicule (3,16 EUR) | pointe 14627 W | moyenne 11169 W📬 Notification optionnel
Recevez des emails quand vos batteries se mettent en pause, reprennent, ou en cas d'erreur. Configurez votre serveur SMTP.
| Parametre | Description | Defaut |
|---|---|---|
Enabled | Activer les notifications email | false |
SmtpHost | Serveur SMTP (ex: smtp.gmail.com) | "" |
SmtpPort | Port SMTP | 587 |
UseSsl | Utiliser TLS/SSL | true |
Username / Password | Identifiants SMTP | "" |
FromAddress | Adresse email de l'expediteur | "" |
ToAddress | Destinataire(s), separes par ; pour plusieurs | "" |
RateLimitMinutes | Intervalle minimum entre deux alertes (anti-spam) | 15 |
📴 Pushover optionnel
Notifications push sur votre telephone via Pushover. Creez une application sur pushover.net pour obtenir votre API Token.
| Parametre | Description |
|---|---|
Enabled | Activer Pushover (true / false) |
ApiToken | Token API de votre application Pushover |
UserKey | Votre cle utilisateur Pushover |
RateLimitMinutes | Intervalle minimum entre alertes (defaut: 15) |
💬 Telegram optionnel
Notifications via un bot Telegram. Creez un bot avec @BotFather et recuperez votre Chat ID.
| Parametre | Description |
|---|---|
Enabled | Activer Telegram (true / false) |
Bots | Liste de bots. Chacun porte son Name, son BotToken et sa liste ChatIds. C'est ce qui permet de prévenir des personnes différentes dans des groupes différents |
RateLimitMinutes | Intervalle minimum entre alertes (défaut : 15) |
Depuis la 1.2.0, vous pouvez prévenir plusieurs groupes à la fois : deux personnes via un premier bot, trois autres via un second. Chaque envoi est isolé, un destinataire injoignable n'empêche plus les autres de recevoir le message.
"Telegram": {
"Enabled": true,
"RateLimitMinutes": 15,
"Bots": [
{
"Name": "Famille",
"BotToken": "123456:AAExxxxxxxxxxxxxxxxxxxx",
"ChatIds": [ "11111111", "22222222" ]
},
{
"Name": "Voisins",
"BotToken": "789012:BBEyyyyyyyyyyyyyyyyyyyy",
"ChatIds": [ "33333333", "44444444", "55555555" ]
}
]
}L'ancienne forme, avec un seul BotToken et des ChatId séparés par des points-virgules, continue de fonctionner. Si vous ne changez rien à votre configuration, vos notifications continuent exactement comme avant.
📈 Monitoring optionnel
| Parametre | Description | Defaut |
|---|---|---|
HealthCheckIntervalSeconds | Frequence de verification de la connectivite des appareils | 30 |
LogStatusIntervalSeconds | Frequence de log du statut complet dans les fichiers de log | 300 |
PostResumeGuardSeconds | Duree pendant laquelle le programme verifie que le hub a bien garde vos reglages apres une reprise | 300 |
DeviceUnreachableAlertMinutes | Duree d'injoignabilite d'un appareil au-dela de laquelle vous etes alerte | 60 |
🔄 Update optionnel
Depuis la 1.2.0, le programme ne se met plus à jour tout seul. Il vérifie une fois par heure si une version plus récente existe, et il se contente de vous prévenir : un rappel dans les logs à chaque heure tant que vous n'avez pas installé la nouvelle version, et un seul message sur les canaux que vous avez configurés, avec le lien de téléchargement direct.
Remplacer le binaire d'un service qui protège vos batteries pendant qu'il tourne, c'est le geste le plus risqué du produit. Autant que ce soit vous qui décidiez du moment. Les anciennes clés AutoUpdateEnabled et CheckIntervalHours ne sont plus lues : vous pouvez les laisser dans votre fichier, elles sont ignorées.
| Parametre | Description | Defaut |
|---|---|---|
CheckEnabled | Vérifier chaque heure si une version plus récente existe | true |
NotifyOnNewVersion | Envoyer un message sur vos canaux de notification à la première détection d'une version. Une seule fois par version, jamais de relance | true |
🔑 License apres l'essai
Apres la periode d'essai de 30 jours, ajoutez votre clef secrete pour activer la licence PRO. Votre clef se trouve dans votre compte sur en haut à droite > "Mon Compte". La licence se renouvelle automatiquement en arriere-plan.
| Parametre | Description | Exemple |
|---|---|---|
SecretKey | Votre clef secrete unique (GUID) depuis votre compte digital3d.com. Laissez vide pour utiliser le mode essai. | d79d24cc-eb02-48d7-94f8-xxxxxxxxxxxx |
Exemple de configuration minimale
Voici un exemple pret a l'emploi. Remplacez simplement les adresses IP par celles de vos appareils :
{
"Messages": {
"Language": "fr"
},
"Energy": {
"PricePerKwhCents": 28
},
"Shelly": {
"Enabled": true,
"Host": "192.168.1.50"
},
"ZendureDevice": {
"Host": "192.168.1.127",
"Port": 80,
"DefaultOutputLimit": 2400,
"DefaultMinSoc": 100
},
"EvDetection": {
"PowerThresholdWatts": 5000
},
"Subscription": {
"SecretKey": "d79d24cc-eb02-48d7-94f8-xxxxxxxxxxxx"
}
}Avec cette configuration, le programme surveille votre Shelly, detecte toute consommation superieure a 5000W (pour exemple), et restaure vos batteries avec un minimum de 10% (100 ÷ 10) et une sortie maximale de 2400W. La section Subscription est vide par defaut : le programme fonctionne en mode essai pendant 30 jours. Pour activer la licence PRO, ajoutez votre clef secrete depuis votre compte en haut à droite.
Essai gratuit & Abonnement
🎉 30 jours d'essai gratuit, sans engagement !
Telechargez Zendure EV Guard et testez-le pendant 30 jours complets, sans rien payer et sans limite de fonctionnalites. Vous aurez acces a 100% des fonctions pour vous assurer que le programme correspond parfaitement a votre installation.
A l'issue des 30 jours, un abonnement Digital3D est necessaire pour continuer a utiliser le programme. Un seul abonnement vous donne acces a toutes les applications Digital3D (CompactForIA, AutoMouseMove, Zendure EV Guard, etc.).
🔑 Comment activer votre licence
- Souscrivez a un abonnement sur "One for All"
- Connectez-vous a votre compte sur digital3d.com et copiez votre clef secrete (un identifiant unique au format GUID, par exemple :
f89f26cc-eb03-48d7-94f8-xxxxxxxxxxxx) - Ouvrez le fichier
appsettings.jsonet ajoutez votre clef dans la sectionSubscription:"Subscription": { "SecretKey": "votre-clef-secrete-guid" } - Redemarrez le programme : la licence PRO s'active automatiquement et se renouvelle sans aucune intervention de votre part.
Pret a proteger vos batteries ?
Telechargez gratuitement, configurez en 5 minutes, et dormez tranquille.
Abonnement « One for All » : un seul abonnement pour toutes les applications Digital3D.
Rejoignez la conversation
Vous devez avoir un compte pour commenter cet article. La création est gratuite et prend moins d'une minute.
Aucun commentaire pour le moment.