Guía del usuario de la aplicación de enrutador ADVANTECH Node.js

Node.js
Guía del usuarioAplicación de enrutador Node.js

Aplicación de enrutador Node.js

© 2023 Advantech Czech sro Ninguna parte de esta publicación puede reproducirse ni transmitirse de ninguna forma ni por ningún medio, electrónico o mecánico, incluida la fotografía, la grabación o cualquier sistema de almacenamiento y recuperación de información, sin el consentimiento por escrito.
La información contenida en este manual está sujeta a cambios sin previo aviso y no representa un compromiso por parte de Advantech.
Advantech Czech sro no será responsable de daños incidentales o consecuentes que resulten del suministro, rendimiento o uso de este manual.
Todas las marcas comerciales utilizadas en este manual son marcas comerciales registradas de sus respectivos propietarios. El uso de marcas comerciales u otras designaciones en esta publicación se hace únicamente con fines de referencia y no constituye un respaldo por parte del titular de la marca comercial.
Símbolos usados

	Peligro: información sobre la seguridad del usuario o posibles daños al enrutador.
	Atención – Problemas que pueden surgir en situaciones específicas.
	Información – Consejos útiles o información de especial interés.
	Example - Example de función, comando o script.

Registro de cambios

1.1 Registro de cambios de Node.js
v1.0.0 (2017 de julio de 10)

• Primer lanzamiento.
  v1.1.0 (2017 de julio de 11)
• Actualizado a Node.js 8.9.1.
  v1.2.0 (2018 de julio de 02)
• Se agregó soporte para iniciar sesión en file con rotación.
  v1.2.1 (2018 de julio de 08)
• Actualizado a Node.js 8.11.1.
  v2.0.0 (2020 de julio de 02)
• Actualizado a Node.js 10.15.3 y ffi 2.3.0.
• Nodos de instalación optimizados files para reducir el tamaño.
• Preparado para el nuevo GCC 7.4.
• Preparado para el nuevo kernel 4.14.
• Preparado para plataforma V4.
• Se agregó el nodo personalizado "enrutador".
• Establezca una ruta predeterminada para buscar nodos en /usr/lib/node_modules.
  v2.1.0 (2021 de julio de 05)
• Actualizado a Node.js 10.23.1.
• Se movió la información de la licencia del módulo Node-RED.
  v16.14.2 (2022 de julio de 03)
• Actualizado a Node.js 16.14.2 con npm 8.5.0.
  v16.15.0 (2022 de julio de 05)
• Se agregó un objeto para trabajar con la configuración del enrutador al nodo del enrutador.
• Actualizado a Node.js 16.15.0 con npm 8.5.5.
• Inicio de sesión fijo en FW 6.3.5.
  v16.17.0 (2022 de julio de 08)
• Actualizado a Node.js 16.17.0 con npm 8.15.0.
• Se agregó la propiedad productModel al nodo del enrutador.
  v18.15.0 (2023 de julio de 04)
• Actualizado a Node.js 18.15.0 con npm 9.5.0.
• Se eliminó el nodo inútil obsoleto "cuando".

Aplicación de enrutador Node.js

La aplicación de enrutador Node.js no está contenida en el firmware estándar del enrutador. La carga de esta aplicación de enrutador se describe en el manual de configuración (consulte el capítulo Documentos relacionados). ¡Esta aplicación de enrutador solo es compatible con enrutadores de plataforma v3 y v4!

2.1 Introducción

El nodo Node.js es un nodo de entorno de ejecución de JavaScript del lado del servidor propietario disponible para enrutadores celulares Advantech. Este nodo lo utilizan los módulos de Advantech escritos en JavaScript, pero puede ser utilizado por cualquier otra aplicación JavaScript de terceros para la administración y el mantenimiento de enrutadores.
El módulo de enrutador contiene estos nodos además de los nodos integrados:

• node-authenticate-pam: autenticación PAM asíncrona para NodeJS,
• Nodo enrutador: un nodo propietario de los enrutadores celulares de Advantech que se describen en detalle en este documento.

2.2Construyendo los nodos personalizados
Una forma oficial de construir e instalar un nodo es mediante el comando nmp. Sin embargo, existen algunas limitaciones, ya que los enrutadores Advantech son dispositivos integrados sin un sistema operativo Linux completo y con hardware especializado. Puede instalar la aplicación nmp Router en el enrutador y usarla de la manera habitual, o preparar nodos con la herramienta npm en su PC y luego copiarlos al enrutador. Pero no es posible instalar todos los nodos que puedes encontrar en el repositorio npm.
Para más detalles véase: Aplicaciones de enrutador: portal de ingeniería de enrutadores celulares (advantech.cz)en el capítulo 4.5 de la Nota de aplicación de Node-RED.

Nodo de enrutador

