Node.js
Felhasználói kézikönyv
Node.js Router App
Node.js Router App
© 2023 Advantech Czech sro A kiadvány egyetlen része sem reprodukálható vagy továbbítható semmilyen formában vagy eszközzel, sem elektronikusan, sem mechanikusan, ideértve a fényképezést, a felvételt vagy bármilyen információtároló és -visszakereső rendszert írásbeli hozzájárulás nélkül.
A kézikönyvben található információk előzetes értesítés nélkül változhatnak, és nem jelentenek kötelezettségvállalást az Advantech részéről.
Az Advantech Czech sro nem vállal felelősséget a jelen kézikönyv berendezéséből, teljesítményéből vagy használatából eredő véletlen vagy következményes károkért.
A kézikönyvben használt összes márkanév a megfelelő tulajdonosok bejegyzett védjegye. A védjegyek vagy más megjelölések ebben a kiadványban csak hivatkozási célokat szolgálnak, és nem minősülnek a védjegytulajdonos általi jóváhagyásnak.
Használt szimbólumok
 |
Veszély – A felhasználó biztonságával vagy az útválasztó esetleges károsodásával kapcsolatos információk. |
 |
Figyelem – Konkrét helyzetekben felmerülő problémák. |
 |
Információ – Hasznos tippek vagy különleges érdeklődésre számot tartó információk. |
 |
