Os carregadores VOOL e o VOOL LMC têm cada um a sua própria interface Modbus, e fazem coisas diferentes. Ambas são usadas para integrações locais, como o Home Assistant, um gestor solar ou de energia, ou um sistema de gestão de edifícios. Escolha a que corresponde ao que pretende ler ou controlar:

Ambas estão desativadas por predefinição e o suporte VOOL pode ativá-las remotamente — envie um e-mail para [email protected] com o número de série do carregador ou do LMC.

Se o seu carregador chega à plataforma VOOL através de um LMC por CAN e não tem ligação Ethernet ou Wi-Fi própria, não existe interface Modbus do carregador a que ligar: o Modbus está dentro do carregador e, nessa configuração, o carregador não está na sua rede. Pode saber qual é o seu caso na página do carregador no portal web: se OCPP source indicar LMC e a secção Connectivity não mostrar Wi-Fi nem Ethernet próprios, o carregador está atrás do LMC.

Numa instalação CAN pode continuar a usar a interface Modbus TCP do LMC — desde que o próprio LMC esteja na sua rede — para ler as correntes e tensões da rede do local e definir o limite de corrente da ligação à rede. Isso limita o local como um todo; o controlo ou as medições por carregador via Modbus exigem que o carregador esteja ligado diretamente à sua rede.

Independentemente do seu servidor Modbus TCP, o LMC também fala Modbus no sentido oposto: lê um contador de energia externo. Nesse caso o LMC atua como Modbus master.

Vale a pena explicar isto porque causa confusão real: o campo de endereço IP na configuração do contador é o endereço do contador, não do carregador. Se o seu contador está ligado ao LMC por RS485 e não está de todo na rede, esse campo não se aplica — indique-nos antes a velocidade de transmissão e o suporte pode configurá-lo.

A interface está desligada por predefinição. É ativada com o parâmetro do carregador 522 — Enable Modbus TCP/UDP interface. Esse parâmetro está no firmware do próprio carregador, não no portal web VOOL: o portal não tem página Modbus, nem interruptor Modbus, nem lista de parâmetros numerados, por isso não há nada a procurar lá. Depois de ativada, a interface escuta na porta 502 (TCP e UDP) — 522 é o número do parâmetro, não a porta. O Modbus funciona na mesma interface única (Ethernet ou Wi-Fi) que o restante tráfego do carregador; uma configuração híbrida com Modbus numa e OCPP na outra não é suportada.

O seu carregador precisa de software de julho de 2025 ou mais recente. A interface Modbus chegou no gateway v1.17.2 (bundle v1.9.33), com as funções de controlador completas no bundle v1.9.40 (gateway v1.17.7, MCU v2.12.3). Em software mais antigo o parâmetro simplesmente não existe, por isso não o vai encontrar. A versão do seu carregador é mostrada na respetiva página no portal web, em Configuration.

A forma mais simples de o ativar: envie um e-mail para [email protected] com o número de série do carregador e peça a ativação do Modbus. A VOOL pode fazê-lo remotamente, normalmente no prazo de um dia útil. Se trabalha com um instalador, ele também pode configurar o carregador diretamente por Bluetooth, usando o modo de instalador na aplicação móvel VOOL.

Todos os registos são holding registers, big-endian. A interface aceita no máximo 3 ligações simultâneas e fecha uma ligação após 60 segundos sem comunicação.

Os registos só de leitura abrangem o estado do carregador e as fases do VE (100–101), correntes, tensões e potência ativa por fase (102–111) e energia importada (200–201). Os registos graváveis são 500 comando de carregamento (1 = iniciar, 2 = parar), 501 limite de corrente externo e 502 fases permitidas externamente. O registo 502 está limitado a 10 comutações de fase por hora. A tabela completa, com unidades, escala e definições de bits, está no Manual Modbus do carregador neste centro de ajuda. O LMC usa um mapa diferente (valores float32, medições da rede em 600–625) — consulte Modbus TCP no VOOL LMC.

Este é o mal-entendido mais comum, por isso, de forma clara: uma escrita Modbus não pode elevar o carregador acima do limite de corrente configurado. O Current limit definido no carregador no portal web é o máximo. Se o seu gestor de energia escrever 32 A no registo 501 num carregador configurado para 16 A, o carregador continua a carregar a 16 A. O registo 501 é um pedido, e o carregador aplica o mais baixo dos limites em vigor nesse momento.

Podem aplicar-se vários limites ao mesmo tempo — o máximo configurado, um limite externo de corrente ou potência, a gestão de carga, a limitação térmica. Por isso, um único valor de limite lido por Modbus não é necessariamente o que está a ser usado. Se a corrente que mede não corresponder ao esperado, indique ao suporte o número de série e as horas, e verificaremos qual o limite que estava realmente em vigor.

Escreva no registo 500 apenas quando quiser realmente iniciar ou parar. Os comandos são processados no evento de escrita, por isso um início tem de ser escrito de novo para cada nova sessão — mas escrevê-lo com um temporizador, uma vez por minuto, é um problema real: inunda os registos internos do carregador, tornando-os inúteis para qualquer diagnóstico, e um início que chegue no mesmo momento em que o carregador está a arrancar automaticamente pode entrar em conflito. Se o carregador tiver o Auto start ativado, começará a carregar sozinho de qualquer forma, e a sua integração não precisa de enviar o comando de início.

Nenhuma das interfaces Modbus tem autenticação. Utilize-as apenas em redes locais seguras e nunca exponha a porta à internet.

Existem integrações de terceiros do Home Assistant para equipamento VOOL. Não são criadas nem mantidas pela VOOL, e algumas não funcionam com o LMC sem ajustes. Para questões sobre uma integração da comunidade, contacte o respetivo autor.

Modbus e OCPP são as vias de integração documentadas. Para questões sobre APIs para parceiros ou programadores, envie um e-mail para [email protected] com as perguntas numeradas e encaminhá-las-emos internamente.