Envio de mensagens do Tulip para o Node-RED
  • 08 Jan 2025
  • 3 Minutos para Ler
  • Contribuintes

Envio de mensagens do Tulip para o Node-RED


Resumo do artigo

Para enviar mensagens da Tulip (por exemplo, de in-App Triggers ou Automações), um Connector pode ser utilizado. Isso é feito mais facilmente com o Connector Host instalado em todos os Tulip Edge Devices.

Com os dispositivos Tulip Edge

O fluxo a seguir será utilizado para enviar uma mensagem de um Tulip Trigger para o Node-RED em execução em um Tulip Edge Device:

Communicate with Machines using Edge MC's Connector Host & Node-RED_314676359.png

Uma vez concluído, use o conector recém-criado em qualquer aplicativo ou automação Tulip para enviar mensagens ao Node-RED, como comandos de dispositivos ou entradas de fluxo.

No Tulip: Configuração do conector e do host do conector

Observação: se você não estiver familiarizado com Connector Hosts e Connector Function no Tulip, consulte este artigo.

  1. Crie um novo conector na página Conectores em sua instância do Tulip.
  2. Na janela modal que aparece, preencha as informações conforme especificado abaixo:

Nome: Escolha um nome para o seu conector HostDescription: Escolha um nome para seu Connector HostConnectorType: Selecione HTTP

  1. Clique em "Save" (Salvar).
  2. Para especificar os detalhes do Connector Host, clique no botão production & testing & development à esquerda. Na janela modal que aparece, insira as seguintes informações:

Running On: selecione o Connector Host do Edge Device de destino *Observação: se o Connector Host do Edge Device não puder ser encontrado, navegue até o portal do Edge Device e verifique se a opção "Connector Host" foi ativada.*Host: Digite localhostPort: Digite 1880 (essa é a porta em que o Node-RED está sendo executado)TLS: Digite NoNão há necessidade de adicionar cabeçalhos ou certificados.

  1. Clique em Test (Testar) e verifique se a conexão é aprovada. Por fim, clique em Save (Salvar).

Esse conector agora pode se comunicar com o Node-RED no Edge Device de destino.


Em Node-RED: Configuração do nó HTTP IN

Observação: esta seção pressupõe familiaridade com o Node-RED.

Para receber a mensagem do Connector Host no dispositivo, será usado um nó HTTP IN.

  1. Clique e arraste para adicionar um nó HTTP IN da paleta no lado esquerdo do Node-RED Editor ao fluxo:

image.png

Digite as seguintes informações: Method (Método): URL POST : qualquer caminho definido pelo usuário, como /nodeRED ou /myMachine/0013. Ele será reutilizado no Node-RED, portanto, deve ser fácil de reconhecer e lembrar.O exemplo abaixo mostra o URL configurado como /test: image.png

  1. Clique em "Done" (Concluído) para salvar as alterações.

As solicitações HTTP falharão sem que uma resposta seja retornada ao servidor (nesse caso, o Tulip). 1. Arraste um nó de Resposta HTTP. 2. Conecte o nó HTTP Request ao nó HTTP Response.3. Clique duas vezes no nó HTTP Response e digite 200 como código de status. Clique em Done (Concluído).

image.png

HTTP Responses and Advanced Feedback

Modify the Status Code and/or use the +add button in the HTTP Response node to modify or add to the Connector's response. These data (most often, system or device outputs generated by the Flow) will appear in the Connector's Response. Configure Connector Outputs with the guide here!!is this the right wording??!!.

  1. Por fim, arraste um nó Debug da paleta. Configure esse nó para emitir**"Objeto de mensagem completa** usando o menu suspenso msg.:image.png

Esse fluxo do Node-RED agora receberá uma mensagem do Tulip e a exibirá no registro de depuração do Node-RED.

Um fluxo concluído pode aparecer como mostrado abaixo:image.png

Clique em Deploy (Implementar ) no canto superior direito para confirmar todas as alterações.

No Tulip: Configuração e teste da função de conector

Quando a configuração do fluxo do Node-RED estiver concluída, retorne ao conector no Tulip. 1. Crie uma nova função de conector. 2. Altere a Connector Function de GET para POST. 3. Digite o caminho configurado no Node-RED (neste exemplo, /test) no URL. 4. (opcional) para adicionar conteúdo ao conector (como uma mensagem ou comando), adicione uma entrada ao conector. 5. (opcional) Adicione a entrada ao corpo da solicitação alterando primeiro o tipo de conteúdo para JSON e, em seguida, adicionando um item à raiz.

A captura de tela abaixo mostra um conector configurado para o ponto de extremidade /test especificado acima e inclui uma entrada chamada testValue:image.png

Clique em "Run" (Executar) para testar a função do conector. Dois indicadores de sucesso ocorrerão: 1. A Connector Function receberá uma resposta 200 OK, contendo (se aplicável): 1. Todas as entradas configuradas para o Conector 2. Quaisquer saídas adicionais configuradas no nó de resposta HTTP do Node-RED2. O registro de depuração no Node-RED exibirá a mensagem do conector. Observação: dependendo da versão atual do Node-RED, o corpo da solicitação do Conector pode ser encontrado em: a. msg.payload ou b. msg.req.body

Ambos os estados de sucesso podem ser encontrados abaixo:

Connector Success:image.png

Node-RED Success:image.png


Este artigo foi útil?