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

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:

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:
{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:
{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:

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:
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.