You are on page 1of 89

Microsol Workbench

User Manual

Version 2.2.0
Workbench User Manual Version 2.2.0

© Microsol Limited 2004

This document contains proprietary information


of Microsol Limited. The information and designs
in the document are covered by international
copyright and a number of international patents
existing and pending. Microsol, and its legally
appointed licensees, reserve the right to seek full
redress in the case of any infringement.

The information in this document is subject to


change without prior notice. Microsol does not
assume responsibility for any errors in fact or
design in this publication. Specifications can and
do vary in different applications. The publication
is provided for general information only and shall
not form part of any contact.

Page 2 of 89
Workbench User Manual Version 2.2.0

1 Contents

1 Contents .................................................................................................... 3
2 Reference Documents.............................................................................. 8
3 Introduction............................................................................................... 9
3.1 Minimum System Requirements ................................................................ 9
3.2 Installing Workbench ................................................................................ 10
3.3 Uninstalling Workbench............................................................................ 14
3.4 Upgrading Workbench .............................................................................. 14
3.5 Starting Workbench................................................................................... 14
3.6 Basic and Advanced Versions ................................................................. 15
3.7 Security....................................................................................................... 15
3.7.1 Access Passwords ................................................................................ 15
3.7.1.1 Group Access Level........................................................................ 16
4 User Interface.......................................................................................... 18
4.1 The Workspace .......................................................................................... 18
4.2 Arranging Windows................................................................................... 19
4.2.1 Docking Tool Windows.......................................................................... 20
4.2.2 Hiding Tool Windows Automatically ...................................................... 21
4.2.2.1 To place a window in auto hide ...................................................... 21
4.2.2.2 To disable Auto Hide ...................................................................... 21
4.3 Menu Bar .................................................................................................... 22
4.3.1 File Menu .............................................................................................. 22
4.3.1.1 File - New........................................................................................ 22
4.3.1.2 File - Open ...................................................................................... 22
4.3.1.3 File - Close...................................................................................... 22
4.3.1.4 File - Save....................................................................................... 22
4.3.1.4.1 Project Information Box.............................................................. 23
4.3.1.5 File – Save As................................................................................. 24
4.3.1.6 File – Print....................................................................................... 24
4.3.1.7 File – Print Preview......................................................................... 24
4.3.1.8 File – Print Setup ............................................................................ 25
4.3.1.9 File – Open Recent Files ................................................................ 25
4.3.1.10 File - Exit ........................................................................................ 25
4.3.2 Edit Menu .............................................................................................. 25
4.3.2.1 Edit - Undo...................................................................................... 25
4.3.2.2 Edit – Redo ..................................................................................... 26
4.3.2.3 Edit - Cut......................................................................................... 26
4.3.2.4 Edit - Copy ...................................................................................... 26
4.3.2.5 Edit - Paste ..................................................................................... 26
4.3.3 View Menu ............................................................................................ 26
4.3.4 Window Menu ....................................................................................... 27
4.3.4.1 Window - Cascade.......................................................................... 27
4.3.4.2 Window – Tile ................................................................................. 27
4.3.4.3 Window- Select Specific Project ..................................................... 28

Page 3 of 89
Workbench User Manual Version 2.2.0

4.3.5 Help Menu ............................................................................................. 28


4.3.5.1 Help – About Xcell Workshop ......................................................... 28
4.3.5.2 Help – License Agreement ............................................................. 28
4.3.5.3 Help – Tip of the Day ...................................................................... 28
4.3.5.4 Help – Upgrade… ........................................................................... 29
4.3.5.5 Help – Context Sensitive ................................................................ 29
4.3.6 Tool Bar................................................................................................. 29
5 Configuration .......................................................................................... 30
5.1 General ....................................................................................................... 30
5.2 Profiles........................................................................................................ 31
5.2.1 Add a new profile .................................................................................. 31
5.2.2 Create new project ................................................................................ 31
5.2.3 Open old project .................................................................................... 31
5.3 Elements..................................................................................................... 32
5.3.1 Project Tab ............................................................................................ 32
5.3.2 Point Tab ............................................................................................... 33
5.3.3 Slave Protocols Tab .............................................................................. 33
5.3.4 Master Protocols Tab ............................................................................ 34
5.3.5 eXpress Tab .......................................................................................... 34
5.4 The Project Area ........................................................................................ 34
5.4.1 Project Hierarchy................................................................................... 35
5.4.1.1 Project Information.......................................................................... 36
5.4.1.2 View Project Change History .......................................................... 36
5.4.1.3 Project Report................................................................................. 36
5.4.1.4 Wiring List ....................................................................................... 37
5.4.1.5 Copy ............................................................................................... 37
5.4.1.6 Move ............................................................................................... 37
5.4.1.7 Link ................................................................................................. 37
5.4.1.8 Delete ............................................................................................. 37
5.4.2 Data Window ......................................................................................... 38
5.4.2.1 Cut .................................................................................................. 40
5.4.2.2 Copy ............................................................................................... 40
5.4.2.3 Paste............................................................................................... 40
5.4.2.4 Find................................................................................................. 41
5.4.2.5 Replace… ....................................................................................... 41
5.4.2.6 Add Record(s)… ............................................................................. 41
5.4.2.7 Insert Record .................................................................................. 41
5.4.2.8 Delete Record................................................................................. 41
5.4.2.9 Delete Selected Records ................................................................ 42
5.4.2.10 Set to Default ................................................................................. 42
5.4.2.11 Set.................................................................................................. 42
5.4.2.12 Interpolate ...................................................................................... 43
5.4.2.13 Definition ........................................................................................ 44
5.4.2.14 Properties....................................................................................... 45
5.4.3 The Messages Window ......................................................................... 45
5.4.3.1 Workbench Messages .................................................................... 45
5.4.3.2 Database Messages ....................................................................... 46
5.5 Multiple Projects ........................................................................................ 47
6 XCell Flash Programmer........................................................................ 48

Page 4 of 89
Workbench User Manual Version 2.2.0

6.1 Setting the XCell Processor to Debug Mode........................................... 48


6.2 Connection Set-up..................................................................................... 48
6.3 Reading the application inside the XCell ................................................ 48
6.4 Loading and Unloading S-Record Files................................................... 49
6.5 Memory Locations of Applications .......................................................... 49
6.6 Erasing an Application.............................................................................. 49
6.7 Erasing a Chip / Sector ............................................................................. 49
6.8 Calculating Chip CRC................................................................................ 49
6.9 Downloading Files ..................................................................................... 49
6.10 Resetting the XCell Processor .............................................................. 50
7 Configuration Download........................................................................ 51
7.1 General ....................................................................................................... 51
7.2 Establishing Communications with XCell ............................................... 51
7.3 Downloading the Current Project............................................................. 53
8 RTU Live .................................................................................................. 54
8.1 Introduction................................................................................................ 54
8.2 RTU menu................................................................................................... 55
8.2.1 Update All Units .................................................................................... 55
8.2.2 Project Sub-Menu ................................................................................. 55
8.2.2.1 Upload ............................................................................................ 55
8.2.2.2 Delete ............................................................................................. 55
8.2.2.3 DMF Downloader............................................................................ 55
8.2.3 RTU Database Messages Menu ........................................................... 56
8.2.4 Protocol Menu ....................................................................................... 56
8.2.5 Set Time Menu Item .............................................................................. 57
8.2.6 Drive Command Menu Item .................................................................. 58
8.2.6.1 Digital Output Drive Commands ..................................................... 58
8.2.6.2 Analog Output Drive Commands .................................................... 58
8.2.7 Request System Full Update ................................................................ 59
8.2.8 SOE Log................................................................................................ 59
8.3 The Unit Menu ............................................................................................ 60
8.3.1 Update................................................................................................... 60
8.3.2 Information Sub-Menu........................................................................... 60
8.3.2.1 Files ................................................................................................ 60
8.3.2.2 File System Statistics...................................................................... 60
8.3.2.3 IO Modules ..................................................................................... 61
8.3.2.3.1 I/O Data Values ......................................................................... 61
8.3.2.3.2 Output Drive Commands ........................................................... 61
8.3.2.4 Memory........................................................................................... 62
8.3.2.5 Named Blocks................................................................................. 62
8.3.2.6 Message Log .................................................................................. 62
8.3.2.7 Database Tables............................................................................. 63
8.3.3 Project Menu ......................................................................................... 63
8.3.3.1 Upload ............................................................................................ 63
8.3.3.2 NB Downloader… ........................................................................... 64

Page 5 of 89
Workbench User Manual Version 2.2.0

8.3.3.3 FFS Downloader… ......................................................................... 64


8.3.4 The Front Panel Display Menu.............................................................. 64
8.3.4.1 Group A, Group B, Group C and Group D...................................... 64
8.3.4.2 Online Units .................................................................................... 64
8.3.4.3 Debug ............................................................................................. 65
8.3.4.4 Restart Unit..................................................................................... 65
8.3.5 Database Messages Menu.................................................................... 65
8.4 Tagged data................................................................................................ 65
9 Tutorial – Simple RTU Configuration ................................................... 67
9.1 Start a New Project (Workbench 1) .......................................................... 68
9.2 Create an RTU with one bay and one unit in the bay ............................. 68
9.3 Add I/O and protocol nodes to the Unit ................................................... 69
9.4 Configure the I/O points and protocols ................................................... 70
9.4.1 SDI Configuration .................................................................................. 70
9.4.2 DOT Configuration ................................................................................ 71
9.4.3 AIN Configuration .................................................................................. 72
9.4.4 DNP3 Configuration .............................................................................. 72
9.5 Download complete configuration to an XCell RTU ............................... 73
9.6 Upload the archived configuration from the XCell. ................................ 73
10 Tutorial – IED Template....................................................................... 75
10.1 Start a New Project (Database 1) .......................................................... 76
10.2 Create Unit with one IED........................................................................ 77
10.3 Add Virtual I/O and protocol nodes to the IED .................................... 77
10.4 Configure the I/O points and protocols................................................ 78
10.5 Save the project...................................................................................... 78
10.6 Restart Workbench................................................................................. 78
11 Tutorial – IO Modules and Wiring list ................................................ 79
11.1 Start a New Project (Workbench 1)....................................................... 80
11.2 Create the RTU........................................................................................ 81
11.2.1 Create the Hierarchy for the first unit ................................................. 81
11.2.2 Add I/O Modules ................................................................................ 81
11.2.3 Add I/O Points.................................................................................... 83
11.2.4 Add More Units .................................................................................. 84
11.3 Create the Wiring List ............................................................................ 85
12 Glossary ............................................................................................... 86
13 Troubleshooting and Technical Support .......................................... 87
14 Appendix 1 Tutorial Configurations .................................................. 88
14.1 Tutorial SDI Configuration..................................................................... 88
14.2 Tutorial DOT Configuration ................................................................... 88
14.3 Tutorial AIN Configuration..................................................................... 89

Page 6 of 89
Workbench User Manual Version 2.2.0

14.4 Tutorial DNP3 Slave Gen Table Configuration .................................... 89


14.5 Tutorial DNP3 Slave Map Table Configuration .................................... 89

Page 7 of 89
Workbench User Manual Version 2.2.0

2 Reference Documents

The following documents should be used in conjunction with this document to


provide complete information for the configuration and use of the XCell product.

• XCell User Manual


• eXpress Users Guide

Page 8 of 89
Workbench User Manual Version 2.2.0

3 Introduction

Microsol Workbench is a Windows© based configuration and diagnostic tool. It


provides user-friendly system configuration with simple copy and paste facilities from
Excel© spreadsheets and simple intuitive interface. Configuration is done
independently on the PC and the resulting database is downloaded to the XCell
target system. The XCell product supports an upload facility whereby the
configuration can be uploaded from the product to reproduce the original PC
configuration.
In addition to system configuration, Workbench incorporates online diagnostic
facilities when connected to the Microsol XCell system. These diagnostic facilities
allow the user to view the state of all inputs and force outputs for test purposes. It
provides facilities to view internal XCell event data and system status information
such as memory allocation, software versions and configuration files.

This Manual provides an overview and operating instructions for Microsol


Workbench. The main body of the manual describes the Installation and general se
of the product and the appendices provide the details of each of the configuration
tables and their parameter settings.

3.1 Minimum System Requirements

The minimum requirement for installing and running Microsol Workbench are
outlined below:
• A 500MHz or better Pentium class PC processor
• 32 Mbytes or more of Random Access Memory (RAM)
• Minimum 40 Mbytes of Hard Disk Space for the program, additional hard disk
space will be required for storing the individual configurations
• A Windows supported graphics adapter supporting 12-bit colours or more and
a 4x CD-ROM drive.
• An RS-232 serial communications port, although this is not necessary to run
the configuration program you will not be able to download the configuration to
the target system or perform any online diagnostics without it.

Page 9 of 89
Workbench User Manual Version 2.2.0

3.2 Installing Workbench

To install Workbench on your computer you need to:

• Insert the installation CD into the CD-ROM drive.


• Double-click the My Computer icon on your desktop.
• Double-click the CD-ROM icon
• Double-click the ‘Setup.exe’ program icon, this should then start the
installation program and display the dialog shown in Figure 3-1.

Figure 3-1 Microsoft Installer - Welcome Screen

• If, at this point you do not wish to install ‘Workbench’, click ‘Cancel’,
otherwise click ‘Next’ and you will be presented with the Microsol
License Agreement.

Figure 3-2 Microsol License Agreement

