Korisnički vodič za aplikaciju ADVANTECH Node.js Router

Node.js
Upute za korištenjeNode.js aplikacija usmjerivača

Node.js aplikacija usmjerivača

© 2023 Advantech Czech sro Nijedan dio ove publikacije ne smije se reproducirati ili prenositi u bilo kojem obliku ili na bilo koji način, elektronički ili mehanički, uključujući fotografiju, snimanje ili bilo koji sustav za pohranu i pronalaženje informacija, bez pismenog pristanka.
Informacije u ovom priručniku podložne su promjenama bez prethodne najave i ne predstavljaju obvezu od strane Advantecha.
Advantech Czech sro neće biti odgovoran za slučajne ili posljedične štete proizašle iz opremanja, izvedbe ili korištenja ovog priručnika.
Svi nazivi robnih marki korišteni u ovom priručniku registrirani su zaštitni znakovi svojih vlasnika. Korištenje zaštitnih znakova ili drugih oznaka u ovoj publikaciji služi samo u referentne svrhe i ne predstavlja odobrenje od strane nositelja zaštitnog znaka.
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 – Korisni savjeti ili informacije od posebnog interesa.
	Example – prample funkcije, naredbe ili skripte.

Dnevnik promjena

1.1 Node.js Dnevnik promjena
v1.0.0 (2017. travnja 10.)

• Prvo izdanje.
  v1.1.0 (2017. travnja 11.)
• Ažurirano na Node.js 8.9.1.
  v1.2.0 (2018. travnja 02.)
• Dodana podrška za prijavu na file s rotirajućim.
  v1.2.1 (2018. travnja 08.)
• Ažurirano na Node.js 8.11.1.
  v2.0.0 (2020. travnja 02.)
• Ažurirano na Node.js 10.15.3 i ffi 2.3.0.
• Optimizirani instalacijski čvorovi files za smanjenje veličine.
• Pripremljeno za novi GCC 7.4.
• Pripremljeno za novi kernel 4.14.
• Pripremljeno za V4 platformu.
• Dodan prilagođeni čvor "usmjerivač".
• Postavite zadani put za pretraživanje čvorova na /usr/lib/node_modules.
  v2.1.0 (2021. travnja 05.)
• Ažurirano na Node.js 10.23.1.
• Premještene informacije o licenci iz modula Node-RED.
  v16.14.2 (2022. travnja 03.)
• Ažurirano na Node.js 16.14.2 s npm 8.5.0.
  v16.15.0 (2022. travnja 05.)
• Čvoru usmjerivača dodan objekt za rad s konfiguracijom usmjerivača.
• Ažurirano na Node.js 16.15.0 s npm 8.5.5.
• Popravljena prijava na FW 6.3.5.
  v16.17.0 (2022. travnja 08.)
• Ažurirano na Node.js 16.17.0 s npm 8.15.0.
• Čvoru usmjerivača dodano svojstvo productModel.
  v18.15.0 (2023. travnja 04.)
• Ažurirano na Node.js 18.15.0 s npm 9.5.0.
• Uklonjen zastarjeli beskorisni čvor "kada".

Node.js aplikacija usmjerivača

Aplikacija usmjerivača Node.js nije sadržana u standardnom firmveru usmjerivača. Prijenos ove aplikacije usmjerivača opisan je u priručniku za konfiguraciju (pogledajte dokumente vezane uz poglavlje). Ova aplikacija usmjerivača kompatibilna je samo s v3 i v4 platformskim usmjerivačima!

2.1 Uvod

Čvor Node.js vlasnički je č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 ove čvorove kao dodatak ugrađenim čvorovima:

• node-authenticate-pam – asinkrona PAM autentifikacija za NodeJS,
• čvor usmjerivača – vlasnički čvor za Advantechove mobilne usmjerivače koji su detaljno opisani u ovom dokumentu.

2.2 Izgradnja prilagođenih čvorova
Službeni način kako izgraditi i instalirati čvor je korištenje nmp naredbe. Međutim, postoje neka ograničenja jer su Advantech usmjerivači ugrađeni uređaji bez potpunog Linux OS-a i sa specijaliziranim hardverom. Možete instalirati aplikaciju nmp Router na usmjerivač i koristiti je na uobičajen način ili pripremiti čvorove pomoću npm alata na računalu i zatim ih kopirati na usmjerivač. Ali nije moguće instalirati sve čvorove koje možete pronaći u npm repozitoriju.
Za više detalja pogledajte: Aplikacije usmjerivača – portal za inženjering mobilnih usmjerivača (advantech.cz)u poglavlju 4.5 Napomene o aplikaciji Node-RED.

Čvor usmjerivača

