Uživatelský modul
Node.js
POZNÁMKA K APLIKACI
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 ve specifických situacích.
Informace nebo upozornění – Užitečné tipy nebo informace zvláštního zájmu.
Example – Přampsoubor funkce, příkazu nebo skriptu.
Advantech Czech sro, Sokolská 71, 562 04 Ústí nad Orlicí, Česká republika
Dokument č. APP-0080-EN byl revidován 7. května 2021. Vydán v České republice.
Uživatelský modul Node.js
Web Rozhraní
Po dokončení instalace modulu lze GUI modulu vyvolat kliknutím na název modulu na stránce Uživatelské moduly na routeru. web rozhraní. Levá část tohoto GUI obsahuje menu se sekcí Obecné menu. Sekce obecného menu obsahuje pouze Licence obsahující seznam všech licencí pro samotný Node.js a také související položku Router Application a Return, která přepíná zpět z modulu web stránku k routeru web konfigurační stránky. Hlavní nabídka GUI modulu je znázorněna na obrázku 2.
Zavedení
Uživatelský modul Node.js není součástí firmwaru routeru. Lze jej stáhnout z icr.advantech.cz/user-modules. Proces instalace uživatelských modulů je popsán v Konfiguračním manuálu (viz [1], [2], [3] a [4]). Tento uživatelský modul je kompatibilní pouze se směrovači platforem v3 a v4!
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 přidání tohoto uzlu k vestavěným uzlům:
- node-authenticate-pam – asynchronní ověřování PAM pro NodeJS,
- když.js – Implementace Promises/A+ a When(), včetně kompletní podložky ES6 Promise,
- uzel routeru – proprietární uzel pro celulární směrovače Advantech podrobně popsaný v tomto dokumentu.
Vytváření vlastních uzlů
Oficiální způsob, jak sestavit a nainstalovat uzel, je pomocí příkazu npm. Na našich routerech jej však nelze najít, protože router je vestavěné zařízení s omezenými prostředky a některé uzly vyžadují složité prostředí budovy a vysoký výkon kvůli jiným jazykům než JavaScript.
Naštěstí je snadné připravit uzel na PC s Linuxem a následně jej zkopírovat do routeru.
Pro více informací viz https://icr.advantech.cz/support/faq/detail/building-the-custom-nodes-fornode-js-node-red.
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:
var r = vyžadovat(“router”);
Použijeme proměnnou r z tohoto příkladuample pro přístup ke všem vlastnostem v dalším příkladuampv této poznámce.
Jednoduché Přample použití uzlu směrovače
Další obrázek je example načítání Node.js uzel.
Vlastnosti uzlu
2.1.1 název produktu
Řetězcová proměnná pouze pro čtení načtená s názvem produktu routeru. Přample použití:
console.log(r.productName);
Výstup: SPECTRE-v3T-LTE
2.1.2 kód platformy
Řetězcová proměnná pouze pro čtení načtená s kódem platformy routeru. Je podporován routery z
produkční platformy v3 a v4. Přample použití:
console.log(r.platformCode);
Výstup: V3
2.1.3 sériové číslo
Řetězcová proměnná pouze pro čtení načtená se sériovým číslem routeru. Přample použití:
console.log(r.serialNumber);
Výstup: ACZ1100000322054
2.1.4 verze firmwaru
Řetězcová proměnná pouze pro čtení načtená s verzí firmwaru routeru. Přample použití:
console.log(r.firmwareVersion);
Výstup: 6.2.1 (2019-10-16)
2.1.5 RTBatteryOK
Booleovská proměnná pouze pro čtení načtená se stavem baterie routeru RTC. Pravda znamená dobře, nepravda znamená špatně. Přample použití:
console.log(r.RTCBateryOK);
Výstup: pravda
2.1.6 zdroj napájení
Proměnná desetinného čísla pouze pro čtení nabitá napájecím zdrojem routeru objtagE. Přample použití:
console.log(r.powerSupply + ' V');
Výstup: 11.701 V.
2.1.7 teplota
Celočíselná proměnná pouze pro čtení načtená vnitřní teplotou routeru ve stupních Celsia. Přample použití:
console.log(r.teplota + '◦ C');
Výkon: 39 ◦ C
2.1.8 usrLED
Logická proměnná pouze pro zápis pro kontrolku LED „USR“ směrovače. Přample použití:
r.usrLED = true;
Nastaví USR LED na ON (svítí).
2.1.9 zásobník
Pole pouze pro čtení s hodnotami na binárních vstupech routeru. Pole má položky související s řadou 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í:
console.log(“Sekundární binární vstup: ” + r.bIn[1]);
Výstup: Sekundární binární vstup: 0
2.1.10 zápas
Pole související s binárními výstupy routeru. Je to podobné jako B_IN, ale můžete také zapisovat hodnoty.
Stav výstupu změny zapsané hodnoty. Přample použití:
console.log(r.bOut[0]);
Výstup: 1
r.bOut[0] = 0;
Nastaví první binární výstup na 0.
2.1.11 XBus
Objekt pro práci s X Bus. X Bus je proprietární sběrnice pro komunikaci mezi procesy.
Např. si můžete objednat informace o tom, které síťové rozhraní jde nahoru/dolů, nebo SMS od man démona. Mezi aplikacemi můžete také odesílat/přihlašovat svá vlastní témata.
XBus.publish(topic, payload, store=false)
Odešle zprávu s tématem String a užitečné zatížení String do X Bus. Přample použití:
r.xBus.publish("watchdog/proc/myapp", "Timeout: 300");
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 v období definovaném v předchozí zprávě (v tomto příkladu 300 sample). Časový limit 0 přestane sledovat.
XBus.subscribe(téma, zpětné volání)
Přihlásí se k odběru zpráv s tématem. Přample použití:
Funkce:
xbus.subscribe(“status/mobile/mwan0”, (msg) => {console.log(msg.payload);});
Asynchronní výstup:
Registrace: Domácí síť
Technologie: LTE
Síla signálu: -88 dBm
Kvalita signálu: -8 dB
XBus.unsubscribe(téma)
Odhlásit se z tématu. Přample použití:
r.XBus.unsubscribe(id);
Přestane dostávat informace o registraci do sítě z předchozího example.
XBus.list()
Zobrazí seznam uložených zpráv. Přample použití:
r.XBus.list();
výstup:
[ 'iface/ipv4/mwan0/config',
'iface/ipv4/mwan0/running',
'iface/ipv4/mwan1/config',
'iface/ipv4/mwan1/running',
'status/mobile/mwan0',
'status/mobile/mwan1',
'hlídací pes/proc/bard',
'watchdog/proc/bard6',
'hlídací pes/proc/mwan1d',
'hlídací pes/proc/mwan2d',
'hlídací pes/proc/mwanxd' ]
XBus.read(téma)
Číst uložené zprávy z XBus. Přample použití:
r.XBus.read('face/ipv4/mwan0/config');
výstup:
Nahoru: 1
Iface: usb0
Adresa: 10.184.131.221
Brána: 192.168.253.254
DNS1: 217.77.165.211
DNS2: 217.77.165.81
[1] Advantech Czech: SmartStart Configuration Manual (MAN-0022-EN)
[2] Advantech Czech: SmartFlex Configuration Manual (MAN-0023-EN)
[3] Advantech Czech: SmartMotion Configuration Manual (MAN-0024-EN)
[4] Advantech Czech: ICR-3200 Configuration Manual (MAN-0042-EN)
[5] Uživatelské moduly: icr.advantech.cz/user-modules
[6] Nadace JS: https://nodered.org/
[EP] Dokumenty a aplikace související s produktem lze získat na Engineering Portal na adrese icr.advantech.cz adresa.
Dokumenty / zdroje
 |
ADVANTECH RouterApp Node.js [pdfUživatelská příručka ADVANTECH, RouterApp, Node.js |
