Haben Sie Zendure-Batterien? Und laden Sie Ihr Auto gleichzeitig? Nicht gut… 😉

Zendure EV Guard

Schützen Sie Ihre Zendure-Batterien während des Ladevorgangs Ihres Elektroautos

Kompatibel mit Zendure SolarFlow 2400 AC • Shelly Pro 3EM • Smappee • Windows, Linux, macOS

Wie funktioniert das?

1. Erkennung

Ihr Shelly Pro 3EM (oder Smappee) misst den Verbrauch. Wenn die Leistung den Schwellenwert überschreitet (z. B.: 5000W), weiß das Programm, dass Ihr Auto lädt.

🔋

2. Schutz

Die Zendure-Batterien gehen sofort in den OFF-Modus. Sie entladen sich nicht mehr, Ihre Zyklen werden erhalten.

3. Wiederaufnahme

Ladevorgang beendet? Das Programm aktiviert Ihre Batterien automatisch mit Ihren ursprünglichen Einstellungen. Keine manuelle Intervention.

🔒 100% sicher für Ihre Batterien

Zendure EV Guard verwendet ausschließlich die lokale HTTP-API Ihres Zendure-Hubs. Es ändert nur einen einzigen Parameter: den minSoc (minimaler Ladezustand). Um zu pausieren, setzt es den minSoc auf 100% — was eine Entladung verhindert. Um wieder aufzunehmen, stellt es Ihren gewohnten Wert wieder her (z. B. 10%).

Keine geänderte Firmware, kein Cloud-Zugriff, kein Risiko. Es ist genau dasselbe, als würden Sie die Einstellung manuell in der Zendure-App ändern, aber automatisch und zur richtigen Zeit.

Voraussetzungen

AusrüstungDetails
Zendure SolarFlow 2400 ACHub mit aktivierter lokaler HTTP-API (Port 80)
Shelly Pro 3EM oder Smappee1 erforderlichStromzange (Shelly, Echtzeit) oder Energiemonitor Smappee (Cloud-API, Blöcke von 5 Minuten) zur Messung des Verbrauchs
Wallbox / LadestationJede Ladestation — die Erkennung basiert auf dem Verbrauch, nicht auf der Ladestation selbst
PC, Server oder NASWindows, Linux oder macOS — das Programm läuft im Hintergrund 24/7
 

Installation

1. Entpacken Sie das Archiv

Extrahieren Sie den Inhalt der ZIP-Datei in das Verzeichnis Ihrer Wahl, zum Beispiel:

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

2. Ausführungsrechte (nur Linux / macOS)

Unter Linux und macOS müssen Sie die Datei ausführbar machen, bevor Sie sie starten:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Konfigurieren Sie appsettings.json

Öffnen Sie die Datei appsettings.json, die neben der ausführbaren Datei liegt, und füllen Sie Ihre Einstellungen aus (siehe den Abschnitt unten).

4. Starten Sie das Programm

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

Das Programm zeigt die Anmeldeinformationen beim Start an. Verwenden Sie P, um manuell zu pausieren, R, um fortzufahren, und Ctrl+C zweimal, um ordnungsgemäß zu beenden.

Linux-Tipp: Damit das Programm dauerhaft läuft, auch nach der Abmeldung, installieren Sie es als systemd-Dienst. So geht's:

a) Erstellen Sie einen dedizierten Benutzer (optional, aber empfohlen):

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

b) Erstellen Sie die Dienstdatei:

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

Fügen Sie den folgenden Inhalt ein:

[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

c) Aktivieren und starten Sie den Dienst:

sudo systemctl daemon-reload
sudo systemctl enable zendure-evguard
sudo systemctl start zendure-evguard

d) Nützliche Befehle:

# Status anzeigen
sudo systemctl status zendure-evguard

# Logs in Echtzeit anzeigen
sudo journalctl -u zendure-evguard -f

# Nach einem Update neu starten
sudo systemctl restart zendure-evguard

# Dienst stoppen
sudo systemctl stop zendure-evguard

Konfiguration — appsettings.json

Hier sind alle Parameter, die Sie konfigurieren können. Die Abschnitte Shelly und ZendureDevice sind erforderlich.

⚡ Shelly erforderlich

Konfiguration Ihres Shelly Pro 3EM. Dies ist der Sensor, der den Stromverbrauch Ihres Hauses misst.

ParameterBeschreibungBeispiel
EnabledAktivieren Sie Shelly als Messquelletrue
HostIP-Adresse Ihres Shelly Pro 3EM in Ihrem lokalen Netzwerk"192.168.1.50"
UseDigestAuthAktivieren, wenn Sie Ihren Shelly mit einem Passwort geschützt habenfalse
UsernameBenutzername (wenn Auth aktiviert)"admin"
PasswordPasswort (wenn Auth aktiviert)"meinpasswort"

🔌 Smappee-Ladestation optional

