Envio de dados do Node-RED para o Tulip com nós do Tulip
  • 20 Feb 2024
  • 4 Minutos para Ler
  • Contribuintes

Envio de dados do Node-RED para o Tulip com nós do Tulip


Resumo do artigo

Visão geral

Existem três métodos principais para enviar dados do Node-RED (como dados do dispositivo ou do sistema externo) para a Tulip:

  1. via Tulip Machine API
  2. via API de tabelas da Tulip
  3. via Connector Response *Observação: requer um Connector primeiro, originado da Tulip.

Para otimizar as comunicações pelos métodos 1 e 2, a Tulip criou três Nodes primários:

  1. tulip-tag: Envia dados para a API de atributos de máquina com funcionalidade avançada - somente Tulip Edge Device2. machine-attribute: Envia dados para a API de atributos da máquina a partir de qualquer dispositivo. 3. tables: Enviar e receber dados de/para a API de tabelas de qualquer dispositivo

Todos os três nós listados acima são pré-instalados nos dispositivos Tulip Edge. Além disso, os nós 2 e 3 acima são publicados na biblioteca Node-RED para download em qualquer dispositivo. Eles podem ser encontrados em here{target=_blank}.


Envio de dados para um atributo de máquina Tulip

Observação: esta seção pressupõe que um atributo de máquina Tulip tenha sido criado. Para obter mais informações, consulte este guia.

De um dispositivo Tulip Edge: o Tulip-tag Node

O tulip-tag Node é compatível com os dispositivos Tulip Edge que executam a versão 51 ou superior do software.

  1. Para usar o tulip-tag Node, primeiro arraste-o para o painel do editor a partir da Paleta. Clique duas vezes no nó para abrir seu painel de configuração.
  2. Clique no lápis para adicionar uma nova lista de tags:
Aviso! Listas de tags) Só há suporte para uma lista de tags ativa por dispositivo de borda. Certifique-se de desativar todos os fluxos que estejam executando outras listas de tags antes de começar. ::: <insira a foto do artigo existente [aqui>](https://support.tulip.co/docs/how-to-send-data-to-machines-from-edge-devices-using-node-red-and-tulip-tags
  1. Clique em +add para adicionar uma nova tag. Cada tag tem três partes: um ID, um rótulo e um tipo.
  2. ID da tag: um identificador exclusivo semelhante a um código para a tag. Uma vez criado, ele não deve ser alterado. Os caracteres válidos são letras, dígitos (não podem começar com um dígito) e sublinhados. Exemplos: part_count, myState1.
  3. Etiqueta da tag: a etiqueta legível para a tag. Para renomear a tag, basta atualizar o rótulo, não o ID. Exemplo: "Part Count" (Contagem de peças).
  4. Type (Tipo): O tipo de dados - String, Integer, Float ou Boolean. Deve corresponder ao tipo do atributo de máquina mapeado.

Um exemplo de configuração de lista de tags pode ser encontrado abaixo:

image.png

  1. Depois que todas as tags forem adicionadas, clique em Add (Adicionar ) para salvar todas as alterações.
    Observe que todas as tags mostrarão Unmapped - isso é esperado, pois as tags ainda não têm um atributo de máquina Tulip associado.
  2. Depois que a lista de tags é criada, há dois métodos para associar o conteúdo do fluxo às entradas da lista. Ambos dependem da caixa de seleção Tag Config no nó tulip-tag:
  3. Se Tag Config estiver marcada (true), será necessário um Tag Node para cada Machine Attribute. Conecte o nó ao nó tulip-tag e selecione o Atributo de máquina relevante com o menu suspenso Selecionar tag do nó de tag. Observe que o nó de tag usará o que for encontrado em msg.payload como a entrada pretendida.

Por exemplo, o fluxo abaixo usa dois nós de injeção para inserir hello ou world. Cada um tem seu próprio nó tulip-tag, com o campo Select Tag mapeado adequadamente:
image.png{height="" width=""}
4. Se a configuração de tag estiver desmarcada (false), será necessário um nó de tag para todos os atributos da máquina. O nó pegará um objeto completo de todos os valores de tag e os mapeará automaticamente para seu respectivo atributo de máquina. Observe que o objeto de entrada deve corresponder exatamente à lista de tags, caso contrário, o nó emitirá um erro.
Por exemplo, o fluxo abaixo usa um nó de injeção. O nó passa o objeto mostrado para o nó de tag, que então mapeia helloworld1 para o itemhello da lista de tags e helloworld2 para o item world da lista de tags:
image.png{height="" width=""}

Agora os dados estão sendo enviados com sucesso para a Tulip. As tags podem ser encontradas como fontes de dados de máquina - para associá-las a um atributo de máquina, localize cada uma delas no dispositivo de borda como uma fonte de dados de máquina.
A imagem abaixo mostra três Tags presentes em um Edge Device:How to Send Data to Machines from Edge Devices using Node-RED and Tulip Tags_566767591.png


De qualquer dispositivo com Node-RED: o Node machine-attr

  1. Para usar o Node machine-attr, primeiro navegue até o Machine Attribute no Tulip.
  2. Clique para abrir possíveis fontes de dados e selecione "Tulip API". Copie as informações mostradas:image.png
  3. No Node-RED, adicione um nó machine-attr do Tulip. Se não tiver sido configurado anteriormente, configure um novo Tulip Authentication (link necessário - copie daqui: https://support.tulip.co/docs/using-node-red-with-the-tulip-api).
  4. Cole os dados de atributo de máquina do Tulip no campo Device Info.

O nó de atributo de máquina agora está configurado. Todos os dados (do mesmo tipo que o Atributo da máquina) presentes em msg.payload, uma vez inseridos no Node, aparecerão no Atributo da máquina no Tulip.


Este artigo foi útil?