Zendure EV Guard

¿Cómo funciona?

Requisitos

Instalación

1. Descomprime el archivo

Extrae el contenido del archivo ZIP en el directorio de tu elección, por ejemplo:

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

2. Derechos de ejecución (solo Linux / macOS)

En Linux y macOS, debes hacer que el archivo sea ejecutable antes de ejecutarlo:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configura appsettings.json

Abre el archivo appsettings.json ubicado junto al ejecutable y completa tus parámetros (ver la sección a continuación).

4. Inicia el programa

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

El programa muestra la información de conexión al inicio. Utilice P para pausar manualmente, R para reanudar, y Ctrl+C dos veces para detener correctamente.

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 - Daemon de Protección de Batería de Carga 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

# Ver el estado
sudo systemctl status zendure-evguard

# Ver los logs en tiempo real
sudo journalctl -u zendure-evguard -f

# Reiniciar después de una actualización
sudo systemctl restart zendure-evguard

# Detener el servicio
sudo systemctl stop zendure-evguard

Configuración — appsettings.json

Aquí están todos los parámetros que puede configurar. Las secciones Shelly y ZendureDevice son obligatorias.

⚡ Shelly requerido

Configuración de su Shelly Pro 3EM. Es el sensor que mide el consumo eléctrico de su hogar.

🔌 Estación Smappee opcional

La estación energética Smappee puede ser utilizada de dos maneras:

• Como fuente de detección EV (alternativa a Shelly) — si Shelly está desactivado, Smappee se convierte en la fuente de medida de potencia para detectar la carga EV. La detección se realiza a través de la API en la nube de Smappee (bloques de 5 minutos, menos reactivo que Shelly en tiempo real).
• En paralelo a Shelly — si Shelly está activo como fuente de detección, Smappee puede seguir estando activo para mostrar continuamente la información de consumo (solar, hogar, red) y de su estación Smappee EV Wall (potencia de carga, estado, etc.) en los logs.

🔋 Batería Zendure requerido

Configuración de su hub Zendure SolarFlow 2400 AC u otros. La dirección IP se encuentra en la app de Zendure.

🚗 EvDetection

Ajustes de la detección de carga de su vehículo eléctrico. El algoritmo utiliza una histeresis: se requieren varias lecturas consecutivas por encima del umbral para confirmar una carga, y varias lecturas por debajo para confirmar la detención.

📬 Notificación opcional

Reciba correos electrónicos cuando sus baterías se pongan en pausa, se reanuden, o en caso de error. Configure su servidor SMTP.

📴 Pushover opcional

Notificaciones push en su teléfono a través de Pushover. Cree una aplicación en pushover.net para obtener su Token API.

💬 Telegram opcional

Notificaciones a través de un bot de Telegram. Cree un bot con @BotFather y recupere su ID de chat.

📈 Monitoreo opcional

🔄 Actualización opcional

🔑 Licencia después de la prueba

Después del período de prueba de 30 días, agregue su clave secreta para activar la licencia PRO. Su clave se encuentra en su cuenta en arriba a la derecha > "Mi Cuenta". La licencia se renueva automáticamente en segundo plano.

Ejemplo de configuración mínima

Aquí hay un ejemplo listo para usar. Simplemente reemplace las direcciones IP por las de sus dispositivos:

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

Con esta configuración, el programa monitorea su Shelly, detecta cualquier consumo superior a 5000W (por ejemplo), y restaura sus baterías con un mínimo de 10% (100 ÷ 10) y una salida máxima de 2400W. La sección Subscription está vacía por defecto: el programa funciona en modo de prueba durante 30 días. Para activar la licencia PRO, agregue su clave secreta desde su cuenta arriba a la derecha.

Prueba gratuita & Suscripción