Die Energieeinheit Smappee kann auf zwei Arten verwendet werden:

  • Als EV-Erkennungsquelle (Alternative zu Shelly) — wenn Shelly deaktiviert ist, wird Smappee zur Messquelle für die Erkennung des EV-Ladevorgangs. Die Erkennung erfolgt über die Smappee-Cloud-API (5-Minuten-Blöcke, weniger reaktiv als Shelly in Echtzeit).
  • Parallel zu Shelly — wenn Shelly aktiv ist als Erkennungsquelle, kann Smappee dennoch aktiviert werden, um kontinuierlich Verbrauchsinformationen (Solar, Haus, Netz) und von Ihrer Smappee EV Wall-Ladestation (Ladeleistung, Status usw.) in den Protokollen anzuzeigen.
ParameterBeschreibungBeispiel
EnabledAktivieren Sie Smappee (Erkennungsquelle, wenn Shelly deaktiviert ist, oder Anzeige von Verbrauchsinformationen/EV-Ladestation parallel)false
ClientIdClient-ID Ihrer Smappee-Anwendung (API v3)"ihre-client-id"
ClientSecretClient-Secret Ihrer Smappee-Anwendung"ihr-client-secret"
UsernameBenutzername Ihres Smappee-Kontos"user@email.com"
PasswordPasswort Ihres Smappee-Kontos"passwort"
ServiceLocationIdID Ihres Smappee-Standorts (sichtbar im Smappee-Dashboard, dies ist nicht die Seriennummer)"190802"
PollingIntervalSecondsAbfragefrequenz der Smappee-API30
EvThresholdWattsLeistungsgrenze, um zu bestimmen, dass die EV-Ladestation lädt (nur Anzeige von Informationen)1400

🔋 Zendure-Batterie erforderlich

Konfiguration Ihres Zendure SolarFlow 2400 AC-Hubs oder anderer. Die IP-Adresse finden Sie in der Zendure-App.

ParameterBeschreibungBeispiel
HostIP-Adresse Ihres Zendure-Hubs im lokalen Netzwerk"192.168.1.127"
PortHTTP-Port der lokalen API (standardmäßig 80)80
DefaultOutputLimitMaximale Ausgangsleistung in Watt, die nach dem Laden des EV wiederhergestellt werden soll2400
DefaultMinSocMinimale Ladeleistung, die wiederhergestellt werden soll (der Wert wird ×10 multipliziert: 100 = 10%, 950 = 95%). Dies ist der Schwellenwert, unter dem Ihre Batterien nicht mehr entladen werden.100
TimeoutSecondsWartezeit für Anfragen an den Hub10

💡 Verstehen des DefaultMinSoc

Dieser Parameter definiert den minimalen Ladezustand Ihrer Batterien nach der Wiederherstellung. Der Wert wird in der Zendure-API mit 10 multipliziert:

  • 100 = die Batterien können bis auf 10% sinken
  • 200 = die Batterien können bis auf 20% sinken
  • 950 = die Batterien hören bei 95% auf (sehr konservativer Modus)

Sie haben die Wahl! Ein niedriger minSoc (100-200) maximiert die Nutzung Ihrer Batterien. Ein hoher minSoc (800-950) schont die Lebensdauer der Zellen. Die meisten Benutzer wählen zwischen 100 (10%) und 200 (20%).

🚗 EvDetection

Einstellungen zur Erkennung des Ladevorgangs Ihres Elektrofahrzeugs. Der Algorithmus verwendet eine Hysterese: Es sind mehrere aufeinanderfolgende Messungen über dem Schwellenwert erforderlich, um einen Ladevorgang zu bestätigen, und mehrere Messungen darunter, um das Ende zu bestätigen.

ParameterBeschreibungStandard
PowerThresholdWattsLeistungsgrenze (in Watt), ab der das Programm annimmt, dass ein Auto lädt. Passen Sie es an Ihre Wallbox an.5000
ConfirmationReadingsAnzahl der aufeinanderfolgenden Messungen über dem Schwellenwert, um den Beginn des Ladevorgangs zu bestätigen2
ReleaseReadingsAnzahl der aufeinanderfolgenden Messungen unter dem Schwellenwert, um das Ende des Ladevorgangs zu bestätigen (24 = ~2 Minuten bei 5s/Messung)24
PollingIntervalSecondsMessfrequenz in Sekunden5

📬 Benachrichtigung optional

Erhalten Sie E-Mails, wenn Ihre Batterien pausieren, wieder aufnehmen oder im Fehlerfall. Konfigurieren Sie Ihren SMTP-Server.

ParameterBeschreibungStandard
EnabledE-Mail-Benachrichtigungen aktivierenfalse
SmtpHostSMTP-Server (z.B.: smtp.gmail.com)""
SmtpPortSMTP-Port587
UseSslTLS/SSL verwendentrue
Username / PasswordSMTP-Anmeldeinformationen""
FromAddressE-Mail-Adresse des Absenders""
ToAddressEmpfänger, durch ; für mehrere getrennt""
RateLimitMinutesMinimales Intervall zwischen zwei Benachrichtigungen (Anti-Spam)15

📴 Pushover optional

Push-Benachrichtigungen auf Ihrem Telefon über Pushover. Erstellen Sie eine Anwendung auf pushover.net, um Ihr API-Token zu erhalten.

