Obsah

Instalace Node-RED na starších systémech

Node-RED pro Unipi Axon (STARÉ)

Tento manuál Vás provede celým procesem instalace Node-RED na Vaši jednotku Axon. Před začátkem instalace se prosím přesvědčte, že jednotka během přepravy neutrpěla žádné poškození či jiné viditelné defekty.

Axon

Pro spuštění SW Node-RED je nezbytné přeflashovat stávající OS v jednotce novým. Tento konkrétní OS s předinstalovaným SW Node-RED naleznete v sekci Obrazy OS v kapitole Axon Node-RED OS. Stáhněte jej a rozbalte do nové složky ve Vašem PC.

Nahrání OS pomocí servisního webového rozhraní

Nahrání OS pomocí servisního rozhraní na jednotce Axon je možné třemi různými způsoby.

1) Na místní síti (s DHCP):

  1. Připojte jednotku k místní síti a připojte napájení, počkejte alespoň minutu, než se jednotka spustí a nastaví se IP adresa z DHCP, poté odpojte napájení
  2. Stiskněte a nepouštějte tlačítko Service umístěné (až na výjimky) ve vrchní řadě značení konektorů nalevo od značení USB portů
  3. Připojte jednotku do napájení. Axon po chvíli přejde do servisního módu indikovaného pomalým blikáním všech diod na sekci 1 (kromě PWR a RUN)
  4. Nyní můžete tlačítko SERVICE uvolnit
  5. Nyní potřebujete získat IP adresu jednotky, tu zjistíte buď z DHCP serveru, nebo vhodným programem, např. Advanced IP Scanner → návod k použití

2) Přímím spojením s jednotkou (bez DHCP):

  1. Připojte jednotku k PC pomocí síťového kabelu (RJ45)
  2. Stiskněte a nepouštějte tlačítko Service umístěné (až na výjimky) ve vrchní řadě značení konektorů nalevo od značení USB portů
  3. Připojte jednotku do napájení. Axon po chvíli přejde do servisního módu indikovaného pomalým blikáním všech diod na sekci 1 (kromě PWR a RUN)
  4. Nyní můžete tlačítko SERVICE uvolnit
  5. Nastavte IP vašeho PC na 192.168.200.100 s maskou 255.255.255.0
  6. Jednotka Axon má nyní IP nastavenu na 192.168.200.200

3) WiFi hotspotem:

  1. Stiskněte a nepouštějte tlačítko Service umístěné (až na výjimky) ve vrchní řadě značení konektorů nalevo od značení USB portů
  2. Připojte jednotku do napájení. Axon po chvíli přejde do servisního módu indikovaného pomalým blikáním všech diod na sekci 1 (kromě PWR a RUN)
  3. Nyní můžete tlačítko SERVICE uvolnit
  4. Připojte se k WiFi síti s SSID: UNIPICONFIG pomocí hesla: unipi.technology, počkejte než vaše PC získá IP adresu z DHCP běžícím na jednotce
  5. Jednotka Axon má nyní IP nastavenu na 192.168.201.1

Pokračujte:

  1. Zadejte IP adresu jednotky do webového prohlížeče, po potvrzení budete připojeni k servisnímu rozhraní jednotky AXON
  2. Do dialogového okna Software update umístěného v servisním rozhraní přetáhněte soubor archive.swu z archivu obrazu OS
  3. Vyčkejte, dokud jednotka nedokončí celý proces - jeho průběh můžete sledovat v dialogovém oknu Messages
  4. Jednotka se restartuje

Nahrání OS pomocí USB flashdisku

  1. Připravte si USB flash disk ve formátu FAT32 s kapacitou minimálně 2 GB
  2. Nakopírujte obsah archivu ZIP na flash disk
  3. Vložte flash disk do portu USB2 na jednotce
  4. Stiskněte a přidržte resetovací tlačítko, umístěné vedle popisků USB
  5. Axon automaticky zahájí přehrávání OS indikované opakovaným postupným rozsvěcením indikačních diod. Tlačítko Reset nyní můžete pustit
  6. Dokončení procesu je indikováno zhasnutím diod. Jednotka se poté automaticky restartuje

(!)

Upozornění:
K nahrání OS lze použít pouze port USB2!

(i)

