Zendure EV Guard

¿Cómo funciona?

Requisitos

Instalación

1. Descomprime el archivo

Extrae el contenido del archivo ZIP en el directorio que quieras, por ejemplo :

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

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

En Linux y macOS, debes hacer ejecutable el archivo antes de lanzarlo :

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configura appsettings.json

Abre el archivo appsettings.json situado junto al ejecutable y completa tus parámetros (consulta la sección de abajo).

4. Lanza el programa

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

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

# 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

Configuración: appsettings.json

Estos son todos los parámetros que puedes configurar. Las secciones Shelly y ZendureDevice son obligatorias.

Mensajes nuevo en 1.3.12

El idioma de todo lo que tú lees: correos, Pushover, Telegram, informes del final de la carga. Los registros técnicos siguen en inglés, para que un mensaje de error se pueda buscar.

Ojo con la ubicación: esta clave va debajo de la sección Messages, nunca en la raíz del archivo. En Linux, una clave Language situada en la raíz es sobrescrita por la variable de entorno LANGUAGE del sistema, y tus mensajes vuelven al inglés sin avisar.

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

⚡ Shelly obligatorio

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

🔌 Punto de carga Smappee opcional

El punto de carga energético Smappee puede utilizarse de dos maneras :

• Como fuente de detección de EV (alternativa a Shelly): si Shelly está desactivado, Smappee se convierte en la fuente de medición de potencia para detectar la carga de EV. La detección se realiza mediante la API cloud de Smappee (bloques de 5 minutos, menos reactiva que Shelly en tiempo real).
• En paralelo con Shelly: si Shelly está activo como fuente de detección, Smappee puede estar activo igualmente para mostrar continuamente la información de consumo (solar, casa, red) y de tu borne Smappee EV Wall (potencia de carga, estado, etc.) en los registros.

Batería Zendure obligatorio

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

Detección de vehículos eléctricos

Ajustes de la detección de carga de tu vehículo eléctrico. El algoritmo utiliza una histéresis : hacen falta varias lecturas consecutivas por encima del umbral para confirmar una carga, y varias lecturas por debajo para confirmar la detención.

Energía nuevo en 1.3.12

Al final de cada carga, el programa te dice cuántos kWh han pasado. Dale el precio de tu kWh y añade el importe. Es indicativo, no una factura: nadie mide el cargador en sí, y el precio es fijo mientras que el tuyo quizá no lo sea.

El uso en el que pienso: varios coches se conectan en tu casa, y cada uno debe saber cuánto ha consumido.

El informe cuantifica dos energías. La medida en el contador, que es un hecho. Y la parte estimada del vehículo, que resta el consumo habitual de la casa: una estimación, y un máximo cuando tus paneles exportaban en el momento de conectarlo.

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

Notificación opcional

Recibe correos electrónicos cuando tus baterías se ponen en pausa, reanudan la carga, o en caso de error. Configura tu servidor SMTP.

📴 Pushover opcional

Notificaciones push en tu teléfono mediante Pushover. Crea una aplicación en pushover.net para obtener tu API Token.

💬 Telegram opcional

Notificaciones mediante un bot de Telegram. Crea un bot con @BotFather y recupera tu Chat ID.

Desde la 1.2.0, puede avisar a varios grupos a la vez: a dos personas mediante un primer bot, y a otras tres mediante un segundo. Cada envío está aislado, un destinatario inalcanzable ya no impide que los demás reciban el mensaje.

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

La forma antigua, con un solo BotToken y varios ChatId separados por punto y coma, sigue funcionando. Si no cambia nada en su configuración, sus notificaciones continúan exactamente como antes.

Monitorización opcional

Actualización opcional

Licencia después de la prueba

Después del periodo de prueba de 30 días, añade tu clave secreta para activar la licencia PRO. Tu clave se encuentra en tu cuenta, en arriba a la derecha > "Mi cuenta". La licencia se renueva automáticamente en segundo plano.

Ejemplo de configuración mínima

Aquí tienes un ejemplo listo para usar. Simplemente sustituye las direcciones IP por las de tus dispositivos:

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

Con esta configuración, el programa supervisa tu Shelly, detecta cualquier consumo superior a 5000W (por ejemplo), y restaura tus baterías con un mínimo del 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, añade tu clave secreta desde tu cuenta arriba a la derecha.

Prueba gratuita y suscripción