Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Adapter Configuration Utility

DNP3

  • Last UpdatedJun 24, 2026
  • 4 minute read

Configure the DNP3 data source to let the adapter connect to your DNP3 outstation, read point data, and collect measurements from the selected device.

Required parameters

The following parameters are required to configure the DNP3 data source:

Array

Required parameters

Description

Master Station Behaviors

Id

Friendly identifier for the configuration. Must be unique among all MasterStationBehaviors.

Master Address

Address that the adapter uses when communicating on a channel. Must be an available address on the channel. Outstations can be configured to accept connections from this address.

Outstation Behaviors

Id

Friendly identifier for the configuration. Must be unique among all Outstation Behaviors.

Descriptions for the additional parameters can be found in the DNP3 - Outstation Behaviors section.

TCP Channels

Master Station Behavior Id

Must match the Id of one of the configurations in the MasterStationBehaviors list.

Host Name or Ip Address

IPv4 address or hostname that can be resolved to an IPv4 address. The adapter establishes a connection to this address.

Port

TCP port that the outstations are listening on.

Outstations

List of outstations that the adapter connects to on the TCP Channel.

Note: A TCPChannel is uniquely identified by the combination of its Host Name Or IP Address and Port properties. For valid configuration, each TCP Channel must have a unique combination of these properties.

Optional parameters

The universal optional parameters for the DNP3 adapter can be found below.

Outstation Behaviors

The following optional parameters are available to configure each Outstation Behaviors:

Parameter

Description

Application Layer Timeout

Period long enough for an entire Application Layer message to be transmitted represented in hh:mm:ss.fff format.

Enable Unsolicited

If enabled, the adapter accept unsolicited messages from an outstation that is configured to send unsolicited event data.

Enable Time Sync

If enabled, the adapter writes the current time to an outstation that indicates "NeedTime" through the internal indication bits.

Integrity Scan On Startup

If enabled, the adapter performs an integrity scan whenever the adapter or outstation is restarted.

Integrity Scan On Event Buffer Overflow

If enabled, the adapter performs an integrity scan whenever the outstation's event buffers overflow

Integrity Scan Period

Frequency of integrity scans. Set to 00:00:00 for no periodic integrity scans represented in hh:mm:ss.fff format.

Event Classes

Select Add to list of event classes that the adapter scans during an event scan. Enter [1, 2, 3] to include all event classes.

Event Scan Period

Frequency of event scans represented in hh:mm:ss.fff format..

TCP Channels

The following optional parameters are available to configure each TCP Channel:

Parameter

Description

Server Certificate Dns Name

The subject name, which is verified in the presented server certificate, from the SAN extension or in the common name field.

The server verifies that TLSChannel.ServerPublicKey is valid for this name.

Note: This is only used when TCPChannel.CertificateValidationMode is set to CASigned

Server Public Key

The file name or full path of the unencrypted PEM file containing the trusted root certificate(s) or the peer self-signed certificate.

Tls Version

Minimum TLS version allowed.

If set, valid values are “None”, “1.2” or “1.3”.

Note: If set to None, TLS encryption will not be used.

Tls Validation Mode

Valid values are CASigned and SelfSigned.

  • CASigned verifies that the root certificate is one provided in the ServerPublicKey.

  • SelfSigned validates that only a single certificate is present and is a direct match of the one specified in ServerPublicKey.

    If this is set to SelfSigned, the validation of the certificate chain and the end-entity certificate of TCPChannel.TlsPeerCertificate is bypassed.

DNP3 optional parameters

Select on the Optional Settings tab to configure additional data sources for the DNP3 adapter.

Parameter

Description

Stream Id Prefix

Specifies what prefix is used for stream IDs. The naming convention is {StreamIdPrefix}{StreamId}.

Default Stream Id Pattern

Specifies the default stream ID pattern to use, such as {OutstationId},{DNPPointType}, {Index}, {Group}, and {Variation}.

An empty or null value results in the default value. {OutstationId}.{DNPPointType}.{Index}.

Link Status Request Interval

The time interval, measured in seconds, in which the adapter sends a DNP3 Link Status Request to each configured data source when operating in warm failover mode.

These periodic requests allow the adapter to confirm that TCP channels and outstations remain reachable, ensuring accurate device status reporting during failover scenarios.

Note: This parameter works only with warm failover.

Tls Client Public Key

The file name or full path of the unencrypted Privacy Enhanced Mail (PEM) file that contains the certificate the adapter presents to the peer.

Tls Client Private Key

The file name or full path of the PEM file containing the encrypted or plaintext private key corresponding to the public key in the presented certificate.

Only PKCS #8 v2 encrypted files are supported.

Tls Private Key Password

Password used to decrypt the private key file.

If the file is not encrypted, leave this field empty.

In This Topic
Related Links
TitleResults for “How to create a CRG?”Also Available in