Poznámka:
V případě, že použitý USB flash disk není kombatibilní, Axon přejde do servisního režimu a není indikováno postupné rozsvěcení indikačních diod. Je tedy potřeba použít jiný flash disk nebo výše zmíněný způsob přes Servisní webové rozhraní.

Předinstalovaný SW

Na obrazu disku, který jste právě nahráli do jednotky již máte předinstalován náš Open-Source software EVOK. Jedná se o aplikační programovací rozhraní (API), které slouží pro komunikaci aplikací s hardwarem jednotky Unipi.

K dispozici máte i praktickou ukázku využití API v podobě jednoduché webové aplikace (Unipi Control Panel) sloužící jako uživatelské rozhraní pro všechny vstupy a výstupy jednotky. Pro připojení k tomuto rozhraní zadejte do webového prohlížeče IP adresu vaší jednotky s portem :80, ale nemusíte jej zadávat, jelikož se jedná o výchozí port pro webový server.

Například: 

192.168.1.10

nebo 

192.168.1.10:80

Tato webová aplikace vypadá následovně:

Dalším softwarem instalovaným na obrazu disku, nyní i ve vaší jednotce, je Node-RED. Jedná se o programovací nástroj k propojení hardwarových zařízení, různých API, či online služeb. V tomto případě již máte do SW Node-RED integrováno API EVOK. Toto API je v programovacím rozhraní reprezentováno dvěma uzly v levém panelu v odstavci Unipi. Konkrétně se jedná o uzly unipi input a unipi output, které slouží jak pro analogové, tak i digitální vstupy a výstupy.

Připojení k rozhraní Node-RED

Pro vstup do programovacího rozhraní Node-RED otevřete webový prohlížeč a do adresního řádku vložte IP adresu jednotky s portem :1880.

Například: 

192.168.1.10:1880

Zobrazí se vám následující rozhraní:

Jistě jste si všimli, že programovací rozhraní již obsahuje projekt. Tento demonstrační projekt slouží pro čtení vstupů, zápis na výstupy a to vše propojené s uživatelským webovým rozhraním → tzv. Dashboard. Tento demonstrační projekt (flow) je k dispozici ke stažení na konci článku.

Pro vstup do rozhraní přidejte za adresu s portem ještě příponu /ui.

Například: 

192.168.1.10:1880/ui

Nyní se vám zobrazí následující uživatelské rozhraní:

Vše potřebné máte již nainstalováno a můžete začít vytvářet své vlastní projekty.

Zabezpečení Node-REDu

Pokud přihlašovací údaje podle následujícího postupu nenastavíte, může to mít za následek umožnění přístupu neoprávněné osobě k jednotce Unipi. To může vést k nepovoleným zásahům, které mohou zastavit, či omezit provoz. V horším případě může zásah způsobit poškození připojených technologií, nebo ohrožení bezpečnosti osob v místě instalace.

Proto vždy, když zavádíte nový projekt, je velmi důležité mít systém správně zabezpečen.

Jelikož se budete k jednotce připojovat pomocí SSH protokolu, je nutné znát IP adresu jednotky a mít na PC nainstalovaného SSH klienta na PC. Mezi nejoblíbenější pro OS Windows patří software PuTTy. Pokud jej v PC nemáte, či tento SW vůbec neznáte, postupujte dle tohoto návodu.

(i)

Poznámka:
Pro přenos souborů mezi PC a jednotkou Unipi můžete použít SW WinSCP. Přihlašovací údaje jsou stejné jako pro SSH.

Dále již postupujte dle tohoto návodu na oficiálních stránkách NodeRED.

Projekty ke stažení

Projekty v SW Node-RED se nazývají flow. Zde si můžete stáhnout soubor s touto flow pro jednotky Unipi Patron / Neuron / Axon.

build-scripts_061-install-default-project-neuron.neuron_node-red_default_flow.zip

Node-RED pro Unipi Edge

Tento návod není pro starší systémy, ale byl nahrazen návodem Instalace Node-RED na jednotkách Unipi.

Tento manuál Vás provede celým procesem instalace Node-RED na Unipi Edge.

Na zařízeních Unipi Edge je z výroby předinstalován Base OS. Tento systém neobsahuje SW Node-RED, ale je možné ho na tento předpřipravený OS doinstalovat.

(!)

Poznámka:
Tento návod obsahuje instalaci SW Node-RED včetně rozhraní Evok, které není povinnou součástí, ale podstatně usnadní práci se vstupy a výstupy na Unipi Edge. Rozhraní Evok není potřeba instalovat, pokud není zapotřebí komunikace se vstupy a výstupy.

