Configuración con WB-MGE v.3

Leer el manual completo del WB-MGE v.3, incluidos los modos actuales de los puertos, las especificaciones y las instrucciones de mantenimiento.

Instrucciones de configuración de la pasarela WB-MGE v.3, incluidas sus interfaces de red, puertos RS-485 e interfaz WB-MIO integrada para módulos laterales WBIO.

Bus de E/S: módulos laterales WBIO

Los módulos laterales funcionan a través de un WB-MIO integrado, que se presenta como dispositivo Modbus en RS485-2. Sus valores predeterminados son Dirección Modbus 247 y 9600 bit/s, 8 bits de datos, sin paridad, 2 bits de parada (8N2).

Para activarlo o desactivarlo, abra Configuration → Serial ports, localice I/O Bus tarjeta y cambie Enable I/O Bus. WB-MIO está habilitado de forma predeterminada. Deshabilítelo si necesita liberar su dirección Modbus o utilizar en RS485-2 un protocolo incompatible con Modbus RTU.

Los ajustes de comunicación de los dispositivos conectados a RS485-2 y del WB-MIO integrado deben coincidir. Si difieren, cambie los ajustes del WB-MIO escribiendo nuevos valores de registro. Puede hacerlo mediante wb-mqtt-serial en la interfaz web del controlador, con modbus_client mediante SSH mientras RS485-2 está en modo Modbus TCP, o conectándose directamente a RS485-2 mediante un convertidor WB-USB485.

Ejemplo: detenga el controlador de software, establezca la velocidad en baudios del WB-MIO y después reinicie el controlador de software:

systemctl stop wb-mqtt-serial
modbus_client --debug -mtcp -a247 -c1 -r110 -t0x06 -o300 -p503 10.42.0.176 1152
systemctl start wb-mqtt-serial

Aquí, 247 es la dirección de WB-MIO y 10.42.0.176 es la dirección IP de la pasarela. El registro 110 utiliza un multiplicador ×100: 1152 significa 115 200 bit/s.

Registros de comunicación de WB-MIO

Todos los registros siguientes son registros de mantenimiento, de lectura y escritura (RW), con valores de 16 bits sin signo (u16).

Configuración de red

El módulo puede conectarse mediante Ethernet y Wi-Fi de forma independiente o utilizar ambas conexiones simultáneamente; por ejemplo, el modo de punto de acceso Wi-Fi para la configuración inicial y Ethernet para el funcionamiento habitual.

En Configuration → Network → Ethernet, el cliente DHCP está habilitado de forma predeterminada, por lo que el router asigna la dirección IP. Para utilizar una dirección estática, deshabilite el cliente DHCP e introduzca manualmente la dirección IP, la máscara de subred y la pasarela.

En Configuration → Network → Wi-Fi, seleccione uno de estos modos:

• Access point (AP): el valor predeterminado. El módulo crea una red denominada WB-MGE-XXXXXX. Configure su SSID, contraseña, tipo de autenticación y dirección IP, máscara y pasarela.
• Client (station): se conecta a una red Wi-Fi existente. Introduzca el SSID y la contraseña de esa red y, después, seleccione DHCP o introduzca una dirección estática, una máscara y una pasarela.
• Disabled: deshabilita completamente la interfaz Wi-Fi. Más abajo se describe una opción independiente de desactivación permanente.

El firmware actual no tiene ajuste de servidor DNS. El módulo funciona en la red local utilizando direcciones IP sin resolver nombres de dominio externos.

Inicio rápido

Esta secuencia abarca un WB-MGE v.3, dispositivos RS-485 (incluidos dispositivos Fast Modbus) y un controlador en la misma red.

