Saltar para o conteúdo
Elausys

HyperVisu / Resolução de problemas e referência

Resolução de Problemas: KNX e Dispositivos

Sem telegramas, interface ocupada, dispositivos sem resposta — um guia de diagnóstico por etapas.

elausys · 15 agosto 2026
Nesta página

KNX

Comece por clicar em Testar na ligação KNX da página Ligações (ver "Ligações"): será indicado Ligação bem-sucedida ou Falha na ligação. O teste de ligação do assistente de configuração inicial (ver "Assistente de Configuração Inicial") vai mais além e funciona como uma sequência de diagnóstico: cada um dos seus cinco resultados valida uma camada — alcance de rede, porta, túnel, endereço atribuído e telegramas intercetados durante o teste (cerca de cinco segundos). O monitor de barramento (ver "Monitor de Barramento KNX") é a confirmação: se os telegramas surgirem aí, a ligação ao barramento está operacional.

ProblemaVerificaçãoResolução
Os dispositivos KNX não respondemO protocolo KNX está ativado (ver "Serviços e Protocolos")? O que indica o estado da ligação (ver "Ligações")?Ative o protocolo; verifique o IP da interface e as respetivas configurações; execute o teste de ligação.
O teste de ligação não abre o túnelExistem outras ferramentas ligadas à mesma interface?As interfaces KNX/IP dispõem de um número limitado de canais de túnel. Feche o ETS ou outras ferramentas de barramento, ou reinicie a alimentação da interface.
Um único dispositivo não respondeO objeto do widget está associado ao endereço de grupo correto (ver "Integração KNX")? Existem erros de transformação?Corrija a associação; consulte a página Estado (ver "Transformações de Valores e Diagnóstico") para identificar ligações incompatíveis e erros de execução.

Dispositivos e dados