Page 10 of 89
Workbench User Manual Version 2.2.0

• If you accept the Agreement click Next and you will be presented with
the Installation Folder Selection dialog

Figure 3-3- Select Installation Folder Screen

• Although it is recommended that you install the program into the default
folder you can use this dialog to select another location for the
installation. Additionally, Workbench can be installed in a single-user
(Just Me’ radio button) or multi-user (‘Everyone’ radio button) mode. It
is recommended to install the multi-user Everyone’ radio button.
• Although the disk space requirements of the program are modest you
may wish to check that sufficient space is available on your hard disk
using the ‘Disk Cost’ button. This will present you with a list of your hard
drives and the amount of space available for installation and the amount
of space required for installation of the program (currently ~30Mbytes).
Ensure that you install the program on a drive with sufficient space.
• Once you have finished the selections click ‘Next’ and the installer will
ask you to confirm the installation, as shown in Figure 3-4

Page 11 of 89
Workbench User Manual Version 2.2.0

Figure 3-4 Installation confirmation

• Once you have confirmed that it is OK to proceed by clicking ‘Next’ the


installation will start showing the progress bar as shown in Figure 3-5

Figure 3-5 Installation progression

• The final dialog will confirm the installation is complete and the
‘Workbench’ is ready to be used; this is shown in Figure 3-6.

Page 12 of 89
Workbench User Manual Version 2.2.0

Figure 3-6 Installation Completion

• Finally the installer will place the Microsol Workbench icon on your
desktop.

Figure 3-7 - Microsol Workbench Desktop icon

Page 13 of 89
Workbench User Manual Version 2.2.0

3.3 Uninstalling Workbench

If at any time you require to uninstall Workbench you will have to carry out the
following steps:

• Click the Start menu, then Settings and finally Control Panel.
• Double click the Add/Remove Programs icon.
• Find the Microsol Workbench entry in the list displayed and single-click
it.
• Finally click the Remove button. This will remove the Workbench
program from your computer but it will not remove any project
configurations that you have created. These can be removed separately
using Windows Explorer if required.

3.4 Upgrading Workbench

To upgrade Workbench simply install the new version according to section 3.2
Installing Workbench. The install program does not remove any existing project
configurations so they will still be available in the new installation.

3.5 Starting Workbench

Workbench can be started by double clicking the icon on the desktop (Figure 3-7) or
selecting the program from the Start program menu, then selecting Programs
followed by Microsol Workbench as shown in Figure 3-8. The program will then
present a blank workspace to allow you to begin configuration or diagnostics

Figure 3-8 - Microsol Workbench Start-up

Page 14 of 89
Workbench User Manual Version 2.2.0

3.6 Basic and Advanced Versions

Workbench is available in two versions; basic and advanced. The basic version has
the ability to configure RTUs and run diagnostics with RTU Live but without
advanced features. The advanced version has the basic functionality plus other
advanced features. These advances features are:

• Print Configuration
• Import eXpert Databases
• OSI SCADA export
• Flash Programmer
• Password Control
• Templates
• Wiring List (XML Spreadsheet)
• Upload Config
• Remote Workbench (Not really used)
• DMF Downloader

To upgrade Workbench to advanced, load the Advanced License File using the
Upgrade… (4.3.5.4) item in the Help menu.

Please consult your Microsol contact for more information on obtaining a Workbench
Advanced License.

3.7 Security

Note: The Workbench Security feature is only available with the advanced version of
Workbench. Please consult your Microsol contact for more information.

3.7.1 Access Passwords


These provide a means to prohibiting access to a number of workbench tasks.
Access levels are pre-assigned to the ‘RTU Live’ and ‘Project Configuration’ tasks as
follows:
RTU Live Group
• View Access – User can view but is unable to control Live Data.
• Control Access – User can control and view Live Data.
• Full Access – User has unrestricted access to live RTU Data.

Project Configuration Group


• View Access – User is unable to Save or Download a project.
• Download Access – User can Download but is unable to Save a
project.
• Full Access – User can Save and Download a project.

Note: Access Passwords are disabled by default.

Page 15 of 89
Workbench User Manual Version 2.2.0

3.7.1.1 Group Access Level


The Access level must be set for each group. By default, a Group Access Level is
set to the least access - ‘View Access’. The user is responsible for changing a
Groups Access Level. This is achieved in two ways as follows.

Prohibited Tasks
When the user attempts to run a prohibited task, a password dialog will appear
displaying its Group and Level, as shown in Figure 3-9. To set the Group Access
Level the user must enter the password for this level. The new access level will
remain valid until workbench is closed.

Figure 3-9 Password Dialog

Password Manager
The user can also set a Group Access level in the Password Manager
(Options->User Access...) by selecting the required level and clicking the ‘Change
Level’ button, as shown in Figure 3-10. As a rule, any Level within a Group has
access to a level with less access. i.e. If the Group Access Level is ‘Full’ the user
has access ‘View’ and ‘Control’. The user may also change the password using the
‘Change Password…’ Button.

Figure 3-10 Password Manager

Page 16 of 89
Workbench User Manual Version 2.2.0

The Password manager icons are as follows:

This icon indicates Group Access Level.

This icon indicates a prohibited level.

This icon indicates a permitted level.

Page 17 of 89
Workbench User Manual Version 2.2.0

4 User Interface

4.1 The Workspace

The user workspace is divided into several sections as shown in below.

Menu
Toolbars

Start Panel
(AutoHide)

Record Properties
RTU Live Panel Data Panel
(AutoHide) Window (AutoHide)
Project
Hierarchy
Elements
Project Area

Workbench Database XCell Flash


Messages Messages Programmer

Figure 4-1 Main Workspace Areas

• Start Panel is used for opening or creating a project. It contains the recent
projects list and templates for creating new project.
• Workbench Messages Panel is used to display messages, warnings, and errors
from the deferent workbench modules.
• Elements Panel is used for project configuration. It contains all configuration
components that can be used for creating a new project configuration
• Record Properties Panel is used for viewing the project data in deferent orders.
• RTU Live Panel is used for communicating with the target hardware for on-line
diagnostics or downloading/uploading system configurations
• Database Messages Panel is used to display on-line messages from the target
system
• XCell Flash Programmer Panel is used to program Microsol XCell products that
use flash memory. Currently, this includes CPR-021 fitted with the FXP-010
Memory Expansion Card and the CCM.

The Project area is used to define the configuration for a particular project or
system. The Project area is divided into two, the Project Hierarchy and the Data
Window. Configuration simply involves dragging and dropping configuration
elements from the Elements window to the Project Hierarchy.
The Message window is used to display on-line messages from the target system

Page 18 of 89
Workbench User Manual Version 2.2.0

The individual windows will be described in more detail in later sections of the
manual along with their associated Right-Click menu options
The windows within the workspace can be resized by dragging the edge of the
window to the required size. In addition the Elements, RTU Live and Message
windows may be re-positioned by double clicking on the relevant title bar and
repositioning the window. The window may be restored to its original position by
double clicking on the title bar again. The windows may be removed completely by
double clicking the close icon. Panels that have been removed can be restored using
the relevant checkbox in the View menu. If the width of any window in Workbench
has been reduced to such an extent that all of the tabs cannot be displayed together,
then scroll arrows will be available to scroll through the available tab list. The filled
arrow shows that there are further elements to be displayed while the empty arrow
shows the end of the list of tabs has been reached.

More items to
the Left

More items
to the Right

Close Active
Document

Figure 4-2 Tab Scroll Bars

4.2 Arranging Windows

The Microsol Workbench has two types of windows, tool windows and document
windows. You can increase the viewing and editing space for project, depending on
how you arrange the windows in the Microsol Workbench. You have many options
for arranging windows within the Microsol Workbench, including the following:
• Tab-dock several windows.

• Dock tool windows to an edge of the Microsol Workbench.

• Minimize tool windows along any edge of the Microsol Workbench.

• Tile and Cascade document windows.

Page 19 of 89
Workbench User Manual Version 2.2.0

4.2.1 Docking Tool Windows

When a tool window is dockable, it floats on top of the other windows or it snaps to a
side of the application window.
To dock “RTU Live” to “Record Properties”, drag “RTU Live” and drop it on
“Record Properties” (Figure 4-3):

Figure 4-3 Docking Tool Windows

Tip To move a dockable window without snapping it into place, press CTRL
while dragging it to the location you desire.

Page 20 of 89
Workbench User Manual Version 2.2.0

4.2.2 Hiding Tool Windows Automatically

Tool windows, all of which appear on the View menu, support a feature called Auto
Hide. Auto Hide allows you to see more of your code at one time by minimizing tool
windows along the edges of the Microsol Workbench.

4.2.2.1 To place a window in auto hide


• Select the window and choose Auto Hide from the window menu, or click the
pushpin icon on the title bar of the window.

Auto Hide Enabled:

4.2.2.2 To disable Auto Hide


• Click the pushpin icon on the title bar of the window or deselect Auto Hide on
the Window menu.

Auto Hide Disabled:

When auto hidden, the name and icon of a window are visible on a tab at the edge of
the Microsol Workbench. Move your cursor over the tab to access auto hidden
windows. The window slides back into view and is ready for use. When an auto-
hidden window loses focus, it automatically slides back to its tab on the edge of the
Microsol Workbench.

Figure 4-4 Docking Tool Windows

Tip Tool windows in Auto Hide temporarily slide into view when the window
has focus. To hide the window again, select an item outside of the current
window. Once the window loses focus, it slides back out of view.

Page 21 of 89
Workbench User Manual Version 2.2.0

4.3 Menu Bar

The Menu Bar provides most of


the standard features available in
Microsoft applications, including Figure 4-5 The Workbench Menu
File, Edit and Printing operations.
The following sections will describe each of the available menu items in the context
of Workbench operation.

4.3.1 File Menu


The File menu provides the standard set of file
manipulation options as described below.

4.3.1.1 File - New


New – Displays the Profile Select Dialog (Figure 5-2).
You may select the profile (see Profiles 5.2) from which
a new blank project configuration is created in a new
workspace. If other project(s) are already open they will
remain open in their own workspaces in the
background. They can be selected using the Window
menu (section 4.3.4.3) or the tabs just above the
Project window. This option is also available using
Ctrl+N
Creating a new project does not affect the status of the Figure 4-6 File menu
RTU Live window, which will remain unchanged.

4.3.1.2 File - Open


Open – Allows you to open a previously saved configuration project. This option is
also available using Ctrl+O

4.3.1.3 File - Close


Close – Closes the currently selected project. If the project has been modified since
it was last loaded it prompts the user to save the changes. Selecting Yes will display
the Project Information box similar to that shown in Figure 4-8. Selecting No will
close the project without saving the changes and Cancel will abort the close
operation and return you to the project workspace.

4.3.1.4 File - Save


Save – Allows you to save the current project on your hard drive as an MWP
(Microsol Workbench Project) file. If it is the first time saving the project, then the
user will be prompted for a file name and directory. It is advisable to set-up a
separate Project directory for configurations. This option is also available using
Ctrl+S

Page 22 of 89
Workbench User Manual Version 2.2.0

4.3.1.4.1 Project Information Box


When saving a configuration the user is
always prompted for some additional
information in the Project Information
Box as shown in Figure 4-7 (across). Here
a Project Name and Description can be
assigned along with a Major Version
number and a Minor Version number. The
Project Name along with the Version
number will be displayed on the title bar of
the Project Hierarchy when the project is
opened.
Both the Engineers Name and
Description of Changes fields must be
completed each time a project is saved.
This data is stored as part of the project
Change History (see 5.4.1.2.).
The Project Information and Change
History may
The Primary Unit is used to select a target
XCell unit where a copy of the entire
project zip file will be stored during the
configuration download. Once the zip file
has been stored in flash memory on the Figure 4-7 Project Information Window
target unit, it can be retrieved at any time
using the RTU Live features of Workbench.
The Redundant Unit provides the option to define an additional XCell unit where a
second copy of the project zip file will be stored. If a backup copy is not required then
this entry should be set to 0.
Workbench projects are stored in the specified project directory. For each project,
two files and a subdirectory are created. One file is the project file and the other is a
compressed archive file. The sub-directory contains two further sub-directories, one,
the DMF directory, contains the I/O download parameters and the other, the eXpress
directory, contains any user eXpress applications that may have been created for the
project, refer to Figure 4-8.

Project file
Specific Project directory
Project zip file
Sub-directory for parameters
Project before last
Sub-directory for eXpress Save
… applications

Page 23 of 89
Workbench User Manual Version 2.2.0

Figure 4-8 – Project Directory

To download the configuration over the IEC 60870-5-101 Protocol the Generate IEC
Files flag must be set. Tag names can also be generated automatically by setting
the Automatic Tag Generation flag. If this flag is set, all Tags will be assigned by
workbench and read-only. Note: A prompt will automatically appear to choose
Automatic Tag Generation when the user adds the first element to a new project.

4.3.1.5 File – Save As


Save As – Allows you to save the current project file under a different project name if
required. As with the Save option the Project Information box is displayed allowing
alteration of the project details if required.

4.3.1.6 File – Print

Note: Configuration Print is only available with the advanced version of Workbench.
Please consult your Microsol contact for more information.

Print – This menu option will only become active (not 'greyed out') when a
configuration table has been selected by clicking on any field in the Data Window.
Print will then present the print dialog as shown in Figure 4-9. This option is also
available using Ctrl+P.

Figure 4-9 - Workbench Print Dialog

4.3.1.7 File – Print Preview


