ADVANTECH Node.js Router App Brukerveiledning

Node.js
BrukerveiledningNode.js ruter-app

Node.js ruter-app

© 2023 Advantech Czech sro Ingen deler av denne publikasjonen kan reproduseres eller overføres i noen form eller på noen måte, elektronisk eller mekanisk, inkludert fotografering, opptak eller noe system for lagring og gjenfinning av informasjon uten skriftlig samtykke.
Informasjonen i denne håndboken kan endres uten varsel, og den representerer ingen forpliktelse fra Advantechs side.
Advantech Czech sro skal ikke holdes ansvarlig for tilfeldige skader eller følgeskader som følge av innredning, ytelse eller bruk av denne håndboken.
Alle merkenavn som brukes i denne håndboken er registrerte varemerker for deres respektive eiere. Bruken av varemerker eller andre betegnelser i denne publikasjonen er kun for referanseformål og utgjør ikke en godkjenning fra varemerkeinnehaveren.
Brukte symboler

	Fare – Informasjon om brukersikkerhet eller potensiell skade på ruteren.
	Oppmerksomhet – Problemer som kan oppstå i spesifikke situasjoner.
	Informasjon – Nyttige tips eller informasjon av spesiell interesse.
	Example – Eksample av funksjon, kommando eller skript.

Endringslogg

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

• Første utgivelse.
  v1.1.0 (2017-11-08)
• Oppdatert til Node.js 8.9.1.
  v1.2.0 (2018-02-18)
• Lagt til støtte for logging til file med roterende.
  v1.2.1 (2018-08-10)
• Oppdatert til Node.js 8.11.1.
  v2.0.0 (2020-02-21)
• Oppdatert til Node.js 10.15.3 og ffi 2.3.0.
• Optimaliserte installasjonsnoder files for å redusere størrelsen.
• Forberedt for ny GCC 7.4.
• Forberedt for ny kjerne 4.14.
• Forberedt for V4-plattform.
• Lagt til den tilpassede noden "ruteren".
• Angi en standardbane for å søke noder til /usr/lib/node_modules.
  v2.1.0 (2021-05-06)
• Oppdatert til Node.js 10.23.1.
• Flyttet lisensinformasjon fra Node-RED-modulen.
  v16.14.2 (2022-03-18)
• Oppdatert til Node.js 16.14.2 med npm 8.5.0.
  v16.15.0 (2022-05-10)
• Lagt til et objekt for å jobbe med ruterkonfigurasjonen til ruternoden.
• Oppdatert til Node.js 16.15.0 med npm 8.5.5.
• Fast pålogging på FW 6.3.5.
  v16.17.0 (2022-08-25)
• Oppdatert til Node.js 16.17.0 med npm 8.15.0.
• Lagt til egenskapsproduktmodell til ruternoden.
  v18.15.0 (2023-04-06)
• Oppdatert til Node.js 18.15.0 med npm 9.5.0.
• Fjernet foreldet ubrukelig node "når".

Node.js ruter-app

Ruter-appen Node.js er ikke inkludert i standard ruterfastvaren. Opplasting av denne ruterappen er beskrevet i konfigurasjonshåndboken (se kapittelrelaterte dokumenter). Denne ruterappen er kun kompatibel med v3- og v4-plattformrutere!

2.1 Introduksjon

Node.js-noden er en proprietær JavaScript-runtime-miljønode på serversiden tilgjengelig for Advantech mobilrutere. Denne noden brukes av Advantech-moduler skrevet i JavaScript, men kan brukes av enhver annen tredjeparts JavaScript-applikasjon for ruteradministrasjon og vedlikehold.
Rutermodulen inneholder dette nodetillegget til innebygde noder:

• node-authenticate-pam – asynkron PAM-autentisering for NodeJS,
• router node – en proprietær node for Advantechs mobilrutere beskrevet i dette dokumentet i detalj.

2.2 Bygge tilpassede noder
En offisiell måte å bygge og installere en node på er å bruke nmp-kommandoen. Imidlertid er det noen begrensninger ettersom Advantech-rutere er innebygde enheter uten et fullt Linux OS og med spesialisert maskinvare. Du kan installere nmp Router App til ruteren og bruke den på vanlig måte, eller klargjøre noder med npm-verktøyet på din PC og deretter kopiere dem til ruteren. Men det er ikke mulig å installere alle noder du kan finne i npm-depotet.
For mer informasjon se: Ruterapper – ingeniørportal for mobilrutere (advantech.cz)i kapittel 4.5 i Node-RED Application Note.

Ruter Node

