Zendure EV Guard

它是如何工作的？

先决条件

安装

1. 解压缩档案

将ZIP文件的内容提取到您选择的目录，例如：

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

2. 执行权限（仅限Linux / macOS）

在Linux和macOS上，您必须在运行之前使文件可执行：

chmod +x ZendureEvGuard
./ZendureEvGuard

3. 配置 appsettings.json

打开与可执行文件位于同一目录的appsettings.json文件，并填写您的参数（请参见下面的部分）。

4. 启动程序

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

程序在启动时显示连接信息。使用 P 手动暂停，使用 R 继续，使用 Ctrl+C 两次干净地停止。

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

# 查看状态
sudo systemctl status zendure-evguard

# 实时查看日志
sudo journalctl -u zendure-evguard -f

# 更新后重启
sudo systemctl restart zendure-evguard

# 停止服务
sudo systemctl stop zendure-evguard

配置 — appsettings.json

以下是您可以配置的所有参数。Shelly 和 ZendureDevice 部分是必需的。

⚡ Shelly 必需

配置您的 Shelly Pro 3EM。它是测量您家电力消耗的传感器。

🔌 Smappee 充电桩 可选

能源充电桩 Smappee 可以通过两种方式使用：

• 作为 EV 检测源（替代 Shelly）— 如果 Shelly 被禁用，Smappee 将成为检测 EV 充电的功率测量源。检测通过 Smappee 云 API 进行（每 5 分钟块，不如 Shelly 实时反应灵敏）。
• 与 Shelly 并行 — 如果 Shelly 作为检测源处于活动状态，Smappee 仍然可以激活，以持续显示消费信息（太阳能、家庭、网络）和您的 Smappee EV Wall 充电桩（充电功率、状态等）在日志中。

🔋 Zendure 电池 必需

配置您的 Zendure SolarFlow 2400 AC 或其他设备。IP 地址在 Zendure 应用中找到。

🚗 EvDetection

电动汽车充电检测的设置。算法使用滞后：需要多次连续读数超过阈值以确认充电，并且多次连续读数低于阈值以确认停止。

📬 通知 可选

当您的电池暂停、恢复或出现错误时接收电子邮件。配置您的SMTP服务器。

📴 Pushover 可选

通过Pushover在您的手机上接收推送通知。在pushover.net上创建一个应用程序以获取您的API令牌。

💬 Telegram 可选

通过Telegram机器人接收通知。使用@BotFather创建一个机器人并获取您的聊天ID。

📈 监控 可选

🔄 更新 可选

🔑 许可证 试用后

在 30 天的试用期后，添加您的密钥以激活 PRO 许可证。您的密钥在您的账户中，位于 右上角 > "我的账户"。许可证会在后台自动续订。

最小配置示例

这是一个现成的示例。只需将 IP 地址替换为您的设备地址：

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

使用此配置，程序监控您的 Shelly，检测任何超过 5000W 的消耗（例如），并以最低 10%（100 ÷ 10）的比例恢复您的电池，最大输出为 2400W。Subscription 部分默认是空的：程序在 30 天内以试用模式运行。要激活 PRO 许可证，请从您的账户中添加您的密钥 右上角。

免费试用 & 订阅