Print Preview - This menu option will only become active (not 'greyed out') when a
configuration table has been selected by clicking on any field in the Data Window.
Print Preview will then present a preview of the print data as shown in Figure 4-10.

Page 24 of 89
Workbench User Manual Version 2.2.0

Figure 4-10 Print Preview

4.3.1.8 File – Print Setup


Print Set-up – Calls the standard Print set-up for your printer. It allows you to set up
the format of the print for the current project. The formats available depend upon the
make and model of the printer.

4.3.1.9 File – Open Recent Files


Recent Files - Below the Print Set-up entry is a list of the most recent project files
that have been opened. Clicking on one of these entries will load the project file from
hard disk.

4.3.1.10 File - Exit


Exit – Exits the Workbench program, closing all open project files. Workbench will
detect if you have not saved any modified project and will prompt you to save the file
before exiting.

4.3.2 Edit Menu


The Edit menu, shown below provides a set of standard editing functions including
Undo, Redo, Cut, Copy and Paste. These functions are briefly described in the
following sections.

4.3.2.1 Edit - Undo


Undo – Will undo any edit operations performed in the Data
Window. The required configuration table must currently be
displayed in the Data Window and at least one field must
be selected to ensure hat the table is selected. This function
will not undo drag-and-drop operations from the
Elements/RTU Live window to the Project window or
Figure 4-11 - Edit Menu moving / copying nodes in the Project Hierarchy. It will
undo changes from individual field edits, or changes made
using the Set, Set to Default and Interpolate functions.
Undo will undo the edits one record at a time, regardless of whether several edits
were automatically performed by the previous operation, (e.g. Set, Set to Default, or
Interpolate). This option is also available using Ctrl+Z.

Page 25 of 89
Workbench User Manual Version 2.2.0

4.3.2.2 Edit – Redo


Redo – Simply reverses what has been undone by the last use of the Undo function
and has the same restrictions as defined in the Undo section above. This option is
also available using Ctrl+Y.

4.3.2.3 Edit - Cut


Cut - Allows the deletion of any highlighted text within the various text fields of the
Data Window. Fields that are Cut will revert to their default values (empty for text
fields). Numeric fields or fields with a drop-down options cannot be Cut. This
operation only applies to TEXT fields and the data to be Cut must be highlighted,
otherwise the action will not work. This option is also available using Ctrl+X.

4.3.2.4 Edit - Copy


Copy - Allows any highlighted fields from the Data Window to be copied to the
clipboard where they can subsequently be Pasted to other fields using the Paste
action, (see below). The data to be Copied must be highlighted, otherwise the action
will not work. This option is also available using Ctrl+C.

4.3.2.5 Edit - Paste


Paste - Allows previously Copied data to be Pasted elsewhere. If a Tag name is
pasted into a column where the Tag name already exists, then the pasted tag will be
renamed with an extension indicating that it is a copy of an existing tag, e.g.
TagX_Copy1. This option is also available using Ctrl+V.

4.3.3 View Menu


The Workbench View menu allows you to enable/disable
various workspace components including:
• Toolbar – at the top
• Status bar - at the bottom
• RTU Live – at the left
• Messages Panel - at the bottom
Figure 4-12 - View Menu • Database Message Panel - at the bottom
• Record Properties - at the right
• Start Panel – at the left

Each of these items can be displayed or hidden by checking their individual boxes in
the drop down menu as shown.

Page 26 of 89
Workbench User Manual Version 2.2.0

4.3.4 Window Menu


If multiple projects are created or opened in the same
session of Workbench, each is assigned its own project
workspace. By default these workspaces are tabbed and
the current project is maximised to fit the entire project
window at any time. The Window menu allows you to re-
arrange the workspace areas or select the current
workspace project.
Figure 4-13 Window Menu

4.3.4.1 Window - Cascade


Cascade – Changes the tabbed window arrangement into a 'stacked' arrangement
as shown in the diagram below. Clicking on the title bar of any window will bring it to
the front for manipulation. The various windows can be resized and re-positioned as
required by the operator.

Figure 4-14 - Cascaded Project Panes

4.3.4.2 Window – Tile


Tile – Changes the project display arrangement to a tiled arrangement whereby all
of the windows are visible simultaneously as shown below.

Figure 4-15 - Tiled Project Panes

Page 27 of 89
Workbench User Manual Version 2.2.0

4.3.4.3 Window- Select Specific Project


The last entry in the Window menu is a list of all currently open projects. Clicking on
any of the projects will bring that project to the foreground and select it as the
currently active project window. The currently active project window is highlighted by
a checkbox as shown in Figure 4-13.

4.3.5 Help Menu


The Help menu provides access to the Workbench
help system as described below. Figure 4-16 - Help Menu

4.3.5.1 Help – About Xcell Workshop


The About option displays details of the various component version numbers. This
information is required when requesting technical support and a sample About box
is shown below.

Figure 4-17 Help About Box

4.3.5.2 Help – License Agreement


License Agreement provides the facility for the user to view the Product License
Agreement

4.3.5.3 Help – Tip of the Day


Show the Workbench Tip of the Day.

Page 28 of 89
Workbench User Manual Version 2.2.0

4.3.5.4 Help – Upgrade…


Select to load the Advanced License File. This is greyed when workbench is
operating in Advanced mode. Please consult your Microsol contact for more
information.

4.3.5.5 Help – Context Sensitive


Context sensitive help is available through the use of hover tips. These brief items of
descriptive help text are available by hovering the mouse cursor over the item in
question for a few seconds.

4.3.6 Tool Bar


The Toolbar as shown below, provides single click access to a selected number of
the most commonly used menu items.

Figure 4-18 - The Toolbar

The Toolbar icons as displayed from left to right, represent the following menu items.
The menu items have already been described in the previous sections.
• File – New
• File - Open
• File – Save
• Edit – Cut
• Edit – Copy
• Edit – Past
• File – Print
• Help – About XCell Workbench

Page 29 of 89
Workbench User Manual Version 2.2.0

5 Configuration

5.1 General

To configure a new project activate the Start Panel by selecting its AutoHide Tab;
this is automatically activated when Workbench is run. Select the project you wish to
create. The Start panel lists the type of projects that are available plus the recent
project list. The Elements tab provides the user with access to all configuration
components that can be dragged and dropped onto the Project Hierarchy window,
see diagram below.

File New

Start Panel
(AutoHide)

Project
Hierarchy Data
Window

Project Area
Elements

Figure 5-1 Configuration Workspace

A simple hierarchy must be observed when defining a project configuration. This


hierarchy will be described in a later section titled Project Hierarchy (section 5.4.1).
The data configuration is organised on a processor unit basis with all associated
functionality being configured under the relevant unit node. All I/O on a particular
processor unit must be configured under that unit node. Similarly, if a particular unit
is fitted with a Master or Slave protocol then the protocol tables must be configured
under the relevant unit node. Likewise for any eXpress application software.
To configure a particular project, simply select the required components from the
various tabs in the Elements window and drag and drop them on the appropriate
position in the Project Hierarchy. As you drag and drop various elements you may
be prompted for the number of elements to create.
If an attempt is made to drop a configuration item in an invalid position in the
hierarchy then the mouse pointer will be displayed as a forbidden symbol. Otherwise
it will be displayed as a positive symbol as shown below.

Page 30 of 89
Workbench User Manual Version 2.2.0

Allowed - Valid Hierarchy


Forbidden - Invalid Hierarchy

5.2 Profiles

A profile defines the


type of project you
create and the
selection of elements
that are available to it.
A Profile is loaded
from a WPP
(Workbench Project
Profiles) file; the
necessary profile(s)
will be supplied to suit
your target system.

Figure 5-2 Select Profile Dialog


5.2.1 Add a new
profile
To Load a new profile select FileÆNew. Click the Add Profile(s) button at the
bottom of the Select Profile Dialog (Figure 5-2 Select Profile Dialog). Select the
profile file that you wish to add and click Open. If the profile is added successfully it
will appear in the Profile Grid, otherwise an error message will be displayed in the
Workbench Messages pane.

5.2.2 Create new project


To create a new project, activate the Start panel
(Figure 5-3 Start Panel). The Start Panel lists the
name of each profile available plus the recent project
list. The profiles are categorised according to there
type (i.e. XCell, Type Editor etc.). Click the profile
name that you wish to use to create it.

5.2.3 Open old project


To open a project that was created with a version of
Workbench that did not support profiles select
Figure 5-3 Start Panel

Page 31 of 89
Workbench User Manual Version 2.2.0

FileÆOpen and select the project in the normal manner. A message will appear
requesting you to select a profile for this project – click OK. Select the profile that
you want to use from the Select Profile dialog (Figure 5-2) – Click OK. Note: If the
profile does not match the project you

5.3 Elements

The Elements tab contains a library of


objects that can be used to create a
project configuration. The library of
components is divided into various types Object Libraries
or groupings to simplify the selection of
the required components. These main
Sub-Library
Library Types have their own tabs for
selection as shown in the Figure
opposite.
For example the Project tab is used to
define the project hierarchy and contains
RTU node, Bay node and Unit node.
The Project elements must be defined
first in the Project Hierarchy as all data
configuration must be associated with
Object
XCell Unit nodes. The Point tab is used
to select the various elements for I/O
channel configuration. The Master and
Slave tabs are used to organise Master
and Slave protocol tables respectively Figure 5-4 Elements Tabs
and eXpress is used to define the
various eXpress pseudo points and the
eXpress application parameters.
Each of the main tabs sub divided further for ease of access to the required
components. Clicking on the title bar of the sub-types will display their contents.
Right-clicking in the elements window allows the selection of large or small icons for
the various selection components.
Items are dragged and dropped from here to the Project Hierarchy. Once an item
has been added to the Project Hierarchy it can be deleted by right clicking on the
item and selecting Delete menu option.

5.3.1 Project Tab


The Project tab contains two sub-tabs, the RTU and the Status.
The RTU tab contains the hierarchical elements for the overall structure of the
project configuration. Project elements must be defined before any data
configuration can be completed, as all data configuration must be associated with a
specific unit node. The RTU elements represent the various hardware components
and can only be added to the Project Hierarchy in a certain order as described in
the section titled Project Hierarchy (section 5.4.1).
The hierarchical elements that can be selected are:
• RTU Is a collection of equipment Bays or processing Units. RTU must be

Page 32 of 89
Workbench User Manual Version 2.2.0

the highest level object in a project hierarchy. There can only be one
RTU in each project. It can contain a number of equipment Bays or
Units but may NOT directly contain I/O points, eXpress points or
protocols.
• Bay Is a logical grouping of processing Units. Bay is a second level object
in a project hierarchy. Each RTU can contain a number of Bays and
each Bay can contain a number of Units up to the maximum of 254
Units per RTU.
• Unit Is a central processing unit that can be used for I/O, communications
and express program applications. Unit is the lowest level structural
element in a project hierarchy. Each unit must be assigned a unique
address within the RTU, up to a maximum of 254 and each unit can
contain a maximum of 256 physical I/O channels.
The Status tab contains all the hardware status elements that may be required for
diagnostics or incorporated into user application programs. These include processor
status, module status and serial port status. These status elements must be
associated with the relevant processor unit in the configuration hierarchy.

5.3.2 Point Tab


The Point tab contains all the I/O data types that can be
used in the project configuration. This tab is sub-divided
into logical groupings of I/O types, e.g. Analog and Digital.
Click on the sub-types to reveal the associated I/O
elements that can be dragged to the Project configuration
window, e.g. SDI (Single Digital Input), DDI (Double Digital
Input). Each of these point types and their configuration
parameters will be described in more detail in the I/O Point
Appendix of this Manual.

5.3.3 Slave Protocols Tab Figure 5-5 – Point tab

The Slave Protocols tab contains all the Slave Protocol configuration elements that
can be used in the Project. A Slave Protocol
communicates with an external master station or data
concentrator. The Slave Protocol tab is divided into
sub-tabs for each of the available protocols. Each
protocol may have several configuration elements that
are required for the protocol operation. Click on the
required protocol sub-tab to reveal the various
configuration elements that can be dragged to the
Project Hierarchy.
An example of using the protocol tables will be found in
the Tutorial section and full details of the protocol
configuration can be found in the relevant Protocol
Configuration Guide.
Note: The processing Unit must be factory loaded with
the required protocol firmware for the protocol to operate Figure 5-6 - Slave Protocols

Page 33 of 89
Workbench User Manual Version 2.2.0

5.3.4 Master Protocols Tab


The Master Protocols tab contains all the Master Protocol configuration elements
that can be used in the Project. A Master Protocol communicates with external slave
devices such as IEDs or remote slave devices or RTUs. The Master Protocol tab is
divided into sub-tabs for each of the available protocols. Each protocol may have
several configuration elements that are required for the protocol operation. Click on
the required protocol sub-tab to reveal the various configuration elements that can
be dragged to the Project Hierarchy. Full details of the protocol configuration can
be found in the relevant Protocol Configuration Guide.
Note: The processing Unit must be factory loaded with the required protocol
firmware for the protocol to operate

5.3.5 eXpress Tab


The express tab contains all the configuration elements to set-up Microsol’s
eXpress application development environment for creating user applications
according to the IEC61131 standard. This tab allows the selection of data points
(inputs and outputs) to be used in the user applications along with pseudo/virtual
points that can be manipulated or used by the application. It is also used to define
the parameters for connecting to the target application for download and online
debugging. The actual application development is done by right-clicking on the
express MAP node once it has been created in the project configuration. Full details
on eXpress configuration can be found in the eXpress Configuration Guide.

