Obsah Node-RED pro UniPi Axon Podrobný návod Úvod... 2 Příprava k instalaci... Chyba! Záložka není definována. Instalace operačního systému... Chyba! Záložka není definována. Instalace v OS Windows... Chyba! Záložka není definována. Instalace v OS Linux... Chyba! Záložka není definována. Úprava adresáře SD karty a vložení karty do zařízení... Chyba! Záložka není definována. Zjištění IP adresy jednotky Axon... 2 Komunikace s jednotkou skrze SSH/PuTTY... 4 Instalace EVOK... 6 EVOK + obraz UniPian... Chyba! Záložka není definována. EVOK + jiné obrazy... Chyba! Záložka není definována. Spuštění EVOKU... Chyba! Záložka není definována. Instalace Node-RED... 8 Automatické spouštění Node-RED... 9 První spuštění Node-RED... 9 Propojení Node-RED a kontroléru UniPi Axon... 11 Ukázka práce s Node-RED... 13 www.unipi.technology I Jarní 44g, Brno, 614 00, Česká Republika I info@unipi.technology
Úvod Tento průvodce Vás krok za krokem provede kompletním procesem instalace systému Node-RED na Váš programovatelný logický kontrolér řady UniPi Axon. Pro více informací o Node-RED či jednotkách řady Axon prosím navštivte UniPi Knowledge Base, případně katalog produktů UniPi.technology. Zjištění IP adresy jednotky Axon Prvním krokem je detekce IP adresy samotné jednotky Axon. Nejjednodušším způsobem je využít mobilní aplikace Fing, dostupné na Google Play (telefony s OS Android) či App Store (telefony s ios). V případě využití aplikace Fing se jednotka ve výčtu zařízení zobrazí podle svého typového označení v případě obrázku výše jde o jednotku M505. Alternativně lze IP adresu kontroléru zjistit za pomoci nástrojů systému Windows, případně jakékoliv jiné aplikace určené pro tento účel. 2
Povolení přístupu k SSH/vypnutí softwaru Mervis Jednotky UniPi Axon disponují na rozdíl od jednotek UniPi Neuron interní emmc pamětí a nevyžadují tak instalaci systému na microsd kartu. Všechny Axony jsou standardně dodávány s předinstalovanou softwarovou platformou Mervis; pro instalaci Node-RED je proto nejprve třeba Mervis deaktivovat a zároveň s tím aktivovat SSH spojení. U jednotek Axon toho lze docílit pomocí přepnutí jednotky do servisního módu: 1. stiskněte a podržte tlačítko umístěné na horní straně šasi Axonu za pomoci tenkého nástroje. Tlačítko se nachází vedle značení USB portů. 2. držte tlačítko a zapojte kontrolér do napájení 3. počkejte, dokud Axon nedokončí bootovací sekvenci a nepřejde do servisního módu. Ten je indikován střídavým blikáním LED diod. 4. otevřete na svém počítači web browser a připojte se k Axonu za pomoci Ethernetu či Wi-Fi. Podle toho, kterou možnost zvolíte, se liší další postup: a. Ethernet LAN: servisní rozhraní je dostupné na IP adrese 192.168.200.200. Axon se rovněž pokusí skrze DHCP získat dynamickou IP adresu (pokud je DHCP dostupné) b. Wi-Fi: Axon vytvoří přístupový bod (SSID: UNIPICONFIG, heslo: unipi.technology). Servisní rozhraní pak je dostupné na adresách 192.168.200.200 a 192.168.201.1 Pokud byly všechny kroky provedeny správně, po zadání odpovídající IP adresy se zobrazí následující servisní rozhraní: Zde proveďte následující kroky: 1. klikněte na Enable SSH 2. klikněte na Disable Mervis runtime 3. klikněte na Restart system Kontrolér se automaticky restartuje. Poté můžete přejít k dalšímu kroku. 3
Komunikace s jednotkou skrze SSH/PuTTY Pro komunikaci s kontrolérem během instalace Node-RED poslouží SSH terminál. K jeho vytvoření je třeba stáhnout program PuTTY (ke stažení na tomto odkaze). Jde o nejvhodnější volbu pro OS Windows, lze ale využít i jiné z širokého výběru SSH programů. Pro účely tohoto manuálu byl použit právě PuTTY. Program běžným způsobem stáhněte a nainstalujte skrze instalační aplikaci. Program následně spusťte. Zobrazí se následující okno, do kterého na vyznačené místo zadejte IP adresu jednotky. 4
Volbu potvrďte kliknutím na Open. Zobrazí se bezpečnostní upozornění, které rovněž potvrďte kliknutím na Ano. Po potvrzení se zobrazí následující okno: Následně zadejte přihlašovací údaje login: unipi heslo: unipi.technology (pozn: text hesla se zadává skrytě, nepohybující se kurzor proto neznačí chybu) Zadání údajů potvrďte stisknutím klávesy Enter. 5
Upozornění: Pro zadání přihlašovacích údajů je určen časový limit, po jehož uplynutí již nebude přihlášení možné. Pokud nestihnete údaje zadat včas, je třeba akci opakovat, obvykle restartováním PuTTY. Pokud jste údaje zadali správně, zobrazí se následující okno. Do tohoto okna již lze zadávat příkazy potřebné pro další krok celého procesu Instalace EVOK EVOK je otevřené aplikační programovací rozhraní (API) umožňující základní přístup k jednotkám UniPi. EVOK je dostupný na úložišti GitHub; kromě podrobnějších informací lze naleznete i návod k instalaci. Pro účely tohoto návodu Vám ale budou stačit pouze níže uvedené příkazy. Doporučujeme příkazy jednoduše kopírovat do příkazového řádku (vkládání příkazů ze schránky je prováděno stisknutím pravého tlačítka myši). U jednotek Axon je nutné EVOK nainstalovat. Proces instalace naleznete na výše zmíněném úložišti GitHub. 6
Po dokončení instalace či aktualizace EVOKu otevřete webový prohlížeč a do adresového řádku zadejte IP adresu kontroléru. Pokud je IP adresa správná a instalace EVOKu proběhla úspěšně, zobrazí se následující uživatelské rozhraní. Toto rozhraní umožňuje základní ovládání vstupů a výstupů kontroléru. Funkčnost můžete vyzkoušet jednoduchým sepnutím některého ze vstupů či výstupů; pokud vše funguje správně, na kontroléru se rozsvítí dioda příslušného vstupu/výstupu. 7
Instalace Node-RED Po dokončení všech předchozích kroků lze přejít k instalaci samotného systému Node-RED. Upozornění: Node-RED vyžaduje aktuální verzi EVOK (verze 2.0.7g a vyšší). Instalace Node-RED opět probíhá zadáváním příkazů do SSH terminálu, a to v následujících krocích vložte příkaz sudo apt-get install build-essential. Instalace by měla proběhnout bez dalšího potřebného zásahu. Její průběh můžete sledovat v okně terminálu. po dokončení předchozího kroku zadejte následující příkaz bash <(curl -sl https://raw.githubusercontent.com/nodered/raspbian-debpackage/master/resources/update-nodejs-and-nodered) Postupně se následně zobrazí následující trojice dotazů 1. Are you really sure you want to install as root? [y/n]? 2. Are you really sure you want to do this? [y/n]? 3. Would you like to install the Pi-specific nodes? [y/n]? Odpovězte na ně v pořadí Y,Y,N. Viz následující obrázek 8
Po zadání odpovědí se spustí samotná instalace Node-RED. Její průběh můžete v SSH terminálu sledovat pomocí postupného odškrtávání jednotlivých kroků instalace zelenými symboly. Pro dokončení instalace musí být odškrtnuty všechny kroky. Pokud je instalace úspěšná, je celý proces instalace Node-RED u konce. Ke spuštění Node-RED nyní stačí do terminálu zadat příkaz node-red Automatické spouštění Node-RED Ve výchozím stavu je nutné příkaz Node-RED zadávat při každém spuštění zařízení. Pro usnadnění spuštění lze do terminálu po spuštění Node-RED zadat následující příkaz: sudo systemctl enable nodered.service Node-RED se nově bude automaticky spouštět po každém spuštění zařízení. První spuštění Node-RED Otevřete webový prohlížeč a do adresového řádku zadejte IP adresu Vašeho kontroléru. Za adresu pak doplňte :1880 dle ukázky: 9
Pokud je IP adresa správná, zobrazí se následující uživatelské rozhraní. Node-RED je nyní plně funkční. 10
Propojení Node-RED a kontroléru UniPi Axon Pro zprostředkování komunikace mezi Node-RED a kontrolérem je třeba do palety uzlů Node-RED doplnit odpovídající uzly. Klikněte na symbol menu v pravém horním rohu obrazovky. Objeví se následující nabídka, ve které klikneme na Manage Palette. Zobrazí se následující menu. Klikněte na záložku Install. 11
Zpřístupní se rozhraní určené pro instalaci nových uzlů. Z nich budou potřeba následující dva uzly @unipitechnology/node-red-contrib-unipi-evok node-red-dashboard Název uzlu zadejte do vyhledávací kolonky označené symbolem lupy. Pak již stačí jen kliknout na tlačítko Install u daného uzlu. Po dokončení instalace uzlů v levé horizontální liště nyní přibyly dva dostupné uzly UniPi: Node-RED je nyní připraven pro komunikaci s jednotkou UniPi Axon. 12
Ukázka práce s Node-RED Pro lepší orientaci v Node-RED jsme vytvořili krátkou demoverzi, která Vám pomůže zorientovat se v prostředí Node-RED a pochopit spojení Node-RED a UniPi. Nejprve v hlavním menu Node-RED klikněte na Import. Zobrazí se následující nabídka Do textového pole následně zkopírujte obsah souboru demo_flow_1.0.json. Pak již stačí jen kliknout na tlačítko Import. Posledním krokem je vyvolání uživatelského rozhraní jednoduchým doplněním /ui za IP adresu rozhraní Node- RED, viz ukázka: Na následující stránce pak naleznete obrazovku, která se po zadání IP adresy zobrazí 13
14