Configuring Properties

<< Click to Display Table of Contents >>

 

Configuring Properties

The MicrolokII tab contains settings specific to this Driver.

MicrolokII tab

MicrolokII tab

The available options on this tab are described on the next table.

Available options on the MicrolokII tab

Option

Description

Session initiative

Selects the initialization mode that this Driver has on the network. Possible values for this option are Wait for partner to initialize: Keeps waiting for a session initialization by another device or Initialize proactively: This Driver initializes the session with another device. Selecting one of these options is the behavior adopted by this Driver with all devices on the network

Station type

Type of Station that this Driver presents itself to the network. Possible values for this option are Vital station or Non-vital station

Acknowledgment timeout (ms)

This option defines the time, in milliseconds, that a sending peer Station waits after sending a message that requires confirmation. The optimal value for this option depends on the average and worst-case latencies of the physical I/O link and the volume of message traffic that the physical link transports. The supported values for this option range from 50 to 60000 milliseconds. In many cases, users may have to define this option on a trial-and-error basis. This option must be defined to its lowest value, in which the acknowledgment time-outs are minimized but not completely eliminated. The default value of this option is the value defined in the Heartbeat interval (ms)

Heartbeat interval (ms)

This option defines the rate in which a peer Station tries to communicate with a peer when no changes are occurring on the bits of the serial output. The heartbeat interval must be defined as a value that is not greater than half the value of the Stale data timeout (ms) option. Usually, this option must be defined as a value not less than the Acknowledgment timeout (ms) option. This option, for a peer Station, can be defined as values between 100 and 600000 milliseconds. The default value of this option is defined as 40% of the value of the Stale data timeout (ms) option

Indication update cycle

This option is used together with the Heartbeat interval (ms) option to control the rate in which a peer Station sends update indication messages to a peer when there are no changes on serial outputs for this Station. An update cycle with a value 1 (one) allows sending a full data indication message at each heartbeat interval. An update cycle with a value 2 (two) allows sending a full data indication message in all other heartbeat intervals, and so on. In the heartbeat intervals for which no data indication message is sent, a status message from the Station that does not contain data is sent. A periodical usage of a status message instead of a data indication message reduces the loading on a heavily loaded I/O channel, reducing the number of bytes sent through that channel. This option can be defined as values between 1 (one) and 100 and its default value is 10

Stale data timeout (ms)

This option defines a time interval in which an I/O failure is declared when a peer Station does not receive indication data or status messages from its peer. This time interval, for a peer Station, is reset to the value specified in this option whenever an indication data or status message is received from the Station's peer. If the stale data time-out of a peer Station with the same level expires, the status of the Station is defined as failed and the Station is defined as in an initialization state. Once declared as failed, the Station's I/O link is not declared as active again until the sequence of I/O initialization is finished and a valid data message is received. The stale data time-out for a peer Station with the same level can be defined as values between 500 and 600000 milliseconds. For non-vital Stations, the default value is 60000 ms

 

Separately, there are parameters for connection management at the Session layer if the physical Ethernet layer is used.

Parameters for Connection Management at the Session Layer

Option

Description

Performs an IP switch in case of timeout

A True value selects the behavior of performing a swap to the backup IP address, or vice versa after n time-outs. The waiting time used is equal to the value of the Acknowledgment timeout option in case this Driver performs the role of Session initiator and it is equal to the value of the Stale data timeout option in case this Driver is configured with the Wait for partner to initialize option. A False value does not replace the backup IP address, or vice versa

IP switch after 'n' timeout(s)

Number of time-outs that must occur for this Driver to switch to the backup IP address or vice versa. The minimum value of this option is 1 (one)

Wait time for new IP switch (ms)

Waiting time, in milliseconds, to allow a new IP address switch request. This waiting time prevents multiple requests from multiple Sessions from being called at very short intervals. The supported values for this option range from 0 to 60000 milliseconds. This setting has no impact on commands of the IO.Ethernet.IPSelect and IO.Ethernet.IPSwitch Tags

 

Users must also configure a registration for each destination Station to communicate with. The registration of Stations is performed on a list with the parameters described on the next table.

Parameters to register a Station

Parameter

Description

Destination address

Address of the destination peer Station

Source address

Address of the peer Station that this Driver uses to identify itself with a destination

Boolean output count

Number of Boolean outputs. This option refers to an information this Driver communicates about itself during initialization and it must match the value expected by its peer Stations

Boolean input count

Number of Boolean inputs. This option refers to an information that the respective peer Station communicates about itself during initialization and it must match this value

 

Use the Add, Update, and Remove options to add new parameters, change parameters already listed, and completely remove a row of parameters, respectively.

Was this page useful?