This is an old revision of the document!
Node-RED pro Unipi Gate
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 kontrolér během přepravy neutrpěl žádné poškození či jiné viditelné defekty.
Gate
Pro spuštění SW Node-RED je nezbytné přeflashovat stávající OS v PLC 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 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.
- Zadejte IP adresu zařízení do webového prohlížeče, po potvrzení budete připojeni k servisnímu rozhraní Unipi Gate
- 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
- Při nahrávání OS diody ACT, TX, RX (ukázka zde) rychle blikají.
- 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
- Úspěšné dokončení nahrávání je indikováno zhasnutím diod a následným restartem zařízení
Nahrání OS pomocí USB flashdisku
- Připravte si USB flash disk ve formátu FAT32 s kapacitou minimálně 2 GB
- Rozbalte ZIP archiv a obsah poté nakopírujte na flash disk
- Odpojte zařízení od napájení a vložte flash disk do USB portu zařízení
- Stiskněte a nepouštějte tlačítko SERVICE na čelní straně
- 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)
- Nyní můžete tlačítko SERVICE uvolnit
- Úspěšné dokončení procesu je indikováno zhasnutím diod a následným restartem zařízení
V případě, že použitý USB flash disk není kombatibilní, 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 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.
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.