Skip to main content

Modbus

The Modbus connector is a field connector for TCP Modbus devices.

Connection settings

SettingDescription
IP AddressIP address of the Modbus host.
PortTCP port of the Modbus host, usually 502.
TimeoutTimeout for connect, read, and write operations in milliseconds.
Between Messages TimeoutDelay between polling cycles in milliseconds.
Delay After ConnectTime to wait after opening the connection before polling starts.

Adding properties

Modbus properties are configured manually. Common fields are:

Property fieldDescription
NameDisplay name of the property.
AddressModbus address in standard notation.
Unit IDModbus slave/unit identifier.
TypeData type such as Boolean, Short, Int, Float, Double, or String.
DirectionInput or output.
Polling IntervalRequired for input properties.
Byte OrderEndianness/word order for multi-byte values.
Zero-Based AddressingControls whether the entered address is interpreted as zero-based or one-based.
Address LengthRequired for string values.

Address ranges

The connector supports these Modbus regions through the entered address:

  • 000001 to 065536: coils
  • 100001 to 165536: discrete inputs
  • 300001 to 365536: input registers
  • 400001 to 465536: holding registers

Five-digit addresses are normalized to six-digit notation automatically.

Runtime behavior

  • Input properties are polled on their configured interval.
  • Output properties write values back to the Modbus device.
  • The connector resolves the correct Modbus region from the address range.

Notes

  • Use Zero-Based Addressing only when that matches the addressing convention of the target device documentation.
  • String reads depend on Address Length, because the connector needs to know how many bytes to read.