Irai Automgen 8 Operating Instructions Automgen8 En

User Manual: irai Automgen 8 - Operating Instructions Free User Guide for Irai Automgen Software, Manual

Open the PDF directly: View PDF .
Page Count: 490

Download
Open PDF In Browser	View PDF

NEXT

AUT
OM
GEN

NERAT
E
G

N
O
I

AUTOMGEN
www.irai.com

8

ENVIRONMENT................................................................................................................................................. 13
INSTALLATION ................................................................................................................................................. 15
Configuration required .............................................................................................................................. 15
Installation in a network ............................................................................................................................ 15
NEW FEATURES OF AUTOMGEN8................................................................................................................... 16
Choice of “Beginner / Expert” mode......................................................................................................... 16
Increased integration of the Grafcet 60848 standard ................................................................................ 16
Compatibility of files.................................................................................................................................. 16
Physical engine integrated to IRIS3D........................................................................................................ 16
Enhanced 3D object handling in IRIS3D................................................................................................... 16
Improved links between AUTOMGEN and IRIS3D objects ....................................................................... 16
Textured IRIS3D objects ............................................................................................................................ 16
Drag and drop from IRIS3D to AUTOMGEN sheets................................................................................. 17
AUTOMSIM user-definable object ............................................................................................................ 17
Drag and drop from AUTOMSIM to AUTOMGEN sheets ........................................................................ 17
Improvements to the environment .............................................................................................................. 17
ENVIRONMENT ................................................................................................................................................. 18
Start............................................................................................................................................................ 18
General views ............................................................................................................................................ 19
Selecting targets in expert mode ................................................................................................................ 21
Selecting targets in beginner mode ............................................................................................................ 21
Palettes in expert mode.............................................................................................................................. 22
Palettes in beginner mode.......................................................................................................................... 22
Displaying or hiding the project window or message window .................................................................. 24
Displaying the work space in full screen mode.......................................................................................... 24
Keyboard shortcuts .................................................................................................................................... 24
LICENSES.......................................................................................................................................................... 25
Registering a license .................................................................................................................................. 25
Sending a user code to IRAI....................................................................................................................... 26
Sending a file by e-mail (the best solution)............................................................................................................ 26
Copying the user code in an e-mail message ......................................................................................................... 27
By fax (not recommended) .................................................................................................................................... 27
By telephone (highly unadvisable)......................................................................................................................... 27

Entering the validation/enable code .......................................................................................................... 27
Validating by a e-mail received file ....................................................................................................................... 27
Validating for a code received in the text of an e-mail .......................................................................................... 27
Validating for a code received by fax or telephone................................................................................................ 27

Modifying a license .................................................................................................................................... 27
Moving a license from one computer to another........................................................................................ 28
Network licenses ........................................................................................................................................ 29
Adding a network license....................................................................................................................................... 30
Modifying a license ............................................................................................................................................... 30
Connecting to client stations .................................................................................................................................. 30

Additional information on installing AUTOMGEN in a network environment.......................................... 31
General information............................................................................................................................................... 31
Installing AUTOMGEN8 on a file server............................................................................................................... 31
Installing one or more AUTOMGEN8 licenses on a network license manager...................................................... 31
Installing the network license server as a service................................................................................................... 33

Uninstallation ............................................................................................................................................ 34
Errors......................................................................................................................................................... 34
THE PROJECT .................................................................................................................................................... 35
Files generated with AUTOMGEN7 ........................................................................................................... 35
Importing an application from an earlier version of AUTOMGEN (version 6 or earlier) ........................ 35
Generating a free distribution executable file............................................................................................ 35
Modifying project properties ..................................................................................................................... 36
Modifying security options .................................................................................................................................... 36
Advanced options .................................................................................................................................................. 36
User interface......................................................................................................................................................... 36
Model..................................................................................................................................................................... 36
Automatic GO........................................................................................................................................................ 37

THE BROWSER.................................................................................................................................................. 38

Sheets ......................................................................................................................................................... 39
Adding a new sheet................................................................................................................................................ 39
Importing old AUTOMGEN version sheets, importing CADEPA sheets ............................................................. 40
Modifying the sheet compilation order .................................................................................................................. 40
Deleting a sheet from the list ................................................................................................................................. 41
Exporting a sheet to a « .GR7 » file ....................................................................................................................... 41
Copying, Cutting, Pasting a sheet .......................................................................................................................... 41
Renaming a sheet ................................................................................................................................................... 41
Modifying sheet properties. ................................................................................................................................... 41

Symbols ...................................................................................................................................................... 42
Creating a symbol table ......................................................................................................................................... 42
Importing a symbol table ....................................................................................................................................... 42

Configuration............................................................................................................................................. 43
Post-processors ...................................................................................................................................................... 43
Compiler options.................................................................................................................................................... 43

Documentation........................................................................................................................................... 43
Generated files ........................................................................................................................................... 44
Generating the instruction list in pivot code .......................................................................................................... 44
Generating the cross reference list ......................................................................................................................... 44
Post-processors ...................................................................................................................................................... 44

Settings....................................................................................................................................................... 44
Viewing and modifying a variable or variable table .............................................................................................. 44

IRIS objects ................................................................................................................................................ 46
Adding an IRIS 2D object...................................................................................................................................... 46
Deleting an IRIS 2D object.................................................................................................................................... 47
Displaying or hiding an IRIS 2D object................................................................................................................. 47
Cutting, copying, pasting an IRIS 2D object.......................................................................................................... 47
Adding a new IRIS 2D object on a console ........................................................................................................... 47
Modifying the properties of an IRIS 2D object...................................................................................................... 47
Setting an object model accessible on the assistant................................................................................................ 48
Importing an IRIS 2D object in an earlier version of AUTOMGEN ..................................................................... 49
Creating an IRIS 3D console ................................................................................................................................. 49

Resources ................................................................................................................................................... 50
Adding a file to the resources ................................................................................................................................ 50
Deleting a file from the resources .......................................................................................................................... 50
Renaming a file in the resources ............................................................................................................................ 50
Modifying a file in the resources ........................................................................................................................... 50
Adding and converting 3D STUDIO files in the resources.................................................................................... 50

External modules ....................................................................................................................................... 50
DESIGNING PROGRAMS ..................................................................................................................................... 52
Designing with the assistant ...................................................................................................................... 52
Designing with the shortcut menu.............................................................................................................. 53
Designing with the pallet ........................................................................................................................... 53
Enhancing and customizing the pallet.................................................................................................................... 53

Designing with the keyboard keys.............................................................................................................. 53
Delete block ........................................................................................................................................................... 53
Link blocks ............................................................................................................................................................ 53
Grafcet blocks........................................................................................................................................................ 54
Flowchart blocks.................................................................................................................................................... 56
Ladder blocks......................................................................................................................................................... 56
Action blocks ......................................................................................................................................................... 57
Test blocks............................................................................................................................................................. 58
Organization chart blocks ...................................................................................................................................... 58
Function block blocks............................................................................................................................................ 58
Other blocks........................................................................................................................................................... 59

Documenting program elements ................................................................................................................ 59
Adding symbols .......................................................................................................................................... 60
RUNNING AN APPLICATION ............................................................................................................................... 62
To run an application easily ................................................................................................................................... 62
To end the run........................................................................................................................................................ 62
To compile only ..................................................................................................................................................... 62
To stop the compilation ......................................................................................................................................... 62
To connect to a processor or install a PC ............................................................................................................... 62
To disconnect a processor or uninstall a PC........................................................................................................... 62
To put the target in RUN mode.............................................................................................................................. 62

To put the target in STOP mode ............................................................................................................................ 62
To initialize the target ............................................................................................................................................ 62
To run a program cycle on the target (generally not supported on processors)...................................................... 63
To activate the dynamic display............................................................................................................................. 63

THE COMPILER ................................................................................................................................................. 64
Modifying compiler options ....................................................................................................................... 64
Displaying compilation messages.............................................................................................................. 64
Finding an error ........................................................................................................................................ 64
RUNNING PROGRAMS ON A PC ......................................................................................................................... 66
Configuring the number of variables ......................................................................................................... 66
PC system variables................................................................................................................................... 67
Modifying the run period ........................................................................................................................... 68
Driving inputs/outputs ............................................................................................................................... 68
IRIS 2D REFERENCES ....................................................................................................................................... 70
Modifying object display............................................................................................................................ 70
Modifying object characteristics................................................................................................................ 71
Removing an object ............................................................................................................................................... 71
Dimensioning an object ......................................................................................................................................... 71
Moving an object ................................................................................................................................................... 71
Putting an object in « User » mode ...................................................................................................................... 71
Putting an object in « Configuration » mode ....................................................................................................... 71
Modifying the characteristics of an object ............................................................................................................. 71

Block access to configuration for all objects ............................................................................................. 72
Basic objects, preset objects ...................................................................................................................... 72
List of basic objects.................................................................................................................................... 72
« Console » object.................................................................................................................................................. 72
The « Button and light » object............................................................................................................................. 72
The« Object » object.............................................................................................................................................. 72
The « Digital value » object................................................................................................................................... 72
The « Screen, keyboard, message list » object....................................................................................................... 72
The « Sound » object ............................................................................................................................................. 73
The « Data archive » object ................................................................................................................................... 73
The « Program » object.......................................................................................................................................... 73
The « Dialogue box » object .................................................................................................................................. 73
The « Analog value » object .................................................................................................................................. 73

Practical experience .................................................................................................................................. 73
Step 1 ..................................................................................................................................................................... 73
Step 2 ..................................................................................................................................................................... 74
Step 3 ..................................................................................................................................................................... 74
Step 4 ..................................................................................................................................................................... 74
Step 5 ..................................................................................................................................................................... 74
Step 6 ..................................................................................................................................................................... 75
Step 7 ..................................................................................................................................................................... 76

Creating an autonomous supervision application ..................................................................................... 77
Syntax for accessing the state of variables................................................................................................. 77
Boolean state.......................................................................................................................................................... 77
Numeric state ......................................................................................................................................................... 78
Modifying the state ................................................................................................................................................ 78
Special orders......................................................................................................................................................... 78
Interchanging objects ............................................................................................................................................. 79

Details of a « Console » object .................................................................................................................. 79
« Aspect » tab ........................................................................................................................................................ 79
« Bitmap » tab........................................................................................................................................................ 80
« Links » tab .......................................................................................................................................................... 80
« Options » tab....................................................................................................................................................... 81
« Sisters » tab......................................................................................................................................................... 81
« External » tab...................................................................................................................................................... 81

Details of an « Illuminated Button » object ............................................................................................... 82
« Aspect » tab ........................................................................................................................................................ 82
« Links » tab .......................................................................................................................................................... 82
« Options » tab....................................................................................................................................................... 83

Details of a « Digital value » object .......................................................................................................... 85
« Aspect » tab ........................................................................................................................................................ 85
« Texts » tab........................................................................................................................................................... 86
« Links » tab .......................................................................................................................................................... 86

Details of an « Analog value » object ........................................................................................................ 86
« Aspect » tab ........................................................................................................................................................ 86
« Links » tab .......................................................................................................................................................... 87
« Limits» tab .......................................................................................................................................................... 87
« Graduations » tab ................................................................................................................................................ 88

