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

Possible Config Entries of the DNP3 Driver

In the config file "config" in the section [dnp3] you can configure the DNP3 driver using the following config entries.

Entry

Type

Default

Range

Description

autoClearRestart

bool

1

0|1

Defines whether the driver deletes the restart bit automatically after it has been reported by the outstation.

0 -> the restart bit is not reset automatically

1 -> the restart bit is reset automatically

autoCmdMode

bool

1

0|1

Determines the command execution behavior.

0 -> no automatic handling for select and execute.

1 -> automatic handling of select and execute.

autoIntegrityRestart

bool

1

0|1

If set to 1 the driver issues integrity poll automatically if device sets the restart bit in the IIN.

autoIntegrityLocal

bool

1

0|1

If set to 1 the driver issues integrity poll automatically if device is setting and clearing the “local” IIN bit.

autoIntegrityOverflow

bool

1

0|1

If set to 1 the driver issues integrity poll automatically if device is setting the “buffer overflow” IIN bit.

autoDisableUnsol

bool

0

0|1

Defines, if the driver automatically deactivates the unsolicited data transfer if the device reports a restart.

(Default: automatic deactivation is disabled)

autoConfirm

bool

1

0|1

Enables (1) and disables(0) automatic application layer confirmation.

autoTimeSync

bool

0

0|1

Executes an automatic time synchronization, if DNP3 device sets “Need Time” bit in IIN (default = deactivated).

autoEventPoll

bool

0

0|1

Executes an automatic integrity poll, if DNP device sets “Class Data 1”, “Class Data 2”, “Class Data 3” bit in IIN (default = activated).

deviceSerial

string string string

""

-

With this entry the parameter of a serial device can be set.

Syntax:

deviceSerial = <device name> <serial port> <serial parameter>

device name:

This is an arbitrary name. It is used as reference in the DNP3 panel (e.g. "dev1").

serial port:

Defines the interface (e.g. "COM1").

serial parameter:

Depending on the used port, the device specific parameters (e.g. baud rate, parity, bit number, stop  bits  = "9600,e,8,1") are set.

integrityPollAtStartup

bool

1

0|1

Specifies whether an integrity poll (general query) is executed on connection establishment (default = TRUE(1)).

linkAddress

uint

3

>= 0

Defines the link address of the DNP3 driver. This address corresponds to the "Destination" address in the outstations.

linkStatusPeriod

unsigned

10

>= 0

Interval for link status period in seconds. If the value is 0 no link status telegrams are sent, if no data telegrams are transmitted.

timeStampMode

uint

0

0 - 2

This config entry determines how WinCC OA time stamps are generated. The different possibilities are:

0 -> use computer time as timestamp

1 -> use time of device and assume time of device is normal local time (no daylight saving)

2 -> use time of device and assume time of device is UTC

readStationTime

uint

0

>= 0

Reads the time from the outstation every x seconds. x stands for the here entered value in seconds.

The read time is written to the internal data point _Dnp3Station.State.StationTime.

sesDefaultResponseTimeout

uint

5000

>= 0

The config entry sets the time-out for session level telegrams responses.

If the time-out expires the session will be set to Offline.

The value must be specified in ms.

userBitXX

int

0

0 - 32

Defines how DNP3 status bits are mapped on WinCC OA user bits. The value "0" (default) means that the corresponding status bit is not mapped.

 

The value for XX stands for:

OL -> online (automatic mapping)

RS -> restart

CL -> communication lost

RF -> remote forced

LF -> local forced

CF -> chatter filter

RO -> rollover

OR -> over range

DC -> discontinuity

RE -> reference error

 

Example

userBitCL = 13

The DNP3 status bit will be mapped to WinCC OA user bit 13.

userBitEvent

int

0

0 - 32

As the event data affects the same point indices as normal data in telegrams, they are mapped on the same peripheral address.

Thereby in each case the "not-event" group is used. That means group 1 for binary input. The DNP3 driver maps then group 1 data as well as group 2 data on 1.

In case of event data the driver sets the here specified user bit.

Default = 0 = the user bit will not be set

 

Top Of Page

 

V 3.11 SP1

Copyright ETM professional control GmbH 2013 All Rights Reserved