Zendure EV Guard

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

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.

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

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

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

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

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