Todos os guias

Base de conhecimentoLigar

Ligar fontes de dados

Adicionar equipamentos e lê-los: Modbus TCP, OPC UA, IEC 60870-5-104, MQTT e Sparkplug B, e ficheiros de dataloggers — com as definições de fuso horário que mantêm as datas certas.

Todas as fontes acabam no mesmo sítio: um histórico por tag, vigiado pelos mesmos alarmes e desenhado nos mesmos gráficos. Este guia explica como ligar cada tipo. A página Fontes de dados lista todos os detalhes que cada uma suporta.

Os passos comuns

  1. Equipamento → Adicionar equipamento. Indique um código, um nome, uma categoria de alarme e a forma de leitura: ficheiros, Modbus TCP, OPC UA, IEC 60870-5-104 ou MQTT. O protocolo pode ser mudado mais tarde no separador Comunicação.
  2. Separador Comunicação. Preencha a ligação e o intervalo de leitura (por equipamento, de 1 segundo a 1 dia) e carregue em Testar ligação — o equipamento é contactado sem que nada fique gravado. Um número fora dos limites permitidos é recusado com uma mensagem que indica o campo.
  3. Separador Mapeamento de Tags. Acrescente as tags do equipamento com o endereço e o tipo de dados, e associe cada uma a uma tag de sistema. Muitas tags de uma vez podem ser importadas de um CSV com Importar CSV. Consulte Tags, virtual tags e banda morta.
  4. Separador Monitorização e Alarmes. Defina o tempo limite de comunicação — quanto tempo o equipamento pode ficar em silêncio antes de aparecer como offline — e, se quiser ser avisado, o alarme de perda de comunicação.

Cada protocolo corre no seu próprio serviço, por isso um equipamento com problemas num protocolo nunca para os outros. A leitura de PLC, MQTT e ficheiros faz parte de todas as licenças.

Modbus TCP

O SyncTide é o cliente Modbus: lê holding registers, input registers, coils e discrete inputs, e nunca escreve.

  • Ligação: host, porta (502 por omissão), unit ID, tempo limite e um desvio de endereços para os equipamentos que contam a partir de 1.
  • Endereços: a numeração clássica 40001 / 30001 / 10001 / 00001, ou explícita hr:100, ir:0, di:5, coil:12 (a contar de 0).
  • Tipos de dados: int16, uint16 e bool num registo; int32, uint32 e float em dois; int64, uint64 e double em quatro; ou um bit de um registo. A ordem dos bytes (ABCD, CDAB, BADC, DCBA) define-se por equipamento.
  • Escala: valor × escala + desvio, por tag.
  • As tags vizinhas são lidas num só pedido, por isso centenas de tags cabem em poucos pedidos. Com leituras de minuto a minuto ou mais frequentes, a ligação fica aberta entre leituras.

Alguns PLC fecham as sessões Modbus inativas e depois recusam novas durante algum tempo (could not connect de vez em quando). Ative a opção de manter a ligação ativa na ligação do equipamento, para que o SyncTide mantenha a sessão aberta.

OPC UA

O SyncTide é um cliente OPC UA num endpoint opc.tcp://, com entrada anónima ou com nome de utilizador e palavra-passe.

  1. Indique o endpoint, por exemplo opc.tcp://192.168.1.50:4840, e teste a ligação.
  2. No separador Mapeamento de Tags, explore o servidor: percorra os espaços de nomes e a árvore de nós, veja o valor e o tipo de cada variável e acrescente as que quiser — sem escrever NodeIds à mão.
  3. Escolha como chegam os valores: leitura no intervalo definido (todas as tags do equipamento num só pedido) ou subscrição, em que o servidor envia as alterações. Com subscrições, a banda morta da tag também é enviada ao servidor, e os valores que não mudaram nem chegam a atravessar a rede.

Os NodeIds também podem ser escritos: ns=2;s=Flow, ns=2;i=1234. As datas vêm do servidor (a hora da origem, senão a do servidor, senão a da receção). Se o servidor responder BadIdentityTokenInvalid, está a pedir nome de utilizador e palavra-passe.

IEC 60870-5-104

