Saiba como usar o Connector Host do Edge MC para se comunicar com dispositivos Node-RED
No artigo a seguir, vamos...
- Configurar o Connector Host do Edge MC
- Criar uma função de conector para se comunicar com seu dispositivo
- Criar um aplicativo para se comunicar com seu dispositivo
Pré-requisitos
- Certifique-se de ter habilitado o Node-RED no seu Edge MC. Para obter instruções sobre como fazer isso, consulte este artigo.
Resumo
Ao utilizar o Connector Host do seu Edge MC, você pode usar um aplicativo para acionar funções de conector que se comunicam com o Node-RED em execução em um dispositivo Tulip. Isso, em última análise, permitirá que você faça gravações em máquinas a partir de um aplicativo Tulip.
Configurando o seu Conector do Edge MC
Observação: se você não estiver familiarizado com conectores e funções de conector no Tulip, consulte este artigo.
Para começar, acesse a página “Conectores ” e clique em “Criar conector”. Uma janela modal será exibida, solicitando que você preencha as seguintes informações:
- Nome: Escolha um nome para o seu conector
- Descrição: Escolha uma descrição para o seu conector
- Tipo de conector: selecione HTTP
Em seguida, você precisará especificar os detalhes do conector. Clique no botão “Produção, teste e desenvolvimento” para abrir a janela modal “Editar detalhes do conector ” e insira as seguintes informações:
- Executando em: Selecione seu host do conector EMC Observação: Caso você não veja essa opção, acesse o portal do Edge MC e certifique-se de que o “Host do conector” esteja habilitado.
- Host: Insira localhost
- Porta: Digite 1880 (essa é a porta na qual o Node-RED está sendo executado)
- TLS: Digite “Não”
Não é necessário adicionar cabeçalhos ou certificados. Agora você está pronto para clicar em “Testar” e verificar se sua conexão foi bem-sucedida. Por fim, clique em “Salvar”.
Criando uma função de conector
Agora que você configurou seu conector com sucesso, está pronto para começar a criar funções de conector para se comunicar com seus dispositivos Tulip. Neste exemplo, o Node-RED atuará como um servidor HTTP.
Para configurar sua função de conector, você precisará configurá-la no Tulip, bem como no editor do Node-RED. Neste exemplo, criaremos uma função simples que recebe como entrada “firstName” e “lastName” e retorna uma resposta “Olá, firstName, lastName!”, além de um carimbo de data/hora.
Criação da função de conector no Tulip
Acesse o conector do seu Edge MC e selecione “Criar função” no canto superior direito.
Selecione GET como Tipo de solicitação e insira o endpoint: /helloWorld. Embora isso possa parecer arbitrário, em uma etapa posterior configuraremos esse endpoint no editor do Node-RED:
{height="" width=""}Configure as entradas da função para incluir Nome e Sobrenome:
{height="" width=""}No Corpo da solicitação, selecione Tipo de conteúdo: JSON e defina as seguintes chaves para as entradas. Elas serão referenciadas posteriormente no editor do Node-RED:
{height="" width=""}Agora adicione as seguintes saídas à função do conector: “Mensagem ” e “Hora”. Adicione o “Corpo” associado às saídas, para que possam ser referenciadas no editor do Node-RED:
{height="" width=""}Em seguida, verifique se o seu Tipo de Resposta está definido como JSON.
Você concluiu a configuração da função do conector no lado do Tulip. Clique em “Salvar” para salvar a função do conector.
Criando o fluxo no Node-RED
Agora é hora de abrir o editor do Node-RED a partir do seu portal do Edge MC e configurar um novo fluxo.
Primeiro, arraste e solte um nó http da seção de rede no seu editor. Defina o nó com a seguinte configuração:
{height="" width=""}É importante que o Método de Solicitação e a URL de Solicitação correspondam à função do conector que você configurou no Tulip.
Em seguida, arraste e solte um nó “change” com a seguinte configuração:
{height="" width=""}Defina msg.payload como JSON e deixe-o como um objeto vazio: {}
Agora insira um nó de modelo. É aqui que você pode pegar as propriedades da mensagem recebida (entradas da função do conector) e construir uma string com elas (por exemplo, “Hello World”).
## {{req.body.firstName}}
## {{req.body.lastName}}!
Agora é hora de adicionar outro nó de alteração para capturar um carimbo de data/hora e enviá-lo de volta como parte da resposta. Configure o nó da seguinte maneira:
{height="" width=""}Neste ponto, nosso fluxo já aceitou as entradas enviadas pelo Tulip, e agora é hora de configurar uma resposta. Para isso, arraste e solte um nó de resposta HTTP. Configure a resposta para ter um Código de Status 200, OK:
{height="" width=""}O fluxo geral agora está concluído e deve ter uma aparência semelhante à seguinte:
{height="" width=""}Observe que os nós verdes no fluxo acima são nós de depuração, utilizados para exibir sua carga útil no editor do Node-RED.
A etapa final será implantar seu fluxo a partir do editor do Node-RED. Agora você poderá testar a função do seu conector no ambiente de teste do Tulip,
Executando a função do conector por meio de um aplicativo
Agora que você configurou seu conector e uma função de conector que se comunica efetivamente com seu dispositivo usando o Node-RED como servidor HTTP, você está pronto para integrar essa funcionalidade aos seus aplicativos.
Neste exemplo, há dois campos de entrada para receber as variáveis firstName e lastName que serão enviadas em nossa solicitação:
{height="" width=""}No botão “Say Hello!”, insira o seguinte gatilho para chamar a função do conector:
{height="" width=""}Depois de inserir seus dados e clicar em “Say Hello!”, você terá enviado efetivamente uma solicitação HTTP para o seu dispositivo Tulip e recebido uma resposta JSON.
Para testar seu aplicativo, clique no botão “Testar” no Editor de Aplicativos para entrar no Modo de Desenvolvimento!