Details of « Screen, keyboard, message list » object ................................................................................. 89
Links with the application...................................................................................................................................... 89
Message classes ..................................................................................................................................................... 90
« Aspect » tab ........................................................................................................................................................ 90
This is used to set an object type. See chapter links with the application .............................................................. 90
« Links » tab .......................................................................................................................................................... 91
« List » tab ............................................................................................................................................................. 91
« Options » tab....................................................................................................................................................... 92
« Messages » tab .................................................................................................................................................... 93

Details of « Data archive » object ............................................................................................................. 93
« Aspect » tab ........................................................................................................................................................ 93
« Data » tab............................................................................................................................................................ 93
« Options » tab....................................................................................................................................................... 95
« Tables » tab......................................................................................................................................................... 95
« Graph» tab .......................................................................................................................................................... 96
« Graduations » tab ................................................................................................................................................ 97
« Grid » tab ............................................................................................................................................................ 98

Details of « Object » object...................................................................................................................... 100
« Aspect » tab ...................................................................................................................................................... 100
« Links » tab ........................................................................................................................................................ 101
« Formats » tab .................................................................................................................................................... 102
« Bitmap » tab...................................................................................................................................................... 102
« Wmf » tab ......................................................................................................................................................... 103
« Colors » tab....................................................................................................................................................... 103
« Gauge » tab ....................................................................................................................................................... 104
« Sensor» tab........................................................................................................................................................ 104
« Options » tab..................................................................................................................................................... 105
Advanced techniques ........................................................................................................................................... 105

Details of « Sound » object ...................................................................................................................... 106
« Aspect » tab ...................................................................................................................................................... 106
« Sounds » tab...................................................................................................................................................... 106

Details of « Dialogue box » object........................................................................................................... 106
« Aspect » tab ...................................................................................................................................................... 106

« Links » tab............................................................................................................................................. 107
« Messages » tab .................................................................................................................................................. 108

Details of « Program » object.................................................................................................................. 108
Run time distribution ........................................................................................................................................... 108
Display................................................................................................................................................................. 108
Syntax .................................................................................................................................................................. 109
Stating variables................................................................................................................................................... 109
Writing a program................................................................................................................................................ 109
Constants ............................................................................................................................................................. 110
Assignment .......................................................................................................................................................... 110
Calculations ......................................................................................................................................................... 110
Tests..................................................................................................................................................................... 111
Loops ................................................................................................................................................................... 111
Variable or variable table address ........................................................................................................................ 112
List of functions................................................................................................................................................... 112
Error messages..................................................................................................................................................... 118
« Aspect » tab ...................................................................................................................................................... 119
« Program » tab.................................................................................................................................................... 120

IRIS 2D EXAMPLES ........................................................................................................................................ 121
Example of composed objects .................................................................................................................. 121
Example of using the « Screen, keyboard, message list » object as a message list.................................. 124
Example of using the « SCREEN KEY » object as a terminal ................................................................. 125
Example of an application composed of multiple pages .......................................................................... 126
Example of using the «OBJECT » object................................................................................................. 126
Example of using the «ARCHIVE» object................................................................................................ 131
Example of using the «PROG » object..................................................................................................... 131
Examples of supervision application 1 ................................................................................................... 131

Examples of supervision application 2 .................................................................................................... 132
Example of operating part simulation 1.................................................................................................. 133
Example of operating part simulation 2................................................................................................... 134
IRIS 3D REFERENCES ..................................................................................................................................... 135
Tutorial .................................................................................................................................................... 136
Creating an IRIS 3D console ................................................................................................................... 136
Adding 3D files to the project .................................................................................................................. 137
Configuring the objects............................................................................................................................ 138
Adding objects to the 3D world................................................................................................................ 139
Removing a 3D file from the resources.................................................................................................... 139
Removing an object from a 3D world ...................................................................................................... 139
Importing an “enhanced” object ............................................................................................................. 139
Exporting an “Enhanced” object ............................................................................................................ 142
Example of creating a 3D simulation based on enhanced objects ........................................................... 143
Applying a behavior to an object ............................................................................................................. 154
Name of AUTOMGEN variables ........................................................................................................................ 155
Adding a translation............................................................................................................................................. 156
Adding a rotation ................................................................................................................................................. 159
Adding a color change ......................................................................................................................................... 160
Adding a link ....................................................................................................................................................... 161
Adding another behavior...................................................................................................................................... 162

Physical engine ........................................................................................................................................ 163
IRIS 3D example ...................................................................................................................................... 165
LANGUAGE....................................................................................................................................................... 167
COMMON ELEMENTS ...................................................................................................................................... 169
Variables.................................................................................................................................................. 169
Booleen variables................................................................................................................................................. 169
Numeric variables ................................................................................................................................................ 170
Time delay ........................................................................................................................................................... 170

Actions ..................................................................................................................................................... 172
Assignment of a boolean variable ........................................................................................................................ 172
Complement assignment of a boolean variable.................................................................................................... 173
Setting a boolean variable to one ......................................................................................................................... 174
Resetting a boolean variable ................................................................................................................................ 175
Inverting a boolean variable................................................................................................................................. 175
Resetting a counter, a word or a long................................................................................................................... 176
Incrementing a counter, a word or a long............................................................................................................. 177
Decrementing a counter, word or long................................................................................................................. 177
Time delays.......................................................................................................................................................... 178
Interferences among the actions........................................................................................................................... 178
IEC1131-3 standard actions................................................................................................................................. 179
Multiple actions ................................................................................................................................................... 180
Literal code .......................................................................................................................................................... 180

Tests ......................................................................................................................................................... 180
General form........................................................................................................................................................ 181
Test modifier........................................................................................................................................................ 181
Time delays.......................................................................................................................................................... 182
Priority of boolean operators................................................................................................................................ 182
Always true test ................................................................................................................................................... 182
Numeric variable test ........................................................................................................................................... 182
Transitions on multiple lines................................................................................................................................ 184

Use of symbols ......................................................................................................................................... 184
Symbol syntax ..................................................................................................................................................... 184
Automatic symbols .............................................................................................................................................. 184
Automatic symbol syntax .................................................................................................................................... 184
How does the compiler manage the automatic symbols ?.................................................................................... 185
Range of variable attribution................................................................................................................................ 185
Fixed-address symbols......................................................................................................................................... 185

Examples.................................................................................................................................................. 186
Grafcet ..................................................................................................................................................... 188
Simple Grafcet ..................................................................................................................................................... 188
Divergence and convergence in « And » ............................................................................................................ 191
Divergence and convergence in « Or » ................................................................................................................ 193

Destination and source steps, destination and source transitions ......................................................................... 195
Multiple actions, conditioned actions .................................................................................................................. 196
Conditional actions, event-based actions ............................................................................................................. 197
Actions on activation or deactivation of a step .................................................................................................... 197
Actions on transition crossing.............................................................................................................................. 197
Synchronization ................................................................................................................................................... 198
Grafcet setting...................................................................................................................................................... 199
Grafcet forcings (60848 standard) ....................................................................................................................... 206
Macro-steps.......................................................................................................................................................... 207
Encapsulating steps.............................................................................................................................................. 210
Grafcet / Ladder and Grafcet / Flow chars links .................................................................................................. 212
Counters............................................................................................................................................................... 213

Gemma ..................................................................................................................................................... 214
Creating a Gemma ............................................................................................................................................... 216
ontent of Gemma rectangles ................................................................................................................................ 216
Obtaining a corresponding Grafcet ...................................................................................................................... 216
Printing Gemma................................................................................................................................................... 217
Exporting Gemma................................................................................................................................................ 217
Example of Gemma ............................................................................................................................................. 217

Ladder...................................................................................................................................................... 220
Example of Ladder............................................................................................................................................... 221

Flow chart................................................................................................................................................ 222
Drawing flow charts............................................................................................................................................. 223
Example of a flow chart....................................................................................................................................... 224

Literal languages ..................................................................................................................................... 226
How is a literal language used?............................................................................................................................ 226
Setting a code box................................................................................................................................................ 227
Low level literal language.................................................................................................................................... 228
Macro-instruction................................................................................................................................................. 285
Libraries............................................................................................................................................................... 286
Pre-defined macro-instructions ............................................................................................................................ 286
Description of pre-defined macro-instructions..................................................................................................... 286
Example of low level literal language.................................................................................................................. 288

Extended literal language ........................................................................................................................ 291
Writing boolean equations ................................................................................................................................... 292
Writing numeric equations................................................................................................................................... 293
IF...THEN...ELSE...structure......................................................................................................................................... 294
WHILE ... ENDWHILE structure........................................................................................................................ 295
Example of a program in extended literal language............................................................................................. 295

ST literal language................................................................................................................................... 296
General Information............................................................................................................................................. 296
Boolean equations................................................................................................................................................ 297
Numeric equations ............................................................................................................................................... 298
Programming structures ....................................................................................................................................... 299
Example of a program in extended literal language............................................................................................. 300

Organization chart................................................................................................................................... 300
Creating an organizational chart .......................................................................................................................... 301
Rectangle content................................................................................................................................................. 302

Illustration ............................................................................................................................................... 302
Function blocks........................................................................................................................................ 304
Creating a function block..................................................................................................................................... 305
Drawing a block and creating a « .ZON » file ..................................................................................................... 305
Creating an « .LIB » file ...................................................................................................................................... 307
Simple example of a function block..................................................................................................................... 307
Illustration............................................................................................................................................................ 308
Supplementary syntax.......................................................................................................................................... 311

Evolved function blocks ........................................................................................................................... 312
Syntax .................................................................................................................................................................. 312
Differentiating between new and old function blocks.......................................................................................... 312
Example ............................................................................................................................................................... 313

Predefined function blocks....................................................................................................................... 313
Conversion blocks................................................................................................................................................ 314
Time delay blocks................................................................................................................................................ 314
String blocks ........................................................................................................................................................ 314
Word table blocks ................................................................................................................................................ 314

Advanced techniques................................................................................................................................ 314

Compiler generated code ..................................................................................................................................... 314
Optimizing generated code .................................................................................................................................. 315

EXAMPLES ...................................................................................................................................................... 317
Regarding examples................................................................................................................................. 317
Simple grafcet...................................................................................................................................................... 317
Grafcet with an OR divergence............................................................................................................................ 318
Grafcet with an AND divergence........................................................................................................................ 319
Grafcet and synchronization ................................................................................................................................ 320
Step setting .......................................................................................................................................................... 321
Destination and source steps ................................................................................................................................ 322
Destination and source steps ................................................................................................................................ 323
Setting Grafcets ................................................................................................................................................... 324
Memorizing Grafcets ........................................................................................................................................... 325
Grafcet and macro-steps ...................................................................................................................................... 326
Linked sheets ....................................................................................................................................................... 327
Flow chart ............................................................................................................................................................ 329
Grafcet and Flow Chart........................................................................................................................................ 330
Literal language box ............................................................................................................................................ 331
Organizational chart............................................................................................................................................. 332
Organizational chart............................................................................................................................................. 333
Function block ..................................................................................................................................................... 334
Function block ..................................................................................................................................................... 335
Ladder.................................................................................................................................................................. 336
Example developed on a train model ................................................................................................................... 337