1. Conecte la alimentación y los bornes RS-485 A/B/GND. Mantenga habilitada la terminación si la pasarela está al final del bus; deshabilítela si está en el medio.
2. Para el acceso inicial, conéctese a la red del módulo WB-MGE-XXXXXX red Wi-Fi utilizando la contraseña de su etiqueta lateral. Abra 192.168.5.1 e inicie sesión con las credenciales predeterminadas admin / admin. Para el funcionamiento normal, conecte el módulo y el controlador a la misma red.
3. Vaya a Modbus tools → TCP gateway, seleccione la tarjeta del puerto RS-485 y establezca Mode en Modbus TCP. Los puertos TCP predeterminados son 502 para RS-485-1 y 503 para RS-485-2.
4. En Configuration → Serial ports, active la terminación solo en un extremo del bus y la polarización de seguridad solo cuando el módulo sea el maestro de ese bus. Los ajustes incorrectos suelen hacer que los dispositivos dejen de responder sin mostrar un error explícito.
5. Localice la dirección IP del módulo en Configuration → Network.
6. En la configuración de wb-mqtt-serial del controlador, añada un puerto Modbus TCP. Introduzca la dirección IP de la pasarela y el puerto TCP seleccionado anteriormente. Mantenga los tiempos predeterminados para una red local. Añada los dispositivos mediante la detección automática o manualmente, con sus identificadores de esclavo y plantillas de dispositivo.
7. Compruebe que los valores de los dispositivos aparecen en la interfaz web del controlador y en MQTT bajo /devices/.../controls/.... Si no lo hacen, compruebe la correspondencia de los puertos TCP, la terminación y la polarización de seguridad.

Interfaz web

La interfaz web de la pasarela funciona en navegadores modernos de ordenadores y dispositivos móviles. Conecte el ordenador y el módulo a la misma red mediante Wi-Fi o Ethernet. El modo de punto de acceso Wi-Fi asigna direcciones IP a los clientes automáticamente. Ethernet obtiene una dirección mediante DHCP, por ejemplo, de su rúter. Los detalles de la red también están disponibles en la consola de depuración a través del conector USB-C situado bajo la cubierta.

Acceso a través del punto de acceso Wi-Fi

1. Busque WB-MGE-XXXXXX en la lista de redes Wi-Fi de su portátil o teléfono.
2. Introduzca la clave de seguridad impresa en la etiqueta lateral del dispositivo.
3. Open 192.168.5.1; el nombre de usuario y la contraseña predeterminados son admin / admin.

Acceso mediante Ethernet

Ethernet utiliza DHCP de forma predeterminada, por lo que se requiere un router que proporcione DHCP, normalmente un router doméstico o de oficina.

1. Conecte la pasarela al router con un cable Ethernet.
2. Abra los ajustes del router y busque la dirección IP asignada a la pasarela.
3. Desde un ordenador conectado al mismo rúter, abra esa dirección en un navegador e inicie sesión con admin / admin.

Acceso mediante un puerto Ethernet del controlador

Si el módulo está en una subred diferente detrás del controlador, utilice un túnel SSH. En este ejemplo, el controlador es 192.168.42.1 y el módulo está 192.168.0.7.

En Linux/macOS con OpenSSH o en Windows PowerShell/CMD:

ssh -N -L 8088:192.168.0.7:80 root@192.168.42.1

Introduzca la contraseña del controlador cuando se le solicite; la predeterminada es wirenboard. La opción -L redirige el puerto local 8088 a 192.168.0.7:80 a través del controlador; -N impide que se ejecute un comando remoto. Si el puerto 8088 está ocupado, elija otro puerto local libre. Mantenga abierta la sesión SSH mientras utilice la interfaz web.

Con PuTTY en Windows:

1. Establezca Session → Host Name en 192.168.42.1.
2. Open Connection → SSH → Tunnels.
3. Establezca Source port en 8088 y Destination en 192.168.0.7:80.
4. Seleccione Local y, a continuación, haga clic en Add.
5. Vuelva a Session, haga clic en Open e inicie sesión como root.

Open http://127.0.0.1:8088/ en un navegador e introduzca el nombre de usuario y la contraseña de la pasarela.

Acceso mediante Wiren Board Cloud

Si WB-MGE v.3 está conectado a una de las interfaces de red del controlador y este está conectado a Wiren Board Cloud, puede configurar el acceso mediante proxy a la interfaz web de la pasarela a través de la nube.

Guardar y cargar la configuración