(!)

Poznámka:
V případě, že chcete mít jistotu, že máte poslední verzi Base OS, nahrajte obraz OS podle návodu Nahrání/záloha OS. Obraz Base OS lze najít v sekci Obrazy OS pod produktem Unipi Edge.

Instalace

Pro zavedení Node-RED je potřeba instalace alespoň těchto balíků a jejich závislostí:

  • Evok
  • Node-RED

Připojení přes SSH

Nejdříve je nutné se k jednotce přihlásit přes SSH. Toho lze dosáhnout například přes emulátor terminálu PuTTy.

Instalace Evok

Pro komunikaci se vstupy a výstupy v rámci Node-RED použijeme rozhraní Evok. Návod jak stáhnout API Evok lze nalézt zde.

Instalace Node-RED

Návod na instalaci samotného Node-RED můžete nalézt zde. Přes spuštěním skriptu se ujistěte, že byl aktualizován seznam dostupných balíků. 

sudo apt update

Po instalaci je možné nastavit automatický start Node-RED při startu. Pokud jste nastavili automatický start, tak nyní lze restartovat zařízení pro spuštění Node-RED. 

sudo reboot

(!)

Upozornění:
Vždy když zavádíte nový projekt, je velmi důležité mít systém správně zabezpečen.

Pro zabezpečení Node-RED postupujte dle tohoto návodu na oficiálních stránkách.

(!)

Tip:
OS s nainstalovaným Node-RED můžete zálohovat a nahrát na další jednotku. Tím se vyhnete instalace a nastavování Node-RED na každé jednotce zvlášť.

Připojení k rozhraní Node-RED

Pro vstup do programovacího rozhraní Node-RED otevřete prohlížeč a do adresního řádku vložte IP, či mDNS adresu zařízení a doplňte ji o port :1880.

Například: 

http://e410-sn1253701234:1880

Nyní se vám zobrazí následující uživatelské rozhraní:

Přidání balíčků z knihovny

Pro jednodušší práci se systémem, vstupy/výstupy a rozhraními lze přidat již existující node do palety v programovacím rozhraní. Způsob přidání node do Node-RED palety z knihovny je popsán zde.

Pro práci s Evok přidáme tento balíček: @unipitechnology/node-red-contrib-unipi-evok.

(!)

Upozornění:
V balíčku je obsaženo více verzí jednotlivých node. Vždy používejte nejnovější verzi dané node!

Node-RED pro Unipi Gate (STARÉ)

Tento manuál Vás provede celým procesem instalace Node-RED na Unipi Gate. Před začátkem instalace se prosím přesvědčte, že zařízení během přepravy neutrpělo žádné poškození či jiné viditelné defekty.

Gate

SW Node-RED Base OS je na zařízeních Unipi Gate předinstalován jako výchozí. Proto není potřeba původní systém přehrát. Pokud však chcete mít jistotu, že máte poslední verzi, nahrajte OS podle návodu níže. OS s předinstalovaným SW Node-RED naleznete v sekci Obrazy OS v kapitole Gate Node-RED OS. Stáhněte jej a rozbalte do nové složky ve Vašem PC.

Nahrání OS

V servisním rozhraní

Pro nahrání OS na zařízení Unipi Gate přes servisní webové rozhraní je nejprve nutné znát postup pro vstup do servisního módu. Postup naleznete v tomto článku.

  1. Zadejte IP adresu zařízení do webového prohlížeče, po potvrzení budete připojeni k servisnímu rozhraní Unipi Gate
  2. Do dialogového okna pod nadpisem Software update, umístěného v servisním rozhraní, přetáhněte předem rozbalený soubor archive.swu z archivu ZIP
  3. Při nahrávání OS diody ACT, TX, RX (ukázka zde) rychle blikají.
  4. Vyčkejte, dokud zařízení nedokončí celý proces nahrávání. Jeho průběh můžete sledovat v dialogovém oknu pod nadpisem Messages
  5. Úspěšné dokončení nahrávání je indikováno zhasnutím diod a následným restartem zařízení

