Zendure EV Guard

Wie funktioniert das?

Voraussetzungen

Installation

1. Entpacke das Archiv

Entpacke den Inhalt der ZIP-Datei in das Verzeichnis deiner Wahl, zum Beispiel:

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

2. Ausführungsrechte (nur Linux / macOS)

Unter Linux und macOS musst du die Datei ausführbar machen, bevor du sie startest :

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Konfiguriere appsettings.json

Öffne die Datei appsettings.json, die neben der ausführbaren Datei liegt, und trage deine Einstellungen ein (siehe Abschnitt unten).

4. Starte das Programm

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

Das Programm zeigt beim Start die Verbindungsinformationen an. Verwende P, um manuell zu pausieren, R, um fortzufahren, und Ctrl+C zweimal, um es sauber zu beenden.

# Linux
sudo sh install-linux.sh

# macOS
sudo sh install-macos.sh

# Windows (PowerShell als Administrator)
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

Konfiguration: appsettings.json

Hier sind alle Parameter, die du konfigurieren kannst. Die Abschnitte Shelly und ZendureDevice sind erforderlich.

Nachrichten neu in 1.3.12

Die Sprache für alles, was du liest: Mails, Pushover, Telegram, Berichte zum Ladeende. Die technischen Protokolle bleiben auf Englisch, damit eine Fehlermeldung auffindbar bleibt.

Achte auf die Platzierung: Dieser Schlüssel gehört unter den Abschnitt Messages, nie an die Wurzel der Datei. Unter Linux wird ein an der Wurzel abgelegter Language-Schlüssel von der Umgebungsvariable LANGUAGE des Systems überschrieben, und deine Meldungen wechseln ohne Vorwarnung wieder ins Englische.

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

Shelly erforderlich

Konfiguration deines Shelly Pro 3EM. Das ist der Sensor, der den Stromverbrauch deines Hauses misst.

Borne Smappee optional

Die Smappee-Ladestation kann auf zwei Arten verwendet werden:

• Als EV-Erkennungsquelle (Alternative zu Shelly): Wenn Shelly deaktiviert ist, wird Smappee zur Quelle der Leistungsmessung, um die EV-Ladung zu erkennen. Die Erkennung erfolgt über die Smappee-Cloud-API (5-Minuten-Blöcke, weniger reaktionsschnell als Shelly in Echtzeit).
• Parallel zu Shelly: Wenn Shelly als Erkennungsquelle aktiv ist, kann Smappee trotzdem aktiviert werden, um kontinuierlich die Verbrauchsinformationen (Solar, Haus, Netz) und die Informationen zu deiner Smappee EV Wall (Ladeleistung, Status usw.) in den Logs anzuzeigen.

🔋 Zendure-Batterie erforderlich

Konfiguration deines Zendure SolarFlow 2400 AC Hubs oder anderer Modelle. Die IP-Adresse findest du in der Zendure-App.

EvDetection

Einstellungen für die Ladeerkennung deines Elektrofahrzeugs. Der Algorithmus verwendet eine Hysterese : Mehrere aufeinanderfolgende Messwerte über dem Schwellenwert sind nötig, um eine Ladung zu bestätigen, und mehrere Messwerte darunter, um den Stopp zu bestätigen.

Energie neu in 1.3.12

Am Ende jedes Ladevorgangs sagt dir das Programm, wie viele kWh durchgelaufen sind. Gib ihm den Preis für deine kWh und es fügt den Betrag hinzu. Das ist unverbindlich, keine Rechnung: Niemand misst die Ladestation selbst, und der Preis ist fest, während deiner es vielleicht nicht ist.

Der Anwendungsfall, an den ich denke: Mehrere Autos werden bei dir angeschlossen, und jedes muss wissen, was es verbraucht hat.

Der Bericht beziffert zwei Energiemengen. Die am Zähler gemessene, die eine Tatsache ist. Und der geschätzte Anteil des Fahrzeugs, der den üblichen Verbrauch des Hauses abzieht: eine Schätzung, und ein Maximum, wenn deine Solarpaneele beim Einstecken Strom ins Netz speisten.

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

Benachrichtigung optional

Erhalte E-Mails, wenn deine Batterien pausieren, wieder anlaufen, oder im Fall eines Fehlers. Richte deinen SMTP-Server ein.

📴 Pushover optional

Push-Benachrichtigungen auf deinem Telefon über Pushover. Erstelle eine Anwendung auf pushover.net, um dein API-Token zu erhalten.

💬 Telegram optional

Benachrichtigungen über einen Telegram-Bot. Erstelle einen Bot mit @BotFather und hole deine Chat-ID ab.

Seit 1.2.0 kannst du mehrere Gruppen gleichzeitig benachrichtigen: zwei Personen über einen ersten Bot, drei weitere über einen zweiten. Jeder Versand ist unabhängig, ein nicht erreichbarer Empfänger verhindert nicht mehr, dass die anderen die Nachricht erhalten.

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

Die alte Form mit einem einzigen BotToken und durch Semikolons getrennten ChatId funktioniert weiterhin. Wenn du an deiner Konfiguration nichts änderst, funktionieren deine Benachrichtigungen genau wie zuvor weiter.

Monitoring optional

🔄 Aktualisierung optional

Lizenz nach dem Test

Nach dem 30-tägigen Testzeitraum fügst du deinen geheimen Schlüssel hinzu, um die PRO-Lizenz zu aktivieren. Deinen Schlüssel findest du in deinem Konto unter oben rechts > „Mein Konto“. Die Lizenz erneuert sich automatisch im Hintergrund.

Beispiel für eine minimale Konfiguration

Hier ist ein sofort einsatzbereites Beispiel. Ersetze einfach die IP-Adressen durch die deiner Geräte:

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

Mit dieser Konfiguration überwacht das Programm deinen Shelly, erkennt jeden Verbrauch von über 5000W (zum Beispiel), und lädt deine Batterien mit einem Minimum von 10% (100 ÷ 10) und einer maximalen Leistung von 2400W wieder auf. Der Abschnitt Subscription ist standardmäßig leer: Das Programm funktioniert 30 Tage lang im Testmodus. Um die PRO-Lizenz zu aktivieren, füge deinen geheimen Schlüssel über dein Konto oben rechts hinzu.

Kostenloser Test & Abonnement