Ovaj dio dokumenta posebno je posvećen programerima.
Čvor usmjerivača (nazvan "usmjerivač") omogućuje pristup specifičnim funkcijama i hardveru usmjerivača. Node.js čvor možete učitati u svom kodu pomoću require(“router”), na primjerampono: Koristit ćemo varijablu r iz ovog example za pristup svim svojstvima u sljedećem exampu ovim bilješkama.
Jednostavan prample o upotrebi čvora usmjerivača
Na sljedećoj slici je example učitavanja čvora Node.js.3.1 Svojstva čvora
3.1.1 naziv proizvoda
Varijabla niza samo za čitanje učitana s nazivom proizvoda usmjerivača. nprampupotreba:3.1.2 model proizvoda
Varijabla niza samo za čitanje učitana s indikacijom modela usmjerivača. nprampupotreba:3.1.3 Revizija proizvoda
Varijabla niza samo za čitanje učitana s brojem revizije proizvoda usmjerivača. nprampupotreba:Izlaz: 1.0
3.1.4 kod platforme
Varijabla niza samo za čitanje učitana s kodom platforme usmjerivača. Podržavaju ga usmjerivači v3 i v4 proizvodne platforme. nprampupotreba:Izlaz: V3
3.1.5 serijski broj
Varijabla niza samo za čitanje učitana serijskim brojem usmjerivača. nprampupotreba:Izlaz: ACZ1100000322054
3.1.6 firmwareVersion
Varijabla niza samo za čitanje učitana s verzijom firmvera usmjerivača. nprampupotreba:Izlaz: 6.2.1 (2019.)
3.1.7 RTCBatteryOK
Booleova varijabla samo za čitanje učitava RTC stanje baterije usmjerivača. Istinito znači OK, lažno znači loše.
Exampupotreba:Izlaz: istina
3.1.8 Napajanje
Varijabla decimalnog broja samo za čitanje učitana s napajanjem usmjerivača voltage. nprampupotreba:Izlaz: 11.701 V
3.1.9 temperatura
Varijabla cjelobrojnog samo za čitanje učitana unutarnjom temperaturom usmjerivača u Celzijevim stupnjevima. nprampupotreba:Izlaz: 39 °C
3.1.1 0usrLED
Booleova varijabla samo za pisanje za “USR” LED kontrolnu lampicu usmjerivača. nprampupotreba:Postavlja USR LED na UKLJUČENO (osvjetljenje).
3.1.11 bIn
Niz samo za čitanje s vrijednostima na binarnim ulazima usmjerivača. Niz ima stavke koje se odnose na broj binarnih ulaza. Npr. usmjerivač 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:Izlaz: Sekundarni binarni ulaz: 0
3.1.12 bOut
Niz koji se odnosi na binarne izlaze usmjerivača. Slično je kao B_IN, ali također možete pisati vrijednosti. Zapisana vrijednost mijenja izlazno stanje. nprampupotreba:3.1.13 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 mwan demona. Također možete poslati/pretplatiti se na vlastite teme između aplikacija.Šalje zahtjev za promatranje sustava kako bi pratio vašu "myapp" aplikaciju. Aplikacija mora redovito slati ovu poruku najkasnije nakon razdoblja definiranog u prethodnoj poruci (300 s u ovoj prample). Istek 0 prestaje gledati.Izlaz:XBus.read(tema)
Pročitajte pohranjenu poruku s XBusa. nprampupotreba:3.1.1 4konfiguracija
Objekt koji sadrži konfiguraciju usmjerivača. Korisnik može pročitati konfiguracijsku stavku dobivanjem svojstva objekta i napisati konfiguracijsku stavku postavljanjem svojstva objekta. Ključevi objekta isti su kao konfiguracijski ključevi kao u postavci files. Moguće je potražiti traženi naziv ključa u povezanoj postavci file. Konfiguracije firmvera nalaze se u /etc/settings.* files. Konfiguracija aplikacije usmjerivača nalazi se u /opt/*/etc/settings files. Izvješće o usmjerivaču (Web UI: Status / Zapisnik sustava / Spremi izvješće) sadrži potpuni popis trenutne konfiguracije i možda je to najlakši način za pronalaženje traženog konfiguracijskog ključa.
Ako određeni ključ ne postoji, pročitana vrijednost je nedefinirana, a zapisana vrijednost uzrokuje iznimku (u strogom načinu). Nije moguće dodati novu nepostojeću stavku konfiguracije, već samo izmijeniti postojeću. Sve vrijednosti konfiguracije tretiraju se kao nizovi. Ako korisnik treba raditi s drugom vrstom, mora je sam pretvoriti. Čvor ne provodi nikakvu provjeru vrijednosti. Korisnik je odgovoran za slanje točnih vrijednosti. npramples:Za WIFI_AP_SSID=ROUTER_AP u /etc/settings.wifi_ap (ili radije u polju SSID u obrascu WiFi • Access Point 1) izlaz će biti:Bivšiample kako postaviti vrijednost konfiguracije:Mijenja IP adresu na eth0 sučelju
BILJEŠKA: Nova konfiguracija je samo napisana. Ako korisnik želi da se primijeni na radnu okolinu, potrebno je ponovno pokrenuti usmjerivač ili povezanu uslugu. Na primjerampgore je moguće koristiti sljedeću naredbu ljuske:

Povezani dokumenti

1. Aplikacije usmjerivača: icr.advantech.cz/korisnički-moduli
2. Zaklada JS: https://nodered.org/

Dokumente vezane uz proizvode možete dobiti na Inženjerskom portalu na adresi icr.advantech.cz adresa.
Da biste dobili Vodič za brzi početak rada, Korisnički priručnik, Priručnik za konfiguraciju ili firmver, idite na Modeli rutera stranici, pronađite željeni model i prebacite se na karticu Manuals ili Firmware.
Instalacijski paketi i priručnici za aplikacije usmjerivača dostupni su na Aplikacije usmjerivača stranica.
Za razvojne dokumente idite na DevZone stranica.

Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Češka Republika
Dokument br. APP-0080-EN, revizija od 12. listopada 2023.