Zendure EV Guard

Comment ca fonctionne ?

Prerequis

Telechargement — Version 1.0.4

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

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.

sudo useradd -r -s /usr/sbin/nologin zendure
sudo chown -R zendure:zendure /home/ZendureEvGuard

sudo nano /etc/systemd/system/zendure-evguard.service

[Unit]
Description=ZendureEvGuard - EV Charging Battery Protection Daemon
After=network.target

[Service]
Type=simple
WorkingDirectory=/home/ZendureEvGuard
ExecStart=/home/ZendureEvGuard/ZendureEvGuard
Restart=on-failure
RestartSec=10
SyslogIdentifier=zendure-evguard
User=zendure
Environment=DOTNET_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable zendure-evguard
sudo systemctl start 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

# Arreter le service
sudo systemctl stop zendure-evguard

Configuration — appsettings.json

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

⚡ Shelly requis

Configuration de votre Shelly Pro 3EM. C'est le capteur qui mesure la consommation electrique de votre maison.

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

🔋 ZendureDevice requis

Configuration de votre hub Zendure SolarFlow 2400 AC. 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.

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

💬 Telegram optionnel

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

📈 Monitoring optionnel

🔄 Update optionnel

Exemple de configuration minimale

Voici un exemple pret a l'emploi. Remplacez simplement les adresses IP par celles de vos appareils :

{
  "Shelly": {
    "Enabled": true,
    "Host": "192.168.1.50"
  },
  "ZendureDevice": {
    "Host": "192.168.1.127",
    "Port": 80,
    "DefaultOutputLimit": 2400,
    "DefaultMinSoc": 100
  },
  "EvDetection": {
    "PowerThresholdWatts": 5000
  }
}

Avec cette configuration, le programme surveille votre Shelly, detecte toute consommation superieure a 5000W, et restaure vos batteries avec un minimum de 10% (100 ÷ 10) et une sortie maximale de 2400W.

Essai gratuit & Licence