ParameterBeschreibung
EnabledPushover aktivieren (true / false)
ApiTokenAPI-Token Ihrer Pushover-Anwendung
UserKeyIhr Pushover-Benutzerschlüssel
RateLimitMinutesMinimales Intervall zwischen Benachrichtigungen (Standard: 15)

💬 Telegram optional

Benachrichtigungen über einen Telegram-Bot. Erstellen Sie einen Bot mit @BotFather und holen Sie sich Ihre Chat-ID.

ParameterBeschreibung
EnabledTelegram aktivieren (true / false)
BotTokenToken Ihres Telegram-Bots (bereitgestellt von @BotFather)
ChatIdID des Chats, in den die Nachrichten gesendet werden (mehrere durch ; getrennt)
RateLimitMinutesMinimales Intervall zwischen Warnungen (Standard: 15)

📈 Überwachung optional

ParameterBeschreibungStandard
HealthCheckIntervalSecondsFrequenz der Überprüfung der Konnektivität der Geräte30
LogStatusIntervalSecondsFrequenz des vollständigen Statusprotokolls in den Logdateien300

🔄 Update optional

ParameterBeschreibungStandard
AutoUpdateEnabledAutomatische Überprüfung von Updates aktivierentrue
CheckIntervalHoursÜberprüfungsintervall (in Stunden)4

🔑 Lizenz nach der Testphase

Nach der 30-tägigen Testphase fügen Sie Ihren geheimen Schlüssel hinzu, um die PRO-Lizenz zu aktivieren. Ihr Schlüssel befindet sich in Ihrem Konto unter oben rechts > "Mein Konto". Die Lizenz wird automatisch im Hintergrund erneuert.

ParameterBeschreibungBeispiel
SecretKeyIhr einzigartiger geheimer Schlüssel (GUID) aus Ihrem Konto digital3d.com. Lassen Sie es leer, um den Testmodus zu verwenden.d79d24cc-eb02-48d7-94f8-xxxxxxxxxxxx

Beispiel für eine minimale Konfiguration

Hier ist ein einsatzbereites Beispiel. Ersetzen Sie einfach die IP-Adressen durch die Ihrer Geräte:

{
  "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 Ihr Shelly, erkennt jeden Verbrauch über 5000W (zum Beispiel) und stellt Ihre Batterien mit einem Minimum von 10% (100 ÷ 10) und einer maximalen Ausgabe von 2400W wieder her. Der Abschnitt Subscription ist standardmäßig leer: Das Programm läuft 30 Tage im Testmodus. Um die PRO-Lizenz zu aktivieren, fügen Sie Ihren geheimen Schlüssel aus Ihrem Konto oben rechts hinzu.

Kostenloser Test & Abonnement

🎉 30 Tage kostenloser Test — ohne Verpflichtung!

Laden Sie Zendure EV Guard herunter und testen Sie es für 30 volle Tage, ohne etwas zu bezahlen und ohne Funktionsbeschränkungen. Sie haben Zugriff auf 100% der Funktionen, um sicherzustellen, dass das Programm perfekt zu Ihrer Installation passt.

Nach Ablauf der 30 Tage ist ein Digital3D-Abonnement erforderlich, um das Programm weiterhin zu nutzen. Ein einziges Abonnement gibt Ihnen Zugang zu allen Digital3D-Anwendungen (CompactForIA, AutoMouseMove, Zendure EV Guard usw.).

🔑 So aktivieren Sie Ihre Lizenz

  1. Abonnieren Sie ein Abonnement auf "One for All"
  2. Melden Sie sich bei Ihrem Konto auf digital3d.com an und kopieren Sie Ihren geheimen Schlüssel (eine eindeutige ID im GUID-Format, z. B.: f89f26cc-eb03-48d7-94f8-xxxxxxxxxxxx)
  3. Öffnen Sie die Datei appsettings.json und fügen Sie Ihren Schlüssel im Abschnitt Subscription hinzu:
    "Subscription": {
      "SecretKey": "Ihr-geheimer-Schlüssel-GUID"
    }
  4. Starten Sie das Programm neu — die PRO-Lizenz wird automatisch aktiviert und ohne Ihr Eingreifen erneuert.

Bereit, Ihre Batterien zu schützen?

Laden Sie kostenlos herunter, konfigurieren Sie in 5 Minuten und schlafen Sie ruhig.

Abonnement « One for All » : ein einziges Abonnement für alle Digital3D-Anwendungen.

Téléchargement — Version 1.1.0

Nouveautés de cette version
- ajout du logiciel dans le ToolBox Digital3D "One for All" permettant avec une seule clé API (sous "Mon Compte") d'avoir accès a tous les logiciels Digital3D - Correction d'un bug qui décrochait lorsque le Shelly Pro n'était pas accessible

Aucun commentaire pour le moment.

Une erreur s'est produite. Cette application peut ne plus répondre jusqu'à ce qu'elle soit rechargée.Veuillez contacter l'auteur. Reload 🗙