Professional Documents
Culture Documents
45manual Somachine-Program PDF
45manual Somachine-Program PDF
SoMachine
Programming Guide
10/2010
EIO0000000067.04
www.schneider-electric.com
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
The information provided in this documentation contains general descriptions and/or
technical characteristics of the performance of the products contained herein. This
documentation is not intended as a substitute for and is not to be used for
determining suitability or reliability of these products for specific user applications. It
is the duty of any such user or integrator to perform the appropriate and complete
risk analysis, evaluation and testing of the products with respect to the relevant
specific application or use thereof. Neither Schneider Electric nor any of its affiliates
or subsidiaries shall be responsible or liable for misuse of the information contained
herein. If you have any suggestions for improvements or amendments or have found
errors in this publication, please notify us.
No part of this document may be reproduced in any form or by any means, electronic
or mechanical, including photocopying, without express written permission of
Schneider Electric.
All pertinent state, regional, and local safety regulations must be observed when
installing and using this product. For reasons of safety and to help ensure
compliance with documented system data, only the manufacturer should perform
repairs to components.
When devices are used for applications with technical safety requirements, the
relevant instructions must be followed.
Failure to use Schneider Electric software or approved software with our hardware
products may result in injury, harm, or improper operating results.
Failure to observe this information can result in injury or equipment damage.
© 2010 Schneider Electric. All rights reserved.
2 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Table of Contents
Safety Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
About the Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Part I Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 1 Introduction about Programming . . . . . . . . . . . . . . . . . . 15
Programming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Chapter 2 Managing Projects with SoMachine 2.0 . . . . . . . . . . . . . 17
Main Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Part II Manage Your Project . . . . . . . . . . . . . . . . . . . . . . . . . 19
Chapter 3 Home . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.1 General Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
General Description of the Main Selection Screen . . . . . . . . . . . . . . . . . . 23
Accessing General Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.2 Show Existing Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Show Existing Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.3 Create New Machine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Create New Machine Sub-Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Start with Empty Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Start with TVD Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Start with Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Start with Existing Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Start with Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.4 Machine Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Machine Workflow Sub-Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Commission Machine - Start with Project . . . . . . . . . . . . . . . . . . . . . . . . . 43
Commission Machine - Upload Project from Device . . . . . . . . . . . . . . . . . 45
Update Firmware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.5 Learning Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Learning Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Chapter 4 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
General Overview of the Properties Tab . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Description of the General Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Description of the Description Task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Description of the Custom Information Task . . . . . . . . . . . . . . . . . . . . . . . 59
EIO0000000067 10/2010 3
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Chapter 5 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
5.1 General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
General Description of the Configuration Tab . . . . . . . . . . . . . . . . . . . . . 62
5.2 Graphical Configuration Editor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
General Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Adding and Deleting Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Configuring Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Detecting Configuration Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Accessing Programming and Application Functions with the Graphical
Configuration Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Creating Network Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Chapter 6 Device Configuration with Device Type Manager (DTM) 87
6.1 General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
What is FDT? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
SoMachine as FDT Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Typical Topologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Devices with Device Type Manager (DTM) . . . . . . . . . . . . . . . . . . . . . . . 93
FDT Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
6.2 Main Use Cases for Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Device Type Manager (DTM) Installation . . . . . . . . . . . . . . . . . . . . . . . . 97
Configuration Offline with the Dedicated DTM. . . . . . . . . . . . . . . . . . . . . 101
Configuration Online with the Dedicated DTM. . . . . . . . . . . . . . . . . . . . . 105
Configuration with Generic DTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Hardwire Topology. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
6.3 FDT Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
FDT Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
6.4 Device Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Device Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Chapter 7 Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
7.1 General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
General Description of the Program Tab . . . . . . . . . . . . . . . . . . . . . . . . . 130
7.2 Managing the Application Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Adding Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Adding and Declaring POUs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Adding Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Adding and Declaring Remanent Variables . . . . . . . . . . . . . . . . . . . . . . . 140
Adding a Symbol Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Adding Other Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Introduction to Data Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
7.3 Adding Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Adding Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Adding Expansion Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Adding Communication Managers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Adding Devices to a Communication Manager . . . . . . . . . . . . . . . . . . . . 154
Adding Devices from Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
4 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
7.4 Managing the Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Generalities About Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Library Management in SoMachine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Schneider Electric Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Other Libraries Used in SoMachine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Creating Your Own Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
7.5 Managing the Communication Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Configuring the Ethernet Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Configuring the CANopen Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Configuring the Serial Line Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Configuring the AS-Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
7.6 SoMachine Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
SoMachine Commands Providing Single Access to Your Machine . . . . . 196
Description of the Build All Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Description of the Create Boot Application Command . . . . . . . . . . . . . . . 198
Description of the USB Mass Storage Command . . . . . . . . . . . . . . . . . . . 199
Description of the Import / Export Vijeo-Designer Project Commands . . . 201
7.7 SoMachine Controller-HMI Data Exchange . . . . . . . . . . . . . . . . . . . . . . . 202
SoMachine Single Variable Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Publishing Variables in the Controller Part . . . . . . . . . . . . . . . . . . . . . . . . 207
Selecting Variables in the HMI Part. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Publishing Variables in the HMI Part. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Parametrization of the Physical Media . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
7.8 SoMachine Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
General Information about SoMachine Templates . . . . . . . . . . . . . . . . . . 213
Supported Fieldbusses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Selecting SoMachine Templates for Your Project. . . . . . . . . . . . . . . . . . . 217
Administration of SoMachine Templates. . . . . . . . . . . . . . . . . . . . . . . . . . 219
7.9 Managing Device Templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Facts of Device Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Adding Devices from Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Creating a Device Template on the Basis of I/O Devices . . . . . . . . . . . . . 228
Visualizations Suitable for Creating Device Templates. . . . . . . . . . . . . . . 229
Steps to Create a Device Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
7.10 Managing Function Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Facts of Function Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Adding Functions From Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Application Functions as Basis for Function Templates . . . . . . . . . . . . . . 239
Steps to Create a Function Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.11 Transferring and Running Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Transferring Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Running Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
EIO0000000067 10/2010 5
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Chapter 8 Commissioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
General Description of the Commissioning Tab . . . . . . . . . . . . . . . . . . . 250
Description of the Login/Logout Task . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Description of the Multiple Download Task . . . . . . . . . . . . . . . . . . . . . . . 255
Description of the Source Download Task. . . . . . . . . . . . . . . . . . . . . . . . 257
Chapter 9 Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Part III Troubleshooting and FAQ . . . . . . . . . . . . . . . . . . . . 265
Chapter 10 Generic - Troubleshooting and FAQ . . . . . . . . . . . . . . . . 267
10.1 Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Shortcuts and Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Enabling and Configuring Analog Inputs on CANopen . . . . . . . . . . . . . . 270
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
6 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Safety Information
§
Important Information
NOTICE
Read these instructions carefully, and look at the equipment to become familiar with
the device before trying to install, operate, or maintain it. The following special
messages may appear throughout this documentation or on the equipment to warn
of potential hazards or to call attention to information that clarifies or simplifies a
procedure.
EIO0000000067 10/2010 7
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
PLEASE NOTE
Electrical equipment should be installed, operated, serviced, and maintained only by
qualified personnel. No responsibility is assumed by Schneider Electric for any
consequences arising out of the use of this material.
A qualified person is one who has skills and knowledge related to the construction
and operation of electrical equipment and the installation, and has received safety
training to recognize and avoid the hazards involved.
8 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
About the Book
At a Glance
Document Scope
This document describes the graphical user interface of the SoMachine software
and the functions it provides. For further information, refer to the separate
documents provided in the SoMachine online help.
Validity Note
This document has been updated with the release of SoMachine V2.0.
Related Documents
EIO0000000067 10/2010 9
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
ATV IMC Drive Controller Programming Guide EIO0000000390 (ENG);
EIO0000000391 (FRE);
EIO0000000392 (GER);
EIO0000000393 (SPA);
EIO0000000394 (ITA);
EIO0000000395 (CHS)
Modicon M258 Logic Controller Programming Guide EIO0000000402 (ENG);
EIO0000000403 (FRE);
EIO0000000404 (GER);
EIO0000000405 (SPA);
EIO0000000406 (ITA);
EIO0000000407 (CHS)
Modicon LMC058 Logic Controller Programming Guide EIO0000000408 (ENG);
EIO0000000409 (FRE);
EIO0000000410 (GER);
EIO0000000411 (SPA);
EIO0000000412 (ITA);
EIO0000000413 (CHS)
You can download these technical publications and other technical information from
our website at www.schneider-electric.com.
10 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Product Related Information
WARNING
LOSS OF CONTROL
z The designer of any control scheme must consider the potential failure modes
of control paths and, for certain critical control functions, provide a means to
achieve a safe state during and after a path failure. Examples of critical control
functions are emergency stop and overtravel stop, power outage and restart.
z Separate or redundant control paths must be provided for critical control
functions.
z System control paths may include communication links. Consideration must be
given to the implications of unanticipated transmission delays or failures of the
link.
z Observe all accident prevention regulations and local safety guidelines.1
z Each implementation of this equipment must be individually and thoroughly
tested for proper operation before being placed into service.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
1 For additional information, refer to NEMA ICS 1.1 (latest edition), "Safety
Guidelines for the Application, Installation, and Maintenance of Solid State Control"
and to NEMA ICS 7.1 (latest edition), "Safety Standards for Construction and Guide
for Selection, Installation and Operation of Adjustable-Speed Drive Systems" or their
equivalent governing your particular location.
WARNING
UNINTENDED EQUIPMENT OPERATION
z Only use software approved by Schneider Electric for use with this equipment.
z Update your application program every time you change the physical hardware
configuration.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
User Comments
We welcome your comments about this document. You can reach us by e-mail at
techcomm@schneider-electric.com.
EIO0000000067 10/2010 11
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
12 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Introduction
EIO0000000067 10/2010
Introduction
I
What's in this Part?
This part contains the following chapters:
Chapter Chapter Name Page
1 Introduction about Programming 15
2 Managing Projects with SoMachine 2.0 17
EIO0000000067 10/2010 13
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Introduction
14 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Introduction about Programming
EIO0000000067 10/2010
1
Programming
Overview
SoMachine allows you to configure, program and commission entire machines in a
single software environment.
It consists of 2 parts dedicated to specific programming tasks:
z SoMachine part for controller programming
z Vijeo-Designer part for HMI programming
User Documentation
This programming manual describes the SoMachine user interface and functions. It
is part of the SoMachine online help.
To start the SoMachine online help, click the ? button in the SoMachine screen or
select the Help command from the General Functions Menu (see page 25).
To start the online help from the Program screen of SoMachine, use the Help menu
or press the F1 key.
To start the Vijeo-Designer online help, select a suitable command from the Help
menu or press the F1 key when you are in the Vijeo-Designer application.
For general information on SoMachine, like for example system requirements,
installation and supported devices, refer to section Introduction of the SoMachine
online help.
For detailed information on the controllers and integrated HMIs supported by
SoMachine, refer to section Hardware User Guides of the SoMachine online help.
For detailed information on SoMachine libraries, refer to section Functions &
Libraries User Manuals of the SoMachine online help.
EIO0000000067 10/2010 15
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Introduction about Programming
16 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Managing Projects with SoMachine 2.0
EIO0000000067 10/2010
Overview
SoMachine 2.0 provides a completely new graphical user interface that is based on
the 3 main tasks it has been designed for:
z configuring projects
z programming projects
z commissioning machines
Configuring Projects
SoMachine 2.0 provides tools that are intended to assist you in creating new
projects fast and easily.
It provides for project start-up
z a variety of tested validated documented architectures (a dedicated TVDA
Finder tool assists you in selecting the architecture that most appropriately suits
your individual project),
z a variety of application projects for conveying, hoisting, and packaging that
provide basic configurations for these applications,
z some examples that provide basic projects for making yourself familiar with
SoMachine.
Once the project is created, SoMachine provides extensive possibilities to add
textual and graphical information to each project file. This additional information
enables you to distinguish projects avoiding the need to open them when you have
to select the suitable project out of those that are available on your computer.
For easy configuration of your project, SoMachine provides a graphical
configuration editor that allows to add and configure devices in a comfortable way.
EIO0000000067 10/2010 17
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Managing Projects with SoMachine 2.0
Programming Projects
For programming projects, the conventional CoDeSys graphical user interface is
integrated in the SoMachine graphical user interface. It provides the general
programming and controller configuration functions. For configuring HMI controllers,
Vijeo-Designer is used.
Commissioning Machines
SoMachine provides components that are especially dedicated to machine
commissioning. These components provide only those functions that are required
for this task, like login into the devices, configuring last parameters and up- or
downloading software and/or sourcecode.
18 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Manage Your Project
EIO0000000067 10/2010
II
What's in this Part?
This part contains the following chapters:
Chapter Chapter Name Page
3 Home 21
4 Properties 53
5 Configuration 61
6 Device Configuration with Device Type Manager (DTM) 87
7 Program 129
8 Commissioning 249
9 Report 259
EIO0000000067 10/2010 19
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Manage Your Project
20 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
EIO0000000067 10/2010
Home
3
What's in this Chapter?
This chapter contains the following sections:
Section Topic Page
3.1 General Information 22
3.2 Show Existing Machine 27
3.3 Create New Machine 31
3.4 Machine Workflow 41
3.5 Learning Center 50
EIO0000000067 10/2010 21
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
22 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Starting up SoMachine
Start SoMachine by using the Start →Programs →Schneider Electric →
SoMachine menu or double-click the SoMachine icon on your desktop or double-
click an already existing SoMachine project file for example in the Windows
Explorer.
A splash screen will be displayed indicating that the program is being started.
EIO0000000067 10/2010 23
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
3 The work area in the middle is intended to always be visible. It provides access to the most
recently opened projects.
4 The Type of files list provides the possibility to display All files or to display only Project
files or Library files or CoDeSys project files (before V3.0) or CoDeSys library files
(before V3.0) in this work area.
5 The View list provides the possibility to change from the thumbnails view of the projects to
a more detailed List view.
6 The information pane on the right-hand side shows further information on the project that
is currently selected in the work area, you can hide this pane by clicking the handle.
7 Handles to hide or display the task selection pane on the right-hand side, the information
pane on the left-hand side and the message pane at the bottom of the window that is not
visible by default in the startup screen.
8 The Language list allows you to change the language of the SoMachine user interface,
after you have changed the language you must restart SoMachine for the changes to
become valid
9 The ? icon provides quick access to the SoMachine online help.
24 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Command Description
Home Execute this command to return to the Home tab (closing your
currently open project), that is the main selection screen
(see page 23) of SoMachine.
Save Execute this command to save the changes to your currently open
project.
Save As Execute this command to save your currently open project / library to
a different location or under a different name. A standard Windows
Save Project dialog box is displayed that allows you to browse to the
new folder and / or enter the new file name.
EIO0000000067 10/2010 25
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Command Description
Save/Send archive Execute this command to create an archive file of the SoMachine
project that is currently open and:
z to save the archive file to a connected drive by using the Save
button of the Project Archive dialog box
or
z to create a temporary archive file that is attached to an empty e-
mail by using the Send button of the Project Archive dialog box.
This e-mail is automatically created by SoMachine if the
Messaging Application Programming Interface (MAPI) is correctly
installed.
Preferences Execute this command to configure:
z the Preferred Path where to open and save SoMachine projects.
z the Online Polling Interval (ms) that is the time span that has to
elapse between 2 attempts to poll the connected devices.
z the Routing Step Width that defines the grid size of the graphical
configuration editor (see page 65). Select a value between 15
(wide grid) and 50 (small grid), bearing in mind that a smaller grid
(a higher value) leads to longer times for refreshing the graphical
representation of your configuration.
z the Timeout for routing that defines the time the graphical
configuration editor (see page 65) is allowed to (re)route the
graphical representation of your configuration in order to create
right-angled connecting lines. If this timeout elapses before the
routing process is finished, the remaining lines will be displayed
without right-angles.
z the Stop Gateway on Exit check box defines the behavior of the
gateway after closing the last instance of SoMachine:
z check box checked (default)
The gateway is automatically stopped when you exit the last
SoMachine instance. If other instances of SoMachine are still
running, using the gateway, it will not be stopped.
z check box unchecked
The gateway will not be stopped automatically when you exit
the last SoMachine instance.
z general settings by clicking the Options button.
26 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Sub-Tasks
With the Show existing machine task you can open an already existing project.
It includes the following sub-tasks:
z Browse for existing project to open an existing SoMachine project
z Extract archive to open an existing SoMachine project archive file
EIO0000000067 10/2010 27
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
1 The most recently opened projects will be displayed in the SoMachine work area.
2 The Type of files list provides the possibility to display All files or to display only Project
files or Library files or CoDeSys project files (before V3.0) or CoDeSys library files
(before V3.0) in this work area.
3 The View list provides the possibility to change from the thumbnails view of the projects to
a more detailed List view.
4 The information pane displays Project Information related to the project that is selected
in the work area.
Double-click its icon in the work area or select the project in the work area and click
the Open button in the information pane to open the project in SoMachine.
SoMachine will select the Properties tab (see page 54) for assigning further
information.
28 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
1 The task selection pane shows the connected drives similar to a Windows Explorer.
2 The work area displays the SoMachine projects that are available in the folder you have
selected in the selection pane.
3 The Type of files list provides the possibility to display All files or to display only Project
files or Library files or CoDeSys project files (before V3.0) or CoDeSys library files
(before V3.0) in this work area.
4 The View list provides the possibility to change from the thumbnails view of the projects to
a more detailed List view.
5 The information pane displays Project Information related to the project that is selected
in the work area.
EIO0000000067 10/2010 29
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
In the task selection pane browse to the folder that contains the SoMachine project
you want to open. Double-click its icon in the work area or select the project in the
work area and click the Open button in the information pane to open the project in
SoMachine. SoMachine will select the Properties tab (see page 54) for assigning
further information.
To access network drives that are not mapped on your PC, proceed as follows:
Step Action
1 Click the Remote drive task in the task selection pane.
2 Enter the server name and the subfolder name(s) according to the following
syntax in the text box: \\servername\foldername
3 Click the Open button.
Result: The content of the server / subfolder will be displayed in the task
selection pane similar to a Windows Explorer.
Step Action
1 Select the Extract Archive sub-task from the task selection pane.
Result: The Extract Archive dialog box will be displayed.
2 Browse to the folder that contains the project archive file you want to open.
3 Select the project archive file and click the Open button.
Result: The Project Archive dialog box opens.
4 In the Project Archive dialog box select the Referenced devices and
Referenced libraries you want to extract from the archive file and click the
Extract button.
Result: SoMachine extracts the selected items from the archive file and
automatically opens the project.
30 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
EIO0000000067 10/2010 31
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Sub-Tasks
With the Create new machine task you can create a new project either from scratch
or by using a project template.
It includes the following sub-tasks:
z Start with empty project
z Start with TVD architecture
z Start with application
z Start with existing project
z Start with example
32 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
EIO0000000067 10/2010 33
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
1 The TVD Architecture Finder in the selection pane assists you in finding the suitable
tested validated documented architecture by answering the questions.
2 The work area provides a list of the tested validated documented architectures available
and highlights the project that best suits your requirements after you have answered the
questions in the TVD Architecture Finder.
3 The information pane provides further information related to the tested validated
documented architecture that is selected in the work area.
34 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Step Action
1 In the Home tab, select Create new machine →Start with TVD architecture.
2 Answer the questions in the selection pane and click the Recommended
Project button.
Result: The TVD architecture that best suits your requirements will be
highlighted in green in the work area.
3 Double-click the TVD architecture you want to use as template for your new
project in the work area or select it in the work area and click the Create From
button in the information pane.
Result: A Save Project As dialog box will be displayed where you can browse
to the destination folder and assign a name to the new project.
4 Click Save to save your project to the selected folder. SoMachine opens the
project and selects the Properties tab (see page 54) for assigning further
information.
EIO0000000067 10/2010 35
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
1 The selection pane lists those Applications SoMachine provides application projects for.
2 The work area shows those application projects that are available for the application
selected in the selection pane.
3 The information pane provides further information related to the application project that is
selected in the work area.
36 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Step Action
1 In the Home tab select Create new machine →Start with application.
2 From the Applications list select the suitable application type for your machine.
Result: The application projects available for the selected application will be
displayed in the work area.
3 Double-click the application project you want to use as template for your new
project in the work area or select it in the work area and click the Create From
button in the information pane.
Result: A Save Project As dialog box will be displayed that allows you to browse
to the destination folder and assign a name to the new project.
4 Click Save to save your project to the selected folder. SoMachine opens the
project and selects the Properties tab (see page 54) for assigning further
information.
EIO0000000067 10/2010 37
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
38 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
EIO0000000067 10/2010 39
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Step Action
1 In the Home tab select Create new machine →Start with example.
2 Select a category in the Examples list to display the examples available for this
category in the work area.
3 To use an example as template for your new project, double-click its icon in the
work area or select it in the work area and click the Create From button in the
information pane.
Result: A Save Project As dialog box will be displayed that allows you to browse
to the destination folder and assign a name to the new project.
4 Click Save to save your project to the selected folder. SoMachine opens the
project and selects the Properties tab (see page 54) for assigning further
information.
40 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
EIO0000000067 10/2010 41
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
42 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
1 The task selection pane shows the connected drives similar to a Windows Explorer.
2 The work area displays the SoMachine projects that are available in the folder you have
selected in the selection pane.
3 The Type of files list provides the possibility to display All files or to display only Project
files or Library files or CoDeSys project files (before V3.0) or CoDeSys library files
(before V3.0) in this work area.
4 The View list provides the possibility to change from the thumbnails view of the projects to
a more detailed List view.
5 The information pane displays Project Information related to the project that is selected
in the work area.
EIO0000000067 10/2010 43
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Step Action
1 In the Home tab select Machine workflow →Commission machine - start
with project.
Result: The connected drives are shown in its task selection pane, similar to a
Windows Explorer, allowing to browse for the project file.
2 Browse to the folder that contains the project file for the new machine.
3 Open the project by double-clicking its icon in the work area or by selecting it in
the work area and clicking the Open button in the information pane.
Result: SoMachine opens the project showing only the Commissioning
Machine tab (see page 250) with commands restricted to perform
commissioning tasks.
44 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Furthermore it is available for those XBTGC types that can use a USB flash drive as
secondary storage and for XBTGT/GK controllers that can use the CF card as
secondary storage.
EIO0000000067 10/2010 45
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Step Action
1 In the Home tab select Machine workflow →Commission machine - upload
project from device.
Result: A Select Device dialog box opens.
2 In the Select Device dialog box select the device you want to upload the project
from.
If the device is not displayed, click the Scan network button to search for all
available devices.
3 Click the OK button.
Result: The Project Archive dialog box opens:
46 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Step Action
4 In the Project Archive dialog box click the ... button to browse to the folder on
your SoMachine PC where the uploaded project will be saved.
5 In the Archive contents section select those contents of the project archive that
will be uploaded to the selected folder. To achieve this, select the check boxes
for each item you want to upload.
6 Click Extract to upload the selected contents of the project archive to the
selected folder.
7 During the upload process you will be prompted to confirm any overwriting of
files already available in the specified folder.
8 Confirm the message prompting you to open the uploaded project.
Result: The Commissioning tab opens, displaying the project configuration in
the work area.
For more information on the sub-tasks available in the Commissioning tab refer to
the Commissioning chapter (see page 249).
EIO0000000067 10/2010 47
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Update Firmware
CAUTION
LOSS OF APPLICATION DATA
z Perform a backup of the application program to the hard disk of the PC before
attempting a firmware update.
z Restore the application program to the device after a successful firmware
update.
Failure to follow these instructions can result in injury or equipment damage.
48 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
To update the firmware of the Modicon M238 Logic Controller, click either the
firmware download icon for USB or for serial line connections.
Result: The M238 Windows Exec Loader wizard will be started. Follow the
instructions on screen that guide you through the update process.
The information pane provides a link to a download area where the latest firmware
updates are available.
EIO0000000067 10/2010 49
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Learning Center
Sub-Tasks
The Learning Center task provides additional information for quickly making
yourself familiar with SoMachine.
It includes the following sub-tasks:
z Quick overview
z Examples
z e-Learning
50 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
Quick Overview
The Quick overview sub-task provides a short film that introduces the SoMachine
user interface as well as its main functions in about 2 minutes time. To run this film,
no additional software is required on your PC.
Examples
The Examples sub-task provides sample projects together with PDF files
documenting these SoMachine projects.
NOTE: Please note that the Adobe ReaderTM is required to open these documents.
This reader is not part of the SoMachine installation but can be downloaded from
http://www.adobe.com/go/EN_US-H-GET-READER.
e-Learning
The e-Learning sub-task provides an interactive training that shows you how to use
SoMachine. To run this training, no additional software is required on your PC.
EIO0000000067 10/2010 51
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Home
52 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
EIO0000000067 10/2010
Properties
4
What's in this Chapter?
This chapter contains the following topics:
Topic Page
General Overview of the Properties Tab 54
Description of the General Task 56
Description of the Description Task 57
Description of the Custom Information Task 59
EIO0000000067 10/2010 53
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
54 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
1 The task selection pane shows the tasks of the Properties tab.
2 The work area provides entry fields for file information and author information.
3 The information pane displays information entered in the work area.
To save your entries, click the SoMachine icon and select Save from the general
functions menu (see page 25).
EIO0000000067 10/2010 55
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
File Information
The section File Information displays the name of your project file and the folder it
is saved in. To save your project to a different location or under a different name,
click the Save as button, navigate to the preferred folder and save your project file.
Author Information
The section Author Information provides entry fields for optional information you
consider relevant. Your entries are displayed in the section Project Information on
the right side.
Note:
The following characters are not allowed in the Title and Author text boxes:
z ( (left parenthesis)
z ) (right parenthesis)
z , (comma)
To save the information entered in the Properties tab, click the SoMachine icon and
select Save from the general functions menu (see page 25).
56 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
The work area provides the button Add to add a preferred Customer Image to your
SoMachine project and shows the Configuration View corresponding to your
settings in the Configuration tab.
EIO0000000067 10/2010 57
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
Customer Image
The section Customer Image allows you to add an image to your SoMachine
project.
Step Action
1 Click the Add button.
Result: The dialog box Add customer image to project opens.
2 Browse to your destination folder, select a preferred image, and click Open.
Result: The customer image is displayed in the work area and in the information
pane.
Configuration View
The Configuration View section shows an overview of your project configuration
corresponding to your settings in the Configuration tab (see page 62).
58 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
EIO0000000067 10/2010 59
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Properties
Attached Documents
Click the Add Attachment button to attach 1 or more documents to your project file.
A dialog box will be displayed, where you can browse to the destination folder.
After you have attached a file to your project, the section Add Attachment displays
a check box for Important Information as well as the icons for:
z View attachment, which opens the attached file.
z Save attachment as file, which opens a Save as dialog box.
z Remove attachment from project, which deletes the link between the project
and the attached file.
Important Information
The section Attached Documents provides the check box Important Information
for each of the attached documents. For each document you consider as important
to read, select the check box. The task menu will then show a small SoMachine icon
next to the task Custom Information to indicate that it includes important
information.
60 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
EIO0000000067 10/2010
Configuration
5
What's in this Chapter?
This chapter contains the following sections:
Section Topic Page
5.1 General Information 62
5.2 Graphical Configuration Editor 65
EIO0000000067 10/2010 61
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Overview
The Configuration tab is only displayed after you have opened a SoMachine
project.
It consists of a graphical configuration editor that provides necessary functions to
perform the entire hardware and network configuration of your machine. The
configuration settings performed here will also be available in the CoDeSys and
Vijeo-Designer Program tab.
62 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
1 The task selection pane shows the list of controllers, HMIs, and miscellaneous devices you
can drag into the graphical configuration editor as well as a Search function to search for
the required device.
2 The work area includes the graphical configuration editor with its display manager at the
bottom.
3 The information pane provides further information on the element selected in the task
selection pane or in the work area (devices, connections, communication managers).
EIO0000000067 10/2010 63
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
64 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
EIO0000000067 10/2010 65
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
General Description
Overview
The graphical configuration editor provides necessary functions to perform the
entire hardware and network configuration of your machine in a graphical way. The
configuration settings performed here will also be available in the Program tab as
well as in Vijeo-Designer.
1 The graphical configuration editor in the work area displays your machine configuration in
a graphical way.
2 The display manager simplifies the use of the graphical configuration editor.
66 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
When you start creating a new project from scratch, the graphical configuration
editor will be empty. It will then prompt you to drag a device from the list on the left-
hand side into this empty area.
Display Manager
To simplify its use, the graphical configuration editor contains a display manager at
the bottom of the pane.
The display manager contains the following functions:
EIO0000000067 10/2010 67
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Overview
The Configuration tab includes the graphical configuration editor that allows to
perform machine configuration in a graphical way.
When adding or deleting devices in the controller configuration, SoMachine
automatically adjusts the memory allocations for the devices. If you are adding or
deleting devices to or from an existing program, you must take into account any
adjustments made to I/O memory within your program.
WARNING
UNINTENDED EQUIPMENT OPERATION
Inspect and modify as necessary any immediate addresses used in the program
after modifying the configuration.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Adding Devices
To add a device, proceed as follows:
Step Action
1 Select the device you want to add to your machine configuration from the catalog
list on the left-hand side of the Configuration tab.
Further information concerning the selected device will be displayed in the
information pane on the right-hand side.
2 Drag the device icon to the graphical configuration editor in the middle of the
Configuration tab.
Result: The device is added to the machine configuration and can be moved
freely with the left mouse button. You can now configure the device.
NOTE: If you add an HMI device to your graphical configuration editor, Vijeo-
Designer will automatically be started in the background.
68 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Deleting Devices
To delete a device from the graphical configuration editor, right-click it and select
Delete from the context menu, or select the device in the editor and press the delete
key on your keyboard. If you confirm this action, the device as well as the network
lines to which the device is connected will be deleted from the graphical
configuration editor.
EIO0000000067 10/2010 69
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Configuring Devices
Overview
The graphical configuration editor provides access to configuration dialog boxes of
the devices.
70 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
EIO0000000067 10/2010 71
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
WARNING
UNINTENDED EQUIPMENT OPERATION
Inspect and modify as necessary any immediate addresses used in the program
after modifying the configuration.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
72 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Select the suitable protocol manager from the list and click the Add and close
button.
Result: The configuration dialog box for the selected protocol will be displayed on
the right-hand side of the SoMachine screen.
EIO0000000067 10/2010 73
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
1 Click the empty rectangle, representing an empty port, of your device graphic.
Result: The Add Object dialog box will be displayed. Its contents, that is the
available fieldbusses and / or communication managers, depends on the
selected device and the specific port.
74 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
2 From the Add Object dialog box select the item you want to define for the
selected port (in the example below a CANopen Manager Optimized).
EIO0000000067 10/2010 75
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
1 Click on a free port of the fieldbus manager in your graphical configuration
editor.
76 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
2 Select a suitable device from the list and click the Add and close button.
Result: The icon of the selected device will be displayed in the graphical
configuration editor, connected to the CANopen_Optimized manager.
To delete a slave device, select it in the graphical configuration editor and hit the
DELETE key or right-click the slave device and select Remove from the context
menu.
EIO0000000067 10/2010 77
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
1 Click in the graphical configuration editor on the area Add Expa... of the device.
Result: The Add object dialog box opens, displaying only those expansion
modules that can be connected to the selected device like in the graphic below
for an M238 logic controller.
78 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
2 Select the expansion module you want to add to the device from the list on the
left-hand side and click the Add and close button.
Result: The expansion module will be displayed in the graphical configuration
editor on the right-hand side of the device.
The expansion modules added to a device are displayed on the right side of the
device icon. You can hide or display them by clicking the small arrow above the Add
Expa... button. To configure them, double-click their icons.
NOTE: When you add a TWDNOI10M3 object, that is an AS-Interface Master
Module, the corresponding Virtual AS interface bus fieldbus manager will
automatically be inserted. To add AS-Interface slave modules, proceed as
described in the Adding Slave Devices to a Fieldbus Manager (see page 76)
paragraph above.
EIO0000000067 10/2010 79
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
80 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
1 Click the red icon (in the above example the CANopen Manager) to display
further information on the specific detected configuration error in the information
pane on the right-hand side.
2 To solve this issue, click the Modify address configuration button.
Result: An Address settings dialog box will be displayed.
3 In the Address settings dialog box you can check the addresses and correct
them manually by changing the Node Id of 1 device or you can click the Fix
address conflicts button to have the address conflict automatically corrected
by SoMachine.
EIO0000000067 10/2010 81
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Overview
The graphical configuration editor provides direct access to the CoDeSys
programming environment.
Programming Logic
To program logic for a device in the graphical configuration editor, right-click the
device and select Program →Application from the context menu.
Result: The SoMachine Program tab opens, providing access to the CoDeSys
programming interface.
Adding an Application
If your device does not yet have an application, you can create a new application as
follows: Right-click the device in the graphical configuration editor and select the
command Add application from the context menu. In the Add application dialog
box enter a name for your new application and click Open.
82 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Updating Firmware
To update the firmware of your M238 controller, right-click the device in the graphical
configuration editor and select the command Update firmware from the context
menu. The M238 OS Loader Wizard will be started, guiding you through the update
process.
Performing a firmware update will delete the current application program in the
device, including the Boot Application in Flash memory.
CAUTION
LOSS OF APPLICATION DATA
z Perform a backup of the application program to the hard disk of the PC before
attempting a firmware update.
z Restore the application program to the device after a successful firmware
update.
Failure to follow these instructions can result in injury or equipment damage.
EIO0000000067 10/2010 83
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Overview
The graphical configuration editor provides easy connection of communication ports
by simply drawing lines between them.
It automatically checks the compatibility of the ports to be connected and issues
error detection messages as tooltips if it detects any incompatibility.
Step Action
1 Move the cursor on the communication port of the device you want to connect.
Result: The cursor will change to a crosshair cursor. The type of the communication
port will be indicated in a tooltip.
2 Click on the communication port you want to connect and keep the left mouse
button pressed.
Result: The cursor converts into a pencil and draws a line when being moved.
3 Drag the pencil cursor to the communication port of the device or module you want
to connect your device to.
Result: The pencil cursor draws a line between the 2 ports.
4 Release the left mouse button when the pencil cursor is over the communication
port of the second device.
Result: The pencil is converted into a normal cursor and the line between the
devices will be displayed in the color that corresponds to the connection type (for
color definitions see below).
84 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Step Action
5 A context menu will be displayed providing the following possibilities to configure
the communication parameters of the 2 devices:
z Copy parameters from start to end device
z Copy parameters of end device to start device
z Setup communication parameters of both devices
To save your settings, select the Save command from the General Functions Menu
(see page 25).
To return to the graphical configuration editor, click the Back button on the left-hand
side of the screen or double-click the Configuration Overview graphic.
To leave the settings on both sides unchanged, click anywhere else in the graphical
configuration editor. The context menu will be closed.
EIO0000000067 10/2010 85
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Configuration
Color Definitions
The type of network connection is indicated by the color of the connection lines:
Consistency Checks
SoMachine automatically checks the consistency when creating new network
connections. It issues error detection messages as tooltips if it detects any
incompatibility.
You can disable this function for individual connections. To achieve this, right-click
the network connection line and select the command Disable consistency checks
from the context menu. The network connection line will be displayed with a red-
striped background to indicate that the consistency check is disabled.
To re-enable the consistency check for a connection line, right-click it and select
once again the command Disable consistency checks from the context menu.
86 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
EIO0000000067 10/2010
EIO0000000067 10/2010 87
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
88 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
What is FDT?
Overview
FDT (Field Device Tool) technology standardizes the communication interface
between field devices and engineering or asset management tools.
FDT Concept
Since 1998, FDT technology has offered both process and factory manufacturing
industries a truly open solution for accessing device intelligence that is supplier,
system, and protocol independent.
See the official WEB site: www.fdtgroup.org
You can find below some information coming from FDTGROUP:
FDT enables easy device access and configuration through any host system that
provides the interface.
FDT is not a new fieldbus protocol. It can be used with any communication protocol.
FDT is vendor independent and established as an open publicly available
specification. Field information from processes is required during the entire life cycle
of a plant or application.
FDT supports all phases of a plant life cycle:
z engineering
z installation
z commissioning
z production
z maintenance
EIO0000000067 10/2010 89
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Overview
The FDT/DTM, an open-standard, integrates the configuration tools needed to build
projects, with a mix of Schneider and Third Party intelligent devices, on
heterogeneous networks.
SoMachine is an FDT Container for DTMs.
NOTE: Schneider Electric is not responsible for the correct functioning of non
Schneider Electric DTMs under SoMachine.
90 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Typical Topologies
Overview
There are two ways to configure DTM devices under SoMachine:
z Communication to the DTM device through controller and fieldbus: fieldbus
topology
z Direct point to point connection to one Device: hardwire topology
Fieldbus Topology
Characteristics:
z Device is connected to the controller fieldbus (CANopen)
z Communication path to the device through the controller
z Connection of the PC to the controller via USB or Ethernet cable
z Device parameters can be transferred in both directions regardless of the
SoMachine - Controller connection status (Login/Logout)
Benefits:
z Commissioning of devices remotely
z Only one connection to all devices through one cable
z Device commissioning parameters are saved in the SoMachine project file
EIO0000000067 10/2010 91
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Hardwire Topology
Typical use cases:
z Device is not connected to the controller by a fieldbus, but by a direct IO
connections (hardwire device).
z Device is connected to the controller through another fieldbus than CANopen.
z Device is connected through CANopen but DTM works over Modbus only.
For configuration data transfer, a Modbus Serial Line connection can be established
between the PC and one device using an USB - RS485 cable converter.
To connect the PC to the device, you must use the TSXCUSB485 cable plus a
Modbus RJ45 cable (VW3A8306R••):
92 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Device DTMs
The following table lists those devices that provide the device DTM in SoMachine
V2.0 for configuration / online connection:
NOTE: At any time, new versions of existing DTMs or new DTMs can be installed
into the SoMachine environment.
Communication DTMs
Communication DTMs provide communication paths to a device for a certain
fieldbus protocol (e.g.: Modbus).
The following table lists the Communication DTMs in SoMachine V2.0:
EIO0000000067 10/2010 93
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Limitations
The limitations for the different DTMs are the following:
DTM Limitation
ATV31 The DTM can be used only to configure the device in Hardwire topology on
Modbus Serial.
ATV71 If you want to use online functions of a DTM which is associated to an ATV71
with an ATV IMC controller plugged in, either through Fieldbus topology
(see page 91) or Hardwire topology, (see page 92) then a valid application
must have been previously downloaded to the ATV IMC controller.
Lexium32 The DTM is not usable on CANmotion. In this case, drive commissioning has
to be done using Hardwire topology on Modbus Serial.
Generic The DTM should only be used when a dedicated DTM is not available.
CANopen When you configure a device using the Generic CANopen DTM with a standard
device EDS, the parameter values might not be fully consistent with the
installed device. For example, the parameter values for min./max. values,
versions, etc. of Altivar or Lexium drives listed in the standard EDS file might
not be fully compatible with the drives in the currently used ranges. As a
consequence, Parameter Upload and Parameter Download commands
might generate some exception messages.
When you configure a Motion & Drive device (Altivar, Integrated Lexium or
Lexium) using the Generic CANopen DTM instead of using the standard device
EDS or a dedicated DTM, the function blocks of the device related library
(Altivar library, Integrated Lexium library or Lexium library) are not operational
to control and monitor this device (Axis_Ref_ATV, Axis_Ref_ILX and
Axis_Ref_LXM are not supported by the Generic CANopen DTM). In that
case use the CAA CiA 405 library (see SoMachine, CANopen Management
Functions, CAA CiA 405 Library Guide) to control and monitor this device.
All In Fieldbus Topology, the number of CANopen device DTMs and standard
CANopen devices declared in a CANopen configuration of a controller is
limited to the maximum number of CANopen devices supported by the
concerned controller CANopen interface. Please refer to the related Controller
Programming Guide in SoMachine Online Help to get this limitation.
All The number of open DTMs at the same time in the PC running SoMachine is
limited to 4 by default. Refer to the Restrict DTM instance count to limit
memory usage option for further details about the customization of this
limitation.
94 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
FDT Services
Overview
FDT services via CANopen offer more advantages than standard CANopen
configuration with EDS file which is limited to offline configuration.
FDT offers upload and online configuration.
Services
The following table describes the services available for standard configuration with
EDS file and device DTM:
1 Downloaded with the controller application download and sent to the device at
CANopen start.
2 If supported by the DTM
3 Not in all cases: values can be changed by other software (Advantys, SoMove,
etc.)
The dedicated DTM available in SoMachine V2.0 and the communication DTM
(needed for a direct connection without controller) are listed in Devices with Device
Type Manager (see page 93).
EIO0000000067 10/2010 95
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
96 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Overview
The DTM must first be installed into the PC.
The DTM must be installed in SoMachine to be visible in the Device Repository.
Only DTMs listed in the Device Repository can be used in a SoMachine project.
Step Action
1 When a project is opened, select the Program tab:
EIO0000000067 10/2010 97
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
5 Select the DTMs to be used with SoMachine.
6 Click OK button.
Result: The selected DTMs are now available in the Device Repository window,
node Fieldbusses →FDT:
NOTE: For more information on the Device Repository, refer to the SoMachine
Online Help, CoDeSys part.
98 EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
1 Select the Program tab:
EIO0000000067 10/2010 99
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
3 Select the DTM device:
NOTE: In the Information area, check in the Name text that the selected device is
a proper DTM device.
4 Click on Add Device button.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Overview
During offline configuration, the device is not communicating with the PC.
Nevertheless the device can be configured by the DTM. The configuration data is
stored in the SoMachine project file and can be downloaded to the device later on.
Most DTMs provide a Hardware Selection and Configuration window prior to the
Device Parameter Configuration window.
Topology
The corresponding topology is described in Fieldbus Topology (see page 91).
Step Action
1 Select the Program tab:
2 In the Device tree, right click on the device and select (depending on DTM):
Device Configuration →Standard Functions →Configuration.
or
Device Configuration →Standard Functions →Observe.
Result: The device hardware configuration window is displayed
3 Configure the hardware of the device.
4 Click OK button.
Result: The device hardware is configured.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
1 Select the Program tab.
2 In the Device tree, right click on the device and select (depending on DTM):
Device Configuration →Standard Functions →Configuration.
or
Device Configuration →Standard Functions →Observe.
Result: The device parameters configuration window is displayed
3 Configure the device parameters.
All parameter values of the device can be saved and stored in the SoMachine
project file. When the SoMachine project will be reopened, all parameter values will
be restored.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
For more information about DTM configuration, see the specific DTM documentation
of the selected device:
Step Action
1 Select the Program tab.
2 In the Device tree, right click on the device and select Device Configuration
→Documentation.
Result: The DTM documentation is displayed.
NOTE: The configuration in SoMachine must be consistent with the physical device
connected.
If some discrepancy in configuration exists (for example, the reference number of
the connected device is not the same as the pre-defined device declared in the
configuration), the services Parameter upload, Parameter download and Switch
to Synchronize mode will be rejected by the device.
If this happens, you have to delete the device in SoMachine and add a new one that
is fully consistent with the configuration of the physical remote device.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Overview
When the device is physically connected to the controller, SoMachine allows to
upload/download parameters from/to the device and to adjust these parameters.
Before downloading parameters to a device, be aware that a download of
communication parameters with wrong values might cause unexpected operation in
the device, especially if it is already in operating mode.
WARNING
LOSS OF COMMUNICATION
Do not download parameters to a device when:
z the node address configured in the device is not consistent with the node
address parameter configured in device DTM.
z the baud rate configured in the device is not consistent with the baud rate
parameter configured in device DTM.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
If you want to upload/download parameters to the device, you do not need to log into
the controller but a user application with CANopen configuration must have been
previously downloaded in the controller.
NOTE: It is a good diagnostic practice to log into the controller in order to check the
status of the device in the Device tree (green icon: device connected and
accessible).
WARNING
UNINTENDED EQUIPMENT OPERATION
Thoroughly read and understand the device manual for the characteristics and
properties of the device before attempting to modify them.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
WARNING
UNINTENDED EQUIPMENT OPERATION
Do not change device parameters by DTM in parallel to device parameter
modifications made by the RUNNING application.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Technical note:
CANopen device DTM exchanges data with the remote device using SDO services.
In many Schneider CANopen devices, only one SDO channel is supported. This
limitation leads to an increase of the SDO exchange time between the controller and
the device (see the following note).
NOTE: A device DTM can be switched to Online when the controller is in RUNNING
or in STOPPED state.
In the case that the controller can be in RUNNING state (e.g. to write calculated data
to the device) and at the same time the DTM is in Online (e.g. to synchronize data),
the bandwidth of the SDO channel is divided into 2 different sub-channels:
z Sub-channel 1: SDO service sent by the controller program application in real
time for specific adjustment.
z Sub-channel 2: SDO service sent by the DTM in Online mode.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
The following table describes how to prevent the device DTMs to exchange
parameters with the devices (through SDO) while the controller application is
running:
Step Action
1 Select the Program tab.
2 In the Device tree, double click on the CANbus.
Result: The CANbus configuration window is displayed:
Parameter Download
It is recommended to execute the Parameter Download only when the controller is
in STOPPED state, see also the description Limitation of the Operation in Online
Mode (see page 106).
WARNING
UNINTENDED EQUIPMENT OPERATION
Do not change device parameters by DTM in parallel to device parameter
modifications made by the RUNNING application.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Step Action
1 Select the Program tab.
2 In the Device tree, in the CANopen manager, right click on the device DTM
then select Device Configuration → Parameter Download.
Result: The transfer begins.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
3 At the end of the transfer, a message is displayed.
4 All parameters are downloaded to the device.
WARNING
UNINTENDED EQUIPMENT OPERATION
Do not change device parameters by DTM in parallel to device parameter
modifications made by the RUNNING application.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
The aim of this function is to download all device DTM parameters to all the attached
devices. By this, you have not to repeat parameter download command for all the
devices. It provides consistency of the data in the SoMachine project and the data
in the devices.
The following table describes how to download device parameter DTM to all
attached devices:
Step Action
1 Select the Program tab.
2 In the Device tree, in the CANopen manager, right click on the DTM then
select Device Configuration → Parameter download to all attached DTMs.
Result: The transfer begins.
3 At the end of the transfer, a message is displayed.
4 The parameters of all DTM are downloaded to all the attached devices.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Parameter Upload
It is recommended to execute the Parameter Upload only when the controller is in
STOPPED state, see also the description Limitation of the Operation in Online Mode
(see page 106).
WARNING
UNINTENDED EQUIPMENT OPERATION
Do not change device parameters by DTM in parallel to device parameter
modifications made by the RUNNING application.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Step Action
1 Select the Program tab:
2 In the Device tree, in the CANopen manager, right click on the DTM device
then select Device Configuration → Parameter Upload.
Result: The transfer begins.
3 At the end of the transfer, a message is displayed.
4 All device parameters are uploaded to the device DTM and displayed in
SoMachine.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Go Online/Offline
In online/offline mode, you can modify directly the device parameters either after
pressing the Apply button in the user interface or immediately after entering the new
value. This depends on the type of DTM.
The following table describes how to switch to DTM online mode:
Step Action
1 Select the Program tab.
2 In the Device tree, in the CANopen manager, right click on the DTM, then
select Device Configuration → Go online.
Result: The DTM is online (main colors are blue):
Synchronized Mode
This mode is a specific mode for ALTIVAR and LEXIUM devices. It is not available
for generic or other DTMs. Entering the Synchronized Mode, it is possible to monitor
in real time parameters of the device in a convenient way.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
1 Change the DTM to online mode with Go online function (see page 110).
2
NOTE: Click on the button to refresh the parameters. This button is disabled
as long as the DTM device is not in synchronized mode.
For more information, please refer to the user manual of the corresponding DTM.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Mode
switching
Click on the button to switch to Click on the button to switch to
unsynchronized mode. synchronized mode.
Monitoring Only monitored parameters are refreshed No monitored parameters are refreshed cyclically.
parameters cyclically (refer to the device DTM
documentation to get the list of monitored
parameters).
Parameters z Parameter value changed in the DTM z Parameters download command
update configuration window is immediately z Parameters upload command
downloaded to the device
The DTM leaves the Online mode and goes to Offline mode when you select Go
Offline from the device configuration menu:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Overview
Usually, a DTM is dedicated to one specific device type or a device family.
In SoMachine the Generic CANopen Device DTM supports all the CANopen devices
which do not have a dedicated DTM, but an EDS description file.
The Generic CANopen Device DTM functionalities and the GUI (Graphical User
Interface) are implemented in a universal way. By this, the DTM can be used with
any device which supports CANopen.
The Generic CANopen Device DTM converts device descriptions in EDS format into
DDXML format (Schneider Electric internal device description). The DDXML is
interpreted to visualize all parameters of the EDS in a GUI and to create means for
user interaction to manage them accordingly.
Each EDS file with the description of one device, which is copied to a certain location
on the PC (please refer to the user manual of the Generic CANopen Device DTM)
is represented in the Device Repository as one Device DTM which can be inserted
in the Device tree of SoMachine.
The Generic CANopen Device DTM provides the following features:
z Upload/Download
z Display Identification information of a device
z Offline parameterization of CANopen parameters
z Offline parameterization of device specific parameters
z Online monitoring of parameters
z Online setting of parameters
z Compare of offline configuration with the configuration on the device
z View the device description files (EDS and DDXML) of selected device
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
1 Open the folder at the location Start Windows menu →Program →
Schneider Electric →Generic CANopen Device DTM →EDS.
2 Copy in this folder the EDS file for which the device DTM has to be created.
3 Install the Generic CANopen Device DTM as explained in DTM Installation
(see page 97).
Result: The EDS file is converted into DDXML format and stored under ... →
Schneider Electric →Generic CANopen Device DTM →DDXML with the
same name.
NOTE: If the DDXML file is not created, then there is a problem with the EDS file.
Check the detected error message to find out the problem with the EDS file. Refer
to the chapter “Handling of invalid EDS files” in the user manual of the Generic
CANopen device DTM.
If several EDS files are copied into the EDS directory, several new device DTMs will
be created.
After the DDXML is created successfully, a device type is added in the device
repository for the given EDS file. The device type created by the Generic CANopen
Device DTM in the repository is represented with the Product Name taken from the
EDS file. The corresponding DDXML file is also displayed in brackets in the
repository next to the device type name.
NOTE: Every time a new EDS file is copied to the mentioned folder, an Install DTM
action has to be repeated with selecting the Generic DTM in the list of available
DTMs.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Example
If the Osicoder EDS file has been placed at the location ... →Schneider Electric →
Generic CANopen Device DTM →EDS and after Install DTM action under Device
Repository, it now is possible to use a DTM to operate the Osicoder device.
The Generic CANopen Device DTM now plays the role of an Osicoder DTM.
In the following figure, you can see two alternative options to configure any Osicoder
device:
z The first line with string Osicoder represents a configuration window in legacy
style
z the second line with string Osicoder represents a DTM, whose functionality is
defined in the EDS file with name <EDS file name> + “.xml”
NOTE: In the Information area, check in the Name text that the selected device is
represented by a DTM.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
After inserting the device DTM based on the Generic DTM into the Device tree, it is
now possible to use a DTM to manage an Osicoder device:
NOTE: For further details, the online help of the Generic DTM can be used by
pressing the Help button in the Configuration window.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Hardwire Topology
Overview
You can also configure devices that are not connected to a controller fieldbus with
a DTM via a point-to-point connection over Modbus Serial Line using a specific cable
(TSXCUSB485) to connect the device to the PC. The configuration data of the
device will be part of the SoMachine project file.
Topology
The corresponding topology is described in Hardwire Topology (see page 92).
Step Action
1 Select the Program tab:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
4 Select the Modbus Serial Communication DTM.
5 In the Device Repository window, the selected DTM is now available.
Result: The Modbus serial communication DTM is now available for insertion
in the Device tree.
Step Action
1 In the Device tree, right click on the project, then select Add Device
Result: The list of available communication DTMs is displayed.
2 Select the Modbus Serial Communication DTM.
In the Device tree, the communication DTM is now installed.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
1 In the Device tree, right click on the communication DTM, then select Add
Device.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
1
In the Windows Taskbar, right-click on the Schneider Modbus Driver icon ,
then select Configure:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
2 Check the COM Port value (COM9 in the example shown below):
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Step Action
4 Select the Configuration tab:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
After configuration of the Modbus Serial Communication DTM, all online services of
the attached device DTM are available to start the configuration/commissioning of
the device. You can now right click on the device in the Device tree and
change/upload/download device parameters.
WARNING
LOSS OF COMMUNICATION
Be sure that the device parameters you intend to download are consistent with
those configured for your device, Modbus network, and application.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
FDT Options
Overview
Some configuration options are available in SoMachine to manage the behavior of
operating modes of the DTM.
Step Action
1 Select the Program tab
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Option Description
Open the default DTM function By double-clicking on the device in the Device tree
when the editor is opened z If checked: the DTM configuration tab is opened.
z If unchecked: only SoMachine standard tabs are opened.
Close all DTM functions when If checked: Close DTM when the SoMachine device editor is closed.
the editor is closed It is useful for special DTMs that have not OK or Cancel buttons.
Advanced settings Opens the second FDT Options window for advanced settings.
Advanced Settings
The following table describes the advanced settings of FDT Options:
Option Description
User management according to MUST be kept unchecked. This function is not supported.
FDT specification
Check for change DTM If selected, an automatic parameter download to those devices is performed before
parameters before application Login if parameters have been changed since the last download.
login This is useful to keep consistency, but it can result in longer execution time for Login
(depends on DTM).
Set DTMs offline after If selected, all DTMs are switched to offline mode after logout from controller.
application logout
Restrict DTM instance count to If selected (by default), limits the number of DTM instances open at a time on the
limit memory usage PC to the Maximum number of DTM instances parameter value (default value is
4, range from 1...10).
If not selected, the number of open DTM instances is not limited.
NOTE: The option setting will only be active after closing the current project.
NOTE: This option is used to reduce the consumption of PC memory and to avoid
the decrease of PC performance. Refer to the Check DTM instances command for
further information on currently open DTM instances checking and disposal.
Create temporary device When the Install DTM... button in the Device Repository window is executed, a
description files when updating device description file is created for every device supported by a DTM.
the catalog The file is available in a temporary folder and is deleted during SoMachine closing.
These device description files are dedicated to developers who want to use the
device description files as template for creating their own device description.
Verbose Mode Can be used by DTM developers for trouble shooting.
Show Popups for errors If selected, Pop-up messages are generated for detected error messages of DTMs.
reported by a DTM If not selected, these messages are only shown in the message window of
SoMachine.
Pop-ups always need to be confirmed by the user. This can slow down operation
(eg: for communication errors, if a device is not responding, a number of pop-up
messages can occur).
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Device Configuration
Overview
The CANopen manager is an obligatory node below the CAN bus node in a CAN
bus configuration. Below the CANopen manager you can add one or more CAN bus
devices to the device tree.
The CANopen manager and some CAN bus devices provide dialogs or functions for
configuration and maintenance of the devices.
Those dialogs or functions are available in the Device Configuration submenu
which is displayed by right-clicking the device node or the CANopen manager node.
The availability of dialogs or functions depends on the kind of device and the state
of the device. If a dialog or function is currently not available, then the menu item
appears dimmed.
NOTE: The CANopen manager supports only the menu items Import DTM and
Parameter download to all attached DTMs.... Both menu items are not supported
by any other CAN bus device
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Device Configuration with Device Type Manager (DTM)
The Dispose check box allows you to dispose the corresponding open
DTM instance in order to release some PC memory and opens another
DTM instance when the maximum number of DTM instances is
reached. Refer to the Restrict DTM instance count to limit memory
usage option for further information on the configuration of the number
of open DTM instances limitation.
NOTE: The DTM instance must be offline to be disposed.
Go online You can connect to the selected device if the device is offline.
Go offline You can disconnect from the selected device if the device is online.
Parameter Transfers stored parameters from the PC to all devices represented by
download to all DTMs.
attached DTMs... NOTE: This menu item is supported only by the CANopen manager.
Parameter Transfers stored parameters from the PC to the selected device.
download
Parameter upload Transfers current parameters from the selected device to the PC.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
EIO0000000067 10/2010
Program
7
What's in this Chapter?
This chapter contains the following sections:
Section Topic Page
7.1 General Information 130
7.2 Managing the Application Objects 133
7.3 Adding Devices 147
7.4 Managing the Libraries 158
7.5 Managing the Communication Ports 176
7.6 SoMachine Commands 195
7.7 SoMachine Controller-HMI Data Exchange 202
7.8 SoMachine Templates 212
7.9 Managing Device Templates 224
7.10 Managing Function Templates 234
7.11 Transferring and Running Applications 243
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The Program tab is only displayed after you have opened a SoMachine project.
It provides access to the CoDeSys programming environment. Any configuration
settings that were already performed in the Configuration tab are displayed in the
Devices view and can be modified, deleted and / or added here. Any changes
performed in this view will also be available in the Configuration tab.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
1 menu bar
2 toolbar
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Adding Tasks
Introduction
The Devices window allows you to add tasks to your application.
Procedure
Step Action
1 Right-click on the Task Configuration node and select Add Object....
2 On the left of the Add Object window, select Task.
3 Rename your task by typing a name in the field Name.
Note: The name must not contain any space nor exceed 32 characters long. If you
do not rename the device, a name is given by default.
Tip: Renaming the task may ease the organization of your project.
4 Click Open.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Introduction
The Devices window allows you to add POUs (Program Organization Units) to your
application.
The different types of POU are:
z Program: It returns one or several values during operation. All values are retained
from the last time the program was run until the next. It can be called by another
POU.
z Function Block: It provides one or more values during the processing of a
program. As opposed to a function, the values of the output variables and the
necessary internal variables shall persist from one execution of the function block
to the next. So invocation of a function block with the same arguments (input
parameters) need not always yield the same output values.
z Function: It yields exactly one data element (which can consist of several
elements, such as fields or structures) when it is processed. The call in textual
languages can occur as an operator in expressions.
NOTE:
Refer to CoDeSys online help:
z For more information on POUs.
z If you want to add POUs for implicit Check to your application.
Adding POUs
To add a POU to the application of the controller, proceed as follows:
Step Action
1 In the Devices view right-click the Application node of the controller and choose
Add Object...
2 In the Add Object dialog box select POU in the list.
3 Rename your POU by typing a name in the field Name.
Note: The name must neither contain any space nor exceed a length of 32
characters. If you do not rename the POU, a name is given by default.
Tip: Renaming the POU may ease the organization of your project.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
4 Select the type of POU you want:
z Program
z Function Block:
a. Select Extends and click on the browser to select the block function you want
in the Input Assistant.
b. Click the OK button.
c. Select Implements and click on the browser to select the interface you want
in the Input Assistant.
d. Click the OK button.
e. In the list box Method implementation language, select the programming
language you want for editing the function block.
z Function:
a. Click on the browser to select the return type you want in the Input Assistant.
b. Click the OK button.
5 In the list box Implementation Language, select the programming language you
want for editing your program.
6 Click the Open button.
Declaring POUs
At least 1 POU has to be declared in the task. To declare a POU in a task, proceed
as follows:
Step Action
1 Under the node Task Configuration of the controller, double-click on the task you
want to declare your POU.
2 In the POUs section of the configuration tab, click Add POU.
3 In the section Categories of the Input Assistant dialog box, select
Programs (Project).
4 Click to clear the check box Structured view.
5 In the Items panel, select the POU you want.
6 Click the OK button.
NOTE: Only the PTO/HSC variables declared in the POU are available in Vijeo-
Designer.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Adding Libraries
Introduction
The Devices window allows you to add libraries to your application by using the
Library Manager node. For adding standard SoMachine libraries, use the
placeholder concept. For adding libraries you created yourself, the placeholder
concept is not applicable.
WARNING
UNINTENDED EQUIPMENT OPERATION
z Verify that the SoMachine Libraries contained in your program are the correct
version after updating SoMachine software.
z Verify that the library versions updated are consistent with your application
specifications.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 Double-click the Library Manager node in the Devices window.
Result: The Library Manager editor opens, showing the libraries that are by default inserted with the
selected device.
2 In the editor click the Add library... link.
Result: The Add Library dialog box opens.
3 In the Add Library dialog box select the Placeholder tab.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
4 In the Placeholder tab configure the following:
z Select the Placeholder name from the list. The placeholder names are identical to the library names,
except of Schneider Electric libraries that are extended by the prefix SE_).
z Define the Default library by selecting the suitable library from the list. This setting only defines the
library type that will be inserted. The library version that will actually be used is defined by the device.
5 Click OK.
Result: The library will be added to the Library Manager, like for example SE_Standard = Standard,
33.3.1.10 (System).
NOTE: Please note that only those libraries defined in the Devices window require
the placeholder concept. The placeholder concept is not applicable for libraries you
define in the POU window.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Introduction
This section describes the different types of remanent variables and their character-
istics. It also shows you how to add and declare remanent variables in your
application.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Memory Mapping
The following table gives more information on memory for:
Device Refer to
Modicon M238 Logic Controller Memory mapping (see Modicon M238 Logic
Controller, Programming Guide)
Modicon M258 Logic Controller Memory mapping (see Modicon M258 Logic
Controller, Programming Guide)
Modicon LMC058 Motion Controller Memory mapping (see Modicon LMC058 Motion
Controller, Programming Guide)
Modicon ATV IMC Drive Controller Memory mapping (see ATV IMC Drive Controller,
Programming Guide)
XBTGC HMI Controller Memory mapping (see Magelis XBT GC HMI
Controller, Programming Guide)
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 Right-click the Application node of the controller, or the Application node of the
HMI, and choose Add Object...
2 In the Add Object window select Persistent Variables in the list and type a name
for this list.
3 Click Open.
Example:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Prerequisites
Variables that will be exchanged between the controller and (multiple) HMI devices
using the transparent SoMachine protocol (see SoMachine, Introduction) must be
published in the controller by means of the Symbol configuration. They will then
be available as SoMachine variables in Vijeo-Designer.
Step Action
1 Right-click the Application node of the controller and select the Add Object...
command.
Result: The Add Object dialog box will be displayed.
2 In the Add Object dialog box select the entry Symbol Configuration from the
list on the left-hand side.
3 Click Open.
Result: A Symbol configuration item is created under the Application node in
the Devices window. The Symbol configuration editor will be displayed on the
right-hand side.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Available Objects
The devices view also allows you to add the following objects to your application:
z CAM table is only available for SoftMotion devices for motion control in tabular
or textual form.
z Data Server establishes a point-to-point connection between the local
application and a remote data source (i.e. an OPC server).
z DataLogManager is used to create customer-specific log files on process or
machine status information.
z DUT is used to create your own data type.
z Global Variable List is used to declare global variables which will be available in
the whole application.
z Image Pool is the images repository for the project.
z Interface is used to organize methods which are used by function blocks. An
interface is a POU describing a collection of method-prototypes.
z POUs for implicit checks provide check functionality for array and range
boundaries, divisions by zero and pointers during runtime
z Relocation Table is an editor that allows you to work with the relocation table of
the system variables.
z Text List is used for multi-language support or dynamic text.
z Trace is used to configure and to display a sampling of the values of variables,
i.e. the online progression of the values read from the controller over a certain
time.
z Visualization allows you to create graphical representation of your system for
monitoring.
z Visualization Manager is used to handle some common settings for all
visualizations assigned to the current application
z Visualizationinstance allows you to create visualization instances.
For more information concerning these objects, refer to the CoDeSys part of the
online help.
Step Action
1 Click on the Application node of the controller, and choose Add Object...
2 In the Add Object window, select the object you want to add.
3 Click Open.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
You can monitor and analyze application data by examining the data log file (.log).
The figure shows an application that includes the 2 function blocks, LogRecord and
Dump. The LogRecord function block writes data to the buffer, which empties into
the data log file (.log) located into the controller’s memory. The buffer dumping is
automatic when 80% full or it can be forced by the Dump function. As a standard FTP
client, a PC can access this data log file when the controller acts as an FTP server.
It is also possible to upload the file from SoMachine or the controller’s web server.
NOTE: Only controllers with file management functionality can support data logging.
Refer to your controller’s programming manual to see if it has such functionality. The
software itself does not evaluate your controller for compatibility with data logging
activities.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Implementation Procedure
You must first declare and configure the data log files in your application before
starting to write your program.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Adding Controller
Introduction
When you add a controller to your project, several nodes are automatically added to
the Devices view. These subnodes are controller-specific, depending on the
functions the controller provides.
The following paragraph describes the general procedure of adding a controller. For
details on a specific controller, refer to the programming manual of this controller.
Procedure
To add a device to your SoMachine project in the Program tab, proceed as follows:
Step Action
1 Right-click on the project node and select the Add Device... command from the
context menu.
2 In the Add Device dialog box select Schneider Electric in the list box Vendor.
3 Choose the controller you want to insert into the project.
4 Rename your device by typing a name in the text box Name.
Note: The name must neither contain any space, nor exceed a length of 32
characters. If you do not rename the device, a name is given by default.
Tip: Renaming the device may ease the organization of your project.
5 Click the Add Device button.
Result: The device selected is added to the project and appears as a new node in
the Devices view. The Add Device window remains open. You can then:
z add another controller by going back to step 3, or
z click the Close button to return to the Program tab.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Introduction
In your project, you can add the following expansion modules to a controller:
WARNING
UNINTENDED EQUIPMENT OPERATION
z Only use software approved by Schneider Electric for use with this equipment.
z Update your application program every time you change the physical hardware
configuration.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 Click in the graphical configuration editor on the area Add Expa... of the device.
Result: The Add object dialog box opens, displaying only those expansion
modules that can be connected to the selected device like in the graphic below
for an M238 logic controller.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
2 Select the expansion module you want to add to the device from the list on the
left-hand side and click the Add and close button.
Result: The expansion module will be displayed in the graphical configuration
editor on the right-hand side of the device.
The expansion modules added to a device are displayed on the right side of the
device icon. You can hide or display them by clicking the small arrow above the Add
Expa... button. To configure them, double-click their icons.
NOTE: When you add a TWDNOI10M3 object, that is an AS-Interface Master
Module, the corresponding Virtual AS interface bus fieldbus manager will
automatically be inserted. To add AS-Interface slave modules, proceed as
described in the Adding Slave Devices to a Fieldbus Manager (see page 76)
paragraph above.
For more information about adding expansion modules refer to the following
Programming Guides of the controllers:
z XBTGC HMI Controller - Programming Guide
z M238 Logic Controller - Programming Guide
z M258 Logic Controller - Programming Guide for TM5 and PCI Expansion
Modules
z LMC058 Logic Controller - Programming Guide for TM5 and PCI Expansion
Modules
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
Communication managers are mandatory to activate and configure the controller’s
hardware bus interface, for example CANbus or Serial line.
2 types of communication managers exist:
z Fieldbus Managers which allow to configure fieldbus devices (for example
CANopen slaves or Modbus slaves)
z general communication managers
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 In the Devices window right-click the bus interface (Serial Line or CANbus) and
select Add Device... from the context menu.
Result: The Add Device dialog box will be displayed.
2 In the Add Device dialog box select <All vendors> from the list box Vendor.
Note: You can sort the devices by brand by clicking on the list box Vendor.
3 Select the Communication manager from the list below.
4 Rename your device by typing a name in the Name textbox.
Note: The name must not contain any space. If you do not rename the device, a
name is given by default.
5 Click the Add Device button.
6 Configure the Communication manager.
NOTE: You can only add 1 manager per interface (Serial line or CANbus).
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
You can add Modbus and CANopen field devices to the communication manager by
executing the Add Device command.
As a prerequisite the device must be available in the Device Repository (see the
CoDeSys part of the online help for details on how to import device descriptions, for
example importing CANopen EDS files into SoMachine).
Adding Devices
Step Action
1 Right-click the field device manager item (CANopen or Modbus manager) in the
Devices window and select Add Device... from the context menu.
Result: The Add Device dialog box will be displayed.
2 In the Add Device dialog box select <All vendors> from the list box Vendor.
Note: You can sort the devices by brand by clicking on the list box Vendor.
3 Select the device of your choice from the list below.
4 Rename your device by typing a name in the Name textbox.
Note: The name must not contain any space. If you do not rename the device, a
name is given by default.
Tip: Renaming the device may ease the organization of your project.
5 Click the Add Device button.
Result: The field device is added to the field device manager.
NOTE: The Add Device dialog box remains open.
You can now:
z add another device by going back to step 2
z click the Close button
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
WARNING
UNINTENDED EQUIPMENT OPERATION
z Use the g_aNetDiagnosis data structure within the application to monitor CAN
slave responses to configuration commands.
z Verify that the application does not start-up or put the machine or process in an
operational state, in the event of receiving SDO abort message(s) from any of
the CAN slaves.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
After adding the CanConfig Extern library to your application, use the Net
Diagnostic definition within your application to test for SDO abort messages from
the CAN slaves.
To help you better understand the use of the CAN diagnostic data structure, the
following code example is provided:
IF g_aNetDiagnosis[CAN_Net_Number].ctSDOErrorCounter = 0 THEN
(* No error is detected in the configuration*)
ELSE
(* An error has been detected during configuration. Get
the latest error information.*)
// node ID of the slave which sent the abort code
ReadLastErrorNodeID :=
g_aNetDiagnosis[CAN_Net_Number].usiNodeID;
// index used in the aborted SDO
ReadLastErrorIndex :=
g_aNetDiagnosis[CAN_Net_Number].wIndex;
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
It is also possible to add a new device using a device template. For a description of
this procedure refer to the Managing Device Templates section (see page 226).
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Content of Libraries
Libraries provide the following items that are executed in the runtime system of your
controller:
z functions and function blocks
z datatype definitions
z global variables
z system variables
z visualization objects
Managing Libraries
SoMachine manages libraries at 2 different locations:
Location Description
in the Library The Library Repository is the editor that manages libraries
Repository for your PC installed in SoMachine. The Library Repository allows you to
installation install or remove libraries. A library can be used in a SoMachine
project only if installed in the Library Repository. After the
installation of SoMachine, a set of libraries are installed by default.
You can install new libraries or new versions of existing libraries.
in the Library The Library Manager is the editor that manages libraries
Manager(s) in your declared in a project.
project
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The figure below shows the Library Manager in the POUs window and the Library
Manager in the Devices window on the left-hand side of the SoMachine PROGRAM
tab:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
For more information about library management, refer to CoDeSys online help:
Basic Concepts of CoDeSys / Library Management.
For more information about Library Repository, refer to CoDeSys online help:
Menu Commands / Installation / Library Repository.
For more information about Library Manager, refer to CoDeSys online help: Editors
/ Library Manager Editor.
In SoMachine, features embedded in libraries might be used for the automation as
well as for the system (internal). In both cases, libraries are managed with the
Library Manager of SoMachine.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The libraries are grouped in the following categories to provide a better overview:
z Application: libraries used in the automation applications
z Communication: libraries used for specific communication features
z Controller: libraries dedicated to SoMachine controllers
z Devices: libraries dedicated to distributed devices management (TeSys, Altivar,
Lexium)
z Intern: system libraries for SoMachine internal usage and controllers runtimes
z Miscellaneous: libraries not categorized
z Solution: libraries dedicated to applications solutions (Packaging, Hoisting,
Conveying)
z System: system libraries for SoMachine internal usage and controllers runtimes
z Target: platform-specific libraries
z Util: libraries providing additional utility functions
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Namespace
A library namespace is a symbol that allows the unique access to the attached
library components (functions, function blocks, variables…). The use of
namespaces is optional, but necessary if 2 components of 2 different libraries used
in the same project have the same name. The full name
<namespace>.<component> will then allow a unique access to the correct
component.
Case Description
1 There is a function block GEN in the library Util. The namespace of the library
Util is Util. An instance of the function block GEN can be declared with or
without the library namespace if the name GEN is unique within the project:
MyGenerator: Util.GEN;
or MyGenerator: GEN;
2 A function block GEN has been created within the project. The use of the library
Util namespace will allow the system to access the function block GEN of the
library Util. Without namespace, the project function block GEN will be
accessed:
MyGenerator_Util: Util.GEN;
MyGenerator_Project: GEN;
3 Another library, also containing a function block called GEN, is declared in the
project with namespace NewLib. The use of the namespace becomes
mandatory to identify the correct function block GEN to be accessed:
MyGenerator_Util: Util.GEN;
MyGenerato_NewLib: NewLib.GEN;
A default namespace is defined for each library. Schneider Electric libraries default
namespaces start with the prefix SE.
Default namespace of a library declared in a project can be customized in the library
Properties editor called from the Library Manager (In the Library Manager of a
project, right click on the library then select the Properties field).
Placeholder
Placeholder is a mechanism used to manage the compatibility between versions of
devices and versions of libraries.
When SoMachine or existing devices are upgraded or when new devices are
integrated, attached Device Description Files are installed. The Device Description
File contains the placeholders that define versions of libraries compatible with the
device version.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
WARNING
UNINTENDED EQUIPMENT OPERATION
z Verify the SoMachine libraries contained in your program are the correct version
after updating SoMachine software.
z Verify that the library versions updated are consistent with your application
specifications.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Introduction
All libraries from Schneider Electric are listed below.
NOTE:
USER column:
z YES: Functions and Function Blocks of the library can be used in the users
applications (program).
z NO: Intended only for specific system or administrative functions. Typically, these
functions and function blocks have no user documentation.
Category: (Miscellaneous)
The following table describes the library available in the (Miscellaneous) category:
Category: Communication
The following table describes the libraries available in the Communication
category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Category: Controller
The following table describes the libraries available in the Controller category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The following table describes the libraries available in the Controller →ATV IMC
category:
The following table describes the libraries available in the Controller →LMC058
category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The following table describes the libraries available in the Controller →M238
category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The following table describes the libraries available in the Controller →M258
category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The following table describes the libraries available in the Controller →XBTGC
category:
Category: Devices
The following table describes the libraries available in the Devices category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Category: Solution
The following table describes the libraries available in the Solution category:
Category: Util
The following table describes the libraries available in the Util category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Introduction
Libraries from companies other than Schneider Electric that are useful are listed
below.
NOTE:
USER column:
z YES: Functions and Function Blocks of the library can be used in the users
applications (program).
z NO: Libraries intended for specific system or administrative functions. Typically,
these functions and function blocks have no user documentation.
System Libraries
The following table describes the library available in the (Miscellaneous) category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The following table describes the libraries available in the Application →Common
category:
Libraries available in (Intern) category: some of these libraries are for internal
system use only.
The following table describes the libraries available in the System →SysLibs
category:
The following table describes the library available in the System →SysLibs23
category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
The following table describes the library available in the Intern →CAA category:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
SoMachine provides the possibility to save a SoMachine project file
(<projectname>.project) as a library file (<projectname>.library) and vice-versa. The
library file only includes the objects managed in the POUs window.
Procedure
To create your own library project via the Program tab, proceed as follows:
Step Action
1 The SoMachine Program tab provides 2 different ways to create a new library
project:
z Either by using the File →New menu and selecting the Empty Library
project template from the Categories →Basic Controllers.
z Or by using the File →Save project as... menu and selecting from the Save
as type list box the Library file type.
2 Fill in the mandatory fields in the File Project →Project information.
3 In your library project create your:
z functions and function blocks
z datatype definitions
z global variables
z visualization objects
z libraries
NOTE: Only the objects managed in the POUs window will be considered for a
library project.
NOTE: If you add standard SoMachine libraries to your own library, always use
placeholders to reference them. For details on referencing libraries by
placeholders refer to the Adding Libraries chapter (see page 137).
4 Execute the command File →Save project and install library into library
repository.
Result: Your library is now installed on your PC and can be added to any project
on your PC using the Library manager.
NOTE: For more detailed information refer to the CoDeSys part of the online help.
To check the syntax and find your potential errors, use the command Check all Pool
objects in the menu build, before using Save the project as a compiled library or
Save project and install library into library repository.
It is best to first code your logic in a regular project application and use the tools
available to debug your logic, such as breakpoints and inspection of data values.
Once a library is compiled, the logic can not be viewed or modified.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
Ethernet communications are possible via Ethernet IP and Modbus TCP slave
devices. Ethernet communications are only supported by M258 and ATV IMC
controllers.
Before you can establish an Ethernet connection you must physically connect your
controller. For detailed information on this hardware connection, refer to the
respective hardware manual.
Step Action
1 In the Devices window right-click the node Ethernet (Ethernet) that is provided as a sub node of your
M258 Logic Controller if it supports Ethernet communications and select the command Add Device...
from the context menu.
Result: The Add Device dialog box opens.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
2 In the Add Device dialog box select EthernetIP node to create an Ethernet IP slave device. Or select
the ModbusTCP Slave Device to create a Modbus TCP slave device.
Enter a Name and click the Add Device button.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 Add another device or click the Close button to close the dialog box.
Result: The Ethernet node in the Devices window now contains a sub node for Ethernet IP and / or
Modbus TCP with the name you entered.
4 Double-click the sub node and configure your Ethernet device in the editor on the right-hand side.
The figure below shows the configuration of a ModbusTCP slave device as an example:
For further information on the individual settings refer to the CoDeSys online help.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
For CANopen communications you must first define the transmission rate and
configure a CANopen master. The following paragraphs describe how to define the
transmission rate in the CANopen configuration dialog box and to create and
configure the CANopen Manager that serves as CANopen master using an M238
Logic Controller as an example.
Before you can establish a CANopen connection you must physically connect your
CANopen devices to your controller. For detailed information on this hardware
connection, refer to the hardware manual of your controller.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 In the Devices window double-click the entry CAN that is provided as a subitem of your M238 Logic
Controller if it is equipped with a CANopen interface.
Result: The tabbed configuration dialog box for CANopen communications will be displayed on the right-
hand side.
2 In the CANbus tab configure the transmission rate:
From the Baudrate list select the transmission rate of your CANopen connection, by default
250,000 bit/s.
To inhibit access to the NMT commands and Service data object (SDO) parameters, that are provided
in the Status tab of each device when you are logged in, while the controller is in RUN mode, select the
Online Bus Access check box.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 In the Devices window right-click the node CAN that is provided as a sub node of your M238 Logic
Controller and select the command Add Device... from the context menu:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
2 In the Add Device dialog box select the CANopen_Manager.
Adapt the default Name, if required, and click the Add Device button:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 The Add Device dialog box remains open. Click the Close button to close the dialog box.
Result: The CAN node in the Devices window now contains a CANopen Manager sub node.
4 To configure your CANopen device, double-click its entry in the Devices window.
Result: The configuration dialog box for CANopen devices, the so-called CANopen_Manager, will be
displayed on the right-hand side. When configuring the CANopen_Manager and the CANopen devices,
consider the hints on nodeguarding and heartbeat settings in the following paragraphs.
For adding a CANopen device, refer to the Adding Devices chapter (see page 147).
Nodeguarding Settings
The node Life time (Life time = Guard time x Life time factor) must be greater than
twice the task cycle time:
z Guard time > task cycle time
z Life time factor >= 2
Parameter Value
Guard time 200 ms
Life time factor 2 (1 is not allowed)
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Heartbeat Settings
The CANopen_Manager heartbeat producer time must be equal to or greater than
the task cycle. To avoid jitter, choose a producer time that is a multiple of the task
cycle:
z CANopen_Manager Producer time >= Task cycle time
The Node heartbeat consumer time must be greater than twice the
CANopen_Manager heartbeat producer time:
z Node Consumer time >= 2.5 x CANopen_Manager Producer time
The Node heartbeat producer time must be equal to or greater than the task cycle:
z Node Producer time >= Task cycle time
Parameter Value
CANopen_Manager Producer time 200 ms
Node Consumer time 500 ms
Node Producer time 200 ms
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
Depending on the controller you are using, you can configure either 1 or 2 serial line
interfaces.
You must first define the communication settings and configure a Protocol
Manager before you can add devices.
Before you can establish a connection you must physically connect your devices to
your controller. For detailed information on this hardware connection, refer to the
hardware manuals of your controller and connected devices.
Step Action
1 In the Devices window double-click the desired Serial Line subnode of your controller.
Result: The tabbed configuration dialog box for serial line communications will be displayed on the right-
hand side.
2 Configure the communication settings in the Configuration tab:
Note: The communication settings must be identical for each device connected.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Protocol Managers
For each serial line interface, one of the following Protocol Managers is required:
There is one Protocol Manager preconfigured for each serial line interface, but it
can be removed and configured according to your individual requirements.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 In the Devices window right-click the Serial Line nubnode and select the command Add Device from
the context menu.
Result: The Add Device dialog box will be displayed.
2
From the Add Device dialog box select the Protocol Manager that suits your requirements, adapt the
Name and click the Add Device button.
Result: The selected manager will now be displayed in the Devices window as a subnode of the Serial
Line / Serial Line 1 / Serial Line 2 node.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 To configure the Protocol Manager, double-click its entry in the Devices window.
Result: The tabbed configuration dialog box for the selected Protocol Manager will be displayed on the
right-hand side. For further information on configuring the individual Protocol Managers, refer to the
Programming Guide of your controller or to the CoDeSys part of the online help.
You can now add your devices as described in the Adding Devices to a
Communication Manager chapter (see page 154).
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
AS-Interface communications are only supported by M238 controllers.
To establish AS-Interface communications, you first have to add an AS-Interface
Master Module. Then you can add AS-Interface slave modules.
Step Action
1 In the Devices window right-click the node of your M238 controller (for example TM238LFDC24DT) and
select the command Add Device from the context menu.
Result: The Add Device dialog box will be displayed.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
2 In the Add Device dialog box expand the Communication Expansion Modules item and select the
entry TWDNOI10M3.
Adapt the default Name, if required, and click the Add Device button.
Result: The node of your controller now contains the AS-Interface Master Module as sub node
TWDNOI10M3 (TWDNOI10M3) →ASi_Master (ASi Master) in the Devices window.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 To configure your AS-Interface Master Module, double-click its entry in the Devices window.
Configure your AS-Interface Master Module in the editor on the right-hand side.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 Right-click the TWDNOI10M3 (TWDNOI10M3) →ASi_Master (ASi Master) node in the Devices
window and select the Add Device command from the context menu.
Result: The Add Device dialog box will be displayed.
2 Select an AS-Interface slave device from the list, adapt the default Name, if required, and click the Add
Device button.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 The Add Device dialog box remains open. Add another AS-Interface slave device, or click the Close
button to close the dialog box.
Result: The node of your controller now contains the AS-Interface slave device as a new sub node of
TWDNOI10M3 (TWDNOI10M3) →ASi_Master (ASi Master) in the Devices window.
4 To configure your AS-Interface slave device, double-click its entry in the Devices window.
Configure your AS-Interface slave device in the editor on the right-hand side.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The following specific SoMachine commands provide the possibility to manage the
controller as well as the HMI applications of a SoMachine project by a single mouse
click.
NOTE: See the Programming Guide for your controller for important safety-related
information concerning SoMachine commands.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The Build all command performs 2 operations:
z It compiles those controller applications that are located under the item PLC
Logic in the Devices tree.
z It builds all HMI target applications.
Procedure
Execute the Build all command as follows:
Step Action
1 From the Build menu select the command Build all.
Result: The applications are compiled and the HMI target applications are built.
This is indicated in the Messages window of SoMachine.
2 In the Messages window of SoMachine select Build from the list in the upper left
side of the window to see the results of the individual compile processes.
3 To display a summary of the messages that occurred during the execution of the
Build all command, select Vijeo-Designer from the list in the upper left side of
the window.
4 To verify the messages you can start Vijeo-Designer directly by double-clicking
the Vijeo-Designer message in the Messages window.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The Create boot application command in the Online menu provides the possibility
to create a controller application that is automatically started after it has been
downloaded from the SoMachine PC to the controller.
NOTE: This function is restricted to controller applications. HMI applications do not
support this feature.
Procedure
To create a boot application for your application, proceed as follows:
Step Action
1 In the Devices view select the Application node of the application you want to
create a boot application for.
2 From the Online menu select the command Create boot application.
Result: SoMachine will automatically build the application. If errors are detected
during the build process, they will be issued in the Messages pane. If the build
process is executed successfully, a Save as dialog box will be displayed.
3 In the Save as dialog box navigate to the folder where you want to save the boot
application and click the Save button.
Result: A message box will be displayed asking you whether you want to
overwrite the reference context of the last download.
4 Click Yes and the following files will be saved to the specified folder:
z Myapplication.App
z Myapplication.crc
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The USB Mass Storage... command in the Online menu provides the possibility to
save the file system image together with a file management script on a USB mass
storage device.
Step Action
1 Plug the USB mass storage device into a USB port of your PC running SoMachine.
2 From the Online menu select the command USB Mass Storage....
Result: SoMachine will automatically build the application. If errors are detected during the build
process, an error detection message will be issued and the process will be cancelled. If the build process
is executed successfully, the USB Mass Storage dialog box will be displayed.
3 In the USB Mass Storage dialog box click the plus sign to create a new row for a new command.
4 Select the commands for the script that will be executed on the controller from the Command list box or
select already available macros from the Macros list.
5 Select the source for the commands from the Source list box or click the ... button to navigate to the
folder that contains the source.
6 To change the Destination subfolder on the USB mass storage device, open the Destination list and
select the suitable folder.
7 To create the script, click the Generate button at the bottom or the gearwheel icon from the toolbar at
the top of the dialog box.
Result: A Browse For Folder dialog box opens.
8 Browse to the root directory of your USB mass storage device (do not open a subfolder) and click Open.
Result: The SoMachine project and the file management script are saved to the USB mass storage
device.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Log File
A log file is automatically saved in the folder of the script file.
It records every execution of the script file with header information (date, time, and
machine information) and the result (successful, or not successful like: source file
not available, incorrect destination, incorrect command, destination full).
Any new information is added to the file, information will not be overwritten.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The Import Vijeo-Designer project command provides the possibility to import an
already existing Vijeo-Designer project into an existing SoMachine project.
The Export Vijeo-Designer project command provides the possibility to export the
Vijeo-Designer project (that is the HMI applications) from an existing SoMachine
project.
NOTE: Note that the imported Vijeo-Designer project will replace the existing HMI
applications of the SoMachine project, if some.
Step Action
1 In SoMachine open the File menu and select the Import Vijeo-Designer
project... command.
Result: A browse dialog box will be displayed.
2 Browse to the folder that includes the Vijeo-Designer project you want to import,
select the VDZ file and click Open.
Result: The selected Vijeo-Designer project is merged with the already existing
SoMachine project.
Step Action
1 In SoMachine open the File menu and select the Export Vijeo-Designer
project... command.
Result: A browse dialog box will be displayed.
2 Browse to the folder where you want to save the exported VDZ file and click
Save.
Result: The extracted Vijeo-Designer project is saved as VDZ file and can be
opened with Vijeo-Designer.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
Sharing variables between a controller and the HMI is very simple in SoMachine. By
publishing the variable(s) in SoMachine they will automatically be available for use
in the Vijeo-Designer HMI application.
For variable exchange with the SoMachine protocol, perform the following steps:
z Create variables in the controller part.
z Publish the variables by defining them as Symbols in the controller part. They
are now available in the HMI part as SoMachine variables.
z Configure the physical connection (automatically setup by SoMachine).
NOTE: This step is not necessary for XBTGC controllers because they may
communicate with their own control variables or those on other controllers.
Step Action
1 In the general functions menu (see page 25) select Preferences and click the
Options button.
Result: The Options dialog box will be displayed.
2 Select the entry Vijeo-Designer from the list on the left-hand side.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 On the right-hand side, enable the check box Disable automatic symbol
export.
NOTE: Activating the Disable automatic symbol export function inhibits the
automatic export of SoMachine variables defined as Symbols to Vijeo-Designer. In
order to perform this transfer manually, right-click the Symbol configuration node
in the Devices window and execute the Export Symbols to Vijeo-Designer
command. If you do not perform this manual transfer, Vijeo-Designer may not show
the correct symbols which, in turn, may lead to errors in the project.
WARNING
UNINTENDED EQUIPMENT OPERATION
Before you start working in Vijeo-Designer and if you have activated the Disable
automatic symbol export, execute the Export Symbols to Vijeo-Designer
command.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Identifier Length
In Vijeo-Designer the maximum length of the variable name is limited to 32
characters.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Procedure
Publish variables in the controller part of the SoMachine application within the
Symbol configuration editor and define specific access rights (read/write, read,
write):
Step Action
1 Create a Symbol Configuration item under the Application node in the Devices window as described
in the Adding a Symbol Configuration chapter (see page 143).
2 In the Symbol configuration editor select those elementary variables that you wish to publish for
communication with 1 or several HMI terminal(s):
The left part of the editor window shows the variables that are currently available in the application. To
see all variables, open the subitems by clicking the plus signs. To provide variables to HMI terminals,
select individual variables or even complete nodes in the list on the left-hand side and click the arrow
button in the middle to copy them to the right side, that is to provide them to HMI terminals.
You can also assign read/write access rights to each variable individually in the Access Rights column.
Note: Only variables on elementary data types are available for interchange with HMI terminals.
3 For your settings to become valid click the Download link in the Symbol configuration editor.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Selecting Variables
In SoMachine 1.1 and later versions those variables that have been published in the
controller part are directly available in the HMI part.
In the Expression Editor Pad of Vijeo-Designer select the SoMachine tab to have
direct access to the variables published in SoMachine.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Procedure
To publish the above mentioned variable types proceed as follows:
Step Action
1 In the Vijeo-Designer Variable Editor select those variables you want to publish.
2 Right-click the selected variable(s) and execute the command Move to SoMachine from the context
menu.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 In the Move to SoMachine dialog box open the subfolders of the devices defined in SoMachine to see
the levels where variables are defined (POU or GVL).
4 Select the POU or GVL to which you want to add the selected Vijeo-Designer variable(s) and click OK.
Result: The selected variable(s) has / have been moved to the selected SoMachine POU or GVL and is
/ are available throughout the SoMachine project.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The runtime data exchange between the controller and the HMI is executed on
different media, depending on the selected hardware.
Configuration Example
The default settings below are valid for communications between M238 and an HMI
panel via serial line RS485 using an XBTZ9008 cable (serial line SubD-RJ45).
Configuration of M238 with HMI panel:
M238 controller serial line configuration
Parameter Value
Physical Medium RS485
Baud rate 115200
Parity none
Data bits 8
Stop bits 1
Parameter Value
Physical Medium RS485
Baud rate 115200
Parity none
Data bits 8
Stop bits 1
Equipment Name controller device name (available in the
communication settings dialog)
Configuration of XBTGC:
Device Configuration
XBTGC controller no configuration required
HMI panel IO-Manager
Driver SoMachine - Combo with at least 1 Scan-
Group
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
SoMachine provides templates in order to make dedicated control and visualization
functionality, that has been developed in one SoMachine project, easily available to
other SoMachine projects. They help to standardize the usage of I/O devices and
applications throughout different SoMachine projects.
The following types of templates are available:
z device templates that are associated with a single I/O device
z function templates that are associated with a high-level application function
SoMachine provides various templates, but you can also create your own templates
for any functionality you want to make available to other projects.
Step Action
1 Create your functionality within a SoMachine project and test it with the
appropriate hardware or in the simulation.
2 Save the functionality in a template library.
3 Open another SoMachine project and instantiate the template from the template
library in order to make the functionality available to this project.
General Notes
When using SoMachine templates, note the following:
z Templates are not controller-specific and can therefore be made available for any
controller. Make sure that the controller, to which you add the template, is
capable of executing the functionality contained in the template.
z After the template has been installed, you can freely adapt the created objects to
your individual requirements.
z The templates function does not support Vijeo-Designer applications. This
means that HMI applications are not included in the SoMachine templates.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
z It is possible to install one template several times on the same controller device.
In order to avoid naming conflicts when creating the same objects several times,
they are renamed automatically during installation. For further information refer
to the Naming of Objects section of the Adding Devices from Template chapter
(see page 227).
z User-defined data types (DUT) or function blocks must be defined in a function
block library if they should be used in templates.
z Templates do not support the use of direct representations of variables (for
example %IX2.0) in templates.
But you can, on the other hand, use direct representations with an incomplete
address specification (for example %I*) in a template. For further information
refer to the Variables configuration - VAR_CONFIG section of the CoDeSys
online help.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Supported Fieldbusses
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
SoMachine templates are stored in template libraries. Each template library
contains the definition for several device or function templates that have a common
base (for example are all related to motor control). The following paragraphs
describe the process of selecting those template libraries that should be available in
your project.
Procedure
To select the SoMachine templates that should be available for a specific project,
proceed as follows:
Step Action
1 From the Project menu select the command Project Settings.
Result: The Project Settings dialog box will be displayed.
2 In the Project Settings dialog box select the option Template Libraries from the list on the left-hand
side.
Result: The Template Libraries view will be displayed on the right-hand side:
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
3 The Template Libraries view provides the following options:
z You can either activate all available template libraries for your project by activating the checkbox Use
All Installed Template Libraries. This is the default setting for any new projects.
z Or you can select specific template libraries, that is the device or function templates they include, from
the Selected Template Libraries list.
NOTE: With the latter option it is neither possible to save new device or function templates into those
template libraries that are not selected nor to use device templates or function templates from not
selected template libraries for creating new field devices.
4 Click OK to activate the selected template libraries for your project.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The following paragraphs provide an overview of how to create new or change
existing device or function templates and to save them as file for transferring them
to other PCs.
Template Libraries
Template libraries contain the definition of several device or function templates.
Write Protection
The following template libraries are write-protected, which means that they cannot
be deleted or renamed:
z the standard template libraries that are included in the SoMachine scope of
delivery
z template libraries that are installed in the Template Repository
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Template Administration
For administration of the available device and function templates in SoMachine,
select Tools →Template Repository.
The Template Repository dialog box opens:
The path to the directory where the template libraries are stored is displayed below
the Location field.
The Installed Templates box lists the installed templates in 2 groups: Device
Templates and Function Templates. Each template library can either contain
device templates or function templates.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 Click the Install button in the Template Repository dialog box.
Result: A File open dialog box opens.
2 Browse to the folder where the template library file you want to install is saved.
3 Select the library file you want to install and click OK.
Result: The selected template library will be installed and will be indicated in the
Template Repository dialog box, including the device or function templates it
contains.
Step Action
1 In the Installed Templates list of the Template Repository dialog box, select
the template library (device or function template) you want to remove.
2 To remove the selected template library (device or function template), click the
Uninstall button.
Result: The selected template library (device or function template) will be
removed from the installation.
Step Action
1 In the Installed Templates list of the Template Repository dialog box, select
the template library (device or function template) you want to rename.
2 Click on the name you want to change.
Result: A text box opens.
3 Enter the new name in the text box and press Enter or leave the text box.
Result: The template library (device or function template) is now assigned the
new name.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 To create a new template library for device templates, select the Device
Templates node in the Installed Templates list and click the Create Library
button of the Template Repository dialog box.
Result: A new template library with a default name is added at the bottom of the
Device Templates section of the Installed Templates list.
To create a new template library for function templates, select the Function
Templates node in the Installed Templates list and click the Create Library
button of the Template Repository dialog box.
Result: A new template library with a default name is added at the bottom of the
Function Templates section of the Installed Templates list.
2 Rename the new template library as stated above and fill it with device or
function templates by using for example the copy and paste operations
described below.
Step Action
1 Select the template library you want to export in the Installed Templates list.
2 Click the Save As File... button.
3 In the Save File dialog box navigate to the folder where you want to save the
template library file.
4 Transfer the template library file to the other PC and install it by using the
Template Repository.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
This new template library will automatically be inserted below the correct node. This
means that template libraries that include device templates will automatically be
inserted below the Device Templates node while template libraries including
function templates will automatically be inserted below the Function Templates
node.
Replace the default name by a name of your choice.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
Device templates are always related to a specific fieldbus device. They contain the
following information:
z fieldbus device configuration
z device logic (controller programming) (optional)
z visualization elements (visualization programming) (optional)
The device templates you want to use must be available and enabled in the
Template Repository of SoMachine. For details refer to the Administration of
SoMachine Templates chapter (see page 219).
You can create your own device templates from your project. For details refer to the
Steps to Create a Device Template chapter (see page 230).
Step Action
1 In the Devices window right-click the I/O device manager and select Add
Device from Template from the context menu.
Result: The Add Device From Template dialog box will be displayed.
2 In the Add Device From Template dialog box select the Device Template to be
used, and set the Device Name as well as the Device Address if the fieldbus
requires numerical addresses.
In case the device templates includes logic, select the program (POU) in which
the logic will be inserted.
3 Click on the OK button.
Result: The device will be created and parametrized according to the selected
device template including the optional visualization screen(s) and logic.
NOTE: The undo / redo function is not available for the process of creating I/O
devices.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Naming of Objects
In order to avoid naming conflicts if the same device template is used as a basis for
creating different I/O devices, the following naming conventions are applied to the
I/O devices and the associated objects (FB, visualization and variables):
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The following paragraphs list
z the criteria that must be fulfilled in order to save an I/O device, including logic and
visualization, as device template
z the information that is saved in the device template
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
Each device template can be associated with 1 or more CoDeSys visualizations.
The supported kinds of visualizations are described in the following.
Supported Visualizations
SoMachine supports the following kinds of visualizations:
z visualizations with frame (recommended)
z visualizations without frame
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The following paragraphs list the steps that have to be performed in order to save
I/O devices meeting the criteria stated in Creating a Device Template on the Basis
of I/O Devices (see page 228).
Step Action
1 Right-click the I/O device you want to save as device template in the Devices
view of SoMachine.
2 Select the command Save As Template from the context menu.
Result: SoMachine automatically builds the application. After the built process
has been successfully completed, the Save as Template dialog box will be
displayed.
3 Define the new device template in the Save as Template dialog box as stated
below.
4 Click OK to close the Save as Template dialog box and to create your new
device template.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
1 the type of the I/O device on which the device template is based
2 the fieldbus type of the I/O device
3 the name of the device template that will be created (initially the name of the original I/O
device)
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 In the Save as Template dialog box click the ... button right to the Template
Library text box.
Result: The Select Template Library dialog box will be displayed.
2 The Select Template Library dialog box displays all template libraries that have
been installed for the current project or have been created. Write-protected
template libraries are not displayed.
To add the new device template to 1 of these template libraries, select the
suitable entry and click OK.
Step Action
1 In the Save as Template dialog box click the ... button right to the Function
Blocks text box.
Result: The Select Function Block dialog box will be displayed.
2 The Select Function Block dialog box displays those function block instances
of the I/O device that meet the following requirements for template creation:
z The function block must be linked to the I/O device.
z The function block must be located in a program that is in fact executed
(added to a task or called by another program).
NOTE: It is recommended that the function block is only called once. Otherwise
problems may occur detecting the correct call to be included in the template.
Furthermore the function block type must be defined in a library.
The function block is linked to the I/O device if a function block parameter
z is connected with a variable that is used in the I/O mapping of the I/O device.
z is connected with a predefined global variable (for example Axis_Ref) of the I/O
device.
The following parameters will be saved in the template:
z constants
z all variables that are linked to the I/O device
z those variables that are not linked to the I/O device but are defined in a POU
NOTE: Variables that are defined in the GVL are not saved in the template.
NOTE: Expressions are not saved in the template.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 In the Save as Template dialog box click the ... button right to the Visualizations
text box.
Result: The Select Visualizations dialog box will be displayed.
2 The Select Visualizations dialog box displays those visualizations that are
linked with the I/O device or with one of the selected function blocks.
The visualization is linked to the I/O device if 1 property of the visualization uses
a variable that is used in the I/O mapping of the I/O device.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
NOTE: Please note that any HMI elements related to CoDeSys are not supported
by this function.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Procedure
To add an application function from a function template to your project, proceed as
follows:
Step Action
1 Right-click the Application node in the Devices view and select the command
Add Function From Template from the context menu.
Result: The Add Function From Template dialog box will be displayed.
2 Enter a Function Name that will be used for the new folder of this application
and for the naming of the elements it contains.
3 Click the ... button and select a function template from the Select Function
Template dialog box.
4 If the function template contains I/O devices, the I/O Devices list contains the
following information:
z Device Name: This cell contains the name of the future I/O device. You
cannot change this name.
z Device Type: This cell indicates the type of the I/O device. You cannot edit
this cell.
z Fieldbus Type: This cell indicates the fieldbus type of the I/O device. You
cannot edit this cell.
z Master: This cell contains the fieldbus master to which the I/O device is
connected. If there are several masters, you can select the master of your
choice from the list.
z Address: This cell is initially empty. For I/O devices on fieldbusses that
require numerical addresses (Modbus serial line and CANopen) click the ...
button right to the field and assign the address of your choice.
Confirm your settings by clicking the OK button.
Result: SoMachine verifies whether the settings are correct and inserts the new
application function as separate folder in the Devices view or displays an error
detection message.
Objects Created
The function template creates the following objects in your project:
Object Description
root folder A new folder is created under the Application node in the Devices view
that is named as defined in the Function Name text box.
I/O devices The I/O devices that are included in the function template are created
using names that apply to the naming rules and are connected to the
fieldbus master. The I/O mapping is automatically adjusted, if
necessary.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Object Description
visualizations The visualizations that are included in the function template are created
below the root folder using names that apply to the naming rules. The
properties of the visualization are automatically adjusted.
programs The programs that are included in the function template are created
below the root folder using names that apply to the naming rules. The
names of those objects in the program that are part of the function
template will be adjusted automatically.
traces The traces that are included in the function template are created below
the root folder using names that apply to the naming rules and can be
used to trace variables belonging to the application function.
CAM tables The CAM tables that are included in the function template are created
below the root folder using names that apply to the naming rules. They
are only required if the application function includes SoftMotion devices.
task configuration The task configuration is adjusted as required by the function template.
global variable lists The global variable lists that are included in the function template are
created below the root folder using names that apply to the naming
rules.
external variables Global variables whose global variable lists do not belong to the function
template are restored in their original global variable list as follows:
z If a global variable list with the original name does not already exist
below the application it will be created automatically.
z If a global variable with the original name does not already exist in
this global variable list, it will be created automatically.
If the type of global variable is not correct, SoMachine will issue an error
detection message.
persistent Persistent variables are restored in the respective variable list of the
variables application as follows:
z If a persistent variable list does not already exist below the
application it will be created automatically with its original name.
z If a variable with the original name does not already exist in the
persistent variable list, it will be created automatically.
If the type of persistent variable is not correct, SoMachine will issue an
error detection message.
Any objects that are created with the instantiation of the function template are listed
in the Messages pane.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Naming of Objects
In order to avoid naming conflicts if you instantiate the same function template
several times on the same controller device, the following naming conventions are
applied to the application functions and the associated objects:
NOTE: Use rather short names for your application functions so that they are
completely displayed.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The following paragraphs list
z the criteria that must be fulfilled in order to save an application function with its
associated I/O devices and visualizations as function template
z the information that is saved in the function template
Otherwise they will not be considered when executing the Build command.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
z all global variables whose variable lists are not part of the function template but
which are used by any program or visualization that is part of the function
template
z all persistent variables that are used by any program or visualization that is part
of the function template
NOTE: Any other object types are not saved in the function template (even if they
are saved in the application function folder). Only use function blocks and data types
that are stored in a library.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Overview
The following paragraphs list the steps that have to be performed in order to save
already available application functions that meet the criteria stated in Application
Functions as Basis for Function Templates (see page 239) as function templates.
Procedure
To save an already available application function as function template, proceed as
follows:
Step Action
1 Right-click the folder that contains your application function in the Devices view.
2 Select the command Save As Function Template from the context menu.
Result: The Save as Function Template dialog box will be displayed.
3 Assign a Template Name and a Template Library as stated below.
4 Click OK to close the Save as Function Template dialog box and to create your
new function template.
Result: SoMachine verifies that the function template can be created and
displays a message that the function template has been created successfully or
issues messages indicating the detected errors.
Step Action
1 In the Save as Function Template dialog box click on the ... button next to the
Template Library text box.
Result: The Select Template Library dialog box will be displayed.
2 The Select Template Library dialog box displays all template libraries that have
been installed for the current project or have been created. Write-protected
libraries are not displayed.
To add your new function template to one of these template libraries, select the
suitable entry and click OK.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 In the Save as Function Template dialog box click the ... button right to the
Template Name text box.
2 Browse to the already available function template you want to replace.
3 Select the function template you want to replace.
Result: The name of this function template will be inserted in the Template
Name text box and the name of the template library where it is stored in is
inserted in the Template Library text box.
4 Click OK to close the Save as Function Template dialog box and to replace the
selected Function Template with the new application function.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Transferring Applications
Introduction
To run an application, you must first connect the PC to the controller, then transfer
the application to the controller.
Transferring a project allows you to copy the current project from SoMachine to the
controller memory.
NOTE: Due to memory size limitation, some controllers are not able to store the
application source but only a built application that is executed. This means that you
are not able to upload the application source from the controller to a PC.
WARNING
UNINTENDED EQUIPMENT OPERATION
Whenever you login to your controller, ensure the following:
z The software application being downloaded must be installed on the intended
device. Confirm you have entered the correct device designation or device
address.
z Guards must be in place so that unintended equipment operation will not cause
injury to personnel or damage to equipment.
z You must have read and understood the user documentation of the software
and devices involved and must know how to operate the equipment.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
Preconditions
Your application must fulfill the following conditions before transferring it to the
controller:
z the active path must be set for the controller,
z the application you want to transfer must be active,
z the application must be free from compilation errors.
Boot Application
The Boot Application is the application that will be launched on controller start. This
application is stored in the controller memory. To configure the download of the boot
application, right-click the Application node in the Devices view and select the
Properties command. A
t the end of a successful transfer of a new application, a message is displayed
asking you if you want to create the boot application.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Operating Modes
The transfer method differs depending on the relationship between the loaded
application and the application you want to transfer. The 3 cases are:
z Case 1: The application in the controller is the same as the one you want to load.
In this case, no transfer occurs, you just connect SoMachine to the controller
z Case 2: You made modifications of the application that is loaded in the controller.
In this case you can specify if you want to transfer all or parts of the modified
application or keep the application in the controller as it is.
z Case 3: The controller application is different to the one you want to load. In this
case, you must specify if you want to connect the loaded application or if you want
to load the new one.
Step Action
1 To connect to the controller, select Online →Login to
’Application[YourApplicationName; Plc Logic]’.
2 You are connected to the controller.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 To connect to the controller, select Online →Login to ’Application[YourApplicationName; Plc
Logic]’.
2 In case you modified your application and you want to reload it into the controller, the following message
appears:
Login with online change only the modified parts of an already running project will be re-loaded to the
controller.
Login with download the whole modified application will be re-loaded to the controller.
Login without any change the modifications are not loaded.
Select what you want to do, click OK.
NOTE: See the Programming Guide for your controller for important safety-related
information concerning the downloading of applications.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Step Action
1 To connect to the controller, select Online →Login to ’Application[YourApplicationName; Plc
Logic]’.
2 In case you want to load a different application than the one currently in the controller, the following
message appears:
To download the new application to the controller, click OK otherwise, click Cancel.
NOTE: See the Programming Guide for your controller for important safety-related
information concerning the downloading of applications.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Program
Running Applications
Introduction
This part shows how to start/stop an application.
Status Description
0 Stop the application. RUN command in SoMachine is not possible.
Rising Edge Start the application.
1 The application runs. RUN/STOP command in SoMachine is possible.
Refer to the manual of your controller to find out whether it supports this function.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
EIO0000000067 10/2010
Commissioning
8
What's in this Chapter?
This chapter contains the following topics:
Topic Page
General Description of the Commissioning Tab 250
Description of the Login/Logout Task 253
Description of the Multiple Download Task 255
Description of the Source Download Task 257
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Overview
The Commissioning tab is only displayed after you have opened a SoMachine
project.
It consists of a graphical configuration editor, like the Configuration tab
(see page 62), but it only provides functions that are required for commissioning a
machine:
z entering last parameters
z viewing online status
z logging into the machine
z downloading to and from the devices
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
The online status information is displayed in the information pane for the device
selected in the graphical configuration editor.
Result: The Parameters configuration screen will be displayed for the selected
device (see page 70).
To edit communication parameters for commissioning the machine
z double-click the network connection line in the graphical configuration editor or
z right-click the network connection line and select Edit parameters from the
context menu.
Result: The network configuration screen will be displayed for the selected network
connection (see page 84).
NOTE: See the Programming Guide for your controller for important safety-related
information concerning the editing of device and communication parameters.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Overview
The Login/Logout task allows you to establish a connection between your PC
running SoMachine and a connected device for uploading / downloading software.
Before you can establish this connection you must physically connect your device to
your PC. For detailed information on this hardware connection, refer to the hardware
manual of your device.
WARNING
UNINTENDED EQUIPMENT OPERATION
Whenever you login to your controller, ensure the following:
z Confirm you have entered the correct device designation or device address.
z Guards must be in place so that unintended equipment operation will not cause
injury to personnel or damage to equipment.
z You must have read and understood the user documentation of the software
and devices involved and must know how to operate the equipment.
Failure to follow these instructions can result in death, serious injury, or
equipment damage.
The login procedure differs depending on whether your project consists of only 1 or
of several applications.
Step Action
1 In the Commissioning tab click the Login/Logout button from the task
selection pane.
Result: After successful login, the information line at the bottom of each device
icon will indicate the status of the device using different colors (for example,
Stop is indicated in red).
To log out, click the Login/Logout button in the task selection pane once again.
Result: After successful logout, the information line at the bottom of each device
icon will get the status not logged in or N/A with color yellow.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Login Procedure with Project Consisting of Several Controllers, Each with 1 Application
For login to a connected device, proceed as follows:
Step Action
1 In the Commissioning tab click the Login/Logout button from the task
selection pane.
Result: The Login/Logout Applications dialog box will be displayed.
2 In the Login/Logout Applications dialog box select the application you want to
login and click the OK button.
Result: After successful login, the information line at the bottom of each device
icon will indicate the status of the device using different colors (for example,
Stop is indicated in red).
To log out, click the Login/Logout button in the task selection pane once again,
deselect the selected applications, and click the Close button.
Result: After successful logout, the information line at the bottom of each device
icon will get the status not logged in or N/A with color yellow.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Overview
For the Multiple Download operation you must specify 2 settings:
z Select the applications of the project to be downloaded.
z Specify online change options and additional settings.
NOTE: All physical targets (selected applications’ associated controllers and HMIs)
must be connected to the PC.
Procedure
Execute the Multiple Download task as follows:
Step Action
1 In the Commissioning tab click the Multiple download button from the task selection pane.
Result: The Multiple Download dialog box will be displayed.
2 In the Please select the applications for download section check each application you want to
download the new source project to.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Step Action
3 Select the Online change options that suit your application. For further details refer to the CoDeSys
part of the online help.
4 Select the Additional operations options that suit your application. For further details refer to the
CoDeSys part of the online help.
5 Click the OK button to start the download process.
Result: A Multiple Download - Result message box will be displayed indicating for each application if
the download process has been successfully completed.
NOTE: See the Programming Guide for your controller for important safety-related
information concerning the Multiple Download feature.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Overview
The Source Download task allows you to download an archived version of a
SoMachine project from your PC to a connected controller.
NOTE: Please note that an additional memory card must be available on the
controller to use this function. It is thus only available for ATV IMC and M258
controllers as well as for those XBTGC types that can use a USB flash drive as
secondary storage. XBTGT/GK controllers can use the CF card as secondary
storage for source download with SoMachine 2.0.
Procedure
To download a SoMachine project to your controller, proceed as follows:
Step Action
1 Login to the controller you want to download the SoMachine project to, as described in the Description
of the Login / Logout Task chapter (see page 253).
2 Click the Source Download button from the task selection pane.
Result: A project archive of the currently open project is automatically created and downloaded to the
controller.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Commissioning
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Report
EIO0000000067 10/2010
Report
9
Report
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Report
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Report
Printing a Report
To print out your report, proceed as follows:
Step Action
1 Click Print Preview to have a view of the items you have selected.
Result: A Print Preview is generated. To page up or page down in your preview,
click on the right side of the page number displayed in the task bar of the Print
Preview box.
2 Click Print to start printing.
Result: A Windows dialog box for Print opens.
Select your settings and click OK to start printing.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Report
1 The upper part of the work area provides options to customize your report.
2 The lower part of the work area shows a preview of the page configuration. The boxes
around the preview allow you to place information in the report.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Report
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Report
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Troubleshooting and FAQ
EIO0000000067 10/2010
III
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Troubleshooting and FAQ
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Generic - Troubleshooting and FAQ
EIO0000000067 10/2010
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Generic - Troubleshooting and FAQ
Overview
The menus and shortcuts of the SoMachine software differ depending on the actual
position, that is the window or editor that is currently open.
The menus and shortcuts of the SoMachine graphical user interface are optimized
for SoMachine but you can adapt them to your individual preferences or you can
load the CoDeSys standard shortcuts and menus.
Step Action
1 Execute the Customize command from the Tools menu.
Result: The Customize dialog box will be displayed.
2 In the Customize dialog box click the Load button.
Result: The Load Menu dialog box will be displayed.
3 In the Load Menu dialog box navigate to the folder ...\Program Files\Schneider
Electric\SoMachine\CoDeSys\Settings, select the file Standard.opt.menu and
click Open.
Result: The Customize dialog box now shows the standard SoMachine
settings.
4 To load these standard settings to the SoMachine graphical user interface, click
OK.
Step Action
1 Execute the Customize command from the Tools menu.
Result: The Customize dialog box will be displayed.
2 In the Customize dialog box click the Load button.
Result: The Load Menu dialog box will be displayed.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Generic - Troubleshooting and FAQ
Step Action
3 In the Load Menu dialog box navigate to the folder ...\Program Files\Schneider
Electric\SoMachine\CoDeSys\Settings, select the file
CoDeSysStandard.opt.menu and click Open.
Result: The Customize dialog box now shows the CoDeSys settings.
4 To load these CoDeSys settings to the SoMachine graphical user interface, click
OK.
NOTE: The menus and shortcuts of the SoMachine software differ, depending on
the window or editor that is currently open.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Generic - Troubleshooting and FAQ
Overview
This section provides instructions on enabling analog inputs according to the
CANopen standard by setting the SDO (Service Data Object) 6423 to the value 1.
Procedure
Step Action
1 Double-click the entry of your analog CANopen device in the Devices window.
2 In the CANopen Remote Device tab, enable the option Enable Expert PDO Settings.
Result: Additional tabs are displayed and the Service Data Object tab is populated with information.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Generic - Troubleshooting and FAQ
Step Action
3 Open the Service Data Object tab and click New.
Result: The Select item from object directory dialog box is displayed.
4 From the list of objects, select object 6423, enter 1 as Value and click OK.
Result: Analog input transmission on the CANopen bus is activated. You can now configure parameters
of the analog values as described in the hardware manual of your device.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Generic - Troubleshooting and FAQ
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
EIO0000000067 10/2010
Glossary
0-9
%I
According to the IEC standard, %I represents an input bit (for example a language
object of type digital IN).
%IW
According to the IEC standard, %IW represents an input word register (for example
a language object of type analog IN).
%MW
According to the IEC standard, %MW represents a memory word register (for
example a language object of type memory word).
%Q
According to the IEC standard, %Q represents an output bit (for example a language
object of type digital OUT).
%QW
According to the IEC standard, %QW represents an output word register (for
example a language object of type analog OUT).
1-phase counter
A 1-phase counter uses 1 hardware input as counter input. It usually counts up or
counts down when there is pulse signal in the input.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
2-phase counter
A 2-phase counter uses the phase difference between 2 input counter signals to
count up or count down.
AFB
application function block
analog input
An analog input module contains circuits that convert an analog DC input signal to
a digital value that can be manipulated by the processor. By implication, the analog
input is usually direct. That means a data table value directly reflects the analog
signal value.
analog output
An analog output module contains circuits that transmit an analog DC signal
proportional to a digital value input to the module from the processor. By implication,
these analog outputs are usually direct. That means a data table value directly
controls the analog signal value.
application source
The application source file can be uploaded to the PC to reopen a SoMachine
project. This source file can support a full SoMachine project (for example, one that
includes HMI application).
ARP
The address resolution protocol is the IP network layer protocol for Ethernet that
maps an IP address to a MAC (hardware) address.
ARRAY
An ARRAY is a table containing elements of a single type. The syntax is as follows:
ARRAY [<limits>] OF <Type>
Example 1: ARRAY [1..2] OF BOOL is a 1-dimensional table with 2 elements of
type BOOL.
Example 2: ARRAY [1..10, 1..20] OF INT is a 2-dimensional table with 10x20
elements of type INT.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
ARW
anti-reset windup
ASCII
The american standard code for information interchange is a communication
protocol for representing alphanumeric characters (letters, numbers, and certain
graphic and control characters).
assigned variable
A variable is "assigned" if its location in controller memory can be known. For
example, the Water_pressure variable is said to be assigned through its
association with memory location %MW102.Water_pressure.
ATC
analog tension control
ATV
ATV is the model prefix for Altivar drives. (For example, “ATV312” refers to the
Altivar 312 variable speed drive.)
AWG
The american wire gauge standard specifies wire gauges in North America.
BCD
The binary coded decimal format represents decimal numbers between 0 and 9 with
a set of 4 bits (a nybble/nibble, also titled as Halfbyte). In this format, the 4 bits used
to encode decimal numbers have an unused range of combinations. For example,
the number 2,450 is encoded as 0010 0100 0101 0000
BOOL
A Boolean type is the basic data type in computing. A BOOL variable can have one
of these values: 0 (FALSE), 1 (TRUE). A bit that is extracted from a word is of type
BOOL, for example: %MW10.4 is a fifth bit a memory word number 10.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
Boot application
Files that contain machine dependent parameters:
z machine name
z device name or IP address
z Modbus Serial Line address
z Routing table
BOOTP
The bootstrap protocol is a UDP network protocol that can be used by a network
client to automatically obtain an IP address (and possibly other data) from a server.
The client identifies itself to the server using the client MAC address. The server—
which maintains a pre-configured table of client device MAC addresses and
associated IP addresses—sends the client its pre-configured IP address. BOOTP
was originally used as a method that enabled diskless hosts to be remotely booted
over a network. The BOOTP process assigns an infinite lease of an IP address. The
BOOTP service utilizes UDP ports 67 and 68.
bps
bit per second as a definition of transmission rate, also given in conjunction with
multiplicator kilo (kbps) and mega (mbps).
BSH
BSH is a Lexium servo motor from Schneider Electric.
bus base
A bus base is a mounting device that is designed to seat an electronic module on a
DIN rail and connect it to the TM5 bus for M258 and LMC058 controllers. Each base
bus extends the TM5 data and to the power buses and the 24 Vdc I/O power
segment. The electronic modules are added to the TM5 system through their
insertion on the base bus. The base bus also supplies the articulation point for the
terminal blocks.
BYTE
When 8 bits are grouped together, they are called a BYTE. You can enter a BYTE
either in binary mode or in base 8. The BYTE type is encoded in an 8-bit format that
ranges from 16#00 to 16#FF (in hexadecimal format).
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
CAN
The controller area network protocol (ISO 11898) for serial bus networks is designed
for the interconnection of smart devices (from multiple manufacturers) in smart
systems for real-time industrial applications. CAN multi-master systems ensure high
data integrity through the implementation of broadcast messaging and advanced
diagnostic mechanisms. Originally developed for use in automobiles, CAN is now
used in a variety of industrial automation control environments.
CANmotion
CANmotion is a CANopen-based motion bus with an additional mechanism that
provides synchronization between the motion controller and the drives.
CANopen
CANopen is an open industry-standard communication protocol and device profile
specification.
CFC
The continuous function chart (an extension of the IEC61131-3 standard) is a
graphical programming language that works like a flowchart. By adding simple logic
blocks (AND, OR, etc.), each function or function block in the program is
represented in this graphical format. For each block, the inputs are on the left and
the outputs on the right. Block outputs can be linked to inputs of other blocks in order
to create complex expressions.
CiA
CAN in automation is a non-profit group of manufacturers and users dedicated to
developing and supporting CAN-based higher layer protocols.
CIP
When the common industrial protocol is implemented in a network application layer,
it can communicate seamlessly with other CIP-based networks without regard to the
protocol. For example, the implementation of CIP in the application layer of an
Ethernet TCP/IP network creates an EtherNet/IP environment. Similarly, CIP in the
application layer of a CAN network creates a DeviceNet environment. In that case,
devices on the EtherNet/IP network can communicate with devices on the
DeviceNet network through CIP bridges or routers.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
CMU
The current measurement unit is used to convert the relative current value (%)
provided by TeSys into a real ISO value (A).
configuration
The configuration includes the arrangement and interconnection of hardware
components within a system and the hardware and software selections that
determine the operating characteristics of the system.
controller
A controller (or “programmable logic controller,” or “programmable controller”) is
used to automate industrial processes.
CPDM
controller power distribution module
CRC
A network message's cyclic redundancy check field contains a small number of bits
that produce a checksum. The message is calculated by the transmitter according
to the message’s content. Receiving nodes then recalculate the field. Any
discrepancy in the two CRC fields indicates that the transmitted message and the
received message are different.
CSA
The canadian standards association defines and maintains standards for industrial
electronic equipment in hazardous environments.
CTS
Clear to send is a data transmission signal and acknowledges the RDS signal from
the transmitting station.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
cyclic task
The cyclic scan time has a fixed duration (interval) specified by the user. If the
current scan time is shorter than the cyclic scan time, the controller waits until the
cyclic scan time has elapsed before starting a new scan.
data log
The controller logs events relative to the user application in a data log.
DCE
Data communications equipment describes devices (often modems) that start, stop,
and sustain network sessions.
Derating
Derating describes a reduction in an operating specification. For devices in general
it is usually a specified reduction in nominal power to facilitate operation at increased
ambient conditions like higher temperatures or higher altitudes.
DHCP
The dynamic host configuration protocol is an advanced extension of BOOTP.
DHCP is a more advanced, but both DHCP and BOOTP are common. (DHCP can
handle BOOTP client requests.)
digital I/O
A digital input or output has an individual circuit connection at the electronic module
that corresponds directly to a data table bit that holds the value of the signal at that
I/O circuit. It gives the control logic digital access to I/O values.
DIN
Deutsches Institut für Normung is a German institution that sets engineering and
dimensional standards.
DINT
A double integer type is encoded in a 32-bit format.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
DNS
The domain name system is the naming system for computers and devices
connected to a LAN or the Internet.
drop cable
A drop cable is the unterminated derivation cord used to connect a TAP to a device.
DSR
Data set ready is a data transmission signal.
DTM
With device type managers representing the field device in SoMachine, direct
communications are possible to every single field device via SoMachine, the
controller and the field bus, thus avoiding the need for individual cable connections.
DWORD
A double word type is encoded in a 32-bit format.
EDS
Electronic data sheet contains for example the properties of a device e.g.
parameters and settings of a drive.
EEPROM
Electrically erasable programmable read-only memory is a type of non-volatile
memory used to store data that must be saved when power is removed.
EIA
The electronic industries alliance is the trade organization for establishing
electrical/electronic and data communication standards (including RS-232 and RS-
485) in the United States.
EIA rack
An electronic industries alliance rack is a standardized (EIA 310-D, IEC 60297 and
DIN 41494 SC48D) system for mounting various electronic modules in a stack or
rack that is 19 inches (482.6 mm) wide.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
electronic module
In a programmable controller system, most electronic modules directly interface to
the sensors, actuators, and external devices of the machine/process. This electronic
module is the component that mounts in a bus base and provides electrical
connections between the controller and the field devices. Electronic modules are
offered in a variety of signal levels and capacities. (Some electronic modules are not
I/O interfaces, including power distribution modules and transmitter/receiver
modules.)
EN
EN identifies one of many European standards maintained by CEN (European
Committee for Standardization), CENELEC (European Committee for
Electrotechnical Standardization), or ETSI (European Telecommunications
Standards Institute).
encoder
An encoder is a device for length or angular measurement (linear or rotary
encoders).
Equipment
An Equipment is a part of the Machine.
ERC
eccentric roller conveyor
ESD
electrostatic discharge
Ethernet
Ethernet is a physical and data link layer technology for LANs, also known as
IEE 802.3.
EtherNet/IP
The ethernet industrial protocol is an open communications protocol for
manufacturing automation solutions in industrial systems. EtherNet/IP is in a family
of networks that implements Common Industrial Protocol at its upper layers. The
supporting organization (ODVA) specifies EtherNet/IP to accomplish global
adaptability and media independence.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
expansion bus
The expansion bus is an electronic communication bus between expansion modules
and a CPU.
expert I/O
Expert I/Os are dedicated modules or channels for advanced features. These
features are generally embedded in the module in order to not use the resources of
the PLC Controller and to allow a fast response time, depending of the feature.
Regarding the function, it could be considered as a “stand alone” module, because
the function is independent of the Controller processing cycle, it just exchanges
some information with the Controller CPU.
FAST I/O
FAST I/Os are specific I/Os with some electrical features (response time, for
example) but the treatment of these channels is done by the Controller CPU.
FAST task
The FAST task is a periodic, high-priority task of a short duration that is run on a
processor through its programming software. The task fast speed keeps it from
interfering with the execution of lower priority master (MAST) tasks. A FAST task is
useful when fast periodic changes in discrete inputs need to be monitored.
FB
A function block performs a specific automation function, such as speed control,
interval control, or counting. A function block comprises configuration data and a set
of operating parameters.
FBD
A function block diagram is a graphically oriented programming language, compliant
with IEC 61131-3. It works with a list of networks whereby each network contains a
graphical structure of boxes and connection lines which represents either a logical
or arithmetic expression, the call of a function block, a jump, or a return instruction.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
FDT
Field device tool for standardized communications between field devices and
SoMachine.
FE
Functional ground is the point of a system or device that must be grounded to help
prevent equipment damage.
FG
frequency generator
firmware
The firmware represents the operating system on a controller.
Flash memory
Flash memory is nonvolatile memory that can be overwritten. It is stored on a special
EEPROM that can be erased and reprogrammed.
FTP
File transfer protocol is a standard network protocol (built on a client-server
architecture), to exchange and manipulate files over TCP/IP based networks.
function
A function:
z is a POU that returns 1 immediate result
z is directly called with its name (as opposed to through an instance)
z has no persistent state from one call to the next
z can be used as an operand in expressions
FWD
forward
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
GVL
The global variable list manages global variables that are available in every
application POU.
HE10
Rectangular connector for electrical signals with frequencies below 3MHz,
complying with IEC60807-2.
HMI
A human-machine interface is an operator interface (usually graphical) for industrial
equipment.
hot swapping
Hot swapping is the replacement of a component with a like component while the
system remains operational. The replacement component begins to function
automatically after it is installed.
HSC
high-speed counter
HVAC
Heating ventilation and air conditioning applications monitor and control indoor
environments.
I/O
input/output
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
I/O scan
An input/output scan continuously polls I/O modules to collect data bits and status,
error, and diagnostics information. This process monitors inputs and controls
outputs.
I/O terminal
An input/output terminal on the front of an expansion I/O module connects input and
output signals.
ICMP
The internet control message protocol reports errors and provides information
related to datagram processing.
IEC
The international electrotechnical commission is a non-profit and non-governmental
international standards organization that prepares and publishes international
standards for all electrical, electronic, and related technologies.
IEC 61131-3
The IEC 61131-3 is an international electrotechnical commission standard for
industrial automation equipment (like controllers). IEC 61131-3 deals with controller
programming languages and defines 2 graphical and 2 textual programming
language standards:
z graphical: ladder diagram, function block diagram
z textual: structured text, instruction list
IEEE
The institute of electrical and electronics engineers is a non-profit international
standards and conformity assessment body for advances in all fields of
electrotechnology.
IEEE 802.3
IEEE 802.3 is a collection of IEEE standards defining the physical layer, and the
media access control (MAC) sublayer of the data link layer, of wired Ethernet.
IL
A program written in the instruction list language is composed of a series of
instructions executed sequentially by the controller. Each instruction includes a line
number, an instruction code, and an operand. (IL is IEC 61131-3 compliant.)
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
immediate addressing
The direct method of addressing memory objects, including physical inputs and
outputs, used in programming instructions as operands and parameters by using
their direct address (for example, %Iwx or %QWx).
The use of immediate addressing in your program may avoid the need to create
symbols for these objects, but there are also disadvantages. For example, if you
change the program configuration by adding or deleting devices or I/O modules or
slices, the immediate addresses used as programming instruction operands and/or
parameters are not updated and must be corrected manually, which may cause
extensive program modifications and lead to incorrect programming instructions.
(See symbolic addressing.)
input filter
An input filter is a special function that rejects input noises. It is useful for eliminating
input noises and chatter in limit switches. All inputs provide a level of input filtering
using the hardware. Additional filtering with software is also configurable through the
programing or the configuration software.
input terminal
An input terminal on the front of an expansion I/O module connects input signals
from input devices (such as sensors, push buttons, and limit switches). For some
modules, input terminals accept both sink and source DC input signals.
INT
A single integer is encoded in 16 bits.
IP
The internet protocol is part of the TCP/IP protocol family that tracks the Internet
addresses of devices, routes outgoing messages, and recognizes incoming
messages.
IP 20
Ingress protection rating according to IEC 60529. IP20 modules are protected
against ingress and contact of objects larger than 12.5 mm. The module is not
protected against harmful ingress of water.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
IP 67
Ingress protection rating according to IEC 60529. IP67 modules are completely
protected against ingress of dust and contact. Ingress of water in harmful quantity is
not possible when the enclosure is immersed in water up to 1m.
Kd
derivative gain
Ki
integral gain
Kp
proportional gain
LAN
A local area network local area network is a short-distance communications network
that is implemented in a home, office, or institutional environment.
latching input
A latching input module interfaces with devices that transmit messages in short
pulses. Incoming pulses are captured and recorded for later examination by the
application.
LCD
liquid crystal display
LD
A program in the ladder diagram language includes a graphical representation of
instructions of a controller program with symbols for contacts, coils, and blocks in a
series of rungs executed sequentially by a controller. IEC 61131-3 compliant.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
LED
A light emitting diode is an indicator that lights up when electricity passes through it.
LINT
Long integer is a 64-bit variable (4 times INT or two times DINT).
LMC
lexium motion control
located variable
A located variable has an address. (See unlocated variable.)
LRC
longitudinal redundancy checking
LREAL
Long real is a 64-bit variable.
LSB
The least significant bit (or least significant byte) is the part of a number, address, or
field that is written as the right-most single value in conventional hexadecimal or
binary notation.
LWORD
A long word type is encoded in a 64-bit format.
MAC address
The media access control address is a unique 48-bit number associated with a
specific piece of hardware. The MAC address is programmed into each network
card or device when it is manufactured.
Machine
A Machine consists of several functions and/or equipments which build the machine.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
Magelis
Magelis is the commercial name for Schneider Electric's range of HMI terminals.
MAST
A master (MAST) task is a processor task that is run through its programming
software. The MAST task has two sections:
z IN: Inputs are copied to the IN section before execution of the MAST task.
z OUT: Outputs are copied to the OUT section after execution of the MAST task.
master/slave
The single direction of control in a network that implements the master/slave model
is always from a master device or process to one or more slave devices.
MIB
The management information base is an object database that is monitored by a
network management system like SNMP. SNMP monitors devices that are defined
by their MIBs. Schneider has obtained a private MIB, groupeschneider (3833).
Modbus
The Modbus communication protocol allows communications between many
devices connected to the same network.
Modbus SL
Modbus serial line
MSB
The most significant bit (or most significant byte) is the part of a number, address,
or field that is written as the left-most single value in conventional hexadecimal or
binary notation.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
NAK
negative acknowledge
NC
A normally closed contact is a contact pair that is closed when the actuator is de-
energized (no power is applied) and open when the actuator is energized (power is
applied).
NEC
The national electric code dictates the safe installation of electrical wiring and
equipment.
NEMA
The national electrical manufacturers association publishes standards for the
performance of various classes of electrical enclosures. The NEMA standards cover
corrosion resistance, ability to protect from rain and submersion, etc. For IEC
member countries, the IEC 60529 standard classifies the ingress protection rating
for enclosures.
network
A network includes interconnected devices that share a common data path and
protocol for communications.
Nibble
A Nibble is a half-byte (representing 4 bits of a byte).
NMT
Network management protocols provide services for network initialization, error
control, and device status control.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
NO
A normally open contact is a contact pair that is open when the actuator is de-
energized (no power is applied) and closed when the actuator is energized (power
is applied).
node
A node is an addressable device on a communication network.
ODVA
The open deviceNet vendors association supports the family of network
technologies that are built on CIP (EtherNet/IP, DeviceNet, and CompoNet).
OS
Operating system. Can be used for Firmware that can be uploaded/downloaded by
the user.
OSI
The open system interconnection reference model is a 7-layer model that describes
network protocol communications. Each abstract layer receives services from the
layer below it and provides services to the layer above.
OTB
Optimized terminal block, used in the context of Advantys I/O distributed module
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
output terminal
An output terminal connects output signals to output devices (such as electrome-
chanical relays and solenoid valves).
pallet
A pallet is a portable platform, which is used for storing or moving goods.
PCI
A peripheral component interconnect is an industry-standard bus for attaching
peripherals.
PDM
A power distribution module distributes either AC or DC field power to a cluster of
I/O modules.
PDO
A process data object is transmitted as an unconfirmed broadcast message or sent
from a producer device to a consumer device in a CAN-based network. The transmit
PDO from the producer device has a specific identifier that corresponds to the
receive PDO of the consumer devices.
PDU
protocol data unit
PE
Protective ground is a return line across the bus for fault currents generated at a
sensor or actuator device in the control system.
periodic execution
The master task is executed either cyclically or periodically. In periodic mode, you
determine a specific time (period) in which the master task must be executed. If it is
executed under this time, a waiting time is generated before the next cycle. If it is
executed over this time, a control system indicates the overrun. If the overrun is too
high, the controller is stopped.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
persistent data
Value of persistent data that will be used at next application change or cold start.
Only get re-initialized at a reboot of the controller or reset origin. Especially they
maintain their values after a download.
PI
proportional integral
PID
proportional, integral and derivative control
PLC
The programmable logic controller is the “brain” of an industrial manufacturing
process. It automates a process, used instead of relay control systems. PLCs are
computers suited to survive the harsh conditions of the industrial environment.
PLCopen
The PLCopen standard brings efficiency, flexibility, and manufacturer independence
to the automation and control industry through the standardization of tools, libraries,
and modular approaches to software programming.
PLI
pulse latch input
post-configuration
Post-configuration files contain machine-independent parameters, including:
z machine name
z device name or IP address
z Modbus serial line address
z routing table
POU
A program organization unit includes a variable declaration in source code and the
corresponding instruction set. POUs facilitate the modular reuse of software
programs, functions, and function blocks. Once declared, POUs are available to one
another. SoMachine programming requires the utilization of POUs.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
POU FB
Program organization unit function block types are user programs that can be
defined by the user in the ST, IL, LD, or FBD languages. You can use POU FB types
in an application to:
z simplify the design and entry of the program
z make the program easier to read
z simplify debugging
z reduce the amount of generated code
protocol
A protocol is a convention or standard that controls or enables the connection,
communication, and data transfer between two computing endpoints.
Pt100/Pt1000
Platinum resistance thermometer are characterized by their nominal resistance R0
at a temperature of 0° C.
z Pt100 (R0 = 100 Ohm)
z Pt1000 (R0 = 1 kOhm)
PTO
Pulse train outputs are used to control for instance stepper motors in open loop.
PWM
Pulse width modulation is used for regulation processes (e.g. actuators for
temperature control) where a pulse signal is modulated in its length. For these kind
of signals, transistor outputs are used.
RAM
random access memory
REAL
Real is a numeric data type. The REAL type is encoded in a 32-bit format.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
reflex output
In a counting mode, the high speed counter current value is measured against its
configured thresholds to determine the state of these dedicated outputs.
retained data
A retained data value is used in the next power-on or warm start. The value is
retained even after an uncontrolled shutdown of the controller or a normal switch-off
of the controller.
RFID
Radio-frequency identification is an automatic identification method that relies on
the storage and remote retrieval of data using RFID tags or transponders.
RJ-45
This registered jack is a modular connector that is commonly implemented in
communication networks.
RPDO
A receive PDO sends data to a device in a CAN-based network.
RPM
revolutions per minute
RPS
revolutions per second
RS-232
RS-232 (also known as EIA RS-232C or V.24) is a standard type of serial
communication bus, based on three wires.
RS-485
RS-485 (also known as EIA RS-485) is a standard type of serial communication bus,
based on two wires.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
RTC
The real-time clock option keeps the time for a limited amount of time even when the
controller is not powered.
RTS
Request to send is a data transmission signal and will be acknowledged by the CTS
signal from the destination node.
RTU
A remote terminal unit is a device that interfaces with objects in the physical world
to a distributed control system or SCADA system by transmitting telemetry data to
the system and/or altering the state of connected objects based on control
messages received from the system.
RxD
receiving data (data transmission signal)
SCADA
A supervisory control and data acquisition system monitors, manages, and controls
industrial applications or processes.
scan
A controller scanning program performs 3 basic functions: [1] It reads inputs and
places these values in memory; [2] it executes the application program 1 instruction
at a time and stores results in memory; [3] It uses the results to update outputs.
SDO
A service data object message is used by the field bus master to access (read/write)
the object directories of network nodes in CAN-based networks. SDO types include
service SDOs (SSDOs) and client SDOs (CSDOs).
SEL-V
A system that follows IEC 61140 guidelines for safety extra low voltage is protected
in such a way that voltage between any 2 accessible parts (or between 1 accessible
part and the PE terminal for Class 1 equipment) does not exceed a specified value
under normal conditions or under single-fault conditions.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
SFC
A program written in the sequential function chart language can be used for
processes that can be split into steps. SFC is composed of steps with associated
actions, transitions with associated logic condition, and directed links between steps
and transitions. (The SFC standard is defined in IEC 848. It is IEC 61131-3
compliant.)
sink input
A sink input is a wiring arrangement in which the device provides current to the input
electronic module. A sink input is referenced to 0 Vdc.
SINT
Signed integer is a 16-bit value.
SL
serial line
SMS
The short message service is a standard communication service for telephones (or
other devices) that send short text messages over the mobile communications
system.
SNMP
The simple network management protocol can control a network remotely by polling
the devices for their status, performing security tests, and viewing information
relating to data transmission. It can also be used to manage software and databases
remotely. The protocol also permits active management tasks, such as modifying
and applying a new configuration
source output
A source output is a wiring arrangement in which the output electronic module
provides current to the device. A source output is referenced to +24 Vdc.
SSI
Serial synchronous interface is a common interface for relative and absolute
measurement systems like encoders.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
ST
See structured text.
STN
Scan Twisted Nematic (also known as passive matrix)
STRING
A STRING variable is a series of ASCII characters.
Structured Text
A program written in the structured text (ST) language includes complex statements
and nested instructions (such as iteration loops, conditional executions, or
functions). ST is compliant with IEC 61131-3.
symbol
A symbol is a string of a maximum of 32 alphanumeric characters, of which the first
character is alphabetic. It allows you to personalize a controller object to facilitate
the maintainability of the application.
symbolic addressing
The indirect method of addressing memory objects, including physical inputs and
outputs, used in programming instructions as operands and parameters by first
defining symbols for them using these symbols in association with the programming
instructions.
In contrast to immediate addressing, this is the recommended method because if the
program configuration changes, symbols are automatically updated with their new
immediate address associations, whereas any immediate addresses used as
operands or parameters are not. (See immediate addressing.)
system time
An internal clock provides a device with the system time.
system variable
A system variable structure provides controller data and diagnostic information and
allows sending commands to the controller.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
TAP
A terminal access point is a junction box connected to the trunk cable that allows you
to plug in drop cables.
task
A group of sections and subroutines, executed cyclically or periodically for the MAST
task, or periodically for the FAST task.
A task possesses a level of priority and is linked to inputs and outputs of the
controller. These I/O are refreshed in consequence.
A controller can have several tasks.
TCP
A transmission control protocol is a connection-based transport layer protocol that
provides a reliable simultaneous bi-directional transmission of data. TCP is part of
the TCP/IP protocol suite.
terminal block
The terminal block is the component that mounts in an electronic module and
provides electrical connections between the controller and the field devices.
TFT
thin film transmission (also known as active matrix)
threshold output
Threshold outputs are controlled directly by the HSC according to the settings
established during configuration.
TP
A touch probe is a position capture that is triggered by a fast input signal (quick
sensor). On the rising edge of the touch probe input the position of an encoder is
captured. Example: This is used for packaging machines to capture the position of
a printmark on a film to cut always on the same position.
TPDO
A transmit PDO reads data from a device in a CAN-based system.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
trunk cable
A trunk cable is the main cable that is terminated at both physical ends with line
termination resistors.
TVDA
tested validated documented architectures
TxD
TxD represents a transmit signal.
UDINT
An unsigned double integer is encoded in 32 bits.
UDP
The user datagram protocol is a connectionless mode protocol (defined by
IETF RFC 768) in which messages are delivered in a datagram (data telegram) to a
destination computer on an IP network. The UDP protocol is typically bundled with
the Internet Protocol. UDP/IP messages do not expect a response, and are
therefore ideal for applications in which dropped packets do not require
retransmission (such as streaming video and networks that demand real-time
performance).
UINT
An unsigned integer is encoded in 16 bits.
UL
Underwriters Laboratories, US organization for product testing and safety
certification.
unlocated variable
An unlocated variable does not have an address. (See located variable.)
UTC
coordinated universal time
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
VSD
variable speed drive
WORD
The WORD type is encoded in a 16-bit format.
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Glossary
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Index
EIO0000000067 10/2010
Index
B
AC
A commands
single access, 196
Add application, 82
Commission machine - start with project, 43
adding controllers, 148
Commission machine - upload project from
adding devices, 68
device, 45
analog inputs
Commissioning, 250
CANopen, 270
Communication DTM, 93, 95, 117, 120
applications, 82
Communication manager configuration, 152
AS-Interface, 78
communication managers, 74
AS-Interface configurations, 190
Configuration, 62
ASCII Managers, 186
configuration diagnostic, 154
attachments, 59
configuring devices, 70
consistency, 84
B Create Boot Application, 198
Create new machine, 32
Boot Application, 244 creating libraries, 175
boot applications, 198 Custom Information, 59
Browse for existing project, 27 Customer Service Tool, 257
Build All command, 197
D
C deleting devices, 68
CANopen analog inputs, 270 device templates, 225, 226
CANopen devices, 152 device type managers, 93
CANopen interface, 180 devices
close project, 25 adding, 154
closing projects, 23 display manager, 66
Collapse All, 66 displaying panes, 23
command DTM, 90, 93
Build All, 197
Export Vijeo-Designer project, 201
Import Vijeo-Designer project, 201
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Index
E import
Vijeo-Designer projects, 201
Ethernet configurations, 177
import command, 201
example projects, 39
information pane, 23
Expand All, 66
Expand Last, 66
expansion modules, 78, 149, 150 L
export
language setting, 23
Vijeo-Designer projects, 201
Learning Center, 50
export command, 201
libraries, 159, 162
adding libraries, 137
F library creation, 175
Limitation, 94, 106
FDT, 89, 90, 95, 124
login, 244
field devices configuration, 152
Login/Logout, 253
fieldbus health information, 154
fieldbus manager
adding slave devices, 76 M
Fieldbus Topology, 91
main selection screen, 23
fieldbusses supported by templates, 215
menus, 268
function templates, 235
message window, 23
Modbus configurations, 186
G Modbus IOScanners, 186
Modbus Managers, 186
general functions, 25
Modbus SL devices, 152
Generic DTM, 95, 113
Multiple Download task, 255
graphical configuration editor, 66
graphical user interface
elements, 23 N
GUI elements, 23
network connections, 84
Network Managers, 186
H nodeguarding settings, 180
handles, 23
Hardwire Topology, 92 O
health information
online help, 23
fieldbus, 154
heartbeat settings, 180
hiding panes, 23 P
placeholder concept, 137
I Preferences, 25
Program, 130
IEC Objects
programming logic, 82
fieldbus Diagnostic/O mapping, 154
projects
close, 23
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Index
R U
Report tab, 259 Update Device Version, 82
Reroute, 66 Update firmware, 48, 82
Reroute On Drop, 66 USB Mass Storage, 199
run, 248
V
S variable definition, 203
save project, 25 variable types, 203
saving to USB mass storage device, 199 variables
selecting variables, 208 persistent, 140
Serial Line configurations, 186 publishing, 207
Set active application, 82 publishing (HMI), 209
shortcuts, 268 remanent, 140
Show All, 66 visualization, 229
Show existing machine, 27
single access commands, 196
slave devices, 76 W
Source Download, 257 work area, 23
Start with application, 36
Start with empty project, 33
Start with Example, 39
Start with existing project, 38
Start with TVD Architecture, 34
startup window, 23
stop, 248
symbol configuration, 143
Synchronized mode, 110
T
task
Multiple Download, 255
task selection pane, 23
tasks
adding, 134
template libraries, 225
templates, 212
Topology, 91, 91, 92, 101
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com
Index
Courtesy of Steven Engineering, Inc.-230 Ryan Way, South San Francisco, CA 94080-6370-Main Office: (650) 588-9200-Outside Local Area: (800) 258-9200-www.stevenengineering.com