Remote Automation Solutions DS800 Development Suite Software Manuals & Guides
Form A6126
Part Number D301174X012
March 2009
DS800 Development Suite
Software
User Manual
Revision Tracking Sheet
March 2009
This manual is periodically altered to incorporate new or updated information. The date revision level of each page is
indicated at the bottom of the page opposite the page number. A major change in the content of the manual also
changes the date of the manual, which appears on the front cover. Listed below is the date revision level of each page.
Page Revision
All Pages 05/02
55, 112-117, 119-120,242, 419-425, 431-454, 538-540,
542, 546-549, 552-553, 556, 559-563, 566-570, 588,
594-5950 08/02
All Pages 07/06
All Pages 03/09
© 2002 - 2009 Remote Automation Solutions, division of Emerson Process Management. All rights reserved.
NOTICE
Remote Automation Solutions (“RAS”), division of Emerson Process Management shall not be liable for technical or
editorial errors in this manual or omissions from this manual. RAS MAKES NO WARRANTIES, EXPRESSED OR
IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE WITH RESPECT TO THIS MANUAL AND, IN NO EVENT SHALL RAS BE LIABLE FOR ANY
INCIDENTAL, PUNITIVE, SPECIAL OR CONSEQUENTIAL DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS
OF PRODUCTION, LOSS OF PROFITS, LOSS OF REVENUE OR USE AND COSTS INCURRED INCLUDING
WITHOUT LIMITATION FOR CAPITAL, FUEL AND POWER, AND CLAIMS OF THIRD PARTIES.
Bristol, Inc., Bristol Canada, BBI SA de CV and Emerson Process Management Ltd., Remote Automation Solutions
division (UK) are wholly owned subsidiaries of Emerson Electric Co. doing business as Remote Automation Solutions
(“RAS”), a division of Emerson Process Management. ROC, FloBoss, ROCLINK, Bristol, Bristol Babcock,
ControlWave, TeleFlow and Helicoid are trademarks of RAS. AMS, PlantWeb and the PlantWeb logo are marks of
Emerson Electric Co. The Emerson logo is a trademark and service mark of the Emerson Electric Co. All other
trademarks are property of their respective owners.
The contents of this publication are presented for informational purposes only. While every effort has been made to
ensure informational accuracy, they are not to be construed as warranties or guarantees, express or implied, regarding
the products or services described herein or their use or applicability. RAS reserves the right to modify or improve the
designs or specifications of such products at any time without notice. All sales are governed by RAS’ terms and
conditions which are available upon request.
RAS does not assume responsibility for the selection, use or maintenance of any product. Responsibility for proper
selection, use and maintenance of any RAS product remains solely with the purchaser and end-user.
DS800 Development Suite 2.10 - User Manual
Table of Contents
Workbench _______________________________________ 1
Appearance ............................................................................................................ 3
Title Bar.......................................................................................................... 4
Menu Bar ........................................................................................................ 5
Toolbars ........................................................................................................ 14
Standard Toolbar......................................................................................15
Debug Toolbar .........................................................................................17
Window Buttons Toolbar.........................................................................19
Layers Toolbar.........................................................................................19
Version Source Control Toolbar..............................................................20
Options Toolbar .......................................................................................20
I/O Wiring Toolbar ..................................................................................20
Workspace .................................................................................................... 22
Zoom ........................................................................................................23
Output Window ............................................................................................ 24
Contextual Menus......................................................................................... 25
Status Bar...................................................................................................... 25
Customization ...................................................................................................... 26
Directory Structure .............................................................................................. 29
Working with Projects ......................................................................................... 32
Creating Projects........................................................................................... 34
Opening and Closing Projects ...................................................................... 36
Saving Projects ............................................................................................. 39
Renaming Projects........................................................................................ 39
Adding a Project Description........................................................................ 40
Printing Projects ........................................................................................... 40
Project Access Control......................................................................................... 41
Importing and Exporting Workbench Elements .................................................. 43
Uploading Workbench Elements from Targets ................................................... 46
Link Architecture View ....................................................................................... 48
Resources...................................................................................................... 48
Resource Window Workspace.................................................................49
Creating Resources ..................................................................................50
DS800 Development Suite 2.1 - Table of Contents i
Renaming Resources ...............................................................................51
Copying Resources ..................................................................................51
Pasting Resources ....................................................................................52
Deleting Resources ..................................................................................53
Editing Resource Properties ......................................................................... 54
Resource Identification............................................................................55
Compilation Options................................................................................55
Run-time Settings ...................................................................................59
Resource Network Parameters.................................................................62
Custom Resource Parameters ..................................................................63
Resource Access Control.........................................................................64
Resource Description...............................................................................66
Variable Bindings ........................................................................................ 67
Internal Bindings .....................................................................................71
Linking Resources .............................................................................74
Deleting Resource Links....................................................................76
Viewing the Internal Bindings Defined for Resources ......................77
Hiding and Showing Resource Links ................................................77
Defining Internal Variable Bindings..................................................78
Editing Internal Variable Bindings ....................................................80
Deleting Internal Variable Bindings ..................................................80
External Bindings ...................................................................................81
Defining Producer Variable Groups ................................................. 83
Editing Producer Variable Groups.....................................................85
Deleting Producer Variable Groups...................................................85
Linking Resources for External Bindings .........................................86
Editing External Resource Links .......................................................87
Defining External Variable Bindings.................................................88
Editing External Variable Bindings ...................................................89
Deleting External Variable Bindings .................................................89
Parameters .................................................................................................... 90
Variable Groups ........................................................................................... 91
Creating Variable Groups........................................................................91
Opening Variable Groups........................................................................91
Importing or Exporting Variables ................................................................ 93
POUs (Program Organization Units) ........................................................... 96
Programs..................................................................................................96
Functions .................................................................................................98
Function Blocks.......................................................................................99
ii DS800 Development Suite 2.1 - User Manual
Creating POUs .........................................................................................99
Manipulating POUs ...............................................................................100
Creating FC Sub-programs ....................................................................102
Creating SFC Child POUs .....................................................................102
Changing Hierarchy Level.....................................................................103
Controlling Access to POUs ..................................................................104
Generating Debug and Monitoring Information ....................................107
Editing a POU Description ....................................................................108
Hardware Architecture View ............................................................................. 109
Configurations ............................................................................................ 110
Creating Configurations.........................................................................110
Deleting Configurations.........................................................................111
Moving Configurations..........................................................................112
Inserting Resources................................................................................112
Moving Resources Between Configurations .........................................113
Configuration Properties............................................................................. 114
Configuration Link to ROCLINK Configuration File ...........................115
Configuration Target Definitions...........................................................117
Target Access Control............................................................................118
Configuration Description .....................................................................119
Networks..................................................................................................... 120
Creating Networks .................................................................................120
Moving Networks ..................................................................................121
Connections ................................................................................................ 123
Creating Connections.............................................................................123
Deleting Connections.............................................................................124
Dictionary View................................................................................................. 125
Appearance ................................................................................................. 126
Variables Tree............................................................................................. 127
Parameters Tree .......................................................................................... 128
Types Tree .................................................................................................. 129
Creating Structures.................................................................................129
Renaming Structures..............................................................................130
Deleting Structures.................................................................................130
Defined Words Tree ................................................................................... 130
Working with the Grids .............................................................................. 131
Resizing Columns ..................................................................................132
Selecting Rows and Elements................................................................132
DS800 Development Suite 2.1 - Table of Contents iii
Editing the Contents of the Grid............................................................133
Adding or Inserting Rows......................................................................134
Moving Rows ........................................................................................135
Expanding or Collapsing Grid Components..........................................135
Cutting, Copying, and Deleting Elements .............................................136
Finding and Replacing Elements...........................................................137
Pasting Elements....................................................................................138
Sorting the Grid .....................................................................................138
Duplicating Rows ..................................................................................139
Renumbering Addresses ........................................................................140
Printing a Grid .......................................................................................141
Variables Grid ............................................................................................ 142
Parameters Grid.......................................................................................... 143
Types Grid.................................................................................................. 144
Defined Words Grid ................................................................................... 145
Defining TLP Variables ............................................................................. 146
Initial Values .............................................................................................. 150
Validation ................................................................................................... 153
Cell-level Validation..............................................................................153
Row-level Validation.............................................................................153
Database-level Validation......................................................................154
I/O Wiring View................................................................................................ 155
Appearance................................................................................................. 156
I/O Wiring Tree View ................................................................................ 157
I/O Wiring Grid View ................................................................................ 159
Working with the I/O Wiring Tool............................................................. 160
TLP Devices (Automatic Wiring) .........................................................162
Analog Input - 4 Point ...........................................................................163
Analog Output - 4 Point.........................................................................163
Discrete Input - 8 Point..........................................................................164
Discrete Output - 5 Point .......................................................................164
Multi-Variable Sensor Input - 6 Point ...................................................165
Pulse Input - 2 Point ..............................................................................166
RTD Input - 2 Point ...............................................................................167
System Analog Input - 5 Point ..............................................................167
Thermocouple Input - 5 Point................................................................168
Adding I/O Devices ...............................................................................169
Opening Devices....................................................................................170
Deleting Devices and Conversions........................................................171
iv DS800 Development Suite 2.1 - User Manual
Setting the Real or Virtual Attribute......................................................171
Wiring Channels ....................................................................................172
Mapping Channels .................................................................................172
Freeing Channels ...................................................................................174
Run-time System Events.................................................................................... 175
Logging Events........................................................................................... 175
Viewing Events........................................................................................... 176
Language Editors ............................................................................................... 181
Common Editor Features............................................................................ 181
Appearance ............................................................................................182
Menu Bar..........................................................................................183
Toolbars............................................................................................184
Standard Toolbar ........................................................................185
Options Toolbar..........................................................................186
Debug Toolbar............................................................................187
SFC Breakpoints Toolbar...........................................................189
SFC Tools...................................................................................189
Flow Chart Tools........................................................................191
ST Tools .....................................................................................192
IL Tools ......................................................................................193
LD Tools.....................................................................................194
FBD Tools ..................................................................................195
Workspace........................................................................................197
Contextual Menus ............................................................................199
Output Window................................................................................199
Status Bar .........................................................................................200
Inserting Identifiers................................................................................201
Inserting Blocks .....................................................................................203
Printing POUs ........................................................................................205
Opening the Dictionary..........................................................................205
Opening Another POU...........................................................................206
Finding and Replacing in POUs ............................................................207
SFC Editor .................................................................................................. 209
Appearance ............................................................................................210
Menu Bar ...............................................................................................211
DS800 Development Suite 2.1 - Table of Contents v
Working with the Editor ........................................................................214
SFC Elements...................................................................................215
Initial Step ..................................................................................215
Step.............................................................................................216
Transition ...................................................................................216
Divergence/Convergence ...........................................................217
Creating New Branches........................................................219
Deleting Branches ................................................................220
Link ............................................................................................221
Jump ...........................................................................................222
Managing Elements .........................................................................223
Select ..........................................................................................223
Rename.......................................................................................224
Move ..........................................................................................225
Cut ..............................................................................................225
Copy ...........................................................................................225
Paste ...........................................................................................226
Delete .........................................................................................227
Goto............................................................................................227
Level 2 .............................................................................................228
Coding Action Blocks for Steps.................................................229
Coding Conditions for Transitions.............................................231
Moving Action Blocks Up or Down ..........................................232
Deleting an Action Block...........................................................233
Renumbering Charts ........................................................................233
FC Editor .................................................................................................... 235
Appearance ............................................................................................235
Menu Bar ...............................................................................................236
Working with Flow Charts ....................................................................239
Flow Chart Elements........................................................................240
Action.........................................................................................240
Test.............................................................................................240
IF-THEN-ELSE .........................................................................241
DO-WHILE................................................................................242
WHILE-DO................................................................................242
Flow............................................................................................243
Connector ...................................................................................244
I/O Specific ................................................................................244
vi DS800 Development Suite 2.1 - User Manual
Comment ....................................................................................245
Sub-Program...............................................................................245
Managing Elements..........................................................................246
Select ..........................................................................................246
Cut ..............................................................................................247
Copy ...........................................................................................247
Paste............................................................................................248
Delete..........................................................................................248
Move...........................................................................................248
GoTo...........................................................................................249
Renumber ...................................................................................249
Level 2..............................................................................................250
Level 2 Window .........................................................................251
Edit the Level 2 ..........................................................................252
Multi-language Editor................................................................................. 253
Appearance ............................................................................................254
Menu Bar ...............................................................................................256
Multi-Language Elements......................................................................260
ST/IL Elements ................................................................................260
LD Elements.....................................................................................261
Contact on the Left ....................................................................261
Contact on the Right ..................................................................261
Parallel Contact .........................................................................262
Coil ............................................................................................262
Block on the Left .......................................................................262
Block on the Right .....................................................................262
Parallel Block ............................................................................262
Jump ..........................................................................................262
Label...........................................................................................263
Return ........................................................................................263
Change Coil/Contact Type ........................................................263
Insert New Rung ........................................................................264
Other Operations .......................................................................264
FBD Elements ..................................................................................265
Variable ......................................................................................266
Function Block ...........................................................................267
Link ...........................................................................................267
Corner ........................................................................................267
Jump ..........................................................................................268
DS800 Development Suite 2.1 - Table of Contents vii
Label ..........................................................................................268
Return.........................................................................................269
LD Elements...............................................................................270
Left Power Bar ...................................................................270
Contacts ..............................................................................270
LD Vertical "OR" Connection ............................................270
Coils.....................................................................................271
Right Power Bar .................................................................271
Comment ....................................................................................272
Managing Elements ...............................................................................273
Select................................................................................................273
Resize...............................................................................................274
Undo/Redo .......................................................................................274
Move ................................................................................................275
Cut....................................................................................................275
Copy.................................................................................................276
Paste .................................................................................................276
Paste Special ....................................................................................277
Delete ...............................................................................................277
Select All..........................................................................................278
Find Matching Name .......................................................................278
Find Matching Coil..........................................................................278
Go to Line ........................................................................................279
Display/Hide Comments..................................................................279
Libraries............................................................................................................. 281
Creating Libraries....................................................................................... 281
Using Libraries in a Project........................................................................ 282
Debug................................................................................................................. 289
Status Information ...................................................................................... 290
Download ................................................................................................... 293
Debug/Simulate .......................................................................................... 295
Start / Stop a Resource...........................................................................297
Resource Execution Mode.....................................................................298
Real-time Mode ...............................................................................298
Cycle-to-cycle Mode........................................................................299
viii DS800 Development Suite 2.1 - User Manual
Step-by-step Mode ...........................................................................299
Setting Breakpoints ....................................................................301
Removing Breakpoints ...............................................................301
Stepping in POUs .......................................................................302
Set Cycle Time.......................................................................................303
Write / Lock / Unlock ............................................................................304
Diagnosis................................................................................................307
SFC Breakpoints ....................................................................................311
Breakpoint on Step Activation .........................................................312
Breakpoint on Step Deactivation .....................................................313
Breakpoint on Transition..................................................................314
Transition Clearing Forcing .............................................................315
Spying Variables....................................................................................316
Adding Variables to the Spy List .....................................................316
Selecting Variables in the Spy List ..................................................317
Removing Variables from the Spy List............................................318
Rearranging the Spy List..................................................................318
Saving a Spy List .............................................................................318
Opening an Existing Spy List ..........................................................319
Forcing the Value of a Spy List Variable.........................................319
Simulate a Panel of I/Os ............................................................................. 320
Appearance ............................................................................................322
Menu Bar..........................................................................................323
Toolbar .............................................................................................324
Contextual Menu..............................................................................325
Displaying I/O Device Window Headers.........................................325
Moving or Hiding the Browser ........................................................326
Online Changes........................................................................................... 327
Code Sequences .....................................................................................327
Variables ................................................................................................329
Declared Variables ...........................................................................329
Function Block Instances .................................................................330
Compiler Allocated Hidden Variables .............................................330
I/O Devices ............................................................................................331
Memory Requirements...........................................................................331
Miscellaneous Limitations.....................................................................331
Operations..............................................................................................332
Debug Function Block Instances................................................................ 334
Clean Stored Code ...................................................................................... 336
DS800 Development Suite 2.1 - Table of Contents ix
Document Generator.......................................................................................... 337
Table of Items............................................................................................. 338
Printing Options ......................................................................................... 340
Preview....................................................................................................... 342
Code Generator.................................................................................................. 345
Build ........................................................................................................... 345
Build a POU...........................................................................................346
Building Resources / Projects................................................................347
Stopping Builds .....................................................................................348
Cleaning Projects...................................................................................348
Compiler Options ....................................................................................... 349
C Source Code............................................................................................ 351
Project Tree View.............................................................................................. 353
Cross References Browser................................................................................. 355
Calculating Cross References..................................................................... 357
Browsing the POUs of a Project................................................................. 357
Defining Search Options ............................................................................ 358
Version Source Control ..................................................................................... 359
Performing a Check in of a Workbench Element....................................... 363
Viewing the History of Workbench Elements ........................................... 364
Getting a Previous Version....................................................................365
Comparing Current and Previous Versions ...........................................365
Ac cessing Details for a Previous Version ............................................366
Creating a History Report......................................................................366
Language Reference ______________________________ 367
Project Architecture........................................................................................... 368
Programs..................................................................................................... 368
Cyclic and Sequential Operations .............................................................. 369
Child SFC POUs ........................................................................................ 370
FC Sub-Programs ....................................................................................... 371
Functions .................................................................................................... 371
Function Blocks.......................................................................................... 373
Description Language................................................................................. 375
Execution Rules.......................................................................................... 376
x DS800 Development Suite 2.1 - User Manual
Common Objects ............................................................................................... 377
Data Types.................................................................................................. 377
Standard IEC 61131 Types ....................................................................377
User Types: Arrays ................................................................................379
User Types: Structures...........................................................................380
Constant Expressions.................................................................................. 381
Boolean Constant Expressions...............................................................381
Short Integer Constant Expressions.......................................................381
Double Integer Constant Expressions....................................................382
Real Constant Expressions.....................................................................382
Timer Constant Expressions ..................................................................383
String Constant Expressions ..................................................................383
Variables..................................................................................................... 385
Reserved Keywords ...............................................................................385
Directly Represented Variables .............................................................387
Information on Variables .......................................................................389
Boolean Variables (BOOL) ...................................................................390
Short Integer Variables (SINT)..............................................................390
Double Integer Variables (DINT)..........................................................390
Real Variables (REAL)..........................................................................390
Timer Variables (TIME)........................................................................391
String Variables (STRING) ...................................................................391
Comments................................................................................................... 392
Defined Words............................................................................................ 392
SFC Language.................................................................................................... 395
SFC Main Format ....................................................................................... 395
SFC Basic Components .............................................................................. 396
Steps and Initial Steps............................................................................396
Transitions..............................................................................................397
Oriented Links .......................................................................................398
Jump to a Step........................................................................................398
Divergences and Convergences.................................................................. 400
Single Divergences (OR) .......................................................................400
Double Divergences (AND) ..................................................................402
Actions Within Steps .................................................................................. 404
Boolean Actions.....................................................................................404
Pulse Actions .........................................................................................405
Non-stored Actions ................................................................................406
SFC Actions...........................................................................................407
DS800 Development Suite 2.1 - Table of Contents xi
List of Instructions.................................................................................408
Calling Functions and Function Blocks.................................................409
Conditions Attached to Transitions............................................................ 410
Condition Programmed in ST................................................................410
Condition Programmed in LD ...............................................................411
Condition Programmed in IL.................................................................411
Calling Functions from a Transition......................................................412
Calling Function Blocks from a Transition ...........................................413
SFC Dynamic Behavior.............................................................................. 414
SFC Program Hierarchy ............................................................................. 415
FC Language...................................................................................................... 417
FC Basic Components ................................................................................ 417
FC BEGIN .............................................................................................418
FC END .................................................................................................418
FC Flow Links .......................................................................................419
FC Actions.............................................................................................420
FC Conditions........................................................................................420
Other FC Components................................................................................ 422
FC Sub-Program ....................................................................................422
FC I/O Specific Actions.........................................................................423
FC Connectors .......................................................................................424
FC Comments ........................................................................................424
FC Complex Structure Examples ..........................................................425
FC Dynamic Behavior................................................................................ 426
FC Checking............................................................................................... 426
FC Examples .............................................................................................. 427
FBD Language................................................................................................... 429
FBD Diagram Main Format ....................................................................... 429
RETURN Statement ................................................................................... 431
Jumps and Labels ....................................................................................... 431
Boolean Negation ....................................................................................... 433
Calling Functions and Function Blocks ..................................................... 433
LD Language ..................................................................................................... 435
Power Rails and Connection Lines ............................................................ 436
Multiple Connections ................................................................................. 437
Basic LD Contacts and Coils...................................................................... 439
Direct Contact........................................................................................440
Inverted Contact.....................................................................................440
xii DS800 Development Suite 2.1 - User Manual
Contact with Rising Edge Detection......................................................441
Contact with Falling Edge Detection.....................................................442
Direct Coil..............................................................................................443
Inverted Coil ..........................................................................................444
SET Coil.................................................................................................445
RESET Coil ...........................................................................................446
Coil with Rising Edge Detection ...........................................................447
Coil with Falling Edge Detection ..........................................................448
RETURN Statement ................................................................................... 449
Jumps and Labels........................................................................................ 450
BLOCKS in LD .......................................................................................... 451
ST Language ...................................................................................................... 453
ST Main Syntax .......................................................................................... 453
Expressions and Parentheses ...................................................................... 455
Functions or Function Block Calls ............................................................. 456
Calling Functions...................................................................................456
Calling Function Blocks ........................................................................457
ST Operators............................................................................................... 459
ST Basic Statements ................................................................................... 459
Assignment.......................................................................................459
RETURN Statement...............................................................................460
IF-THEN-ELSIF-ELSE Statement ........................................................461
CASE Statement ....................................................................................462
WHILE Statement..................................................................................463
REPEAT Statement ...............................................................................464
FOR Statement.......................................................................................465
EXIT Statement .....................................................................................466
ST Extensions ............................................................................................. 467
GSTART Statement in SFC Action.......................................................468
GKILL Statement in SFC Action ..........................................................469
GFREEZE Statement in SFC Action.....................................................470
GRST Statement in SFC Action ............................................................471
GSTATUS Statement in SFC Action ....................................................472
IL Language....................................................................................................... 473
IL Main Syntax........................................................................................... 473
Labels.....................................................................................................474
Operator Modifiers.................................................................................474
Delayed Operations................................................................................475
DS800 Development Suite 2.1 - Table of Contents xiii
IL Operators ............................................................................................... 476
LD Operator...........................................................................................477
ST Operator ...........................................................................................478
S Operator..............................................................................................478
R Operator .............................................................................................479
JMP Operator.........................................................................................480
RET Operator.........................................................................................481
) Operator...............................................................................................482
Calling Functions...................................................................................483
Calling Function Blocks: CAL Operator...............................................485
Standard Operators ............................................................................................ 487
* ................................................................................................................. 488
+ ................................................................................................................. 489
- .................................................................................................................. 491
/ .................................................................................................................. 492
1 GAIN ....................................................................................................... 494
AND ........................................................................................................... 495
ANY_TO_BOOL ....................................................................................... 496
ANY_TO_SINT ......................................................................................... 498
ANY_TO_DINT ........................................................................................ 499
ANY_TO_REAL........................................................................................ 501
ANY_TO_TIME ........................................................................................ 502
ANY_TO_STRING.................................................................................... 504
Equal........................................................................................................... 505
Greater Than or Equal ................................................................................ 507
Greater Than............................................................................................... 508
Less Than or Equal..................................................................................... 510
Less Than ................................................................................................... 511
NEG............................................................................................................ 512
NOT............................................................................................................ 514
Not Equal.................................................................................................... 515
OR .............................................................................................................. 516
TMR ........................................................................................................... 517
XOR............................................................................................................ 518
Standard Functions ............................................................................................ 521
ABS ............................................................................................................ 522
ACOS ......................................................................................................... 523
AND_MASK.............................................................................................. 524
xiv DS800 Development Suite 2.1 - User Manual
ASCII.......................................................................................................... 525
ASIN........................................................................................................... 526
ATAN ......................................................................................................... 527
CHAR ......................................................................................................... 528
COS ............................................................................................................ 530
CURRENT_ISA_DATE............................................................................. 531
DELETE ..................................................................................................... 532
EXPT .......................................................................................................... 533
FIND........................................................................................................... 534
INSERT ...................................................................................................... 536
LEFT........................................................................................................... 537
LIMIT ......................................................................................................... 539
LOG ............................................................................................................ 540
MAX........................................................................................................... 541
MID............................................................................................................. 542
MIN............................................................................................................. 543
MLEN......................................................................................................... 544
MOD........................................................................................................... 546
MUX4......................................................................................................... 547
MUX8......................................................................................................... 549
NOT_MASK............................................................................................... 550
ODD............................................................................................................ 551
OR_MASK ................................................................................................. 553
POW ........................................................................................................... 554
RAND......................................................................................................... 555
REPLACE .................................................................................................. 556
RIGHT ........................................................................................................ 558
ROL ............................................................................................................ 559
ROR ............................................................................................................ 560
SEL ............................................................................................................. 562
SHL............................................................................................................. 563
SHR ............................................................................................................ 564
SIN.............................................................................................................. 565
SQRT .......................................................................................................... 566
SUB_DATE_DATE ................................................................................... 567
TAN ............................................................................................................ 569
TRUNC....................................................................................................... 570
XOR_MASK .............................................................................................. 571
DS800 Development Suite 2.1 - Table of Contents xv
Standard Function Blocks.................................................................................. 573
ALARM...................................................................................................... 575
AVERAGE................................................................................................. 575
BLINK........................................................................................................ 577
CMP............................................................................................................ 578
CONNECT ................................................................................................. 579
CTD ............................................................................................................ 581
CTU ............................................................................................................ 582
CTUD ......................................................................................................... 583
DBG_CLR_GET_ERR .............................................................................. 585
DBG_CLR_SET_ERR............................................................................... 585
DBG_GET_ERR ........................................................................................ 586
DBG_SET_ERR......................................................................................... 586
DERIVATE ................................................................................................ 587
EVENT....................................................................................................... 588
F_TRIG ...................................................................................................... 588
HYSTER .................................................................................................... 589
INTEGRAL ................................................................................................ 590
R_TRIG ...................................................................................................... 591
REQUEST_LICENSE................................................................................ 592
RS ............................................................................................................... 593
SET_PRIORITY ........................................................................................ 594
SIG_GEN ................................................................................................... 595
SOFT_POINT_READ................................................................................ 596
SOFT_POINT_WRITE.............................................................................. 597
SR ............................................................................................................... 598
STACKINT ................................................................................................ 600
TLP_GET_DINT........................................................................................ 601
TLP_GET_REAL....................................................................................... 602
TLP_GET_SINT ........................................................................................ 603
TLP_GET_STRING................................................................................... 604
TLP_GET_TLP .......................................................................................... 605
TLP_SET_DINT ........................................................................................ 606
TLP_SET_REAL ....................................................................................... 607
TLP_SET_SINT......................................................................................... 608
TLP_SET_STRING ................................................................................... 609
TOF ............................................................................................................ 609
TON............................................................................................................ 610
TP ............................................................................................................... 611
xvi DS800 Development Suite 2.1 - User Manual
URCV_S..................................................................................................... 612
USEND_S................................................................................................... 613
Glossary ............................................................................................................. 615
Copyright ........................................................................................................... 661
DS800 Development Suite 2.1 - Table of Contents xvii
Workbench
The DS800 software suite supports both the ROC800-Series and the FloBoss 107 flow
computers from Remote Automation Solutions (RAS). To simplify usage, this
documentation refers to both devices as the “RAS device.” If there is a situation where we
restrict functionality to either the ROC800-Series or the FB107, we note it.
The Workbench is the environment in which you develop multi-process control projects made
up of virtual machines running on hardware components, called target nodes. The development
process consists of creating projects made up of configurations, representing, individual target
nodes, on which one or more instances of resources, i.e., virtual machines, are downloaded. At
runtime, the virtual machines run on these target nodes.
Projects can be developed using any of the five languages of the IEC 61131 standard: SFC:
Sequential Function Chart (or Grafcet), FBD: Function Block Diagram, LD: Ladder Diagram,
ST: Structured Text, and IL: Instruction List. You can also use the Flow Chart language. When
building, resources are compiled to produce very fast "target independent code" (TIC) or
"C" code.
Within resources, you can declare variables using standard IEC 61131 data types (i.e., Boolean,
integer, real, etc.) or user-defined types such as arrays or structures. For defined variables, you
can set up alarms, events, and trending. Furthermore, field communications allow you to
connect variables to field equipment. Resources can share variables using internal bindings or
external bindings. Internal bindings are between resources within the same project. External
bindings are between resources belonging to different projects.
DS800 Development Suite 2.1 - Workbench 1
You develop projects on a Windows development platform, in the Workbench and language
editors. The Workbench graphically represents and organizes configurations, resources, POUs,
and networks within a project from multiple views:
link architecture
hardware architecture
dictionary
I/O wiring
bindings
Libraries made up of configurations and resources enable you to define functions and function
blocks for reuse throughout projects.
Individual resources, from the configurations making up a project, are downloaded, using the
ETCP or ISARSI (serial link) network, onto target RAS device nodes running real-time
operating systems. Communication between configurations can be implemented using the
TCP\IP network. You can choose to implement any other network.
You can choose to simulate the running of a project, after building a project, using high-level
debugging tools, before actually downloading the resources making up configurations to the
target nodes.
You can set four levels of access control in a Workbench application:
password protection and read-only mode for a complete project
password protection and read-only mode for individual resources
password protection for individual POUs
password protection for a target
2 DS800 Development Suite 2.1 - User Manual
Appearance
Title bar
Menu bar
Tool bars
Workspace
Output window
Status bar
DS800 Development Suite 2.1 - Workbench 3
Title Bar
For help locating the Title Bar, see the Appearance diagram. The Title Bar displays the
application name and the filename of the active project, if any are open, along with the current
view (Hardware Architecture, Link Architecture, Dictionary or I/O Wiring).
Control Icon
At the left end of the Title Bar is the Control Icon, which is used to access the Control Menu
(see following section). Double-clicking on the Control Icon closes the Workbench.
Control Menu
Clicking on the Control icon opens the Control Menu. The Control Menu is used to position
the Main Window or to exit.
Window Buttons
The standard window buttons appear at the right end of the Title Bar. Use these to resize or
close the Window.
4 DS800 Development Suite 2.1 - User Manual
Menu Bar
The options available from the menu bar differ slightly for the hardware architecture and link
architecture views of a project. Some options are available as keyboard commands.
File New Project/Library Ctrl+N creates a new project or library
Open Project/Library Ctrl+O opens an existing project or library
Save Project/Library Ctrl+S saves the current project or library
Rename Project/Library renames the current project or
library
Project Properties sets project access control
Import imports three types of information:
- PLC definitions using text files
generated with the Target Definition
Builder
- Workbench elements (projects,
configurations, resources, and
POUs)
- Variables data
Export exports Workbench elements
(projects, configurations, resources,
and POUs) or variables data
Print Ctrl+P accesses the Document Generator
Exit Ctrl+Q leaves the Workbench
DS800 Development Suite 2.1 - Workbench 5
Edit Open Alt+N opens the item selected from a
resource. This option is only
available in the link architecture
view.
Undo Ctrl+Z cancels the last action
Redo Ctrl+Y restores the last cancelled action
Cut Ctrl+X removes the selected item and places
it on clipboard
Copy Ctrl+C takes a copy of the selected item and
places it on the clipboard. For the
link architecture view, this option
appears as Copy Program where it
copies an entire selected program.
Paste Ctrl+V inserts the contents of the clipboard
into the selected item
Delete DEL removes the selected item from the
selected item
Find / Replace in POUs Ctrl+F finds and replaces text in a project, a
configuration, a resource, or a POU
Select All Ctrl+A selects all items in the active view
Properties accesses the properties for the
selected item
Move to lower level sets the selected FC or SFC program
as a sub-program of the next
program in the resource. This option
is only available in the link
architecture view.
Move to upper level sets the selected FC or SFC program
as a parent program of the previous
program in the resource. This option
is only available in the link
architecture view.
6 DS800 Development Suite 2.1 - User Manual
Insert Configuration inserts a configuration in the
workspace. This option is only
available in the hardware
architecture view.
Resource inserts a resource. For the hardware
architecture view of a project, you
insert resources in selected
configurations. For the link
architecture view, you insert
resources in the workspace.
Network inserts a network in the workspace.
This option is only available in the
hardware architecture view.
Add Variable Group adds a variable group to the selected
resource. This option is only
available in the link architecture
view.
Add Program adds a program to the selected
resource. This option is only
available in the link architecture
view.
Add SFC Sub-program adds an SFC sub-program to the
selected program. When an FC
program is selected, adds an FC
sub-program. This option is only
available in the link architecture
view.
DS800 Development Suite 2.1 - Workbench 7
Project Types Ctrl+3 accesses the Types Tree of the
Dictionary view
Variables Ctrl+G accesses the Variables Tree of the
Dictionary view
Function /Function Block
Parameters
External Binding List Ctrl+0 accesses the External Binding list
Internal Binding List Ctrl+1 accesses the Binding List window
Defined Words Ctrl+2 accesses the Defined Words Tree of
I/O Wiring
Build Project/Library compiles the current project or
Rebuild Project/Library recompiles the complete current
Clean Project/Library removes files created during the last
Build Resource compiles the selected resource
Clean Resource removes files created during the last
Build Program compiles the selected program. This
Stop Build stops a build in progress
accesses the Parameters Tree of the
Dictionary view. This option is only
available in the link architecture
view.
window where you can define
external variable bindings between
producer variables of a source
resource in a given project with
consumer variables of a destination
resource in a different project
for the selected binding. This option
is only available in the link
architecture view.
the Dictionary view
library
project
build of the current project or library
build of the selected resource
option is only available in the link
architecture view.
8 DS800 Development Suite 2.1 - User Manual
Tools Compact Database optimizes the current project’s
database
Edit Project Description Ctrl+K accesses the description editor for
the current project or library
Edit Description accesses the description editor for
the selected item
Unlock Resource unlocks a resource currently locked
by another user. This option is only
available when editing a project in
normal mode and one or more
resources of the project are opened
in single-resource editing mode by
other users.
Add/Remove Dependencies accesses the Add/Remove
Dependencies window where you
define the libraries used by a project
Browser Ctrl+B accesses the cross references
browser listing and localizing all
instances of global variables (cross
references) and I/Os declared in a
project
Check-in Checks in a project, configuration,
resource, or POU definition not
having the read-only attribute into a
version source control database
View History Views the history of a project,
configuration, resource, or POU that
has been checked in repeatedly to a
version source control database
Events Viewer accesses the Events Viewer
DS800 Development Suite 2.1 - Workbench 9
Debug Download Ctrl+M accesses the Download editor from
where you download resources onto
target nodes
Debug Target Alt+F6 starts the project in debug mode
Simulation Alt+F7 starts the project in simulation mode
On-line Change: Download downloads only the changes made
since the last download for the
selected running resource. The
download includes the symbol table
(complete or reduced as selected in
the resource’s compilation options).
On-line Change: Update updates a resource running on a
target to use the latest on-line change
download code. For use when you
chose to update the resource code
later.
Start starts the selected resource, while in
run mode
Stop stops the selected resource, while in
run mode
Start from code saved on
Targ et
Save Code on target saves the code of the running
Clean Stored Code removes code previously saved on a
Diagnosis accesses the Diagnosis window
Refresh Status updates the resource status
restarts the selected resource using
the code saved on the target node
resource (including changes)
target
displaying general and status
information for the selected resource
information, appearing in the title
bar, for all resources
10 DS800 Development Suite 2.1 - User Manual
Loading...