Korisnički vodič za ADVANTECH RouterApp Node.js

Korisnički modul
Node.js
NAPOMENA O PRIMJENI

Korišteni simboli

Opasnost – Informacije o sigurnosti korisnika ili mogućem oštećenju usmjerivača.
Pažnja – Problemi koji se mogu pojaviti u određenim situacijama.
Informacije ili obavijesti – korisni savjeti ili informacije od posebnog interesa.
Example – prample funkcije, naredbe ili skripte.

Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Češka Republika
Dokument br. APP-0080-HR revidiran je 7. svibnja 2021. Objavljen u Češkoj Republici.

Node.js korisnički modul

Web Sučelje

Nakon što je instalacija modula dovršena, GUI modula može se pozvati klikom na naziv modula na stranici Korisnički moduli na usmjerivaču web sučelje. Lijevi dio ovog GUI-ja sadrži izbornik s odjeljkom izbornika Općenito. Opći odjeljak izbornika sadrži samo Licence koje sadrže popis svih licenci za sam Node.js, kao i srodnu aplikaciju usmjerivača i stavku Povrat, koja se vraća s modula web stranicu na usmjerivač web konfiguracijske stranice. Glavni izbornik GUI modula prikazan je na slici 2.

 Uvod

Korisnički modul Node.js nije dio firmvera usmjerivača. Može se preuzeti sa icr.advantech.cz/korisnički-moduli. Proces instalacije korisničkih modula opisan je u Priručniku za konfiguraciju (vidi [1], [2], [3] i [4]). Ovaj korisnički modul kompatibilan je samo s usmjerivačima platforme v3 i v4!
Node.js čvor je vlasnički čvor JavaScript runtime okruženja na strani poslužitelja dostupan za Advantech mobilne usmjerivače. Ovaj čvor koriste Advantech moduli napisani u JavaScriptu, ali ga može koristiti bilo koja druga JavaScript aplikacija treće strane za administraciju i održavanje usmjerivača.
Modul usmjerivača sadrži dodatak ovog čvora ugrađenim čvorovima:

• čvor-authenticate-pam – asinkrona PAM autentifikacija za NodeJS,
• kada.js – implementacija Promises/A+ i when(), uključujući kompletan ES6 Promise shim,
• čvor rutera – vlasnički čvor za Advantechove mobilne usmjerivače detaljno opisan u ovom dokumentu.

Izgradnja prilagođenih čvorova

Službeni način kako izgraditi i instalirati čvor je korištenje npm naredbe. Međutim, nije ga moguće pronaći na našim usmjerivačima jer je usmjerivač ugrađeni uređaj s ograničenim resursima i neki čvorovi zahtijevaju složeno okruženje izgradnje i visoke performanse zbog drugih jezika osim JavaScripta.
Srećom, lako je pripremiti čvor na računalu s Linuxom i zatim ga kopirati na usmjerivač.
Za više pojedinosti pogledajte https://icr.advantech.cz/support/faq/detail/building-the-custom-nodes-fornode-js-node-red.

Čvor usmjerivača

Ovaj dio dokumenta posebno je posvećen programerima.
Čvor usmjerivača (nazvan "usmjerivač") pruža pristup funkcijama i hardveru specifičnim za usmjerivač.
Node.js čvor možete učitati u svoj kod pomoću require(“router”), na primjerampono:
var r = zahtijevaju(“usmjerivač”);
Koristit ćemo varijablu r iz ovog example za pristup svim svojstvima u sljedećem examples u ovoj bilješci.
Jednostavan prample o upotrebi čvora usmjerivača
Sljedeća figura je bivšiample utovara Node.js čvor.

Svojstva čvora

