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

🔋 Батарея Zendure обязательно

Конфигурация вашего хаба Zendure SolarFlow 2400 AC или других. IP-адрес находится в приложении Zendure.

🚗 EvDetection

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

📬 Уведомление опционально

Получайте электронные письма, когда ваши батареи ставятся на паузу, возобновляются или в случае ошибки. Настройте ваш SMTP-сервер.

📴 Pushover опционально

Push-уведомления на ваш телефон через Pushover. Создайте приложение на pushover.net, чтобы получить ваш API Token.

💬 Telegram опционально

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

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