../pvss.htm menu.gif basics.gif

Configuration file RK512

The config configuration file contains all the settings for the managers. The file name is passed to the managers in the environment variable WinCC OA. The file is divided into sections. Each section begins with the name enclosed in angle brackets followed by a list of entries. An example configuration file might look as follows:

[Section]
<Keyword> = <Parameter 1> <Parameter 2> ...

Each entry appears on a separate line. The individual parameters are separated by spaces or tabs. Comment lines begin with the character # in the first column. Settings that apply to all drivers of type WCCOArk512 are held in the section [rk512]. Settings that only apply to the driver of type WCCOArk512 with driver number num are held in the section [rk512_num].

IconExample of a config file

[general]

pvss_path = "C:/Siemens/Automation/WinCC_OA/3.10"

proj_path = "C:/WinCC_OA_Proj/MyProj"

langs = "de_AT.iso88591"

 

[rk512]

baudrate = 9600

 

[rk512_1]

devicename = "COM2"

priority = "high"

drvGQ = "_Driver_1.GQ"

drvSQ = "_Driver_1.SQ"

...

The file entries supported by WCCOArk512 are described below:

Entry

Type

Default

Range

Description

rk512DpName

string

"_RK512_<num>"

-

This config entry specifies the name of the internal data point of type _RK512 (Type: string). Normally the name is "_RK512_<num>". In a redundant system, the names of the two drivers must be different and the following entries are required:

 

[rk512]
(host1) rk512DpName = "_RK512_<num>"
(host2) rk512DpName = "_RK512_2_<num>"

devicename

string

""

-

Specifies the name of the serial interface for communication with the PLC. This entry must be present. Communication is in accordance with RS232 via a simple 3-wire cable.

 

Example:

Assigns the interface with the name /dev/tty00 to the driver.

 

devicename = "/dev/tty00"

device

string string

""

-

This config entry specifies the name of the serial interface and the associated settings. The entry is only relevant under Windows. It should not be used in conjunction with "baudrate" or "parity".

 

device = "COM1" "9600,e,8,1" # No handshaking
device = "COM1" "9600,e,8,1,p" # Hardware handshaking

 

Settings for 9600 baud, even parity, 8 bits, 1 stop bit; p enables handshaking.

drvGQ

string

""

-

Specifies the data point name that initiates a general query. Every time this data point is sent, it causes the driver to poll all the data points configured as inputs, and to pass on the values to the WinCC OA system. A sensible choice of data point name is _Driver_num.GQ, where num is the driver number. The data point element type is natural number, the value is not evaluated by the driver. If this entry does not appear in the configuration file, then a general query is not possible.

 

Example:

Every write to _Driver_1.GQ:_original.._value initiates a general query.

 

drvGQ = "_Driver_1.GQ"

drvPollMode

string

""

-

Specifies the data point name that is used to enable and disable polling mode. A sensible choice of data name is _Driver_num.PM, where num is the driver number. In general polling mode is only disabled for diagnostic purposes.

 

Example:

If the data point is set to 0, the driver no longer polls any data points.

 

drvPollMode = "_Driver_1.PM"

drvSQ

string

""

-

Specifies the data point name that initiates a single query. If this data point is sent and if it contains the name of a data point that has been configured for single queries, then the single query is performed. A sensible choice for this value is _Driver_num.SQ, where num is the driver number. The data point element is of type Name. In order to initiate a single query, the name of the corresponding data point must be passed in _Driver_num.SQ:original..value. If this entry does not appear in the configuration file, then a single query cannot be executed.

 

Example:

If a data point name is passed in _Driver_1.SQ:_original.._value, the driver performs a single query for this data point.

 

drvSQ = "_Driver_1.SQ"

baudrate

int

9600

2400 - 9600; 19200

Specifies the baud rate for the serial interface. The default value is 9600. Typical values are 2400, 4800 and 9600. Used in conjunction with an S5, the lower limit for the transmission rate is 2400 baud with an upper limit of 9600 baud. 19200 baud is only supported by the S5 under certain conditions.

 

Example:

Sets the baud rate to 9600 baud.

 

baudrate = 9600

parity

string

