DNP3 Data Object Mapping

Introduction

To facilitate communications with the BMENOR2200H module, create data points for the DNP3 communication protocol in the DATA MAPPINGS tab in the DTM.

Access the Configuration Tab

Access the configuration parameters on the DATA MAPPINGS tab in Control Expert:

Step	Action
1	Access the DTM configuration for your module.
2	Confirm that you already created client or server channels.
3	In the CONFIGURATION menu, expand ( +) the Channels/Devices sub-menu.
4	Make a selection in the Channels/Devices sub-menu: DNP3 NET Server DNP3 NET Client DNP3 Serial Server DNP3 Serial Client
5	Select a specific channel in the sub-menu.
6	Select the DATA MAPPINGS tab for the channel.
7	Configure the data mapping parameters.
8	Select Apply to implement your configuration changes. Select OK to implement your changes and close the dialog box.

DNP3 Data Mappings

Using a Binary Input as an example, edit the data point configuration on the DATA MAPPINGS tab:

Step	Action
1	At Select Type Id, select a type ID. NOTE: For this example, select Binary Input.
2	Click Add to see the name ‘Binary Input’ in the Type Identification column.
3	Select the table row that corresponds to the new binary input to see the BINARY INPUT configuration options.
4	Modify the parameters. NOTE: When the Control Expert window is active, you can hover the cursor over any field to see a description of the functionality and the available range of values.
5	Select Apply to implement your configuration changes. Select OK to implement your changes and close the dialog box.

Exchangeable Controller Data Object

WARNING

UNINTENDED EQUIPMENT OPERATION

Do not create an instance of redundant data access.

Failure to follow these instructions can result in death, serious injury, or equipment damage.

Implement the data dictionary in Control Expert:

Step	Action
1	Open the Project Settings (Tools > Project Settings).
2	Expand (+) the menu: Project Settings > General
3	Select the PLC Embedded Data setting to see the Property label and Property value columns.
4	In the Data label column, find the Data Dictionary row and select the corresponding box in the Property value column. NOTE: Select this box when you program the PLC application. Otherwise, unlocated variables may not be mapped to RTU data points. However, a compiled application consumes more memory when the data dictionary is included, which can have an impact on unlocated variables that are implemented in RTU solutions.
5	Select Apply to implement your configuration changes. Select OK to implement your changes and close the dialog box.

Unlocated variables can be exchanged between the controller and the BMENOR2200H module after you define and manage the memory map of the controller to exchange data with the module.

The controller data objects are mapped and only linked for the BMENOR2200H module’s purpose.

Data Exchange

To sustain a high rate of data exchange, the user can define the BMENOR2200H module’s RTU memory for data objects in a sequential ARRAY data type to group points with the same settings.

Use consecutive point numbers (0, 1, 2, 3...) in DNP3 request fragments. Inconsecutive point number will cause some DNP3 points unavailable to work.

Predefined Command List

The required input fields are requested to define a predefined command item for DNP3 client/DNP3 NET client.

Static Variation Name of DNP3

Data object type	Static variation
Binary Input	g1v1 Binary In
Binary Input	g1v2 Binary In Flag
Double Input	g3v1 Double In
Double Input	g3v2 Double In Flag
Binary Output	g10v1 Binary Out
Binary Output	g10v2 Binary Out Flag
Binary Counter	g20v1 32bit Counter
	g20v2 16bit Counter
	g20v5 32bit Ctr No Flag
	g20v6 16bit Ctr No Flag
Frozen Counter	g21v1 32bit Frozen Ctr Flag
	g21v2 16bit Frozen Ctr Flag
	g21v5 32bit Frozen Ctr Flag Time
	g21v6 16bit Frozen Ctr Flag Time
	g21v9 32bit Frozen Counter
	g21v10 32bit Frozen Counter
Analog Input	g30v1 32bit Analog In
	g30v2 16bit Analog In
	g30v3 32bit AI No Flag
	g30v4 16bit AI No Flag
	g30v5 Short Float AI
Analog Input Deadband	g34v1 16bit AI Deadband
	g34v2 32bit AI Deadband
	g34v3 Short Float AI Deadband
Analog Input Dband_Ctrl	g34v1 16bit AI Deadband
	g34v2 32bit AI Deadband
	g34v3 Short Float AI Deadband