Educational training manual for AUTOMGEN users.............................................................................. 343
Distribution.............................................................................................................................................. 345
Doctor R. in the home automation kingdom ............................................................................................ 345
First example: « which came first the bulb or the switch … » ................................................................. 346
Solution 1: natural language of an electrician: ladder .......................................................................................... 347
Solution 2: the sequential language of the automation specialist: Grafcet ........................................................... 347

It's your turn to play … ............................................................................................................................ 349
Second example: « time frames, time-switches and other time fun… » ................................................... 349
Solution 1: simplicity........................................................................................................................................... 350
Solution 2: improvement...................................................................................................................................... 351

Third Example: « variation on the theme of coming and going… » ........................................................ 352
Fourth example: « And the push button became intelligent … » ............................................................. 356
The solutions … ....................................................................................................................................... 359
« which came first the switch or the bulb … »..................................................................................................... 359
« time delays, time switches and other time fun… » ........................................................................................... 359
« variation on the theme of coming and going …» .............................................................................................. 361

AUTOMSIM....................................................................................................................................................... 363
INTRODUCTION ............................................................................................................................................... 365
INSTALLATION ............................................................................................................................................... 366
Practical experience ................................................................................................................................ 366
AUTOMGEN’S “BEGINNER” MODE............................................................................................................... 370
USING AUTOMSIM ...................................................................................................................................... 371
Organizing applications........................................................................................................................... 371
Opening an existing application .............................................................................................................. 371
Creating an AUTOMSIM sheet................................................................................................................ 371
Adding an object onto an AUTOMSIM sheet........................................................................................... 372
Using the palette ...................................................................................................................................... 374
Selecting one or more objects. ................................................................................................................. 375
Selecting one or more objects .................................................................................................................. 376
Deleting one or more objects ................................................................................................................... 376
Changing the orientation of one or more objects .................................................................................... 376
Copying/cutting one or more objects to the clipboard............................................................................. 376
Pasting one or more objects from the clipboard...................................................................................... 377
Modifying object properties. .................................................................................................................... 377
Exporting one or more objects................................................................................................................. 377
ADVANCED FUNCTIONS .................................................................................................................................. 378
Interactions between objects.................................................................................................................... 378
Creating sensors associated with a cylinder............................................................................................ 378

Interactions between AUTOMSIM objects and the automaton program ................................................. 380
Interactions between AUTOMSIM objects and the IRIS 3D operational unit simulator ......................... 381
Interactions between AUTOMSIM objects and the IRIS2D supervision objects ..................................... 382
How can a link be made between an IRIS2D pushbutton or switch and an AUTOMSIM pushbutton or switch?382
How can a link be made between an AUTOMSIM object and an IRIS2D indicator light? ................................. 383

Drag and drop from an AUTOMSIM variable to an AUTOMGEN sheet................................................ 384
User-definable objects ............................................................................................................................. 385
Designs .................................................................................................................................................... 387
List of design primitives ........................................................................................................................... 388
Drawing primitive................................................................................................................................................ 388
Attribute primitives.............................................................................................................................................. 390
Other primitives ................................................................................................................................................... 391

Program ................................................................................................................................................... 392
List of programming primitives ........................................................................................................................... 393

Connections ............................................................................................................................................. 395
Example ................................................................................................................................................... 396
POST-PROCESSORS........................................................................................................................................ 397
GENERAL INFORMATION ................................................................................................................................ 399
CONFIGURATION ............................................................................................................................................ 400
Configuration files ................................................................................................................................... 400
System ................................................................................................................................................................. 400
Variable functions................................................................................................................................................ 400
Start-up manufacturer code.................................................................................................................................. 400
End manufacturer code ........................................................................................................................................ 400

Configuration by default .......................................................................................................................... 400
Modifying the default statements......................................................................................................................... 401
Using the default statements. ............................................................................................................................... 401

Displaying and modifying configuration elements................................................................................... 401
System ...................................................................................................................................................... 401
Hardware configuration ....................................................................................................................................... 401
Software configuration......................................................................................................................................... 402
Code generation options ...................................................................................................................................... 402
Stating the variables............................................................................................................................................. 402
Other elements ..................................................................................................................................................... 402
See the « System » element in text format. .......................................................................................................... 402
Displaying system elements................................................................................................................................. 403

Variable functions.................................................................................................................................... 403
Single assignment ................................................................................................................................................ 404
Linear assignment ................................................................................................................................................ 404
Automatic assignment.......................................................................................................................................... 404
Types of AUTOMGEN elimination variables ..................................................................................................... 405
Modifying a variable function element ................................................................................................................ 410
Adding a variable function element ..................................................................................................................... 410
Deleting a variable function element ................................................................................................................... 412
Associating an AUTOMGEN bit to a target system bit ....................................................................................... 412
Associating a table of AUTOMGEN words to a table of fixed target words ....................................................... 413
Associating AUTOMGEN words to target analog inputs or outputs ................................................................... 414
Associating a table of AUTOMGEN bits to a table of target bits ........................................................................ 414
See the variable functions in text format.............................................................................................................. 415

Start-up manufacturer code, end manufacturer code .............................................................................. 415
Reference to an AUTOMGEN variable ............................................................................................................... 415
Referring to an AUTOMGEN application symbol .............................................................................................. 416
Setting and referring to a label............................................................................................................................. 416

Entering machine code in an application ................................................................................................ 416
Selecting connection options.................................................................................................................... 416
Selecting a connection mode.................................................................................................................... 417
Setting communication module parameters ............................................................................................. 417
POST-PROCESSOR PL7.................................................................................................................................... 418
Communication module ........................................................................................................................... 418
Generating an executable file .................................................................................................................. 419
Direct generation of a binary file ......................................................................................................................... 419
Generating an « .FEF » executable file ................................................................................................................ 421

Using interrupt tasks................................................................................................................................ 423

Specific examples ..................................................................................................................................... 423
Analog inputs/outputs .......................................................................................................................................... 424
Fast counter TSX 37-10 ....................................................................................................................................... 424
Fast counter TSX 37-10 used in counting............................................................................................................ 424
Fast counter TSX 37-22 ....................................................................................................................................... 424
ASI....................................................................................................................................................................... 424
MAGELIS ........................................................................................................................................................... 424

POST-PROCESSOR PL72.................................................................................................................................. 425
Selecting processor type .......................................................................................................................... 425
Specific syntax elements........................................................................................................................... 425
Calling up PL72 function blocks ......................................................................................................................... 425
Using a fast task................................................................................................................................................... 427

Communication module ........................................................................................................................... 428
Specific examples ..................................................................................................................................... 428
Analog inputs/outputs .......................................................................................................................................... 429
Fast counter.......................................................................................................................................................... 430
Text blocks and xbt.............................................................................................................................................. 430
UNITELWAY text blocks ................................................................................................................................... 433
TOR extension module ........................................................................................................................................ 435
Conversion........................................................................................................................................................... 435
Time/date ............................................................................................................................................................. 435

POST-PROCESSOR S7200 ................................................................................................................................ 436
Selecting CPU type .................................................................................................................................. 436
Communication module ........................................................................................................................... 436
Specific example....................................................................................................................................... 436
POST-PROCESSOR ABB .................................................................................................................................. 437
Selecting processor type .......................................................................................................................... 437
Processor AC31 ................................................................................................................................................... 437
Processor CS31.................................................................................................................................................... 437

Communication module ........................................................................................................................... 437
Utility ....................................................................................................................................................... 437
Specific examples ..................................................................................................................................... 437
Analog inputs/outputs .......................................................................................................................................... 438
Interrupt ............................................................................................................................................................... 438

POST-PROCESSOR GE-FANUC / ALSPA ....................................................................................................... 439
Selecting processor type .......................................................................................................................... 439
Communication module ........................................................................................................................... 439
Utility ....................................................................................................................................................... 439
POST-PROCESSOR STEP5 ............................................................................................................................... 440
Communication module ........................................................................................................................... 440
Application structure ............................................................................................................................... 440
Selecting program blocks to use .......................................................................................................................... 443
Selecting data blocks ........................................................................................................................................... 443

Selecting processor type .......................................................................................................................... 444
Associating code written on a sheet to a program block ......................................................................... 444
Specific syntaxes ...................................................................................................................................... 444
Setting blocks....................................................................................................................................................... 445

POST-PROCESSOR TSX 07 .............................................................................................................................. 447
Communication module ........................................................................................................................... 447
POST-PROCESSOR PS3-PS4 ............................................................................................................................ 449
Communication module ........................................................................................................................... 449
POST-PROCESSOR PS4 .................................................................................................................................... 450
Module de communication ....................................................................................................................... 450
Transferring programs to MOELLER SUCOSOFT software .................................................................. 450
Proceed as follows to import the file generated by AUTOMGEN in the MOELLER software then inject it in the
processor.............................................................................................................................................................. 451

POST-PROCESSOR RPX................................................................................................................................... 455
Selecting processor type .......................................................................................................................... 455
Communication module ........................................................................................................................... 455
Utility ....................................................................................................................................................... 455
POST-PROCESSOR PL71.................................................................................................................................. 456
Selecting processor type .......................................................................................................................... 456
Communication module ........................................................................................................................... 456

Fast counter task...................................................................................................................................... 456
Specific examples ..................................................................................................................................... 456
Counting .............................................................................................................................................................. 457
Fast counter.......................................................................................................................................................... 457

POST-PROCESSOR PB...................................................................................................................................... 458
Selecting processor type .......................................................................................................................... 458
Communication module ........................................................................................................................... 458
Specific syntaxes ...................................................................................................................................... 458
POST-PROCESSOR SMC .................................................................................................................................. 460
Selecting processor type .......................................................................................................................... 460
Communication module ........................................................................................................................... 460
Specific syntaxes ...................................................................................................................................... 460
POST-PROCESSOR S7300 ................................................................................................................................ 461
Communication module ........................................................................................................................... 461
Specific syntaxes ...................................................................................................................................... 461
Setting block variables......................................................................................................................................... 462
Calling up blocks ................................................................................................................................................. 462

Importing in SIEMENS SIMATIC software ............................................................................................. 463
Structure of generated code ..................................................................................................................... 465
Selecting program blocks to use .......................................................................................................................... 469

Associating code written on a sheet to a program block ......................................................................... 469
Specific examples ..................................................................................................................................... 469
Calling up a STEP7 block.................................................................................................................................... 470
Using an OB block............................................................................................................................................... 470

