Zendure EV Guard

Jak to funguje?

Předpoklady

Instalace

1. Rozbalte archiv

Rozbalte obsah souboru ZIP do adresáře podle svého výběru, například:

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

2. Práva ke spuštění (pouze Linux / macOS)

Na Linuxu a macOS musíš soubor před spuštěním nastavit jako spustitelný:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Nastav appsettings.json

Otevři soubor appsettings.json umístěný vedle spustitelného souboru a vyplň své parametry (viz sekce níže).

4. Spusť program

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

Program při spuštění zobrazí informace o připojení. Použij P pro ruční pozastavení, R pro pokračování a Ctrl+C dvakrát pro řádné ukončení.

# 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

Konfigurace: appsettings.json

Zde jsou všechny parametry, které můžete nastavit. Sekce Shelly a ZendureDevice jsou povinné.

Zprávy nové v 1.3.12

Jazyk všeho, co čtete: e-mailů, Pushoveru, Telegramu a zpráv o dokončení nabíjení. Technické protokoly zůstávají v angličtině, aby se chybová zpráva dala vyhledat.

Pozor na umístění: tento klíč patří pod sekci Messages, nikdy do kořene souboru. V Linuxu je klíč Language umístěný v kořeni přepsán systémovou proměnnou prostředí LANGUAGE a tvoje zprávy se bez varování vrátí do angličtiny.

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

⚡ Shelly požadováno

Nastavení tvého zařízení Shelly Pro 3EM. Je to senzor, který měří spotřebu elektřiny v tvém domě.

Nabíjecí stanice Smappee volitelné

Energetickou nabíjecí stanici Smappee lze použít dvěma způsoby :

• Jako zdroj detekce EV (alternativa k Shelly): pokud je Shelly deaktivované, Smappee se stává zdrojem měření výkonu pro detekci nabíjení EV. Detekce probíhá přes cloudové API Smappee (bloky po 5 minutách, méně pružné než Shelly v reálném čase).
• Paralelně se Shelly: pokud je Shelly aktivní jako zdroj detekce, Smappee může být přesto aktivní pro průběžné zobrazování informací o spotřebě (solární energie, domácnost, síť) a o vaší nabíjecí stanici Smappee EV Wall (nabíjecí výkon, stav atd.) v logách.

Baterie Zendure vyžadována

Konfigurace vašeho hubu Zendure SolarFlow 2400 AC nebo jiných. IP adresa se nachází v aplikaci Zendure.

EvDetection

Nastavení detekce nabíjení vašeho elektromobilu. Algoritmus používá hysterezi : k potvrzení nabíjení je potřeba několik po sobě jdoucích měření nad prahem a k potvrzení zastavení několik měření pod prahem.

Energie nové v 1.3.12

Na konci každého nabíjení vám program řekne, kolik kWh proteklo. Zadejte mu cenu za kWh a on přidá částku. Je to orientační, ne faktura: samotnou nabíječku nikdo neměří a cena je pevná, zatímco ta vaše taková možná není.

Použití, které mám na mysli: u vás se připojí několik aut a každé musí vědět, kolik spotřebovalo.

Zpráva uvádí dvě energie. Ta naměřená elektroměrem, což je fakt. A odhadovaný podíl vozidla, který odečítá obvyklou spotřebu domu: odhad a maximum v době, kdy vaše panely při připojení dodávaly energii do sítě.

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

Oznámení volitelné

Dostávejte e-maily, když se baterie pozastaví, znovu se spustí nebo dojde k chybě. Nakonfigurujte svůj SMTP server.

📴 Pushover volitelné

Pushová oznámení do telefonu prostřednictvím Pushover. Vytvořte aplikaci na pushover.net, abyste získali svůj API Token.

💬 Telegram volitelné

Oznámení prostřednictvím telegramového bota. Vytvořte bota pomocí @BotFather a zjistěte své Chat ID.

Od verze 1.2.0 můžete upozornit několik skupin najednou: dvě osoby prostřednictvím prvního bota, další tři prostřednictvím druhého. Každé odeslání je izolované, nedostupný příjemce už nebrání ostatním v přijetí zprávy.

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

Stará podoba s jediným BotToken a několika ChatId oddělenými středníky nadále funguje. Pokud ve své konfiguraci nic nezměníte, budou vaše oznámení pokračovat přesně jako dříve.

📈 Monitorování volitelné

Aktualizace volitelné

Licence po zkoušce

Po 30denním zkušebním období přidejte svůj tajný klíč pro aktivaci licence PRO. Svůj klíč najdete ve svém účtu na vpravo nahoře > „Můj účet“. Licence se automaticky obnovuje na pozadí.

Příklad minimální konfigurace

Zde je příklad připravený k použití. Jednoduše nahraďte IP adresy adresami svých zařízení:

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

S tímto nastavením program sleduje váš Shelly, detekuje každou spotřebu vyšší než 5000W (například), a obnovuje vaše baterie s minimem 10% (100 ÷ 10) a maximálním výstupem 2400W. Sekce Subscription je ve výchozím nastavení prázdná: program funguje ve zkušebním režimu po dobu 30 dnů. Pro aktivaci licence PRO přidejte svůj tajný klíč ze svého účtu vpravo nahoře.

Zkušební verze zdarma & předplatné