[dnp3]

Settings for the DNP3 driver

[dnp3] authKeyChangeInterval

Type
uint
Default
600000
Range
>10000
Specifies the time in milli-seconds after that a key change shall be done.

[dnp3] authMACAlgorithm

Type
uint
Default
4
Range
1-6
Specifies the algorithm to use for the message authentication code (MAC).
  • 1 -> SHA1 4-OCTET
  • 2 -> SHA1 10-OCTET
  • 3 -> SHA256 8-OCTET
  • 4 -> SHA256 16-OCTET
  • 5 -> SHA1 8-OCTET
  • 6 -> AESGMAC 12-OCTET

[dnp3] authMaxKeyChangeCount

Type
uint
Default
1000
Range
>0
Specifies the number of DNP3 telegrams until a key change shall be done.

[dnp3] authReplyTimeout

Type
uint
Default
2000
Range
>1000
Timeout in milli-seconds for waiting on a authentication reply message.

[dnp3] autoClearRestart

Type
bool
Default
1
Range
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

[dnp3] autoCmdMode

Type
bool
Default
1
Range
0|1
Determines the command execution behavior.
  • 0 -> no automatic handling for select and execute
  • 1 -> automatic handling of select and execute

[dnp3] autoConfirm

Type
bool
Default
1
Range
0|1
Defines whether a confirmation is sent from the application layer automatically (default = automatic sending).

[dnp3] autoDisableUnsol

Type
bool
Default
0
Range
0|1
Defines whether the function for unsolicited response is disabled on driver startup (default = deactivated).

[dnp3] autoEventPoll

Type
bool
Default
0
Range
0|1
Defines whether the driver issues an automatic integrity poll when the DNP3 device sets "Class Data 1", "Class Data 2" and "Class Data 3" bits in IIN (default = automatic poll is deactivated).

[dnp3] autoIntegrityLocal

Type
bool
Default
1
Range
0|1
Defines whether the driver issues an automatic integrity poll when the device sets or removes the "local" IIN bit (default = the poll is issued automatically).

[dnp3] autoIntegrityOverflow

Type
bool
Default
1
Range
0|1
Defines whether the driver issues an automatic integrity poll when the device sets the "buffer overflow" IIN bit (default = the poll is issued automatically).

[dnp3] autoIntegrityRestart

Type
bool
Default
1
Range
0|1
Defines whether the driver issues an automatic integrity poll when the device sets the restart bit in IIN (default = the poll is issued automatically).

[dnp3] autoTimeSync

Type
bool
Default
0
Range
0|1
Defines whether an automatic time synchronization shall be executed, when the DNP3 device sets "Need Time" bit in IIN (default = automatic time synchronization deactivated).

[dnp3] channelWatchdogTimeout

Type
uint
Default
180
Range
>0
Defines the timeout between two watchdog checks. The checks are used to verify if a channel is still active. Timeout in seconds.

[dnp3] deviceSerial

Type
string, string, string
With this entry the parameters 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.

[dnp3] dnp3DummyRead

Type
uint
Default
1
Range
0-2
Allows to specifiy the behavior of the connection check using dummy read operations. 0 => no dummy read operations 1 => Group 0 variant 252 is used for dummy read operations 2 => Group 60 variant 44 is used for dummy read operations

[dnp3] integrityPollAtStartup

Type
bool
Default
1
Range
0|1
Specifies whether an integrity poll (general query) is executed on connection establishment (default = TRUE).

[dnp3] linkAddress

Type
unsigned integer
Default
3
Range
>=0
Defines the link address of the DNP3 driver. This address corresponds to the "Destination" address in the outstations.

[dnp3] linkStatusPeriod

Type
unsigned integer
Default
10
Range
>=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.

[dnp3] 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.

[dnp3] readStationTime

Type
unsigned integer
Default
0
Range
>=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.

[dnp3] sesDefaultResponseTimeout

Type
uint
Default
5
Range
>=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 seconds.

[dnp3] timeStampMode

Type
unsigned integer
Default
0
Range
0 | 1 | 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

[dnp3] userBitEvent

Type
integer
Default
0
Range
0-32
As the event data affects the same point indices as normal data in telegrams, they are specified 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.

[dnp3] userBitXX

Type
integer
Default
0
Range
0-32
Defines how DNP3 status bits are mapped on WinCC OA user bits. The value "0" means that the corresponding status bit is not mapped. The value for xx stands for:
  • OL -> online (automatisches 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