Configuration avec WB-MGE v.3

Consultez le manuel complet du WB-MGE v.3, avec les modes actuels des ports, les caractéristiques et les instructions de maintenance.

Instructions de configuration de la passerelle WB-MGE v.3, notamment ses interfaces réseau, ses ports RS-485 et son interface WB-MIO intégrée pour les modules latéraux WBIO.

I/O Bus : modules latéraux WBIO

Les modules latéraux fonctionnent via un WB-MIO intégré, présenté comme un appareil Modbus sur RS485-2. Ses valeurs par défaut sont adresse Modbus 247 et le 9600 bit/s, 8 bits de données, aucune parité, 2 bits d’arrêt (8N2).

Pour l’activer ou le désactiver, ouvrez Configuration → Serial ports, recherchez la carte I/O Bus et modifiez Enable I/O Bus. WB-MIO est activé par défaut. Désactivez-le si vous devez libérer son adresse Modbus ou utiliser sur RS485-2 un protocole incompatible avec Modbus RTU.

Les paramètres de communication des appareils raccordés à RS485-2 et du WB-MIO intégré doivent correspondre. S’ils diffèrent, modifiez les paramètres WB-MIO en écrivant de nouvelles valeurs de registres. Vous pouvez le faire via wb-mqtt-serial dans l’interface web du contrôleur, avec modbus_client par SSH lorsque RS485-2 est en mode Modbus TCP, ou en vous raccordant directement à RS485-2 avec un convertisseur WB-USB485.

Exemple : arrêtez le pilote du contrôleur, réglez le débit du WB-MIO, puis redémarrez le pilote :

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

Ici, 247 est l’adresse WB-MIO et 10.42.0.176 est l’adresse IP de la passerelle. Le registre 110 utilise un multiplicateur ×100 : 1152 signifie 115 200 bit/s.

Registres de communication WB-MIO

Tous les registres ci-dessous sont des registres de maintien accessibles en lecture et en écriture (RW), avec des valeurs non signées sur 16 bits (u16).

Configuration réseau

Le module peut se connecter par Ethernet et Wi-Fi indépendamment, ou utiliser les deux simultanément, par exemple le point d’accès Wi-Fi pour la configuration initiale et Ethernet en fonctionnement normal.

Dans Configuration → Network → Ethernet, le client DHCP est activé par défaut ; le routeur attribue donc l’adresse IP. Pour utiliser une adresse statique, désactivez le client DHCP et saisissez manuellement l’adresse IP, le masque de sous-réseau et la passerelle.

Dans Configuration → Network → Wi-Fi, sélectionnez l’un des modes suivants :

• Access point (AP): mode par défaut. Le module crée un réseau nommé WB-MGE-XXXXXX. Configurez son SSID, son mot de passe, son type d’authentification, son adresse IP, son masque et sa passerelle.
• Client (station): rejoint un réseau Wi-Fi existant. Saisissez son SSID et son mot de passe, puis sélectionnez DHCP ou saisissez une adresse statique, un masque et une passerelle.
• Disabled: désactive entièrement l’interface Wi-Fi. Une option distincte de désactivation permanente est décrite ci-dessous.

Le micrologiciel actuel ne possède pas de paramètre de serveur DNS. Le module fonctionne sur le réseau local avec des adresses IP, sans résoudre de noms de domaine externes.

Démarrage rapide

Cette procédure concerne un WB-MGE v.3, des appareils RS-485 (dont des appareils Fast Modbus) et un contrôleur sur le même réseau.

