O carregador VOOL disponibiliza uma interface Modbus TCP/UDP para integrações locais. Esta página contém o manual completo da interface (22.01.2026, firmware v1.9.40; GW v1.17.7, MCU v2.12.3). A versão em PDF está anexada abaixo.
Descrição
A interface Modbus está disponível nas interfaces Ethernet e Wi-Fi. A ligação híbrida — usar Modbus por Wi-Fi e OCPP por Ethernet (ou vice-versa) ao mesmo tempo — não é suportada; todas as ligações usam uma interface comum de cada vez.
Por predefinição, o Modbus está desativado e pode ser ativado com o parâmetro especial 522 — Enable Modbus TCP/UDP interface. O suporte VOOL também o pode ativar remotamente para um determinado número de série.
Especificações do protocolo
Porta: 502 (TCP e UDP)
Ordem de bytes: big-endian
Máximo de ligações simultâneas: 3 — as tentativas de ligação adicionais são rejeitadas
Tempo limite: 60 s (a ligação é fechada quando não há comunicação)
Esta interface Modbus não inclui qualquer segurança. Utilize-a apenas em redes locais e seguras. A VOOL não se responsabiliza por danos causados por acesso não autorizado à interface Modbus.
Tabela de registos
Todos os registos são holding registers.
Address | Descrição | Type | Acesso | Unidade | Casas decimais |
100 | Estado do carregador | uint | R | enum | - |
101 | Fases do VE (EV Phases) | uint | R | binary | - |
102–104 | Corrente AC L1 / L2 / L3 | int | R | A | 0.01 |
105–107 | Tensão L1 / L2 / L3 | int | R | V | 0.1 |
108 | Potência ativa (total) | int | R | kW | 0.01 |
109–111 | Potência ativa L1 / L2 / L3 | int | R | kW | 0.01 |
200–201 | Energia importada (MSB, LSB) | uint32 | R | Wh | 1 |
500 | Comando de carregamento | uint | W | enum | - |
501 | Limite de corrente externo | uint | R/W | A | 0.01 |
502 | Fases permitidas externamente | uint | R/W | binary | - |
Os registos marcados com W permitem operações de leitura, mas a resposta pode não conter um valor significativo. Nota: o endereço de registo 502 (External Allowed Phases) não tem relação com a porta TCP 502 — o número em comum é uma coincidência.
Estado do carregador (registo 100)
0 = UNDEFINED, 1 = AVAILABLE, 2 = PREPARING, 3 = CHARGING, 4 = SUSPENDED_EV, 5 = SUSPENDED_EVSE, 6 = FINISHING, 7 = RESERVED, 8 = UNAVAILABLE, 9 = FAULTED, 10 = STARTING_CHARGING
Fases do VE (registo 101)
Indica quantas fases o VE está a usar (não as fases da rede): bit 0 = L1, bit 1 = L2, bit 2 = L3. Exemplo: 0b001 — o VE usa apenas L1 (VE monofásico); 0b111 — todas as fases (VE trifásico). 0b110 (L2+L3) é normalmente uma combinação anómala e pode indicar uma falha de cabo ou de ligação em L1.
Comando de carregamento (registo 500)
1 = iniciar carregamento, 2 = parar carregamento. Os comandos são processados no evento de escrita do registo: se o carregador tiver parado por qualquer motivo, o comando de início tem de ser escrito novamente para iniciar um novo carregamento. Leia a reação no registo de estado do carregador. Não escreva valores de comando válidos periodicamente — não causa falhas, mas sobrecarrega o sistema e torna os registos internos inutilizáveis.
Fases permitidas externamente (registo 502)
Define que fases de entrada da rede (L1, L2, L3) o carregador pode usar: bit 0 = L1, bit 1 = L2, bit 2 = L3. As saídas de fase do carregador selecionam automaticamente uma configuração adequada e ligam sempre primeiro a saída L1 — quando só L2 é permitida, o carregador liga a L2 da rede à L1 do VE. Exemplo: 0b010 — só L2 permitida; 0b101 — L1 e L3 permitidas, L2 proibida.
Máximo de 10 comutações por hora. O carregador conta e limita automaticamente as comutações; o contador é reposto uma hora após a primeira comutação. A ativação de fases é permitida mesmo acima do limite, para evitar uma situação de bloqueio.
Está em preparação um manual atualizado para a próxima geração de firmware do carregador, que substituirá esta página quando esse firmware for lançado.