Pomocí USB flashdisku

  1. Připravte si USB flash disk ve formátu FAT32 s kapacitou minimálně 2 GB
  2. Rozbalte ZIP archiv a obsah poté nakopírujte na flash disk
  3. Odpojte zařízení od napájení a vložte flash disk do USB portu zařízení
  4. Stiskněte a nepouštějte tlačítko SERVICE na čelní straně
  5. Připojte zařízení k napájení, Unipi Gate automaticky zahájí přehrávání OS indikované rychlým blikáním diod ACT, TX, RX (ukázka zde)
  6. Nyní můžete tlačítko SERVICE uvolnit
  7. Úspěšné dokončení procesu je indikováno zhasnutím diod a následným restartem zařízení

(i)

Poznámka:
V případě, že použitý USB flash disk není kompatibilní, Unipi Gate nespustí nahrávání OS a restartuje se. V tomto případě je potřeba použít jiný flash disk nebo výše zmíněný způsob přes Servisní webové rozhraní.

Předinstalovaný SW

Na obrazu disku, který jste právě nahráli do zařízení již máte předinstalován SW Node-RED. Jedná se o programovací nástroj k propojení hardwarových zařízení, různých API, či online služeb.

Připojení k rozhraní Node-RED

Pro vstup do uživatelského rozhraní Node-RED (tzv. dashboard) otevřete webový prohlížeč a do adresního řádku vložte IP, či mDNS adresu zařízení.

Například: 

http://g100-sn1

Zobrazí se vám následující rozhraní:

Pro vstup do programovacího rozhraní Node-RED doplňte IP, či mDNS adresu zařízení o port :1880.

Například: 

http://g100-sn1:1880

Nyní se vám zobrazí následující uživatelské rozhraní:

Jak je z obrázku patrné, programovací rozhraní již obsahuje demonstrační projekt. Tento projekt slouží pouze pro vytvoření uživatelského rozhraní a je součástí každého OS Node-RED pro Unipi Gate.

Zabezpečení OS (SSH)

(!)

Upozornění:
Vždy je nutností zabezpečit operační systém, aby se neoprávněným osobam zabránilo přístupu k jednotce Unipi. Pokud OS není řádně zabezpečen, může to vést k nepovoleným zásahům, které mohou zastavit, či omezit provoz. V horším případě může zásah způsobit poškození připojených technologií, nebo ohrožení bezpečnosti osob v místě instalace.

Proto je vždy při spouštění nového projektu důležité mít systém správně zabezpečen. Alternativou je také úplné zakázání SSH přístupu.

Jelikož je připojení k zařízení zajištěno protokolem SSH, je nutné znát IP adresu, nebo mDNS adresu zařízení a mít na PC, či tabletu nainstalovaného SSH klienta. Mezi nejoblíbenější pro OS Windows patří software PuTTY, návod k použití a výchozí hesla zde.

Před pokračováním se ujistěte, že jste přihlášeni jako správný uživatel (například „unipi“ v našem Base OS). To si můžete ověřit příkazem whoami. 

unipi@S103-sn999:~$ whoami
unipi

Poté zadejte příkaz: 

sudo passwd

Následně budete vyzváni k zadání nového hesla a poté k potvrzení nového hesla. Pokud vše proběhne v pořádku, zobrazí se hláška: 

passwd: password updated successfully

Celý postup zde (heslo při zadávání není viditelné): 

unipi@S103-sn999:~$ sudo passwd
New password:
Retype new password:
passwd: password updated successfully


Nepodařilo se změnit heslo?
V případě, že se změna hesla nepodaří a zobrazí se hláška: 

passwd: Authentication token manipulation error
passwd: password unchanged

vyzkoušejte zadat příkaz níže a následně opakujte postup pro změnu hesla. 

sudo mount -rw -o remount /

Pokud ani zadání tohoto příkazu neumožní změnit heslo, kontaktujte naši technickou podporu.

Zabezpečení Node-REDu

Pokud přihlašovací údaje podle následujícího postupu nenastavíte, může to mít za následek umožnění přístupu neoprávněné osobě k jednotce Unipi. To může vést k nepovoleným zásahům, které mohou zastavit, či omezit provoz. V horším případě může zásah způsobit poškození připojených technologií, nebo ohrožení bezpečnosti osob v místě instalace.

Proto vždy, když zavádíte nový projekt, je velmi důležité mít systém správně zabezpečen.

Jelikož se budete k jednotce připojovat pomocí SSH protokolu, je nutné znát IP adresu jednotky a mít na PC nainstalovaného SSH klienta na PC. Mezi nejoblíbenější pro OS Windows patří software PuTTy. Pokud jej v PC nemáte, či tento SW vůbec neznáte, postupujte dle tohoto návodu.

