Acessando o Node-RED
O HyperVisu inclui uma poderosa integração com o Node-RED que permite criar automações personalizadas e integrar com sistemas externos. O Node-RED é uma ferramenta de programação baseada em fluxos que facilita a conexão de dispositivos de hardware, APIs e serviços online sem a necessidade de amplo conhecimento em programação.
Para acessar o aplicativo Node-RED:
- Navegue até a interface de administração do HyperVisu digitando o endereço IP do seu servidor em um navegador web
- Faça login com suas credenciais de administração (nome de usuário e senha)
- Clique no botão "Node-RED" na página de administração do servidor
- Uma nova aba do navegador será aberta com a página de login do Node-RED
- Use o mesmo nome de usuário e senha da interface de administração do HyperVisu para acessar o Node-RED
Nota: O ambiente Node-RED roda no mesmo hardware que o seu servidor HyperVisu, portanto, todas as integrações são locais e não requerem serviços de nuvem externos.
Usando os Nós do HyperVisu
O HyperVisu estende o Node-RED adicionando nós personalizados que representam cada tipo de widget em seu sistema de automação residencial. Esses nós permitem que você interaja com seus dispositivos KNX diretamente do Node-RED.
Estrutura do Nó
A integração do HyperVisu com o Node-RED gira em torno de um nó principal "HyperVisu" que gerencia a conexão com o servidor e fornece acesso a todos os widgets, salas e categorias. Este nó central estabelece e mantém:
- Comunicação com o servidor
- Atualizações em tempo real dos valores dos widgets
Nós personalizados adicionais representam cada tipo de widget disponível no HyperVisu:
- Botão de Pressão - Para botões de pressão com feedback de status opcional
- Interruptor de Luz - Para interruptores ON/OFF especificamente para iluminação
- Interruptor ON/OFF - Para interruptores gerais ON/OFF (tomadas, etc.)
- Saída Analógica - Para enviar valores analógicos dentro de uma faixa predefinida
- Persiana/Cortina - Para controlar persianas e cortinas
- Controlador de Temperatura - Para controle de aquecimento/resfriamento
- Dimmer - Para dimmers de iluminação padrão
- Dimmer RGB - Para controlar luzes RGB(W)
- Dimmer de Branco Ajustável - Para ajustar a temperatura de cor das luzes brancas
- Entrada Analógica - Para exibir valores analógicos com tendência opcional
- Entrada Digital - Para exibir valores de status digital
Nós de comando global também estão disponíveis:
- Luzes Globais - Para controlar todas as luzes em uma sala ou categoria
- Persianas Globais - Para controlar todas as persianas em uma sala ou categoria
- Cenário - Para acionar cenários predefinidos
Cada nó exibe seu nome e a sala ou categoria associada dentro do nó para fácil identificação.
Entradas e Saídas
Os nós de widget normalmente têm múltiplas entradas e saídas que correspondem às funções do widget. Por exemplo:
Nó Dimmer:
- Entradas: Alternar, Ligar, Desligar, Ponto de Ajuste (valor de dimmer)
- Saídas: Estado (status on/off), Valor (nível de brilho), Comando de Ligar, Comando de Desligar
Nó Persiana/Cortina:
- Entradas: Para Cima, Para Baixo, Parar, Ponto de Ajuste da Cortina, Ponto de Ajuste das Lâminas
- Saídas: Movendo Para Cima, Movendo Para Baixo, Posição da Cortina, Posição das Lâminas, Para Cima, Para Baixo, Parar
Quando um nó recebe ou envia dados:
- A carga útil da mensagem contém o valor da saída ou entrada
- Um campo de tópico contém o ID do objeto do widget
- Um campo de widget contém o ID do widget
Esses formatos padronizados facilitam o processamento de mensagens entre nós e a construção de automações complexas.
Construindo Fluxos
O Node-RED utiliza uma abordagem de programação visual onde você conecta nós para criar "fluxos" de dados.
Conectando Nós
Para construir um fluxo no editor do Node-RED:
- Encontre os nós do HyperVisu na paleta de nós no lado esquerdo
- Arraste o tipo de nó desejado para o fluxo
- Conecte os nós arrastando linhas entre a saída de um nó e a entrada de outro
- Os nós processam mensagens sequencialmente à medida que fluem pelas conexões
Padrões básicos de fluxo incluem:
- Fluxos de Gatilho: Um nó de gatilho (como um evento de entrada ou tempo) causa uma ação através de um nó de saída
- Fluxos de Transformação: Os dados passam por nós de função que modificam valores antes de chegarem aos nós de saída
- Fluxos de Decisão: Nós de comutação roteiam mensagens de forma diferente com base nos valores recebidos
- Fluxos de Integração: Nós de diferentes sistemas (MQTT, HTTP, etc.) conectam-se para trocar dados
Configurando Nós
Cada nó do HyperVisu deve ser configurado para se conectar a um widget específico em seu sistema:
- Clique duas vezes em um nó para abrir seu painel de configuração
- Use o menu suspenso para selecionar o widget ao qual ele deve se conectar
- Filtre opções por sala, categoria e tipo de widget para encontrar o widget correto
- A lista mostra todos os widgets do mesmo tipo disponíveis na sua configuração do HyperVisu
- Ative/desative a publicação do broker MQTT se necessário (envia valores de widgets para o broker MQTT embutido)
- Clique em Concluído para salvar a configuração
Para widgets virtuais, você pode enviar valores diretamente do Node-RED para atualizar o estado do widget, permitindo integrar sensores ou sistemas que não estão diretamente conectados ao seu barramento KNX.
Implantando Fluxos
Após construir e configurar seus fluxos:
- Clique no botão Implantar no canto superior direito da interface do Node-RED
- Aguarde a mensagem de confirmação que indica a implantação bem-sucedida
- Seus fluxos agora estão ativos e começarão a processar dados
O ambiente Node-RED salva seus fluxos automaticamente, e eles serão reiniciados quando o servidor HyperVisu for reiniciado.
Você pode visualizar o status do fluxo em tempo real:
- Conexões ativas mostram indicadores de status com valores
- Erros aparecem no painel de depuração (acessado pela barra lateral direita)
- Os dados podem ser rastreados usando nós de depuração colocados no fluxo
Recursos Avançados
Integração de Comandos Globais
Comandos globais permitem que você controle vários dispositivos simultaneamente:
- Adicione um nó de Luzes Globais ou Persianas Globais ao seu fluxo
- Configure-o para direcionar uma sala ou categoria específica
- Envie uma mensagem "Ligado" ou "Desligado" para a entrada do nó para controlar todas as luzes nessa sala
- Para persianas, envie "Para Cima" ou "Para Baixo" para controlar todas as cortinas/persianas
Isso é particularmente útil para criar cenas ou controles baseados em tempo que afetam vários dispositivos.
Acionamento de Cenários
Cenários do HyperVisu (grupos predefinidos de estados de dispositivos) podem ser acionados diretamente do Node-RED:
- Adicione um nó de Cenário ao seu fluxo
- Configure-o para selecionar o cenário específico da lista de cenários disponíveis
- Conecte qualquer nó de gatilho à sua entrada
- Quando acionado, o cenário será executado como se ativado pelo aplicativo móvel
Isso permite que você crie gatilhos complexos para seus cenários com base em tempo, eventos externos ou dados de sensores.
Integração de Dispositivos IoT
Uma grande vantagem da integração do Node-RED é conectar dispositivos IoT não-KNX ao seu sistema HyperVisu:
Integrando Sensores Externos:
- Crie um widget virtual no HyperVisu
- Adicione o nó correspondente do Node-RED (como Entrada Analógica)
- Conecte uma fonte de dados externa (MQTT, HTTP, etc.) a este nó
- Quando os dados chegarem, ele atualiza o widget virtual e aparece no aplicativo HyperVisu
Controlando Dispositivos Externos:
- Crie um widget de saída virtual no HyperVisu
- Adicione o nó correspondente do Node-RED (como Interruptor)
- Conecte a saída a um nó que controla seu dispositivo externo (requisição HTTP, publicação MQTT, etc.)
- Quando você controla o widget virtual no HyperVisu, ele aciona a ação externa
O broker MQTT embutido pode ser ativado para qualquer widget, transmitindo suas mudanças de estado em tópicos que correspondem ao ID do objeto do widget. Isso facilita que outros dispositivos compatíveis com MQTT respondam a eventos em sua casa.
Exemplos de Integração:
- Conectar APIs de clima para exibir condições externas em widgets virtuais
- Controlar dispositivos inteligentes que usam diferentes protocolos
- Registrar dados de consumo de energia de medidores inteligentes no InfluxDB
- Construir lógica personalizada para automações avançadas com base em múltiplas condições
Ao aproveitar essa integração do Node-RED, você pode expandir o HyperVisu além de suas capacidades nativas KNX para criar uma solução de casa inteligente verdadeiramente abrangente que integra todos os seus sistemas.