Esta parte del documento está dedicada especialmente a los programadores.
El nodo enrutador (denominado "enrutador") proporciona acceso a funciones y hardware específicos del enrutador. Puede cargar el nodo Node.js en su código mediante require(“enrutador”), por ejemploampen: Usaremos la variable r de este example para acceder a todas las propiedades en el siguiente examparchivos en estas notas.
Simple example de uso del nodo del enrutador
En la siguiente figura hay un ex.amparchivo de carga del nodo Node.js.3.1 Propiedades del nodo
3.1.1 nombre del producto
Variable de cadena de solo lectura cargada con el nombre del producto del enrutador. Example de uso:3.1.2 modelo de producto
Variable de cadena de solo lectura cargada con la indicación del modelo del enrutador. Example de uso:3.1.3 Revisión del producto
Variable de cadena de solo lectura cargada con el número de revisión del producto del enrutador. Example de uso:Salida: 1.0
3.1.4 Código de plataforma
Variable de cadena de solo lectura cargada con el código de plataforma del enrutador. Es compatible con enrutadores de plataforma de producción v3 y v4. Example de uso:Salida: V3
3.1.5 número de serie
Variable de cadena de solo lectura cargada con el número de serie del enrutador. Example de uso:Salida: ACZ1100000322054
3.1.6 Versión de firmware
Variable de cadena de solo lectura cargada con la versión de firmware del enrutador. Example de uso:Salida: 6.2.1 (2019-10-16)
3.1.7 Batería RTC OK
Variable booleana de solo lectura cargada con el estado de la batería RTC del enrutador. Verdadero significa OK, falso significa malo.
Example de uso:Salida: verdadero
3.1.8 fuente de alimentación
Variable de número decimal de solo lectura cargada con la fuente de alimentación del enrutador voltagmi. Example de uso:Salida: 11.701 V
3.1.9 temperaturas
Variable de número entero de solo lectura cargada con la temperatura interna del enrutador en grados Celsius. Example de uso:Salida: 39 °C
3.1.1 0usrLED
Variable booleana de solo escritura para el LED “USR” del enrutador de control. Example de uso:Establece el LED USR en ON (iluminación).
3.1.11 bIn
Matriz de solo lectura con valores en las entradas binarias del enrutador. La matriz tiene los elementos relacionados con el número de entradas binarias. Por ejemplo, el enrutador tiene BIN0 y BIN1, por lo que la matriz tiene índices válidos 0 y 1. Los elementos de la matriz pueden tener valores 0 o 1. Ej.ample de uso:Salida: La entrada binaria secundaria: 0
3.1.12 bFuera
Matriz relacionada con las salidas binarias del enrutador. Es similar a B_IN pero también puedes escribir valores. Estado de salida de cambio de valor escrito. Example de uso:3.1.13 XBus
Objeto para trabajar con X Bus. X Bus es un bus propietario para la comunicación entre procesos. P.ej
Puede suscribirse a información sobre qué interfaz de red sube o baja o SMS desde un demonio mwan. También puedes enviar/suscribir tus propios temas entre tus aplicaciones.Envía al sistema una solicitud de vigilancia para observar su aplicación "myapp". La aplicación debe enviar este mensaje periódicamente a más tardar en el período definido en el mensaje anterior (300 s en este ejemplo).ample). Timeout 0 deja de mirar.Producción:XBus.read (tema)
Leer mensaje almacenado de XBus. Example de uso:3.1.1 4 configuración
Objeto que contiene la configuración del enrutador. El usuario puede leer un elemento de configuración obteniendo una propiedad de objeto y escribir un elemento de configuración estableciendo una propiedad de objeto. Las claves de objeto son las mismas que las claves de configuración como en la configuración files. Es posible buscar un nombre de clave solicitado en la configuración relacionada file. Las configuraciones del firmware se encuentran en /etc/settings.* files. La configuración de la aplicación del enrutador se coloca en/opt/*/etc/settings files. El informe del enrutador (Web UI: Estado/Registro del sistema/Guardar informe) contiene una lista completa de la configuración actual y puede ser la forma más sencilla de encontrar la clave de configuración solicitada.
Si una clave determinada no existe, un valor leído no está definido y un valor escrito causa una excepción (en modo estricto). No es posible agregar un nuevo elemento de configuración no existente, sólo modificar uno existente. Todos los valores de configuración se tratan como cadenas. Si el usuario necesita trabajar con un tipo diferente, debe convertirlo él mismo. Node no realiza ninguna validación de valores. El usuario es responsable de enviar los valores correctos. Exampellos:Para WIFI_AP_SSID=ROUTER_AP en /etc/settings.wifi_ap (o más bien en el campo SSID en el formulario WiFi • Punto de acceso 1) la salida será:Un example cómo establecer un valor de configuración:Cambia las direcciones IP en la interfaz eth0
NOTA: Sólo se escribe una nueva configuración. Si el usuario desea que se aplique al entorno en ejecución, es necesario reiniciar el enrutador o el servicio relacionado. por ejemploamparchivo anterior es posible utilizar el siguiente comando de shell:

Documentos relacionados

1. Aplicaciones de enrutador: icr.advantech.cz/user-modules
2. Fundación JS: https://nodered.org/

Puede obtener documentos relacionados con el producto en el Portal de ingeniería en icr.advantech.cz DIRECCIÓN.
Para obtener la Guía de inicio rápido, el Manual de usuario, el Manual de configuración o el firmware de su enrutador, vaya a Modelos de enrutador , busque el modelo requerido y cambie a la pestaña Manuales o Firmware, respectivamente.
Los paquetes y manuales de instalación de Router Apps están disponibles en Aplicaciones de enrutador página.
Para los Documentos de Desarrollo, vaya a la Zona de desarrollo página.

Advantech Czech sro, Sokolska 71, 562 04 Usti nad Orlici, República Checa
Documento No. APP-0080-EN, revisión del 12 de octubre de 2023.