(i)

Poznámka:
Pro přenos souborů mezi PC a jednotkou Unipi můžete použít SW WinSCP. Přihlašovací údaje jsou stejné jako pro SSH.

Dále již postupujte dle tohoto návodu na oficiálních stránkách NodeRED.

Node-RED pro Unipi Neuron (STARÉ)

Tento manuál Vás provede celým procesem instalace Node-RED na Vaši jednotku Neuron. Před začátkem instalace se prosím přesvědčte, že jednotky během přepravy neutrpěla žádné poškození či jiné viditelné defekty.

Neuron

Nyní je třeba stáhnout poslední verzi obrazu vámi zvoleného operačního systému. Archiv s předchystaným OS naleznete na stránce Obrazy OS.

Příprava SD karty

Ve všech případech doporučujeme použití průmyslové SD karty. Pokud používáte laptop, mějte prosím na paměti, že většina laptopů nedisponuje slotem pro microSD kartu a je tudíž třeba použít vhodný adaptér na klasickou SD kartu, nebo adaptér do USB. Odpovídající kartu můžete zakoupit na e-shopu Unipi.

Pro bezproblémový provoz platformy Node-RED na jednotkách Unipi Neuron a Unipi 1.1 budete potřebovat alespoň 4GB microSD

Detekce IP adresy jednotky

K zjištění IP adresy jednotky můžete použít některý z nástrojů pro skenování sítí LAN. Mimo jiné je možné IP adresu získat i z DHCP serveru, pokud k němu máte přístup. Pro naše účely jsme zvolili program Advanced IP Scanner.

Stáhněte jej a nainstalujte, nebo jen spusťte. Otevřený Advanced IP Scanner vypadá následovně:

Pro automátické zvolení sítě klikněte na ikonu Prohledají se tím všechny dostupné sítě na všech dostupných adaptérech PC. Konkrétní rozsah můžete následně upravit manuálně.

Pro skenování sítě klikněte na tlačítko

Nyní se bude několik minut prohledávat místní síť. Vyčkejte dokud se nezobrazí konkrétní hledané zařízení.

Zapamatujte/zapište si IP adresu, budete ji následně používat při práci s jednotkou.

Předinstalovaný SW

Na obrazu disku, který jste právě nahráli do jednotky již máte předinstalován náš Open-Source software EVOK. Jedná se o aplikační programovací rozhraní (API), které slouží pro komunikaci aplikací s hardwarem jednotky Unipi.

K dispozici máte i praktickou ukázku využití API v podobě jednoduché webové aplikace (Unipi Control Panel) sloužící jako uživatelské rozhraní pro všechny vstupy a výstupy jednotky. Pro připojení k tomuto rozhraní zadejte do webového prohlížeče IP adresu vaší jednotky s portem :80, ale nemusíte jej zadávat, jelikož se jedná o výchozí port pro webový server.

Například: 

192.168.1.10

nebo 

192.168.1.10:80

Tato webová aplikace vypadá následovně:

Dalším softwarem instalovaným na obrazu disku, nyní i ve vaší jednotce, je Node-RED. Jedná se o programovací nástroj k propojení hardwarových zařízení, různých API, či online služeb. V tomto případě již máte do SW Node-RED integrováno API EVOK. Toto API je v programovacím rozhraní reprezentováno dvěma uzly v levém panelu v odstavci Unipi. Konkrétně se jedná o uzly unipi input a unipi output, které slouží jak pro analogové, tak i digitální vstupy a výstupy.

Připojení k rozhraní Node-RED

Pro vstup do programovacího rozhraní Node-RED otevřete webový prohlížeč a do adresního řádku vložte IP adresu jednotky s portem :1880.

Například: 

192.168.1.10:1880

Zobrazí se vám následující rozhraní:

Jistě jste si všimli, že programovací rozhraní již obsahuje projekt. Tento demonstrační projekt slouží pro čtení vstupů, zápis na výstupy a to vše propojené s uživatelským webovým rozhraním → tzv. Dashboard. Tento demonstrační projekt (flow) je k dispozici ke stažení na konci článku.

Pro vstup do rozhraní přidejte za adresu s portem ještě příponu /ui.

Například: 

192.168.1.10:1880/ui

