Comment ca fonctionne ?

Prerequis

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
./ZendureEvGuard

3. Configurez appsettings.json

Ouvrez le fichier appsettings.json situe a cote de l'executable et remplissez vos parametres (voir la section ci-dessous).

Ou, beaucoup plus simple, laissez l'assistant le faire. Il pose les questions une par une, montre la valeur actuelle entre crochets (Entrée garde la valeur), teste chaque appareil au fur et à mesure et ne touche qu'aux réglages que vous changez :

# Windows
ZendureEvGuard.exe --setup

# Linux / macOS
./ZendureEvGuard --setup

Le matériel est annoncé d'entrée : un compteur et des batteries Zendure sont requis, une borne Smappee est facultative. Pour le compteur, l'assistant demande simplement lequel : 1 pour le Shelly Pro 3EM (le choix par défaut, Entrée suffit), 2 pour votre propre capteur. Le calibrage du seuil se fait idéalement pendant une vraie charge de la voiture : il mesure la maison avec et sans véhicule et propose la valeur. Pas de voiture sous la main ? On saute l'étape et on garde le seuil actuel. À la fin, il propose de redémarrer le service pour qu'il prenne les nouveaux réglages, ou donne la commande exacte à taper si le service n'est pas encore installé.

Un doute plus tard ? Le diagnostic relit tout sans rien modifier :

./ZendureEvGuard --doctor
./ZendureEvGuard --doctor --notify   # envoie aussi un message de test

4. Lancez le programme

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

Le 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.

# Linux
sudo sh install-linux.sh

# macOS
sudo sh install-macos.sh

# Windows (PowerShell en tant qu'administrateur)
powershell -ExecutionPolicy Bypass -File .\install-windows.ps1

[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.target

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-evguard

Configuration : appsettings.json

Voici tous les parametres que vous pouvez configurer. Les sections Shelly et ZendureDevice sont obligatoires.

Messages

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.

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. Pas de Shelly ? Voyez « Votre propre capteur » juste en dessous.

Votre propre capteur à la place du Shelly

Vous avez déjà un compteur qui mesure votre raccordement, dans Home Assistant, Jeedom, un Tasmota, un ESPHome ou un autre Shelly ? Pas besoin d'acheter un Shelly Pro 3EM : ZendureEvGuard va lire un nombre sur une URL de votre réseau local qui répond en JSON, toutes les 5 secondes. Avec un Shelly Pro 3EM, ignorez simplement cette section : sans elle, tout fonctionne comme avant.

"CustomMeter": {
  "Enabled": true,
  "Url": "http://192.168.1.50:8123/api/states/sensor.puissance_reseau",
  "ValuePath": "state",
  "Unit": "W",
  "InvertSign": false,
  "Authentication": "Bearer",
  "BearerToken": "votre-jeton-longue-duree"
}

Le seul réglage un peu technique, c'est ValuePath : le chemin du nombre dans la réponse. Quelques exemples qui marchent :

• Home Assistant (/api/states/sensor.xxx, jeton longue durée en Bearer) : state
• Shelly Gen1 EM : emeters[0].power
• Shelly Gen2 (/rpc/EM.GetStatus?id=0) : total_act_power
• Tasmota (/cm?cmnd=Status%208) : StatusSNS.ENERGY.Power
• ESPHome (/sensor/xxx) : value
• Jeedom (jeeApi.php, qui rend le nombre seul) : laissez vide

Unit vaut W ou kW, InvertSign sert si votre capteur compte l'export solaire en positif, et Authentication accepte None, Basic (avec Username et Password) ou Bearer. --setup pose toutes ces questions et fait une lecture de test qui affiche la valeur brute et les watts, par exemple lecture 1500 W (valeur lue : 1.5). Au-delà de 60 kW, il vous prévient : c'est presque toujours une confusion entre W et kW.

Attention au choix du capteur : il faut la puissance réseau, au compteur de la maison, positive quand vous soutirez et négative quand vous exportez. Pas un capteur « consommation de la maison », qui compte déjà ce que fournit la batterie et ferait croire à une charge. Et la sécurité reste la même que pour le Shelly : un capteur qui ne répond pas, met plus de 4 secondes ou rend unavailable déclenche la pause de précaution. L'URL, le mot de passe et le jeton n'apparaissent jamais dans les journaux.

🔌 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.

🔋 Batterie Zendure requis

Configuration de votre hub Zendure SolarFlow 2400 AC ou autres. L'adresse IP se trouve dans l'app Zendure.

🚗 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.

Energy

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.

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.

📴 Pushover optionnel

Notifications push sur votre telephone via Pushover. Creez une application sur pushover.net pour obtenir votre API Token. Le plus simple : --setup vous demande la clé et le jeton, puis envoie un message de test avant d'activer le canal.

💬 Telegram optionnel

Notifications via un bot Telegram. Creez un bot avec @BotFather et recuperez votre Chat ID.

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" ]
    }
  ]
}

Et des commandes. Un bot peut aussi recevoir vos ordres. /status donne l'état de la batterie et du compteur, /pause et /resume font exactement ce que font les touches P et R, et /license <votre clé> active une licence (le bot efface aussitôt le message qui contient la clé). C'est désactivé par défaut et ça s'active bot par bot :

{
  "Name": "Commandes",
  "BotToken": "345678:CCFzzzzzzzzzzzzzzzzzzzz",
  "ChatIds": [ "11111111" ],
  "CommandsEnabled": true
}

Seules les conversations listées dans ChatIds sont obéies, une commande de plus de 5 minutes est ignorée, et /resume est refusé pendant une charge (la batterie serait remise en pause au cycle suivant). Perso, je réserve un bot à ces commandes et je ne le mets dans aucun groupe : quiconque peut écrire dans la conversation peut mettre votre batterie en pause.

Pour un seul bot, la forme courte marche aussi : un BotToken et des ChatId séparés par des points-virgules.

📈 Monitoring optionnel

🔄 Update optionnel

🔑 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.

Vous pouvez aussi l'envoyer à votre bot Telegram, sans toucher au fichier : /license <votre clé>. Le bot efface le message, active la licence et répond le résultat (activée jusqu'au, refusée, compte suspendu). Il faut que les commandes soient activées sur ce bot.

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