Using Extra Parameters

Each device type has its own specific settings. Users can configure these parameters using the ExtraParameters property available in the device settings table.

When multiple extra parameters are used, the parameters must be separated from each other using the semicolon (;) character.

Example:

shift=0;readfreq=1;writefreq=1

The following table lists the extra parameters that can be used for devices supported by EOS SCADA, together with their descriptions and default values.

Device Extra Parameters

Extra Parameter Name Parameter Description Default Value
shift Specifies which register address corresponds to the zero-based MODBUS table register. 0
writefreq Determines the write frequency. 1
readfreq Determines the read frequency. 1
silent Runs the device in hot standby mode for local controllers. Devices configured as silent are queried once every 10,000 scan cycles. false
spontaneousonly Determines whether query commands are periodically sent to the remote station. Used only with the IEC 60870 protocol. false
usesendmessagequeue Determines whether a message sending queue is used for communication between SCADA and the remote station. Used only with the IEC 60870 protocol. false
localaddress Defines the source address of messages sent for queries. Used only with the DNP3 protocol. 2
remoteaddress Defines the destination address of messages sent for queries. Used only with the DNP3 protocol. 1
scaninterval Determines the scan interval for DNP3 queries. Used only with the DNP3 protocol. 60000
datasetmode Enables the use of dataset mode. Used only with the IEC 61850 protocol. false
transid Defines a fixed transaction ID. Used only with the MODBUS protocol. 0
masswrite Enables sending multiple commands using Function Code 16. Used only with the MODBUS protocol. false
lockinterval Determines the lock wait interval. Used only with the MODBUS protocol. 1000
exitcontext Allows the system to exit the waiting state when the lock interval expires. Used only with the MODBUS protocol. true
locktype Determines the operation serialization type for read and write operations. Used only with the MODBUS protocol. None
rack Specifies the rack number of the Siemens S7 PLC. Normally, in systems consisting of a single rack, the first rack is numbered 0. Used only for Siemens S7 devices. 0
Slot0 Specifies the slot number of the module installed on the Siemens S7 PLC. Used only for Siemens S7 devices. 0
tablename Specifies the name of the table containing live data. Used only for the Live Database. ANLIK_DURUM
tarihcolname Specifies the name of the table column containing live data timestamps. Used only for the Live Database. TARIH
degercolname Specifies the name of the table column containing live data values. Used only for the Live Database. DEGER
veriidcolname Specifies the name of the table column containing the Data ID number. Used only for the Live Database. VERI_ID
sid Specifies the Oracle System ID value, particularly for ORACLE database systems. Used only for the Live Database. -
seperator Specifies the separator used between data values. Used only with TXT and MSMQ protocols. -
usetimestamp Enables the use of timestamps. Used only with TXT and MSMQ protocols. false
writefile Specifies the name of the command file. Used only with TXT and MSMQ protocols. build-force.txt
readfile Specifies the name of the data read file. Used only with TXT and MSMQ protocols. build-simulasyon.txt
connreset Determines the connection renewal interval. Used only with the OPC protocol. 0

MODBUS Shift Parameter

The shift extra parameter is a special parameter used for MODBUS-based protocols. It specifies which register number corresponds to address 0.

For example, if shift=-1 is set, it means that address 0 should be read from register 1. Similarly, address 1 corresponds to register 2.

⚠️ WARNING

MODBUS addresses are determined by shifting them according to the specified shift value. Therefore, it is important to correctly understand the addressing method used by the device.

When EOS hardware is used, no shift value needs to be entered due to the controller communication design. This is equivalent to using shift=0.

Read and Write Frequencies

The readfreq and writefreq parameters are used to determine how frequently data is read from and written to the device.

For example, if readfreq=1 is set, data is read from the device during every device scan cycle.

If readfreq=5 is set, a read operation is performed only once every 5 scan cycles. No data read operation is performed during the other 4 scan cycles.

⚠️ WARNING

Read and write frequencies should be configured according to the required frequency. This feature can be particularly useful for reducing unnecessary communication traffic with devices for slowly changing data.

NOTE: Read and write frequencies can be used as extra parameters for all device types.

IEC 60870 Extra Parameters