Analog Output	g40v1 32bit Analog Output
	g40v2 16bit Analog Output
	g40v3 Short Float AO
Read_Group	—
Read_Class	—
Write_Octet_String	—
Freeze_Counter	—
Unsolicited_Class	—
Time_Sync	—
Restart	—
Octet String	g110 Octet Strings
Integrity_Poll	—
Gen_Events	—
Clear_Events	—

Mapping Tables

Depending on the data object type and the selected protocol profile, different configuration fields are required to define a data object mapping item. The tables below describe the available parameters for each selection in the Select Type Id pull-down menu on the client and server DATA MAPPINGS tabs.

NOTE: These tables include brief descriptions of each data mapping parameter. When the Control Expert window is active, hover the cursor over any parameter field to see a description of the functionality and the available range of values.

Binary Input

This table describes the DNP3 net client parameters that appear on the DATA MAPPINGS tab when you select a Binary Input in the DATA MAPPINGS tab:

Client Parameter		Description
Point Number		Indicates the start number of the point. NOTE: Confirm that the DNP3 point number starts at 0 and is contiguous in server mode. If this is not applied, the nonconsecutive points cannot work normally.
Point Count		Indicates the number of points.
Store to Controller		Choose a source for the event time stamp and flag: Value only: module time Value with time: controller register time Value with flag: point flag information from the controller registers Value with flag and time : flag and time from the controller registers
Point Name		Name of the unlocated register
Static Variation		Select the static variation for the data point.
Event Routing	Route Channel	Disable: Disable routing for the channel. Enable: Enable routing for the channel.
	Route Point	Point number to route. (This point number appears in the server side but cannot be modified on the server side.)
	Event Class Mask	Defines the event class of points. `Unsolicited` is not allowed with class 0 only. In client, `Channel` is 0.
	Default Event Variation	Indicates the default event variation for data point.
	Routing Offline	Specify the flag when the routing channel is offline: Valid Quality: Use any available routing channel connection. Invalid Quality Without Events : Set the flag to offline when the routing channel is offline. Invalid Quality With Event: Set the point flag to invalid in the event when the routing channel is offline. Generate event with received flag value when the routing channel is online. The general integrity will be firstly started (if general integrity is enabled in the client).

This table describes the DNP3 net server parameters that appear on the DATA MAPPINGS tab when you select a Binary Input in the DATA MAPPINGS tab:

Server Parameter		Description
Point Number		Indicates the start number of the point. NOTE: The DNP3 point number starts at 0 and is contiguous in server mode. If this is not the case, the nonconsecutive points do not work normally.
Point Count		indicates the number of points.
Controller Reg Mapping		Choose a source for the event time stamp and flag: Value only: module time Value with time: controller register time Value with flag: point flag information from the controller registers Value with flag and time : flag and time from the controller registers NOTE: Select one of these values to implement SOE for time stamping.
Point Name		Name of the unlocated register
Default Static Variation		Select the default static variation for the data point.
Default Event Variation		Select the default event variation for the data point.
Event Class Mask		Defines the event class of points. `Unsolicited` is not allowed with class 0 only. In client, `Channel` is 0.
PLC State		Specify the flag when the routing channel is offline: No Impact Quality : The quality is valid when the PLC runs. Impact Quality: If the PLC is stopped or removed from the rack, the quality is invalid.

Analog Input

This table describes the client data mapping parameters for analog input types:

Client Parameter		Description
Point Number		Indicates the start number of the point. NOTE: Confirm that the DNP3 point number starts at 0 and is contiguous in server mode. If this is not applied, the nonconsecutive points cannot work normally.
Point Count		Indicates the number of points.
Store to Controller		Choose a source for the event time stamp and flag: Value only: module time Value with time: controller register time Value with flag: point flag information from the controller registers Value with flag and time : flag and time from the controller registers
Static Variation		Select the static variation for the data point.
Point Name		Name of the unlocated register
Display Deadband In Variable		Specify a deadband variable name.
Point Name		Name of the unlocated register when Display Deadband In Variable is selected.
Event Routing	Channel	Enable or disable the routing of the channel number.
	Route Point	Define the point number to route.
	Event Class Mask	Defines the event class of points. `Unsolicited` is not allowed with class 0 only. In client, confirm that `Channel` is at 0 for normal operations.
	Default Event Variation	Indicates the default event variation for data point.
	Routing Offline	Specify the flag when the routing channel is offline: Valid Quality: Use any available routing channel connection. Invalid Quality Without Events : Set the flag to offline when the routing channel is offline. Invalid Quality With Event: Set the point flag to invalid in the event when the routing channel is offline. Generate event with received flag value when the routing channel is online. The general integrity will be firstly started (if general integrity is enabled in the client).

