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 от имени администратора)
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. Обнаружение выполняется через облачный API Smappee (блоки по 5 минут, менее оперативно, чем Shelly в реальном времени).
• Параллельно с Shelly: если Shelly активен в качестве источника обнаружения, Smappee всё равно можно активировать, чтобы постоянно отображать в логах информацию о потреблении (солнечная энергия, дом, сеть) и о вашей зарядной станции Smappee EV Wall (мощность зарядки, состояние и т. д.).

Батарея Zendure требуется

Настройка вашего хаба Zendure SolarFlow 2400 AC или других моделей. IP-адрес находится в приложении Zendure.

🚗 EvDetection

Настройки обнаружения зарядки вашего электромобиля. Алгоритм использует гистерезис: для подтверждения зарядки нужно несколько последовательных показаний выше порога, а для подтверждения остановки, несколько показаний ниже него.

Energy новое в 1.3.12

В конце каждой зарядки программа сообщает, сколько кВт⋅ч прошло. Укажите ей цену вашего кВт⋅ч, и она добавит сумму. Это ориентировочно, а не счёт: никто не измеряет саму зарядную станцию, и цена фиксирована, тогда как ваша, возможно, нет.

Я думаю об использовании в такой ситуации: у вас подключаются несколько машин, и каждая должна знать, сколько она потребила.

В отчёте указаны две энергии. Измеренная счётчиком, которая является фактом. И оценочная доля автомобиля, из которой вычитается обычное потребление дома: это оценка, и максимум, когда ваши панели экспортировали энергию в момент подключения.

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 необязательно

Push-уведомления на ваш телефон через 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, добавьте свой секретный ключ из аккаунта в правом верхнем углу.

Бесплатный пробный период и подписка