Node.js
Кіраўніцтва карыстальніка
Прыкладанне маршрутызатара Node.js
Прыкладанне маршрутызатара Node.js
© 2023 Advantech Czech sro Ніякая частка гэтай публікацыі не можа быць прайграная або перададзена ў любой форме або любымі сродкамі, электроннымі або механічнымі, уключаючы фатаграфію, запіс або любую сістэму захоўвання і пошуку інфармацыі без пісьмовай згоды.
Інфармацыя ў гэтым кіраўніцтве можа быць зменена без папярэдняга паведамлення і не з'яўляецца абавязацельствам з боку Advantech.
Кампанія Advantech Czech sro не нясе адказнасці за выпадковыя або ўскосныя пашкоджанні ў выніку размяшчэння, выканання або выкарыстання гэтага кіраўніцтва.
Усе гандлёвыя маркі, якія выкарыстоўваюцца ў гэтым кіраўніцтве, з'яўляюцца зарэгістраванымі гандлёвымі маркамі іх адпаведных уладальнікаў. Выкарыстанне таварных знакаў або іншых абазначэнняў у гэтай публікацыі прызначана толькі ў даведачных мэтах і не з'яўляецца адабрэннем уладальнікам таварнага знака.
Выкарыстоўваная сімволіка
 |
Небяспека – інфармацыя аб бяспецы карыстальніка або патэнцыйным пашкоджанні маршрутызатара. |
 |
Увага - Праблемы, якія могуць узнікнуць у канкрэтных сітуацыях. |
 |
Інфармацыя – Карысныя парады або асабліва цікавая інфармацыя. |
 |