The spontaneousonly parameter defines a specific communication behavior related to the IEC 60870 standard.

When spontaneousonly=true is set, SCADA sends query commands to remote stations only during the initial startup. Afterwards, periodic and spontaneous data received from the stations are processed.

When spontaneousonly=false is selected, query commands are sent to remote stations according to the scan intervals and data read/write frequencies.

⚠️ WARNING

The spontaneousonly parameter should only be used with devices associated with the IEC 60870 protocol.

More detailed information about the communication structure, polling mechanisms, and spontaneous data transmission of the IEC 60870 protocol is provided in the relevant sections of the User Manual.

DNP3 Extra Parameters

Extra parameters used for DNP3 devices allow the source and destination addresses of queries to be defined and the polling interval to be configured.

  • localaddress — Source address of query messages.
  • remoteaddress — Destination address of query messages.
  • scaninterval — Scan interval between queries.

By default, the values localaddress=2, remoteaddress=1, and scaninterval=60000 are used.

IEC 61850 Extra Parameters

In IEC 61850 devices, the datasetmode parameter is used to enable the use of dataset mode.

The default value of this parameter is false. It can be set to true for IEC 61850 applications that require dataset mode.

Siemens S7 Extra Parameters

For Siemens S7 PLC devices, it may be necessary to specify the PLC rack and slot information. These values can be defined using the rack and Slot0 extra parameters.

The rack parameter specifies the number of the mounting rack containing the PLC. Normally, in systems consisting of a single rack, the first rack is numbered 0.

The Slot0 parameter specifies the slot number of the module installed on the rack. Modules are numbered starting from zero on the rack.

Default: rack=0;Slot0=0

Live Database Extra Parameters

The Live Database driver is a feature specific to EOS SCADA software. It allows data to be transferred in real time to other SCADA and third-party software through a continuously updated database table.

EOS SCADA can retrieve data from such a database environment just as it reads data from an industrial device. This allows any database table with a suitable structure to be used as a live data source.

The table and column information used by the Live Database driver can be defined using the following extra parameters:

  • tablename — Name of the table containing live data.
  • tarihcolname — Name of the column containing date/time information.
  • degercolname — Name of the column containing data values.
  • veriidcolname — Name of the column containing the Data ID.
  • sid — Oracle System ID value, particularly for ORACLE systems.

The default table and column names are ANLIK_DURUM, TARIH, DEGER, and VERI_ID.

TXT and MSMQ Extra Parameters

For TXT- and MSMQ-based data sources, several extra parameters can be used to format data and enable the use of timestamp information.

  • seperator — Specifies the separator used between data values.
  • usetimestamp — Determines whether timestamps are used.
  • writefile — Specifies the name of the command file.
  • readfile — Specifies the name of the data read file.

By default, usetimestamp=false. The write file is defined as build-force.txt, while the read file is defined as build-simulasyon.txt.

OPC Extra Parameter

For OPC-based devices, the connreset parameter can be used when the connection needs to be renewed after a specified period of time.

This parameter determines the connection renewal interval for OPC communication. Its default value is defined as 0.

Defining Extra Parameters

Extra parameters are entered in the device's ExtraParameters property. When multiple parameters are used, they are separated from each other by semicolons.

Example

In the following example, address shifting, read frequency, and write frequency are defined together for a MODBUS device.

shift=0;readfreq=1;writefreq=1

It is recommended to select only parameters supported by the relevant device driver. Unsupported or incorrectly written parameters may affect the communication behavior of the device in unexpected ways.

Summary

Special communication features required beyond the standard settings of EOS SCADA devices can be configured using the ExtraParameters field. Parameters are separated by semicolons, allowing multiple settings to be used on the same device.

Address shifting and read/write frequencies for MODBUS devices; spontaneous data behavior for IEC 60870 devices; addresses and scan intervals for DNP3 devices; dataset mode for IEC 61850 devices; and rack and slot information for Siemens S7 PLCs can all be configured through this mechanism.

Driver-specific extra parameters can also be used for different data sources such as Live Database, TXT, MSMQ, and OPC.

Correct configuration of extra parameters is important to ensure reliable communication between EOS SCADA and field devices and to ensure that the application operates according to its requirements.

← Back to Previous Page