Para RTU de redes de água, saneamento e energia. O SyncTide é a estação de controlo: mantém uma ligação aberta por equipamento (porta 2404 por omissão), pede uma interrogação geral ao ligar e depois recebe os eventos espontâneos do RTU à medida que chegam.

  • Endereço comum (ASDU): tem de coincidir com o do RTU. Se o RTU liga mas não chegam valores, verifique primeiro o endereço comum.
  • Pontos: um endereço de objeto de informação (IOA) por tag, com o seu tipo — floats curtos, valores escalados e normalizados, pontos simples, ou qualquer tipo de monitorização indicado pelo nome exato.
  • Hora: as etiquetas de tempo do RTU (CP56Time2a) são mantidas, por isso os eventos guardados durante uma falha chegam com a sua própria hora. Essas etiquetas não indicam fuso horário: defina no equipamento o fuso do relógio do RTU.
  • Os pontos que o RTU envia sem estarem mapeados são registados uma vez no log, com o tipo, para poderem ser mapeados sem outra ferramenta.

MQTT e Sparkplug B

O SyncTide subscreve um broker MQTT — o seu ou o da nossa cloud.

  1. Registe o broker uma vez em Configuração → Tempo de execução → MQTT: host, porta, nome de utilizador e palavra-passe, TLS.
  2. No equipamento, escolha o broker e um prefixo de tópico; o SyncTide subscreve prefixo/# com o QoS escolhido (0, 1 ou 2).

As mensagens podem ter um valor por tópico de tag ({"value": 12.3}), várias tags numa mensagem JSON, uma lista de valores com as suas próprias datas, ou só um número. O Sparkplug B (NBIRTH, DBIRTH, NDATA, DDATA) é descodificado automaticamente, com os nomes e aliases das métricas das mensagens de nascimento e as datas das métricas mantidas.

Ficheiros de dataloggers

Para dataloggers e sistemas que exportam ficheiros CSV ou Excel, muitas vezes por rede móvel e muitas vezes com atraso.

  • Para onde vão os ficheiros: cada equipamento tem a sua pasta (por omissão dentro da pasta de dataloggers escolhida na instalação, com o código do equipamento como nome). O seu servidor FTP ou SFTP, ou uma partilha de rede, coloca lá os ficheiros; também pode carregá-los a partir do browser. Na nossa cloud, os dataloggers enviam por FTP, FTPS ou SFTP.
  • Formatos: CSV com o separador detetado (vírgula, ponto e vírgula, tabulação ou barra vertical) e Excel .xlsx (primeira folha). Uma coluna por tag, ou linhas longas de hora, tag e valor; uma linha de unidades é reconhecida.
  • Números: vírgula ou ponto decimal; on/off, true/false e yes/no são lidos como 1/0.
  • Leitura segura: um ficheiro só é lido quando deixa de mudar, por isso um envio lento nunca é lido a meio. Um ficheiro enviado duas vezes é reconhecido pelo conteúdo e ignorado, e ficheiros sobrepostos nunca guardam um valor duas vezes.
  • Ficheiros atrasados são arquivados nas suas próprias horas, e os alarmes disparam na mesma para as passagens de limite que contêm.
  • Ficheiros que não podem ser lidos ficam de parte com o motivo e listados na plataforma. São tentados de novo quando o ficheiro, as definições do equipamento ou o SyncTide mudam, ou quando os volta a tentar.

Verifique a primeira importação de um novo formato de ficheiro. Uma data ambígua como 03/04/2026 é lida com o dia primeiro. Se um sistema escrever o mês primeiro sem o indicar, uma data mal lida coloca as linhas nos dias errados em silêncio, em vez de falhar.

Fusos horários

Duas definições separadas respondem a duas perguntas diferentes. Um erro nunca estraga os dados, mas desloca todo o histórico no ecrã.

Definição Onde O que responde
Fuso horário das datas Separador Comunicação Como ler as datas que chegam deste equipamento
Fuso horário do local Separador Metadados Onde está o equipamento — usado para mostrar os seus dados

Que fuso horário das datas escolher:

  1. O equipamento envia UTC — escolha UTC.
  2. O equipamento envia hora local e muda sozinho para a hora de verão — escolha o fuso pelo nome, por exemplo Europe/Lisbon.
  3. O equipamento envia hora local e nunca muda o relógio (foi acertado à mão) — escolha o desvio fixo correspondente, por exemplo Etc/GMT-1 para UTC+1 (o sinal dos nomes Etc/GMT é invertido).

Mudar um fuso horário nunca reescreve os dados guardados, mas muda a forma como todos os valores existentes são mostrados, nos gráficos, relatórios e exportações. Mude-o de forma consciente e avise quem lê os relatórios.