Example – Выклampфайл функцыі, каманды або сцэнара. |
Журнал змяненняў
1.1 Журнал змяненняў Node.js
v1.0.0 (2017-10-02)
- Першы выпуск.
v1.1.0 (2017-11-08) - Абноўлены да Node.js 8.9.1.
v1.2.0 (2018-02-18) - Дададзена падтрымка ўваходу ў file з верціцца.
v1.2.1 (2018-08-10) - Абноўлены да Node.js 8.11.1.
v2.0.0 (2020-02-21) - Абноўлены да Node.js 10.15.3 і ffi 2.3.0.
- Аптымізаваныя вузлы ўстаноўкі files, каб паменшыць памер.
- Падрыхтавана для новай версіі GCC 7.4.
- Падрыхтавана для новага ядра 4.14.
- Падрыхтавана для платформы V4.
- Дададзены карыстальніцкі вузел «маршрутызатар».
- Усталюйце стандартны шлях для пошуку вузлоў у /usr/lib/node_modules.
v2.1.0 (2021-05-06) - Абноўлены да Node.js 10.23.1.
- Інфармацыя аб ліцэнзіі перанесена з модуля Node-RED.
v16.14.2 (2022-03-18) - Абноўлены да Node.js 16.14.2 з npm 8.5.0.
v16.15.0 (2022-05-10) - У вузел маршрутызатара дададзены аб'ект для працы з канфігурацыяй маршрутызатара.
- Абноўлены да Node.js 16.15.0 з npm 8.5.5.
- Выпраўлены ўваход у FW 6.3.5.
v16.17.0 (2022-08-25) - Абноўлены да Node.js 16.17.0 з npm 8.15.0.
- У вузел маршрутызатара дададзена ўласцівасць productModel.
v18.15.0 (2023-04-06) - Абноўлены да Node.js 18.15.0 з npm 9.5.0.
- Выдалены састарэлы бескарысны вузел «калі».
Прыкладанне маршрутызатара Node.js
Прыкладанне для маршрутызатара Node.js не змяшчаецца ў стандартнай прашыўцы маршрутызатара. Загрузка гэтага прыкладання маршрутызатара апісана ў кіраўніцтве па канфігурацыі (гл. дакументы, звязаныя з раздзелам). Гэта дадатак для маршрутызатара сумяшчальна толькі з маршрутызатарамі на платформах v3 і v4!
2.1 Уводзіны
Вузел Node.js - гэта прапрыетарны серверны вузел асяроддзя выканання JavaScript, даступны для сотавых маршрутызатараў Advantech. Гэты вузел выкарыстоўваецца модулямі Advantech, напісанымі на JavaScript, але можа выкарыстоўвацца любым іншым дадаткам JavaScript трэцяга боку для адміністравання і абслугоўвання маршрутызатараў.
Модуль маршрутызатара змяшчае наступныя вузлы ў дадатак да ўбудаваных вузлоў:
- node-authenticate-pam - асінхронная аўтэнтыфікацыя PAM для NodeJS,
- вузел маршрутызатара - прапрыетарны вузел для сотавых маршрутызатараў Advantech, падрабязна апісаных у гэтым дакуменце.
2.2 Стварэнне карыстацкіх вузлоў
Афіцыйны спосаб стварэння і ўстаноўкі вузла - гэта выкарыстанне каманды nmp. Аднак ёсць некаторыя абмежаванні, паколькі маршрутызатары Advantech з'яўляюцца ўбудаванымі прыладамі без поўнай АС Linux і са спецыялізаваным абсталяваннем. Вы можаце ўсталяваць прыкладанне nmp Router на маршрутызатар і выкарыстоўваць яго звычайным спосабам або падрыхтаваць вузлы з дапамогай інструмента npm на вашым ПК, а затым скапіяваць іх на маршрутызатар. Але немагчыма ўсталяваць усе вузлы, якія можна знайсці ў рэпазітары npm.
Для больш падрабязнай інфармацыі глядзіце: Прыкладанні для маршрутызатараў – Інжынерны партал сотавых маршрутызатараў (advantech.cz)у главе 4.5 Node-RED Application Note.
Вузел маршрутызатара
Гэтая частка дакумента спецыяльна прысвечана праграмістам.
Вузел маршрутызатара (пад назвай «маршрутызатар») забяспечвае доступ да спецыфічных функцый і абсталявання маршрутызатара. Вы можаце загрузіць вузел Node.js у свой код патрабаваннем (“маршрутызатар”), напрыкладampль:
Мы будзем выкарыстоўваць зменную r з гэтага прыкладуample, каб атрымаць доступ да ўсіх уласцівасцей у наступным экзampу гэтых нататках.
Просты Exampвыкарыстанне вузла маршрутызатара
На наступным малюнку эксampзагрузка вузла Node.js.
3.1 Уласцівасці вузла
3.1.1 назва прадукту
Радковая зменная толькі для чытання, загружаная з назвай прадукту маршрутызатара. напрыкладampвыкарыстанне:
3.1.2 мадэль прадукту
Радковая зменная толькі для чытання, загружаная з указаннем мадэлі маршрутызатара. напрыкладampвыкарыстанне:
3.1.3 Рэвізія прадукту
Радковая зменная толькі для чытання, загружаная з нумарам версіі прадукту маршрутызатара. напрыкладampвыкарыстанне:
Выхад: 1.0
3.1.4 код платформы
Радковая зменная толькі для чытання, загружаная з кодам платформы маршрутызатара. Ён падтрымліваецца маршрутызатарамі вытворчасці v3 і v4. напрыкладampвыкарыстанне:
Выхад: V3
3.1.5 серыйны нумар
Радковая зменная толькі для чытання, загружаная з серыйным нумарам маршрутызатара. напрыкладampвыкарыстанне:
Выхад: ACZ1100000322054
3.1.6 версія прашыўкі
Радковая зменная толькі для чытання, загружаная з версіяй прашыўкі маршрутызатара. напрыкладampвыкарыстанне:
Выхад: 6.2.1 (2019-10-16)
3.1.7 RTCBatteryOK
Лагічная зменная толькі для чытання, загружаная з інфармацыяй аб стане батарэі RTC маршрутызатара. Праўда азначае добра, ілжыва азначае дрэнна.
Exampвыкарыстанне:
Вывад: праўда
3.1.8 Крыніца харчавання
Зменная дзесятковага ліку, даступная толькі для чытання, загружаная з блокам харчавання маршрутызатара voltage. Прampвыкарыстанне:
Выхад: 11.701 В.
3.1.9 тэмпература
Цэлая лікавая зменная толькі для чытання, у якую загружаецца ўнутраная тэмпература маршрутызатара ў градусах Цэльсія. напрыкладampвыкарыстанне:
Выхад: 39 °C
3.1.1 0usrLED
Лагічная зменная толькі для запісу для святлодыёда «USR» кіравання маршрутызатарам. напрыкладampвыкарыстанне:
Ўключае святлодыёд USR (асвятленне).
3.1.11 бІн
Масіў толькі для чытання са значэннямі на бінарных уваходах маршрутызатара. У масіве ёсць элементы, звязаныя з колькасцю двайковых уваходаў. напрыклад маршрутызатар мае BIN0 і BIN1, таму масіў мае дапушчальныя індэксы 0 і 1. Элементы масіва могуць мець значэнні 0 або 1. Напрыкладampвыкарыстанне:
Выхад: другасны двайковы ўваход: 0
3.1.12 выйдзе
Масіў, звязаны з бінарнымі выхадамі маршрутызатара. Ён падобны на B_IN, але вы таксама можаце запісваць значэнні. Запісанае значэнне змяняе стан вываду. напрыкладampвыкарыстанне:
3.1.13 XBus
Аб'ект для працы з X Bus. X Bus - гэта ўласная шына для сувязі паміж працэсамі. напрыклад
вы можаце падпісацца на інфармацыю аб тым, які сеткавы інтэрфейс уверх/уніз або SMS ад дэмана mwan. Вы таксама можаце адпраўляць/падпісвацца на ўласныя тэмы паміж вашымі праграмамі.
Адпраўляе ў сістэмны запыт назірання за вашым дадаткам «myapp». Прыкладанне павінна адпраўляць гэта паведамленне рэгулярна не пазней за перыяд, вызначаны ў папярэднім паведамленні (300 с у гэтым прыкладзеample). Тайм-аўт 0 спыняе прагляд.
выхад:
XBus.read(тэма)
Прачытайце захаванае паведамленне з XBus. напрыкладampвыкарыстанне:
3.1.1 4канфігурацыя
Аб'ект, які змяшчае канфігурацыю маршрутызатара. Карыстальнік можа прачытаць элемент канфігурацыі, атрымаўшы ўласцівасць аб'екта, і запісаць элемент канфігурацыі, усталяваўшы ўласцівасць аб'екта. Ключы аб'ектаў такія ж, як і ключы канфігурацыі, што і ў наладзе fileс. Запытанае імя ключа можна знайсці ў адпаведнай наладзе file. Канфігурацыі прашыўкі знаходзяцца ў /etc/settings.* fileс. Канфігурацыя прыкладання маршрутызатара змяшчаецца ў /opt/*/etc/settings fileс. Справаздача маршрутызатара (Web Карыстацкі інтэрфейс: Статус / Сістэмны журнал / Захаваць справаздачу) змяшчае поўны спіс бягучай канфігурацыі і, магчыма, гэта самы просты спосаб знайсці запытаны ключ канфігурацыі.
Калі дадзены ключ не існуе, прачытанае значэнне не вызначана, а запісанае значэнне выклікае выключэнне (у строгім рэжыме). Немагчыма дадаць новы неіснуючы элемент канфігурацыі, можна толькі змяніць існуючы. Усе значэнні канфігурацыі разглядаюцца як радкі. Калі карыстачу трэба працаваць з іншым тыпам, ён павінен пераўтварыць яго самастойна. Вузел не выконвае ніякай праверкі значэнняў. Карыстальнік нясе адказнасць за адпраўку правільных значэнняў. напрыкладampлес:
Для WIFI_AP_SSID=ROUTER_AP у /etc/settings.wifi_ap (дакладней, у полі SSID у форме WiFi • Access Point 1) вывад будзе:
Былыample, як усталяваць значэнне канфігурацыі:
Змяняе IP-адрас на інтэрфейсе eth0
УВАГА: Новая канфігурацыя толькі напісана. Калі карыстальнік хоча, каб гэта прымянялася да працоўнага асяроддзя, неабходна перазапусціць маршрутызатар або адпаведную службу. Напрыкладampвышэй можна выкарыстоўваць наступную каманду абалонкі:
- Праграмы маршрутызатара: icr.advantech.cz/user-modules
- Фонд JS: https://nodered.org/
Вы можаце атрымаць дакументы, звязаныя з прадуктам, на інжынерным партале па адрасе icr.advantech.cz адрас.
Каб атрымаць Кароткае кіраўніцтва па запуску маршрутызатара, Кіраўніцтва карыстальніка, Кіраўніцтва па канфігурацыі або прашыўку, перайдзіце на Мадэлі маршрутызатараў знайдзіце патрэбную мадэль і пераключыцеся на ўкладку Manuals або Firmware адпаведна.
Пакеты ўстаноўкі і кіраўніцтва Router Apps даступныя на Прыкладання для маршрутызатара старонка.
Для атрымання дакументаў па распрацоўцы перайдзіце да DevZone старонка.
Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, Чэхія
Дакумент № APP-0080-EN, версія ад 12 кастрычніка 2023 г.
Дакументы / Рэсурсы
 |
Прыкладанне маршрутызатара ADVANTECH Node.js [pdfКіраўніцтва карыстальніка Праграма маршрутызатара Node.js, Node.js, праграма маршрутызатара, праграма |