Nyní se vám zobrazí následující uživatelské rozhraní:

Vše potřebné máte již nainstalováno a můžete začít vytvářet své vlastní projekty.

Zabezpečení Node-REDu

Pokud přihlašovací údaje podle následujícího postupu nenastavíte, může to mít za následek umožnění přístupu neoprávněné osobě k jednotce Unipi. To může vést k nepovoleným zásahům, které mohou zastavit, či omezit provoz. V horším případě může zásah způsobit poškození připojených technologií, nebo ohrožení bezpečnosti osob v místě instalace.

Proto vždy, když zavádíte nový projekt, je velmi důležité mít systém správně zabezpečen.

Jelikož se budete k jednotce připojovat pomocí SSH protokolu, je nutné znát IP adresu jednotky a mít na PC nainstalovaného SSH klienta na PC. Mezi nejoblíbenější pro OS Windows patří software PuTTy. Pokud jej v PC nemáte, či tento SW vůbec neznáte, postupujte dle tohoto návodu.

(i)

Poznámka:
Pro přenos souborů mezi PC a jednotkou Unipi můžete použít SW WinSCP. Přihlašovací údaje jsou stejné jako pro SSH.

Dále již postupujte dle tohoto návodu na oficiálních stránkách NodeRED.

Projekty ke stažení

Projekty v SW Node-RED se nazývají flow. Zde si můžete stáhnout soubor s touto flow pro jednotky Unipi Patron / Neuron / Axon.

build-scripts_061-install-default-project-neuron.neuron_node-red_default_flow.zip

Node-RED pro Unipi Patron (STARÉ)

Tento manuál Vás provede celým procesem instalace Node-RED na Vaši jednotku Patron. Před začátkem instalace se prosím přesvědčte, že jednotka během přepravy neutrpěla žádné poškození či jiné viditelné defekty.

Patron

Pro spuštění SW Node-RED je nezbytné přeflashovat stávající OS v jednotce novým. Tento konkrétní OS s předinstalovaným SW Node-RED naleznete v sekci Obrazy OS v kapitole Patron Node-RED OS. Stáhněte jej a rozbalte do nové složky ve Vašem PC.

Nahrání OS pomocí servisního rozhraní

Pro nahrání OS na jednotce Patron přes servisní webové rozhraní je nejprve nutné znát postup pro vstup do servisního módu. Postup naleznete v tomto článku.

  1. Zadejte IP adresu zařízení do webového prohlížeče, po potvrzení budete připojeni k servisnímu rozhraní Unipi Patron
  2. Do dialogového okna pod nadpisem Software update, umístěného v servisním rozhraní, přetáhněte předem rozbalený soubor archive.swu z archivu ZIP
  3. Zahájí se nahrávání OS indikované rychlým blikáním všech diod v horní i dolní řadě na sekci 1
  4. Vyčkejte, dokud zařízení nedokončí celý proces nahrávání. Jeho průběh můžete sledovat i v dialogovém oknu pod nadpisem Messages
  5. Dokončení nahrávání je indikováno zhasnutím diod a následným restartem zařízení

Nahrání OS pomocí USB flashdisku

  1. Připravte si USB flash disk ve formátu FAT32 s kapacitou minimálně 2 GB
  2. Rozbalte ZIP archiv a obsah poté nakopírujte na flash disk
  3. Odpojte zařízení od napájení a vložte flash disk do libovolného USB portu zařízení
  4. Stiskněte a nepouštějte tlačítko SERVICE
  5. Připojte zařízení k napájení, jednotka automaticky zahájí přehrávání OS indikované rychlým blikáním všech diod v horní i dolní řadě na sekci 1
  6. Nyní můžete tlačítko SERVICE uvolnit
  7. Dokončení procesu je indikováno zhasnutím diod a následným restartem zařízení

(i)

Poznámka:
V případě, že použitý USB flash disk není kompatibilní, jednotka nespustí nahrávání OS a restartuje se. V tomto případě je potřeba použít jiný flash disk nebo výše zmíněný způsob přes Servisní webové rozhraní.

Předinstalovaný SW

Na obrazu disku, který jste právě nahráli do jednotky již máte předinstalován náš Open-Source software EVOK. Jedná se o aplikační programovací rozhraní (API), které slouží pro komunikaci aplikací s hardwarem jednotky Unipi.