5.4 The Project Area

The Project configuration is divided into two areas, the Project Hierarchy and the
Data Window. The Project Hierarchy defines all the elements required for the
project. These elements are dragged and dropped from the Elements tab. Once the
project hierarchy has been created, the Data Window is used to define the
parameters for each of the elements.

Project
Hierarchy Data
Window
Elements
Project Area

Figure 5-7 Project Workspace

Page 34 of 89
Workbench User Manual Version 2.2.0

5.4.1 Project Hierarchy


The Project Hierarchy defines all the elements in a particular project. To add
elements to the project hierarchy, simply select the required components from the
various tabs in the Elements window and drag and drop them on the appropriate
position in the Project Hierarchy.
A basic hierarchy must be observed when defining a project configuration. Project
hierarchy elements must be defined before any data configuration can be completed,
as all data configuration must be associated with a processor unit node. The
hierarchical elements are selected from the Elements window, Project tab (RTU
sub tab). These elements represent the various hardware components. All projects
must start with an RTU node, to which any combination of Bays and Units can be
added, up to a limit of 254 units. All data configuration must be associated with a
processor unit and the configuration elements placed under the relevant unit node.
All I/O on a particular processor unit must be configured under the relevant unit
node. Similarly, if a particular unit is fitted with a Master or Slave protocol then the
protocol tables must be configured under the relevant unit node. Likewise for any
eXpress application software.

The basic project hierarchy that must be observed when defining a configuration is
outlined in the following diagram.

RTU
Bay
Unit
I/O Modules
Point Components (I/O)
Master Protocol Components
Slave Protocol Components
Express Components
Unit
Point Components (I/O)
Master Protocol Components
Slave Protocol Components
Express Components

The diagram in Figure 5-8 below shows the hierarchy diagram with both Unit nodes
and Bay nodes connected to the primary RTU node. The I/O modules, I/O nodes
(e.g SDI, Single Digital Inputs), and protocol nodes (e.g. IEC, DNP and Master
Modbus) are all attached to Unit nodes. Please refer to “Tutorial – Simple RTU
Configuration” and “Tutorial – IO Modules and Wiring list”.
The Project Hierarchy window in the Figure 5-8 has been resized (i.e. one edge
has been dragged over to resize it) to show some additional parameters in this view.
The only parameter that can be changed is the Unit number of the Unit nodes.

Page 35 of 89
Workbench User Manual Version 2.2.0

Elements Project Hierarchy expanded Data


Window

Figure 5-8 Sample Project Hierarchy

As you drag and drop certain elements onto the Project Hierarchy you may be
prompted for the number of data elements associated with the node, e.g. the number
of Single Digital Input points.
Once a data node has been added to the Project Hierarchy, the individual elements
can be edited in the Data Window.
There are several context sensitive menu options available in the Project Hierarchy,
which are activated by right-clicking the mouse. See Figure 5-9 Context Menu.

5.4.1.1 Project Information


This option permits the user to view and change the
current Project Information details. No information is
saved until the project is saved. Note: The Engineers
Name and Description of Changes may only be
changed during the save process. See section 4.3.1.4.1
for more on Project Information.

5.4.1.2 View Project Change History Figure 5-9 Context Menu


The Project Change History displays a log entry for
each time the project was saved. Each log includes the Timestamp, Engineers
Name, Version Number and change description as it was entered in the Project
Information. Change History is stored in the Project File which is saved both on the
Workbench PC and the Xcell Unit during the download process. This log is restored
on Project Upload (see Section 8.3.3.1). This log will store the previous twenty
changes.

The Change Log which is a text file change.log located in the project directory on
the PC, also logs this information but has greater capacity. This file will rollover
when the 64k maximum file size is reached. The data is stored in csv (comma
seperated values) format, columns are: Date, Time, Engineers Name, Version and
Change Description.

5.4.1.3 Project Report


This will export the project information to XML spreadsheet format.

Page 36 of 89
Workbench User Manual Version 2.2.0

5.4.1.4 Wiring List


This Option generates the wiring list from the project and opens it in the form of an
XML spreadsheet which can be saved and opened by Microsoft Excel. This
spreedsheet contains following information for each point in the project::
• TAG name;
• Bay;
• Xcell RTU Information
o Cabinet;
o Rack;
o Unit number;
o IO Module;
o Slot number;
o Channel number;
o Connection number;
o Pin number (+,-)
• Termination Board Information
o Type
o Name
o Pin number (+,-)
Please refere to Tutorial – IO Modules and Wiring list (Page 79).

Note: The Wiring List feature is only available with the advanced version of
Workbench. Please consult your Microsol contact for more information.

5.4.1.5 Copy
To Copy items from the Project Hierarchy simply right-click on the item and select
the Copy option. Right-click on the destination and select Paste.

5.4.1.6 Move
To Move items from the Project Hierarchy simply right-click on the item and select
the Cut option. Right-click on the destination and select Paste.

5.4.1.7 Link
To Create a link of an item from the Project Hierarchy simply right-click on the item
and select the Copy option. Right-click on the destination and select Paste
Shortcut..

5.4.1.8 Delete
To remove items from the Project Hierarchy simply right-click on the item and
select the Delete option. Confirmation of the deletion will be required before the
action is performed.

Page 37 of 89
Workbench User Manual Version 2.2.0

5.4.2 Data Window


The Data Window is used to enter or edit the data parameters associated with the
various configuration elements. It is used to set the I/O processing parameters for
the individual I/O channels. It is used to specify the communication parameters for
the protocols as well as the protocol point addresses and processing parameters.
Left-click on any node in the Project Hierarchy to change the context of the Data
Window to that of the selected node. Alternatively, the tabs at the top of the Data
Window can be used to select other configuration elements for display or editing.
Each tab corresponds to a configuration element in the Project Hierarchy.

Data
Window
selection

Project Data
Hierarchy Window

Elements
Project Area

Figure 5-10 Data Window Selection

This section will detail the general data manipulation facilities and menus available in
the Data Window. The detailed description of the various configuration tables is
provided in the Appendices and is not covered in this section.
Note: Any data changes performed in the Data Window can be undone using the
Undo menu option or Ctrl+Z. These operations will only work if the relevant
configuration table is currently being displayed in the Data Window and the cursor is
active on the window. If one operation changes multiple fields, the Undo will undo
them one at a time. If a configuration table entry is deleted and its associated
Reference Tags automatically deleted, the Undo operation must be performed on
both the configuration table and the reference table(s) separately.

For editing data in the Data Window there are different methods of data entry
depending on the field type.
Typed data entry is available by double-clicking on the field to be edited. This will
highlight the current data within the field and allow it to be changed to any valid
value. If the value entered exceeds the maximum permissible value, a message will
be displayed advising the user of the maximum field value.

Page 38 of 89
Workbench User Manual Version 2.2.0

A Spinner option is available on numeric fields by left-clicking on the required field.


This presents a set of up and down arrows beside the field that may be used to
increment or decrement the value by one each time the up or down arrow is pressed
(see Figure 5-11).

Figure 5-11 Spinner' selector shown on Channel 0

A Drop Down selection box is available on certain data entry fields. Left click on the
field to display a single down arrow beside the field. Click on the arrow to display the
drop-down options available and simply select the required option.

Figure 5-12 Drop down Selection

There are several context sensitive menu options available in the Data Window,
which are activated by right-clicking the mouse. The menu options provide facilities
for manipulating the contents of the table entries, and also inserting or removing
table entries. The menu options will vary depending on the area highlighted when the
right-click menu is selected. All options will be detailed here but they are not all
available in any single menu.

Page 39 of 89
Workbench User Manual Version 2.2.0

The Figure 5-13 below shows some of the different menu displays.

Figure 5-13 Data Window - Menu Options

Note: Before describing each of the menu options it should be noted that any table
column may be selected by left clicking on the column title. However, no right-click
menu options are available when the mouse is placed over the column title or the
row number.

5.4.2.1 Cut
Cut – Will delete the contents of any highlighted text fields within the Data Window.
Once Cut, the text fields will revert to their default value (generally blank) and the
Cut fields can be Pasted elsewhere. This operation only applies to TEXT fields.
Numeric fields or fields with a drop-down option cannot be Cut.

5.4.2.2 Copy
Copy – Will copy the contents of any highlighted fields to the Windows clipboard.
Any copied fields can be Pasted elsewhere. All fields, including Tags and drop-down
options can be copied.

5.4.2.3 Paste
Paste – Will Paste the contents of the Windows clipboard to the corresponding
number of fields in the Data Window beginning at the top left of the highlighted area.
If only one field is on the clipboard and three fields are highlighted for pasting, only
one field will be pasted. If ten fields are on the clipboard and only three fields are
highlighted, ten fields will be pasted. It is not advisable to paste the contents of fields
into different field types, e.g. pasting text fields into numeric fields etc. If a Tag is
copied and pasted into another entry in the same column it will be appended with the
suffix “_Copyn” where “n” is the number of times the tag has been copied to the
same column. A message is displayed in the Message Window whenever a Tag
substitution is made.

Page 40 of 89
Workbench User Manual Version 2.2.0

DDI_3

DDI_3_COPY1
DDI_3_COPY2

Reported in the
Message Window

Figure 5-14 Example of a Copied Tag

5.4.2.4 Find
Find… – Will search for a specified data value in the first column of any highlighted
area. The Find… option will display a simple dialogue for entering the required data
value. This option will search the entire column where the first highlighted field is
located regardless of the size of the highlighted area. If only two fields are
highlighted it will search the entire column on which the first field is located.

5.4.2.5 Replace…
Replace… – Provides standard Find and Replace facility for text fields only. It can
be used to find and replace an entire field contents or any part of a text string.

5.4.2.6 Add Record(s)…


Add Record(s)… - Will add new entries to the end of the existing table. The user will
be prompted for the number of additional entries to be created. Any new entries are
created with default values for all fields. This option is only available if the highlighted
area is on a single row or if the mouse is positioned below all existing entries.

5.4.2.7 Insert Record


Insert Record – Inserts one new entry into the current configuration table. The new
entry is inserted immediately above the highlighted entry. The new entry is created
with default values for all fields. This option is only available if the highlighted area is
on a single row.

5.4.2.8 Delete Record


Delete Record – Deletes the highlighted entry from the current configuration table.
The user is prompted for a confirmation of the deletion. If the entry is referenced in

Page 41 of 89
Workbench User Manual Version 2.2.0

any other configuration table the reference will be removed automatically and the
user will be informed. Details of all deleted references will be provided in the
Message Window as shown below. This option is only available if the highlighted
area is on a single row.

SDI_2 has been


Deleted from the SDI
table and it was
referenced here in
the DNP Protocol
Map

Reported that a
reference to SDI_2
has been removed
from the DNP Map
Messages Window

Workbench

Figure 5-15 Deleted Reference Tag

5.4.2.9 Delete Selected Records


Delete Selected Records – Deletes the highlighted entries from the current
configuration table. The user is prompted for a confirmation of the deletion. If any of
entries are referenced in any other configuration table the references will be
removed automatically and the user will be informed. Details of all deleted
references will be provided in the Message Window as shown for Delete Record
above.

5.4.2.10 Set to Default


Set to Default – Sets all highlighted fields to their default value. Refer to the
particular configuration tables for the exact default values.

5.4.2.11 Set
Set – Sets all highlighted fields to a user entered
value. The user will be prompted to enter the
required value. If the highlighted area spans more
than one column then the user will be prompted
for a set value for each of the columns in turn.
The Set operation will not allow you to set a value Figure 5-16 – Set value selection
outside the range of the particular field (e.g. a

Page 42 of 89
Workbench User Manual Version 2.2.0

hardware channel number >255 is not permissible). If an out of range value is


entered, an error box will be displayed showing the maximum permissible value. The
user must either correct the value or cancel the operation. For drop-down fields the
user can simply select the desired drop-down option from the list of available
options.
Note: It is not recommended to use the Set option for Tags or Reference tags.

5.4.2.12 Interpolate
Interpolate – This very powerful function is
used to set both numeric and text fields with
incrementing values. This option is only
available if fields in more than one row are
selected. It has two modes of operation.
In its simplest form it allows the user to set a
numeric value and automatically increment it
for each highlighted entry in a particular Figure 5-17 - Interpolate - numeric values
only
column. The user can specify the start value
and the increment to be used for the
subsequent entries in the column. The
dialogue opposite is used to set these values. As an example, this menu option can
be used to set sequential channel numbers for all channels in a configuration Table
for Single Digital Inputs.
The second mode of operation allows it to
be used for non-numerical fields. The user
can combine a text prefix and/or a text suffix
to the numerical value to generate unique
tags or descriptions. The dialogue opposite
is used to set these values.
Note: Interpolate only works on a single
column regardless of the number of columns
selected. It will operate on the column where
the menu option is selected.
Figure 5-18 - Interpolate with Prefix and
Suffix

Page 43 of 89
Workbench User Manual Version 2.2.0

The diagram below shows fields set using the various Interpolate options and the
Set option.

Interpolate
Dialogue
Set using Interpolate Prefix
and numeric increment of 1

Set using basic Interpolate


with numeric increment of 2

Set using Set option and


value of 10

Figure 5-19 Examples of Interpolate and Set Options

5.4.2.13 Definition
Definition – This option is only available on Tag or Reference Tag fields. It displays
the source of the Tag and places where the Tag is referenced. The format of the
information is shown in Figure 5-20 below.