POST-PROCESSOR OMRON............................................................................................................................ 471
Select PLC model..................................................................................................................................... 471
Communication module ........................................................................................................................... 471
Transferring applications to the CX-PROGRAMMER software.............................................................. 471
Specific syntax.......................................................................................................................................... 474
Associating code written on a sheet to a program block ......................................................................... 474
Specific example....................................................................................................................................... 474
POST-PROCESSOR ALSPA.............................................................................................................................. 475
Communication module ........................................................................................................................... 475
POST-PROCESSOR ZELIO............................................................................................................................... 476
Communication module ........................................................................................................................... 476
POST-PROCESSOR FESTO .............................................................................................................................. 477
Communication module ........................................................................................................................... 477
Generating a binary file........................................................................................................................... 477
Importation in a FESTO software workgroup ......................................................................................... 477
POST-PROCESSOR ALLEN-BRADLEY ......................................................................................................... 479
Communication module ........................................................................................................................... 479
Transferring programs to ROCKWELL RS-Logix 500 Software ............................................................. 479
POST-PROCESSOR TWIDO ............................................................................................................................. 481
Processor configuration selection............................................................................................................ 481
Communication module ........................................................................................................................... 481
POST-PROCESSOR MITSUBISHI.................................................................................................................... 482
Selecting the type of processor................................................................................................................. 482
Communication module ........................................................................................................................... 482
Transferring programs to MITSUBISHI FX-WIN software.................................................................... 483
Transferring programs to MITSUBISHI GX-DEVELOPPER software.................................................. 483
POST-PROCESSOR MITSUBISHI-Q ............................................................................................................... 485
Communication module ........................................................................................................................... 485
Transferring programs to MITSUBISHI GX-DEVELOPPER software.................................................. 485
POST-PROCESSOR GEM.................................................................................................................................. 486
Communication module ........................................................................................................................... 486
POST-PROCESSOR ZELIO 2 ............................................................................................................................ 487
Initializing the automaton ........................................................................................................................ 487
Configuring the module ........................................................................................................................... 487
Communication module ........................................................................................................................... 487
POST-PROCESSOR PANASONIC.................................................................................................................... 488
Selecting the configuration of the automaton .......................................................................................... 488

Communication module ........................................................................................................................... 488

Environment

Environment

Installation
If you are installing AUTOMGEN from the AUTOMGEN CD-ROM, place
it in your CD-ROM drive.
The installation is launched automatically.
If this does not occur, launch the “Setup.exe” executable which is in the
CD-ROM root.

Configuration required
PC compatible computer, with:
- WINDOWS 98 SE or WINDOWS ME or WINDOWS 2000 or
WINDOWS XP or WINDOWS 2003 or WINDOWS VISTA operating
system,
- 256 MB memory (depending on the operating system: the operating
system itself may require more memory),
- graphics board with a resolution of at least 1024 x 768 in 65536 colors.

Installation in a network
AUTOMGEN can be installed in a network environment.
Execute the installation procedure on the “server” PC (make sure you
have all of the access rights when you carry out the procedure).
To launch AUTOMGEN, on the client PCs, create a shortcut to the
“autom8.exe” executable of the AUTOMGEN installation directory on the
server PC.
Refer to the chapter “additional information on installing AUTOMGEN in
a network environment” for more information about installing
AUTOMGEN and licenses in a network environment.

AUTOMGEN8

15

©opyright 1988-2007 IRAI

Environment

New features of AUTOMGEN8
Choice of “Beginner / Expert” mode
“Beginner” mode allows beginners to use a “simplified” environment that
is extremely easy to use.

Increased integration of the Grafcet 60848 standard
The new elements of this standard can now be accessed in the
contextual program editing menus.

Compatibility of files
The files generated by all of the AUTOMGEN8 versions can be re-read
by all of the AUTOMGEN8 versions.

Physical engine integrated to IRIS3D
The TOKAMAK motor is integrated to IRIS3D. This enables an extremely
realistic simulation of the 3D operational units to be obtained.

Enhanced 3D object handling in IRIS3D
The saving and re-reading of objects and behaviors allows you to
manage libraries of easily reusable objects. Predefined objects
(cylinders, conveyor belts, etc) are proposed as standard. A 3D
operational unit simulation application can now be created in just a
couple of mouse clicks.

Improved links between AUTOMGEN and IRIS3D objects
Enhanced modes allow you to easily handle displacements of complex
objects between AUTOMGEN and IRIS3D. An AUTOMGEN variable
can, for example, give the speed of an object directly. Position reporting
can also be simulated in the manner of an absolute encoder.

Textured IRIS3D objects
Textured objects now provide IRIS3D with extraordinarily realistic
rendering.

AUTOMGEN8

16

©opyright 1988-2007 IRAI

Environment

Drag and drop from IRIS3D to AUTOMGEN sheets
A right click on the IRIS3D objects allows you to access the list of
variables and “drag” a reference over to a programming sheet.

AUTOMSIM user-definable object
AUTOMSIM users will appreciate the new user-definable object, which
will allow you to create your own objects.
(see the section of this manual devoted to AUTOMSIM)

Drag and drop from AUTOMSIM to AUTOMGEN sheets
A click on the AUTOMSIM objects allows you to “drag” a reference over
to a programming sheet.

Improvements to the environment
Finally, numerous improvements to the environment, such as the
magnifying glass in the design palette, the simplified palettes in
“beginner” mode, or personalizing menus make AUTOMGEN even more
user-friendly.

AUTOMGEN8

17

©opyright 1988-2007 IRAI

Environment

Environment
Start
When AUTOMGEN is launched, a choice of mode for the environment is
proposed. “Beginner” modes make it possible to start using AUTOMGEN
in a “simplified” configuration, with a reduced number of options in the
menus and simplified palettes. This mode is especially suited to people
using AUTOMGEN for the first time. Expert mode offers all of the
applications. You could create your own models (see “project models”).

AUTOMGEN8

18

©opyright 1988-2007 IRAI

Environment

General views

Tool
bars

Workspace

Browser

Tabs
Message
window
AUTOMGEN’s main window in “Expert” mode

The environment is fully customizable. The tool bars can be moved (by
dragging their moving handle
“Tools/Customize the environment”).

)

and

parameterized

