Zendure EV Guard

Como funciona?

Pré-requisitos

Instalação

1. Descompacte o arquivo

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

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

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

No Linux e macOS, você deve tornar o arquivo executável antes de executá-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. Execute 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.

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 Proteção de Bateria de Carregamento 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 o status
sudo systemctl status zendure-evguard

# Ver os logs em tempo real
sudo journalctl -u zendure-evguard -f

# Reiniciar após uma atualização
sudo systemctl restart zendure-evguard

# Parar o serviço
sudo systemctl stop zendure-evguard

Configuração — appsettings.json

Aqui estão todos os parâmetros que você pode configurar. As seções Shelly e ZendureDevice são obrigatórias.

⚡ Shelly requerido

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

🔌 Estação Smappee opcional

A estação energética Smappee pode ser utilizada de duas maneiras:

• Como fonte de detecção EV (alternativa ao Shelly) — se o Shelly estiver desativado, Smappee se torna a fonte de medição de potência para detectar o carregamento EV. A detecção é feita através da API em nuvem Smappee (blocos de 5 minutos, menos reativa que o Shelly em tempo real).
• Em paralelo ao Shelly — se o Shelly estiver ativo como fonte de detecção, Smappee ainda pode ser ativado para exibir continuamente as informações de consumo (solar, casa, rede) e da sua estação Smappee EV Wall (potência de carga, estado, etc.) nos logs.

🔋 Bateria Zendure requerido

Configuração do seu hub Zendure SolarFlow 2400 AC ou outros. O endereço IP pode ser encontrado no aplicativo Zendure.

🚗 EvDetection

Configurações da detecção de carga do seu veículo elétrico. O algoritmo utiliza uma histerese: são necessárias várias leituras consecutivas acima do limite para confirmar uma carga, e várias leituras abaixo para confirmar a parada.

📬 Notificação opcional

Receba e-mails quando suas baterias entram em pausa, retomam ou em caso de erro. Configure seu servidor SMTP.

📴 Pushover opcional

Notificações push no seu telefone via Pushover. Crie um aplicativo em pushover.net para obter seu Token API.

💬 Telegram opcional

Notificações via um bot Telegram. Crie um bot com @BotFather e recupere seu Chat ID.

📈 Monitoramento 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 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 uso. Basta substituir os endereços IP pelos de seus 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"
  }
}

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

Teste gratuito & Assinatura