Figure 5-20 Tag Definition and References

Page 44 of 89
Workbench User Manual Version 2.2.0

Left-clicking on the Definition or the Reference in the “[…]” the relevant data table
will be displayed in the Data Window. In the example above clicking on the
Reference […] will result in the reference data table (DNP3 Map) being displayed in
the Data Window.

5.4.2.14 Properties
Properties – This option displays a separate Properties Window showing all the
properties associated with a single row entry, refer to Figure 5-21 below. This option
is only available when fields in a single row entry are selected. The data can then be
edited either in the Properties Window or the Data Window. The format of the data
display in the Properties Window can be altered using the various options at the top
of the window. The data can be displayed Categorized by data type, Alphabetically
or by Display order.

Properties

Display Options

Figure 5-21 Properties Window

5.4.3 The Messages Window


The Messages panel that usually occupies the lower portion of Workbench has a
number of tab selections.

5.4.3.1 Workbench Messages


The Workbench tab is used to display messages from the Workbench application
including errors and the results of any configuration download operations, refer to
Figure 5-22 below.

Figure 5-22 - The 'Workbench' messages pane

Page 45 of 89
Workbench User Manual Version 2.2.0

5.4.3.2 Database Messages


The Database Messages tab is used when Workbench is connected to the target
XCell system. It displays XCell data change messages transmitted around the XCell
network. These can be very useful for diagnostic purposes.
The change messages must be enabled or disabled using the RTU Live window,
refer to RTU Live section 8.2.3 for full details.
The format of the Database Messages display is shown in Figure 5-23.

1 2 3 4 5 6 7 8 9 10

Figure 5-23 Change Message Display

The Database Messages display is split into a number of columns as described


below.
Date & Time This is the date and time that the change, to the nearest
millisecond

Tag This is the TAG of the point if it exists. This is retrieved from
the current open project configuration

Unit This is the XCell unit number where the change message was
generated.

Group This is the data type that changed, e.g. SDI, DOT, AIN, BCD,
RAW_DI, RAW_AI etc

Record This is the channel number or record number of the point that
has changed within the unit.

Field This is the data attribute of the point that has changed. It
usually corresponds to the data size but may specify another
attribute in some circumstances e.g. Suppression field for
SDIs or DDIs.

Value The new value or state of the point being reported.

Status This is the quality/status information of the value that is


reported.

Message This is the message type. Currently there are four message
Type types that can be reported:

Change Messages
• Single point change
Full Update
• Current value/status report –

Page 46 of 89
Workbench User Manual Version 2.2.0

used to synchronize all units


when the system
configuration may have
changed (hardware or
software).

Packed Message
• Multiple changes packed in
Type 1
one transmission, all with the
same timestamp but
individual quality information.

Packed Message
• Multiple changes packed in
Type 2
one transmission, all with the
same timestamp and quality
information.

Project Name The name of the current Project configuration file used to
extract the Tag information for display. Some raw points do
not have associated Tags.

5.5 Multiple Projects

Multiple configuration projects may be opened or created at any time. Each project
has its own selection tab immediately above the Project Hierarchy and Data Window.
The selection tabs contain the name of the Project file as stored on the hard drive.
The title bar of the Project Hierarchy displays the name and version number provided
when saving the project.
Configuration components can be copied or moved between projects. To achieve
this both projects must be on display simultaneously using the Window+Cascade or
Window+Tile menu options. Once both projects are on display components can be
moved from one project to another by using drag and drop from one project to the
other. Components can be copied by holding the <Ctrl> key while using drag and
drop from one project to the other.

Page 47 of 89
Workbench User Manual Version 2.2.0

6 XCell Flash Programmer

Note: The XCell Flash Programmer is only available with the advanced version of
Workbench. Please consult your Microsol contact for more information.

The XCell Flash Programmer Panel is a tool that can be used to download software
applications to a Microsol XCell Processor equipped with Flash Memory. The figure
below displays a sample screen shot of the tool (Figure 6-1).

Figure 6-1 XCell Flash Programmer

6.1 Setting the XCell Processor to Debug Mode

In order for the XCell Flash Programmer to work, the XCell processor must be set to
debug mode. The following steps in setting the processor to debug mode are:
• Turn OFF the processor
• Press and hold the function button
• Turn ON the processor
• Release the function button
After releasing the function button, only the power LED should be ON.
6.2 Connection Set-up

Only one XCell Processor can be configured at one time using the XCell Flash
Programmer. The figure below illustrates the connection set-up between the PC and
the XCell Processor.
The download cable is identical to that used for configuration download, ie DTE to
DTE. Refer to the XCell user guide for a pin out.

NOTE: The communications port (COM1 by default) of the PC must be


connected to the top port of the XCell Processor. Make sure the
communications port on the PC is not used by any other application.
6.3 Reading the application inside the XCell

The “Show XCell Flash Information” button ( ) communicates and reads the flash
memory module inside XCell processor. It then displays the applications in
Applications item under XCell Unit tree view item. The XCell Unit tree view item
displays the applications present in the processor. It displays the name of the

Page 48 of 89
Workbench User Manual Version 2.2.0

applications and other relevant details. The Figure 6-2 shows a sample screen shot
of the XCELL APPLICATION.

Figure 6-2 Applications inside the XCell

6.4 Loading and Unloading S-Record Files

The software applications that are downloaded to the processor are S-Record files.
The S-Record files that can be downloaded to the XCell Processor are found under
“Files” tree item. The “Load” and “Erase” buttons are used to display and remove S-
Record files from this window. It displays the name of the applications and other
relevant details. Figure 6-3 shows a sample screen shot of the window.

Figure 6-3 Loaded S-Record Files

NOTE: Invalid files will not be loaded into the XCell Flash Programmer.

6.5 Memory Locations of Applications

If the memory addresses of the code or data of the NBs overlap each other, the
XCell Flash Programmer will detect it and give out a warning dialog. Applications are
incompatible in this situation, please consult your Microsol contact.
6.6 Erasing an Application

Clicking on the appropriate application displayed under “Applications” item and


clicking on the “Erase” removes the application inside the XCell Processor.
6.7 Erasing a Chip / Sector

Clicking on the appropriate Chip / Sector displayed under “Flash Devices” item and
clicking on the “Erase” removes the Chip / Sector inside the XCell Processor.
6.8 Calculating Chip CRC

Clicking on the appropriate Chip displayed under “Flash Devices” item and clicking
on the “Calculate CRC” calculates CRC for the Chip inside the XCell Processor.
6.9 Downloading Files

Clicking on the appropriate application displayed under “Files” item and clicking on
the “Download” placing the XCell RTU into download mode, and transfers the
binary data in its memory to the RTU. If the file being downloaded is being

Page 49 of 89
Workbench User Manual Version 2.2.0

downloaded to a region of RAM, then the file is downloaded without erasing the
memory first. If the file being downloaded is being downloaded to a region of FLASH
memory then XCell Flash Programmer will prompt you if you want to erase the
memory first. A dialog box is displayed that shows the download progress and any
errors that occur.

6.10 Resetting the XCell Processor

The RESET button resets the processor. If you don't hold in the Function Button on
the front panel of the XCell while the RTU is restarting it will exit BUG mode and it
will no longer be possible to communicate with the XCell using XCell Flash
Programmer.

Page 50 of 89
Workbench User Manual Version 2.2.0

7 Configuration Download

7.1 General

Configuration download is done using the RTU Live window. The RTU Live Window
is generally located on the left hand side of the display and selected by clicking on
the RTU Live tab as shown in Figure 7-1.

RTU Live Panel

Comms Status
Figure 7-1 RTU Live Window

Before any configuration can be downloaded the following steps need to e


completed.
• Save the project configuration as defined in section 4.3.1.4, File - Save
• Establish communications between Workbench and the target XCell system
as described below in section 7.2
• Download the configuration as described below in section 7.3

7.2 Establishing Communications with XCell

The RTU Live panel must be online and communicating with target XCell hardware
for any of the functions to operate.
To establish communications between Workbench and the XCell target the following
steps need to be carried out.
• Connect a serial cable between the Workbench PC and the diagnostic port on
the XCell unit (usually the top port). In any XCell system there may be many
processing units but it is only necessary to connect to one unit to retrieve data
from all units on the network.

Page 51 of 89
Workbench User Manual Version 2.2.0

• Once the physical connection has


been made the next step is to
select the appropriate
communications port on the
Workbench PC. Right click on a
blank area in the RTU Live panel
or on the RTU icon to reveal the
menu options as shown in Figure
Figure 7-2 Protocol Selection
7-2. Select Protocol and
Communications Setup… and
select the required
communications port as shown in
Figure 7-3.
• Finally select the required protocol
for communicating between
Workbench and the target
hardware. Again, right click on a
blank area in the RTU Live panel
or on the RTU icon to reveal the
same menu options as above
Figure 7-2. Select Protocol and
one of the listed protocols
(generally UIP Ver.2). For details
of the various protocols refer to Figure 7-3 PC Port Selection
the section on the Protocol menu,
section 8.2.4

Once the protocol has been selected, Workbench will automatically try to establish
communications with the target hardware. If it is successful then the communications
status at the bottom right of the Project work area (Figure 7-1) will indicate Good
Communications as shown in Figure 7-4. The relevant icon (host computer on the
left and RTU on the right) will briefly flash when the relevant unit is transmitting a
message. If it is unable to establish communications then it will indicate
Communications Failed as shown in Figure 7-4.

Good Communications Communications Failed


Figure 7-4 Communications Status

If good communications is established with the


target then Workbench will interrogate the
hardware to determine the structure of the
system. This structure is displayed in the RTU
Live panel as an iconic system map as shown in
Figure 7-5. The PC icon represents the
Workbench PC, the Hub icon represents the
XCell interface unit the other numbered units
represent the XCell units on the network.
When communications is established the current
XCell time will be displayed at the top left of the
RTU Live panel.
Figure 7-5 – System Overview

Page 52 of 89
Workbench User Manual Version 2.2.0

7.3 Downloading the Current Project

To download configuration data to the target XCell system, simply drag and drop the
required project element from the Project Hierarchy into the RTU Live window. This
action will automatically start the download of the required component(s). You can
drag and drop the entire RTU, a bay, a unit or simply an I/O table from one unit.
Note, The project must be saved before you can download it and the XCell
units MUST be online.

Once download starts, a series of


progress boxes as shown in Figure 7-6
will be displayed showing the download
status of each individual item in the
download.
The first item that is normally downloaded
is the project archive file that is
Figure 7-6 - Project download progress box
downloaded to the designated XCell units
(specified in the 'Project Information'
box, section 4.3.1.4.1, Primary and Redundant units). If either of these units are not
online, Workbench will advise you of this, and give you the opportunity to abort the
operation. If you continue to download, the configuration for the online units will be
downloaded but the archive copy of the project WILL NOT be downloaded.
The download of the project archive file
can easily be verified after the
download is complete. Simply right-click
in the RTU Live window and select
Update menu option to force
Workbench to update the RTU
structure display. Then highlight the unit
node designated as the Primary or
Redundant archive units. Right-click
and select the Information menu and
Files option. This will result in a Flash
Figure 7-7 – Downloaded Archive File File System node being available on
that particular unit. Verify that a file
named MWPROJ… exists with the
latest date and version number as shown in Figure 7-7.

The Workbench Project can then be retrieved from either the Primary or Redundant
unit at any time using the Project-Upload menu option from the appropriate XCell
Unit Node Menu. Refer to section 8.3.3.1 for further details.

Page 53 of 89
Workbench User Manual Version 2.2.0

8 RTU Live

8.1 Introduction

The RTU Live panel provides a range of online diagnostic facilities as well as
configuration download/upload to the target hardware. The diagnostic facilities
include:
• Display Hardware Modules
• Memory Map
• Current I/O Status
• Online XCell units
• Flash File Contents
• Set Time
• Drive Outputs
• Simulate Inputs
• Display archived messages
• Configuration Download
• Configuration Upload

For all these facilities Workbench must be connected and communicating with the
target XCell system. For details on establishing communications with the target XCell
system refer to section 7.2. Once communications is established Workbench
automatically determines the structure of the target system. Once the structure of the
system has been determined a series of menu options are available by right clicking
on the main nodes within the RTU Live window. Many of the options are common to
several menus and will therefore only be detailed in one menu.

RTU Live tab

Comms Status
Figure 8-1 RTU Live Window

Page 54 of 89
Workbench User Manual Version 2.2.0

8.2 RTU menu

The RTU menu, accessed by right-clicking the RTU icon in


the network diagram, is shown in Figure 8-2. This menu
has a number sub-menus that will be described briefly
below:

8.2.1 Update All Units


Update All Units – Will force Workbench to interrogate all Figure 8-2 - RTU menu
connected XCell units and update the RTU Live display.
This may be used if any hardware or software has changed
or if new configurations have been downloaded.

8.2.2 Project Sub-Menu


This sub-menu contains functions for
downloading configuration files and
uploading the project configuration, refer to
Figure 8-3.

8.2.2.1 Upload
Note: Upload is only with the advanced Figure 8-3 –RTU Live - Project Menu
version of Workbench. Please consult your
Microsol contact for more information.

Upload – Displays a list detailing every unit that contains an archival copy of a
project, see Figure 8-4. The selected copy can be uploaded and opened in
Workbench and so viewed and modified if required.

