Wysyłanie danych z Node-RED do Tulip za pomocą węzłów Tulip
  • 20 Feb 2024
  • 3 Minuty do przeczytania
  • Współtwórcy

Wysyłanie danych z Node-RED do Tulip za pomocą węzłów Tulip


Streszczenie artykułu

Przegląd

Istnieją trzy główne metody wysyłania danych z Node-RED (takich jak dane urządzenia lub systemu zewnętrznego) do Tulip:

  1. za pośrednictwem interfejsu API Tulip Machine
  2. za pośrednictwem interfejsu API Tulip Tables
  3. przez Connector Response *Uwaga: Wymaga najpierw Connector, pochodzącego od Tulip.

Aby usprawnić komunikację za pomocą metod 1 i 2, Tulip stworzył trzy węzły pierwszej strony:

  1. tulip-tag: Wysyłanie danych do Machine Attributes API z zaawansowaną funkcjonalnością - tylko Tulip Edge Device2. machine-attribute: Wysyłanie danych do Machine Attributes API z dowolnego urządzenia 3. tables: Wysyłanie i odbieranie danych do/z interfejsu API Tables z dowolnego urządzenia.

Wszystkie trzy węzły wymienione powyżej są wstępnie zainstalowane na urządzeniach Tulip Edge. Dodatkowo, węzły 2 i 3 powyżej są opublikowane w bibliotece Node-RED Library do pobrania na dowolne urządzenie. Można je znaleźć pod adresem here{target=_blank}.


Wysyłanie danych do atrybutu maszyny Tulip

Uwaga: W tej sekcji założono, że został utworzony Tulip Machine Attribute. Więcej informacji można znaleźć w tym przewodniku.

Z urządzenia brzegowego Tulip: tulip-tag Node

Węzeł tulip-tag jest kompatybilny z urządzeniami Tulip Edge z oprogramowaniem w wersji 51 lub nowszej.

  1. Aby użyć węzła tulip-tag, najpierw przeciągnij go do panelu edytora z palety. Kliknij dwukrotnie węzeł, aby otworzyć panel konfiguracji.
  2. Kliknij ołówek, aby dodać nową listę tagów:
    :::(Warning) (Uwaga! Listy tagów) Tylko jedna aktywna lista tagów jest obsługiwana na urządzenie brzegowe. Pamiętaj, aby przed rozpoczęciem wyłączyć wszystkie przepływy z innymi listami tagów ::: <wstaw tutajzdjęcie z istniejącego artykułu>.
  3. Kliknij +add, aby dodać nowy tag. Każdy tag składa się z trzech części: ID, etykiety i typu.
  4. Identyfikatortagu: unikalny, podobny do kodu identyfikator tagu. Po utworzeniu nie powinien się zmieniać. Prawidłowe znaki to litery, cyfry (nie mogą zaczynać się od cyfry) i podkreślenia. Przykłady: part_count, myState1.
  5. Etykieta tag u: czytelna dla człowieka etykieta tagu. Aby zmienić nazwę tagu, wystarczy zaktualizować etykietę - nie ID. Przykład: "Part Count".
  6. Type: Typ danych - String, Integer, Float lub Boolean. Musi być zgodny z typem zmapowanego atrybutu maszyny.

Przykładową konfigurację listy tagów można znaleźć poniżej:

image.png

  1. Po dodaniu wszystkich znaczników kliknij przycisk Add, aby zapisać wszystkie zmiany.
    Należy pamiętać, że wszystkie tagi będą wyświetlane jako Niezamapowane - należy się tego spodziewać, ponieważ tagi nie mają jeszcze powiązanego atrybutu maszyny Tulip.
  2. Po utworzeniu listy tagów istnieją dwie metody powiązania zawartości przepływu z wpisami na liście. Obie zależą od pola wyboru Tag Config w węźle tulip-tag:
  3. Jeśli opcja Tag Config jest zaznaczona (true), dla każdego atrybutu Machine Attribute potrzebny jest jeden węzeł Tag Node. Podłącz węzeł do węzła tulip-tag i wybierz odpowiedni atrybut maszyny za pomocą rozwijanego pola wyboru Tag Node. Należy pamiętać, że węzeł tagów przyjmie wszystko, co znajduje się w msg.payload jako zamierzone dane wejściowe.

Na przykład poniższy przepływ wykorzystuje dwa węzły wstrzykiwania do wprowadzania hello lub world. Każdy z nich ma swój własny węzeł tulip-tag, z odpowiednio zmapowanym polem Select Tag:
image.png{height="" width=""}
4. Jeśli opcja Tag Config jest odznaczona (false), jeden węzeł Tag jest potrzebny dla wszystkich atrybutów maszyny. Węzeł pobierze pełny obiekt wszystkich wartości tagów i automatycznie zmapuje je do odpowiedniego atrybutu maszyny. Należy pamiętać, że obiekt wejściowy musi dokładnie pasować do listy tagów, w przeciwnym razie węzeł zgłosi błąd.
Na przykład, poniższy przepływ używa jednego węzła wstrzykiwania. Węzeł przekazuje pokazany obiekt do węzła tagów, który następnie mapuje helloworld1 na listę tagów itemhello, a helloworld2 na listę tagów item world:
image.png{height="" width=""}

Dane są teraz pomyślnie wysyłane do Tulip. Tagi można znaleźć jako źródła danych maszyny - aby powiązać je z atrybutem maszyny, znajdź każdy z nich pod urządzeniem brzegowym jako źródło danych maszyny.
Poniższy obraz przedstawia trzy tagi obecne na urządzeniu brzegowym:How to Send Data to Machines from Edge Devices using Node-RED and Tulip Tags_566767591.png


Z dowolnego urządzenia z Node-RED: machine-attr Node

  1. Aby użyć węzła machine-attr, najpierw przejdź do atrybutu Machine w Tulip.
  2. Kliknij, aby otworzyć możliwe źródła danych i wybierz "Tulip API". Skopiuj wyświetlone informacje:image.png
  3. W Node-RED dodaj węzeł Tulip machine-attr. Jeśli nie był wcześniej skonfigurowany, skonfiguruj nowe uwierzytelnianie Tulip (potrzebny link - skopiuj stąd: https://support.tulip.co/docs/using-node-red-with-the-tulip-api).
  4. Wklej dane Machine Attribute z Tulip w polu Device Info.

Węzeł Machine Attribute Node jest teraz skonfigurowany. Wszelkie dane (tego samego typu co atrybut maszyny) obecne w msg.payload po wprowadzeniu do węzła pojawią się w atrybucie maszyny w Tulip.


Czy ten artykuł był pomocny?