Data source parameters

Save PDF

Last UpdatedFeb 20, 2025
2 minute read

The data source configuration parameters are split into four categories:

MasterStationBehavior - Parameters defining the adapter's behavior as a DNP3 master station
OutstationBehavior - Parameters defining general behaviors of the DNP3 outstations
TCPChannel - Parameters defining connection information for a TCP channel
Outstation - Parameters defining the connection information for a specific outstation

TLS Configuration

When the adapter is initialized, a certificate directory is created adjacent to the configuration directory.

When running the adapter on Windows, the directory can be found at C:\ProgramData\OSIsoft\Adapters\DNP3\Certificates
When running the adapter on Linux, the directory can be found at /usr/share/OSIsoft/Adapters/DNP3/Certificates

The adapter administrator is responsible for adding certificates, and key files to this directory. TLS properties in the configuration referencing certificate and key files can specify either full path name or just the file name. If only the file name is specified, the adapter looks in the certificate directory.

The following parameters are available to configure a DNP3 data source:

Parameter	Required	Type	Description
StreamIdPrefix	Optional	string	Specifies what prefix is used for stream IDs. The naming convention is {StreamIdPrefix}{StreamId}. An empty string means no prefix will be added to the stream IDs and names. A null value defaults to ComponentID followed by a period. Example: DNP3-1.{OutstationId}.{DNPPointType}.{Index} Note: If you change the StreamIdPrefix of a configured adapter, for example when you delete and add a data source, you need to restart the adapter for the changes to take place. New streams are created on adapter restart and pre-existing streams are no longer updated.
DefaultStreamIdPattern	Optional	string	Specifies the default stream ID pattern to use. An empty or null value results in the default value. Possible parameters: {OutstationId},{DNPPointType}, {Index}, {Group}, and {Variation}. Allowed value: any string Default value: {OutstationId}.{DNPPointType}.{Index}.
LinkStatusRequestInterval	Optional	number	The time interval, measured in seconds, in which the adapter sends a LinkStatus request to each configured data source. Note: This parameter works only with Warm failover. Default value: 60
tlsClientPublicKey	Optional	string	The file name or full path of the unencrypted Privacy Enhanced Mail (PEM) file that contains the certificate the adapter presents to the peer.
tlsClientPrivateKey	Optional	string	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.
tlsPrivateKeyPassword	Optional	string	Password used to decrypt the private key file. If the file is not encrypted, leave this field empty.

AVEVA™ Adapter for DNP3