Saltar para o conteúdo
Elausys

HyperVisu / Integrações

Integração KNX

A ligação ao bus, a programação com o ETS no local ou remotamente, a biblioteca de endereços de grupo e a associação por arrastar e largar.

elausys · 21 julho 2026
Nesta página

Integração KNX

A página KNX do painel de administração é o espaço de trabalho para tudo o que diz respeito ao KNX: a ligação ao bus, o acesso de programação ETS, a biblioteca de endereços de grupo, o monitor de bus, o KNX Bridge e os acionadores KNX. Abra-a a partir da barra lateral. A página tem três separadores: Bridge, Bus monitor e Group addresses. Nos separadores Bridge e Bus monitor, uma barra de ligação mostra o Protocol, o Gateway IP e o estado em tempo real (Connected / Disconnected).

Página KNX, navegador de secretária.

Ligação e acesso ETS remoto

O que é necessário: uma ligação KNX configurada (consulte “Connections”) que apresente Connected.

A barra de ligação reflete a ligação KNX que configurou na página Connections. Se apresentar Disconnected, corrija primeiro a ligação aí — nada nesta página funciona sem o bus.

Programar com o ETS no local. O HyperVisu mantém a sua ligação KNX enquanto programa com o ETS: não há nada a comutar e os widgets permanecem ativos. A maioria das interfaces KNX/IP permite apenas um número limitado de túneis, e o HyperVisu ocupa um deles, pelo que o ETS precisa de outro túnel livre na interface (ou de uma interface de programação própria).

Acesso ETS remoto. Para programar o bus com o ETS a partir do exterior do edifício, ative Remote ETS access. Isto abre um túnel seguro através da ligação cloud e apresenta o Server e um número de Port.

  1. Na página KNX (separador Bridge), ative Remote ETS access. O interruptor demora alguns segundos enquanto o túnel é aberto.
  2. Anote o servidor e o número de porta apresentados. A porta é atribuída de novo sempre que o acesso é ativado.
  3. No ETS, configure uma ligação KNX/IP tunnelling para esse servidor e introduza essa porta.
  4. Desative Remote ETS access quando terminar.

📘 Nota: O túnel remoto fecha automaticamente após 8 horas. Volte a ativá-lo se precisar de mais tempo e anote a nova porta.

Separador Bridge, cartão Remote ETS access ativado, com a porta do túnel, a indicação "Use this port number in ETS" e a nota de desativação automática.

Endereços de grupo

O separador Group addresses contém a biblioteca de endereços de grupo do servidor — todos os endereços conhecidos a partir do ETS, que se podem consultar como ETS project tree ("N main groups · M addresses"). É a mesma biblioteca que o espaço de trabalho Devices oferece para a associação por arrastar e largar.

  • Pesquise por endereço, nome ou tipo de ponto de dados através do campo de pesquisa por cima da árvore.
  • Importe endereços a partir de uma exportação XML de endereços de grupo do ETS, se não quiser importar o projeto completo: clique em Import Group Addresses no cabeçalho deste separador e escolha o ficheiro produzido pelo ETS através de Group Addresses → Export.

Seleccione um endereço na árvore para abrir o respetivo painel de detalhe:

CampoSignificado
Last valueO valor descodificado mais recente observado no bus.
Last seenQuando esse valor chegou.
Used byTodos os dispositivos e automatismos associados a este endereço ("Not used by any device or automation" quando está livre).
Watch on the bus monitorAbre o separador Bus monitor com um lembrete do endereço. A tabela não é filtrada: escreva o endereço em Search telegrams... para isolar os respetivos telegramas (consulte “KNX Bus Monitor”).

💡 Dica: “Used by” é a forma mais rápida de responder a “o que acontece se este endereço mudar?” antes de alterar qualquer cablagem.

Separador Group addresses.

Associar KNX

No espaço de trabalho Devices, o separador KNX da barra Communication objects mostra a ETS project tree — os seus endereços de grupo, organizados como no ETS — seja qual for o dispositivo selecionado. Se a árvore estiver vazia, clique em Import Group Addresses na barra e escolha a exportação de endereços de grupo do ETS (XML) (consulte “Group addresses” acima).

Para associar:

  1. Expanda a linha do dispositivo (Show objects) para mostrar os respetivos objetos de comunicação.
  2. Encontre o endereço na árvore ou escreva em Search group addresses....
  3. Arraste o endereço de grupo para a linha do objeto correspondente. Durante o arrasto, as linhas vazias indicam Drop here to assign. O endereço é atribuído e o objeto assume o tipo de ponto de dados (DPT) do endereço a partir dos dados do ETS, com a unidade e o número de casas decimais correspondentes.
  4. Repita para cada objeto de comando e de feedback do dispositivo.
  5. Clique em Apply changes na barra lateral e, de seguida, em Apply changes na caixa de diálogo Apply configuration changes (consulte “Admin Panel Tour”).

📘 Nota: Um endereço de grupo é largado numa linha de objeto de cada vez. Não pode ser largado no dispositivo como um todo: apenas uma entidade do Home Assistant preenche vários objetos numa só operação (consulte “Home Assistant Integration”).

Um endereço de grupo a ser arrastado da árvore ETS para a linha do objeto "Position" de um dispositivo expandido.

Quando o tipo de dados não coincide. Se o DPT do endereço de grupo for diferente do que o objeto espera, a caixa de diálogo Data type differs from object type explica a divergência: o tipo de dados real do endereço será associado ao objeto e é necessária uma transformação para converter entre ambos. Clique em Cancel e largue o endereço correto, ou clique em Map anyway apenas se pretender adicionar a transformação — o objeto continua assinalado na página Health até o fazer (consulte “Value Transformations & Health”).

💡 Dica: Caso típico: um byte de estado (DPT 5.010) a alimentar um objeto booleano — use Map anyway e, depois, adicione uma transformação Bit Check (consulte “Value Transformations & Health”).

Perguntas frequentes

Tenho de desligar o HyperVisu antes de programar com o ETS?

Não. O HyperVisu mantém a sua ligação KNX e os widgets permanecem ativos enquanto o ETS programa. O ETS só precisa de um túnel livre próprio na interface.

Durante quanto tempo fica aberto o acesso ETS remoto?

O túnel remoto seguro fecha automaticamente após oito horas. Volte a ativá-lo se precisar de mais tempo; a porta muda de cada vez.

Posso importar endereços de grupo sem um projeto ETS completo?

Sim. Importe uma exportação XML de endereços de grupo do ETS no separador Group addresses.

Como associo um endereço de grupo KNX?

Arraste-o da árvore do projeto ETS para a linha de um objeto, um objeto de cada vez. O objeto assume o DPT importado. Depois, aplique as alterações.

O que acontece se o DPT não coincidir com o objeto?

A caixa de diálogo de divergência explica a conversão necessária. Se selecionar Map anyway, adicione uma transformação adequada; até lá, o Health assinala o objeto.

Continuar a explorar

Encontre os outros guias deste produto na documentação.

Voltar a Integrações