Internal Data Points of the DNP3 Driver
An internal data point is needed for every peripheral device. The name for the internal data point type of a DNP3 outstation is _Dnp3Station. The data points of this type are managed by the DNP3 device panel. This panel can be used to create or remove these data points or to set or indicate the content.
The data point type _Dnp3Station has the following structure.
_Dnp3Station
Data point element | Type |
Direction (seen from driver) |
Description |
Configuration | string | Input |
Configuration string for the outstation. The original value can be either IP:<IP address>:<port number>:<link address> for TCP/IP connections or SI:<COM port>:<link address> for serial connections. Examples: “IP:192.168.1.1:3333:10” or “SI:COM1:10” |
Command.Active | bool | Input | Activates/deactivates the DNP3 device. If the value is FALSE, the driver does not establish a connection to this device and ignores all requests for this device. |
Command.AssignClass | dyn_string | Input |
Allows to assign an address to a class. <group>.<index>-<class mask> Following options are available for the class mask parameter:
Example "1.10-4" indicates: Add the Binary Input Index 10 address to the class 3. |
Command.GQ | uint | Input |
Bit mask for execution of a general query to the corresponding device. Bit 0 -> class 0 Bit 1 -> class 1 Bit 2 -> class 2 Bit 3 -> class 3 The value "5" means for instance that for class 2 and class 0 data a general query is executed. |
Command.GroupGQ | dyn_string | Input |
With this data point element a query to a specific group can be carried out. With the variation it can be specified in which format the data should be received. Syntax: group:variation Example: To query all counter with flags (variation 1) in 32 bit modem, the entry 20:1 has to be written to the data point element. For the group and variation numbers see Compatibility of the DNP3 Driver (Interoperability). |
Command.DelayMeasurement | bool | Input | Executes a delay measurement for the corresponding device. The measured value is returned on the State.TimeDelay DPE. |
Command.ColdRestart | bool | Input | Executes a cold restart of the corresponding outstation. |
Command.SyncTime | bool | Input | Executes a time synchronization of the DNP3 device. |
Command.ClearIIN | unsigned | Input |
Executes a clear of internal indication bits in the device. The value written on the DPE is a bit mask with the following meaning: Bit 0 -> reset “Restart” bit Bit 1 -> reset “Need Time” bit |
Command.UnsolicitedResponse | unsigned | Input |
Bit mask to enable/disable unsolicited response. Bit 0 -> class 1 Bit 1 -> class 2 Bit 2 -> class 3 A value "5" means for instance, that class 3 and class 1 are enabled and class 2 is disabled. |
Command.ReadIIN | bool | Output |
Reads out the bits of the internal indication and writes them to the data point element State.IIN, if TRUE. The bits are updated in WinCC OA, if the value has changed (old/new comparison). |
Config.Flags | bit32 |
Enthält verschiedene boolesche Einstellungen. Es wird verwendet, um einige Einstellungen im Zusammenhang mit der sicheren Authentifizierung zu konfigurieren. In Zukunft kann es auch für andere boolesche Einstellungen verwendet werden. Bit0 -> sichere Authentifizierung aktiviert(1)/deaktiviert(0) Bit1 -> aggressiver Modus aktiviert(1)/deaktiviert(0) Bit2 -> SHA1 erlaubt (1)/nicht erlaubt (0) |
|
Config.Security.Users | dyn_string |
Dieses Datenpunktelement enthält die Liste der Benutzerkonfigurationen für das Gerät. In jeder Zeichenfolge werden Benutzernummer, Benutzername, Rolle und der vorinstallierte Schlüssel durch Semikolon getrennt gespeichert. Die Schlüssellänge kann entweder 16 oder 32 Byte betragen. Im Hex-Modus sind dies 32 oder 64 Zeichen. Z.B. "1;alug;operator;11223344556677889900112233445566 |
|
Config.Security.ActUser | int | Enthält die Benutzernummer des aktiven Benutzers, die vom Treiber für das Gerät verwendet werden soll. | |
State.ConnState | bool | Output | Indication of connection status to the DNP3 device (not connected (0), connected(1)). |
State.IIN | bit32 | Output | Display of internal indication status word received from the DNP3 device. |
State.TimeDelay | unsigned | Output | Returns the measured time delay in milliseconds. |
State.StationTime | time | Output | Shows the read-out time from the outstation (see also readStationTime config entry). |