Exporte los parámetros configurados a un archivo para restaurarlos en otro dispositivo o reutilizarlos en instalaciones similares. El archivo incluye todos los ajustes de la interfaz web, los puertos y las interfaces de red.

Terminación y polarización de seguridad

El módulo tiene las siguientes resistencias, ambas habilitadas de forma predeterminada:

• Terminación: una resistencia de 120 Ω entre A y B. Habilítela en el extremo del bus; deshabilítela en un punto intermedio.
• Polarización de seguridad: Resistencias de polarización de 560 Ω que establecen un estado definido del bus cuando todos los transmisores están desactivados. Actívelas cuando el módulo sea el maestro; desactívelas en caso contrario.

Controle estos ajustes por software en Configuration → Serial ports, en la tarjeta del puerto correspondiente.

Desactivación de la transmisión (TX)

Disponible a partir de la versión de firmware 1.3.0.

Cada puerto RS-485 dispone de un Disable transmission (TX) interruptor en Configuration → Serial ports. Esto coloca físicamente el transceptor en modo de solo recepción: el pin de habilitación de dirección (DE) se desconecta de la UART y se mantiene inactivo. Mientras está habilitado, el software no puede transmitir al bus; los intentos de transmisión se descartan sin notificación.

Esto permite conectarse a una instalación en funcionamiento para analizar o replicar el tráfico mediante el sniffer o el multimaestro con caché, sin que una transmisión accidental perturbe el sistema. El botón Send packet del sniffer no está disponible para los puertos de solo recepción.

Deshabilitación permanente de Wi-Fi

Disponible a partir de la versión de firmware 1.3.0.

En este modo, el controlador de software Wi-Fi deja de inicializarse. La radio permanece apagada en los arranques posteriores y los ajustes Wi-Fi desaparecen de la interfaz web. El modo no puede revertirse mediante la API.

Actívelo mediante la API y, a continuación, reinicie:

# Authenticate
curl -s -c cookies.txt -X POST http://192.168.0.7/auth -H 'Content-Type: application/json' -d '{"login":"admin","pass":"admin"}'

# Permanently disable Wi-Fi
curl -s -b cookies.txt -X POST http://192.168.0.7/settings -H 'Content-Type: application/json' -d '{"wifi_perm_disable": true}'

# Reboot to apply
curl -s -b cookies.txt -X POST http://192.168.0.7/cmd -H 'Content-Type: application/json' -d '{"cmd": "reboot"}'

Después del reinicio, GET /settings omite wifi grupo e incluye "wifi_perm_disable": true. El envío de {"wifi_perm_disable": false} se ignora sin avisar. Para restablecer el Wi-Fi, restablezca la pasarela a los valores de fábrica manteniendo pulsado Config durante 5 segundos, o vuelva a programar el firmware del dispositivo.

Configuración en el controlador Wiren Board

Controlador y pasarela conectados al mismo rúter, ambos mediante DHCP

La pasarela ilustrada recibe 192.168.0.125. Utilice la dirección real asignada por su rúter.

Conexión Ethernet directa: el controlador comparte IPv4 y la pasarela utiliza DHCP

Establezca el puerto Ethernet del controlador en IPv4: Shared to other computers y la pasarela a DHCP client. La pasarela de la ilustración recibe 10.42.0.15.

Conexión Ethernet directa con direcciones estáticas

El ejemplo utiliza Ethernet 2 del controlador en 192.168.1.2 y la pasarela 192.168.1.7, ambos con configuración IP estática.

Para controlar dispositivos Modbus conectados a la pasarela, configure wb-mqtt-serial en el controlador:

1. Añada puertos TCP para las interfaces RS-485-1 y RS-485-2 de la pasarela.
2. Añada los dispositivos mediante la detección automática o manualmente, seleccionando sus plantillas. A continuación aparecerán en la página Devices del controlador.
3. Añada módulos laterales WBIO manualmente utilizando sus plantillas. Con un controlador Wiren Board, la dirección es <WB-MIO Modbus address>:<WBIO sequence number, starting at 1>. Con la dirección interna predeterminada, el primer módulo es 247:1. Los controladores o programas de terceros deben calcular las direcciones mediante el mapa de registros del WB-MIO.