Example – Plampfüggvény, parancs vagy szkript le. |
Változásnapló
1.1 Node.js változásnapló
v1.0.0 (2017-10-02)
- Első kiadás.
v1.1.0 (2017-11-08) - Frissítve Node.js 8.9.1-re.
v1.2.0 (2018-02-18) - Hozzáadott támogatás a bejelentkezéshez file forgatással.
v1.2.1 (2018-08-10) - Frissítve Node.js 8.11.1-re.
v2.0.0 (2020-02-21) - Frissítve Node.js 10.15.3-ra és ffi 2.3.0-ra.
- Optimalizált csomópontok telepítése files méretének csökkentésére.
- Felkészült az új GCC 7.4-re.
- Felkészült az új 4.14-es kernelre.
- V4 platformra felkészítve.
- Hozzáadtuk a „router” egyéni csomópontot.
- Állítsa be a csomópontok keresésének alapértelmezett elérési útját a /usr/lib/node_modules mappába.
v2.1.0 (2021-05-06) - Frissítve Node.js 10.23.1-re.
- Licencinformációk áthelyezve a Node-RED modulból.
v16.14.2 (2022-03-18) - Frissítve Node.js 16.14.2-re, npm 8.5.0-val.
v16.15.0 (2022-05-10) - Hozzáadott egy objektumot az útválasztó konfigurációjával való munkavégzéshez az útválasztó csomópontjához.
- Frissítve Node.js 16.15.0-re, npm 8.5.5-val.
- Fix bejelentkezés az FW 6.3.5-ön.
v16.17.0 (2022-08-25) - Frissítve Node.js 16.17.0-re, npm 8.15.0-val.
- A productModel tulajdonság hozzáadva az útválasztó csomópontjához.
v18.15.0 (2023-04-06) - Frissítve Node.js 18.15.0-re, npm 9.5.0-val.
- Eltávolított elavult, használhatatlan csomópont „mikor”.
Node.js Router App
A Node.js útválasztó alkalmazást nem tartalmazza a szabványos útválasztó firmware. Az útválasztó alkalmazás feltöltését a konfigurációs kézikönyv írja le (lásd a Kapcsolódó dokumentumok fejezetet). Ez az útválasztó alkalmazás csak a v3 és v4 platformú útválasztókkal kompatibilis!
2.1 Bevezetés
A Node.js csomópont egy szabadalmaztatott szerveroldali JavaScript futási környezeti csomópont, amely az Advantech cellás útválasztók számára elérhető. Ezt a csomópontot az Advantech JavaScript-ben írt moduljai használják, de bármely más, harmadik féltől származó JavaScript-alkalmazás használhatja az útválasztók adminisztrációjához és karbantartásához.
A router modul a következő csomópontokat tartalmazza a beépített csomópontokhoz:
- node-authenticate-pam – aszinkron PAM hitelesítés a NodeJS-hez,
- router node – egy szabadalmaztatott csomópont az Advantech cellás útválasztóihoz, amelyeket ebben a dokumentumban részletesen ismertetünk.
2.2 Egyéni csomópontok létrehozása
A csomópontok létrehozásának és telepítésének hivatalos módja az nmp parancs használata. Vannak azonban bizonyos korlátozások, mivel az Advantech útválasztók beágyazott eszközök teljes Linux operációs rendszer nélkül és speciális hardverrel. Telepítheti az nmp Router App-ot az útválasztóra, és a szokásos módon használhatja, vagy előkészítheti a csomópontokat az npm eszközzel a számítógépen, majd átmásolhatja azokat az útválasztóra. De nem lehet minden csomópontot telepíteni, amelyet az npm tárolóban talál.
További részletekért lásd: Útválasztó alkalmazások – Cellular Routers Engineering Portal (advantech.cz)a Node-RED Application Note 4.5. fejezetében.
Router csomópont
A dokumentum ezen része kifejezetten a programozóknak szól.
Az útválasztó csomópontja (úgynevezett „router”) hozzáférést biztosít a router-specifikus funkciókhoz és hardverekhez. A Node.js csomópontot a kódban a request("router") segítségével töltheti be, plample:
Ebből a példából az r változót fogjuk használniample az összes tulajdonság eléréséhez a következő examples ebben a jegyzetekben.
Egyszerű plampLe a Router Node Use
A következő ábrán egy example a Node.js csomópont betöltéséhez.
3.1 Csomópont tulajdonságai
3.1.1 terméknév
Csak olvasható karakterlánc-változó betöltve az útválasztó terméknevével. Voltampfelhasználási terület:
3.1.2 termékmodell
Csak olvasható karakterlánc-változó betöltve az útválasztó modelljelzésével. Voltampfelhasználási terület:
3.1.3 termékRevision
Csak olvasható karakterlánc-változó betöltve az útválasztó termék verziószámával. Voltampfelhasználási terület:
Kimenet: 1.0
3.1.4 PlatformCode
Csak olvasható karakterlánc-változó betöltve az útválasztó platformkódjával. A v3 és v4 éles patform útválasztói támogatják. Voltampfelhasználási terület:
Kimenet: V3
3.1.5 sorozatszám
Csak olvasható karakterlánc-változó betöltve az útválasztó sorozatszámával. Voltampfelhasználási terület:
Kimenet: ACZ1100000322054
3.1.6 firmware-verzió
Csak olvasható karakterlánc-változó betöltve az útválasztó firmware-verziójával. Voltampfelhasználási terület:
Kimenet: 6.2.1 (2019-10-16)
3.1.7 RTCBatteryOK
Csak olvasható logikai változó betöltve az útválasztó RTC akkumulátorállapotával. Az igaz azt jelenti, hogy rendben van, a hamis azt, hogy rossz.
Exampfelhasználási terület:
Kimenet: igaz
3.1.8 tápegység
Csak olvasható decimális számváltozó betöltve a router tápegységével voltage. Voltampfelhasználási terület:
Kimenet: 11.701 V
3.1.9 hőmérséklet
Csak olvasható egész szám változó a router belső hőmérsékletével Celsius fokban. Voltampfelhasználási terület:
Kimenet: 39 °C
3.1.1 0usrLED
Csak írható logikai változó az útválasztó „USR” LED-jéhez. Voltampfelhasználási terület:
Az USR LED-et BE-re állítja (világítás).
3.1.11 bIn
Csak olvasható tömb értékekkel az útválasztó bináris bemenetein. A tömb a bináris bemenetek számához kapcsolódó elemeket tartalmazza. Pl. az útválasztónak BIN0 és BIN1 van, tehát a tömbnek érvényes indexe 0 és 1. A tömb elemeinek értéke lehet 0 vagy 1. Pl.ampfelhasználási terület:
Kimenet: A másodlagos bináris bemenet: 0
3.1.12 bOut
A router bináris kimeneteivel kapcsolatos tömb. Hasonló a B_IN-hez, de értékeket is írhat. Írott érték változás kimeneti állapota. Voltampfelhasználási terület:
3.1.13 XBus
Objektum az X Busszal való munkavégzéshez. Az X Bus egy szabadalmaztatott busz a folyamatok közötti kommunikációhoz. Például
Előfizethet információkra, hogy melyik hálózati interfész megy fel/le, vagy SMS-t egy mwan démontól. Saját témákat is küldhet/előfizethet az alkalmazások között.
Kérést küld a rendszerfigyelőnek, hogy nézze meg a „myapp” alkalmazást. Az alkalmazásnak rendszeresen el kell küldenie ezt az üzenetet, legkésőbb az előző üzenetben meghatározott időszakon belül (ebben pl. 300 s).ample). A 0 időtúllépés leállítja a nézést.
Kimenet:
XBus.read(téma)
Olvassa el az XBus tárolt üzenetét. Voltampfelhasználási terület:
3.1.1 4konfiguráció
Az útválasztó konfigurációját tartalmazó objektum. A felhasználó beolvashat egy konfigurációs elemet egy objektumtulajdonság lekérésével, és egy konfigurációs elemet írhat egy objektumtulajdonság beállításával. Az objektumkulcsok megegyeznek a konfigurációs kulcsokkal, mint a beállításban files. Lehetőség van a kért kulcsnév megkeresésére a kapcsolódó beállításokban file. A firmware-konfigurációk az /etc/settings mappában találhatók.* files. A Router App konfigurációja az /opt/*/etc/settings mappában található files. Az útválasztó jelentés (Web UI: Állapot / Rendszernapló / Jelentés mentése) tartalmazza az aktuális konfiguráció teljes listáját, és talán ez a legegyszerűbb módja a kért konfigurációs kulcs megtalálásának.
Ha egy adott kulcs nem létezik, az olvasási érték definiálatlan, és egy írott érték kivételt okoz (szigorú módban). Új, nem létező konfigurációs elem hozzáadása nem lehetséges, csak egy meglévő módosítása lehetséges. Az összes konfigurációs értéket karakterláncként kezeli a rendszer. Ha a felhasználónak más típussal kell dolgoznia, magának kell konvertálnia. A csomópont nem végez értékellenőrzést. A helyes értékek elküldéséért a felhasználó felelős. Voltamples:
A WIFI_AP_SSID=ROUTER_AP esetén az /etc/settings.wifi_ap fájlban (vagy inkább a WiFi • Access Point 1 űrlap SSID mezőjében) a kimenet a következő lesz:
Egy voltamphogyan állítsunk be egy konfigurációs értéket:
Megváltoztatja az eth0 interfész IP-címét
JEGYZET: Egy új konfiguráció csak íródik. Ha a felhasználó azt szeretné, hogy a futó környezetre vonatkozzon, újra kell indítani az útválasztót vagy a kapcsolódó szolgáltatást. PlampA fentiekben a következő shell parancs használható:
- Router alkalmazások: icr.advantech.cz/user-modules
- JS Alapítvány: https://nodered.org/
A termékkel kapcsolatos dokumentumokat a Mérnöki Portálon szerezheti be: icr.advantech.cz cím.
Az útválasztó gyors üzembe helyezési útmutatója, felhasználói kézikönyve, konfigurációs kézikönyve vagy firmware-e a Router modellek oldalon, keresse meg a kívánt modellt, és váltson át a Kézikönyvek vagy a Firmware fülre.
A Router Apps telepítőcsomagjai és kézikönyvei itt érhetők el Útválasztó alkalmazások oldalon.
A fejlesztési dokumentumokhoz lépjen a DevZone oldalon.
Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Cseh Köztársaság
APP-0080-EN számú dokumentum, 12. október 2023-i felülvizsgálat.
Dokumentumok / Források
 |
ADVANTECH Node.js Router App [pdf] Felhasználói útmutató Node.js Router App, Node.js, Router App, App |
