Zendure EV Guard

Hoe werkt het?

Vereisten

Installatie

1. Pak het archief uit

Pak de inhoud van het ZIP-bestand uit in de map van je keuze, bijvoorbeeld :

• Windows : C:\ZendureEvGuard\
• Linux : /home/ZendureEvGuard/
• macOS : /Applications/ZendureEvGuard/

2. Uitvoeringsrechten (alleen Linux / macOS)

Op Linux en macOS moet je het bestand uitvoerbaar maken voordat je het start :

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configureer appsettings.json

Open het bestand appsettings.json dat naast het uitvoerbare bestand staat en vul je instellingen in (zie de onderstaande sectie).

4. Start het programma

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

Het programma toont de verbindingsinformatie bij het opstarten. Gebruik P om handmatig te pauzeren, R om te hervatten, en Ctrl+C twee keer om netjes te stoppen.

# 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

Configuratie: appsettings.json

Hier zijn alle parameters die je kunt configureren. De secties Shelly en ZendureDevice zijn verplicht.

Berichten nieuw in 1.3.12

De taal van alles wat je leest: mails, Pushover, Telegram, rapporten na het opladen. De technische logs blijven in het Engels, zodat een foutmelding vindbaar blijft.

Let op de plaatsing: deze sleutel komt onder de sectie Messages, nooit in de hoofdmap van het bestand. Op Linux wordt een sleutel Language in de hoofdmap overschreven door de omgevingsvariabele LANGUAGE van het systeem, en je berichten springen zonder waarschuwing weer terug naar het Engels.

"Messages": {
  "Language": "fr"
}

⚡ Shelly vereist

Configuratie van je Shelly Pro 3EM. Dit is de sensor die het elektriciteitsverbruik van je huis meet.

🔌 Smappee-laadpaal optioneel

De energie laadpaal Smappee kan op twee manieren worden gebruikt :

• Als bron voor EV-detectie (alternatief voor de Shelly): als de Shelly uitgeschakeld is, wordt Smappee de bron van de vermogensmeting om het laden van de EV te detecteren. De detectie gebeurt via de Smappee-cloud-API (blokken van 5 minuten, minder reactief dan de Shelly in realtime).
• Parallel aan de Shelly: als de Shelly actief is als detectiebron, kan Smappee toch actief blijven om continu de verbruiksinformatie (zonne-energie, huis, netwerk) en die van je Smappee EV Wall-laadpaal (laadvermogen, status, enz.) in de logs weer te geven.

🔋 Zendure-batterij vereist

Configuratie van je Zendure SolarFlow 2400 AC-hub of andere. Het IP-adres vind je in de Zendure-app.

EvDetection

Instellingen voor de detectie van het laden van je elektrische voertuig. Het algoritme gebruikt een hysterese : er zijn meerdere opeenvolgende metingen boven de drempel nodig om het laden te bevestigen, en meerdere metingen eronder om de stop te bevestigen.

Energy nieuw in 1.3.12

Aan het einde van elke laadbeurt zegt het programma hoeveel kWh er zijn verbruikt. Geef het je kWh-prijs en het telt het bedrag erbij op. Het is indicatief, geen factuur: niemand meet de laadpaal zelf, en de prijs ligt vast terwijl die van jou dat misschien niet is.

Het gebruik waar ik aan denk: meerdere auto's worden bij jou thuis aangesloten, en elke auto moet weten wat hij heeft verbruikt.

Het rapport geeft twee hoeveelheden energie weer. De energie die aan de meter is gemeten, en die is een feit. En het geschatte aandeel van het voertuig, waarbij het gewone verbruik van het huis ervan wordt afgetrokken: een schatting, en een maximum op het moment waarop je panelen energie terugleverden toen je de auto aansloot.

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

Melding optioneel

Ontvang e-mails wanneer je batterijen pauzeren, weer beginnen, of in geval van een fout. Configureer je SMTP-server.

📴 Pushover optioneel

Pushmeldingen op je telefoon via Pushover. Maak een applicatie aan op pushover.net om je API Token te verkrijgen.

💬 Telegram optioneel

Meldingen via een Telegram-bot. Maak een bot aan met @BotFather en haal je Chat ID op.

Sinds 1.2.0 kun je meerdere groepen tegelijk waarschuwen : twee mensen via een eerste bot, drie anderen via een tweede. Elke verzending staat los van de andere, een onbereikbare ontvanger verhindert niet langer dat de anderen het bericht ontvangen.

"Telegram": {
  "Enabled": true,
  "RateLimitMinutes": 15,
  "Bots": [
    {
      "Name": "Famille",
      "BotToken": "123456:AAExxxxxxxxxxxxxxxxxxxx",
      "ChatIds": [ "11111111", "22222222" ]
    },
    {
      "Name": "Voisins",
      "BotToken": "789012:BBEyyyyyyyyyyyyyyyyyyyy",
      "ChatIds": [ "33333333", "44444444", "55555555" ]
    }
  ]
}

De oude vorm, met één BotToken en ChatId's die door puntkomma's van elkaar worden gescheiden, blijft werken. Als je niets aan je configuratie verandert, blijven je meldingen precies werken zoals voorheen.

📈 Monitoring optioneel

Update optioneel

🔑 Licentie na de proefperiode

Na de proefperiode van 30 dagen voeg je je geheime sleutel toe om de PRO-licentie te activeren. Je sleutel vind je in je account op rechtsboven > "Mijn account". De licentie wordt automatisch op de achtergrond vernieuwd.

Voorbeeld van een minimale configuratie

Hier is een gebruiksklaar voorbeeld. Vervang gewoon de IP-adressen door die van jouw apparaten :

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

Met deze configuratie houdt het programma jouw Shelly in de gaten, detecteert het elk verbruik van meer dan 5000W (bij wijze van voorbeeld), en laadt het jouw batterijen weer op met een minimum van 10% (100 ÷ 10) en een maximaal uitgangsvermogen van 2400W. De sectie Subscription is standaard leeg : het programma werkt 30 dagen in proefmodus. Om de PRO-licentie te activeren, voeg je jouw geheime sleutel toe vanuit je account rechtsboven.

Gratis proefperiode & abonnement