Ligações (grupo SISTEMA na barra lateral) efetua a gestão das ligações configuradas entre o servidor e o exterior. Uma ligação é uma ligação configurada — uma interface KNX, um servidor Home Assistant, um dispositivo Modbus, um endpoint HTTP, um broker MQTT, um dispositivo BACnet, um dispositivo TCP/UDP. Os dispositivos são depois associados a uma ligação (consulte «O espaço de trabalho Dispositivos»).
Quantas ligações cada protocolo utiliza:
- KNX, Home Assistant e Virtual — exatamente uma ligação cada.
- Modbus TCP, HTTP, MQTT, BACnet/IP e TCP/UDP — tantas quantas necessitar: uma por dispositivo físico ou endpoint (uma por broker para MQTT).
O que é necessário: o protocolo ativado na página Serviços (consulte «Serviços e protocolos»). Uma ligação definida para um protocolo desativado apresenta Ativar <protocolo> em Serviços em vez de um estado em direto.
A lista de ligações
A lista apresenta todas as ligações com um estado em direto.
Para cada ligação, pode:
- Pesquisar por nome, anfitrião ou dispositivo.
- Ativar/desativar a ligação individual.
- Testar — executa um teste de ligação em direto e reporta Ligação efetuada com sucesso ou Falha na ligação. O botão está disponível para KNX, Home Assistant, MQTT, TCP/UDP, BACnet/IP e Sonos.
- Duplicar — copia a ligação (designada por "(cópia)"); útil para um segundo dispositivo Modbus ou TCP/UDP com parâmetros semelhantes.
- Eliminar — um aviso indica quantos dispositivos perdem a respetiva origem: os dispositivos são mantidos e marcados como inacessíveis, não sendo removidos.
Ao selecionar uma ligação, abre-se o respetivo painel de detalhes:
- Para onde estabelece a ligação — as definições de endereço específicas do protocolo.
- Frequência e tempo de espera — intervalo de polling e timeout, onde o protocolo os utiliza.
- Dispositivos nesta ligação — os dispositivos que utilizam esta ligação, com um atalho Abrir em Dispositivos.
Adicionar uma ligação
- Clique em Adicionar ligação.
- Selecione primeiro o protocolo. A janela apresenta de seguida apenas os campos desse protocolo.
- Atribua um nome à ligação — este é o nome apresentado nos dispositivos que utilizam a ligação.
- Preencha os campos do protocolo e clique em Criar ligação.
Parâmetros por protocolo
KNX
| Campo | Descrição |
|---|---|
| Endereço IP / Porta | A interface KNX/IP ou router na sua rede local LAN. |
| Endereço individual | O endereço físico utilizado pelo HyperVisu no barramento. |
| Protocolo de comunicação | Tunnel UDP (ponto-a-ponto para uma interface) ou Multicast (routing). |
| Data/Hora do barramento | Opcional: o servidor transmite a data e hora atuais para o barramento num endereço de grupo, a cada ciclo de envio segundos. |
Clique em Detetar interfaces para pesquisar interfaces KNX/IP na rede. Selecione uma nos resultados para preencher os campos da ligação.
Home Assistant
| Campo | Descrição |
|---|---|
| URL do Home Assistant | URL completo incluindo http:// ou https:// e a porta. |
| Token de API | Token de acesso de longa duração, gerado nas definições de utilizador do Home Assistant. |
Modbus TCP
| Campo | Descrição |
|---|---|
| Endereço IP do servidor | O dispositivo Modbus TCP. |
| Porta | Predefinição 502. |
| Intervalo de polling | Frequência com que o servidor lê os registos, em segundos. |
HTTP
| Campo | Descrição |
|---|---|
| Nome de apresentação | Nome descritivo para o endpoint. |
| URL base | ex.: https://api.example.com/v1. Os caminhos dos objetos são anexados a este (consulte «Integração HTTP»). |
| Porta | Opcional; normalmente derivado do URL. |
| Intervalo de polling | Segundos entre leituras. Defina 0 para um endpoint apenas de escrita. |
| Timeout | Tempo limite do pedido em milissegundos. |
| Autenticação | Nenhuma, Chave de API (Cabeçalho), Chave de API (Parâmetro de consulta), Autenticação básica, Token Bearer ou Cabeçalhos personalizados (enviados com cada pedido). |
MQTT
| Campo | Descrição |
|---|---|
| Endereço do broker | Anfitrião ou URL completo (mqtt://, mqtts://, ws://, wss://); um anfitrião simples corresponde a mqtt://. |
| Porta | Predefinição 1883 (8883 para mqtts://). |
| Nome de utilizador / Palavra-passe / ID do cliente | Credenciais caso o broker as exija; deixe o ID do cliente em branco para derivar um a partir do endereço MAC do servidor. |
| Aceitar certificados autoassinados / Certificado CA | Apenas TLS (mqtts:// / wss://): desativado por predefinição; cole o certificado PEM da autoridade de certificação quando esta não for pública. |
| Opções do broker | Keepalive (60 s), QoS predefinida (0/1/2), Tópico de disponibilidade (hypervisu/status) com Anunciar disponibilidade do HyperVisu, Sessão limpa. |
Testar liga ao broker e aguarda pela respetiva confirmação — também disponível na janela de criação antes da ligação existir (consulte «Integração MQTT»).
Quando o broker integrado estiver em execução e ainda nada estiver ligado a ele, a página Ligações disponibiliza um atalho: um painel intitulado O broker MQTT local está em execução com o botão Utilizar o broker local, que cria a ligação com a conta gerida pelo próprio HyperVisu — sem necessidade de introduzir endereço ou palavra-passe (consulte «O broker MQTT integrado»).
BACnet/IP
| Campo | Descrição |
|---|---|
| Endereço do dispositivo | Endereço IP do dispositivo BACnet ou do router a montante. |
| Porta | A porta UDP em que o dispositivo escuta (padrão 47808). |
| Instância do dispositivo | A instância do objeto de dispositivo (0–4194302); opcional, verificada pelo teste quando definida. |
| Duração da subscrição COV | Segundos antes da renovação de uma subscrição por alteração de valor (COV); vazio = predefinição do serviço (600 s). |
| Intervalo de polling (segundos) | Frequência com que os pontos sem subscrição COV são relidos (predefinição 30). |
Clique em Pesquisar rede para enviar uma mensagem Who-Is em broadcast e selecionar o dispositivo a partir das respostas — o endereço, porta e instância são preenchidos automaticamente (consulte «Integração BACnet/IP»).
TCP/UDP
| Campo | Descrição |
|---|---|
| Endereço do dispositivo / Porta | O dispositivo (AUDAC XMP44: porta 5001). |
| Intervalo de polling (segundos) | Frequência de releitura do dispositivo; 0 para um dispositivo que envia o seu estado de forma autónoma. |
| Enquadramento e temporização | Transporte (TCP · ligação persistente / UDP · datagramas), Delimitador de trama (\r\n), Codificação do payload (Texto ASCII / Bytes HEX), Porta de escuta (UDP), Trama de heartbeat • A cada (TCP), Timeout de ligação, Atraso entre comandos, Ler tudo ao ligar. |
As tramas propriamente ditas são configuradas por objeto (consulte «Integração TCP/UDP»).
Virtual
Nada a configurar — os dispositivos virtuais residem inteiramente no servidor (consulte «Dispositivos virtuais e Node-RED»).