8.2.2.2 Delete
Delete – Displays a list detailing every unit
that contains an archival copy of a project,
see Figure 8-5. The selected copy can be
deleted from the unit.

Figure 8-4 Upload Project

8.2.2.3 DMF Downloader


Note: The DMF Downloader is only
available with the advanced version of
Figure 8-5 Delete Project Workbench. Please consult your Microsol
contact for more information.

DMF Downloader – Provides a mechanism for selecting and downloading specific


configuration files (.DMF files), to the target system. The user simply selects a .DMF
file from the hard drive for download. The hub unit (unit interfacing with PC)

Page 55 of 89
Workbench User Manual Version 2.2.0

distributes the configuration data to the relevant processors as required. It is not


necessary to connect directly to destination unit.
This is not the standard mechanism for downloading configuration files.
Configuration is normally dragged and dropped form the Project Hierarchy to the
RTU Live window.

8.2.3 RTU Database Messages Menu


This menu contains the options for enabling and disabling XCell database message
reporting in the Database Messages tab in the Messages window as shown in
Figure 8-6. These XCell database
messages reflect the system changes and
events that occur in the system and can be
vital in diagnosing problems. Details for
interpreting the data displayed in the
Database Messages panel are given in
section 5.4.3.2
Enable – Enables the reception and logging
Figure 8-6 - RTU Database Messages of all change messages transmitted on the
connected XCell network. These messages
are displayed in the Database Messages
pane of the Messages panel as shown in Figure 8-7.
Disable– Disables the logging of the XCell change messages for the connected
RTU.

Figure 8-7 - Database Messages from Connected RTU

8.2.4 Protocol Menu


This menu contains the various protocol options for connecting between Workbench
and the XCell system. All systems should support UIP protocol but newer systems
that support UIP Ver.2 protocol will
have additional functionality. If you
are unsure what protocol is
supported in your system simply try
UIP Ver. 2 and if it does not
communicate then drop back to y
UIP protocol. Workbench also
supports remote connection to
Figure 8-8 - Protocol Selection Menu another Workbench PC over an IP
connection for remote debugging.

Page 56 of 89
Workbench User Manual Version 2.2.0

UIP - User Interface Protocol is used by the earlier version of XCell and will limit the
diagnostic functionality available.
UIP Version 2 – An upgraded version of the UIP protocol that supports additional
functionality and should be used where possible.
Remote Workbench… -
Note: Remote Workbench is only available
with the advanced version of Workbench.
Please consult your Microsol contact for
more information.

Workbench can remotely connect to


another Workbench PC that is actually
connected to the XCell system. Selecting the
Remote Workbench protocol will enable Figure 8-9 – Remote Workbench Protocol
another dialog as shown in Figure 8-9. This
dialog allows the selection of the server
name or IP address and IP port number (1000 by default) of the remote Workbench
PC.

8.2.5 Set Time Menu Item


This menu item (Figure 8-10) provides the facility to set the time and date in the
XCell system. It displays the Set Time dialog box as shown in Figure 8-11. The
dialog automatically displays the current PC time. The update of the PC time can be

Figure 8-10 - Set Time Menu

Figure 8-11 - Set Time Dialog Box

suspended using the Pause button and then a new time can be entered manually.
To set the XCell system time with that displayed, simply click on the Set RTU Time
button.

Page 57 of 89
Workbench User Manual Version 2.2.0

8.2.6 Drive Command Menu Item


This menu item enables you to drive Digital and
Analog output points in the XCell system. Selecting
this item pops up the Drive Command dialog box as
shown in Figure 8-13. The Group field in the dialog
box determines the type of drive to perform e.g.
Digital Output, Analog Output, Modbus Digital Output
etc.
Figure 8-12 - Drive Command
The following fields are common to all drive types: Menu
Unit - The XCell Unit number of the point
Group - The Group name of the point to be driven.
Record – The channel number of the point to be driven.
Close Button - Closes the dialog box.

8.2.6.1 Digital Output Drive Commands


The following fields apply to Digital Output
Drive Commands as shown in Figure
8-13.
Single Stage - Select this option to drive
a single stage output.
Three Stage - Select this option to drive a
three-stage output.
On - Select this option to drive a digital
output on.
Off - Select this option to drive a digital
output off. Figure 8-13 - Digital Drive Command

Pulse - Select this option to pulse a


digital output on for a specified time period. The time period is entered in
milliseconds beside the radio button.

8.2.6.2 Analog Output Drive Commands


If the Group field is changed to an Analog
Output group then the dialogue box will be
presented as in Figure 8-14. The following
fields apply to Analog Output Drive
Commands
The dialog allows the analog output value
to be entered in four different ways. As any
value is entered all four value formats are
updated. Two formats (Unipolar and
Bipolar) are dependent on the Analog Figure 8-14 - Analog Drive Command
Setup entries.
Value – Enter the analogue output value to
be driven in the range 0-65535.

Page 58 of 89
Workbench User Manual Version 2.2.0

% Slidebar – Enter the value in percent (0-100%) or use slide bar to set the value.
Unipolar – Enter a positive value in mA or V. This must be between 0 and
(Maximum + Over Range) as defined below, e.g. 0 - 21 mA.
Bipolar – Enter ether positive or nagative value in mA or V. This must be between
+/- (Maximum + Over Range) as defined below, e.g.-20.5 to +20.5 mA.
Maximum – Nominal maximum value of the point/card in mA or V or etc. (e.g. 20
mA)
Over Range (%) – The over range supported on the card. (e.g. 5% )
The analog drive commands are always single stage commands initiated by the
Single Stage button.

8.2.7 Request System Full Update


This menu item as shown in Figure 8-15, forces a
System Full Update. This forces all XCell units to
transmit their current data values from their database.
This is used to synchronize all XCell units on the
network and automatically occurs after a hardware or
software reconfiguration.
Figure 8-15 - Request System
Full Update

8.2.8 SOE Log


if SOE Log is available on some units, SOE Log menu item will be enabled. This
menu item as shown in Figure 8-16, searches the RTU for a SOE Log. It brings up a
dialog box with the list of all SOE Logs on deferent units (Figure 8-17).

Figure 8-16 – SOE Log menu


item

Figure 8-17 – SOE Log List

Page 59 of 89
Workbench User Manual Version 2.2.0

8.3 The Unit Menu

By right clicking on any Unit icon in the RTU Live panel a


unit specific menu is available as shown in Figure 8-18.

8.3.1 Update
Selecting this option will force Workbench to interrogate
the particular Unit and update the RTU Live display. This
may be used if any hardware or software has changed or if Figure 8-18 - Unit-Menu
new configurations have been downloaded. A similar menu
is available from the RTU node that will update all units in the project.

8.3.2 Information Sub-Menu


This sub-menu (Figure 8-19) allows you to
select the information you would like to
retrieve from this particular XCell unit.
Workbench will then request the specified
information and update the RTU Live display.
Each of the information types and their display
format will be described in the following sub-
sections.
Figure 8-19 - Information menu
8.3.2.1 Files
Selecting Files on the Information menu will
result in a Flash File System node being
available under the particular Unit node in the
RTU Live display. This shows all the files in the
Flash File System of that unit, similar to that
shown in Figure 8-20. The first column is the file
name and second column is size of the file.
Figure 8-20 Flash File Details

Right-clicking on the individual files will present


a simple Delete/Upload menu as shown in
Figure 8-21. This simple menu allows you to
delete the particular file or upload it to a
specified directory. Files should not be deleted
under normal circumstances. Figure 8-21 – Files Menu

8.3.2.2 File System Statistics


Selecting File System Statistics on the
Information menu will result in a File System
Statistics node being available under the
particular Unit node in the RTU Live display. This
shows a set of statistics on the File System for
that unit, similar to that shown in Figure 8-22.
Many of these statistics are not updated by the
system and may not be valid. Figure 8-22 – Flash File Statistics

Page 60 of 89
Workbench User Manual Version 2.2.0

8.3.2.3 IO Modules
Selecting IO Modules on the Information menu will result in an IO Modules node
being available under the particular Unit node in the RTU Live display. This shows
the I/O modules installed on the unit, refer to Figure 8-23. If the RTU Live window is
expanded it will show the module types and the hardware channel numbers
associated with each module.

Figure 8-23 Installed I/O Modules

8.3.2.3.1 I/O Data Values


By clicking on each IO module, the current value/status of the I/O channels will be
displayed, as shown in Figure 8-24.

Figure 8-24 – Current State / Value of I/O

8.3.2.3.2 Output Drive Commands


And by double-clicking on any output
points ( DO, AO, …) , it pops up the Drive
Command dialog box as described in
section 8.2.6. and shown again in Figure
8-25

Figure 8-25 Output Drive Command

Page 61 of 89
Workbench User Manual Version 2.2.0

8.3.2.4 Memory
Selecting Memory on the
Information menu will result in a
Memory node being available
under the particular Unit –
Hardware node in the RTU Live
display. This shows the memory
allocation on the unit, similar to that
shown in Figure 8-26.
This display shows the Memory
Figure 8-26 Memory Allocation
Type, Start Address, End Address
and Block Size

8.3.2.5 Named Blocks


Selecting Named Blocks on the
Information menu will result in a Named
Blocks node being available under the
particular Unit node in the RTU Live
display. This shows all the Named
Blocks stored on the unit, refer to Figure
8-27. In some versions of XCell software,
Named Blocks are used for storing code
and eXpress applications. In other
versions of XCell software these code Figure 8-27 – Named Blocks Allocation
and eXpress applications are stored in
the Flash File System. The display
shows the Name, the Version and Start Address in memory.
Right-clicking on the individual Named Blocks will
present a simple Delete/Upload menu as shown in
Figure 8-28. This simple menu allows you to delete
the particular Named Block or upload it to a specified
Figure 8-28 – Named
directory. Named Blocks should not be deleted under Blocks Menu
normal circumstances.

8.3.2.6 Message Log


Selecting Message Log on the Information menu will result in a Message Log
node being available under the particular Unit node in the RTU Live display. This
shows all the Front Panel Messages that have occurred on the unit since it was last
rebooted, similar to that shown in Figure 8-29.

Figure 8-29 –Front Panel Message Log

Page 62 of 89
Workbench User Manual Version 2.2.0

The Message Log display has a number of columns


• 1st Column: Message Code (e.g. NET-032),
• 2nd Column: User Data
• 3rd Column: Operating System Error Code
• 4th Column: Date & Time of occurrence.
• 5th Column: Error Code

Double-clicking on any
message brings up the
Message Look-up dialog box
similar to that shown in Figure
8-30. This describes the
possible cause of the message
and actions that may be
required.

Figure 8-30 - The Message Look-up Dialog Box

8.3.2.7 Database Tables


Selecting Database Tables from the Information
menu will result in a Database Tables node being
available under the particular Unit node in the RTU
Live display. This shows all the internal database
tables created in the unit, similar to that shown in
Figure 8-31. The display simply shows a list of table
icons and their associated table names.

Figure 8-31 - Database Tables

8.3.3 Project Menu


This menu provides the facilities to
Upload an archived copy of the complete
Workbench project or to download new
code files to the unit. Refer to Figure 8-32
for details of the sub-menu options.
Note: This menu option is only available
on units that are fitted with Flash memory. Figure 8-32 - Project Menu

8.3.3.1 Upload
Note: Upload is only available with the advanced version of Workbench. Please
consult your Microsol contact for more information.

Page 63 of 89
Workbench User Manual Version 2.2.0

During system configuration it is standard practice to automatically download an


archive copy of the entire Workbench Project to one or two designated units. This is
set-up in the Project Information dialog box (section 4.3.1.4). This archived copy of
the project configuration is in a compressed format and has a predefined file name
“MWPROJ…” It is stored in the Flash File System on the designated units. It is
recommended to store the archive file in the two XCell units with the lowest unit
numbers.
This menu option allows the archived copy to be uploaded and opened in
Workbench where it can be viewed and modified if required. This utility will look for
the compressed project file on the unit and upload it to Workbench. If the file cannot
be located on the requested unit a message to that affect will be displayed for the
user.
The option is not available ('greyed-out') unless the XCell system reports the
presence of the archived configuration file when Workbench first interrogates it.

8.3.3.2 NB Downloader…
This option allows you to download new software modules (Named Blocks) to the
relevant processor thereby allowing 'on-line' updating of the processor software.

8.3.3.3 FFS Downloader…


This option allows you to download new files to the relevant processor thereby
allowing 'on-line' updating of the processor software.

8.3.4 The Front Panel Display Menu


This menu contains options to change the front
panel display of the particular XCell unit,
mimicking the actions of the Function Button on
the front panel of the XCell processor module.
The sub-menu is shown in Figure 8-33.

8.3.4.1 Group A, Group B, Group C and


Group D
Figure 8-33 - Front-Panel Display
The XCell Front Panel Led Matrix contains 64 Menu
LEDs. As any XCell unit may have up to 256
physical I/O channels they are displayed on the LED Matrix in four groups of 64
(Groups A-D). The four menu options allow you to select the group of I/O channels
that will be displayed on the Front Panel LED Matrix of the particular XCell unit,
(Group A for channels 0-63, Group B for channels 64-127, Group C for channels
128-191 and Group D for channels 192-255).

8.3.4.2 Online Units


This changes the Front Panel LED Matrix on the particular XCell unit to show all
units that are currently communicating on the XCell network. As there are only 64
LEDs in the matrix the display wraps-around after 64 units, i.e. Unit 1, 65, 129, 196
are all shown on the same LED.

