Skip to main content

Adding Modbus Devices

This guide explains how to register new WAGO controllers or energy analyzers or Modbus-supported devices within the WEVA interface.

Prerequisites​

  • Administrator credentials for the WEVA dashboard (You must be an admin user).
  • Device network details (IP Address, Modbus Client ID).
  • Controller Modbus service must be enabled and active.

1. Creating Device Interface​

Login to WEVA and navigate to the Add device page.

  • Fill in the form with the information of the device.
  • Device name is for the user to give.
  • IP address, Port Numberand Client ID are the information gotten from the device to connect to it successfully.
  • Device Type is not needed. It is merely for identification purposes.
  • Select a point on the map where the device is located. (You cannot write in the Address field. It is automatically updated from the map when clicked).

2. Configure Device Parameters​

Enter the technical specifications for the target device.

FieldDescriptionExample
NameUnique identifier for device.Transformer_A_Meter, DeviceType01
IP AddressIPv4 address of the device.192.168.1.10
PortModbus TCP port.502
Unit IDModbus slave address.1
Device TypeSelect from images. (QOS feature)WAGO 879-8421
LocationUser to know location of deviceClick on the map

Add Device Form Placeholder The 'Add Device' page with sample technical data filled in.

3. Verification of Connectivity​

After saving, the system will attempt a connection and initial polling. If successful, the system gives a green message. If an error occurs, the system gives a red message.

  1. Observe the Status column in the device list.
  2. Green: Communication established.
  3. Red: Connection timeout. Check physical cabling and IP settings. Also check WDX connectivity with the device.

4. Troubleshooting Initial Connections​

If the device remains offline:

  • Verify that no other master is locking the Modbus connection (Max 1 connection for some legacy controllers).

  • Ping the device from the WEVA host terminal:

    ping <device-ip>

  • Access WDX and try restarting the connection from there.

Device List Placeholder Image: View of the device list showing one 'Online' and one 'Offline' device.