ProblemaVerificaçãoResolução
Um dispositivo não responde a partir da aplicaçãoEstado da ligação (ver "Ligações"); objetos não associados; página de Estado (ver "Transformações de Valores e Diagnóstico")Associe os objetos em falta, restabeleça a ligação e corrija os erros de transformação.
Um dispositivo ignora comandos gerais / comandos de divisãoEstá excluído de comandos globais (ver "PIN de Alarme e Exclusões de Comandos Globais")?Essa exclusão é intencional — foi definida pelo administrador. Remova-a no painel de administração se não for pretendida.
Sem histórico, gráficos vaziosO serviço de histórico está ativado (ver "Serviços e Protocolos")? A opção Registar valores históricos está ativa nesse objeto (ver "Definições de Objetos, Registo e Notificações")?Ative a base de dados de histórico e ative a opção Registar valores históricos por objeto. O histórico tem início no momento em que o registo é ativado — não tem efeitos retroativos.
A meteorologia não apresenta dadosChave de API introduzida? Localização definida (ver "Definições de Rede e Hora", "Serviço Meteorológico")? Serviço ativado?Introduza uma chave de fornecedor válida e configure a localidade/coordenadas; teste a leitura em tempo real na página Meteorologia.
Os preços de energia estão vaziosChave ENTSO-E? Zona de ofertas selecionada (ver "Serviço de Preços de Energia")?Introduza a chave, selecione a zona de ofertas, clique em Guardar Configuração e ative o serviço; a opção desativa-se automaticamente caso a obtenção de dados falhe.
Uma ligação MQTT surge com o estado inativoTeste a ligação (ver "Ligações"): o broker indica Não autorizado ou recusa a ligação?Corrija o nome de utilizador/palavra-passe ou a porta; para ligações mqtts://, verifique o certificado (certificado da CA, ou selecione Aceitar certificados autoassinados para brokers com certificado próprio). O servidor tenta restabelecer a ligação automaticamente assim que estiver correto.
Um widget MQTT nunca atualizaO tópico do objeto corresponde exatamente ao que o dispositivo publica? O caminho JSON aponta para um campo existente?Clique em Analisar broker no editor de objetos (ver "Integração MQTT") e selecione o tópico e o campo a partir dos dados reais que o broker transmite — um caminho incorreto descarta todas as mensagens silenciosamente. Um tópico de saída não pode conter + ou #. Um broker que recuse filtros de tópicos (pela respetiva lista de controlo de acessos) é registado nos logs do servidor.
O broker integrado não apresenta dados na página MQTT BrokerO serviço MQTT Broker está ativado e o servidor foi reiniciado posteriormente (ver "Serviços e Protocolos")?Ative o serviço, reinicie o sistema e reabra a secção Configurar. O painel de Estado indica quando o broker não se encontra em execução (ver "O Broker MQTT Integrado").
Um dispositivo não consegue ligar-se ao broker integradoO dispositivo tem uma conta própria criada? O endereço configurado no dispositivo é exatamente o indicado em Endereço a introduzir no dispositivo?Crie uma conta dedicada por dispositivo; as ligações anónimas estão desativadas por predefinição, pelo que qualquer dispositivo sem credenciais é recusado. Verifique se o módulo de escuta apresenta o estado A escutar e não Desativado.
Um dispositivo deixa de funcionar imediatamente após ativar as regras de tópicosEssa conta tem uma regra definida para os tópicos que utiliza?Com a opção Restringir tópicos por conta ativada, uma conta sem regras correspondentes é recusada. Crie uma regra por dispositivo; a conta interna do HyperVisu não necessita de regras — mantém sempre acesso total.
Os valores retidos desaparecem após reiniciarA opção Manter mensagens retidas após reiniciar está ativada? A opção Permitir mensagens retidas está ativada?Ative ambas as opções. Sem persistência, o broker inicia vazio e cada widget aguarda pela publicação seguinte do dispositivo.
Nada é publicado nos tópicos de estadoA opção Publicar estados dos widgets em MQTT está ativada? O painel indica que está ativa mas não publica?A publicação requer o protocolo MQTT ativado e uma ligação estabelecida a um broker. Confirme se a pré-visualização do tópico corresponde ao tópico subscrito — o número de série e o formato do tópico fazem parte do mesmo.
Os comandos num tópico …/set não surtem efeitoA opção Aceitar comandos por MQTT está ativada? O acesso anónimo está desativado? O objeto é apenas de entrada?Os comandos são integralmente recusados quando o broker aceita clientes anónimos, e mensagem a mensagem em objetos de apenas leitura ou payloads incompatíveis com o tipo de dados do objeto.
O comando Analisar rede em BACnet não deteta dispositivosO serviço BACnet/IP está em execução (ver "Serviços e Protocolos")? O dispositivo encontra-se nesta sub-rede e na porta padrão?Ative o serviço; de seguida utilize Analisar endereço (ver "Integração BACnet/IP") com o endereço de broadcast da sub-rede (192.168.1.255) quando os broadcasts são filtrados entre VLANs, ou o próprio IP do dispositivo (192.168.1.70:47808) — um dispositivo numa porta não padrão nunca é detetado por broadcast.
Um dispositivo BACnet ignora o widgetExiste outro sistema (como o sistema de gestão técnica centralizada) a escrever no mesmo objeto? Desfasamento de valor num objeto multistate?Defina uma Prioridade de escrita numericamente inferior à do outro emissor (ver "Integração BACnet/IP"); utilize o ajuste -1 em associações multistate.
Um teste TCP/UDP falha ou a ligação permanece com o estado inativoNão é possível alcançar … tempo limite de ligação esgotado ou ECONNREFUSEDVerifique o endereço e a porta, e confirme se mais nenhum software retém a ligação única do dispositivo (como a ferramenta de configuração do fabricante). Um teste realizado numa ligação já estabelecida pelo serviço apresenta o estado em tempo real em vez de iniciar uma nova sondagem — este comportamento é normal.
O comando Analisar rede em Sonos não deteta zonasAs colunas estão no mesmo segmento de rede que o servidor? O protocolo Sonos está ativado?A deteção utiliza broadcast de rede, que é frequentemente bloqueado por routers e VLANs. Introduza manualmente o IP da coluna principal — basta um endereço para toda a instalação (ver "Integração Sonos").
Os botões de fontes Sonos apresentam nomes incorretosOs favoritos foram alterados na aplicação Sonos após a criação do widget?Clique em Sincronizar favoritos Sonos no widget (ver "Biblioteca de Dispositivos e Associação Sonos"). Os nomes ficam guardados no widget e não são atualizados automaticamente a partir da aplicação Sonos.
Um dispositivo criado a partir da biblioteca não respondeClicou em Aplicar alterações após a sua criação? O dispositivo requer a ativação de uma opção específica (nos seus Requisitos de configuração)?Aplique as alterações pendentes; de seguida, reveja os requisitos do modelo — a maioria dos inversores é fornecida com o Modbus TCP desativado e alguns necessitam de conta de instalador para o ativar (ver "Biblioteca de Dispositivos e Associação Sonos").
Um dispositivo TCP/UDP ignora comandos ou não envia valoresO modelo termina com o delimitador correto? Os comandos são enviados em sequência rápida? Existe um Padrão de correspondência?Verifique a pré-visualização da Trama enviada (ver "Integração TCP/UDP"); aumente o Atraso entre comandos; um objeto de entrada sem padrão de correspondência nunca recebe valores, e a chave deve constar na trama de resposta do dispositivo.

Perguntas frequentes

Por onde devo começar quando os dispositivos KNX não respondem?

Verifique se o protocolo KNX está ativo, confirme as definições da interface e execute Ligações → KNX → Testar. O monitor de barramento confirma se os telegramas chegam ao HyperVisu.

Por que razão a etapa de túnel KNX falha?

A interface pode não ter canais de túnel livres. O HyperVisu necessita de um túnel dedicado e não o liberta para o ETS; feche o ETS ou outros utilitários de barramento, ou utilize uma interface com mais canais.

Por que razão os meus gráficos de histórico estão vazios?

Ative a base de dados de histórico e o registo no respetivo objeto. A gravação inicia-se assim que o registo é ativado; não é possível recuperar leituras anteriores.

Por que razão um widget MQTT nunca atualiza?

Verifique a correspondência exata do tópico de estado e do caminho JSON. Utilize a função de análise do broker no editor de objetos para selecionar o tópico e o campo a partir das mensagens reais.

Por que razão um dispositivo da biblioteca não responde após a sua criação?

Aplique as alterações pendentes e verifique os requisitos de configuração do modelo. Alguns equipamentos exigem a ativação individual do respetivo protocolo, como o Modbus TCP.

Por que razão os favoritos Sonos estão desatualizados?

Os nomes dos favoritos guardados no widget não são atualizados automaticamente. Utilize a opção Sincronizar favoritos Sonos após efetuar alterações na aplicação Sonos.

Continuar a explorar

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

Voltar a Resolução de problemas e referência