Denne delen av dokumentet er dedikert spesielt til programmerere.
Ruternode (kalt "ruter") gir tilgang til ruterspesifikke funksjoner og maskinvare. Du kan laste inn Node.js-noden i koden din ved å kreve ("ruter"), for eksempelampde: Vi vil bruke r-variabelen fra denne eksample for å få tilgang til alle eiendommene i neste eksamples i disse notatene.
Enkelt eksample av ruternodebruk
I neste figur er en eksamplesing av Node.js-noden.3.1 Nodeegenskaper
3.1.1 produktnavn
Skrivebeskyttet strengvariabel lastet med ruterens produktnavn. Eksampbruksområde:3.1.2 produktmodell
Skrivebeskyttet strengvariabel lastet med ruterens modellindikasjon. Eksampbruksområde:3.1.3 produktRevisjon
Skrivebeskyttet strengvariabel lastet med ruterens produktrevisjonsnummer. Eksampbruksområde:Utgang: 1.0
3.1.4 plattformkode
Skrivebeskyttet strengvariabel lastet med ruterens plattformkode. Den støttes av rutere av v3 og v4 produksjonspatform. Eksampbruksområde:Utgang: V3
3.1.5 serienummer
Skrivebeskyttet strengvariabel lastet med ruterens serienummer. Eksampbruksområde:Utgang: ACZ1100000322054
3.1.6 fastvareversjon
Skrivebeskyttet strengvariabel lastet med ruterens fastvareversjon. Eksampbruksområde:Utdata: 6.2.1 (2019-10-16)
3.1.7 RTCBatteryOK
Skrivebeskyttet boolsk variabel lastet med ruterens RTC-batteristatus. Sant betyr OK, usant betyr dårlig.
Exampbruksområde:Utgang: sant
3.1.8 strømforsyning
Skrivebeskyttet desimalnummervariabel lastet med ruterens strømforsyning voltage. Eksampbruksområde:Utgang: 11.701 V.
3.1.9 temperatur
Skrivebeskyttet heltallsvariabel lastet med ruterens interne temperatur i Celsius-grader. Eksampbruksområde:Utgang: 39 °C
3.1.1 0usrLED
Bare skrivebar boolsk variabel for kontrollruterens "USR" LED. Eksampbruksområde:Setter USR LED til PÅ (belysning).
3.1.11 bIn
Skrivebeskyttet matrise med verdier på ruterens binære innganger. Array har elementene relatert til antall binære innganger. Ruteren har for eksempel BIN0 og BIN1, så matrisen har gyldige indekser 0 og 1. Matriseelementene kan ha verdiene 0 eller 1. Eks.ampbruksområde:Utgang: Den sekundære binære inngangen: 0
3.1.12 ut
Array relatert til ruterens binære utganger. Det ligner på B_IN, men du kan også skrive verdier. Skrevet verdi endre utgangstilstand. Eksampbruksområde:3.1.13 XBus
Objekt for arbeid med X Bus. X Bus er en proprietær buss for kommunikasjon mellom prosesser. F.eks
du kan abonnere på informasjon om hvilket nettverksgrensesnitt som går opp/ned eller SMS fra en mwan-demon. Du kan også sende/abonnere på dine egne emner mellom søknadene dine.Sender til systemets overvåkingsforespørsel for å se "minapp"-applikasjonen din. Søknaden må sende denne meldingen regelmessig ikke senere enn perioden definert i forrige melding (300 s i denne eksample). Timeout 0 slutter å se.Produksjon:XBus.read(topic)
Les lagret melding fra XBus. Eksampbruksområde:3.1.1 4konfigurasjon
Objekt som inneholder ruterkonfigurasjonen. Brukeren kan lese et konfigurasjonselement ved å få en objektegenskap og skrive et konfigurasjonselement ved å angi en objektegenskap. Objektnøklene er de samme som konfigurasjonsnøkler som i innstillingen files. Det er mulig å se etter et forespurt nøkkelnavn i relaterte innstillinger file. Fastvarekonfigurasjonene er plassert i /etc/settings.* files. Ruter-appens konfigurasjon er plassert i/opt/*/etc/settings files. Ruterrapporten (Web UI: Status / System Log / Save Report) inneholder en fullstendig liste over gjeldende konfigurasjon og kan være den enkleste måten å finne den forespurte konfigurasjonsnøkkelen på.
Hvis en gitt nøkkel ikke eksisterer, er en leseverdi udefinert og en skrevet verdi forårsaker unntak (i ​​streng modus). Det er ikke mulig å legge til et nytt ikke-eksisterende konfigurasjonselement, kun for å endre et eksisterende. Alle konfigurasjonsverdier behandles som strenger. Hvis brukeren trenger å jobbe med en annen type, må han konvertere den selv. Node utfører ingen verdivalidering. Brukeren er ansvarlig for å sende riktige verdier. Eksamples:For WIFI_AP_SSID=ROUTER_AP i /etc/settings.wifi_ap (eller rettere sagt i SSID-feltet i WiFi • Access Point 1-skjemaet) vil utdata være:En eksamples hvordan du angir en konfigurasjonsverdi:Endrer IP-adressene på eth0-grensesnittet
NOTE: En ny konfigurasjon skrives bare. Hvis brukeren vil at det skal gjelde for kjøremiljøet, er det nødvendig å starte ruteren på nytt eller den relaterte tjenesten. For eksample ovenfor er det mulig å bruke følgende skallkommando:

Relaterte dokumenter

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

Du kan få produktrelaterte dokumenter på Engineering Portal på icr.advantech.cz adresse.
For å få ruterens hurtigstartveiledning, brukerhåndbok, konfigurasjonshåndbok eller fastvare, gå til Rutermodeller siden, finn den nødvendige modellen og bytt til henholdsvis fanen Manuals eller Firmware.
Installasjonspakkene og manualene for ruterapper er tilgjengelige på Ruter-apper side.
For utviklingsdokumentene, gå til DevZone side.

Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Tsjekkia
Dokument nr. APP-0080-EN, revisjon fra 12. oktober 2023.