(menu

The state of the environment is saved when you quit it. This state can
also be saved in a project file (see the project options).

AUTOMGEN8

19

©opyright 1988-2007 IRAI

Environment

Tool
bars

Simplified
palettes

Workspace

AUTOMGEN’s main window in “Beginner” mode

AUTOMGEN8

20

©opyright 1988-2007 IRAI

Environment

Selecting targets in expert mode
At the bottom of the browser window there is a “Targets” tab, allowing
access to the list of post-processors installed.
The active target is indicated with a red tick. Access
to targets displayed in grey is not authorized for the
license installed (see the “Licenses” chapter for
more details). To change the current target, doubleclick on the corresponding line. The targets shown in
this list are the ones selected at installation time. If
the target you want to use is not shown in this list,
re-launch the AUTOMGEN installation and install it.

Selecting targets in beginner mode
In beginner mode, the following window is opened to allow the target to
be selected each time a program is run.

AUTOMGEN8

21

©opyright 1988-2007 IRAI

Environment

Palettes in expert mode
At the bottom of the browser window there is a “Palette” tab, allowing
access to program design elements.
The palette gives a set of elements that can be
selected and placed on the sheets. To select an
element, left-click with the mouse in the palette,
expand the selection, release the mouse button,
click in the area selected and move the area
towards the sheet.
The palette also contains the list of symbols for
the project. You can grab them and drag them
onto a test or an action on a sheet.
A magnifying glass is automatically shown when
the elements displayed are small.

Palettes in beginner mode
In beginner mode, the palette contains a reduced group of the simplest
tools for designing programs. Left-click with the mouse over a category
to “open up this category” like a tree structure.

The palette in “beginner” mode

“

” elements allow access to sub-elements.

AUTOMGEN8

22

©opyright 1988-2007 IRAI

Environment

The palette in “beginner” mode showing the “Grafcet” category open

The “

” element allows a category to be closed.

AUTOMGEN8

23

©opyright 1988-2007 IRAI

Environment

Displaying or hiding the project window or message window
Select the « Project » or « Messages » option from the « Window »
menu.

Displaying the work space in full screen mode
Select the « Full screen » option from the « Display » menu. Click on
to exit full screen mode.

Keyboard shortcuts
Keyboard shortcuts are written in the menus. « Masked » shortcuts can
also be used:
CTRL + ALT + F8
CTRL + ALT + F9
CTRL + ALT + F10
CTRL + ALT + F11

Save the project in executable
format
Save the project
Access project properties
Display or hide AUTOMGEN
window
Parameters can be set for the entire
environment, its state is saved when you
close AUTOMGEN. Environment windows
can be hidden. The « Windows » menu is
used to display them again. The work space
can be displayed in full screen mode. The
tabs at the bottom of the browser window are
used to access selection for the current postprocessor and the graphics palette.

AUTOMGEN8

24

©opyright 1988-2007 IRAI

Environment

Licenses
A license establishes AUTOMGEN user rights. The following elements
are established by license:
- the number of all or none inputs/outputs that can be used,
- post-processors that can be used,
- the number of users (only for network licenses).

Registering a license
When you install AUTOMGEN, you can use it for free for a period of 40
days.
You must register your license within 40 days.
To register your license, send IRAI:
- the serial number printed on the label glued to the software box, or
the reference of your delivery note or order form,
- the user code provided with the software indicating the PC where
you have installed the product.
You will then receive an enable code (also called validation code).
The « License » option in the AUTOMGEN « File » menu can be used to
display the status of your license and obtain a user code (click on
« Registering the license »).

License status.

AUTOMGEN8

25

©opyright 1988-2007 IRAI

Environment

A user code is valid for a period of 10 days.
So a maximum period of 10 days can pass from when you send a user
code to IRAI and when you receive an enable code provided by IRAI.

Sending a user code to IRAI
There are various methods you can use. Exchanging codes by e-mail is
highly recommended as it limits the risk of error.

A single error in the code will prevent the license from
being registered.

Sending a file by e-mail (the best solution)

License registration dialogue box

To generate a file containing your user code, click on « Save user code
in a file ». You can then transmit the file with « .a8u » extension as an
attachment and send it to the address contact@irai.com.

AUTOMGEN8

26

©opyright 1988-2007 IRAI

Environment

Copying the user code in an e-mail message
By clicking on « Copy user code to clipboard », you can then paste the
code in the body of the message and transmit it to the e-mail address
contact@irai.com.
By fax (not recommended)
By clicking on « Copy user code to clipboard », you can then paste the
code in a document and send it by fax to 00 33 4 66 54 91 33. If possible
avoid writing the code by hand and print it using a font which
differentiates between the letter « O » and the number zero.
By telephone (highly unadvisable)
By telephoning 00 33 4 66 54 91 30. Be sure to differentiate between the
letter « O » and number zero. Be careful of consonants which are difficult
to tell apart on the telephone (for example « S » and « F »).

Entering the validation/enable code
Validating by a e-mail received file
If you have received an « .a8v » file by e-mail, save the file on your hard
disk, click on « Read a validation code from a file » and select the file.
Validating for a code received in the text of an e-mail
Select the code in the message text (make sure you only select the code
and do not add any spaces to the end). Click on « Paste a validation
code from the clipboard ».
Validating for a code received by fax or telephone
Enter the code in the spaces under the title « Validation code ».

Modifying a license
Modification of a license Involves changing the elements authorized by
the license (for example adding a post-processor).
The license modification procedure is identical to registration.

AUTOMGEN8

27

©opyright 1988-2007 IRAI

Environment

Moving a license from one computer to another
This procedure is more complex. The instructions below must be
scrupulously followed to obtain good results. In the instructions below,
« source » PC indicates the computer with the license and the « target »
PC is the PC where the license needs to be moved.
1- if it has not already been done, install AUTOMGEN on the target
PC,
2- generate an « .a8u » user code file on the target PC and move this
file to the source PC (for example on a floppy disk),
3- on the source PC, select the « Move the license to another place »
option,

Dialogue box for moving a license

4- on the source PC, click on « Read a user code from a file » and
select the « .a8u » file that came from the target PC,
5- on the source PC, click on « Move the license »,
6- on the source PC, click on « Save the validation code in a file »,
recopy the generated « .a8v » file to the target PC,
7- on the target PC, click on « Read a validation code from a file »
and select the « .a8v » file that came from the source PC.

AUTOMGEN8

28

©opyright 1988-2007 IRAI

Environment

Network licenses
The « akey8.exe » executable manages the network license. This
executable must be launched from one of the network computers. The
network must be able to be used with TCP IP protocol. When launched,
icon appears in the
the network license manager is hidden and only a
WINDOWS keybar. To display the network license manager window,
double click on the
icon in the keybar.

The network license manager

Up to 16 different licenses can be managed by the network license
manager. A network license is characterized by a number of users and a
type of copyright (number of all or none inputs/outputs and useable postprocessors). For each license the number of possible user/s, number of
connected user/s and list of connected users (using AUTOMGEN) is

AUTOMGEN8

29

©opyright 1988-2007 IRAI

Environment

displayed in a tree format attached to each license. Each license is
associated to a port number (a numeric value starting from 5000 by
default). The first port number used can be configured by clicking on
« Parameters ».
Adding a network license
You can add a license by clicking on « Add a license ». The license
registration principle is the same as for single license versions.
Modifying a license
Double click on the licenses to modify them. The license modification
procedure is the identical to that used for single license versions.
Connecting to client stations
Click on « Connect to a network license » to connect a client station to a
network license.

Connecting to a network license

The PC name (the one from the network) where the « akey7.exe » was
launched must be provided as well as the port number corresponding to
the desired license.
You must register your license with IRAI
(contact@irai.com) by sending your user
code by e-mail (« File/License » menu. The
network license manager is used to manage
multiple licenses on TCP IP network PC's.

AUTOMGEN8

30

©opyright 1988-2007 IRAI

Environment

Additional information on installing AUTOMGEN in a network
environment
General information
Two aspects of the AUTOMGEN8 installation have to be considered:
installing files on the one hand and managing licenses on the other.
These two aspects are completely separate: you can choose to install
the files either on the hard disk of the client PCs or else on a file server
and, completely independently of this, choose to install either a license
locally on a PC or else a network license on a network license manager.

Installing AUTOMGEN8 on a file server
Benefit: the AUTOMGEN8 files are installed just once on a file server,
and updates are simplified.
Procedure on the file server: install AUTOMGEN8. Rights needed: readaccess is sufficient.
Procedure on the client workstations: create a shortcut to the
“autom8.exe” executable, which is in the AUTOMGEN8 installation
directory on the file server.

Installing one or more AUTOMGEN8 licenses on a network license
manager
Benefit: the licenses are no longer restricted to one PC but can be used
by all of the PCs connected to the network (floating licenses).
Principle: one or more licenses are installed on one of the network’s
PCs. A license authorizes from 1 to n users. AUTOMGEN8 may be
launched on client PCs upto the maximum number of users. A license
has the same features for all users in terms of the number of
inputs/outputs that can be used and the types of post-processors that
can be used. If several configurations (several types of licenses) are
AUTOMGEN8

31

©opyright 1988-2007 IRAI

Environment

needed, then as many licenses will be created as there are different
types of configurations. When AUTOMGEN8 is launched on the client
PCs, a connection will be created to one or other of the licenses
depending on the features that are wanted.
Actual example: setting up a network of 4 16 I+16 O PL72 licenses, 4 16
I+16 O PL7 licenses + 2 unlimited I/O PL7 licenses. For this: 3 licenses
will be created on the network license manager: 1 license for 4 16 I+16 O
PL72 users, 1 license for 4 16 I+16 O PL7 users, 1 license for 2 unlimited
I/O PL7 users.
Where to install the network license manager: on one of the network’s
PCs (it does not have to be the server) which must be running all the
time (whenever a user would like to use AUTOMGEN8).
Technical constraints: the network must support TCP/IP, the PC where
the network license manager is located must be able to run a WINDOWS
program (application or service).
Installation on the network license manager: on the PC where the
network licenses are going to be managed, install the main
AUTOMGEN8 module + the network license manager.
Registering one or more licenses on the network license manager:
launch the network license manager: (AKEY8.EXE executable, located in
the AUTOMGEN8 installation directory). When launched, the license
manager sets up an icon in the bottom right of the WINDOWS task bar.
Left-click once with the mouse to open the window.
Click on “Add a license” to add a license.
Click on “Save the user code in a file” to generate an .n8u file that you
will e-mail to us at the address “contact@irai.com”: we will send back an
.n8v file that you will connect up by clicking on the “Read a validation
code from a file” button.
The licenses installed in this way will then be shown in the network
license manager with the serial number and characteristics of the license
and the associated port number. It is this port number that will allow
clients to connect to a specific license.

AUTOMGEN8

32

©opyright 1988-2007 IRAI

Environment

Installation on the client workstations: launch AUTOMGEN8, and in the
“File / License” menu select “Connect to a network license”.
Enter the name of the PC where the network license manager is running
(or its IP address) and the port number (this number makes it possible to
identify the license you want to connect to, if there is more than one).
It is also possible to add an argument in the AUTOMGEN8 launch
shortcut in order to force connection to one network license.
The argument is:
/NETLICENSE=,
Make sure that “NETLICENSE” is correctly spelled: S not C at the end.
For example:
/NETLICENSE=MYSERVER,5001
Several launch shortcuts can be created in order to connect to different
licenses.
Possible problems: if you use a firewall, make sure access is authorized
to the ports used by the network license manager (those displayed in the
network license manager).
Installing the network license manager as a service under WINDOWS
NT, 2000, XP, 2003 and VISTA: see the following chapter.
Displaying the status of the licenses remotely: to display the status of the
network license manager on a different PC from the one on which the
network license manager has been launched (or if the “service” version
of the network license manager is being used), use the
“spya8protnet.exe” utility, which is located in the AUTOMGEN8
installation directory.
Installing the network license server as a service
The “NT Service” key server allows the AUTOMGEN8 network licenses
to be managed on a WINDOWS NT4, 2000, 2003, XP or VISTA
AUTOMGEN8

33

©opyright 1988-2007 IRAI

Environment

workstation without opening a session. Unlike the AKEY8.EXE
“executable” version, AKEY8NT.EXE does not allow either the
protections or the connected users to be displayed.
Before installing the key server as an “NT service”, you are
recommended to make sure that the key server works properly with the
“executable” version: AKEY8.EXE.
Launch the “akey8nt –i” command line to install the NT key server
service. The AKEY8NT.EXE executable is installed in the AUTOMGEN
installation directory.
So that the service starts automatically:
- under WINDOWS NT4: in the “Start/Parameters/Configuration
Panel” menu, select the “Services” icon the “AKEY8” line, click on
the start button and select the “Automatic” button.
Reboot your PC so that the key server is activated.
- under WINDOWS 2000, 2003, XP or VISTA: in the
“Start/Parameters/Configuration
Panel”
menu,
select
the
“Administrative Tools” icon then the “Services” icon. Right-click with
the mouse on the “AKEY8” line and select “properties”. In the
“Startup Type” option, select “Automatic”. In the “Recovery” tab,
select “Restart the service” in the “First Failure” area.

Uninstallation
Launch the “akey8nt –u” command to uninstall the NT key server
service.

Errors
After having uninstalled the AKEY8NT.EXE service, use AKEY8.EXE to
determine the cause of any malfunctions.

AUTOMGEN8

34

©opyright 1988-2007 IRAI

Environment

The project
AUTOMGEN8 is strongly based on the idea of a project. A project groups
together the elements that compose an application. The browser (see
page Erreur ! Signet non défini.) displays all the project elements
(sheets, symbols, configuration, IRIS objects etc.) in a tree format.
The new file format of AUTOMGEN8 (files with « .AGN » extension)
includes all project elements.
When you save an « .AGN » file you are assured of saving all the
elements of an application. You can easily and effectively interchange
applications created with AUTOMGEN.
« .AGN » files are compacted with « ZIP » technology, they do not need
to be compressed to be interchanged, their size is already optimized.
All the files generated by AUTOMGEN8 can be re-read with all of the
versions of AUTOMGEN8: upward and downward compatibility.

Files generated with AUTOMGEN7
The files created with AUTOMGEN7 can be opened directly in
AUTOMGEN8.

Importing an application from an earlier version of AUTOMGEN
(version 6 or earlier)
You need to import all of the sheets (“.GR7” files) and any symbol file
(“.SYM” file). To do this, use the import procedures described in the
following chapters.

Generating a free distribution executable file
The « Generate an executable » command from the « File » menu
is used to generate an executable starting from a project in
progress (an « .EXE » file executable on a PC with WINDOWS).
The AUTOMGEN « viewer » is automatically integrated with the
generated executable (the executable user does not need
AUTOMGEN).
This viewer makes it possible to use the
application without modifying it. You can easily distribute your
AUTOMGEN8

35

©opyright 1988-2007 IRAI

Environment

applications. The generated executable is not covered by
copyright. This technique is normally used for producing a
supervising application.

Modifying project properties
With the right side of the mouse click on the « Project» element on the
browser and select « Properties » from the menu.
Modifying security options
You can restrict reading or modification access to a project by
passwords.
Advanced options
« Save the environment aspect with the project »: if checked, the position
of the windows and the aspect of the toolbars are saved in the « .AGN »
file. When the project is opened, these elements are reproduced.
« Hide the main window upon launching … »: if checked, the
AUTOMGEN window is hidden when the project is opened. Only IRIS
objects incorporated in the project will be displayed. This option is
normally used to create « package » applications which only leave IRIS
objects displayed. Use the [CTRL] + [F11] keys to redisplay the
AUTOMGEN window.
The other options are used to change the display of the AUTOMGEN
window when a project is opened.
User interface
« Block IRIS object configuration »: if checked, a user cannot modify
IRIS object configuration.
The other options are used to modify the behavior of the user interface.
Model
« This project is a document model »: if checked, when opened all the
options and the documents it contains act as a model for the creation of
a new project. This functionality is used to create standard configuration
which can be uploaded when AUTOMGEN is launched (for example a
default symbol file or a default processor configuration).
Defining a mode
To define a mode that can be used when launching AUTOMGEN (like
the “Expert” and “Beginner” modes), save a project model in the
AUTOMGEN8

36

©opyright 1988-2007 IRAI

Environment

“models” sub-directory of the AUTOMGEN installation directory. An
image can be linked to a model. To do this, create a “jpg” format file with
the same name as the “.agn” file. This file must have the following
dimensions: 120 pixels wide by 90 pixels high.
Automatic GO
«Automatic go at project launch »: if checked, the application is
automatically run when a project is opened.
The project is used to group together the
elements of an AUTOMGEN application.
Once regrouped, the elements form a
compact file with « .AGN » extension. The
project models are used to be able to easily
manage different software configurations.
Generation of executables makes it easy to
distribute applications.

AUTOMGEN8

37

©opyright 1988-2007 IRAI

Environment

The Browser
A central element for application
management, the browser is used for
fast access to different application
elements:
sheets,
symbols,
configuration, printing, IRIS objects etc.
The « + » and « - » icons are used to
develop or retract project elements.
Actions on the browser are effected by
double clicking on the elements (opens
the element) or by clicking with the right
side of the mouse (adds a new element
to a project, special action on an
element etc.).
Certain operations are effected by
dragging and dropping the elements and
moving them on the browser.
The colors (generally called up at the
bottom of documents in the work space)
are used to identify families of elements.

Browser tree

AUTOMGEN8

38

©opyright 1988-2007 IRAI

Environment

Sheets
A sheet is a page where a program or part of a program is designed.
Using sheets is extremely simplified in AUTOMGEN8. The sheet
chaining orders needed in the previous versions are no longer used. For
multiple sheets to be compiled together, they only need to be in the
project.
The icons associated to the sheets are shown below:
normal sheet,
normal sheet (excluding compilation),
sheet containing a macro-step expansion,
sheet containing a function block program,
sheet containing a key,
sheet containing a key (excluding compilation).
sheet containing an encapsulation,
Icons are marked with a cross indicating a closed sheet (not displayed in
the work space). Double clicking on this type of icon opens (displays) the
associated sheet.
Adding a new sheet
With the right side of the mouse click on the « Sheets » element on the
browser then select « Add a new sheet ».
Select the sheet size (XXL is the
recommended format, the other
formats are for older versions of
AUTOMGEN, GEMMA is only
used for creating GEMMA
models).
The sheet can be given any
name, but each project sheet
must have its own name.
The comment area is up to your
discretion for modifications or
other information relative to each
sheet.

AUTOMGEN8

39

©opyright 1988-2007 IRAI

Environment

Importing old AUTOMGEN version sheets, importing CADEPA sheets
With the right side of the mouse click on the « Sheets » element on the
browser then select « Add one or more existing sheets ».

Selecting one or more sheets to import.

From the « Type » list select « AUTOMGEN » or « CADEPA » for the
sheet type to import then click on OK.
There are some restrictions for importing
CADEPA sheets:
- the step numbers must be individual (the
same step number cannot be used on
multiple sheets),
- references must be converted with links to
CADEPA before being able to import
them.
By keeping the [CTRL] key pressed down, you can select multiple
sheets.
Modifying the sheet compilation order
The sheets are compiled in the order they are listed in for the project. To
modify this order, click on the sheet with the left side of the mouse on the
browser and move it in the list.

AUTOMGEN8

40

©opyright 1988-2007 IRAI

Environment

Deleting a sheet from the list
With the right side of the mouse click the sheet to be deleted on the
browser and select « Delete » from the menu.
Exporting a sheet to a « .GR7 » file
With the right side of the mouse click the sheet to be deleted on the
browser and select « Export » from the menu.
Copying, Cutting, Pasting a sheet
With the right side of the mouse click the sheet on the browser and
select « Copy/cut » from the menu. To paste, with the right side of the
mouse click on the « Sheet » element on the browser and select
« Paste ».
This option makes it possible to copy or transfer sheets from one project
to another.
Renaming a sheet
See « Modifying properties » below.
Modifying sheet properties.
With the right side of the mouse click the sheet on the browser and
select « Properties » from the menu.

AUTOMGEN8

41

©opyright 1988-2007 IRAI

Environment

You can modify the
sheet name, the syntax
used
for
literal
language and variable
names. The « Do not
compile this sheet »
option is used to
exclude the sheet from
the compilation. The
« Display in GEMMA
format» option is only
available if the sheet
format is GEMMA and
is used to display and
modify a sheet in
GEMMA format. The
« Block the of use
inputs/outputs
other
than set symbols »
option blocks the use of
i, %i, o %q variables
not
attributed
to
symbols. Access to the
sheet can be protected
by a password. -The
« comments » area is
left to your discretion.

Symbols
The list of symbols provides the correspondence between « symbol »
names and variable names. A project may only have one symbol table.
Creating a symbol table
With the right side of the mouse click on the « Symbols» element on the
browser and select « Create a symbol table » from the menu.
Importing a symbol table
With the right side of the mouse click on the « Symbols» element on the
browser and select « Import a symbol table » from the menu.

AUTOMGEN8

42

©opyright 1988-2007 IRAI

Environment

Configuration
Post-processors
This section contains all the post-processor configuration elements (see
the post-processor manual for more information).
Compiler options
Double click on this element to modify the settings of compiler options.

Documentation
This is used to access the file printing function (double click on the
« Print » element. You can print a complete file composed of an end
paper, cross reference table, symbol list and sheets. The print setup
function is used to display all these elements.

AUTOMGEN8

43

©opyright 1988-2007 IRAI

Environment

Generated files
Generating the instruction list in pivot code
By double clicking on « Pivot code » you generate a list in low level literal
language (AUTOMGEN pivot code). Viewing of the generated code is
normally reserved for specialists involved in understanding the
translation methods used by the compiler.
Generating the cross reference list
Double clicking on the « Cross reference » element generates and
displays the list of variables used in an application with any associated
processor variables and the name of or sheet(s) where they are used.
Post-processors
The other elements concern the files generated by the post-processors:
instruction lists are in processor language.

Settings
Contains the tools to display and modify the state of the variables.
Viewing and modifying a variable or variable table
With the right side of the mouse click on « Settings » and select
« Monitoring » to open an element where you can see the state of a
variable or variable table.
Next variable

Previous
variable

Modify the state
of another
variable

A monitoring window.

AUTOMGEN8

Close

Select a
variable

44

Open the
menu

©opyright 1988-2007 IRAI

Environment

Modify the
variable state by
clicking in this
area

The monitoring window in « 10 variables table » mode.

Click on this button to display
the expanded information
(automaton symbols and
names of variables)
associated with each variable

The monitoring window in “Variables Table” mode

Re-size the window by
dragging one of the
edges in order to see
more or fewer variables

Click on these buttons
to change the size of
the information
displayed in the table
AUTOMGEN8

45

©opyright 1988-2007 IRAI

Environment

IRIS objects
IRIS 2D objects are used to create consoles, supervision applications
and simulation applications of 2D operating parts. IRIS 3D is used to
create simulation applications of 3D operating parts. Each IRIS 2D object
appears in the project tree (see the chapters IRIS 2D references and
IRIS 3D references for additional information).
Adding an IRIS 2D object
Click with the right side of the mouse on « Add an IRIS 2D object ». The
object selection assistant is used to select it and set its parameters.

Selection assistant for an IRIS 2D object
AUTOMGEN8

46

©opyright 1988-2007 IRAI

Environment

Deleting an IRIS 2D object
With the right side of the mouse click on the IRIS object on the browser
and select « Delete » from the menu.
Displaying or hiding an IRIS 2D object
With the right side of the mouse click on the IRIS object on the browser
and select « Display/hide » from the menu.
Cutting, copying, pasting an IRIS 2D object
With the right side of the mouse click on the IRIS object on the browser
and select « Copy » or « Cut » from the menu.
To paste, with the right side of the mouse click on the « Sheet » element
on the browser and select « Paste ».
To paste an IRIS object on a console, select « Paste» from the console
menu or click with the right side of the mouse on the console on the
browser and select « Paste».
Adding a new IRIS 2D object on a console
Select « Add an object » from the console menu or click with the right
side of the mouse on the console on the browser and select « Add an
object on the console » from the menu (for more information on the
console see the chapter « Console » object)
Modifying the properties of an IRIS 2D object
With the right side of the mouse click on the IRIS object on the browser
and select « Properties ». For higher level objects (parent objects),
special properties can be accessed:

AUTOMGEN8

47

©opyright 1988-2007 IRAI

Environment

Properties of high level objects

Display establishes under which conditions the object is displayed or
hidden. The reinstallation option is used to return an object to its initial
state when dynamic display is launched (normally used for OP simulation
applications).
Setting an object model accessible on the assistant
With the right side of the mouse click on the IRIS object on the browser
and select « Save as model » from the menu.

AUTOMGEN8

48

©opyright 1988-2007 IRAI

Environment

Selection of modifiable parameters for users of your models

You can select the list of parameters which remain accessible to the user
on the assistant. By clicking on « Save », you save your object model.
The storage directory for object models is « \i2d\lib ». You can use a sub-directory called « my objects » for
saving your models.
Importing an IRIS 2D object in an earlier version of AUTOMGEN
With the right side of the mouse click on the « IRIS» element on the
browser and select « Import IRIS 2D objects ». Select one or more
« .AOF » files.

Creating an IRIS 3D console
With the right side of the mouse click on the « IRIS » element on the
browser and select « Add an IRIS 3D console » (see the chapter on IRIS
3D for more information).

AUTOMGEN8

49

©opyright 1988-2007 IRAI

Environment

Resources
This project element is used for adding all types of files to a project. Files
which are added will become an integral part of the project and will be
saved along with the other elements. To refer to a pseudo directory
where the resources are, the key word «  » can be used in the
specific directory name in AUTOMGEN. For example IRIS objects can
refer to bitmaps if they are included in the resources.
Adding a file to the resources
With the right side of the mouse click on the « Resources» element on
the browser and select « Add » from the menu.
Deleting a file from the resources
With the right side of the mouse click the resource file on the browser
and select « Delete ».
Renaming a file in the resources
With the right side of the mouse click the resource file on the browser
and select « Rename ».
Modifying a file in the resources
With the right side of the mouse click the resource file on the browser
and select « Modify ».
Adding and converting 3D STUDIO files in the resources
3D STUDIO files can be converted into .x files and added to the
resources by clicking with the right side of the mouse on the
« Resources » element on the browser and selecting « Import 3D files »
(see the chapter IRIS 2D references and IRIS 3D references for more
information).

External modules
These elements are reserved for executable modules developed by third
parties and interfaced with AUTOMGEN.

AUTOMGEN8

50

©opyright 1988-2007 IRAI

Environment

The browser is used to display and manage
all the project elements. By double clicking
on the elements or by clicking with the right
side of the mouse, you access the different
functions applicable to each element.

AUTOMGEN8

51

©opyright 1988-2007 IRAI

Environment

Designing programs
Various tools are available for designing programs.

Designing with the assistant
This is without doubt the simplest when starting with AUTOMGEN. With
the right side of the mouse click on an open sheet in the work space and
select « Assistant » from the menu. You will then be guided for making
selections. When you have finished click on « OK » and put the design
on the sheet by clicking with the left side of the mouse.

The assistant

AUTOMGEN8

52

©opyright 1988-2007 IRAI

Environment

Designing with the shortcut menu
Click with the right side of the mouse on an open sheet in the work
space, the menu will propose a series of elements that you can put on
the sheet. This is an instinctive and fast creation method.

Designing with the pallet
By selecting elements on the pallet you can quickly create programs
starting from previously created elements.
Enhancing and customizing the pallet
« .GR7 » files are used to set the pallet, they are located in the directory
« \pal ». You can delete, modify,
rename or add files. To generate « .GR7 », files use the « Export »
command by clicking with the right side of the mouse on a sheet on the
browser. The names displayed on the pallet are « .GR7 » files. Relaunch
AUTOMGEN for a new element to be displayed on the pallet.

Designing with the keyboard keys
Each key is associated to design blocks. The « Blocks » element also
provides access to the blocks. The table below lists the blocks and their
use.
Delete block
Aspect

Associated key

Generic name

Comments

Languages

[A]

Delete

Used to make a cell blank
again

All

Link blocks
Aspect Associated key

AUTOMGEN8

Generic name

Comments

Languages

[E]

Vertical link

Link from top to bottom
or bottom to top

All

[F]

Horizontal link

Link from right to left or
left to right

All

53

©opyright 1988-2007 IRAI

Environment

[G]

Upper left corner

Link towards the bottom
right or bottom left

All

[H]

Upper right corner

Link towards the bottom
left or bottom right

All

[I]

Lower left corner

Link from top to right or
left to top

All

[J]

Lower right corner

Link from top to left or
right to top

All

[Z]

Cross

Crosses two links

All

Generic name

Comments

Languages

[B]

Step

Normal step

Grafcet

[C]

Initial step without
activation

Initial step without
activation

Grafcet

[D]

Initial step

Initial step

Grafcet

Macro-step

Only available in the
shortcut menu

Grafcet

Encapsulating step

An encapsulation must
be linked

Grafcet

Initial encapsulating step An encapsulation must
be linked

Grafcet

Initial state mark

Défine intial state for an
encapsulation

Grafcet

[T]

Transition

Transition

Grafcet

[$]

Source transition

Can replace the
transition symbol

Grafcet

[£]

Exit transition

Can replace the
transition symbol

Grafcet

Grafcet blocks
Aspect Associated key

[+]
.

[-]
.

.

.

AUTOMGEN8

54

©opyright 1988-2007 IRAI

Environment

Link for action on
transition crossing

Use the following
element to design the
action rectangle

Grafcet

Start of an action
rectangle on transition
crossing

Use the [X] and [Y]
elements to end the
rectangle

Grafcet

[K]

Left limit of an « And »
divergence

Compulsory to the left
of an « And »
divergences

Grafcet

[L]

Supplementary branch
of an « And »
divergence or an
« And » convergence

Do not use as a left or
right limit of an « And »
divergence

Grafcet

[M]

Right limit of an
« And » divergence

Compulsory to the right
of an « And »
divergence

Grafcet

[N]

Extension of an « And » If placed in the [K], [L],
[M], [P] or [O],[P],[Q],
divergence
[L] blocks

Grafcet

[O]

Left limit of an « And »
convergence

Compulsory to the left
of an « And »
convergence

Grafcet

[P]

Supplementary branch
of an « And »
convergence or an
« And » divergence

Do not use as a left or
right limit of an « And »
convergence

Grafcet

[Q]

Right limit of an
« And » convergence

Compulsory to the right
of an « And »
convergence

Grafcet

[R]

« Or » divergence

Do not use as a limit of
an « Or » convergence

Grafcet

[S]

« Or » convergence

Do not use as a limit of
an « Or » divergence

Grafcet

[U]

Skip or repeat left step

« Or » convergence or
divergence

Grafcet

[V]

Skip or repeat right step

« Or » convergence or

Grafcet

.

.

AUTOMGEN8

55

©opyright 1988-2007 IRAI

Environment
divergence
[SPACE] on an
[E] block

Link towards the top

For relooping and
repeating steps

Grafcet

Flowchart blocks
Aspect

Associated
key

Generic name

Comments

Languages

[0] (zero)

Flowchart assignment

Separates the « test »
from the « action »
area

Flowchart

[1]

« Not » function

Complements the
block input signal

Flowchart

[2]

« And » function

Combines the inputs in
an « And » logic

Flowchart

[3]

« Or » function

Combines the inputs in
an « Or » logic

Flowchart

[4]

Block environment

Enlarges an « And » or
« Or » function block

Flowchart

[5]

Bottom of block

Ends an « And » or
« Or » function block

Flowchart

Ladder blocks
Aspect

Associated key

Generic name

Comments

Languages

[(]

Start left coil

Starts an action

Ladder

[)]

Start right coil

Ends an action

Ladder

[U]

Left limit

Ends the diagram

Ladder

[V]

Right limit

Starts the diagram

Ladder

[R]

Connection

« Or » function

Ladder

[S]

Connection

« Or » function

Ladder

AUTOMGEN8

56

©opyright 1988-2007 IRAI

Environment

Action blocks
Aspect

Associated
key

Generic name

Comments

Languages

[W]

Action rectangle left
limit

Starts an action

Grafcet and Flowchart

[X]

Action rectangle
environment

Extends an action

Grafcet and Flowchart

[Y]

Action rectangle
right limit

Ends an action

Grafcet and Flowchart

[.]

Left side of a
double action
rectangle

[/]

Middle of a double
action rectangle

Prolongs a double
action rectangle

Grafcet and Flowchart

[%]

Right side of a
double action
rectangle

Ends a double action
rectangle

Grafcet and Flowchart

[S]

Divergence Action

Used to vertically
juxtapose action
rectangles

Grafcet and Flowchart

[V]

Divergence Action

Used to vertically
juxtapose action
rectangles

Grafcet and Flowchart

[#]

Action on
activation

Defines the type of
action

Grafcet

[_]

Action on
deactivation

Defines the type of
action

Grafcet

[@]

Event-driven
action

Defines the type of
action

Grafcet

.

.

.

.

.

AUTOMGEN8

Starts a double action Grafcet and Flowchart
rectangle

57

©opyright 1988-2007 IRAI

Environment

Test blocks
Aspect

Associated
key

Generic name

Comments

Languages

[7]

Left limit of a test

Starts a test

Flowchart and ladder

[6]

Right limit of a test

Ends a test

Flowchart and ladder

Organization chart blocks
Aspect

Associated
key

Generic name

Comments

Languages

[<]

Organization chart
input

Indicates the input in a
rectangle

Organization
chart

[=]

« False » output

Output if a test
rectangle is false

Organization
chart

Associated
key

Generic name

Comments

Languages

[8]

Upper left corner of a
function block

Starts the name of the
function block

Function block

[9]

Upper right corner of a Ends the name of the
function block
function block

Function block

[:]

Lower left corner of a
function block

Adds an input to the
function block

Function block

[;]

Left limit of a function
block

Adds an input to the
function block

Function block

[>]

Right limit of a
function block

Adds an output to the
function block

Function block

Lower right corner of a Adds an output to the
function block
function block

Function block

Function block blocks
Aspect

[?]

AUTOMGEN8

58

©opyright 1988-2007 IRAI

Environment

Other blocks
Aspect

Associated
key

Generic name

Comments

Languages

[*]

Combination /
transition link

This block is a link
between the Logical
Diagrams or Ladder
languages and the
Grafcet language

Grafcet /
Flowchart /
Ladder

.

Documenting program elements
To document program elements, click below with the left side of the
mouse. To create comments, click on a blank space on the sheet. To
validate modifications, push the [Enter] key or click outside the editing
are with the left side of the mouse. To delete modifications, push the
[Esc] key or click outside the editing area with the right side of the
mouse.
When editing tests and actions, a « … » button appears under the editing
area. If you click on it you access an assistant for creating tests or
actions.

AUTOMGEN8

59

©opyright 1988-2007 IRAI

Environment

Test creation assistant

Adding symbols
To create a symbol, click with the right side of the mouse on the symbol
button on the
table in the work space and select « Add ». Or click the
toolbar. You can also launch program compiling containing unset
symbols. You will be asked for variables corresponding to the symbols
during the compilation.

AUTOMGEN8

60

©opyright 1988-2007 IRAI

Environment

Attribution of symbols during compilation

To easily design a program, create a new
sheet, then click with the right side of the
mouse on the bottom of the sheet. Select
« Assistant » from the menu, you will then
be guided by it.

AUTOMGEN8

61

©opyright 1988-2007 IRAI

Environment

Running an application
To run an application easily
button on the toolbar is the quickest way to see application run
The
results. This pushbutton activates the following mechanisms:
- compilation of the application if it is not updated (not already
compiled after the last modifications),
- installation of the run module (with downloading if the current target
is a processor and following the connection options),
- passage of the target to RUN,
- activation of the dynamic display.
To end the run
Click on
. On the processor target, the program continues to be run
on the target. On the PC, the program is stopped.
To compile only
Click on

.

To stop the compilation
Click on

.

To connect to a processor or install a PC
.
Click on
To disconnect a processor or uninstall a PC
Click on

.

To put the target in RUN mode
Click on

.

To put the target in STOP mode
Click on

.

To initialize the target
Click on

AUTOMGEN8

.

62

©opyright 1988-2007 IRAI

Environment

To run a program cycle on the target (generally not supported on
processors)
.

Click on

To activate the dynamic display
Click on

.

To run an application, click on the « GO »
button. To end the run, click again on the
same button.

AUTOMGEN8

63

©opyright 1988-2007 IRAI

Environment

The compiler
The compiler translates the sheets into a set of pivot language equations
(these can be displayed by double clicking on the « Generated code /
pivot language » element on the browser).
The pivot language is then translated into a language which can be run
by a post-processor (the current post-processor can be displayed and
selected by double clicking on the « Targets » panel accessible by
clicking on the « Targets » tab at the lower part of the window where the
browser is.

Modifying compiler options
Double click on the element « Configuration / Compiler options».

Displaying compilation messages
The « Compilation » panel on the messages window contains the counts
produced by the last compilation.

Finding an error
By double clicking on error messages, you can find the source.

An error message and its source

AUTOMGEN8

64

©opyright 1988-2007 IRAI

Environment

If the message windows are hidden and if one or more errors are
detected by the compiler, a dialogue box indicates the first error detected
(to display the message windows: use the « Messages » command from
the « Windows » menu).

At the end of the compilation the
« Compilation » window provides a list of
any errors. By double clicking on the error
messages, the site in the program that
caused the error is displayed.

AUTOMGEN8

65

©opyright 1988-2007 IRAI

Environment

Running programs on a PC
The « run PC» target is an actual processor loaded in your PC.
You can:
- test your applications,
- drive a virtual operating part created with IRIS 2D or 3D,
- drive input/output cards connected to the PC.

Configuring the number of variables
Double click on the « Configuration / Post-processors / Executor PC /
Variables » element.

Selecting the number of variables

The space needed for the variables used in the application is
automatically reserved by default. You can manually select the amount
of memory to reserve for each type of variable. This may be necessary if
an indexed addressing is used to access a variable table.

AUTOMGEN8

66

©opyright 1988-2007 IRAI

Environment

PC system variables
Bits 0 to 99 and words 0 to 199 are system variables and can not be
used as user variables in your applications. The two tables below provide
details on the PC system variables.
Bits
0
1 to 4
5 to 7
8
9 and
10
11
12
13 to
29
30
31
32
33
34
35
36
37
38 to
55
56
57 to
67
68 to
99

Use
active at first cycle, activation of initial Grafcet steps
reserved for I/O drivers
reserved for I/O driver errors
error on watchdog overflow is equal to 1
error general PC fault
run mode 1=RUN, 0=STOP
emergency stop pass to 1 in the event of an error or set to 1 to stop the program
reserved for drivers
bit associated to timer 1
bit associated to timer 2
bit associated to timer 3
bit associated to timer 4
bit associated to timer 5
bit for repeating sector (pass to 1 on repeat sector, reset to zero is the job of the
programmer)
setting this bit to 1 causes reading of the clock in real time and transfer to System
words 4, 5, 6, 7, 8, 51 and 52.
setting this bit to 1 causes writing of System words 4, 5, 6, 7, 8, 51 and 52 in the
real time clock.
reserved
division by zero
reserved for future versions
reserved for the stack of boolean processing

Words Use
reserved for the upper part of the multiplication result or the remainder of the
0
division
1 to 3 timers in milliseconds
timer in 1/10 second
4
timer in seconds
5
timer in minutes
6
timer in hours
7
timer in days
8
9 to 29 reserved for I/O drivers
timer 1 counter
30

AUTOMGEN8

67

©opyright 1988-2007 IRAI

Environment
31
32
33
34
35
36
37
38
39
40
41
42 to
50
51
52

timer 2 counter
timer 3 counter
timer 4 counter
timer 5 counter
timer 1 procedure
timer 2 procedure
timer 3 procedure
timer 4 procedure
timer 5 procedure
lower part of clock reference
upper part of clock reference
reserved for I/O drivers
timer in months
timer in years

Modifying the run period
Double click on « Post-processors / Executor PC / Run ».

Setting the run period

Driving inputs/outputs
Double click on « Configuration / Post-processor / Executor PC / I/O
Drivers ».

AUTOMGEN8

68

©opyright 1988-2007 IRAI

Environment

Adding an I/O driver

Select a driver from the list on the right and then click on « Add ».
« Set parameters » is used to configure certain drivers.

The executor PC transforms your PC into a
program processor, it can be used to drive
inputs/outputs directly connected to your
computer.

AUTOMGEN8

69

©opyright 1988-2007 IRAI

Environment

IRIS 2D references
IRIS 2D objects are used to create supervision and simulation
applications of 2D operating parts.
The link between the objects and the automatically functioning
applications is always created by interchanging the variable state.
IRIS 2D objects are contained in WINDOWS windows.

An IRIS 2D object

IRIS 2D objects have two possible states: the « Configuration » mode
(used to modify the object characteristics) and « Use » mode (for using
an object). The « User » mode is also called « Employ » mode.

Modifying object display
The objects can be hidden or displayed. This property can be specified
when opening an object or when changing the state of the dynamic
display in the environment. Only higher level objects (not objects located
on a console) can be displayed or hidden. Objects located on a console
are displayed or hidden at the same time as the console.
To dynamically modify the visibility of objects, click with the left side of
the mouse on the objects on the browser and select « Display/Hide ».
To modify the display properties, click with the left side of the mouse on
the objects on the browser and select « Properties ».

AUTOMGEN8

70

©opyright 1988-2007 IRAI

Environment

Display properties of an object.

Modifying object characteristics
Removing an object
Method 1: click the
button on the surface of the object.
Method 2: with the right side of the mouse click on the object on the
browser and select « Delete » from the menu.
Dimensioning an object
By dragging the object from one of its edges you can enlarge or shrink it
(you can also precisely modify the size of an object by accessing its
properties, see below).
Moving an object
Drag the object by clicking with the left side of the mouse on the minibar
located on the upper part of its surface.
Putting an object in « User » mode
Method 1: click on the button
on the object with the left side of the
mouse.
Method 2: click with the right side of the mouse on the object.
Putting an object in « Configuration » mode
Click with the right side of the mouse on the object.
Modifying the characteristics of an object
Method 1: click on the button.
Method 2: push down the [CTRL] key on the keyboard and click with the
right side of the mouse on the object, then release the [CTRL] key.

AUTOMGEN8

71

©opyright 1988-2007 IRAI

Environment

Method 3: with the right side of the mouse click on the object on the
browser and select « Properties » from the menu.

Block access to configuration for all objects
With the right side of the mouse click on « Project » on the browser,
select « Properties » and check « Block IRIS 2D object configuration »
on the « Advanced » tab.

Basic objects, preset objects
The basic objects set major functionality types. Preset objects are based
on a basic type and a configuration to meet a specific need. For an
example, an emergency pushbutton is an object derived from a basic
object used to create pushbuttons and lights. To access preset objects,
use the assistant by clicking with the right side of the mouse on the
« IRIS » element on the browser and select « Adding an IRIS 2D
object ».

List of basic objects
« Console » object
The console object is the only object which can contain other objects on
its surface. It is used to create command consoles and animation
used
surfaces for virtual operating parts. This object has a pushbutton
to manage objects on its surface: add, move, delete etc.
The « Button and light » object
This is used to create pushbuttons and
processing application variables.

lights that interact with the

The« Object » object
This is a polymorphic element primarily used to simulate operating parts.
The « Digital value » object
This is used to display numeric values of the processing application in a
number format.
The « Screen, keyboard, message list » object
This is used to display information on the processing application in a text
format.

AUTOMGEN8

72

©opyright 1988-2007 IRAI

Environment

The « Sound » object
This is used to produce output sounds when the variable state of the
processing application changes.
The « Data archive » object
This is used to display processing application data in a table or chart
format and save them in the computer memory or on the disk.
The « Program » object
This is used for processing run separately from the processing
application.
The « Dialogue box » object
This is used to display messages in a pop-up window format regarding
changes in the variable state of the processing application.
The « Analog value » object
This is used to display processing application numeric variables in an
analog numeric format (bars, dials etc.).

Practical experience
In this chapter you will be able to quickly create your first IRIS 2D
application. We are going to create a console, put a pushbutton on it and
link the object variables to the processing application.
Step 1
Creating a minimal application with AUTOMGEN see chapter Designing
programs.

This is a Grafcet with one step as shown below.
0

AUTOMGEN8

73

©opyright 1988-2007 IRAI

Environment

Step 2
Launch the run of the AUTOMGEN application (click on the « Go »
button on the toolbar).
Step 3
With the right side of the mouse click on the « IRIS » element on the
browser and then select « Add an IRIS 2D object » from the menu. In the
« Basic objects » category, double click on « Console ».
At this point the object will appear on the screen in this format:

Step 4
(menu
To add a pushbutton to the console click on the console icon
access) and select the « Add an object » option. In the « Basic objects »
category, double click on « illuminated button ».
The object will then appear on the console:

Step 5
Now we are going to associate the pushbutton to a processing
(not
application output, for example %Q4. Click the pushbutton icon
the console icon). The pushbutton properties dialogue box will open:

AUTOMGEN8

74

©opyright 1988-2007 IRAI

Environment

Click the « Links » tab (upper part of the dialogue window). In the
« Action when button is pressed » section enter « %Q4=1 ». In the
« Action when button is released » section enter « %Q4=0 ». Then click
on « OK » on the pushbutton on the lower part of the dialogue window.
Actions on the pushbutton will drive processing application output 4. You
can open a « Monitoring » window from the « Set-up » menu by clicking
with the right side of the mouse on the browser. You display the state of
output 4 when you click then release the pushbutton.
Step 6
We are going to associate a light to the « Illuminated Button » object, this
light will be associated to a processing application input (for example 12).
Click the pushbutton icon
again. In the « Aspect » tab click on the
« Pushbutton and light » radio button. Click on the « Links » tab and
enter « %i2 » in the « Light state » section. Click on the « OK »
pushbutton in the lower part of the property dialogue window. You can
keep the state of variable « %i2 » modified (with a « Monitoring » window
or by modifying the state of the physical input, if it exists).

AUTOMGEN8

75

©opyright 1988-2007 IRAI

Environment

Step 7
We are going to duplicate the « Illuminated Button » on the console in
order to obtain a second pushbutton whose properties we will modify.
Click on the pushbutton with the left side of the mouse while pressing
down the [SHIFT] key. Black squares will appear around the selected
and select the « Copy » option.

object. Click on the console icon

Click on the console icon
and select the « Paste » option. Now there
are two overlapping « Illuminated Button» objects. Drag the upper one (it
is the only accessible one) by its upper bar and move it away from the
other pushbutton. The object which has been duplicated has the same
properties as the first. Now you can set the parameters for the second
object, for example, so it is linked to output 5 and input 3.
You can also customize the aspect of the pushbuttons by using the
aspect tab for the two objects. You can modify the size of the objects by
dragging their edges.
The three objects on the screen (console and two pushbuttons) are in
« Configuration » mode, this means that they have a mini bar on the
upper part of their surface, icons and edges for modifying their
dimensions. The objects have another mode called « Employ », in this
mode their aspect is permanent: the upper bar, icon and edges for
modifying the dimensions no longer exist. To tilt an object, click on it with
the right side of the mouse.
At this point you will have created an object that looks like this:

AUTOMGEN8

76

©opyright 1988-2007 IRAI

Environment

Creating an autonomous supervision application
To create an autonomous supervision application (without developing a
processing application with AUTOMGEN) follow the procedure below:
- create correspondences for the AUTOMGEN variables and the
processor variables by double clicking on the « Configuration /
Post-processor
/

/
Variable
correspondence » element (see the post-processor manual for
more information).
- compile the application by clicking on the
button on the toolbar
(this validates the variable correspondence).
- configure the connection mode on « Only connect » by double
clicking on « Configuration / Post-processor /  / Connection option ».
Comments:
- the « Automatic go » project option is used to obtain an application
which automatically connects to the target to be started.
- the « Generate an executable » on the « File » menu is used to
obtain an autonomous supervision application which is zipped and
not covered by copyright in the format of a single executable file.

Syntax for accessing the state of variables
You can use variable names in AUTOMGEN , IEC 1131-3 or a symbol
syntax. The « … » pushbuttons located near the drag areas in the object
are used to access the assistant for selecting a variable name.
Boolean state
This syntax is used in the object « states » section.
To test the state of a boolean variable, use the variable name, for
example: « i0 », « %q0 », « gate open ».
To test the complement state of a boolean variable, add a character « / »
in front of the variable name, for example: « /i4 », « /%M100 », « /high
level ».
To test the equality of a numeric variable with a constant, use the name
of the numeric variable followed by « = », « < », « > » and a constant, for
example: « %MW200=4 », « speed>2 ».

AUTOMGEN8

77

©opyright 1988-2007 IRAI

Environment

The complement state is used for creating « if different », « if less than or
equal to» and « if greater than or equal to » tests, for example:
« /%MW201<300 ».
The operator '&' is used to test a bit of a numeric variable, for example
M200&4 tests the third bit (4 = 2 power 3) of word m200.
Numeric state
This syntax is used in the object « states » section.
To read the state of a numeric variable, use the variable name, for
example: « %MW300 », « m400 », « pressure », « _+V_ ».
Modifying the state
This syntax is used in the object « order » section.
To modify the variable state, add the « = » sign followed by a constant
after the variable name.
The following constants are used for boolean variables:
« 0 », « 1 », « F1 » (set to 1), « F0 » (reset), « UF » (end set), for
example: « %Q0=1 », « %I10=F1 », « %I12=UF ».
For numeric variables, the constant is a number, for example:
« M200=1234 », « speed=4 ».
Special orders
The following key words can be used in the object order sections:
« RUN »: puts the target in RUN mode,
« STOP »: puts the target in stop,
« INIT »: initializes the target,
« STEP »: effects a step on the target,
« GO »: identical to the environment GO command,
« ENDGO »: stops the GO command,

AUTOMGEN8

78

©opyright 1988-2007 IRAI

Environment

« EXIT »: exits the environment,
« UCEXIT »: exits the environment without asking for confirmation,
« OPENAOF(