Zendure EV Guard

How does it work?

Prerequisites

Installation

1. Extract the archive

Extract the contents of the ZIP file into the directory of your choice, for example:

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

2. Execution permissions (Linux / macOS only)

On Linux and macOS, you must make the file executable before launching it:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configure appsettings.json

Open the appsettings.json file located next to the executable and fill in your settings (see the section below).

4. Launch the program

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

The program displays the connection information at startup. Use P to pause manually, R to resume, and Ctrl+C twice to stop cleanly.

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

Here are all the settings you can configure. The Shelly and ZendureDevice sections are required.

⚡ Shelly required

Configuration of your Shelly Pro 3EM. This is the sensor that measures your home's electricity consumption.

🔌 Smappee charging station optional

The Smappee energy station can be used in two ways:

• As an EV detection source (alternative to Shelly): if Shelly is disabled, Smappee becomes the power measurement source for detecting EV charging. Detection is performed via the Smappee cloud API (5-minute blocks, less responsive than Shelly in real time).
• In parallel with Shelly: if Shelly is active as the detection source, Smappee can still be enabled to continuously display consumption information (solar, home, grid) and information about your Smappee EV Wall charging station (charging power, status, etc.) in the logs.

🔋 Zendure Battery required

Configuration of your Zendure SolarFlow 2400 AC hub or others. The IP address can be found in the Zendure app.

🚗 EvDetection

Settings for detecting your electric vehicle's charging. The algorithm uses hysteresis: several consecutive readings above the threshold are required to confirm charging, and several readings below it to confirm that charging has stopped.

📬 Notification optional

Receive emails when your batteries pause, resume, or in case of an error. Configure your SMTP server.

📴 Pushover optional

Push notifications on your phone via Pushover. Create an application on pushover.net to obtain your API Token.

💬 Telegram optional

Notifications via a Telegram bot. Create a bot with @BotFather and retrieve your Chat ID.

Since 1.2.0, you can notify several groups at once: two people via a first bot, and three others via a second. Each sending operation is isolated; an unreachable recipient no longer prevents the others from receiving the message.

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

The old format, with a single BotToken and ChatId values separated by semicolons, continues to work. If you do not change anything in your configuration, your notifications will continue exactly as before.

📈 Monitoring optional

🔄 Update optional

🔑 License after the trial

After the 30-day trial period, add your secret key to activate the PRO license. Your key can be found in your account at top right > "My Account". The license renews automatically in the background.

Minimal configuration example

Here is a ready-to-use example. Simply replace the IP addresses with those of your devices:

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

With this configuration, the program monitors your Shelly, detects any consumption above 5000W (for example), and restores your batteries with a minimum of 10% (100 ÷ 10) and a maximum output of 2400W. The Subscription section is empty by default: the program operates in trial mode for 30 days. To activate the PRO license, add your secret key from your account in the top right.

Free Trial & Subscription