Node.js
Giya sa GumagamitNode.js Router App

Node.js Router App

© 2023 Advantech Czech sro Walay bahin niini nga publikasyon ang mahimong kopyahon o ipadala sa bisan unsang porma o sa bisan unsang paagi, elektroniko o mekanikal, lakip ang litrato, pagrekord, o bisan unsang sistema sa pagtipig ug pagkuha sa impormasyon nga walay sinulat nga pagtugot.
Ang impormasyon niini nga manwal mahimong mausab nga walay pahibalo, ug kini wala magrepresentar sa usa ka pasalig sa bahin sa Advantech.
Ang Advantech Czech sro dili manubag sa sulagma o sangputanan nga mga kadaot nga resulta sa paghatag, pagbuhat, o paggamit niini nga manwal.
Ang tanan nga mga ngalan sa brand nga gigamit niini nga manwal mao ang mga rehistradong marka sa pamatigayon sa ilang tagsa-tagsa ka tag-iya. Ang paggamit sa mga marka sa pamatigayon o uban pang mga ngalan niini nga publikasyon alang lamang sa mga katuyoan sa pakisayran ug dili usa ka pag-endorso sa naghupot sa marka sa pamatigayon.
Gigamit nga mga simbolo

	Peligro – Impormasyon bahin sa kaluwasan sa user o posibleng kadaot sa router.
	Atensyon - Mga problema nga mahimong motumaw sa piho nga mga sitwasyon.
	Impormasyon – Mapuslanon nga mga tip o impormasyon sa espesyal nga interes.
	Example – Example sa function, sugo o script.

Changelog

1.1 Node.js Changelog
v1.0.0 (2017-10-02)

• Unang pagpagawas.
  v1.1.0 (2017-11-08)
• Gi-update sa Node.js 8.9.1.
  v1.2.0 (2018-02-18)
• Gidugang nga suporta alang sa pag-log sa file uban sa pagtuyok.
  v1.2.1 (2018-08-10)
• Gi-update sa Node.js 8.11.1.
  v2.0.0 (2020-02-21)
• Gi-update sa Node.js 10.15.3 ug ffi 2.3.0.
• Na-optimize nga pag-install sa mga node files sa pagpakunhod sa gidak-on.
• Andam alang sa bag-ong GCC 7.4.
• Andam alang sa bag-ong kernel 4.14.
• Andam alang sa V4 nga plataporma.
• Gidugang ang naandan nga node nga "router".
• Pagbutang ug default nga dalan para sa pagpangita sa mga node sa /usr/lib/node_modules.
  v2.1.0 (2021-05-06)
• Gi-update sa Node.js 10.23.1.
• Gibalhin ang impormasyon sa lisensya gikan sa Node-RED module.
  v16.14.2 (2022-03-18)
• Gi-update sa Node.js 16.14.2 nga adunay npm 8.5.0.
  v16.15.0 (2022-05-10)
• Gidugang ang usa ka butang alang sa pagtrabaho kauban ang configuration sa router sa node sa router.
• Gi-update sa Node.js 16.15.0 nga adunay npm 8.5.5.
• Giayo nga pag-login sa FW 6.3.5.
  v16.17.0 (2022-08-25)
• Gi-update sa Node.js 16.17.0 nga adunay npm 8.15.0.
• Gidugang ang property productModel sa router node.
  v18.15.0 (2023-04-06)
• Gi-update sa Node.js 18.15.0 nga adunay npm 9.5.0.
• Gikuha ang obsolte walay pulos nga node "kanus-a".

Node.js Router App

Ang Router app nga Node.js wala anaa sa standard router firmware. Ang pag-upload niini nga router app gihulagway sa Configuration manual (tan-awa ang Chapter Related Documents). Kini nga router app nahiuyon ra sa v3 ug v4 nga mga platform nga router!

2.1 Pasiuna

Ang Node.js node usa ka proprietary server-side JavaScript runtime environment node nga magamit alang sa Advantech cellular routers. Kini nga node gigamit sa mga module sa Advantech nga gisulat sa JavaScript, apan mahimong gamiton sa bisan unsang ubang third-party nga JavaScript nga aplikasyon alang sa pagdumala ug pagmentinar sa mga router.
Ang module sa router naglangkob niini nga mga node nga dugang sa mga buil-in nga node:

