Configurazione con WB-MGE v.3

Leggere il manuale completo WB-MGE v.3, comprese le modalità attuali delle porte, le specifiche e le istruzioni di manutenzione.

Istruzioni di configurazione per il gateway WB-MGE v.3, comprese le interfacce di rete, le porte RS-485 e l’interfaccia WB-MIO integrata per i moduli laterali WBIO.

I/O Bus: moduli laterali WBIO

I moduli laterali funzionano tramite un WB-MIO integrato, presentato come dispositivo Modbus su RS485-2. Le impostazioni predefinite sono indirizzo Modbus 247 e 9600 bit/s, 8 bit di dati, nessuna parità, 2 bit di stop (8N2).

Per abilitarlo o disabilitarlo, aprire Configuration → Serial ports, individuare la scheda I/O Bus e modificare Enable I/O Bus. WB-MIO è abilitato per impostazione predefinita. Disabilitarlo se occorre liberare il suo indirizzo Modbus oppure utilizzare su RS485-2 un protocollo in conflitto con Modbus RTU.

Le impostazioni di comunicazione dei dispositivi collegati a RS485-2 e del WB-MIO integrato devono coincidere. Se differiscono, modificare le impostazioni WB-MIO scrivendo nuovi valori nei registri. È possibile farlo tramite wb-mqtt-serial nell’interfaccia web del controllore, con modbus_client tramite SSH mentre RS485-2 è in modalità Modbus TCP oppure collegandosi direttamente a RS485-2 tramite un convertitore WB-USB485.

Esempio: arrestare il driver del controllore, impostare la velocità in baud di WB-MIO e riavviare il driver:

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

Qui, 247 è l’indirizzo WB-MIO e 10.42.0.176 è l’indirizzo IP del gateway. Il registro 110 utilizza un moltiplicatore ×100: 1152 significa 115 200 bit/s.

Registri di comunicazione WB-MIO

Tutti i registri seguenti sono registri holding, leggibili e scrivibili (RW), con valori senza segno a 16 bit (u16).

Configurazione della rete

Il modulo può collegarsi tramite Ethernet e Wi-Fi indipendentemente oppure utilizzare entrambi contemporaneamente, ad esempio la modalità punto di accesso Wi-Fi per la configurazione iniziale ed Ethernet per il normale funzionamento.

In Configuration → Network → Ethernet, il client DHCP è abilitato per impostazione predefinita, quindi il router assegna l’indirizzo IP. Per utilizzare un indirizzo statico, disabilitare il client DHCP e inserire manualmente indirizzo IP, maschera di sottorete e gateway.

In Configuration → Network → Wi-Fi, selezionare una delle modalità seguenti:

• Access point (AP): modalità predefinita. Il modulo crea una rete denominata WB-MGE-XXXXXX. Configurare SSID, password, tipo di autenticazione, indirizzo IP, maschera e gateway.
• Client (station): si collega a una rete Wi-Fi esistente. Inserire SSID e password della rete, quindi selezionare DHCP oppure inserire indirizzo statico, maschera e gateway.
• Disabled: disabilita completamente l’interfaccia Wi-Fi. Un’opzione separata di disabilitazione permanente è descritta di seguito.

Il firmware attuale non dispone di un’impostazione per il server DNS. Il modulo funziona sulla rete locale utilizzando indirizzi IP, senza risolvere nomi di dominio esterni.

Avvio rapido

Questa sequenza riguarda un WB-MGE v.3, dispositivi RS-485 (compresi quelli Fast Modbus) e un controllore sulla stessa rete.

