[rk512]

Settings for the RK512 driver

[rk512] 3964R

Type
int
Default
1
Range
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. The default value is '1' for 3964R. 

Example:
Protocol 3964 will be used. 

3964R = 0

[rk512] baudrate

Type
int
Default
9600
Range
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

[rk512] connRetries

Type
int
Default
6
Range
>= 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

[rk512] device

Type
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.

[rk512] deviceName

Type
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"

[rk512] drvGQ

Type
string
Specifies the datapoint name that initiates a general query. Every time this datapoint is sent, it causes the driver to poll all the datapoints parameterized as inputs, and to pass on the values to the WinCC OA system. A sensible choice of datapoint name is _Driver_num.GQ, where num is the driver number. The datapoint 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"

[rk512] drvPollMode

Type
string
Specifies the datapoint 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 datapoint is set to 0, the driver no longer polls any datapoints. 

drvPollMode = "_Driver_1.PM"

[rk512] drvSQ

Type
string
Specifies the datapoint name that initiates a single query. If this datapoint is sent and if it contains the name of a datapoint 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 datapoint element is of type Name. In order to initiate a single query, the name of the corresponding datapoint 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 datapoint name is passed in _Driver_1.SQ:_original.._value, the driver performs a single query for this datapoint. 

drvSQ = "_Driver_1.SQ"

[rk512] floatIsIEEE

Type
string
Default
No
Range
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. 

[rk512]
floatIsIEEE = "Yes"

[rk512] parity

Type
string
Default
even
Range
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"

[rk512] pollCount

Type
unsigned integer
Default
32
Range
>0

Defines the number of data points that can be polled at once. If several polling requests are queued they will be processed in the next driver cycle.

[rk512] pollMode

Type
bool
Default
1
Range
0|1
Enables or disables polling. Possible values are 0, polling disabled, or 1, polling enabled. The default value is 1 meaning datapoints are polled. This setting can be changed at runtime by writing to the datapoint specified under drvPollMode. 

Example:
Disables datapoint polling. 

pollMode = 0

[rk512] priority

Type
string
Default
low
Range
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. 

Example:
Sets a high priority. 

priority = "high"

[rk512] QVZ

Type
float
Default
2.0 [sec]
Range
> 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

[rk512] restartFetchOnError

Type
string
Default
No
Range
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. 

[rk512]
restartFetchOnError = "yes"

[rk512] restartSendOnError

Type
string
Default
No
Range
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. 

[rk512]
restartSendOnError = "yes"

[rk512] rk512DpName

Type
string
Default
_RK512_<num>
This config entry specifies the name of the internal datapoint 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>"

[rk512] sendRetries

Type
int
Default
6
Range
6gt;= 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

[rk512] talas

Type
string
Default
No
Range
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.

[rk512] TVZ

Type
float
Default
5.0 [sec]
Range
> 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. 

Example:
[rk512]
TVZ = 6.5

[rk512] ZVZ

Type
float
Default
0.220 [sec]
Range
> 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