1. Raccordez l’alimentation et les bornes RS-485 A/B/GND. Laissez la terminaison activée si la passerelle est à l’extrémité du bus ; désactivez-la si elle est au milieu.
2. Pour l’accès initial, rejoignez le réseau Wi-Fi du module WB-MGE-XXXXXX avec le mot de passe figurant sur son étiquette latérale. Ouvrez 192.168.5.1 et connectez-vous avec les identifiants par défaut admin / admin. Pour le fonctionnement normal, connectez le module et le contrôleur au même réseau.
3. Accédez à Modbus tools → TCP gateway, sélectionnez la carte du port RS-485 et réglez Mode sur Modbus TCP. Les ports TCP par défaut sont 502 pour RS-485-1 et le 503 pour RS-485-2.
4. Dans Configuration → Serial ports, activez la terminaison uniquement à une extrémité du bus et la polarisation de repos uniquement lorsque le module est maître sur ce bus. Des réglages incorrects provoquent souvent l’absence de réponse des appareils sans erreur explicite.
5. Recherchez l’adresse IP du module dans Configuration → Network.
6. Dans les paramètres du contrôleur wb-mqtt-serial , ajoutez un port Modbus TCP . Saisissez l’adresse IP de la passerelle et le port TCP choisis ci-dessus. Conservez les paramètres de temporisation par défaut pour un réseau local. Ajoutez les appareils par détection automatique, ou manuellement avec leurs identifiants d’esclave et leurs modèles.
7. Vérifiez que les valeurs des appareils apparaissent dans l’interface web du contrôleur et dans MQTT sous /devices/.../controls/.... Sinon, vérifiez la correspondance des ports TCP, la terminaison et la polarisation de repos.

Interface web

L’interface web de la passerelle fonctionne dans les navigateurs modernes sur ordinateur et mobile. Connectez l’ordinateur et le module au même réseau par Wi-Fi ou Ethernet. Le mode point d’accès Wi-Fi attribue automatiquement des adresses IP aux clients. Ethernet obtient une adresse par DHCP, par exemple depuis votre routeur. Les détails réseau sont aussi disponibles dans la console de débogage via le connecteur USB-C sous le couvercle.

Accès par le point d’accès Wi-Fi

1. Recherchez WB-MGE-XXXXXX dans la liste des réseaux Wi-Fi de votre ordinateur portable ou téléphone.
2. Saisissez la clé de sécurité imprimée sur l’étiquette latérale de l’appareil.
3. Open 192.168.5.1; l’identifiant et le mot de passe par défaut sont admin / admin.

Accès par Ethernet

Ethernet utilise DHCP par défaut ; un routeur fournissant DHCP est donc nécessaire, généralement un routeur domestique ou de bureau.

1. Raccordez la passerelle au routeur avec un câble Ethernet.
2. Ouvrez les paramètres du routeur et trouvez l’adresse IP attribuée à la passerelle.
3. Depuis un ordinateur connecté au même routeur, ouvrez cette adresse dans un navigateur et connectez-vous avec admin / admin.

Accès par un port Ethernet du contrôleur

Si le module se trouve dans un sous-réseau différent derrière le contrôleur, utilisez un tunnel SSH. Dans cet exemple, le contrôleur est 192.168.42.1 et le module est 192.168.0.7.

Sous Linux/macOS avec OpenSSH, ou Windows PowerShell/CMD :

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

Saisissez le mot de passe du contrôleur lorsque vous y êtes invité ; sa valeur par défaut est wirenboard. L’option -L redirige le port local 8088 vers 192.168.0.7:80 via le contrôleur ; -N empêche le lancement d’une commande distante. Si le port 8088 est occupé, choisissez un autre port local libre. Gardez la session SSH ouverte pendant l’utilisation de l’interface web.

Avec PuTTY sous Windows :

1. Réglez Session → Host Name sur 192.168.42.1.
2. Open Connection → SSH → Tunnels.
3. Réglez Source port sur 8088 et le Destination sur 192.168.0.7:80.
4. Sélectionnez Local, puis cliquez sur Add.
5. Revenez à Session, cliquez sur Open et connectez-vous en tant que root.

Open http://127.0.0.1:8088/ dans un navigateur et saisissez l’identifiant et le mot de passe de la passerelle.

Accès par Wiren Board Cloud

