Browse FAQs

How do I increase the Modbus TCP timeout in Vijeo Designer?

Published date: 30 November 2018

Working with Driver Properties

Driver properties enable you to interact with drivers at runtime. Using driver properties, you can view information about the driver and, in some cases, change how the driver operates. To work with a driver property, it must be mapped to the Device Address of a variable. See Creating Variables for Driver Variable for Driver Properties (@prop) below for information on mapping a variable to a driver property.

The following drivers support driver properties.



SoMachine - Network/Combo

Schneider Electric

Modbus Plus

Schneider Electric

Modbus RTU

Schneider Electric

Modbus TCP/IP

Schneider Electric



Creating Variables for Driver Properties (@prop)

The format for working with driver properties is similar to driver statistics (see Section 5.3, Collecting Driver Statistics).

  1. To display or read a particular driver property, create a variable with Data Type set to an integer (INT, DINT, UINT, UDINT), Data Source set to External, and ScanGroup set to a driver that supports driver properties.

  1. In the Device Address field, type @prop:X

Replace X with the index number of the driver property the variable is referring to.

You can use the following driver properties to specify certain settings on the Modbus RTU and Modbus TCP/IP Local Nodes. For more information, see the Modbus RTU Driver manual, Modbus TCP/IP Driver manual, Modbus RTU specifications, or Modbus TCP/IP specifications.


Modbus RTU and TCP/IP Driver Properties


Device addresses @prop:5 and above are reserved. Do not write to these addresses.

Failure to follow these instructions can result in death, serious injury, or equipment damage.


Device Address




Set Timeout Value

Use this parameter to set a timeout value between 2 and 15 seconds for the driver. The timeout value determines the amount of time the driver takes to attempt a reconnect after a detected connection loss.

Write an integer value from 2 to 15 to @prop:0 to set the timeout value. This parameter is only available on the Modbus TCP/IP driver.


Set Function Codes for WRITE Operations

Use this parameter to force the driver to use the function codes 05 (0x05: Force Single Coil) and 06 (0x06: Preset Single Register) for WRITE operations, instead of the default function codes of 15 (0x0F: Force Multiple Coils) and 16 (0x10: Preset Multiple Registers).

Write 1 to @prop:1 to enable this feature.


Enable JBus

Use this parameter to enable JBus. Write 1 to @prop:2 to enable and 0 to disable.


Connection Status

Use this parameter to show the connection status: Value of 1 (dual Ethernet enabled); value of 3 (dual Ethernet enabled, primary connection OK); value of 5 (dual Ethernet enabled, secondary connection OK); value of 7 (dual Ethernet enabled, primary and secondary connections OK). This property is only available for TCP/UDP and is read only.


Selected Connection

Use this parameter to set the selected connection. Write 1 to @prop:4 to activate the primary connection, or write 2 to activate the secondary connection. @prop:4 is only available for TCP/UDP.

Changing the Value in a Driver Property

At runtime, use the associated variable to read and write driver property values. Variables mapped to driver properties work like any other external variable. You can use the variable in scripts, parts, animation, and anywhere else you can use a variable.

The following steps describe how to use a Numeric Display to display and change the driver property.

  1. Select Numeric Display from the Graphical Objects toolbar and draw it on the panel.

  1. In the General tab of the Numeric Display Settings dialog box, select the variable associated with the driver property you want to work with.
    In this example, we are working with the previously defined variable DriverProperty1. See Creating Variables for Driver Properties (@prop).

  1. In the Input Mode tab, select the Enable Input Mode checkbox, and then click OK to complete the setup.

At runtime, the Numeric Display part displays the value of the associated driver property— in this case, @prop:1 of the Modbus Plus driver. Touch the numeric display and type a value to change value of the driver property.


Was this helpful?

What can we do to improve the information ?

Can't find what you are looking for?

Reach out to our customer care team to receive information on technical support, assistance for complaints and more.