Node.js
Uživatelská příručka
Aplikace Node.js Router
Aplikace Node.js Router
© 2023 Advantech Czech sro Žádná část této publikace nesmí být bez písemného souhlasu reprodukována ani přenášena v jakékoli formě nebo jakýmikoli prostředky, elektronickými nebo mechanickými, včetně fotografií, záznamů nebo jakéhokoli systému pro ukládání a vyhledávání informací.
Informace v této příručce se mohou bez upozornění změnit a nepředstavují závazek ze strany společnosti Advantech.
Advantech Czech sro nenese odpovědnost za náhodné nebo následné škody vzniklé v důsledku poskytnutí, provedení nebo použití tohoto návodu.
Všechny názvy značek použité v této příručce jsou registrované ochranné známky příslušných vlastníků. Použití ochranných známek nebo jiných označení v této publikaci je pouze pro referenční účely a nepředstavuje podporu držitele ochranné známky.
Použité symboly
 |
Nebezpečí – Informace týkající se bezpečnosti uživatele nebo možného poškození routeru. |
 |
Pozor – Problémy, které mohou nastat v konkrétních situacích. |
 |
Informace – užitečné tipy nebo informace zvláštního zájmu. |
 |
Example – Přampsoubor funkce, příkazu nebo skriptu. |
Seznam změn
1.1 Protokol změn Node.js
v1.0.0 (2017)
- První vydání.
v1.1.0 (2017) - Aktualizováno na Node.js 8.9.1.
v1.2.0 (2018) - Přidána podpora pro přihlášení do file s otáčením.
v1.2.1 (2018) - Aktualizováno na Node.js 8.11.1.
v2.0.0 (2020) - Aktualizováno na Node.js 10.15.3 a ffi 2.3.0.
- Optimalizované instalační uzly files ke zmenšení velikosti.
- Připraveno pro nový GCC 7.4.
- Připraveno pro nové jádro 4.14.
- Připraveno pro platformu V4.
- Přidán vlastní uzel „router“.
- Nastavte výchozí cestu pro vyhledávání uzlů na /usr/lib/node_modules.
v2.1.0 (2021) - Aktualizováno na Node.js 10.23.1.
- Přesunuté licenční informace z modulu Node-RED.
v16.14.2 (2022) - Aktualizováno na Node.js 16.14.2 s npm 8.5.0.
v16.15.0 (2022) - Do uzlu routeru přidán objekt pro práci s konfigurací routeru.
- Aktualizováno na Node.js 16.15.0 s npm 8.5.5.
- Opravené přihlášení na FW 6.3.5.
v16.17.0 (2022) - Aktualizováno na Node.js 16.17.0 s npm 8.15.0.
- Do uzlu routeru byla přidána vlastnost productModel.
v18.15.0 (2023) - Aktualizováno na Node.js 18.15.0 s npm 9.5.0.
- Odstraněn zastaralý neužitečný uzel „kdy“.
Aplikace Node.js Router
Routerová aplikace Node.js není obsažena ve standardním firmwaru routeru. Nahrání této aplikace routeru je popsáno v konfigurační příručce (viz kapitola Související dokumenty). Tato aplikace směrovače je kompatibilní pouze se směrovači platformy v3 a v4!
2.1 Úvod
Uzel Node.js je proprietární uzel běhového prostředí JavaScript na straně serveru dostupný pro mobilní směrovače Advantech. Tento uzel používají moduly Advantech napsané v JavaScriptu, ale může být použit jakoukoli jinou JavaScriptovou aplikací třetích stran pro správu a údržbu routerů.
Modul směrovače obsahuje tento přídavek uzlů k vestavěným uzlům:
- node-authenticate-pam – asynchronní ověřování PAM pro NodeJS,
- router node – proprietární uzel pro celulární routery Advantech podrobně popsaný v tomto dokumentu.
2.2Vytváření vlastních uzlů
Oficiální způsob, jak sestavit a nainstalovat uzel, je pomocí příkazu nmp. Existují však určitá omezení, protože směrovače Advantech jsou vestavěná zařízení bez plného operačního systému Linux a se specializovaným hardwarem. Aplikaci nmp Router App můžete nainstalovat do routeru a používat ji běžným způsobem, nebo připravit uzly pomocí nástroje npm na vašem PC a poté je zkopírovat do routeru. Není však možné nainstalovat všechny uzly, které najdete v úložišti npm.
Další podrobnosti viz: Router Apps – Cellular Routers Engineering Portal (advantech.cz)v kapitole 4.5 Node-RED Application Note.
Uzel směrovače
Tato část dokumentu je věnována především programátorům.
Uzel routeru (pojmenovaný „router“) poskytuje přístup ke specifickým funkcím a hardwaru routeru. Uzel Node.js můžete načíst do svého kódu pomocí require(“router”), napřampten:
Použijeme proměnnou r z tohoto příkladuample pro přístup ke všem vlastnostem v dalším příkladuampv těchto poznámkách.
Jednoduché Přample použití uzlu směrovače
Na dalším obrázku je exampsoubor načtení uzlu Node.js.
3.1 Vlastnosti uzlu
3.1.1 název produktu
Řetězcová proměnná pouze pro čtení načtená s názvem produktu routeru. Přample použití:
3.1.2 Model produktu
Řetězcová proměnná pouze pro čtení načtená s indikací modelu routeru. Přample použití:
3.1.3 revize produktu
Řetězcová proměnná pouze pro čtení načtená s číslem revize produktu routeru. Přample použití:
Výstup: 1.0
3.1.4 kód platformy
Řetězcová proměnná pouze pro čtení načtená s kódem platformy routeru. Je podporován routery produkční patologie v3 a v4. Přample použití:
Výstup: V3
3.1.5 sériové číslo
Řetězcová proměnná pouze pro čtení načtená se sériovým číslem routeru. Přample použití:
Výstup: ACZ1100000322054
Verze firmwaru 3.1.6
Řetězcová proměnná pouze pro čtení načtená s verzí firmwaru routeru. Přample použití:
Výstup: 6.2.1 (2019-10-16)
3.1.7 RTBatteryOK
Booleovská proměnná pouze pro čtení načtená se stavem baterie routeru RTC. Pravda znamená dobře, nepravda znamená špatně.
Example použití:
Výstup: pravda
3.1.8 Napájení
Proměnná desetinného čísla pouze pro čtení nabitá napájecím zdrojem routeru objtagE. Přample použití:
Výstup: 11.701 V.
3.1.9 teplota
Celočíselná proměnná pouze pro čtení načtená vnitřní teplotou routeru ve stupních Celsia. Přample použití:
Výstup: 39 °C
3.1.1 0usrLED
Logická proměnná pouze pro zápis pro kontrolku LED „USR“ směrovače. Přample použití:
Nastaví USR LED na ON (svítí).
3.1.11 bIn
Pole pouze pro čtení s hodnotami na binárních vstupech routeru. Pole má položky související s počtem binárních vstupů. Např. router má BIN0 a BIN1, takže pole má platné indexy 0 a 1. Položky pole mohou mít hodnoty 0 nebo 1. Př.ample použití:
Výstup: Sekundární binární vstup: 0
3.1.12 bOut
Pole související s binárními výstupy routeru. Je to podobné jako B_IN, ale můžete také zapisovat hodnoty. Zapsaná hodnota změní stav výstupu. Přample použití:
3.1.13 XBus
Objekt pro práci s X Bus. X Bus je proprietární sběrnice pro komunikaci mezi procesy. Např
můžete si objednat informace o tom, které síťové rozhraní jde nahoru/dolů, nebo SMS od démona mwan. Mezi aplikacemi můžete také odesílat/přihlašovat svá vlastní témata.
Odešle do systému požadavek sledování, aby sledoval vaši aplikaci „myapp“. Aplikace musí tuto zprávu zasílat pravidelně nejpozději do období definovaného v předchozí zprávě (v tomto příkladu 300 sample). Časový limit 0 přestane sledovat.
výstup:
XBus.read(téma)
Přečtěte si uloženou zprávu z XBus. Přample použití:
3.1.1 4konfigurace
Objekt obsahující konfiguraci routeru. Uživatel může číst konfigurační položku získáním vlastnosti objektu a zapisovat konfigurační položku nastavením vlastnosti objektu. Objektové klíče jsou stejné jako konfigurační klíče jako v nastavení files. Požadovaný název klíče je možné vyhledat v souvisejícím nastavení file. Konfigurace firmwaru jsou umístěny v /etc/settings.* files. Konfigurace aplikace Router je umístěna v /opt/*/etc/settings files. Zpráva o směrovači (Web UI: Status / System Log / Save Report) obsahuje úplný seznam aktuální konfigurace a může to být nejjednodušší způsob, jak najít požadovaný konfigurační klíč.
Pokud daný klíč neexistuje, čtená hodnota není definována a zapsaná hodnota způsobuje výjimku (v přísném režimu). Není možné přidat novou neexistující položku konfigurace, pouze upravit existující. Všechny konfigurační hodnoty jsou považovány za řetězce. Pokud uživatel potřebuje pracovat s jiným typem, musí si jej převést sám. Uzel neprovádí žádné ověření hodnoty. Za odeslání správných hodnot je odpovědný uživatel. Přamples:
Pro WIFI_AP_SSID=ROUTER_AP v /etc/settings.wifi_ap (nebo spíše v poli SSID ve formuláři WiFi • Access Point 1) bude výstup:
Bývalýample jak nastavit hodnotu konfigurace:
Změní IP adresu na rozhraní eth0
POZNÁMKA: Je pouze zapsána nová konfigurace. Pokud chce uživatel, aby se to vztahovalo na běžící prostředí, je nutný restart routeru nebo související služby. Napřample výše je možné použít následující příkaz shellu:
- Routerové aplikace: icr.advantech.cz/user-modules
- Nadace JS: https://nodered.org/
Dokumenty týkající se produktu můžete získat na Engineering Portal na adrese icr.advantech.cz adresa.
Chcete-li získat příručku pro rychlý start, uživatelskou příručku, konfigurační příručku nebo firmware vašeho routeru, přejděte na stránku Modely směrovačů vyhledejte požadovaný model a přepněte se na kartu Manuals nebo Firmware.
Instalační balíčky a příručky Router Apps jsou k dispozici na Routerové aplikace strana.
Vývojové dokumenty najdete na DevZone strana.
Advantech Czech sro, Sokolská 71, 562 04 Ústí nad Orlicí, Česká republika
Dokument č. APP-0080-EN, revize z 12. října 2023.
Dokumenty / zdroje
 |
Aplikace ADVANTECH Node.js Router [pdfUživatelská příručka Node.js Router App, Node.js, Router App, App |