Si le WB-MGE v.3 est connecté à l’une des interfaces réseau du contrôleur et que celui-ci est connecté à Wiren Board Cloud, vous pouvez configurer un accès par proxy à l’interface web de la passerelle via le cloud.

Sauvegarde et chargement de la configuration

Exportez les paramètres configurés dans un fichier pour les restaurer sur un autre appareil ou les réutiliser dans des installations similaires. Le fichier comprend tous les paramètres de l’interface web, des ports et des interfaces réseau.

Terminaison et polarisation de repos

Le module comporte les résistances suivantes, toutes deux activées par défaut :

• Terminaison : une résistance de 120 Ω entre A et B. Activez-la à l’extrémité du bus ; désactivez-la au milieu.
• Polarisation de repos : des résistances de polarisation de 560 Ω établissant un état défini du bus lorsque tous les émetteurs sont désactivés. Activez-les lorsque le module est maître ; désactivez-les dans les autres cas.

Commandez ces réglages par logiciel dans Configuration → Serial ports, sur la carte du port concerné.

Désactivation de l’émission (TX)

Disponible à partir du micrologiciel 1.3.0.

Chaque port RS-485 possède un commutateur Disable transmission (TX) dans Configuration → Serial ports. Cela place physiquement l’émetteur-récepteur en réception seule : la broche d’activation de direction (DE) est détachée de l’UART et maintenue inactive. Lorsque cette option est activée, le logiciel ne peut pas émettre sur le bus ; les tentatives d’émission sont silencieusement ignorées.

Cela permet de se connecter à une installation en fonctionnement pour analyser ou dupliquer son trafic à l’aide du sniffer ou du multimaître avec cache, sans qu’une émission accidentelle ne perturbe le système. Le bouton Send packet du sniffer est indisponible pour les ports en réception seule.

Désactivation permanente du Wi-Fi

Disponible à partir du micrologiciel 1.3.0.

Dans ce mode, le pilote Wi-Fi n’est plus initialisé. La radio reste éteinte aux démarrages suivants et les paramètres Wi-Fi disparaissent de l’interface web. Ce mode ne peut pas être annulé par l’API.

Activez-le via l’API, puis redémarrez :

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

Après redémarrage, GET /settings omet le groupe wifi et inclut "wifi_perm_disable": true. L’envoi de {"wifi_perm_disable": false} est silencieusement ignoré. Pour rétablir le Wi-Fi, remettez la passerelle aux paramètres d’usine en maintenant Config pendant 5 secondes, ou reprogrammez l’appareil.

Configuration dans le contrôleur Wiren Board

Contrôleur et passerelle sur le même routeur, tous deux en DHCP

La passerelle illustrée reçoit 192.168.0.125. Utilisez l’adresse réelle attribuée par votre routeur.

Connexion Ethernet directe : le contrôleur partage IPv4, la passerelle utilise DHCP

Réglez le port Ethernet du contrôleur sur IPv4: Shared to other computers et la passerelle sur DHCP client. La passerelle illustrée reçoit 10.42.0.15.

Connexion Ethernet directe avec adresses statiques

L’exemple utilise Ethernet 2 du contrôleur à 192.168.1.2 et la passerelle 192.168.1.7, tous deux avec une configuration IP statique.

Pour commander les appareils Modbus raccordés à la passerelle, configurez wb-mqtt-serial sur le contrôleur :

1. Ajoutez des ports TCP pour les interfaces RS-485-1 et RS-485-2 de la passerelle.
2. Ajoutez les appareils par détection automatique ou manuellement en sélectionnant leurs modèles. Ils apparaîtront ensuite sur la page Devices du contrôleur.
3. Ajoutez les modules latéraux WBIO manuellement à l’aide de leurs modèles. Avec un contrôleur Wiren Board, l’adresse est <WB-MIO Modbus address>:<WBIO sequence number, starting at 1>. Avec l’adresse interne par défaut, le premier module est 247:1. Les contrôleurs ou logiciels tiers doivent calculer les adresses à partir de la table des registres WB-MIO.