Operation Manual: Protocol Mapping Tool
Operation Manual: Protocol Mapping Tool
Operation Manual: Protocol Mapping Tool
Operation Manual
1MRS755277 CAP 505
Issued: 05.11.2003 Protocol Mapping Tool
Version: D/01.03.2005
Operation Manual
4
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
5
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
1.1. Copyrights
The information in this document is subject to change without notice and should not
be construed as a commitment by ABB Oy. ABB Oy assumes no responsibility for
any errors that may appear in this document.
In no event shall ABB Oy be liable for direct, indirect, special, incidental or
consequential damages of any nature or kind arising from the use of this document,
nor shall ABB Oy be liable for incidental or consequential damages arising from use
of any software or hardware described in this document.
This document and parts thereof must not be reproduced or copied without written
permission from ABB Oy, and the contents thereof must not be imparted to a third
party nor used for any unauthorized purpose.
The software or hardware described in this document is furnished under a license
and may be used, copied, or disclosed only in accordance with the terms of such
license.
ABB Oy regularly provides standard training courses on its main products. The
training program is available on the Internet at http://www.abb.com/
substationautomation. Contact your ABB contact for more information.
Copyright 2005 ABB Oy
All rights reserved.
1.2. Trademarks
ABB is a registered trademark of ABB Group. All other brand or product names
mentioned in this document may be trademarks or registered trademarks of their
respective holders.
1.3. General
The Protocol Mapping Tool (PMT) is used to create and edit the protocol mapping
configuration, which is a cross-reference table between the application and the
communication protocol. This table defines what information can be accessed from
the device using the protocol interface. As REM 54_, REF 54_, RET 54_, REC 52_
and REX 52_ terminals are programmable devices which may run various
application setups (different sets of function blocks), the mapping is also
reconfigurable.
The mapping can contain a lot of information the device needs, but which is not
necessarily important for viewing and changing from the configuration engineering
point of view. Therefore, the mapping will be presented as a list of accessible
protocol points instead of a spreadsheet-like table with all the rows and all the
attributes.
The Protocol Mapping Tool uses the relay configuration project to create a mapping
for a given application. After a mapping has been created, the user can modify it by
removing or adding points, changing their order and creating protocol compositions,
such as user-defined registers (bit-field and analog) or control structures.
7
CAP 505 1MRS755277
Resources
of Protocol
Mapping Tool
Relay configuration
Protocol
mapping file
Protocol Mapping
Tool
C
E
8
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
Chapter 5. Modbus, Chapter 6. DNP 3.0 and Chapter 7. IEC 60870-5-101 provide a
detailed description of the Protocol Mapping Tool features supporting the given
protocol.
Chapter 8. Troubleshooting contains frequently asked questions and their answers.
The tip icon indicates advice on, for example, how to design your
project or how to use a certain function.
Although warning hazards are related to personal injury, and caution hazards are
associated with equipment or property damage, it should be understood that
operation of damaged equipment could, under certain operational conditions, result
in degraded process performance leading to personal injury or death. Therefore,
comply fully with all warning and caution notices.
1.6. Terminology
9
CAP 505 1MRS755277
1.7. Abbreviations
10
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
2. General
The Protocol Mapping Tool is used for creating and editing the protocol mapping
configuration. It supports the editing of mappings for the following terminals and
protocols:
REM 54_
Modbus
REF 54_
DNP 3.0
Modbus
RET 54_
DNP 3.0
Modbus
REX 52_
DNP 3.0
REC 52_
IEC 60870-5-101
11
CAP 505 1MRS755277
Change the addresses and the order of points within a whole data category
Change the conversion factors of analog points
Add predefined structures to a mapping
Manage event definitions mapped as points within mapping
Export mapping information into HTML or text documents
The Protocol Mapping Tool provides certain features available exclusively for a
selected protocol and/or terminal, e.g. an unsolicited reporting disabling and
enabling provided for DNP 3.0 dependent mappings.
The Protocol Mapping Tool is described in detail in Section 4.2. Protocol Mapping
Tool.
Advanced
In the advanced mode the user can execute all the available editing features (i.e.
adding points).
Entering the advanced mode is not restricted, since the purpose of the two different
modes only is to minimize unwanted changes.
All the editing features are described in detail in Section 4.2.3.3. Mapping editing
12
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
3.1. Configuring a relay object for REF 54_, REM 54_ and RET 54_
The Protocol Mapping Tool is an object tool in CAP 505. However, it is not
available by default in the Project Structure Navigator for a newly created relay
object, and is generally available only for certain relay types and revisions.
To be able to use the Protocol Mapping Tool, the relay object has to be configured
so that the selected SW configuration (SW library and its revision) supports one or
more add-on protocols. During the configuration, the support availability of the add-
on protocol can be seen from the "Add-on protocol" list contents (see Fig. 3.1.-1).
As an example, a REF 543 relay and Modbus protocol is used here. The figures are
captured from the current versions of the related tools, so they are only to be
regarded as samples.
config_ref
13
CAP 505 1MRS755277
After the selections have been accepted, the Protocol Mapping Tool will appear on
the Object Tools list (see Fig. 3.1.-2). However, if the Protocol Mapping Tool is still
not visible in the project tree, the selections in the configuration dialog must be
checked.
ref_object_tools
14
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
config_rex
15
CAP 505 1MRS755277
rex_object_tools
16
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
config_REC52_
object_REC52_
17
CAP 505 1MRS755277
With REF 54_, REM 54_ and RET 54_ there are two cases, where
the opening might be prevented (see Fig. 3.4.1.-1 and Fig. 3.4.1.-2).
1. If no add-on protocol was selected during the relay object configuration, the tool
cannot be opened.
pmt_notification_1
Fig. 3.4.1.-1 Message shown during startup of the Protocol Mapping Tool, when
no add-on protocol has been selected.
2. If the selected add-on protocol is IEC 60870-5-103, the mapping is fixed in the
relay, and it needs not to be mapped by the Protocol Mapping Tool.
18
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
pmt_notification_2
Fig. 3.4.1.-2 Message shown during startup of the Protocol Mapping Tool, when
the add-on protocol selected does not need to be mapped by the
tool.
pmt_wizard
Fig. 3.4.2.-1 Creating a new protocol mapping with the Protocol Mapping Tool
wizard.
The fastest way to create a protocol mapping is to select Create New Mapping from
the wizard dialog and accept the default values provided by the wizard until the
Protocol Mapping Tool dialog is opened. Then, if the default mapping is accepted,
the mapping is ready to be saved. Otherwise, the editing features of the tool can be
utilized.
19
CAP 505 1MRS755277
pmt_export
Fig. 3.4.3.-1 Functions to export protocol mapping data for master system
configuration.
20
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
save_file
It is very important to check that the option "Save binary file" has
been set. Otherwise, the actual mapping file to be sent to the relay is
not created.
21
CAP 505 1MRS755277
Rdt_send_b
Downloading the relay configuration inactivates the add-on protocol and deletes
the protocol mapping. Therefore, also the protocol mapping must be sent again, if
the relay configuration is sent.
Due to the above, the protocol mapping must be received from the relay before
downloading the relay configuration, if the protocol mapping file is not available
elsewhere. The "RCT Project" does not include the protocol mapping file.
The protocol mapping file can also be downloaded separately, if the active add-on
protocol in the relay is the same as the one being downloaded.
The protocol mapping file for the IEC 60870-5-103 protocol is never used; it
does not need to be downloaded and cannot be uploaded. Downloading this
protocol only activates the protocol in the relay.
22
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
REM 54_ units do not yet support the setting of add-on protocol
parameters using the Relay Setting Tool. The parameters have to be
set locally.
rst_parameters
Fig. 3.5.1.-1 Setting add-on protocol related parameters for REF 54_
23
CAP 505 1MRS755277
3.5.2. Uploading protocol mapping from REF 54_, REM 54_ and
RET 54_
It is possible to upload the protocol mapping file from REF 54_, REM 54_ and
RET 54_. This is useful if the mapping in the relay has been modified or is unknown.
For more information, see Section 4.2.3.1. Opening of an existing mapping.
Rtd_receive_b
rdt_send_rex
24
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
Sending the protocol mapping file to REX 52_ is possible only with
the SPA protocol via the optical front panel connector. Rear
connectors (SPA or LON) are not supported for downloading.
However, receiving the protocol mapping from REX 52_ is possible
also via the rear connections.
The downloaded protocol mapping is taken into use immediately after a successful
mapping transfer and when the relay has been switched back to the protection mode.
rst_parameters_rex
25
CAP 505 1MRS755277
rdt_receive_rex
rdt_send_rec
26
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
The protocol mapping file for IEC 60870-5-101 can be downloaded either separately
or together with the configuration. Downloading of the relay configuration does not
affect the existing protocol mapping in REC 52_.
rst_parameters_rec
27
CAP 505 1MRS755277
rdt_receive_rec
28
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
wizard
Caption bar
The caption bar contains the full name of the Protocol Mapping Tool.
Menu bar
The menu bar provides access to the Help menu. The content of this menu is
presented in Section 4.2.1.4. Help menu
29
CAP 505 1MRS755277
Processing context
The processing context presents basic information describing the edited mapping
and contains:
The application name (i.e. relay object title) with the related device name and its
revision
The protocol name
Function buttons
The function buttons allow the user to choose the operation to be performed.
Available operations are described in detail in Section 4.1.1. Creating a new
mapping - Section 4.1.4. Deleting mapping
Navigation buttons
Navigation buttons allow the user to move between the steps in the Wizard.
The Exit button quits the Protocol Mapping Tool
Note: If the Wizard is started from the Protocol Mapping Tool, Exit is replaced by
Cancel button, which quits the Wizard and returns to the Protocol Mapping Tool.
The Next/Finish button moves to the next Wizard step or switches to the Protocol
Mapping Tool
The Back button moves to the previous Wizard step
30
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
wizard_opn
31
CAP 505 1MRS755277
wizard_imp
32
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
wizard_imp2
33
CAP 505 1MRS755277
look_REM_desc
Caption bar
The caption bar contains the full name of the Protocol Mapping Tool followed by
the names of the selected add-on protocol and of the edited mapping file (see
Fig. 4.2.-1).
If the name of the mapping file has not already been set, the word "Untitled" will be
shown instead.
If the edited mapping has been changed but not yet saved, the mapping file name
will be followed by an asterisk (*).
34
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
Menu bar
The menu bar provides access to the File, Edit, Settings and Help menus. The
contents of the listed menus are described in Section 4.2.1. Description of menu
items and toolbar buttons
Toolbar
The toolbar provides fast access to most of the Menu bar functions. A description
and instructions on how to use of the buttons are provided in Section 4.2.1.
Description of menu items and toolbar buttons.
Mapping tree
The mapping tree is the main area of the Protocol Mapping Tool. The mapping tree
provides a tree structure, which presents points stored within a mapping as leaves in
a tree. This is described in greater detail in Section 5.2. Mapping tree for Modbus,
in Section 6.2. Mapping tree for DNP 3.0 and in Section 7.2. Mapping tree for IEC
60870-5-101.
Pop-up menu
The pop-up menu is available in the area of the mapping tree. It provides the most
common editing operations of points currently selected within the mapping tree.
Details concerning the pop-up menu are available in Section 4.2.2. Description of
the pop-up menus.
Status bar
The status bar presents the basic information of the mapping (see Fig. 4.2.-2).
status_bar_REM
35
CAP 505 1MRS755277
menu_file
Exit
This function exits the program. The program asks whether the user wants to save
unsaved changes or not before exiting.
36
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
menu_edit_rem
Fig. 4.2.1.2.-1 The Edit menu for Modbus mapping (in the Advanced mode)
menu_edit_dnp
Fig. 4.2.1.2.-2 The Edit menu for DNP 3.0 mapping (in the Advanced mode)
37
CAP 505 1MRS755277
menu_edit_IEC101
Fig. 4.2.1.2.-3 The Edit menu for IEC 60870-5-101 mapping (in the Advanced
mode)
Add Points
This menu item allows the user to add new points into an edited mapping. More
information concerning the adding of points is available in Section 4.2.3.3. Mapping
editing under Adding new points.
Toolbar button:
plus
Delete Points
minus
38
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
This menu item allows the user to change the base address of the selected data
category. More information can be found in Section 5.4. Complex structures under
Base address editing.
Cut Points
This menu item provides the way to select some points in a mapping in order to paste
them into a different location. Cut Points is presented in Section 4.2.3.3. Mapping
editing under Cut and paste operations.
Toolbar button:
sciz
Paste Points
The Paste Points function is available for performing the pasting of points into a
different location. Details are available in Section 4.2.3.3. Mapping editing under
the heading Cut and paste operations.
Toolbar button:
paste
39
CAP 505 1MRS755277
Patterns are function block specific resource files used by PMT. They describe what
kind of data and how the data of a function block is mapped for a protocol.
This option compares the mapping content with patterns and allows fixing all the
detected errors and problems. More information can be found in Section 4.2.3.4.
Verification against patterns.
Keyboard shortcut: <Ctrl>+<A>
menu_settings_rem
menu_settings_dnp
Fig. 4.2.1.3.-2 The Settings menu of DNP 3.0 and IEC 60870-5-101
40
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
menu_settings_mode
menu_settings_address
41
CAP 505 1MRS755277
Note! All SCADA register numbers and bit numbers are zero-based counters.
menu_help
About
The About dialog contains the versions of the Protocol Mapping Tool and the pattern
library supported by the tool.
menu_popup_ref
42
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
Fig. 4.2.2.-2 shows the components of the pop-up menu shown for the DNP 3.0
mapping tree in the main window:
menu_popup_dnp
menu_popup_IEC101
4.2.2.1. Menu items shared by Modbus, DNP 3.0 and IEC 60870-5-101
Change base address
This pop-up menu item allows the user to change the base address of the selected
data category. This menu item is described in detail in Section 5.4. Complex
structures under Base address editing.
Change conversion factor
This pop-up menu option is used to edit conversion factors of selected analog
registers. See Section 4.2.3.5. Conversion factor editing for more details.
43
CAP 505 1MRS755277
44
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
rod
45
CAP 505 1MRS755277
The creation of a new mapping is always supervised by the Protocol Mapping Tool
Wizard dialog. If a currently edited mapping is changed but not saved, the Protocol
Mapping Tool will show a message box which induces the user to save a modified
mapping.
For more information on the mapping creation process for Modbus, refer to Section
5.1.1. Creating a new mapping; for DNP 3.0, refer to Section 6.1.1. Creating a new
mapping and for IEC 60870-5-101, refer to Section 7.1.1. Creating a new mapping.
cap_open
During this operation the mapping browser window will be shown to enable the
selection of an existing mapping.
In the browser each stored mapping is marked with the following icon in the file tree
(see Fig. 4.2.3.1.-1 below):
fpp
46
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
prj_browser
A binary file is created when an edited mapping is saved with the Save binary file-
option. In this case, the association between mapping and binary files is established.
Mapping with an associated binary mapping file is marked with the following icon:
fppjbin
It is possible that in the beginning only a binary mapping file will be available for a
certain object. In this case, it will be marked with the following icon:
fbin
If a mapping, with an associated binary mapping file is changed, but the associated
binary mapping file is not updated, it will also appear in the tree as a separate node
(because the association no longer exists).
The Delete mapping file button allows the user to remove any mapping file, which
exists in the browsed location. Neither a binary file nor a mapping file related to the
binary file can be deleted.
47
CAP 505 1MRS755277
cap_save
save
48
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
49
CAP 505 1MRS755277
plus
add_rem
50
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
The user may also select a point and click the << button to remove that point from
the right tree. More than one point can be selected.
When the user presses the OK button, all the points stored in the right tree are added
to a current mapping at the end of the current point list.
To see the points available for another pattern, the user has to select an appropriate
pattern in the top-most combo box called Points of function block (see
Fig. 4.2.3.3.-1).
If required, unnecessary points can be removed from the mapping. The Protocol
Mapping Tool removes the currently selected points.
To start this operation the user should:
Select Delete Points from the Edit menu or
Select the following toolbar button:
minus
delete_confirm
51
CAP 505 1MRS755277
sciz
cut_points
paste
52
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
drag_cursor
drag_operation
Constant 0 points
A Constant 0 point is a special point that has a conversion factor equal to
DUMMY_0. All Constant 0 points always return 0 and have no special meaning.
Therefore, they can be used to fill gaps between two separated sub-ranges of points
within the same data category (see Fig. 4.2.3.3.-6).
constant_0_reg
Verification against patterns compares existing points in the mapping with the points
defined in the current patterns. If differences are found, the user is notified and given
a chance to change such points within the mapping.
53
CAP 505 1MRS755277
mapp_ver_window
msg_error
2. Warnings
msg_warning
3. Informative
msg_info
To solve the problems shown by the mapping verification, the user has to check the
appropriate check boxes and press the Fix Selected button. Errors and warnings have
their check boxes selected by default.
54
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
Common messages:
Address space is not continuous Error Points readdressed
Point already existing in the mapping Informative Point removed
Missing point found in pattern Warning Point added to the mapping
Point added from not default pattern Warning Point removed
Point not existing in pattern Error Point removed
Unknown point found in pattern Error Point removed
Unknown error detected (Invalid flag Warning Flag cleared
active)
Incorrect block detected (No block flag Warning Flag cleared
active)
Incorrect point definition detected (No Warning Flag cleared
object flag active)
Point updated (Corrected flag active) Warning Flag cleared
Incorrect number of events Error Events restored
(row #) Incorrect database name Error Database name restored
(row #) Incorrect datatype Error Datatype restored
(row #) Incorrect IU flags Warning IU flags restored
Editable conversion factor changed by a Informative Default conversion factor restored
user
Point having incorrect conversion factor Warning Default conversion factor restored
Modbus specific messages:
Pack registers corrupted Error Pack registers restored
Missing change detect signal Error Change detect signal restored
Orphaned change detect signal Error Change detect signal removed
User-defined registers
Empty user-defined register Error User-defined register removed
User register maps an already mapped Warning User-defined register removed
analog registers
User register in slot # maps an already Warning Slot # cleaned up
mapped binary register
Control structures
Control structure corrupted Error Control structure removed
Missing control point found in pattern Warning Control point added to the mapping (but not
added to a control structure)
Control point added from not default Warning Control point removed
mapping
Control point not existing in pattern Error Control point removed
55
CAP 505 1MRS755277
When the Fix Selected button is clicked, all the verification differences having their
check boxes checked are fixed. However, they are not all removed from the list but
are distinguished by changing their background color into light green (see
Fig. 4.2.3.4.-2).
56
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
mapp_ver_wind_fixed
mapp_ver_wind_removed
conv_factor_editor
57
CAP 505 1MRS755277
The conversion factor editing is possible only for analog points of data type
EV_REAL and one of the conversion factors listed above set. Other analog points
have the operation disabled.
If the operation is executed for more than one register and the
selected registers have no common conversion factor, the conversion
factor editor will present the "Multiply by 1" value by default
(regardless of conversion factors being set within all edited
registers).
58
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
5. Modbus
This chapter provides detailed description of all the Protocol Mapping Tool features
supporting the Modbus protocol.
wizard_new
59
CAP 505 1MRS755277
REM 54_terminal
wizard_iec
Fig. 5.1.1.-1 Choosing the point base addresses of data categories (for the REM
54_ terminal).
Supported data types:
Coils
Digital Inputs
Input Registers
Holding Registers
Category of data points:
Process Data (basic): state values mapped to Digital Inputs (basic address range
of Digital Inputs)
Process Data (extended): two Digital Inputs points per signal - state value
followed by momentary Change detect bit in the consecutive address (extended
address range of Digital Inputs)
Slowly Changing: Slowly changing binary data (without change events)
Control: Control parameters
Diagnostics: Diagnostic parameters
60
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
wizard_ref
Fig. 5.1.1.-2 Choosing the point base addresses of data categories (for REF 54_
and RET 54_ terminals).
After performing this step, the Protocol Mapping Tool will open with a new
mapping.
mapping_tree
Fig. 5.2.-1 A piece of mapping tree showing its branches and leaves
The number of categories/subcategories and the way points are mapped into those
categories depend on the selected application.
61
CAP 505 1MRS755277
If a mapping is read from a device, some points may have warning flags set. There
are four warning flags:
1. Invalid (entry for a given point contains invalid information - point removed
from the data map)
2. Corrected (the entry for a given point contained incorrect information and was
corrected by the device during mapping parsing)
3. No block (the device application does not have a function that contains this data
- point removed from the data map)
4. No object (the device application does have a function, but there is no such data
item - point removed from the data map)
Tree nodes, which represent registers with warning flags set, have different
background colors (see Fig. 5.2.-2):
Purple background color indicates object flag set
Light green background color indicates no block flag set
Yellow background color indicates corrected flag set
Red background color indicates incorrect flag set
warning_flags_modbus
Fig. 5.2.-2 The example of tree nodes indicating active warning flags
When the user leaves the cursor over a tree node for a while, a tooltip window will
be shown (see Fig. 5.2.-3).
tooltip_modbus
62
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
tooltip_datac
63
CAP 505 1MRS755277
mt_modbus_rem
Fig. 5.3.1.-1 Data categories within a mapping tree for REM 54_
64
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
mt_modbus_ref
Fig. 5.3.2.-1 Data categories within a mapping tree for the REF 54_ and
RET 54_
lowhigh_word_reg
65
CAP 505 1MRS755277
analog_reg_conv_factor
user_registers
66
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
tooltip_modbus_ura
tooltip_modbus_urb
Pack Registers
Pack registers are provided for packing a sequence of digital signals in the order
determined by the order of coils on the Modbus map. Each pack register contains up
to 16 binary points mapped from basic and extended process data ranges of coils.
Pack registers are read-only registers, which are created automatically when a
mapping is created and updated any time a mapping is changed.
Pack registers are stored as holding registers in a separate data category (see
Fig. 5.4.-6).
67
CAP 505 1MRS755277
pack_registers
tooltip_modbus_pr
68
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
The user can insert a Constant 0 point by selecting the "Insert Constant 0" option:
In the Edit menu or
From the Edit window's pop-up menu
A Constant 0 point is always put just behind points selected as a destination location.
If the user wants to put a Constant 0 point at the beginning of the data category, the
data category branch must be selected as a destination location.
Constant 0 points are also used to replace not supported points during the mapping
file import.
Add 15 constant 0 points to the end of the data category. That makes
it possible to define the polling topic easier. The topic needs to be a
number of full 16 bits words. If the topic contains more bits than
exists in the relays data category, the relay answers nothing to the
poll.
The "Change base address" pop-up menu item allows the user to change the base
address of the selected data category.
As a result, all the registers within such a data category are readdressed.
A dialog box is used to enter a new base address (see Fig. 5.4.-8).
base_address_edition
69
CAP 505 1MRS755277
modbus_addr_ed1
Fig. 5.4.-9 The order of Modbus data categories before the base address change
Changing the base address of the "Pack registers" data category (from address 1024
to address 510) will change the sequence of data categories as well - "Pack registers"
category is ahead of "Process data extended range" category (see Fig. 5.4.-10).
modbus_addr_ed2
Fig. 5.4.-10 The order of Modbus data categories after the base address of "Pack
registers" category was changed to address 510.
Apart from that, the overlapping check operation proceeded (it is active by default)
and moved the overtaken category (from address 512 to address 524) to avoid the
address conflicts.
Overlapping check
70
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
The Auto Check menu toggle in the Overlapping submenu within the Edit menu is
also available. It is used to enable/disable the automatic start of the Overlapping
check procedure each time the mapping has been changed during the editing.
By default, auto check is enabled.
create_ur
ur_create
71
CAP 505 1MRS755277
an_ur
duplicates_analog
72
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
bf_ur
duplicates_binary
Fig. 5.4.-15 Warning message seen, when a duplicate of a binary register is found
73
CAP 505 1MRS755277
If the Check duplicates before user register added option in the Settings menu is
unchecked, the PMT does not show any warning. The user can also quickly uncheck
this option when the warning is shown (see Fig. 5.4.-15 above).
To remove already added binary register, the user has to select such an item in the
right tree and press the << button.
The order of added binary registers can always be changed by using the drag&drop
operation.
The user is able to change any of the existing user registers:
By selecting User Register in the Change submenu in the Edit menu or
By selecting the following toolbar button:
change_ur
y selecting Change User Register in the Protocol Mapping Tool window's pop-up
menu
First of all, the user has to select which user register must be edited. Fig. 5.4.-16
allows the user to set the identification number of the required user register:
ur_edit
74
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
an_ur_edit
bf_ur_edit
75
CAP 505 1MRS755277
The editing of user register proceeds in the same manner as if the user register has
only just been created.
Fore details on user registers see Section 5.4. Complex structures under User
Registers (User-Defined Registers).
menu_edit_rem
menu_edit_create_ref
By selecting the User Register menu item in the Create submenu of the Edit menu,
the creation of a new user register is started. This feature is described in Section 5.4.
Complex structures under User registers editing.
More information can be found in Section 5.4. Complex structures under User
Registers (User-Defined Registers).
76
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
Toolbar button:
create_ur
menu_edit_change_ref
By selecting this feature, the user is able to change any of already existing user
registers within the mapping. The description of the feature is available in Section
5.4. Complex structures under User registers editing.
Toolbar button:
change_ur
menu_edit_overlapping
Check overlapping
This menu option starts the procedure of the data category address range checking
within Modbus data types to determine whether any data category begins at a
memory address, which is reserved by registers belonging to another data category.
The Overlapping check is described in detail in Section 5.4. Complex structures
under Overlapping check.
77
CAP 505 1MRS755277
Auto check
Auto check is a menu toggle used to enable/disable the automatic start of the
overlapping check procedure each time the mapping has been changed during the
editing. The "Overlapping check" is described in detail in Section 5.4. Complex
structures under Overlapping check.
menu_settings_rem
menu_popup_ref
78
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
All pop-up menu items make sense only for certain types of tree nodes and each pop-
up menu item is enabled only when the user selects the appropriate type of tree node
within the mapping tree.
79
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
6. DNP 3.0
This chapter provides a detailed description of all the Protocol Mapping Tool
features supporting the DNP 3.0 protocol.
wizard2_new
81
CAP 505 1MRS755277
wizard4_dnp
82
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
wizard5_dnp
Fig. 6.1.1.-2 Choosing the point base addresses of data categories (for DNP 3.0
protocol).
After performing this step, the Protocol Mapping Tool will open with a new
mapping.
mapping_tree_dnp
Fig. 6.2.-1 Data objects within the DNP 3.0 mapping tree
Data objects are represented by branches with the following icon:
gategory
DNP 3.0 points can produce both static and dynamic (event) information. It can be
determined by a tree node icon set for a tree node representing a single register:
83
CAP 505 1MRS755277
points3
2. Node containing only events (static information is also available, but is based on
the value of the last triggered event)
events3
points_events3
If a mapping is read from a device with the Relay Download Tool, some points may
have warning flags set. There are four warning flags:
Invalid (the entry for a given point contains invalid information - point removed
from data map)
Corrected (the entry for a given point contained incorrect information and was
corrected by the device during mapping parsing)
No block (the device application does not have a function that contains this data -
point removed from the data map)
No object (the device application does have a function, but there is no such data
item - point removed from the data map)
Tree nodes representing registers with warning flags set have different background
colors (see Fig. 6.2.-2):
Purple background color indicates object flag set
Light green background color indicates no block flag set
Yellow background color indicates corrected flag set
Red background color indicates incorrect flag set
warning_flags
Fig. 6.2.-2 Example of tree nodes indicating the active warning flags
84
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
When the user leaves the cursor over a tree node for a while, a tooltip window will
be shown (see Fig. 6.2.-3).
tooltip_dnp
tooltip_datac
85
CAP 505 1MRS755277
Internal indications
Internal indication are information elements used to convey internal states and
diagnostic results of a responding station. This information can be used by a
receiving station to perform error recovery or other functions.
The definitions of internal indications are stored in a separate data category called
Internal Indications within DNP 3.0 mapping. The Internal Indication data category
is not editable and is composed of 16 binary points.
The meaning of 16 internal indications is specified in Table 6.4.-1 below:
86
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
The "Change base address" pop-up menu item allows to change the base address of
the selected data category. As a result, all registers within such a data category will
be readdressed. A dialog box is used to enter a new base address (see Fig. 6.5.-1
below).
base_address_dnp
Removing events
This operation removes the event definitions from points defined within the
mapping.
The Protocol Mapping Tool provides two ways of removing events:
1. Removing all events within all the defined points either by selecting Remove
All Events in the Edit menu or by selecting the following toolbar button:
remove_events
2. Removing events within the currently selected points by selecting Remove
Events in a pop-up menu.
Such an action must be confirmed (see Fig. 6.5.-2).
87
CAP 505 1MRS755277
remove_events_confirm
urep1
To enable UR flags only for currently selected points, the user has to choose Enable
UR flags in a pop-up menu.
Similarly, the following ways can be used to disable all unsolicited reporting flags
for events within all defined static points:
By selecting Disable All UR Flags in the Edit menu or
By selecting the following toolbar button:
urep0
To disable UR flags only for selected points, the user needs to choose Disable UR
Flags within a pop-up menu.
Class assignment
Class assignment is used to set an appropriate class to events provided by currently
selected points.
Fig. 6.5.-3 is used to assign class (see below):
88
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
class_editor
If operation is executed for more than one point, the class editor will
present a "Not assigned" value by default (regardless of class values
being currently set within all edited points).
menu_edit_dnp
89
CAP 505 1MRS755277
Assign Class
This menu option is used to set the appropriate class to events produced by the
currently selected points. More information is provided in Section 6.5. Mapping
editing features under Class assignment.
urep1
urep0
This operation removes the event definitions from all registers defined within the
mapping. More information is provided in Section 6.5. Mapping editing features
under Removing events.
Toolbar button:
remove_events
90
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
menu_popup_dnp
Disable UR Flag
This menu option disables the unsolicited reporting flags of all currently selected
points. Section 6.5. Mapping editing features under Unsolicited reporting
management provides more information.
Enable UR Flag
This menu option enables the unsolicited reporting flags of all currently selected
points. Section 6.5. Mapping editing features under Unsolicited reporting
management provides more information.
Remove Events
This menu item deletes event definitions from all currently selected points. Section
6.5. Mapping editing features under Removing events provides more information.
Assign Class
Assign Class menu option is used to set the appropriate class to events produced by
currently selected points. Section 6.5. Mapping editing features under Class
assignment provides more information.
91
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
7. IEC 60870-5-101
This chapter provides detailed description of the Protocol Mapping Tool features
supporting the IEC 60870-5-101 protocol.
A050092
93
CAP 505 1MRS755277
A050093
94
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
A050094
95
CAP 505 1MRS755277
The user can decide what type should be used (see Fig. 7.1.1.-3).
A050095
96
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
A050096
Fig. 7.1.1.-4 Choosing the point base addresses of data categories (decimal
values).
A050097
Fig. 7.1.1.-5 Choosing the point base addresses of data categories (hexadecimal
values).
97
CAP 505 1MRS755277
A050098
Fig. 7.2.-1 Data objects within the IEC 60870-5-101 mapping tree
The root node indicates the current addressing convention (fixed or continuous).
Data categories (ASDU types) are represented by branches with the following icon:
A050099
Tree nodes can contain both static and dynamic (event) information. It can be
determined by a node icon set for a tree node representing a single point:
1. Node containing only static points
A050100
2. Node containing only events
A050101
3. Node containing both static points and events
A050102
98
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
If a mapping is read from a device with the Relay Download Tool, some points may
have warning flags set. There are four warning flags:
Invalid (the entry for a given point contains invalid information - point removed
from data map)
Corrected (the entry for a given point contained incorrect information and was
corrected by the device during mapping parsing)
No block (the device application does not have a function that contains this data
- point removed from the data map)
No object (the device application does have a function, but there is no such data
item - point removed from the data map)
Tree nodes representing points with warning flags set have different background
colors (see Fig. 7.2.-2):
Purple background color indicates object flag set
Light green background color indicates no block flag set
Yellow background color indicates corrected flag set
Red background color indicates incorrect flag set
A050103
Fig. 7.2.-2 Example of tree nodes indicating the active warning flags
When the user leaves the cursor over the tree node for a while, a tooltip window will
be shown (see Fig. 7.2.-3).
A050104
A050105
99
CAP 505 1MRS755277
Double point information (M_DP) nodes are used to represent state of two bit
encodes binary points (hardware or software) such as breaker position.
Measured values (M_ME) nodes are information objects used to represent
hardware or software analog points. Their values can represent digitized signals
or calculated values.
Integrated totals (M_IT) represent the accumulated values. They can be
accumulated pulses or transitions from hardware or software points.
Bit strings in monitoring direction (M_BO) nodes represent values for reading
that can be treated as bit masks.
Strings in monitoring direction (M_SR) nodes represent strings of characters that
can be read from the device.
Single command (C_SC) nodes are used to make control commands on relays by
using one bit convention for encoding desired position.
Double command (C_DC) nodes are used to make control commands on relays
by using two bit convention for encoding desired position.
Set point commands (C_SE) nodes are used to set new value of analog output
points.
Bit strings in control direction (C_BO) nodes represent values for writing that can
be treated as bit masks.
Strings in control direction (C_SR) nodes represent strings of characters that can
be written.
Clock read command (C_CS) nodes represent devices current time of day and
date.
The "Change base address" menu item (in Edit menu and pop-up menu) allows to
change the base address for the selected data category. As a result, all the points
within such a data category will be readdressed. The following dialog is used to enter
a new base address (see Fig. 7.4.-1).
A050106
100
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
A050107
A050108
101
CAP 505 1MRS755277
A050109
A050110
The following dialog is used to set new base addresses for all data categories (see
Fig. 7.5.1.-2).
102
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
A050111
103
CAP 505 1MRS755277
A050112
104
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
8. Troubleshooting
This chapter provides answers to some frequently asked questions.
Some menu and pop-up items are disabled all the time. How to
activate them?
Some menu and pop-up items are enabled only if the appropriate nodes are selected
in the mapping tree (the pop-up menu's "Change base address" operation is enabled
when a data category node is selected).
The second reason why a menu/pop-up item is not available all the time is incorrect
working mode. The Protocol Mapping Tool provides two working modes: basic and
advanced. Some editing features can be used only in the advanced working mode. If
you need more information about working modes, see Section 2.2.1. Working
modes The switching between working modes is described in Section 4.2.1.3.
Settings menu under Working Mode submenu.
105
CAP 505 1MRS755277
save
106
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
The overlapping check is also capable of moving all points belonging to one of the
data categories into the nearest unallocated location. Such an operation allows to
avoid possible conflicts between points having the same Modbus address. The
overlapping check is described in Section 5.4. Complex structures under
Overlapping check.
More information concerning the data category moving is available in Section 5.4.
Complex structures under Base address editing. If you need more information about
Modbus data types and categories, see Section 5.2. Mapping tree
107
1MRS755277 CAP 505
Protocol Mapping Tool
Appendix A
9. Appendix
109
CAP 505 1MRS755277
Address
<Data Category> = PDB | PDE | SCH | CTL | DGN | PRG | DDE {PDB-process
data basic, PDE-process data extend., SCH-slowly changing, CTL-control,
DGN-diagnostics, PRG-pack registers, DDE-device data}
Example rows:
CO 0001 (PDB) F014O001 PS1_14-D: Output 1 state Y F014E014/ F014E015
- 0/1 -
HR 0002 (PDE) F200I001 MECU3A-D: IL1 Y - MUL_100 0.020000.0 [A]
HR 2368 (PRG).09bit F014I003 PS1_14-D: Input 3 state Y F014E004/
F014E005 - 0/1 -
2. In case of a DNP 3.00 Address = <Object Type> <Point> where all the elements
are separated by a space character and
<Object Type> = BI | BO | AI | AO | CT | TM | AP | II {BI-binary input, BO-
binary output/control relay output block, AI-analog input, AO-analog output/
analog output block, CT-counter, TM-timers, AP-application, II-internal
indication}
<Point>= {a decimal address within the data type identified by <Object Type>}
e.g.
BI 0127
AP 0001
Example rows:
BI 0007 F014O001 PS1_14-D: Output 1 state 1 Y F014E014/F014E015
- 0/1 -
AI 0001 F016O001 RTD1_16-D: Output 1 value - - - MUL_1000
-10000.00000 10000.00 [mA]
110
1MRS755277 CAP 505
Protocol Mapping Tool
Appendix A
Example rows:
M_SP 00000 F031O001 NOC3Low-D: Output START
F031E000/F031E001 1 0 -0..1-
111
CAP 505 1MRS755277
DB name
DB name is the signal identifier in the terminal. When so-called shadow points are
reported, the exported DB name will be composed of several identifiers separated by
a backslash "/".
e.g.
BI 0183 F200E20/F200E21 MECU3A-D: IL2 low alarm reset - - F200E20/
F200E21 - 0/1
Explanation
Description of the signal.
Scaling factor
This field describes the conversion factor applied for the appropriate static point.
For MODBUS protocol:
MUL_1000_SIGNED, MUL_100_SIGNED, MUL_10_SIGNED,
MUL_1_SIGNED, MUL_1000, MUL_100, MUL_10,NO_OPERATION, DIV_10,
DIV_100, DIV_1000, DIV_10_SIGNED, DIV_100_SIGNED,
DIV_1000_SIGNED
For DNP protocol:
MUL_1000, MUL_100, MUL_10, NO_OPERATION, DIV_10, DIV_100,
DIV_1000
For IEC 60870-5-101 protocol:
FLOAT_UINT, FLOAT_SINT10, FLOAT_SINT100, FLOAT_SINT1000,
FLOAT_SINT01, FLOAT_SINT001, FLOAT_SINT0001,
Read only
Marks whether a static signal is writable. Field may be equal to:
Y - readable only
N - writable/readable
112
1MRS755277 CAP 505
Protocol Mapping Tool
Appendix A
Event class
The event class column describes the class set for events associated with an exported
static signal.
The following single characters are used:
Unsolicited reporting
Marks whether unsolicited reporting is activated. Field may be equal to:
Y - unsolicited reporting activated
N - unsolicited reporting turned off
Value range
This column provides a value range of the exported static point.
The field provides the real range of values possible for the static point (the value
carried by a protocol may be different because the appropriate scaling factor is taken
into account).
In case of binary signals the value range is always equal to 0/1.
Unit
This field provides the unit of measure of the exported point.
The field matters for analog static points only.
Data class
This column describes the data class priority set for the exported signals.
The following values are allowed:
1 - High Priority
2 - Low Priority
113
CAP 505 1MRS755277
114
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
10. Index
A
Abbreviations ........................................................................................... 10
Adding new points .................................................................................... 50
Analog inputs ............................................................................................ 85
Analog output block information objects ................................................. 85
Analog output status information objects ................................................. 85
Analog User Register ............................................................................... 71
Appendix ................................................................................................ 109
ASDU type ......................................................................................... 96, 98
B
Binary counter .......................................................................................... 85
Binary output objects ................................................................................ 85
Bit Field User Register ............................................................................. 73
C
Class assignment ...................................................................................... 88
Communication interface configuration ..................................................... 8
Complex structures (DNP)
Analog points having an editable conversion factor .......................... 86
Internal indications ............................................................................. 86
Complex structures (Modbus) .................................................................. 65
Analog points having an editable conversion factor .......................... 65
Base address editing ........................................................................... 69
Creation of Constant 0 points ............................................................. 69
Low Word/High Word Analog Registers ........................................... 65
Pack Registers .................................................................................... 67
User Registers (User-Defined Registers) ........................................... 66
Configuring a relay application .......................................................... 14, 18
Control relay output block information object ......................................... 85
Conversion factor ............................................................................... 65, 86
Conversion File Address Format .............................................................. 41
Copyrights .................................................................................................. 7
Creation of Constant 0 points ................................................................... 69
D
Dealing with unsupported points .............................................................. 32
Description of menu items and toolbar buttons ........................................ 35
DNP protocol ............................................................................................ 81
Dummy points .......................................................................................... 32
E
Edit menu .................................................................................................. 37
Add Points .......................................................................................... 38
Change Base Address ......................................................................... 39
Change Conversion Factor ................................................................. 39
115
CAP 505 1MRS755277
116
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
Mapping edition
Cut & paste operations ....................................................................... 51
Removing existing points ................................................................... 51
Mapping export ........................................................................................ 49
Exporting of mapping information ..................................................... 49
Exporting of point information ........................................................... 49
Mapping management
Creating a new mapping ..................................................................... 45
Opening of an existing mapping ......................................................... 46
Saving an edited mapping .................................................................. 48
Mapping tree ....................................................................................... 61, 83
Modbus protocol ....................................................................................... 59
Data categories ................................................................................... 63
Data objects ........................................................................................ 63
Data types ........................................................................................... 63
O
Overlapping check .................................................................................... 70
P
Pop-up menu (DNP specific)
Assign Class ................................................................................. 44, 91
Disable UR Flag ........................................................................... 44, 91
Enable UR Flag ............................................................................ 44, 91
Remove Events ............................................................................. 44, 91
Pop-up menu (IEC 60870-5-101 specific) ............................................... 45
Assign General Interrogation Group .................................................. 45
Change Data Class .............................................................................. 45
Change Measurement Value Format .................................................. 45
Set continuous address space .............................................................. 45
Pop-up menu (Modbus specific)
Change User Register ................................................................... 44, 79
Pop-up menus
Change base address ........................................................................... 43
Change conversion factor ................................................................... 43
Cut points and Paste points ................................................................. 44
Hex points/decimal points .................................................................. 44
Insert constant ..................................................................................... 44
Process Data Basic Range ........................................................................ 66
Protocol Mapping Tool ............................................................................. 34
Protocol Mapping Tool editor .................................................................. 11
Caption bar ......................................................................................... 34
Mapping tree ................................................................................. 34, 35
Menu bar ....................................................................................... 34, 35
Pop-up menu ................................................................................. 34, 35
Status bar ...................................................................................... 34, 35
Tool bar .............................................................................................. 34
117
CAP 505 1MRS755277
118
1MRS755277 CAP 505
Protocol Mapping Tool
Operation Manual
T
Time and date objects ............................................................................... 85
Tooltips for a bit-field user register .......................................................... 67
Trademarks ................................................................................................. 7
Tree nodes ................................................................................................ 62
U
Unsolicited reporting management ........................................................... 88
UR flag ..................................................................................................... 88
User analog register .................................................................................. 66
User bit-field register ................................................................................ 66
User registers editing ................................................................................ 71
User-defined registers ................................................................................. 7
V
Verification against patterns ..................................................................... 53
W
Warning flags ..................................................................................... 62, 84
Corrected ...................................................................................... 62, 84
Invalid ........................................................................................... 62, 84
No block ....................................................................................... 62, 84
No object ...................................................................................... 62, 84
Working modes ........................................................................................ 12
119
1MRS755277 EN 03.2005 EN
ABB Oy
Distribution Automation
P.O. Box 699
FI-65101 Vaasa
FINLAND
Tel. +358 10 22 11
Fax. +358 10 224 1094
www.abb.com/substationautomation