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 两次来正常停止。

# Linux
sudo sh install-linux.sh

# macOS
sudo sh install-macos.sh

# Windows (PowerShell en tant qu'administrateur)
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

配置：appsettings.json

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

消息 1.3.12 中新增

你读到的所有内容的语言：邮件、Pushover、Telegram、充电结束报告。技术日志仍然是英文，这样错误消息还能被搜索到。

注意放置位置：这个键要放在 下方的 Messages 部分，绝不能放在文件根部。 在 Linux 上，放在根部的 Language 键会被系统的环境变量 LANGUAGE 覆盖，你的消息会毫无预兆地重新变成英语。

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

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 hub 或其他设备。IP 地址可以在 Zendure 应用中找到。

EvDetection

用于检测你的电动车充电状态的设置。这个算法使用了滞回：必须连续多次读取到高于阈值，才能确认正在充电，也必须连续多次读取到低于阈值，才能确认充电停止。

Energy 1.3.12 中的新功能

每次充电结束时，程序都会告诉你已经充入了多少 kWh。告诉它每 kWh 的价格，它就会算出金额。这只是参考值，不是账单：没人测量充电桩本身，而且价格是固定的，而你的价格可能不是固定的。

我想到的使用场景是：有几辆车在你家充电，每辆车都需要知道自己消耗了多少电。

报告会列出两种能量。电表测得的能量，这是事实。以及估算出的车辆所占部分，也就是扣除房屋通常用电量后的数值：这是一个估算值，也是你插入车辆时太阳能电池板正在向外供电时的最大值。

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

通知 可选

当你的电池暂停充电、恢复充电或发生错误时接收邮件。配置你的 SMTP 服务器。

Pushover 可选

通过Pushover在你的手机上接收推送通知. 在 pushover.net 上创建一个应用，以获取你的 API Token.

Telegram 可选

通过 Telegram 机器人接收通知. 使用@BotFather创建一个机器人，然后获取你的 Chat ID.

从 1.2.0 开始，你可以同时通知多个群组：通过第一个机器人通知两个人，通过第二个机器人通知另外三个人。每次发送彼此独立，一个无法联系的接收者不再阻止其他人收到消息。

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

旧的形式使用单个 BotToken 和由分号分隔的多个 ChatId，仍然可以使用。如果你不更改配置，通知仍会和以前完全一样。

📈 监控 可选

更新 可选

🔑 许可证 试用期后

30 天试用期结束后，添加你的密钥以激活 PRO 许可证。你的密钥位于你的账户中，路径是 右上角 > “我的账户”。许可证会在后台自动续期。

最小配置示例

这里有一个开箱即用的示例。只需将 IP 地址替换为你的设备地址：

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

使用此配置，程序会监控你的 Shelly，检测任何高于 5000W 的用电量（举例来说），并以最低 10%（100 ÷ 10）和最高 2400W 的输出恢复你的电池。Subscription 部分默认为空：程序会在 30 天内以试用模式运行。要激活 PRO 许可证，请从你的账户右上方添加你的密钥。

免费试用 & 订阅