Zendure EV Guard

How does it work?

Requirements

Download — Version 1.0.8

Installation

1. Unzip the archive

Extract the contents of the ZIP file to your chosen directory, for example:

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

2. Execution rights (Linux / macOS only)

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

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configure appsettings.json

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

4. Launch the program

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

The program displays connection information at startup. Use P to manually pause, 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

# View status
sudo systemctl status zendure-evguard

# View logs in real time
sudo journalctl -u zendure-evguard -f

# Restart after an update
sudo systemctl restart zendure-evguard

# Stop the service
sudo systemctl stop zendure-evguard

Configuration — appsettings.json

Here are all the parameters you can configure. The Shelly and ZendureDevice sections are mandatory.

⚡ Shelly required

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

🔌 Smappee Charging Station optional

The energy station Smappee can be used in two ways:

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

🔋 ZendureDevice required

Configuration of your Zendure SolarFlow 2400 AC hub. The IP address is found in the Zendure app.

🚗 EvDetection

Settings for detecting the charging of your electric vehicle. The algorithm uses a hysteresis: it requires several consecutive readings above the threshold to confirm charging, and several readings below to confirm stopping.

📬 Notification optional

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

📴 Pushover optional

Push notifications to 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.

📈 Monitoring optional

🔄 Update optional

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

With this configuration, the program monitors your Shelly, detects any consumption above 5000W, and restores your batteries with a minimum of 10% (100 ÷ 10) and a maximum output of 2400W.

Free trial & License