Page 64 of 89
Workbench User Manual Version 2.2.0

8.3.4.3 Debug
This option changes the Front Panel LED Matrix on the particular XCell unit to
display the Debug panel. The LED's reflect internal diagnostics of various processes
currently active in the unit. The interpretation of the LEDs will depend on the
software modules running on the unit.

8.3.4.4 Restart Unit


This option restarts the particular XCell unit. Before restarting the unit a warning
message box will be displayed.

8.3.5 Database Messages Menu


This menu contains the options for enabling
and disabling the reporting of database
change messages from the particular XCell
unit to the Database Messages tab in
Workbench. These XCell database
messages reflect the system changes and
events that occur in the unit and can be vital
in diagnosing problems. Details for
interpreting the data displayed in the Figure 8-34 - Database Messages Menu
Database Messages panel are given in
section 5.4.3.1. Also refer to the section on RTU Database Messages, section 8.2.3
for enabling/disabling these on all units.

8.4 Tagged data

In addition to viewing the current values of the physical I/O points, Workbench
provides the facility to view all software points or Tagged points within the project.
This includes points derived from the physical I/O such as Single Digital Inputs and
Double Digital Inputs but it also includes IED data points that are retrieved via Master
protocols. In order to show the current values of all the different tagged data in a cell,
the following steps should be taken:
1. Open a Workbench database which includes the required tagged
data;
2. Enable database change messages;
3. Request Full-update.
This will result in the Tagged data points from the current Workbench project being
available for viewing in the RTU Live window under their respective units and data
types as shown below.

Page 65 of 89
Workbench User Manual Version 2.2.0

Figure 8-35 – Tagged Data

Page 66 of 89
Workbench User Manual Version 2.2.0

9 Tutorial – Simple RTU Configuration

In this section we will create a simple project and download it to a connected XCell
RTU. Although all of the interface functions will not be used for this tutorial many of
the most commonly used functions and point types will be included thereby giving
you a basis for creating more complex configurations when required. The process
that will be followed is:

• Start a new project called Workbench 1


• Create an RTU with a single bay with a single unit in the bay.
• Add I/O (some basic digital and analogue points) and a protocol (the
DNP3 Slave protocol) to the unit
• Configure the I/O points and protocol
• Download the complete configuration to an XCell RTU
• Upload the stored configuration from the RTU.

To carry out this tutorial you will need the following:

• A PC with at least one serial communications port and a copy of Microsol


Workbench.
• A serial cable to connect the PC to the XCell system.
• An XCell rack containing:

• Qnty • Module • Description


• 1 • CPR • Processor
module
• 1 • HDI- • 64 Channel
050 Digital Input
Module
• 1 • HDO- • 32 Channel
040 Digital Output
Module
• 1 • HAI- • 32 Channel
030 Analog Input
Module
• 1 • AOT- • 4 Channel
030 Analog
Output
Module

• For this tutorial it is assumed that the PC and the XCell rack hardware
are already powered and connected together.

Page 67 of 89
Workbench User Manual Version 2.2.0

9.1 Start a New Project (Workbench 1)

This section will create a blank new project named 'Workbench 1' based on a sample
profile (“IEC 60870-5-101 (Sample Profile)”), carry out the following steps to create
this blank project. (Please note that the sample profile with your installation of
Workbench may have a different name – see Profiles 5.2 ).

• Open Microsol Workbench. The Start Panel will automatically activate,


if not click the Start AutoHide Tab.
• Select the profile listing “IEC 60870-5-101 (Sample Profile)” from the
Start Panel. The project and its associated element pane will be created.
• Select 'File+Save As' .
• When the 'Project Information' dialog is displayed call the project “WB-
1” and click 'OK'
• When the file naming dialog is presented type 'Workbench 1' then click
'Save'
• This should then give you the 'Workbench' shown in Figure 9-1.


Figure 9-1 - Part 1 - 'Workbench 1' Blank Project

9.2 Create an RTU with one bay and one unit in the bay
At this stage we will create the Project Hierarchy before attempting to add any I/O
or protocols.

• Select the Elements tab in Elements/RTU Live and then the Project
tab
• Drag an RTU node into the Project Hierarchy panel and then drag a
Bay node onto the RTU node and a single Unit node onto the Bay node.

Page 68 of 89
Workbench User Manual Version 2.2.0

If you want to change the unit number double click on the value beside
the Unit node and enter the required address.

Figure 9-2 – Simple Project Hierarchy

9.3 Add I/O and protocol nodes to the Unit


Here we will add some I/O points and a communications protocol to the Unit. We will
add some digital points, analogue points and the DNP3 communications protocol to
unit 1. The configuration that will be created will have:
Qnty. Description
8 SDI Points
4 DOT Points
4 AIN Points
1 DNP3 Gen
6 DNP3 Map rows

• In the Elements window select the Point tab and then from the Digital
sub-tab drag an SDI node onto unit 1 in the Project Hierarchy. When
prompted for the number of records to add, enter 8. Again from the
Digital sub-tab drag a DOT node onto unit 1 but this time just add 4
records.
• From the Analog sub-tab drag an AIN node and add 4 records.
• Select the Slave Protocols tab and then from the DNP 3.0 sub-tab drag
a DNP3 Gen node onto unit 1. From the same sub-tab drag a DNP3
Map node to unit 1 and select 6 records to add in the DNP Map. This will
result in a configuration diagram similar to that shown in Figure 9-3.

Figure 9-3 - Workbench 1 project with all I/O and protocol nodes defined

Page 69 of 89
Workbench User Manual Version 2.2.0

9.4 Configure the I/O points and protocols


While the basic configuration structure is now in place, the parameters must be set
for proper operation. To understand the meaning of each of the fields in the
configuration tables you may need to reference the Workbench I/O Configuration
Guide.

9.4.1 SDI Configuration


Firstly, we will configure the SDI points to use the first 8 hardware channels of the
HDI-050 (channels 0-7) with relevant TAG’s and descriptions using only the channel
number to differentiate them. Other parameters will also be changed to demonstrate
the various configuration options.
Click on the title of the Tag column to select the entire column. Then move the
mouse down to one
of the entries and
right-click to display
the menu options.
Select the
Interpolate option
Using Interpolate
with the Prefix and
Suffix option as
shown below we will
set the TAG names Figure 9-4 - Using 'Interpolate' to set up the TAG name string
for each of the SDI
points to the string
'SDI n TAG', where n is the incrementing
TAG/Channel number from 0 to 7.
Similarly the SDI description will be set to the
string 'Workbench 1 Test SDI X', this time no
suffix will be used, as the interpolated number is
the last character in the string.
The result of both of these 'Interpolate'
operations can be seen in Figure 9-6 below. Figure 9-5

Figure 9-6 - Unit 1 SDI TAG and Description fields set using the Interpolate option

We will also assign the channel numbers 0-7 using the Interpolate function on the
Channel column but without the Prefix/Suffix option as shown in Figure 9-7.

Page 70 of 89
Workbench User Manual Version 2.2.0

We will assign all the ON Filter Time (ms) to 100 using the Set menu option as
shown in Figure 9-8 Similarly, we will assign the OFF Filter Time (ms) to 500.

Figure 9-7 - 'Set' options dialog Figure 9-8 - 'Set' value request box

SDI points 6 and 7 will be Inverted and Not Suppressed by clicking the relevant
field and selecting the required value from the associated Drop Down options.
The complete SDI configuration can be seen in Figure 9-9.

Figure 9-9 - Final Unit 1 SDI Group configuration

9.4.2 DOT Configuration


We can similarly configure the Unit 1 Digital Output (DOT) parameters using a
combination of the Interpolate and Set options and direct data entry on certain
fields. As a HDI-050 module (64 channels) is in the first I/O card position, the HDO-
040 card channels must start at 64. We will set the first three channel numbers to 64,
65 and 66 using Interpolate and the fourth channel number to 95 by double clicking
on the field and entering the required value. Channel 66 will be set to 3-Stage (from
the 'Drop-Down' selection) and channel 95 will be a Pulsed channel (from the drop
down selection) with a pulse width of 500mS.
The completed DOT configuration can be seen in Figure 9-10 below.

Figure 9-10 - Complete Unit 1 DOT Configuration

Page 71 of 89
Workbench User Manual Version 2.2.0

9.4.3 AIN Configuration


We will similarly configure the four Analog Input (AIN) channels already created. As
a HDI-050 (64 channel card) is in the first I/O card position and a HDO-040 (32
channels) is in the second I/O card position, the HAI-030 card channels must start at
96. We will set the four channel numbers to 96-99 using Interpolate. All channels
will be configured with a Delta value of 2% using the Set option on the Delta column.
Channel 99 will be a 'Bipolar' channel between ±15mA by clicking on the appropriate
fields and entering the required values.
The completed AIN configuration can be seen in Figure 9-11below.

Figure 9-11 - Complete AIN I/O Point Configuration for Unit 1

9.4.4 DNP3 Configuration


The final section of this tutorial will deal with the configuration of DNP3 Slave
protocol. In general the configuration of a protocol is the same as configuring any I/O
point. With the exception that the configuration tables will generally be larger (have
more fields) and the MAP table entries will have to be configured after the I/O points
have been configured so that they can reference the I/O for reporting purposes.
Appendix 1 contains the sample configuration for the DNP Gen table. For a detailed
description of the DNP3 Slave protocol and the configuration of the table fields
please see the associated Workbench Configuration Guide. A sample portion of the
DNP3 Gen table is shown in Figure 9-12 below.

Figure 9-12 - Part of the DNP3 Slave Gen Table


Again for the sake of simplicity will be only be configuring six I/O Map Table records
for this protocol but these will enable us to monitor the eight digital inputs and the
four analogue inputs as both single points and groups of points. Appendix 1 defines
the complete listing for the DNP3 Map table configuration and Figure 9-13 shows the
completed Map table with its six entries.

Page 72 of 89
Workbench User Manual Version 2.2.0

Figure 9-13 - The completed six entries in the DNP3 Map Table

9.5 Download complete configuration to an XCell RTU


When all of the I/O points and protocols for the test unit have been configured it is
necessary to download the project to the XCell RTU. To carry out this operation it is
necessary to:

• Connect the Workbench computer to the XCell system using a suitable


serial communications cable.
• Select the communications protocol (UIP Ver.2) and communications
port.
• At this point Workbench should be
communicating with the XCell system, the
communication status icon should be Figure 9-14 - 'Workbench'
is communicating with the
'communicating' (see Figure 9-14) and the XCell system
RTU Live panel should now show the structure
of the connected system,.
• Drag the RTU icon from the Project Hierarchy panel and drop it into the
RTU Live panel. This will initiate the download of the configuration data
to the XCell system.
• Once this is completed
successfully, Update All Units
from the RTU Menu in the
RTU Live panel. Then
highlight the unit node and
right-click. Select the
Information menu and Files
option. This will result in a
Flash File System node being
available on that particular unit. Figure 9-15 - RTU File System after project
Verify that a file named download
MWPROJ… exists with the
latest date and version number
1.05 as shown in Figure 9-15.

9.6 Upload the archived configuration from the XCell.


Note: Upload is only available with the advanced version of Workbench. Please
consult your Microsol contact for more information.

Page 73 of 89
Workbench User Manual Version 2.2.0

As a final check that our configuration has


been stored correctly on the target XCell we
will upload the configuration and compare it
to our original configuration. This operation
is carried out from the RTU Live pane with
the following steps.

Figure 9-16 - Project Upload selection

From the Hub icon sub-menu select the


Project + Upload menu options as shown in
Figure 9-16. This will then start the upload of
the archived project from unit 1 and progress
bars similar to those shown in Figure 9-17 will
be seen until the upload is complete.
Figure 9-17 - Project Upload in
progress

Once the upload is complete


Workbench will request a location to
store the uploaded project by
displaying a Save As dialog similar
to that shown in Figure 9-18. Enter a
suitable file name and click Save and
the upload of the archived project
from the RTU is complete. Examine
the configuration and verify that it is
correct.
Figure 9-18 - File Save Dialog

Page 74 of 89
Workbench User Manual Version 2.2.0

10 Tutorial – IED Template

In this tutorial we will create a simple IED template. The process that will be followed
is:

• Start a new project called Database 1.


• Create a Unit with a single IED.
• Add Virtual I/O (some basic virtual digital and analogue points) and a
protocol (the MODBUS Master protocol) to the IED
• Configure the I/O points and protocol.
• Save the project as template.
• Restart Workbench.

To carry out this tutorial you will need the following:

• A copy of Microsol Workbench version 2.2 or later.

Page 75 of 89
Workbench User Manual Version 2.2.0


10.1 Start a New Project (Database 1)

This section will create a blank new project named ‘Database1', carry out the
following steps to create this blank project.

• Open Microsol Workbench. The Start Panel will automatically activate,


if not click the Start AutoHide Tab.
• Select MODBUS master profile from the Start Panel. The project and its
associated element pane will be created.
• Change the RTU Name to ‘Template 1.
• Select 'File+Save As' .
• When the 'Project Information' dialog is displayed call the project
“Database” and click 'OK'
• When the file naming dialog is presented type 'Database 1' then click
'Save'
• This should then give you the 'Workbench' shown Figure 10-1.

Figure 10-1 - Part 1 - 'Database 1' Blank Project

Page 76 of 89
Workbench User Manual Version 2.2.0

10.2 Create Unit with one IED


At this stage we will create the Project Hierarchy before attempting to add any I/O
or protocols.

