📖 Overview

This guide provides a step-by-step procedure for integrating the N3uron IIoT platform with Robustel Edge Gateways (EG Series) running RobustOS Pro. N3uron is a powerful industrial edge platform that enables data orchestration between OT and IT systems.

By following this example, you will learn how to:

• Collect data from a Modbus device.
• Visualize that data locally using the WebVision module.
• Forward the processed data to an external MQTT broker for cloud integration.

🛠 What You'll Need

Hardware:

• Robustel EG Series Gateway (e.g., EG5100, EG5120).

Software/Firmware: RobustOS Pro v2.3.0 or newer.

• N3uron software installed on the gateway.
• An MQTT Client tool (e.g., MQTT.fx or MQTT Explorer) for verification.
• Connectivity: Ethernet or Cellular internet access.

🚀 Step-by-Step Configuration Guide

1️⃣ Phase 1: Data Acquisition (Modbus Client)

In this stage, we configure N3uron to poll data from a Modbus TCP device.

1. Create Modbus Module:

• Navigate to System > Config > Modules.
• Click Add and create a new module.
• Set Module Type to ModbusClient.

2. Configure Channel:

• Create a new Channel under the Modbus module.
• Set the Host (IP address of your Modbus server) and the TCP Port (default is 502).

3. Define Device:

• Create a Device under the channel.
• Assign the correct Slave ID for your target equipment.

4. Create Tag Group:

• Navigate to System > Config > Tags.
• Create a new Group to organize your data points.

5. Configure Data Tag:

• Create a Tag within the group.
• Set Number Type and enable the source by toggling Enable under the Source section.
• Link the tag to the Modbus module by selecting the Module Type (ModbusClient) and the Module Name you created.
• In the Source Config, specify the Device, Modbus Address, and Data Type.

2️⃣ Phase 2: Data Visualization (WebVision)

WebVision allows you to create a local HMI dashboard directly on the gateway.

1. Create WebVision Module:

• Navigate to System > Config > Modules.
• Click Add and select WebVision as the module type.

2. User Permissions:

• Add an access user for WebVision.
• Grant the user Designer permissions.
• Ensure the user has access rights to the Tags created in Phase 1.

3. Design the Interface:

• Open the Designer interface and log in with the authorized user.
• [Insert screenshot of WebVision Designer Interface]

4. Create UI Components:

• Create a Container and select Set as startup.
• Inside the container, add a Component (e.g., a display gauge or text box).
• Link the component value to the Modbus Tag created previously.

5. Launch UI:

• Save and open the generated WebVision UI URL to view live data.

3️⃣ Phase 3: Data Forwarding (MQTT Client)

Finally, we forward the collected data to a remote MQTT broker.

1. Create MQTT Module:

• Navigate to System > Config > Modules.
• Create a module with Module Type set to MqttClient.

2. Establish Connection:

• Create a new MQTT connection.
• Under Connection Options, enter your Broker URL (e.g., mqtt://broker.hivemq.com:1883).

3. Set Publisher:

• Create a Publisher entry.
• Define the Topic where the gateway will post data.

4. Verify Transmission:

• Use your external MQTT client tool to subscribe to the defined topic.

❓ Troubleshooting / FAQ

• Q: Why is my Modbus module showing a "Timeout" error?
• Check physical wiring (for RTU) or IP connectivity (for TCP).
• Ensure the Slave ID and register addresses match the device documentation.
• Q: I cannot log into the WebVision Designer.
• Verify that the user was created specifically within the WebVision module settings and has "Designer" rights enabled.
• Q: MQTT data is not reaching the broker.
• Check the gateway's Firewall settings to ensure outbound traffic on port 1883/8883 is allowed.
• Verify the Broker URL format includes the protocol (e.g., mqtt://).

📜 Revision History