"even"

"even","odd","none"

Sets the parity for the serial interface. Possible values are "even", "odd" and "none". The default value is "even". An even parity is set by the PLC. Thus any other setting is only advisable if the RK512 protocol is to be used for communicating with a specific device.

 

Example:

Sets the parity to odd.

 

parity = "odd"

pollMode

bool

1

0|1

Enables or disables polling. Possible values are 0, polling disabled, or 1, polling enabled. The default value is 1 meaning data points are polled. This setting can be changed at runtime by writing to the data point specified under drvPollMode.

 

Example:

Disables data point polling.

 

pollMode = 0

priority

string

"low"

"high"|"low"

Specifies the priority of the driver in the event of an initialization conflict. Possible values are "low" and "high". The default value is "low". If the PLC and driver try to send a message at the same time, the priority is used to decide which device is actually allowed to send the message. The priority is set on the PLC in the hardware. The opposite priority must be set for the driver.

connRetries

int

6

>= 0

Specifies the number of repeat attempts to establish a connection to the PLC in order to send a message. Possible values are all natural numbers including 0. The default value is 6. Normally this value must not be changed.

 

Example:

Sets the number of retries to 8.

 

connRetries = 8

sendRetries

int

6

>= 0

Specifies the number of repeat attempts to send a message to the PLC after successfully connecting. Possible values are all natural numbers including 0. The default value is 6. Normally this value must not be changed.

 

Example:

Sets the number of retries to 8.

 

sendRetries = 8

TVZ

float

5.0

>= 5.0

This config entry TVZ (message delay time) specifies the time in seconds (float, default 5 sec, range > 5) within which a message must be received in response to a command message. The value should be at least twice as great as the QVZ (acknowledgement delay time), so that the PLC has sufficient opportunity to detect a timeout and to repeat its response message.
 

[rk512]
TVZ = 6.5

QVZ

float

2.0

>= 2.0

Specifies the time in seconds within which connection or disconnection must be acknowledged by the PLC. The default value is 2.0 seconds. If the 3964 protocol is used instead of the 3964R, this value should be set to 0.55 seconds. Since this setting only concerns the driver but not the PLC, smaller values should not be used.

 

Example:

Sets the acknowledgement delay time to 0.55 seconds.

 

QVZ = 0.55

ZVZ

float

0.220

>= 0.220

Specifies the time in seconds within which another character in a message must be received. If this character fails to appear, an error code is sent to the PLC. The default value is 0.22 seconds. Since this setting only concerns the driver but not the PLC, smaller values should not be used. Normally the default setting must not be changed.

 

Example:

Sets the character delay time to 0.30 seconds.

 

ZVZ = 0.30

3964R

int

1

0|1

This setting is used to switch between the 3964 and 3964R protocols. The 3964R protocol differs from 3964 by having a longer acknowledge delay time and an additional checksum in the messages. Possible values are '0' for 3964 and '1' for 3964R.

 

Example:

Protocol 3964 will be used.

 

3964R = 0

talas

string

"No"

"Yes"|"No"

This entry defines whether the driver will be docked to a TALAS computer (default = no). In this case always entire data blocks are read out. The first words contain the source time of the data, the data is followed by a status word.

floatIsIEEE

string

"No"

"Yes"|"No"

This entry defines whether float values are transmitted with the IEEE format or with the RK512 specific format. By default it is the RK512 specific format. Since with most PLCs the IEEE format is used, the entry floatIsIEEE = "Yes" must be registered in the config file.

restartFetchOnError

string

"No"

"Yes"|"No"

This config entry (type: string, default: "No") defines whether, in the event of a transmission error in the message direction (data being transferred from PLC to driver), it should start again with a command message (the first message) ("Yes") or whether a follow-on message can be repeated.

restartSendOnError

string

"No"

"Yes"|"No"

This config entry (type: string, default: "No") defines whether, in the event of a transmission error in the command direction (data being transferred from driver to PLC), it should start again with a command message (the first message) ("Yes") or whether a follow-on message can be repeated.

 

Top Of Page

 

V 3.11 SP1

Copyright ETM professional control GmbH 2013 All Rights Reserved