Zendure EV Guard

Bagaimana cara kerjanya?

Prasyarat

Instalasi

1. Ekstrak arsip

Ekstrak isi file ZIP ke direktori pilihan Anda, misalnya:

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

2. Hak eksekusi (Linux / macOS saja)

Di Linux dan macOS, kamu harus membuat file dapat dieksekusi sebelum menjalankannya:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Konfigurasikan appsettings.json

Buka file appsettings.json yang terletak di sebelah executable dan isi parametermu (lihat bagian di bawah).

4. Jalankan program

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

Program menampilkan informasi koneksi saat dimulai. Gunakan P untuk menjeda secara manual, R untuk melanjutkan, dan Ctrl+C dua kali untuk menghentikannya dengan benar.

# Linux
sudo sh install-linux.sh

# macOS
sudo sh install-macos.sh

# Windows (PowerShell sebagai administrator)
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

Konfigurasi: appsettings.json

Berikut semua parameter yang bisa Anda konfigurasi. Bagian Shelly dan ZendureDevice wajib ada.

Pesan baru di 1.3.12

Bahasa semua hal yang Anda baca: email, Pushover, Telegram, laporan akhir pengisian daya. Log teknis tetap dalam bahasa Inggris, agar pesan kesalahan tetap bisa dicari.

Perhatikan penempatannya: kunci ini harus berada di bawah bagian Messages, tidak pernah di akar berkas. Di Linux, kunci Language yang diletakkan di akar akan ditimpa oleh variabel lingkungan LANGUAGE milik sistem, dan pesanmu kembali menjadi bahasa Inggris tanpa peringatan.

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

⚡ Shelly wajib

Konfigurasi Shelly Pro 3EM kamu. Ini adalah sensor yang mengukur konsumsi listrik rumahmu.

🔌 Stasiun Smappee opsional

Stasiun energi Smappee dapat digunakan dengan dua cara :

• Sebagai sumber deteksi EV (alternatif untuk Shelly) : jika Shelly dinonaktifkan, Smappee menjadi sumber pengukuran daya untuk mendeteksi pengisian EV. Deteksi dilakukan melalui API cloud Smappee (blok 5 menit, kurang responsif dibandingkan Shelly secara real-time).
• Bersamaan dengan Shelly : jika Shelly aktif sebagai sumber deteksi, Smappee tetap dapat diaktifkan untuk menampilkan terus-menerus informasi konsumsi (surya, rumah, jaringan) dan stasiun Smappee EV Wall milikmu (daya pengisian, status, dan sebagainya) di dalam log.

Baterai Zendure wajib

Konfigurasi hub Zendure SolarFlow 2400 AC kamu atau yang lainnya. Alamat IP-nya ada di aplikasi Zendure.

EvDetection

Pengaturan deteksi pengisian daya kendaraan listrik kamu. Algoritmenya menggunakan histeresis : perlu beberapa pembacaan berturut-turut di atas ambang untuk mengonfirmasi pengisian daya, dan beberapa pembacaan di bawahnya untuk mengonfirmasi penghentian.

Energi baru di 1.3.12

Di akhir setiap pengisian daya, program memberi tahu berapa kWh yang telah terpakai. Beri tahu harga kWh milikmu dan program akan menambahkan jumlahnya. Ini indikatif, bukan tagihan : tidak ada yang mengukur stasiun pengisian itu sendiri, dan harganya tetap sementara harga milikmu mungkin tidak tetap.

Penggunaan yang terpikir olehku : beberapa mobil terhubung di rumahmu, dan masing-masing harus tahu berapa yang telah dikonsumsinya.

Laporan menghitung dua energi. Yang diukur pada meteran, yang merupakan fakta. Dan bagian yang diperkirakan untuk kendaraan, yang mengurangi konsumsi rumah biasanya : sebuah perkiraan, dan nilai maksimum ketika panelmu mengekspor listrik saat kendaraan dicolokkan.

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

Notifikasi opsional

Terima email saat bateraimu dijeda, dilanjutkan kembali, atau jika terjadi kesalahan. Konfigurasikan server SMTP-mu.

📴 Pushover opsional

Notifikasi push di ponsel Anda melalui Pushover. Buat aplikasi di pushover.net untuk mendapatkan API Token Anda.

💬 Telegram opsional

Notifikasi melalui bot Telegram. Buat bot dengan @BotFather dan dapatkan Chat ID Anda.

Sejak 1.2.0, kamu bisa memberi tahu beberapa grup sekaligus: dua orang melalui bot pertama, tiga orang lainnya melalui bot kedua. Setiap pengiriman terisolasi, penerima yang tidak dapat dihubungi tidak lagi menghalangi penerima lain untuk menerima pesan.

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

Format lama, dengan satu BotToken dan beberapa ChatId yang dipisahkan dengan titik koma, tetap berfungsi. Jika kamu tidak mengubah apa pun pada konfigurasi, notifikasi kamu tetap berjalan persis seperti sebelumnya.

Monitoring opsional

🔄 Update opsional

Lisensi setelah uji coba

Setelah periode uji coba 30 hari, tambahkan kunci rahasiamu untuk mengaktifkan lisensi PRO. Kuncimu ada di akunmu pada pojok kanan atas > "Akun Saya". Lisensi diperbarui secara otomatis di latar belakang.

Contoh konfigurasi minimal

Berikut adalah contoh yang siap digunakan. Cukup ganti alamat IP dengan alamat perangkat Anda :

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

Dengan konfigurasi ini, program memantau Shelly Anda, mendeteksi setiap konsumsi yang lebih besar dari 5000W (sebagai contoh), dan memulihkan baterai Anda dengan minimum 10% (100 ÷ 10) dan keluaran maksimum sebesar 2400W. Bagian Subscription secara default kosong : program berfungsi dalam mode uji coba selama 30 hari. Untuk mengaktifkan lisensi PRO, tambahkan kunci rahasia Anda dari akun Anda di kanan atas.

Uji coba gratis & Langganan