Configuring ModbusRTU

Configuring Modbus RTU

The Modbus RTU network allows the platform to communicate with Modbus RTU devices over an RS-485 serial communication network.


Creating a Modbus RTU Network

  1. Navigate to the Devices module from the sidebar.

  2. Click the + (Add) icon.

  3. Drag and drop Modbus RTU into the Create Network window.

    The Create Network dialog box appears.

    Create Modbus RTU Network

  4. Enter the required network details.

    FieldDescription
    Network NameEnter a unique name to identify the Modbus RTU network.
    Choose a PortSelect the serial communication port connected to the Modbus RTU device. Available ports include RS1, RS2, and RS3.
  5. After selecting the communication port, configure the serial communication parameters.

    FieldDescription
    Baud RateSelect the communication speed used by the Modbus RTU device. The configured baud rate must match the connected device.
    ParitySelect the parity mode used for serial communication (None, Even, or Odd).
    Stop BitSelect the number of stop bits used for communication.
    Byte SizeSelect the data byte size used by the device.
    TimeoutSpecifies the maximum time the platform waits for a response from the device.
    Poll TimeoutSpecifies the maximum time allowed for a polling request to complete.
    RetriesSpecifies the number of retry attempts if communication fails.
    Retry GapSpecifies the delay between consecutive retry attempts.
    Skip After RetriesEnables the platform to skip the current request after all retry attempts have failed.
    Retry Every CycleEnables the platform to retry communication during every polling cycle after a failed request.
  6. Review the network configuration.

  7. Click Create Network.

    The Modbus RTU network is successfully created and is displayed in the Devices module.


Adding Modbus RTU Devices

After creating the Modbus RTU network, you can add devices either manually or by using a predefined template.

  1. Select the newly created Modbus RTU network from the Devices module.

  2. Click Add Device.

    The Add Device dialog box appears with the following options:

    • Add Manually
    • Add from Template

Add Manually

Use this option to configure a Modbus RTU device manually.

  1. Select Add Manually.

  2. Enter the required device details.

    FieldDescription
    Device NameEnter a unique name for the device.
    Device DescriptionEnter a brief description of the device.
    Device TypeSelect the appropriate Modbus RTU device type.
    Device AddressEnter the Modbus slave address of the device.
    Poll FrequencySpecify how frequently the platform polls the device.
  3. Click Add Device.

    The device is successfully added to the selected Modbus RTU Network.

    Add Modbus RTU Device


Add from Template

Use this option to create a device using one of the predefined templates.

  1. Select Add from Template.

    The following templates are available:

    • RT-M14
    • RTM16
    • RTM26
    • RTD16
  2. Select the required template.

  3. Click Next.

    A configuration dialog box appears.

    Add Device from Template

  4. Enter the required details.

    FieldDescription
    Slave CountSpecify the number of slave devices to create.
    Slave IDEnter the starting Modbus slave ID.
  5. Click Create.

    The platform automatically creates the device(s) based on the selected template and displays them under the Modbus RTU Network.

    Add Device from Slave


Adding Points

After adding the Modbus RTU device, you can add monitoring points using one of the following methods:

  • Add Manually
  • Import CSV
  1. Select the newly added Modbus RTU Device.

  2. Click Add Points.

    The Add Points dialog box appears.


Add Manually

Use this option to create monitoring points manually.

  1. Select Add Manually.

  2. Enter the required point details.

    FieldDescription
    Point NameEnter a unique name for the point.
    Point DescriptionEnter a brief description of the point.
    Point TypeSelect the Modbus register type. Available options are Holding Register, Input Register, Coil Status, and Input Status.
    Data TypeSelect the data type used by the register. Available options include Integer, Long Integer, Float32, Hex, and Bit.

Reading a Specific Bit

If the selected Data Type is Bit, enable the Read Bit checkbox and specify the required Bit Number.

The platform reads only the selected bit from the configured register.

  1. After entering all the required details, click Add Selected Points.

    The configured points are added successfully to the selected Modbus RTU device.

    Add Points Manually


Import CSV