• Select the Elements tab and then the Project tab.


• Drag an IED node onto the Unit node and enter the required address.

Figure 10-2 – Simple Project Hierarchy

10.3 Add Virtual I/O and protocol nodes to the IED


Here we will add some I/O points and a communications protocol to the IED. We will
add some digital points, analogue points and the Modbus communications protocol
to IED. The configuration that will be created will have:
Qnty. Description
8 Modbus DI
4 Modbus DO
4 Modbus AI
3 Modbus MAP rows
1 Modbus RTU row

• In the Elements window select the Master Protocls tab and then from
the Modbus sub-tab drag an Modbus DI node onto IED in the Project
Hierarchy. When prompted for the number of records to add, enter 8.
Again from the Modbus sub-tab drag a Modbus DI node onto IED but
this time just add 4 records. And drag an Modbus AI node and add 4
records.
• Drag a Modbus Map node onto IED and select 3 records to add in the
Modbus Map. From the same sub-tab drag a Modbus RTU node to
IED and select 1 record to add. This will result in a configuration diagram
similar to that shown in Figure 10-3.

Page 77 of 89
Workbench User Manual Version 2.2.0

Figure 10-3 - Database 1 project with all I/O and protocol nodes defined

10.4 Configure the I/O points and protocols


While the basic configuration structure is now in place, the parameters must be set
for proper operation. To understand the meaning of each of the fields in the
configuration tables you may need to reference the Modbus protocol Configuration
Guide.

10.5 Save the project.


Now we should save the project and copy it into Workbench Type directory which by
default is: “C:\Program Files\Microsol Workbench\Types”.

10.6 Restart Workbench.


By restarting the workbench and creating a new project you should be avail of the
IED template which you can drag and drop it into any Unit node (Figure 10-4 – IED
template).

Figure 10-4 – IED template

Page 78 of 89
Workbench User Manual Version 2.2.0

11 Tutorial – IO Modules and Wiring list

In this section we will create a simple project using IO Modules and Create the wiring
list for it. The process that will be followed is:

• Start a new project called “Workbench 1”


• Create an RTU with a two bays and each bay as follow:

Bay 1

Cabinet 1 Cabinet 2

Rack 1 Rack 1

Unit 1 Unit 2 Unit 5 Unit 6

Rack 2 Rack 2

Unit 3 Unit 4 Unit 7 Unit 8

• Add I/O Modules (some basic digital and analogue points)

Qnty Module Description


1 CPR Processor module
1 HDI-050 64 Channel Digital Input Module
1 HDO-040 32 Channel Digital Output Module
1 HAI-030 32 Channel Analog Input Module
1 AOT-030 4 Channel Analog Output Module
• Create Wiring List.

Page 79 of 89
Workbench User Manual Version 2.2.0

11.1 Start a New Project (Workbench 1)

This section will create a blank new project named 'Workbench 1' based on a sample
profile (“IEC 60870-5-101 (Sample Profile)”), carry out the following steps to create
this blank project. (Please note that the sample profile with your installation of
Workbench may have a different name – see Profiles 5.2 ).

• Open Microsol Workbench. The Start Panel will automatically activate,


if not click the Start AutoHide Tab.
• Select the profile listing “IEC 60870-5-101 (Sample Profile)” from the
Start Panel. The project and its associated element pane will be created.
• Select 'File+Save As' .
• When the 'Project Information' dialog is displayed call the project “WB-
1” and click 'OK'
• When the file naming dialog is presented type 'Workbench 1' then click
'Save'
• This should then give you the 'Workbench 1' shown in Figure 11-1.

Figure 11-1 - Part 1 - 'Workbench 1' Blank Project

Page 80 of 89
Workbench User Manual Version 2.2.0

11.2 Create the RTU


At this stage we will create the Project Hierarchy .

11.2.1 Create the Hierarchy for the first unit

• Select the Project tab in Elements toolbar.


• Drag a Bay node onto the RTU node and rename it to “BAY 1”.
• Drag a single Cabinet node onto the Bay node and rename it to
“Cabinet 1”.
• Drag a single Rack node onto the Cabinet node and rename it to “Rack
1”.
• Move unit 1 ( or drag a Unit node) onto the Rack node.

• Your project hierarchy should look like Figure 11-2:

Figure 11-2 – Hierarchy for the first unit

11.2.2 Add I/O Modules


Here we will add following modules I/O points and a communications protocol to the
Unit. We will add some digital points, analogue points and the DNP3
communications protocol to unit 1. The configuration that will be created will have:

Qnty Module Description


1 HDI-050 64 Channel Digital Input Module
1 HDO-040 32 Channel Digital Output Module
1 HAI-030 32 Channel Analog Input Module
1 AOT-030 4 Channel Analog Output Module

• Select the Project tab in Elements toolbar.


• Drag a MODULE node onto the Unit 1 and do the following changes:
• Module - Type: HDI-05X (64-channel digital input module)
• Termination Block - Type: TDI-040 (32-channel termination board)
• Name – 1st: TDI1 (first termination board)

Page 81 of 89
Workbench User Manual Version 2.2.0

• Name – 2nd: TDI2 (second termination board)


• Drag another MODULE node onto the Unit 1 and do the following
changes:
• Module - Type: HDO-04X
• Termination Block - Type: TDO-040
• Name – 1st: TDO1
• Drag another MODULE node onto the Unit 1 and do the following
changes:
• Module - Type: HAI-03X
• Termination Block - Type: TAI-040
• Name – 1st: TAI1

• Drag another MODULE node onto the Unit 1 and do the following
changes:
• Module - Type: HAO-03X
• Termination Block - Type: TAI-040
• Name – 1st: TAO1

• This should then give you the hierarchy shown in Figure 11-3.

Figure 11-3 – Unit IO Modules

Page 82 of 89
Workbench User Manual Version 2.2.0

11.2.3 Add I/O Points


Here we will add some I/O points to the Unit. The configuration that will be created
will have:
Qnty. Description
8 SDI Points
4 DOT Points
4 AIN Points
4 AOT Points

• In the Elements window select the Point tab and then from the Digital
sub-tab drag an SDI node onto HDI-05X in the Project Hierarchy. When
prompted for the number of records to add, enter 8. Again from the
Digital sub-tab drag a DOT node onto unit 1 but this time just add 4
records.
• From the Analog sub-tab drag an AIN node onto HAI-03X and add 4
records. Again from the Analog sub-tab drag a AOT node onto HAO-
03X and add 4 records.
• The first channel number of each module is 0. So the first channel
number of SDI, DOT, AIN, AOT should be 0.
• This should then give you the hierarchy shown in Figure 11-4.

Figure 11-4 – Unit 1 with I/O Modules and some IO points defined

Page 83 of 89
Workbench User Manual Version 2.2.0

11.2.4 Add More Units

• Copy the Unit 1 onto Rack 1. It


would create unit 2 under Rack 1.
• Copy Rack 1 onto Cabinet 1 and
rename it to Rack 2.
• Copy Cabinet 1 onto Bay 1 and
rename it to Cabinet 2.
• Copy Bay 1 onto RTU and rename it
to Bay 2.
• This should then give you the
hierarchy shown in Error!
Reference source not found..

Figure 11-5 – Project Hierarchy

Page 84 of 89
Workbench User Manual Version 2.2.0

11.3 Create the Wiring List


On the RTU menu (right-click on the RTU
node) , please select the Wiring List menu
option (This option would be available in
advanced mode) shown in Figure 11-6. This
would create the wiring list shown in Figure
11-7.

Figure 11-6 RTU node Menu

Figure 11-7 – Wiring List

Page 85 of 89
Workbench User Manual Version 2.2.0

12 Glossary

Area This is the area of the screen within 'Workbench' that contains one
of the main operating functions, Elements, RTU Live, Project
Hierarchy, Data Window, Properties and Messages.
Bay This is a second level object in a 'Workbench' project. Each RTU
can contain a number of Bays and each Bay can contain several
Units up to the maximum of 254 Units per RTU.
Change Message A change in status or value that exceeds a reporting threshold and
is notified to all other XCell units.
eXpress Express is a graphical programming tool conforming to IEC61131
for the XCell product. eXpress applications may be run on any XCell
unit fitted with eXpress software.
Front Panel Display The arrangement of 64 green LED's on the front panel of an XCell
unit processor module.
I/O Point A single data point within the XCell RTU. I/O Points can be either
RAW (unprocessed by software, e.g. RAW_DI) or PROCESSED
(filtered by software, e.g. SDI), changes in an I/O point beyond
certain defined limits result in the generation of a Change
Message.
Project A 'Workbench' configuration for a single RTU that can contain up to
254 units.
RTU Remote Telemetry Unit, in the context of 'Workbench' this is the
highest level object in a 'Workbench' project, there can only be one
RTU in each project. It can contain a number of Bays and Units but
may NOT contain individual I/O points groups, protocols or eXpress
points.
Unit This is the lowest level structural element in a 'Workbench' project
and corresponds to an XCell processor module. Each unit has an
individual address.
Workspace This is the working area for the creation of configurations with the
Workbench program and comprises Elements, RTU Live, Project
Hierarchy, Data Window, Properties and Messages areas.
XCell The family of monitoring and control hardware and software
produced by Microsol.

Page 86 of 89
Workbench User Manual Version 2.2.0

13 Troubleshooting and Technical Support

In the event that problems with 'Workbench' cannot be solved with reference to this
Users Guide or the on line help; TECHNICAL SUPPORT is available from:
Email: support@microsol.ie
Web: http://www.microsol.com

To ensure that you obtain the best service please ensure that you include explicit
details of the problem. Also include the version of Workbench you are using, the
operating system used on the computer and the hardware and software structure of
the XCell system connected to Workbench.
Failure to include this information in your fault report may increase the time to
correct the problem.

Page 87 of 89
Workbench User Manual Version 2.2.0

14 Appendix 1 Tutorial Configurations

14.1 Tutorial SDI Configuration

TAG Description Channel On Time Off Time Invert Inhibit


SDI 0 TAG Workbench 1 Test SDI 0 100mS 500mS No Auto
0 Suppression
SDI 1 TAG Workbench 1 Test SDI 1 100mS 500mS No Auto
1 Suppression
SDI 2 TAG Workbench 1 Test SDI 2 100mS 500mS No Auto
2 Suppression
SDI 3 TAG Workbench 1 Test SDI 3 100mS 500mS No Auto
3 Suppression
SDI 4 TAG Workbench 1 Test SDI 4 100mS 500mS No Auto
4 Suppression
SDI 5 TAG Workbench 1 Test SDI 5 100mS 500mS No Auto
5 Suppression
SDI 6 TAG Workbench 1 Test SDI 6 6 100mS 500mS Yes No Suppression
SDI 7 TAG Workbench 1 Test SDI 7 7 100mS 500mS Yes No Suppression

14.2 Tutorial DOT Configuration

TAG Descriptio Channe Mode Stages Pulse Enable Input Output Output Enable
n l Time Field Sense Sense Enable TAG
(mS)
DOT 0 Workbench 1 Steady One Stage Not On Off No
TAG Test DOT 0 0 State 0 Selected

DOT 1 Workbench 1 Steady One Stage Not On Off No


TAG Test DOT 1 1 State 0 Selected

DOT 2 Workbench 1 Steady Three Not On Off No


TAG Test DOT 2 2 State Stage 0 Selected

DOT 3 Workbench 1 Pulsed One Stage Not On Off No


TAG Test DOT 3 15 500 Selected

Page 88 of 89
Workbench User Manual Version 2.2.0

14.3 Tutorial AIN Configuration

TAG Description Channe Delta Filter Polarity Max Min mA High Low Alarm
l % % mA Limit Limit Deadban
mA mA d

AIN 0 TAG Workbench 1 Test AIN Unipolar


0 4 2 1 20 -20 20 -20 8

AIN 1 TAG Workbench 1 Test AIN Unipolar


1 5 2 1 20 -20 20 -20 8

AIN 2 TAG Workbench 1 Test AIN Unipolar


2 6 2 1 20 -20 20 -20 8

AIN 3 TAG Workbench 1 Test AIN Bipolar


3 7 2 1 20 -20 15 -15 2

14.4 Tutorial DNP3 Slave Gen Table Configuration

TAG Description Serial Port Primary Device Unsolicited DL DL Retry


Address Address Confirm

DNP3Gen DNP Master Link CommB 1 1 Disable None 1

DL Timeout APP Confirm App Retry App Umode Umode Class Event Size
Timeout Timeout Retry Assignment

4000 All APDU 3 10,000 1,000 3 Enable 100

Fragment Baud Rate RTS Key On RTS Key Off Parity DataLength StopBits
Message Time Time

Multiple 9600 8 20 None 8 1

14.5 Tutorial DNP3 Slave Map Table Configuration

Reference Field Range Device Object ID Point Initial Frozen Point


Tag Number class

SDI 0 TAG 1-Bit Data 1 1 Digital Input 1 Class 1 -1

SDI 1 TAG 1-Bit Data 1 1 Digital Input 2 Class 1 -1

SDI 2 TAG 1-Bit Data 6 1 Digital Input 3 Class 1 -1

AIN 1 TAG 16-Bit Data 1 1 Analog Input 20 Class 2 -1

AIN 2 TAG 16-Bit Data 1 1 Analog Input 21 Class 2 -1

AIN 3 TAG 16-Bit Data 2 1 Analog Input 22 Class 2 -1

Page 89 of 89

You might also like