Node-RED pro Unipi Axon

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 kontrolér během přepravy neutrpěl žádné poškození či jiné viditelné defekty.

Axon

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 Axon Node-RED OS. Stáhněte jej a rozbalte do nové složky ve Vašem PC.

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 PLC k místní síti a připojte napájení, počkejte alespoň minutu, než se PLC spustí a nastaví se IP adresa z DHCP, poté odpojte napájení
  2. Stiskněte a držte tlačítko Reset umístěné ve vrchní řadě značení konektorů (nalevo od značení USB portů)
  3. Připojte kontrolér do napájení. Axon po chvíli přejde do servisního módu indikovaného střídavým blikáním horní a dolní řady diod, tlačítko Reset nyní můžete pustit
  4. Nyní potřebujete získat IP adresu PLC, tu zjistíte buď z DHCP serveru, nebo vhodným programem, např. Advanced IP Scannernávod k použití

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

  1. Připojte PLC k PC pomocí síťového kabelu (RJ45)
  2. Stiskněte a držte tlačítko Reset umístěné ve vrchní řadě značení konektorů (nalevo od značení USB portů)
  3. Připojte kontrolér do napájení. Axon po chvíli přejde do servisního módu indikovaného střídavým blikáním horní a dolní řady diod, tlačítko Reset nyní můžete pustit
  4. Nastavte IP vašeho PC na 192.168.200.100 s maskou 255.255.255.0
  5. Jednotka Axon má nyní IP nastavenu na 192.168.200.200

3) WiFi hotspotem:

  1. Stiskněte a držte tlačítko Reset umístěné ve vrchní řadě značení konektorů (nalevo od značení USB portů)
  2. Připojte kontrolér do napájení. Axon po chvíli přejde do servisního módu indikovaného střídavým blikáním horní a dolní řady diod, tlačítko Reset nyní můžete pustit
  3. 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 PLC
  4. Jednotka Axon má nyní IP nastavenu na 192.168.201.1

Pokračujte:

  1. Zadejte IP adresu PLC do webového prohlížeče, po potvrzení budete připojeni k servisnímu rozhraní PLC 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
  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 kontroléru
  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

K nahrání OS lze použít pouze port USB2

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

Na obrazu disku, který jste právě nahráli do PLC 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 Unipi PLC.

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 kontroléru. Pro připojení k tomuto rozhraní zadejte do webového prohlížeče IP adresu vašeho PLC 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šem PLC, 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.

Pro vstup do programovacího rozhraní Node-RED otevřete webový prohlížeč a do adresního řádku vložte IP adresu kontroléru 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.

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 PLC připojovat pomocí SSH protokolu, je nutné znát IP adresu PLC 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 PLC 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 v SW Node-RED se nazývají flow. Zde si můžete stáhnout soubor s touto flow pro Unipi Axon/Neuron.

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