Definições de objetos
Todos os objetos de comunicação possuem uma janela de definições — abra a linha do objeto e clique em Editar. O que é apresentado depende do protocolo, mas os campos comuns são:
Geral
| Campo | Descrição |
|---|---|
| Nome | O nome do objeto. |
| Datatype | O tipo de dados do objeto. Selecionar um tipo de dados diferente do tipo nativo do objeto apresenta um aviso: é necessária uma transformação para converter entre eles (ver “Transformações de Valor e Diagnóstico”). |
| Direção | Entrada, saída ou ambos. |
Definições de valor
| Campo | Descrição |
|---|---|
| Intervalo - Mín / Máx | A escala de valores. |
| Etiqueta - Mín / Máx | Etiquetas para os limites da escala (ex. Fechado / Aberto). |
| Casas decimais | Precisão de visualização. |
| Unidades | A unidade apresentada (ex. °C, kWh). |
Definições por protocolo
- KNX: Endereço de Grupo, Tipo de Ponto de Dados — o servidor lê o endereço no arranque para que a aplicação apresente um valor de imediato.
- Home Assistant: Entity ID e opcionalmente o Atributo a ler.
- Modbus: ver “Integração Modbus TCP”.
- HTTP: ver “Integração HTTP”.
- MQTT: tópico, formato da carga útil (payload), opções de publicação e subscrição — ver “Integração MQTT”.
- BACnet/IP: tipo de objeto e instância, tipo de valor, subscrição COV (Change-of-Value) e prioridade de escrita — ver “Integração BACnet/IP”.
- TCP/UDP: chave, modelos de comando e consulta, padrão de correspondência — ver “Integração TCP/UDP”.
- Virtual: Valor Padrão e Persistente (mantém o valor após reinícios) — ver “Dispositivos Virtuais e Node-RED”.
- Câmara: o URL do Stream da Câmara (ver “Configuração de Câmaras e Videoporteiro”).
- Videoporteiro: o endereço do videoporteiro e credenciais (ver “Configuração de Câmaras e Videoporteiro”).
Notificações
Um objeto pode gerar uma notificação push quando um valor recebido cumpre uma regra:
| Campo | Descrição |
|---|---|
| Tipo | Não (desativado), Igual, Maior que, Menor que. |
| Valor | O valor de limiar ou de correspondência. |
| Intervalo (s) | Tempo mínimo entre notificações repetidas para a mesma condição. |
As notificações são enviadas para a aplicação como mensagens push (ver “Notificações Push”).
Registo de dados (Logging)
- Ativar registo — escreve todas as alterações de valor no histórico de séries temporais (InfluxDB). É este histórico que alimenta os gráficos de tendências na aplicação, gráficos de contadores, painéis Grafana e exportação CSV (ver “Histórico e Registo de Dados”). A linha do dispositivo passa a apresentar o distintivo LOGGED.
- Persistir Estado — guarda o valor na alteração e restaura-o após o reinício do servidor.
As alterações entram em vigor ao guardar; o registo tem início com o próximo valor recebido.
O construtor de painéis Grafana
Os objetos com registo ativo oferecem a ação Painel Grafana, que cria um painel Grafana ou uma consulta Flux para o objeto:
- Selecione 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.
- De seguida, copie o JSON do Painel ou apenas a consulta (Flux) para colar manualmente no Grafana, ou selecione um painel de destino e clique em Adicionar painel — o painel é adicionado a esse dashboard. Também pode criar um novo dashboard indicando um nome.
Se faltar alguma configuração, o diálogo especifica exatamente o motivo: o Grafana está desativado (ative-o em Serviços), não existe token de API configurado (ver “Serviços e Protocolos”), o Grafana está inacessível ou o token não possui permissões de Editor. Mais detalhes sobre o Grafana e dashboards em “Histórico e Registo de Dados”.