• node-authenticate-pam - asynchronous nga PAM authentication para sa NodeJS,
• router node – usa ka proprietary node para sa mga cellular router sa Advantech nga gihulagway niini nga dokumento sa detalye.

2.2Pagtukod sa Custom Nodes
Usa ka opisyal nga paagi kung giunsa ang paghimo ug pag-instalar sa usa ka node gamit ang nmp command. Bisan pa, adunay pipila nga mga limitasyon tungod kay ang mga Advantech nga mga router mga naka-embed nga aparato nga wala’y bug-os nga Linux OS ug adunay espesyal nga hardware. Mahimo nimong i-install ang nmp Router App sa router ug gamiton kini sa kasagaran nga paagi, o pag-andam sa mga node nga adunay npm tool sa imong PC ug dayon kopyaha kini sa router. Apan dili posible nga i-install ang tanan nga mga node nga imong makit-an sa npm repository.
Para sa dugang detalye tan-awa: Router Apps – Cellular Router Engineering Portal (advantech.cz)sa kapitulo 4.5 sa Node-RED Application Note.

Router Node

Kini nga bahin sa dokumento gipahinungod labi na sa mga programmer.
Ang node sa router (ginganlan og "router") naghatag og access sa piho nga mga function ug hardware sa router. Mahimo nimong i-load ang Node.js node sa imong code pinaagi sa require("router"), alang sa example: Atong gamiton ang r variable gikan niini nga examparon ma-access ang tanan nga mga kabtangan sa sunod nga examples niini nga mga nota.
Simple Example sa Paggamit sa Node sa Router
Sa sunod nga numero mao ang usa ka example sa pagkarga sa Node.js node.3.1 Mga Property sa Node
3.1.1 Ngalan sa produkto
Read-only string variable nga puno sa ngalan sa produkto sa router. Exampsa paggamit:3.1.2 modelo sa produkto
Read-only string variable nga puno sa indikasyon sa modelo sa router. Exampsa paggamit:3.1.3 produktoRebisyon
Read-only string nga variable nga puno sa numero sa rebisyon sa produkto sa router. Exampsa paggamit:Output: 1.0
3.1.4 platapormaCode
Read-only string variable nga puno sa code sa plataporma sa router. Gisuportahan kini sa mga routers sa v3 ug v4 production patform. Exampsa paggamit:Output: V3
3.1.5 serialNumber
Read-only string variable nga puno sa serial number sa router. Exampsa paggamit:Output: ACZ1100000322054
3.1.6 firmware Bersyon
Read-only string variable nga puno sa bersyon sa firmware sa router. Exampsa paggamit:Output: 6.2.1 (2019-10-16)
3.1.7 RTCBBateryaOK
Read-only boolean variable nga puno sa RTC battery state sa router. Ang tinuod nagpasabut nga OK, ang bakak nagpasabut nga dili maayo.
Exampsa paggamit:Output: tinuod
3.1.8 PowerSupply
Read-only decimal number variable nga puno sa power supply voltage. Exampsa paggamit:Output: 11.701 V
3.1.9 nga temperatura
Read-only integer number variable nga puno sa internal nga temperatura sa router sa Celsius degrees. Exampsa paggamit:Output: 39 °C
3.1.1 0usrLED
Isulat lang ang boolean nga variable para sa control nga "USR" LED sa router. Exampsa paggamit:Gibutang ang USR LED sa ON (suga).
3.1.11 bIn
Read-only array nga adunay mga value sa binary inputs sa router. Ang Array adunay mga butang nga may kalabutan sa gidaghanon sa mga binary input. E.g. ang router adunay BIN0 ug BIN1 mao nga ang array adunay balido nga mga indeks 0 ug 1. Ang array nga mga butang mahimong adunay mga bili 0 o 1. Exampsa paggamit:Output: Ang ikaduha nga binary input: 0
3.1.12 bout
Array nga may kalabutan sa binary nga mga output sa router. Susama kini sa B_IN apan mahimo usab nimo isulat ang mga kantidad. Gisulat nga bili nagbag-o nga kahimtang sa output. Exampsa paggamit:3.1.13 XBus
Bagay alang sa pagtrabaho sa X Bus. Ang X Bus usa ka proprietary bus alang sa komunikasyon tali sa mga proseso. E.g.
mahimo ka mag-subscribe sa mga impormasyon kung unsang network interface ang mosaka/kanaog o SMS gikan sa usa ka mwan daemon. Mahimo ka usab magpadala / mag-subscribe sa imong kaugalingon nga mga hilisgutan tali sa imong mga aplikasyon.Nagpadala sa hangyo sa pagbantay sa sistema aron tan-awon ang imong "myapp" nga aplikasyon. Ang aplikasyon kinahanglan nga ipadala kini nga mensahe nga regular nga dili ulahi ang panahon nga gihubit sa miaging mensahe (300 s sa kini nga example). Ang timeout 0 mihunong sa pagtan-aw.Output:XBus.read(topic)
Basaha ang gitipigan nga mensahe gikan sa XBus. Exampsa paggamit:3.1.1 4konfigurasyon
Ang butang nga adunay sulud nga configuration sa router. Makabasa ang user sa usa ka butang sa pag-configure pinaagi sa pagkuha sa usa ka butang nga kabtangan ug pagsulat sa usa ka butang sa pag-configure pinaagi sa pagbutang sa usa ka butang nga kabtangan. Ang mga yawe sa butang parehas sa mga yawe sa pag-configure sama sa setting files. Posible nga pangitaon ang gihangyo nga yawe nga ngalan sa may kalabutan nga setting file. Ang mga configuration sa firmware gibutang sa /etc/settings.* files. Ang configuration sa Router App gibutang sa/opt/*/etc/settings files. Ang Router Report (Web UI: Status / System Log / Save Report) adunay kompleto nga lista sa kasamtangan nga configuration ug mahimo nga kini ang pinakasayon ​​​​nga paagi unsaon pagpangita sa gihangyo nga configuration key.
Kung ang usa ka gihatag nga yawe wala maglungtad usa ka gibasa nga kantidad dili matino ug usa ka sinulat nga kantidad hinungdan sa eksepsiyon (sa estrikto nga paagi). Dili posible nga magdugang ug bag-ong wala na nga butang sa pag-configure, aron lang usbon ang naa na. Ang tanan nga mga kantidad sa pag-configure giisip nga mga string. Kung ang user kinahanglan nga magtrabaho sa usa ka lahi nga tipo kinahanglan niya nga i-convert kini sa iyang kaugalingon. Ang node wala maghimo sa bisan unsang pag-validate sa kantidad. Ang tiggamit ang responsable sa pagpadala sa husto nga mga kantidad. Examples:Para sa WIFI_AP_SSID=ROUTER_AP sa /etc/settings.wifi_ap (o hinoon sa SSID field sa WiFi • Access Point 1 nga porma) ang output mao ang:Usa ka exampunsaon pag set ug configuration value:Gibag-o ang mga IP address sa interface sa eth0
NOTA: Usa ka bag-ong configuration ang gisulat lamang. Kung gusto sa user nga magamit kini sa nagdagan nga palibot nga i-restart ang router o kinahanglan ang may kalabutan nga serbisyo. Kay exampsa ibabaw posible nga gamiton ang mosunod nga shell command:

May Kalabutan nga mga Dokumento

1. Router apps: icr.advantech.cz/user-modules
2. JS Foundation: https://nodered.org/

Makuha nimo ang mga dokumento nga may kalabotan sa produkto sa Engineering Portal sa icr.advantech.cz adres.
Aron makuha ang Quick Start Guide sa imong router, User Manual, Configuration Manual, o Firmware adto sa Mga Modelo sa Router panid, pangitaa ang gikinahanglan nga modelo, ug ibalhin sa tab nga Manuals o Firmware, matag usa.
Ang mga pakete ug manwal sa pag-instalar sa Router Apps anaa sa Mga Aplikasyon sa Router panid.
Para sa Mga Dokumento sa Pag-uswag, adto sa DevZone panid.

Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Czech Republic
Dokumento Num. APP-0080-EN, rebisyon gikan sa ika-12 sa Oktubre, 2023.

Mga Dokumento / Mga Kapanguhaan

ADVANTECH Node.js Router App [pdf] Giya sa Gumagamit Node.js Router App, Node.js, Router App, App

Mga pakisayran

• Manwal sa Gumagamit