Use this option to import multiple points using a CSV template.

  1. Select Import CSV.

  2. Click Download CSV to download the point template.

    Download CSV

  3. Open the downloaded CSV file and enter the required point details.

    Save the updated CSV file.

  4. Click Import CSV Catalog and select the updated CSV file.

    The imported points are displayed in the preview.

  5. Click Process Catalog.

    Process Catalog

    The platform validates and processes the imported point configuration.

  6. Review the imported points.

  7. Click Add Selected Points.

    The selected points are imported successfully and added to the Modbus RTU Device.

    Import CSV Points


Writing Point Values

Modbus RTU supports both Read Points and Write Points.

  • Read Points are used to continuously read data from the Modbus RTU device based on the configured polling interval.
  • Write Points are used to write values to the Modbus RTU device.

To write a value to a Modbus RTU device:

  1. Select the required Write Point from the Device Browser.

  2. Click Override.

    The Override dialog box appears.

  3. Enter the required value manually.

  4. Click Write.

    The entered value is written to the configured Modbus RTU register, and the device is updated accordingly.

    Write Point

    Write Point


Point Properties

After adding the required points, select a point from the Modbus RTU Device in the Device Browser.

The Point Properties page opens, allowing you to view the live value of the point, configure its properties, and perform write operations for read/write points.

Modbus RTU Point Properties

The point page contains two tabs:

  • Properties
  • Config

Properties

The Properties tab displays the current status and configuration of the selected point.

Live Data Status

The Live Data Status section displays the current value received from the Modbus RTU device along with its communication status.

It also provides:

  • Current live value
  • Communication status
  • System authority
  • Command interface

System Authority

The System Authority section determines how the point value is controlled.

The following options are available:

  • Authority (Auto) – The point value is automatically updated based on the value received from the Modbus RTU device.
  • Override (Manual) – Allows you to manually write a value to the selected point.

Command Interface

The Command Interface is used to write values to Read/Write points.

To manually update a point value:

  1. Click Override (Manual).
  2. Enter the required value in the Command Interface field.
  3. Select the required Priority.
  4. Click Save Changes.

The entered value is written to the configured Modbus RTU register.


Point Information

The Point Information section displays the basic information of the selected point.

FieldDescription
Point NameDisplays the name of the point. You can modify the point name if required.
DescriptionEnter or update a description for the point.
Point AddressDisplays the Modbus register address associated with the point.

System & Configuration

The System & Configuration section displays the configuration details of the selected point.

FieldDescription
Poll StatusDisplays the communication status of the point.
Point UnitSelect the engineering unit for the point value.
Data TypeDisplays or selects the data type of the point.
Word TypeDisplays the word order used for the selected data type.
Storage CategoryDisplays the storage type used for the point value.

Priority Array

The Priority Array displays the current command priorities assigned to the selected point.

The priority array consists of sixteen priority levels (P1–P16). The active priority is highlighted, indicating which priority level is currently controlling the point.

After making the required changes, click Save Changes to update the point configuration.


Point Configuration

After opening a point, click the Config tab to configure the operational settings of the selected point.

The Config tab contains the following sections:

  • General
  • Alarms
  • Trends
  • Tags

General

The General section allows you to configure how the point value is processed before it is displayed.

General Configuration

Point Characteristics

Enable Linear Mapping to convert the raw input value into the required engineering range.

Configure the following settings:

FieldDescription
Sensor TypeSelect the appropriate sensor type for the point. Available options include NTC 10K, NTC 20K, PT1000, Resistance, Current, Voltage, and DI.

Scaling

Enable Scaling to multiply the incoming point value by a scaling factor.

FieldDescription
Scaling ValueSpecifies the multiplier applied to the point value.

Offset

Enable Offset to adjust the calculated value by adding or subtracting a fixed value.

FieldDescription
Offset ValueSpecifies the value added to or subtracted from the calculated value.

Deadband

Enable Deadband to ignore small changes in the point value.

FieldDescription
Deadband ValueSpecifies the minimum value change required before the point value is updated.

Resolution

The Resolution setting determines the number of decimal places used when displaying the point value.

Select the required resolution from the available options.


Live Readings

The Live Readings section displays the current value of the selected point.

ReadingDescription
Raw ValueDisplays the value received directly from the Modbus RTU device.
Calculated ValueDisplays the processed value after applying scaling and offset.

After configuring the required settings, click Apply Changes to save the configuration.


Alarms