This table describes the server data mapping parameters for analog input types:

Server Parameter		Description
Point Number		Indicates the start number of the point. NOTE: Confirm that the DNP3 point number starts at 0 and is contiguous in server mode. If this is not applied, the nonconsecutive points cannot work normally.
Point Count		Indicates the number of points.
Event Class Mask		Defines the event class of points. In client, confirm that `Channel` is at 0 for normal operations.
Default Static Variation		Select the default static variation for the data point.
Default Event Variation		Select the default event variation for the data point.
Controller Reg Mapping		Choose a source for the event time stamp and flag: Value only: module time Value with time: controller register time Value with flag: point flag information from the controller registers Value with flag and time : flag and time from the controller registers NOTE: Select one of these values to implement SOE for time stamping.
Deadband		Deadband value of the analog input
Use Percent Data		Use low and high range for the percentage of deadband calculation when the check box is selected.
Low Range		Lowest value in the range when the Use Percent Data check box is selected.
High Range		Highest value in the range when the Use Percent Data check box is selected.
Point Name		Name of the unlocated register
PLC State		Specify the flag when the routing channel is offline: No Impact Quality : The quality is valid when the PLC runs. Impact Quality: If the PLC is stopped or removed from the rack, the quality is invalid.
Display Deadband In Variable		Specify a deadband variable name.
Point Name		Name of the unlocated register when the Display Deadband In Variable check box is selected.

Binary Output

This table describes the client data mapping parameters for binary output types:

Client Parameter		Description
Point Number		Indicates the start number of the point. NOTE: Confirm that the DNP3 point number starts at 0 and is contiguous in server mode. If this is not applied, the nonconsecutive points cannot work normally.
Point Count		Indicates the number of points.
Operation Mode		The selected operation mode
Control Code Type		Specify the control code used by the CROB: Latch_On_Off: Trigger the CROB. Pulse_On: Change the value. NOTE: Refer to the description of binary output behavior.
Pulse Duration		Specify the width of the pulse (ms).
Point Name		Name of the unlocated register
Add CMD_STATUS		Specify the CMD_STATUS variable name.

Server data mapping parameters for binary output types:

Server Parameter		Description
Point Number		Indicates the start number of the point. NOTE: Confirm that the DNP3 point number starts at 0 and is contiguous in server mode. If this is not applied, the nonconsecutive points cannot work normally.
Point Count		Indicates the number of points.
TCC		It is used to create Trip Close Control Code of CROB. If it is enabled, the odd point in this configuration is close output and the following point is trip out, when outstation receives close or trip command. Be sure that the point count should be even if enabled. Default value is None.
Short Pulse Duration		Indicates the pre-configured pulse duration of the server
Default Static Variation		Select the default static variation for the data point.
Default Event Variation		Select the default event variation for the data point.
Add Flag Variable		Specify the flag variable name.
Point Name		Name of the unlocated register when the Add Flag Variable check box is selected.
PLC State		Specify the flag when the routing channel is offline: No Impact Quality : The quality is valid when the PLC runs. Impact Quality: If the PLC is stopped or removed from the rack, the quality is invalid.
Prefix		This prefix for the variable name is followed with an underscore (`_`). Configure the prefix in the server advanced parameters. Example: `RTU001_Point1`.
Controller Register Type		The only available option for the binary output is %MW.
Controller Register Address		This is the start %MW address in the controller. This field applies only to located variables. To create a variable without a %MW address, use the value -1. Considerations: The binary output value (0 or 1) is bit 0 the %MW (INT) in the global variable list. The binary output flag data remains in the Device DDT. The %MW range depends on the controller %MW register range (default 2048).

NOTE:

The Binary_Output_Status is applied in the client, which records the latest value, state (flag), and time stamp.

Analog Output

This table describes the client data mapping parameters for analog output types:

Client Parameter		Description
Point Number		Indicates the start number of the point. NOTE: Confirm that the DNP3 point number starts at 0 and is contiguous in server mode. If this is not applied, the nonconsecutive points cannot work normally.
Point Count		Indicates the number of points.
Operation Mode		Selected operation mode
Default Static Variation		Select the default static variation for the data point.
Point Name		Name of the unlocated register
Add CMD_STATUS		Specify the CMD_STATUS variable name.

This table describes the server data mapping parameters for analog output types:

Server Parameter		Description
Point Number		Indicates the start number of the point. NOTE: Confirm that the DNP3 point number starts at 0 and is contiguous in server mode. If this is not applied, the nonconsecutive points cannot work normally.
Point Count		Indicates the number of points.
Event Class Mask		Defines the event class of points. `Unsolicited` is not allowed with class 0 only. In client, confirm that `Channel` is at 0.
Default Static Variation		Select the default static variation for the data point.
Default Event Variation		Select the default event variation for the data point.
Deadband		Deadband value of the analog point
Point Name		Name of the unlocated register
Add Flag Variable		Specify the flag variable name.
Point Name		Name of the unlocated register when the Add Flag Variable check box is selected.
PLC State		Specify the flag when the routing channel is offline: No Impact Quality : The quality is valid when the PLC runs. Impact Quality: If the PLC is stopped or removed from the rack, the quality is invalid.
Prefix		The prefix for the variable name is followed with an underscore (`_`). Configure the prefix in the server advanced parameters. The final variable name follows this format: `Prefix_VariableName.Pointx.value` Example: `RTU001_AO01.Point[10].value`
Controller Register Type		The only available option for the analog output is %MW.
CPU Register Address		This is the start %MW address in the controller. This field applies only to located variables. To create a variable without a %MW address, use a start address of the type float/32 bit. A valid analog output type value is an even number. Use address `-1`. Considerations: The analog output value is in the global variable list. The binary output flag data remains in the Device DDT. The %MW range depends on the controller %MW register range (default 2048).

NOTE:

The Analog_Output_Status is applied in the client, which records the latest value, state (flag), and time stamp.
Floating point values (scientific notation) can be entered for the deadband.

Behavior of a Binary Output

This configuration depends on the selection you made in the Control Code Type field in the binary output client parameters.

The configuration applies latch on/off, pulse on, and Pulse/Trip close.

Depending on the situation, three control types are available for binary outputs. This table shows examples of Trip/close point numbers in the client and server sides for the BMENOR2200H module.

CROB sent in DNP3 client	Point number in DNP3 client	Point number in DNP3 server
Close/Pulse on (double mode)	n n	n
Trip/Pulse on (double mode)	n n	n + 1
Close/Pulse on (single mode)	n	first element of n
Trip/Pulse on (single mode)	n	second element of n

Refer to these trigger mechanisms for the corresponding type of control code:

Op type field	Trigger mechanism	Description
Pulse_on	any value change (0...65535)	pulse on if value change
Latch_on	even-to-odd value change, for example: 0 to 1 2 to 3	latch on
Latch off	odd-to-even value change, for example: 1 to 0 3 to 2	latch off
Close/Pulse_on	even-to-odd value change, for example: 0 to 1 2 to 3	pulse on for close output
Trip/Pulse_on	odd-to-even value change, for example: 1 to 0 3 to 2	pulse on for trip output

Long and Short Pulses of Binary Outputs

This configuration depends on the selection you made for these parameters in the binary output client parameters:

Pulse Duration: It is the pulse duration setting of the client.
Short Pulse Duration : It is the pre-configured pulse duration of the server.

NOTE: The outstation uses the entered Pulse Duration. The value 0 indicates that the device uses a pre-configured value.

Set Measured Value

Apply analog input deadband (obj34) to set deadband of measured value. The parameters of the measured points are activated immediately after the DNP3 server receives the request from the DNP3 client.

For DNP3 obj34 , there is no qualifier to set as it only applies the parameter deadband . Set the static variation and point number at the same setting of the analog input. Analog input deadband is applied both on the DNP3 client and the DNP3 server. The DNP3 server uses it to store the current value which is reported in the response of read requests, the DNP3 client uses it to display the current deadband value which can be controlled by the server through the analog input deadband control block.

This configuration depends on the deadband settings you made in these fields:

Point Number (analog input client parameters)
Point Number (analog input server parameters)
Default Static Variation (analog input server parameters)

NOTE: Refer to the description of the analog input client and server parameters.

Octet String Mapping for DNP3

In DNP3, Octet String applies to group 110. It supports read, write, and response function codes.

For the BMENOR2200H module, the octet string splits into two types of points, input points and output points.

The client uses a Read_Group command to read the Octet String.

This is the interpretation of the Octet String from the perspective of the client:

Octet String points are input points.
Write Octet String points are output points.

This is the interpretation of the Octet String from the perspective of the server:

Octet String points with protocol variable access are input points for the DNP3 client.
Octet String points with controller variable access are output points from the controller.

Octet String lengths:

maximum: 255 characters
default: 16 characters

Event Generation

Access the event command configuration in Control Expert:

Step	Action
1	Follow the directions to configure a server channel.
2	Expand (+) Channels > DNP3 NET server > <ServerName> .
3	Select one of these items from the Select Type Id pull-down menu on the DATA MAPPINGS tab: Generate Events Clear Events
4	Select the Add button to view the parameters for the selected type: Generate Events: Point Number Point Count Object Group Point Name Add CMD_STATUS Clear Events: Object Group Point Name Add CMD_STATUS NOTE: When the Control Expert window is active, you can hover the cursor over any field to see a description of the functionality and the available range of values.
5	Click the Apply button to implement your configuration changes. Click the OK button to implement your changes and close the dialog box.

NOTE: IEC60870-5-101/104 protocols do not support event generation.

Clearing Events in the Server

Clear_Events supports a new point type which clears the event buffer in DNP3 and IEC60870-5-101/104 servers. It enables the user to clear the events buffer in a local or remote SCADA through mapping memory.

To create Clear_Events for these servers, select Data Mapping.

When the value of the Clear_Events register changes, the BMENOR2200H module clears the events of the object group in the configuration.

Parameter	Value Scope	Definition
Object Group	All ObjectsBinary InputDouble InputBinary CounterAnalog InputBinary OutputAnalog Output	Specifies the object group whose event is cleared o. demand
Variable Name	—	Indicates the name of the located register.

DNP3 Event Parameters

The event-generation parameters in the following tables are available after you create an instance of the corresponding type ID. Select the instance of Generate Events or Clear Events in the Data Mappings table to view the parameters.

Generate Events parameters:

Parameter	Description
Point Number	Start point number of the point (min: 0, max: 65535, default: 0)
Point Count	Number of the points (min: 0, max: 7000, default: 1)
Object Group	Object group to read (default: binary input)
Point Name	Name of located or unlocated register (default: –, forbidden symbol: {} “ [], max length: 50) default: CE_P0_P0
Add CMD_STATUS	selected: Specify a CMD_STATUS variable name.
Add CMD_STATUS	deselected: A CMD_STATUS variable name is not specified.

Clear Events: parameters:

Parameter	Description
Object Group	Object group to read (default: binary input)
Point Name	Name of located or unlocated register (default: –, forbidden symbol: {} “ [], max length: 50) default: CE_P0_P0
Add CMD_STATUS	selected: Specify a CMD_STATUS variable name.
Add CMD_STATUS	deselected: A CMD_STATUS variable name is not specified.
Channel Mask	Main Channel	Select the appropriate Channel Mask box to specify the channel number to clear an object group. NOTE: This functionality is configuration dependent.
	Virtual Channel-1
	Virtual Channel-2
	Virtual Channel-3

Event Queue Setting Page

Configure the parameters on the Events tab to map the event queue status to the Device DDT registers in the controller. Each event queue status consumes one three-byte register.

NOTE: When the events number exceeds the configured buffer size, events are lost or overwritten.

Access the event queue configuration in Control Expert:

Step	Action
1	Expand: Channels/Devices<DNP3 NET Server><ServerName>
2	Make a selection in the Select Type Id pull-down menu on the EVENTS tab
3	Select the Add button to view the parameters for the selected type: Event Store Mode Max Event Count Buffer Setting Max Event Count-1 Max Event Count-2 Max Event Count-3 Event Backup NOTE: When the Control Expert window is active, you can hover the cursor over any field to see a description of the functionality and the available range of values.
4	Click the Apply button to implement your configuration changes. Click the OK button to implement your changes and close the dialog box.