2.1.1 naziv proizvoda
Varijabla niza samo za čitanje učitana s nazivom proizvoda usmjerivača. nprampupotreba:
console.log(r.productName);
Izlaz: SPECTRE-v3T-LTE
2.1.2 kod platforme
Varijabla niza samo za čitanje učitana je kodom platforme usmjerivača. Podržavaju ga usmjerivači od
v3 i v4 proizvodne platforme. nprampupotreba:
console.log(r.platformCode);
Izlaz: V3
2.1.3 serijski broj
Varijabla niza samo za čitanje učitana serijskim brojem usmjerivača. nprampupotreba:
console.log(r.serijski broj);
Izlaz: ACZ1100000322054
2.1.4 verzija firmvera
Varijabla niza samo za čitanje učitana s verzijom firmvera usmjerivača. nprampupotreba:
console.log(r.firmwareVersion);
Izlaz: 6.2.1 (2019.)
2.1.5 RTCBatteryOK
Booleova varijabla samo za čitanje učitana s RTC stanjem baterije usmjerivača. Istina znači u redu, lažno znači loše. nprampupotreba:
console.log(r.RTCBatteryOK);
Izlaz: istina
2.1.6 napajanje
Varijabla decimalnog broja samo za čitanje učitana s napajanjem usmjerivača voltage. nprampupotreba:
console.log(r.powerSupply + 'V');
Izlaz: 11.701 V
2.1.7 temperatura
Varijabla cjelobrojnog samo za čitanje učitana unutarnjom temperaturom usmjerivača u Celzijevim stupnjevima. nprampupotreba:
console.log(r.temperature + '◦ C');
Izlaz: 39 ◦ C
2.1.8 usrLED
Booleova varijabla samo za pisanje za “USR” LED kontrolnu lampicu usmjerivača. nprampupotreba:
r.usrLED = istina;
Postavlja USR LED na UKLJUČENO (osvjetljenje).
2.1.9 bIn
Niz samo za čitanje s vrijednostima na binarnim ulazima usmjerivača. Niz ima stavke povezane s nizom binarnih ulaza. Npr. ruter ima BIN0 i BIN1 tako da niz ima važeće indekse 0 i 1. Stavke niza mogu imati vrijednosti 0 ili 1. Npr.ampupotreba:
console.log(“Sekundarni binarni ulaz: ” + r.bIn[1]);
Izlaz: Sekundarni binarni ulaz: 0
2.1.10 nastup
Niz povezan s binarnim izlazima usmjerivača. Slično je B_IN, ali također možete napisati vrijednosti.
Napisana vrijednost mijenja stanje izlaza. nprampupotreba:
console.log(r.bOut[0]);
Izlaz: 1
r.bIzlaz[0] = 0;
Postavlja prvi binarni izlaz na 0.
2.1.11 XBus
Objekt za rad s X Busom. X Bus je vlasnička sabirnica za komunikaciju između procesa.
Npr. možete se pretplatiti na informacije koje mrežno sučelje ide gore/dolje ili SMS od man demona. Također možete slati/pretplatiti vlastite teme između svojih aplikacija.
XBus.publish(topic, payload, store=false)
Šalje poruku s temom String i korisni niz String na X sabirnicu. nprampupotreba:
r.xBus.publish(“watchdog/proc/myapp”, “Timeout: 300”);
Šalje zahtjev za praćenje sustava za gledanje vaše aplikacije "myapp". Aplikacija mora redovito slati ovu poruku najkasnije do razdoblja definiranog u prethodnoj poruci (300 s u ovoj example). Istek 0 prestaje gledati.
XBus.subscribe(tema, povratni poziv)
Pretplatite se za primanje poruka s temom. nprampupotreba:
Funkcija:
xbus.subscribe(“status/mobile/mwan0”, (msg) => {console.log(msg.payload);});
Asinkroni izlaz:
Registracija: kućna mreža
Tehnologija: LTE
Jačina signala: -88 dBm
Kvaliteta signala: -8 dB

XBus.unsubscribe(tema)
Odjavite se s teme. nprampupotreba:
r.XBus.unsubscribe(id);
Prestaje primati informacije o registraciji na mrežu od prethodnog example.
XBus.list()
Popisuje pohranjene poruke. nprampupotreba:
r.XBus.list();

Izlaz:
[ 'iface/ipv4/mwan0/config',
'iface/ipv4/mwan0/running',
'iface/ipv4/mwan1/config',
'iface/ipv4/mwan1/running',
'status/mobile/mwan0',
'status/mobile/mwan1',
'pas čuvar/proc/bard',
'watchdog/proc/bard6',
'watchdog/proc/mwan1d',
'watchdog/proc/mwan2d',
'watchdog/proc/mwanxd' ]

XBus.read(tema)
Čitanje pohranjenih poruka s XBusa. nprampupotreba:
r.XBus.read('face/ipv4/mwan0/config');
Izlaz:
Gore: 1
Lice: usb0
Adresa: 10.184.131.221
Gateway: 192.168.253.254
DNS1: 217.77.165.211
DNS2: 217.77.165.81

Povezani dokumenti

[1] Advantech Češka: Priručnik za konfiguraciju SmartStart (MAN-0022-EN)
[2] Advantech Češka: Priručnik za konfiguraciju SmartFlex (MAN-0023-EN)
[3] Advantech Češka: Priručnik za konfiguraciju SmartMotion (MAN-0024-EN)
[4] Advantech Češka: Priručnik za konfiguraciju ICR-3200 (MAN-0042-EN)
[5] Korisnički moduli: icr.advantech.cz/korisnički-moduli
[6] Zaklada JS: https://nodered.org/

[EP] Dokumenti i aplikacije u vezi s proizvodom mogu se dobiti na Inženjerskom portalu na adresi icr.advantech.cz adresa.