The Alarms section allows you to configure alarm thresholds for the selected point.

Alarm Configuration

The following alarm types are available:

  • High Critical
  • Low Critical

For each alarm, configure the following settings:

FieldDescription
EnableEnables or disables the alarm.
PrioritySelect the alarm priority.
Critical LimitSpecifies the threshold value that triggers the alarm.
Alarm MessageEnter the message displayed when the alarm is triggered.

After configuring the required settings, click Save Alarm Configuration.


The Trends section allows you to configure historical data logging for the selected point.

Data Logging

Data Logging

Enable Data Logging and configure the following settings:

FieldDescription
Trend IntervalSpecifies how frequently the point value is recorded.
Max History RecordsSpecifies the maximum number of records to retain.

Active Calendar

The Active Calendar allows you to configure when trend logging is active.

Configure:

  • Days of the week
  • Start Time
  • End Time

After completing the configuration, click Save Trend Configuration.


Tags

Tags

The Tags section allows you to organize and categorize points using custom tags.

To add a tag:

  1. Enter the tag name in the Search & Add Tags field.
  2. Select an existing tag or create a new tag.
  3. The selected tag is displayed under Added Tags.

Tags make it easier to organize, search, and filter points throughout the platform.


Alarm Status

After configuring the required alarm thresholds, click Save Alarm Configuration.

The platform continuously monitors the point value against the configured alarm limits. When the point value reaches or exceeds the configured threshold, the corresponding alarm is generated.

To view the generated alarm:

  1. Navigate to the Alarms module from the sidebar.
  2. Select the required alarm from the alarm list.
  3. Open the associated point to view the alarm details and current alarm status.

This allows you to verify whether the configured alarm has been triggered for the selected point.

Alarm Status


After enabling trend logging, you can view the historical data recorded for the selected point.

Navigate to the Trends module and select the required point. The historical data is available in both Table View and Chart View.


Table View

The Table View displays the recorded values of the selected point in a tabular format.

The following options are available:

OptionDescription
Start DateSelect the start date for retrieving trend data.
End DateSelect the end date for retrieving trend data.
ExportExports the displayed trend data as a CSV file.
RefreshReloads the trend data for the selected date range.
ClearClears the selected date range and displayed data.
DeltaEnables or disables delta value display.
EditEnables or disables edit mode using the toggle button.

Table View


Chart View

The Chart View displays the historical values of the selected point in graphical format, making it easier to analyze value changes over time.

The following options are available:

OptionDescription
Start DateSelect the start date for displaying trend data.
End DateSelect the end date for displaying trend data.
ExportExports the displayed chart data.
RefreshReloads the chart using the selected date range.
ClearClears the selected filters and chart data.
DeltaEnables or disables delta value display on the chart.
EditEnables or disables edit mode using the toggle button.

Chart View

Complete Workflow

Configure a Modbus RTU network by following the workflow below:

  • Open the Devices module.
  • Click the + (Add) icon.
  • Drag and drop Modbus RTU into the Create Network window.
  • Enter the Network Name.
  • Select the communication Port (RS1, RS2, or RS3).
  • Configure the communication parameters:
    • Baud Rate
    • Parity
    • Stop Bit
    • Byte Size
    • Timeout
    • Poll Timeout
    • Retries
    • Retry Gap
    • Skip After Retries
    • Retry Every Cycle
  • Click Create Network.
  • Select the newly created Modbus RTU Network.
  • Click Add Device.
  • Add the device either Manually or From Template.
  • Enter the required device details and create the device.
  • Select the newly created device.
  • Click Add Points.
  • Add points either Manually or by Importing a CSV.
  • Configure the required Read Points and Write Points.
  • Click Add Selected Points.
  • Select a point from the Device Browser.
  • View and update the Point Properties if required.
  • Configure the General, Alarms, Trends, and Tags settings from the Config tab.
  • Click Apply Changes to save the General configuration.
  • Click Save Alarm Configuration to save the alarm settings.
  • Click Save Trend Configuration to save the trend settings.
  • To write a value to a Read/Write Point, select Override (Manual), enter the required value, choose the priority, and click Save Changes.
  • Verify generated alarms from the Alarms module.
  • View historical point data from the Trends module using the Table View or Chart View.