Saltar para o conteúdo
Elausys

HyperVisu / Configuração do dispositivo

Definições de objetos, registo e notificações

Intervalos, etiquetas, registo em InfluxDB, persistência de estado e regras de notificação.

elausys · 17 julho 2026
Nesta página

Definições do objeto

Cada objeto de comunicação tem uma caixa de diálogo de definições: expanda o dispositivo e clique na roda dentada no fim da linha do objeto (Edit Object). O que aparece depende do protocolo, mas as partes comuns são:

General

FieldDescription
Object NameO nome do objeto.
DatatypeO tipo de dados do objeto. Escolher um tipo de dados diferente do nativo do objeto mostra um aviso: é necessária uma transformação para converter entre ambos (consulte «Value Transformations & Health»).
AddressA associação do objeto: o endereço de grupo, a entidade ou o endereço de protocolo a que está ligado.

A caixa de diálogo não tem definição de direção: o facto de um objeto receber valores, enviar comandos ou ambos depende do tipo de widget (consulte «The Devices Workspace»).

Value settings

FieldDescription
Range - Min / MaxO intervalo de valores.
Label - Min / MaxEtiquetas para os extremos do intervalo (p. ex., Closed / Open).
Decimal digitsA precisão de apresentação.
UnitsA unidade apresentada (p. ex., °C, kWh).

Definições por protocolo

  • KNX: o endereço de grupo (Address) e o tipo de ponto de dados (Datatype). Não existe a opção «Read on Start»: sempre que a ligação KNX é estabelecida, o servidor lê todos os objetos que recebem um valor e têm endereço, pelo que a aplicação mostra os valores de imediato.
  • Home Assistant: Entity ID e, opcionalmente, o Attribute a ler.
  • Modbus: consulte «Modbus TCP Integration».
  • HTTP: consulte «HTTP Integration».
  • MQTT: topic, formato do payload, opções de publicação e subscrição; consulte «MQTT Integration».
  • BACnet/IP: tipo e instância do objeto, tipo de valor, subscrição de alteração de valor e prioridade de escrita; consulte «BACnet/IP Integration».
  • TCP/UDP: chave, modelos de comando e de consulta, padrão de correspondência; consulte «TCP/UDP Integration».
  • Virtual: o intervalo (Range - Min / Range - Max) e Persist State (manter o valor após reinícios); não existe definição de valor predefinido; consulte «Virtual Devices & Node-RED».
  • Camera: o Camera Stream URL (consulte «Cameras & Videophone Setup»).
  • Videophone: o endereço e as credenciais do videoporteiro (consulte «Cameras & Videophone Setup»).

Notificações

Um objeto pode gerar uma notificação push quando um valor recebido cumpre uma regra. Ative Notifications e defina:

FieldDescription
TypeEqual, Greater than ou Lower than.
ValueO limiar ou o valor de correspondência.
Interval (s)O tempo mínimo entre duas notificações. É um intervalo mínimo, não um temporizador de repetição.

Uma regra dispara quando o valor cruza o limiar, não enquanto permanecer além dele. Uma regra Greater than envia uma notificação quando o valor atinge o limiar; a seguinte só é possível depois de o valor ter voltado a descer abaixo dele, e nunca antes de Interval (s) após a anterior. Um objeto admite uma única regra de notificação.

As notificações são entregues à aplicação como mensagens push (consulte «Push Notifications»).

Settings

  • Log historical values — grava cada alteração de valor no histórico de séries temporais (InfluxDB). É o que alimenta as tendências na aplicação, os gráficos de contadores, os painéis do Grafana e a exportação CSV (consulte «History & Data Logging»). A linha do objeto passa então a mostrar o ícone de base de dados e o botão do Grafana (a legenda LOGGED e GRAFANA, consulte «The Devices Workspace»).
  • Persist State — guarda o valor quando muda e restaura-o após o reinício do servidor. É independente do registo.

Clique em Save object para guardar a caixa de diálogo e depois em Apply changes na barra lateral e confirme (consulte «Admin Panel Tour»). O registo começa com o valor seguinte recebido.

A caixa de diálogo de definições de um objeto de temperatura KNX.

O construtor de painéis Grafana

Os objetos registados oferecem uma ação Grafana panel que cria um painel Grafana ou uma consulta Flux para o objeto:

  1. Escolha o tipo de painel, a função de agregação e o período de agregação, o intervalo de tempo e um título.
  2. Depois, copie o Panel JSON ou apenas a consulta (Flux) para colar no Grafana, ou escolha um painel de controlo de destino e clique em Add panel: o painel é acrescentado a esse painel de controlo. Também pode criar um novo painel de controlo indicando o nome.

Se faltar alguma coisa, a caixa de diálogo indica exatamente o quê: o Grafana está desativado (ative-o em Services), não há token de API definido (consulte «Services & Protocols»), o Grafana está inacessível ou o token não tem permissão de Editor. Os detalhes sobre o Grafana e os painéis de controlo estão em «History & Data Logging».

A caixa de diálogo do painel Grafana para um objeto de potência registado.

Perguntas frequentes

Onde altero as unidades e as casas decimais de uma leitura?

Expanda o dispositivo e clique na roda dentada no fim da linha do objeto (Edit Object). Use Units e Decimal digits em Value settings.

Quando começa o registo do histórico?

Ative Log historical values, guarde o objeto e aplique as alterações. O registo começa com o valor seguinte recebido e grava no InfluxDB as alterações de valor posteriores.

Em que difere o Persist State do registo?

O registo grava um histórico de séries temporais. O Persist State guarda o último valor quando muda e restaura-o após o reinício do servidor.

Como posso reduzir os alertas repetidos de limiar?

Defina o Interval da notificação em segundos. É o tempo mínimo entre duas notificações; uma regra só volta a disparar depois de o valor ter voltado a cruzar o limiar.

Porque é que o construtor de painéis Grafana indica um problema?

Verifique se o Grafana está ativado e acessível, e se o respetivo token de API está configurado com permissão de Editor.

Continuar a explorar

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

Voltar a Configuração do dispositivo