Zendure EV Guard

Como isso funciona?

Pré-requisitos

Instalação

1. Descompacte o arquivo

Extraia o conteúdo do arquivo ZIP para o diretório de sua escolha, por exemplo:

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

2. Permissões de execução (apenas Linux / macOS)

No Linux e no macOS, você precisa tornar o arquivo executável antes de iniciá-lo:

chmod +x ZendureEvGuard
./ZendureEvGuard

3. Configure appsettings.json

Abra o arquivo appsettings.json localizado ao lado do executável e preencha suas configurações (veja a seção abaixo).

4. Inicie o programa

# Windows
ZendureEvGuard.exe

# Linux / macOS
./ZendureEvGuard

O programa exibe as informações de conexão na inicialização. Use P para pausar manualmente, R para retomar, e Ctrl+C duas vezes para parar corretamente.

# Linux
sudo sh install-linux.sh

# macOS
sudo sh install-macos.sh

# Windows (PowerShell como administrador)
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

Configuração : appsettings.json

Aqui estão todos os parâmetros que podes configurar. As secções Shelly e ZendureDevice são obrigatórias.

Mensagens novo em 1.3.12

A língua de tudo o que tu lês: e-mails, Pushover, Telegram, relatórios de fim de carregamento. Os registos técnicos continuam em inglês, para que uma mensagem de erro continue a ser pesquisável.

Atenção ao posicionamento: esta chave fica sob a secção Messages, nunca na raiz do ficheiro. No Linux, uma chave Language colocada na raiz é substituída pela variável de ambiente LANGUAGE do sistema, e as suas mensagens voltam ao inglês sem aviso.

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

Shelly necessário

Configuração do seu Shelly Pro 3EM. É o sensor que mede o consumo elétrico da sua casa.

Borne Smappee opcional

O carregador de energia Smappee pode ser utilizado de duas formas :

• Como fonte de deteção de VE (alternativa ao Shelly): se o Shelly estiver desativado, o Smappee passa a ser a fonte de medição de potência para detetar o carregamento de VE. A deteção é feita através da API cloud do Smappee (blocos de 5 minutos, menos reativa do que o Shelly em tempo real).
• Em paralelo com o Shelly: se o Shelly estiver ativo como fonte de deteção, o Smappee pode ainda ser ativado para apresentar continuamente as informações de consumo (solar, casa, rede) e da sua borne Smappee EV Wall (potência de carregamento, estado, etc.) nos logs.

🔋 Bateria Zendure obrigatório

Configuração do seu hub Zendure SolarFlow 2400 AC ou outros. O endereço IP encontra-se na aplicação Zendure.

EvDetection

Definições da deteção de carregamento do teu veículo elétrico. O algoritmo utiliza uma histerese : são necessárias várias leituras consecutivas acima do limiar para confirmar um carregamento, e várias leituras abaixo para confirmar a paragem.

Energia novo na 1.3.12

No fim de cada carregamento, o programa diz-lhe quantos kWh passaram. Dê-lhe o preço do seu kWh e ele acrescenta o valor. É indicativo, não é uma fatura: ninguém mede a própria estação, e o preço é fixo, embora o seu talvez não seja.

O uso em que estou a pensar: vários carros ligam-se em sua casa, e cada um tem de saber quanto consumiu.

O relatório quantifica duas energias. A medida no contador, que é um facto. E a parte estimada do veículo, que retira o consumo habitual da casa: uma estimativa, e um máximo quando os seus painéis estavam a exportar no momento de ligar.

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

Notificação opcional

Receba emails quando as suas baterias entrarem em pausa, retomarem, ou em caso de erro. Configure o seu servidor SMTP.

📴 Pushover opcional

Notificações push no seu telefone via Pushover. Crie uma aplicação em pushover.net para obter seu API Token.

💬 Telegram opcional

Notificações por meio de um bot do Telegram. Crie um bot com @BotFather e obtenha seu Chat ID.

Desde a 1.2.0, você pode avisar vários grupos ao mesmo tempo: duas pessoas por meio de um primeiro bot, outras três por meio de um segundo. Cada envio é isolado, um destinatário que não pode ser contatado não impede mais os outros de receberem a mensagem.

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

O formato antigo, com um único BotToken e ChatId separados por ponto e vírgula, continua funcionando. Se você não mudar nada na sua configuração, suas notificações continuam exatamente como antes.

Monitoring opcional

Atualização opcional

Licença após o teste

Após o período de teste de 30 dias, adicione sua chave secreta para ativar a licença PRO. Sua chave está na sua conta em no canto superior direito > "Minha conta". A licença é renovada automaticamente em segundo plano.

Exemplo de configuração mínima

Aqui está um exemplo pronto para usar. Basta substituir os endereços IP pelos dos seus 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"
  }
}

Com esta configuração, o programa monitora o seu Shelly, detecta qualquer consumo superior a 5000W (por exemplo), e restaura as suas baterias com um mínimo de 10% (100 ÷ 10) e uma saída máxima de 2400W. A seção Subscription fica vazia por padrão : o programa funciona em modo de teste durante 30 dias. Para ativar a licença PRO, adicione a sua chave secreta a partir da sua conta no canto superior direito.

Teste gratuito & Assinatura