K dispozici máte i praktickou ukázku využití API v podobě jednoduché webové aplikace (Unipi Control Panel) sloužící jako uživatelské rozhraní pro všechny vstupy a výstupy jednotky. Pro připojení k tomuto rozhraní zadejte do webového prohlížeče IP adresu vaší jednotky s portem :80, ale nemusíte jej zadávat, jelikož se jedná o výchozí port pro webový server.

Například: 

192.168.1.10

nebo 

192.168.1.10:80

Tato webová aplikace vypadá následovně:

Dalším softwarem instalovaným na obrazu disku, nyní i ve vaší jednotce, je Node-RED. Jedná se o programovací nástroj k propojení hardwarových zařízení, různých API, či online služeb. V tomto případě již máte do SW Node-RED integrováno API EVOK. Toto API je v programovacím rozhraní reprezentováno dvěma uzly v levém panelu v odstavci Unipi. Konkrétně se jedná o uzly unipi input a unipi output, které slouží jak pro analogové, tak i digitální vstupy a výstupy.

Připojení k rozhraní Node-RED

Pro vstup do programovacího rozhraní Node-RED otevřete webový prohlížeč a do adresního řádku vložte IP adresu jednotky s portem :1880.

Například: 

192.168.1.10:1880

Zobrazí se vám následující rozhraní:

Jistě jste si všimli, že programovací rozhraní již obsahuje projekt. Tento demonstrační projekt slouží pro čtení vstupů, zápis na výstupy a to vše propojené s uživatelským webovým rozhraním → tzv. Dashboard. Tento demonstrační projekt (flow) je k dispozici ke stažení na konci článku.

Pro vstup do rozhraní přidejte za adresu s portem ještě příponu /ui.

Například: 

192.168.1.10:1880/ui

Nyní se vám zobrazí následující uživatelské rozhraní:

Vše potřebné máte již nainstalováno a můžete začít vytvářet své vlastní projekty.

Zabezpečení Node-REDu

Pokud přihlašovací údaje podle následujícího postupu nenastavíte, může to mít za následek umožnění přístupu neoprávněné osobě k jednotce Unipi. To může vést k nepovoleným zásahům, které mohou zastavit, či omezit provoz. V horším případě může zásah způsobit poškození připojených technologií, nebo ohrožení bezpečnosti osob v místě instalace.

Proto vždy, když zavádíte nový projekt, je velmi důležité mít systém správně zabezpečen.

Jelikož se budete k jednotce připojovat pomocí SSH protokolu, je nutné znát IP adresu jednotky a mít na PC nainstalovaného SSH klienta na PC. Mezi nejoblíbenější pro OS Windows patří software PuTTy. Pokud jej v PC nemáte, či tento SW vůbec neznáte, postupujte dle tohoto návodu.

(i)

Poznámka:
Pro přenos souborů mezi PC a jednotkou Unipi můžete použít SW WinSCP. Přihlašovací údaje jsou stejné jako pro SSH.

Dále již postupujte dle tohoto návodu na oficiálních stránkách NodeRED.

Projekty ke stažení

Projekty v SW Node-RED se nazývají flow. Zde si můžete stáhnout soubor s touto flow pro jednotky Unipi Patron / Neuron / Axon.

build-scripts_061-install-default-project-neuron.neuron_node-red_default_flow.zip

Node-RED pro Unipi 1.1 (STARÉ)

Tento manuál Vás provede celým procesem instalace Node-RED na Vaše Unipi 1.1. Před začátkem instalace se prosím přesvědčte, že jednotka během přepravy neutrpěla žádné poškození či jiné viditelné defekty.

Unipi 1.1

Nyní je třeba stáhnout poslední verzi obrazu vámi zvoleného operačního systému. Archiv s předchystaným OS naleznete na stránce Obrazy OS.

Příprava SD karty

Ve všech případech doporučujeme použití průmyslové SD karty. Pokud používáte laptop, mějte prosím na paměti, že většina laptopů nedisponuje slotem pro microSD kartu a je tudíž třeba použít vhodný adaptér na klasickou SD kartu, nebo adaptér do USB. Odpovídající kartu můžete zakoupit na e-shopu Unipi.

Pro bezproblémový provoz platformy Node-RED na jednotkách Unipi Neuron a Unipi 1.1 budete potřebovat alespoň 4GB microSD

Detekce IP adresy jednotky