1. Collegare l’alimentazione e i morsetti RS-485 A/B/GND. Lasciare abilitata la terminazione se il gateway si trova all’estremità del bus; disabilitarla se è al centro.
2. Per il primo accesso, collegarsi alla rete Wi-Fi del modulo WB-MGE-XXXXXX utilizzando la password sull’etichetta laterale. Aprire 192.168.5.1 e accedere con le credenziali predefinite admin / admin. Per il normale funzionamento, collegare il modulo e il controllore alla stessa rete.
3. Aprire Modbus tools → TCP gateway, selezionare la scheda della porta RS-485 e impostare Mode su Modbus TCP. Le porte TCP predefinite sono 502 per RS-485-1 e 503 per RS-485-2.
4. In Configuration → Serial ports, abilitare la terminazione solo a un’estremità del bus e abilitare la polarizzazione a riposo solo quando il modulo è il master di quel bus. Impostazioni errate causano frequentemente la mancata risposta dei dispositivi senza un errore esplicito.
5. Individuare l’indirizzo IP del modulo in Configuration → Network.
6. Nelle impostazioni del controllore wb-mqtt-serial , aggiungere una porta Modbus TCP . Inserire l’indirizzo IP del gateway e la porta TCP selezionata sopra. Mantenere le impostazioni temporali predefinite per una rete locale. Aggiungere i dispositivi mediante rilevamento automatico oppure manualmente con i rispettivi indirizzi slave e template.
7. Verificare che i valori dei dispositivi compaiano nell’interfaccia web del controllore e in MQTT in /devices/.../controls/.... In caso contrario, verificare la corrispondenza delle porte TCP, la terminazione e la polarizzazione a riposo.

Interfaccia web

L’interfaccia web del gateway funziona nei browser moderni per computer e dispositivi mobili. Collegare computer e modulo alla stessa rete tramite Wi-Fi o Ethernet. La modalità punto di accesso Wi-Fi assegna automaticamente gli indirizzi IP ai client. Ethernet ottiene un indirizzo tramite DHCP, ad esempio dal router. I dettagli della rete sono disponibili anche nella console di debug tramite il connettore USB-C sotto il coperchio.

Accesso tramite il punto di accesso Wi-Fi

1. Cercare WB-MGE-XXXXXX nell’elenco delle reti Wi-Fi del computer portatile o del telefono.
2. Inserire la chiave di sicurezza stampata sull’etichetta laterale del dispositivo.
3. Aprire 192.168.5.1; nome utente e password predefiniti sono admin / admin.

Accesso tramite Ethernet

Ethernet utilizza DHCP per impostazione predefinita, quindi è necessario un router che fornisca DHCP, tipicamente un router domestico o aziendale.

1. Collegare il gateway al router con un cavo Ethernet.
2. Aprire le impostazioni del router e individuare l’indirizzo IP assegnato al gateway.
3. Da un computer collegato allo stesso router, aprire tale indirizzo in un browser e accedere con admin / admin.

Accesso tramite una porta Ethernet del controllore

Se il modulo si trova su una sottorete diversa dietro il controllore, utilizzare un tunnel SSH. In questo esempio il controllore è 192.168.42.1 e il modulo è 192.168.0.7.

Su Linux/macOS con OpenSSH oppure in Windows PowerShell/CMD:

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

Quando richiesto, inserire la password del controllore; quella predefinita è wirenboard. L’opzione -L inoltra la porta locale 8088 a 192.168.0.7:80 tramite il controllore; -N impedisce l’avvio di un comando remoto. Se la porta 8088 è occupata, scegliere un’altra porta locale libera. Mantenere aperta la sessione SSH durante l’utilizzo dell’interfaccia web.

Con PuTTY su Windows:

1. Impostare Session → Host Name su 192.168.42.1.
2. Aprire Connection → SSH → Tunnels.
3. Impostare Source port su 8088 e Destination su 192.168.0.7:80.
4. Selezionare Local, quindi fare clic su Add.
5. Tornare a Session, fare clic su Open e accedere come root.

Aprire http://127.0.0.1:8088/ in un browser e inserire nome utente e password del gateway.

Accesso tramite Wiren Board Cloud

Se WB-MGE v.3 è collegato a una delle interfacce di rete del controllore e il controllore è connesso a Wiren Board Cloud, è possibile configurare l’accesso proxy all’interfaccia web del gateway tramite il cloud.

