Distributed Network Protocol is an open standard-based protocol maintained by the DNP Users Group (http://www.dnp.org/). The following documentation will only make sense if you have read the documentation published by the DNP Users group. To simplify the interface for OPC clients, the OPC client can only have access to higher-level DNP3 static objects. Instead of having to deal with many separate objects (static object, different variations of the event object, different variations of the output block).
||IOServer acts as a Master station.|
||IOServer acts as a Slave station. Each DNP3 slave device can support multiple DNP3 masters with access to their independent event buffer. The DNP3 slave will accept requests from any Master Station Address. Each DNP3 Master with the same Master Station Address shares the same event buffer, that is filled from the main event buffer.|
|Master Station Address
||The address of the Master station.|
||The OPC Quality flag of offline objects (online bit cleared or restart/communication lost bits not cleared).
||Quality Good, Local Override|
||Quality Bad, Not connected|
|Connect Ping Type
||Master device Application Layer Initial poll message.
||Class 1, 2, or 3 as configured and Class 0 polls.|
||Use Delay Measurement. This ensures that the slave clock is synchronized before the event data are polled. The DNP3 Master or Slave can initiate the Time Synchronization procedure by writing 1 to .NeedTime.|
||Class 0 poll only.|
|Request link status with self-address
||The DNP3 master will issue a request link status with self-address of 0xFFFC to identify the slave to be associated with this connection. The request link status will not be issued if the first message (comma- separated list of numbers terminated by \r\n) received on the connection identify any of the configured slaves.
Only DNP3 slaves with this option enabled will respond to requests with self-address.
|File Transfer Directory
||If not blank, then restrict all file transfer activities in the slave to this directory.|
|Force all devices online at startup
||Put all devices attached to this port online at startup. For multi-dropped devices when each device takes more than 30 seconds to start up.|
||When attaching multiple devices to a port, each device can access the port anytime without waiting for another device to finish. For use only when the underlying media have robust collision avoidance handling.|
|Data Link Confirm Mode
Data Link confirm mode should be turned on when using unreliable media. Turning on the Data Link confirm mode will slow down the data transfer rate.
|| Never request for Data Link confirmation. Disable link layer retry.|
|| Always request Data Link confirmation. The port.Timeout is used as the link layer timeout, the port.Retries is used as the link-layer retry.|
| On multi-frames only
|| Request Data Link confirmation on multi-frames only.|
|Ethernet Time Synchronization
||Data Link Confirmation mode is set to Never. Use Record Current Time (Function Code 24) instead of Delay Measurement (Function Code 23) to synchronize time on the Slave. Do not enable this option if your TCP/IP RTU does not support Function Code 24|
|Log Link Layer
||Log Link Layer messages to log file. Logging will slow down the data transfer rate.|
|Application Confirm Mode
|| Never request for application confirmation.|
|| Always request application confirmation.|
|| Request application confirmation on multi-fragments or when sending event data.|
|| Request application confirmation when sending event data.|
||Maximum time to wait for an application confirmation or fragment. The application timeout must be greater than (Port Timeout * (Port Retries + 1)).|
||Number of retries before abandoning transactions and putting the device offline. The Port Watch Time must be greater than (Application Timeout * (Application Retries + 1))|
|Application Fragment Size
||Maximum size of each application fragment (200 to 16000).|
|Log App Layer
||Log Application Layer messages to log file. Logging will slow down the data transfer rate.|
|Slave Station Address
||Station Address of Slave. A device with an address of 65535 is used to send broadcast commands such as Freeze or Operate to all devices on a channel.|
|Device Startup Mode
||Initial value of the .Enable tag of the device.
|| 1 - The device is started and polled as scheduled.|
|| 2 - The device is started, but the polling schedule is suspended.|
|| 0 - The device is not started or polled|
||Add this number of minutes to timestamps|
||The value of DNP objects is written to this file at the device shutdown. The next time the device is started up, it will use this information to restore the time stamp of DNP objects. Leave this field blank if restoration of the timestamp is not necessary, otherwise specify a different filename for each device. Writing a 0 value to .Backup will cause the current values of all objects to be written to this file. Writing a 1 value to .Backup will restore the values from this file.|
|Object File Update Time
||The DNP3 Master will ensure that all changes to static objects are saved to the object file within this time. The DNP3 Slave will ensure a new object file is loaded within this time. Set to 0 to disable this feature. e.g. A value of 0.1 in a DNP3 master will ensure that all changes to static objects are saved to the object file within 0.1 seconds.|
|Use UTC Time
||If Enable, all timestamps read and written to the slave are assumed to be based on UTC (Coordinated Universal Time) time. Otherwise, local time is used. The use of UTC time is recommended, it is the responsibility of each OPC client in different time zones to convert the UTC time to local time for display.|
||Log SOE (Sequence of Events) to log file when generated by the slave or received by the master.
11:45:10.005 999 SOE Master.2.3.0,81,2002 01 23 11:45:10.001
||Time this event is received.|
||Elapsed time since the last event in the log file.|
||DNP3 Log tag|
||DNP3 event object 2, variation 3 and index 0 from device Master|
||Status value (hex)|
|2002 01 23 11:45:10.001
||Time as received in the event data|
11:23:54.003 999 SOE Master.32.4.0,01,122,2002 01 23 11:23:54.002
||DNP3 event object 32, variation 4 and index 0 from device Master|
||Status value (hex)|
|2002 01 23 11:23:54.002
||Time as received in the event data|
||Class 0 are static data, these are the current value of the data in the RTU. Class 1, 2, and 3 are event data, these are data changes (possibly with timestamp) of the data in the RTU. Each event object in the RTU can be assigned to classes 1, 2, or 3. Belonging to a class does not imply any sort of priority. Most RTU will statically assign a default class to each event object. More advanced RTU allows the user to assign the class of each event object. Level 3 RTU allows the Master to assign the class of each event object dynamically. Event data are used to update the DNP3 Master database. Event data are normally polled at a much faster rate than static data. Class 0 poll is issued at a very slow rate to the DNP3 Master database is up to date. The RTU will respond with all its static data points to a class 0 poll, which could be quite substantial for a large RTU. The RTU will respond only with data changes to class 1, 2, or 3 polls.|
||Interval between poll for that poll type. A poll interval of 7 seconds with a sync time of 0 seconds means that the master will poll the device at the following times (starting from midnight): 0,7,14,...,63,70.
The Device Polling schedule can be paused by writing a value of 2 to the Device.Enable tag. Other possible values are:
||Stop that device immediately and put that device offline. IOServer will continue to restart that device at every watchtime but will be unsuccessful.|
||Allow the device to start successfully at the next watchtime.|
||Suspend polling of the device. The device will remain online.|
Device.Enable will return a value of 0 if the device is offline.
||Start of poll time within the poll interval. A poll interval of 7 seconds with a sync time of 2 seconds means that the master will poll the device at the following times (starting from midnight): 2,9,16,...,65,72.|
||Enable the reception or transmission of unsolicited messages for that class|
||Maximum number of items requested per class poll (supported only by level 2 slaves). Use 0 for no limit. This is used to limit the amount of data that a level 2 slave may return per poll. Use -1 to stop DNP Master from issuing an event poll whenever the class internal indication flag from the RTU is set for this class. Use -1 to stop DNP Slave from setting the class internal indication flags.|
||List of objects/data points to be assigned to this class (supported only by level 3 slaves). Assigning a data point to class 0 stops that slave from producing an event object for that data point. Examples of objects:
Default class assignment
||All variations and indexes of object 1|
||Variation 1 of object 1|
||Indexes 1 to 20 of variation 1 of object 1|
||All static data and Output Events(10 12 40)|
||All Binary Input Events(1)|
||All Analog Input Events(30 31)|
||All Counters Events(20 21)|
When defining your class assignments, first clear the default class assignments by setting Class 0 to "1 20 21 30 31"
|Enable SOE Tag
||When enabled in a DNP3 master, all received DNP3 event objects will route to the .SOE tag. Writes to the .SOE tag will cause a DNP3 event to be generated in the DNP3 Slave.
The .SOE tag is string (VT_BSTR) with the format
Digital : object.variation.index,status(hex),optional timestamp
Analog: object.variation.index,status(hex),analog value,optional timestamp
|Use Level 3 commands
||Enable Level 3 commands, this option should only be enabled if the RTU support the following level 3 command:
Start/Stop Qualifiers in Poll and Freeze commands
Pattern Control Block and Pattern Mask objects
Enable/Disable Unsolicited Message
||Writing to analog inputs will cause FREEZE command to be issued, otherwise WRITE command will be issued.|
|Read after Operate
||Perform a read after operating the output.
|Class 0 static poll
|Class 1 event poll
|Class 2 event poll
|Class 3 event poll
||Millisecond delay before issuing the read|
||Shows the number of events in the main event buffer and master station event buffers. Address(All,Class 1,Class 2,Class 3:Total:Age) shows the number All, Class 1, Class 2, and Class 3 objects waiting for transmission to master station Address. Total is the number of objects processed so far. Age is the oldest event in the buffer in hours.|
|Enable Unsolicited Messages
||Enable the transmission of unsolicited messages for Slave.|
|Execute Pulse on/off commands
||Pulse on/off, Close and Trip commands from the DNP master are executed with the correct on/off time. If disabled, the command from the DNP master is encoded as a 32-bit value that can be passed on to other DNP masters.|
||Time offset between clocks on Slave station and Master station. Each DNP3 slave clock must be accurate, but the actual clock of each DNP3 slave can be set to any time or not set all. With DNP3 time synchronization, each DNP3 slave will automatically adjust the timestamp it sends to the master based on the time difference it calculated during the time synchronization procedure. In IOServer DNP3 slave this time offset is displayed in DNP Slave.Time offset. If you want the DNP3 slave to send unsynchronized time, then you will need to turn off time synchronization by clearing the Needtime internal indication before a DNP3 master connects to it.
The following OPC Gateway item will turn off the Needtime internal indicator as soon as the device comes online.
|| Event data older than Event lifetime are discarded by the slave. Each writes to an object will cause an event to be generated. All events will be accumulated indefinitely at the DNP3 slave until they are transmitted and confirmed by the DNP3 Master. e.g. A value of 0.5 will discard all events older than 30 minutes. The number of events currently stored in each class is indicated by Events(Total, Class 1, Class 2, Class 3).|
|Event Update Time
||Unsolicited data buffer time, a value of zero means that events are sent immediately. A non zero value allows the slave to pack more events into a single frame for transmission to the master.|
|Binary Input Change with Relative Time
||When sending more than N Binary Input Change with Time (2.2) objects, convert them to Time and Data (51.1) and Binary Input Change with Relative Time (2.3) objects.|
|Control Output Close Address Offset
||A close command (Pulse On/Close:65) to control output x will cause the control output x + offset to be operated.|
The OPC Browse Server Address Space will show all the available data of each Slave station based on information received from the Slave station. To find out what type of data is available, connect to IOServer, using the built in OPC Server explorer, add a group then add item to see the available data types.
1.2.1 is the 8 bit byte value of the status (online, state and etc.,) of Object 1, variation 2, index 1.
1.2.1.State is the Digital value of the state of object 1, variation 2, index 1.
1.1.1 is the Digital value of the state of object 1, variation 1, index 1.
IOServer DNP3 Device Profile
||IOServer Pty Limited|
||IOServer DNP3 Device|
|Highest DNP3 Level Supported:
Can be configured as a Master or a Slave at DNP3 Channel Tab, Protocol Mode.|
|Maximum Data Link Frame Size (octets)
||292||Maximum Application Fragment Size (octets)
||Configurable between 200 and 16000|
| Setting the Application Layer Fragment Size to less than 249 will stop the device from sending Multi-fragments.|
|Maximum Data Link Retries
Configurable at Port->Retries, range 0 to 5
|Maximum Application Layer Retries
Configurable at DNP3 Channel->Application Layer Retries, range 0 to 15
|Data Link Layer Confirmation: Configurable as
||Never request for Data Link confirmation.|
||Always request Data Link confirmation|
|On multi-frames only
||Request Data Link confirmation on multi-frames only||Application Layer Confirmation: Configurable as
Defaults to Never for Master and Sometimes for Slave station
||Never request for application confirmation|
||Always request application confirmation|
||Request application confirmation on multi-fragments or when sending event data.|
|Timeouts while waiting for:
|Data Link Confirm
||Configurable as Port->Timeout between 10 and 360000 milliseconds.|
|Complete Application Fragment
||Configurable as DNP3 Channel->Application Layer Timeout between 10 and 360000 milliseconds.|
|Complete Application Response|
|Send/Executes Control Operations
For binary outputs, the 12.1.x.Status will be set to 255 when the write command is issued. The result code of the response will be reported in 12.1.x.Status. A value of zero indicates that the command was accepted. A non zero value indicates failure.
|Write Binary Outputs
||Use .Write suffix in object name|
|Select / Operate
||Use .SO suffix in object name. The operate will only be issued if the select is successful.|
||Use .DO suffix in object name (Direct operate is chosen if no qualifier is selected)|
|Direct Operate - No ACK
||Use .DO suffix in object name when writing to the broadcast device.|
||Use .Select suffix to only issue the select command.|
||Use .Operate suffix to only issue the operate command.|
||Writing a zero value to counters or analog inputs will cause the Freeze and Clear command to be issued. Writing a non-zero value will cause the Freeze command to be issued. The no ack version is used when writing to the broadcast device.|
||The master can initiate time synchronization with any slave by writing any value to the write-only object "50.1.WriteOnly" of that slave. A read request to "50.1" will return a 32-bit value from the slave of the number of milliseconds since midnight.|
For analog outputs, the 41.x.x will be set to 255 when the write command is issued. The result code of the response will be reported in 40.x.x
Writing to the output object by OPC/DDE clients will cause output block to be written to the RTU:
After the response to a write to output is received, a read is issued to read back the new value of the output. After the write, the result code of the operation is available in 12.1 for binary outputs and 41.x for analog outputs. The meaning of the result code are:
|Output Type||Data Type||Output||Output Block|
|Binary Output without Status||Binary
||12.1, 12.2, or 12.3|
|Binary Output with Status||Binary
||12.1, 12.2, or 12.3|
|Analog Output||32 Bit
||Request accepted, initiated, or queued.|
||Request not accepted as the operate message was received after the arm timer timed out. The arm timer was started when the select operation for the same point was received.|
||No previous matching select message (i.e. an operate message was sent to activate a control point that was not previously armed with the select message).|
||Request not accepted as there were formatting errors in the control request (either select, operate, or direct operate).|
||Control operation not supported for this point.|
||Request not accepted, as the control queue is full or the point is already active.|
||Request not accepted because of control hardware problems|
||Request not accepted because Local/Remote switch is in Local position|
||Request not accepted because it was prevented or inhibited by a local automation process. i.e. .LocalForce of that point is set.|
||Set by the driver, when the command is issued.|
The maximum number of CROB (Control Relay Output Object 12.1) objects issued in a single message is limited by the Input Queue Length parameter for that port.
The maximum number of analog output (41.x) objects issued in a single message is limited by the Input Queue Length parameter for that port.
Pattern Control Block and Pattern Mask (12.2 and 12.3) are only issued if the Use Level 3 command option is enabled and the Input Queue Length parameter for that port is greater than one.
CROB (12.1) and analog output (41.x) are permitted together in a single message.
|Binary Output with status (10.2) and Binary Output (10.1) are declared as unsigned long, the 32 bit value is interpreted as follows:
Bits 0..7 (8 bits) is the Control Code.
Bits 8..15 (8 bits) is Count - 1. i.e. Use a value of zero to specify a count of 1.
||Pulse On - The point is turned on for on time, then turned off for off time.|
||Pulse Off - The point is turned off for off time, then turned on for on time.|
Bits 16..22 (7 bits) is the pulse on time.
Bits 23-29 (7 bits) is the pulse off time.
Bit 30-31 (2 bits) is the pulse time factor.
For pulse on/pulse off code with a count of 1 and not queued, Bits 16..29(14 bits) is the pulse time
||7 Bit Pulse
||14 Bit Pulse|
|| Up to 127 ms
||Up to 16.384 seconds|
|| Up to 12.70 seconds
||Up to 1638.4 seconds|
||Up to 1,270 seconds
||Up to 163,840 seconds|
|| Up to 127,000 seconds
||Up to 4,294,000 seconds|
Writing a 0 or 1 to "10.2.x.State" object will cause control code 4 or 3 to be written to the output block object respectively.
Writing a 2 to 10.2.10 will pulse 10.2.10 off with Direct Operate.
Writing a 1 to 10.2.10.SO will pulse 10.2.10 on with Select and Operate.
Writing a 1 to 10.1.10.SO,bool will latch on 10.2.10 with Select and Operate.
Writing a 0 to 10.2.10.State will latch off 10.2.10 with Direct Operate.
Writing 845416705 (hex 0032640901) to10.2.10.SO will pulse 10.2.10 on 10 times with 100ms on and 100ms off time with Select and Operate.
Writing 0 to Device.10.1.2.SO.3000,bool will issue control code 2 (Pulse Off) with an off time of 3000 ms with Select and Operate
Writing 1 to Device.10.1.2.DO.3000,bool will issue control code 1 (Pulse On) with an on time of 3000 ms with Direct Operate.
Writing 0 to Device.10.1.2.SO.3000.1,bool will issue control code 129 (Trip/Pulse On) with an on time of 3000 ms
Writing 1 to Device.10.1.2.SO.3000.1,bool will issue control code 65 (Close/Pulse On) with an on time of 3000 ms
The .SO and .DO works similarly for analog outputs.
|Master Devices will accept both time-tagged and non-time-tagged for all event data. The Time of Occurrence in received event data will be used as the item timestamp for the static data. If none is available then the time when the data is acquired is used. Each item reported by our OPC Server to any OPC client contains the value, timestamp, and quality of the item. This is a standard feature of OPC.
Every single SOE received from the slave RTU will be reported to the interested OPC client via the static data. It is up to the OPC client to accept (not ignore) and use the VTQ (value, timestamp, and quality) information correctly. IOServer will never issue multiple changes for a particular object in each advice to the OPC client. You can insert a delay between each advice by setting the Preference.SOE Interval parameter. Try to use as small value as you can (less than 50ms).
e.g. If the slave reports 2.3.0 (Binary Input Change with relative time), then the OPC client can see the new value and timestamp in 1.1.0 or 1.2.0.State
|Objects.variations in the slave are only created when they are first read or written to by OPC/DDE clients.|
|Writing to the static object by OPC/DDE clients will cause associated event object to be reported. e.g. Writing to static object 1.1.0 will create a 2.1.0 event object. Writing to static object 1.2.0.State will create a 2.2.0 event object.
|Object Type||Data Type||With Time Object||Without Time Object|
|32 Bit Delta
|16 Bit Delta
|Frozen Counter||32 Bit
|32 Bit Delta
|16 Bit Delta
|Analog Input||32 Bit
|Frozen Analog Input||32 Bit
|Analog Output||32 Bit
Only one variation should be used for each object type
Object 12.1 can not be accessed directly, you can only see the effect on 10.1. For example, if the DNP3 Master sends a pulse on with a count of 10, on-time 10, off-time 10 to 10.1, then object 10.1 will pulse on and off ten times at 10ms interval.
|The device Event Update Time is used to delay the transmission of unsolicited event data messages to allow the slave to pack more data into a frame for transmission. Static data are sent in unsolicited messages when the OPC/DDE clients add new objects.|
| Enable/Disable unsolicited Function are supported.|
| Time tagged binary input events always use Relative time when polled by event polls.|
|Sends static data in unsolicited Responses when the device restarts.|
|Counter Roll Over at 16/32 bits for 16/32 bits counter respectively.|
|Writing User specified timestamp to DNP3 Slave|
|DNP3 Over LAN/WAN
|Link Layer confirmation is explicitly disabled.|
|Configurable Keep Alive Timer for use in unsolicited mode.|
|The Record Current Time method of Time Synchronization is used.|
|DNP3 Master can act as a server (listen) or as a client (connect).|
|DNP3 Slave can act as a server or as a client.|
|TCP/IP or UDP/IP Port Number
Writing to the ".File" Object initiate file transfer operations, The write command is a string of the form:
Operation,RTUFile,PCFile,UserName,Password. Use ".FIO" instead of ".File" for RTU that supports the legacy implementation of 70.1 object.
||Copy RTUFile to PCFile|
||Copy PCFile To RTUFile|
||Full Name of file in RTU|
||Full Name of file in PC. Replace \r,\n and \t with \R, \N and \T.|
||Optional User Name|
Write the string "Write,rtucfg.pcc,C:\RTU\PCFilename" to RTU.File to upload the file PCFileName to the RTU.
Write the string "rtucfg.pcc" to RTU.70.8 to activate it.
Master Station Mode of operation.
|Master Station Unsolicited Mode||Slave Station Unsolicited Mode||Class 0 Poll Interval||Class 1,2,3 Poll Interval||Mode of Operation (The lower numbered ones are the most efficient)|
||1. Quiescent Operation - Never poll any Slave, and all communication is unsolicited report-by-exception.|
||2. Unsolicited Report-by-Exception Operation. Most communication is unsolicited, but also polls for event data.|
||3. Unsolicited Report-by-Exception Operation. Most communication is unsolicited, but poll for static data to keep its database up to date.|
||4. Unsolicited and Polled Report-by-Exception Operation. Most communication is unsolicited, but also polls for event data and static data.|
||5. Polled Report-by-Exception Operation. Polls for event data and static data.|
||6. Poll for event data only.|
||7. Poll for static data only. Event data is never requested.|
||8. Poll Static Data Operation - Polls for the specific static data it requires. Not recommended because it is very inefficient when the number of points is high and changes are infrequent. Event data are never requested. The polling rate will be controlled by the OPC Group or DDE update time.|
Poll for event data - Poll for class 1, class 2, and class 3 data.
Poll for static data - Poll for class 0 data.
Writing to Class objects from Master Station
|Write Value||Function Code issued by Master|
||1 - Read|
||20 - Enable Unsolicited Messages|
||21 - Disable Unsolicited Messages|
The DNP3 master can be scheduled to perform regular polling for class 0, 1, 2, or 3 data. The OPC client can also perform demand poll by writing a 0 to object 60.1, 60.2, 60.3, or 60.4.
e.g Writing a 0 to 60.4 will cause a Class 3 read to be issued to the RTU
writing a 0 to 60.0 will cause a read function code to be issued for Class 1, 2, 3, and 0 data
writing a 4 to 60.0 will cause a disable unsolicited message function code to be issued for Class 1, 2, and 3
Static and Event objects
OPC clients are allowed access to static (1, 20, 30) or output objects (10, 40)
OPC clients are not allowed access to events (2, 22, 32) or output block objects (12, 41).
Events received will be reflected in their static objects, eg. received event objects 2.1, 2.2, or 51.1/2.3 will be reported in static objects 1.1 or 1.2.
e.g if we allowed the OPC client to access 2.1, but the RTU sends 2.2 or 51.1/2.3 then the OPC client will never see any 2.1 events.
OPC clients writing to 10.1 or 10.2 output objects will cause the appropriate object 12.1, 12.2, or 12.3 objects to be issued to the DNP Slave. If we allowed OPC client access to 12, then the OPC client will have to use separate tags to read (10) and write (12) to the same point.
DNP3 masters are normally configured as TCP/IP clients and DNP3 slaves are normally configured as TCP/IP servers
When a DNP3 master is configured as a TCP/IP server. The DNP3 master will remain online when the slave disconnects and will go offline when there is no activity for more than twice the port watchtime or poll intervals.
IOServer running on a Pentium 4, 2.8 GHz PC under Windows 2000 Advanced Server reading from a DNP3 Slave device over TCP/IP. Test configuration file
|Binary Input Event with Time (2.3)
||180,000 events per second|
|32 Bit Counter Change Event with Time (22.5)
||130,000 events per second|
|32 Bit Analog Input Change Event with Time (32.3)
||130,000 events per second|
DNP3 Implementation Table
DNP User Group
Demo Configuration of DNP3 Master accessing a DNP3 Slave over TCP/IP
Exchanging Data with DNP3 Master and Slave