K zjištění IP adresy jednotky můžete použít některý z nástrojů pro skenování sítí LAN. Mimo jiné je možné IP adresu získat i z DHCP serveru, pokud k němu máte přístup. Pro naše účely jsme zvolili program Advanced IP Scanner.

Stáhněte jej a nainstalujte, nebo jen spusťte. Otevřený Advanced IP Scanner vypadá následovně:

Pro automátické zvolení sítě klikněte na ikonu Prohledají se tím všechny dostupné sítě na všech dostupných adaptérech PC. Konkrétní rozsah můžete následně upravit manuálně.

Pro skenování sítě klikněte na tlačítko

Nyní se bude několik minut prohledávat místní síť. Vyčkejte dokud se nezobrazí konkrétní hledané zařízení.

Zapamatujte/zapište si IP adresu, budete ji následně používat při práci s jednotkou.

Předinstalovaný SW

Na obrazu disku, který jste právě nahráli do jednotky již máte předinstalován náš Open-Source software EVOK. Jedná se o aplikační programovací rozhraní (API), které slouží pro komunikaci aplikací s hardwarem jednotky Unipi.

K dispozici máte i praktickou ukázku využití API v podobě jednoduché webové aplikace (Unipi Control Panel) sloužící jako uživatelské rozhraní pro všechny vstupy a výstupy jednotky. Pro připojení k tomuto rozhraní zadejte do webového prohlížeče IP adresu vaší jednotky s portem :80, ale nemusíte jej zadávat, jelikož se jedná o výchozí port pro webový server.

Například: 

192.168.1.10

nebo 

192.168.1.10:80

Tato webová aplikace vypadá následovně:

Dalším softwarem instalovaným na obrazu disku, nyní i ve vaší jednotce, je Node-RED. Jedná se o programovací nástroj k propojení hardwarových zařízení, různých API, či online služeb. V tomto případě již máte do SW Node-RED integrováno API EVOK. Toto API je v programovacím rozhraní reprezentováno dvěma uzly v levém panelu v odstavci Unipi. Konkrétně se jedná o uzly unipi input a unipi output, které slouží jak pro analogové, tak i digitální vstupy a výstupy.

Připojení k rozhraní Node-RED

Pro vstup do programovacího rozhraní Node-RED otevřete webový prohlížeč a do adresního řádku vložte IP adresu jednotky s portem :1880.

Například: 

192.168.1.10:1880

Zobrazí se vám následující rozhraní:

Jistě jste si všimli, že programovací rozhraní již obsahuje projekt. Tento demonstrační projekt slouží pro čtení vstupů, zápis na výstupy a to vše propojené s uživatelským webovým rozhraním → tzv. Dashboard. Tento demonstrační projekt (flow) je k dispozici ke stažení na konci článku.

Pro vstup do rozhraní přidejte za adresu s portem ještě příponu /ui.

Například: 

192.168.1.10:1880/ui

Nyní se vám zobrazí následující uživatelské rozhraní:

Vše potřebné máte již nainstalováno a můžete začít vytvářet své vlastní projekty.

Zabezpečení Node-REDu

Pokud přihlašovací údaje podle následujícího postupu nenastavíte, může to mít za následek umožnění přístupu neoprávněné osobě k jednotce Unipi. To může vést k nepovoleným zásahům, které mohou zastavit, či omezit provoz. V horším případě může zásah způsobit poškození připojených technologií, nebo ohrožení bezpečnosti osob v místě instalace.

Proto vždy, když zavádíte nový projekt, je velmi důležité mít systém správně zabezpečen.

Jelikož se budete k jednotce připojovat pomocí SSH protokolu, je nutné znát IP adresu jednotky a mít na PC nainstalovaného SSH klienta na PC. Mezi nejoblíbenější pro OS Windows patří software PuTTy. Pokud jej v PC nemáte, či tento SW vůbec neznáte, postupujte dle tohoto návodu.

(i)

Poznámka:
Pro přenos souborů mezi PC a jednotkou Unipi můžete použít SW WinSCP. Přihlašovací údaje jsou stejné jako pro SSH.

Dále již postupujte dle tohoto návodu na oficiálních stránkách NodeRED.

Projekty ke stažení

Projekty v SW Node-RED se nazývají flow. Zde si můžete stáhnout soubor s touto flow pro Unipi 1.1/Lite.

build-scripts_060-install-default-project-unipi1.unipi1_node-red_default_flow.zip