Salvataggio e caricamento della configurazione

Esportare i parametri configurati in un file per ripristinarli su un altro dispositivo o riutilizzarli in installazioni simili. Il file comprende tutte le impostazioni dell’interfaccia web, delle porte e delle interfacce di rete.

Terminazione e polarizzazione a riposo

Il modulo dispone delle seguenti resistenze, entrambe abilitate per impostazione predefinita:

• Terminazione: una resistenza da 120 Ω tra A e B. Abilitarla all’estremità del bus; disabilitarla al centro.
• Polarizzazione a riposo: resistenze di polarizzazione da 560 Ω che stabiliscono uno stato definito del bus quando tutti i trasmettitori sono disabilitati. Abilitarle quando il modulo è il master; altrimenti disabilitarle.

Controllare queste impostazioni via software in Configuration → Serial ports, nella scheda della porta interessata.

Disabilitazione della trasmissione (TX)

Disponibile dalla versione firmware 1.3.0.

Ogni porta RS-485 dispone di un interruttore Disable transmission (TX) in Configuration → Serial ports. Questo porta fisicamente il ricetrasmettitore in modalità di sola ricezione: il pin di abilitazione della direzione (DE) viene scollegato dall’UART e mantenuto inattivo. Quando è abilitato, il software non può trasmettere sul bus; i tentativi di trasmissione vengono scartati senza segnalazione.

Ciò consente di collegarsi a un impianto in funzione per analizzarne o replicarne il traffico tramite lo sniffer o il multimaster con cache, senza che una trasmissione accidentale comprometta il sistema. Il pulsante Send packet dello sniffer non è disponibile per le porte in modalità di sola ricezione.

Disabilitazione permanente del Wi-Fi

Disponibile dalla versione firmware 1.3.0.

In questa modalità il driver Wi-Fi non viene più inizializzato. La radio rimane spenta ai successivi avvii e le impostazioni Wi-Fi scompaiono dall’interfaccia web. La modalità non può essere annullata tramite API.

Attivarla tramite API, quindi riavviare:

# 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"}'

Dopo il riavvio, GET /settings omette il gruppo wifi e include "wifi_perm_disable": true. L'invio di {"wifi_perm_disable": false} viene ignorato senza segnalazione. Per ripristinare il Wi-Fi, riportare il gateway alle impostazioni di fabbrica tenendo premuto Config per 5 secondi oppure riscrivere il firmware del dispositivo.

Configurazione nel controllore Wiren Board

Controllore e gateway sullo stesso router, entrambi con DHCP

Il gateway nell’illustrazione riceve 192.168.0.125. Utilizzare l’indirizzo effettivamente assegnato dal router.

Collegamento Ethernet diretto: il controllore condivide IPv4, il gateway utilizza DHCP

Impostare la porta Ethernet del controllore su IPv4: Shared to other computers e il gateway su DHCP client. Il gateway nell’illustrazione riceve 10.42.0.15.

Collegamento Ethernet diretto con indirizzi statici

L’esempio utilizza Ethernet 2 del controllore all’indirizzo 192.168.1.2 e il gateway 192.168.1.7, entrambi con configurazione IP statica.

Per controllare i dispositivi Modbus collegati al gateway, configurare wb-mqtt-serial sul controllore:

1. Aggiungere le porte TCP per le interfacce RS-485-1 e RS-485-2 del gateway.
2. Aggiungere i dispositivi tramite il rilevamento automatico oppure manualmente selezionando i rispettivi modelli. Compariranno quindi nella pagina Devices del controllore.
3. Aggiungere i moduli laterali WBIO manualmente utilizzando i rispettivi template. Con un controllore Wiren Board, l’indirizzo è <WB-MIO Modbus address>:<WBIO sequence number, starting at 1>. Con l’indirizzo interno predefinito, il primo modulo è 247:1. I controllori o software di terzi devono calcolare gli indirizzi utilizzando la mappa dei registri WB-MIO.