Zendure EV Guard

Hoe werkt het?

Vereisten

Installatie

1. Pak het archief uit

Extraheer de inhoud van het ZIP-bestand naar de map van uw keuze, bijvoorbeeld:

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

2. Uitvoeringsrechten (alleen Linux / macOS)

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

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configureer appsettings.json

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

4. Start het programma

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

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

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

# Bekijk de status
sudo systemctl status zendure-evguard

# Bekijk de logs in realtime
sudo journalctl -u zendure-evguard -f

# Herstart na een update
sudo systemctl restart zendure-evguard

# Stop de service
sudo systemctl stop zendure-evguard

Configuratie — appsettings.json

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

⚡ Shelly vereist

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

🔌 Smappee Laadstation optioneel

Het energiepunt Smappee kan op twee manieren worden gebruikt:

• Als EV-detectiebron (alternatief voor de Shelly) — als de Shelly is uitgeschakeld, wordt Smappee de meetbron voor het detecteren van de EV-oplading. 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 nog steeds worden geactiveerd om continu informatie over verbruik (zonne-energie, huis, netwerk) en je Smappee EV Wall (oplaadvermogen, status, enz.) in de logs weer te geven.

🔋 Zendure Batterij vereist

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

🚗 EvDetection

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

📬 Notificatie optioneel

Ontvang e-mails wanneer uw batterijen in de pauze gaan, hervatten of in geval van een fout. Configureer uw SMTP-server.

📴 Pushover optioneel

Pushnotificaties op uw telefoon via Pushover. Maak een applicatie aan op pushover.net om uw API-token te verkrijgen.

💬 Telegram optioneel

Notificaties via een Telegram-bot. Maak een bot met @BotFather en verkrijg uw Chat-ID.

📈 Monitoring optioneel

🔄 Update optioneel

🔑 Licentie na de proefperiode

Na de proefperiode van 30 dagen, voeg uw geheime sleutel toe om de PRO-licentie te activeren. Uw sleutel bevindt zich in uw account op rechtsboven > "Mijn Account". De licentie wordt automatisch op de achtergrond vernieuwd.

Voorbeeld van minimale configuratie

Hier is een voorbeeld dat klaar is voor gebruik. Vervang eenvoudig de IP-adressen door die van uw apparaten:

{
  "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 controleert het programma uw Shelly, detecteert het elk verbruik boven de 5000W (bijvoorbeeld), en herstelt het uw batterijen met een minimum van 10% (100 ÷ 10) en een maximale output van 2400W. De sectie Subscription is standaard leeg: het programma werkt in proefmodus gedurende 30 dagen. Om de PRO licentie te activeren, voeg uw geheime sleutel toe vanuit uw account rechtsboven.

Gratis proefperiode & Abonnement