31.01.

2003

SIMATIC
Easy Motion Control

Getting Started Edition 02/2003

First Steps in Commissioning

 31.01.2003

Safety Guidelines

This manual contains notices intended to ensure personal safety, as well as to protect the products and
connected equipment against damage. These notices are highlighted by the symbols shown below and
graded according to severity by the following texts:

Danger
! indicates that death, severe personal injury or substantial property damage will result if proper
precautions are not taken.

Warning
! indicates that death, severe personal injury or substantial property damage can result if proper
precautions are not taken.

Caution
! indicates that minor personal injury can result if proper precautions are not taken.

Caution
indicates that property damage can result if proper precautions are not taken.

Notice
draws your attention to particularly important information on the product, handling the product, or to a
particular part of the documentation.

Qualified Personnel

Only qualified personnel should be allowed to install and work on this equipment. Qualified persons
are defined as persons who are authorized to commission, to ground and to tag circuits, equipment, and
systems in accordance with established safety practices and standards.

Correct Usage

Note the following:

Warning
! This device and its components may only be used for the applications described in the catalog or the
technical description, and only in connection with devices or components from other manufacturers
which have been approved or recommended by Siemens.

This product can only function correctly and safely if it is transported, stored, set up, and installed
correctly, and operated and maintained as recommended.

Trademarks

SIMATIC®, SIMATIC HMI® and SIMATIC NET® are registered trademarks of SIEMENS AG.

Third parties using for their own purposes any other names in this document which refer to trademarks
might infringe upon the rights of the trademark owners.

Copyright © Siemens AG 2001-2003 All rights reserved Disclaimer of Liability

The reproduction, transmission or use of this document or its We have checked the contents of this manual for agreement with
contents is not permitted without express written authority. the hardware and software described. Since deviations cannot be
Offenders will be liable for damages. All rights, including rights precluded entirely, we cannot guarantee full agreement. However,
created by patent grant or registration of a utility model or design, the data in this manual are reviewed regularly and any necessary
are reserved. corrections included in subsequent editions. Suggestions for
improvement are welcomed

Siemens AG
Bereich Automation and Drives
Geschäftsgebiet Industrial Automation Systems © Siemens AG 2001-2003
Postfach 4848, D- 90327 Nuernberg Technical data subject to change.

Siemens Aktiengesellschaft A5E00100696-02

 31.01.2003

Getting Started

Introduction
Using an IM 178-4 as an example of a distance measurement and output module,
this primer leads you through six commissioning steps to a working application. It
allows you to familiarize yourself with the basic functions of Easy Motion Control.
Depending on your experience, it will take between one and two hours of your
time.
At the end of this primer, you will find information on testing in simulation mode
without hardware and drive.

Using other distance measurement and output modules

Of course, the commissioning tasks described here can also be carried out using
other distance measurement and output modules if an IM178-4 is not available.
Easy Motion Control provides other special drivers for this purpose.
You can also perform the commissioning described here with other distance
measurement and output modules supported by Easy Motion Control.
This documentation assumes the use of an IM178-4.
All text sections involving hardware are highlighted with a colored background. This
indicates that the tasks may differ if you use different hardware.

Requirements
The following requirements must be fulfilled:
• You must have configured and wired an S7 station consisting of a power
supply module, CPU with DP connection and a locally connected IM 178-4 as
well as your drive together with encoder.
• For installation and wiring of the IM 178-4, see the "IM 178-4 Drive Interface"
manual.
Wiring includes connecting the enable input of your power unit to a digital
output of the IM 178-4 (see step 5.9).
• STEP 7 (≥ V5.0 + Service Pack 3) is correctly installed on your programming
device.
• Your programming device is connected to the CPU.
• You have set up a project for your S7 station.
• You are in possession of the Easy Motion Control software product.
• You are familiar with the STEP 7 configuration package, particularly with the
SIMATIC Manager and the LAD/STL/FBD-Editor.
• You have provided safety limit switches and EMERGENCY STOP switches to
safeguard the safety of operating staff and the system itself.

Easy Motion Control

A5E00100696-02 3
 31.01.2003

Getting Started

Warning
! Injury may occur to persons and property.
Uncontrolled travel motions during commissioning and operation can cause
severe injury to persons and property.
To avoid injury to persons and objects, take the following precautions:
• Install an EMERGENCY STOP switch in the vicinity of the computer. This is
the only way to ensure that the system is reliably switched off in the event of a
hardware or software failure.
• Install safety limit switches with direct control over the power units of all drives.
• Ensure that nobody has access to anywhere of the system where there are
moving parts.

Configuration of Example

Emergency STOP Network

Button
IM 178-4 CPU

DP
Enabling
Safety Power +/- 10 Volt
Device Unit

PC/PG
Working
Stations

Movement

M Encoder
Motor

Safety Limit
Switch Easy Motion Control with
configuration software,
blocks and manual

Easy Motion Control

4 A5E00100696-02
 31.01.2003

Getting Started

Functionality of Example
You generate a user program allowing you to move your axis in jogging mode.

Step 1: Easy Motion Control Installation

Install the software by starting the installation program Setup.exe on the CD-ROM
and following its instructions.
More detailed information can be found in the Easy Motion Control manual under
"Installation of Easy Motion Control". The manual can be found in unzipped form on
the installation CD under Manuals\English\EasyMotionControlV2.pdf.

Step 2: Parameterization in HW Config

Parameterize the time interrupt of OB35 in the CPU with 10 ms (CPU 318 or
S7-400) or 20 ms (S7-300 to CPU 316).
In OB35, you later launch Easy Motion Control blocks in Step 5.
Select IM 178-4 from the module catalogue in HW Config under PROFIBUS-DP >
Function Modules > IM 178-4. Configure slot 4 of the IM 178-4 as "4Word
AO/12Word AI/Cons. 1Word".
Parameterize the IM 178-4 as follows:

Step Parameter Setting

2.1 Synchronization Software

2.2 Edge selection Rising or falling edge

Parameter
Parameterize the other settings according to the connected encoder.

Easy Motion Control

A5E00100696-02 5
 31.01.2003

Getting Started

Step 3: Parameterization of Axis Data

Step Job Result

3.1 Open the Easy Motion Control configuration software The Easy Motion Control V 2
on your PC via the Windows start menu (Start > window appears.
Simatic > STEP 7 > Easy Motion Control V2).
3.2 Select the menu function File > New from the configuration software.

3.3 In the "New" window, open the block container of your project.

3.4 Under "Object Name", enter a DB that does not yet The dialog is opened for
exist in your project, e.g. DB1. This DB is regenerated parameterizing the DB.
with "OK".
UDT AXIS_REF is thereby copied from the library
"EMC2 Easy Motion Control" into the "Blocks"
container of your project.
Note: You should not then delete this UDT AXIS_REF
or change the UDT number.
3.5 Enter all parameters corresponding to your axis. You will find an explanation of parameters
in the configuration software's online help (F1 key).
In the "Commissioning" register, the configuration software offers help in determining
parameters.
• "Set encoder polarity"
• "Set drive polarity"
• "Axis distance per encoder revolution" and
• "Max. axis velocity"
see step 4.
3.6 Save the axis DB that has just been parameterized in The DB is generated and
your offline database organization. parameterized.

Easy Motion Control

6 A5E00100696-02
 31.01.2003

Getting Started

Step 4: Commissioning the Axis using Configuration Software

Warning
! The start-up aids described here cause your axis to move. Faulty wiring or
parameterization results in incorrect speed or polarity. You must therefore make
sure that your system cannot be damaged by being moved, e.g. using safety limit
switches which switch your drive off.
The axis is commissioned without a user program and only functions if nothing
else is accessing the analog output channel controlling your drive.

Step Job Result

4.1 Bring your CPU into RUN.

4.2 Open the register "Commissioning" in the configuration software.

4.3 Use the "wiring test" to check the wiring of your The axis is moved.
encoder and analog output and if necessary set the The parameters "Set encoder
encoder or drive polarity. polarity" and "Set drive polarity" are
Press the "Wiring test" button and follow the adjusted so as to ensure correct
instructions in Wizard. direction of control action of the
position control loop.
4.4 "Distance measurement" allows you to determine the The axis is moved.
parameter "Axis distance per encoder revolution".
"Distance measurement" is only necessary if you do
not know what distance your axis covers in one
The parameter "Axis distance per
encoder revolution.
encoder revolution" is set correctly.
Press the "Distance measurement" button and follow
the instructions in Wizard.
4.5 "Velocity measurement" allows you to determine the The axis is moved.
parameter "Maximum axis velocity".
"Velocity measurement" is only necessary if you do not
know what maximum axis velocity your axis reaches.
Press the button "Velocity measurement" and follow
the instructions in Wizard. The parameter "Maximum axis
velocity" is set correctly.
4.6 Save the axis DB in your offline database organization.

Easy Motion Control

A5E00100696-02 7
 31.01.2003

Getting Started

Step 5: Generating a position control program

The program described here is included in the Easy Motion Control V2.0 sample
project (English project: ZEn20_02_EMC2; Programm: GettingStarted).

Step Job Result

5.1 Give the axis DB generated in step 3 the symbolic name "DB_Axis".

5.2 From the "Blocks" container of the "EMC2 Easy Motion Control" library, copy the blocks
• FC Mc_Init (function for initializing all blocks)
• FB EncoderIM178 (input driver for IM 178-4)
• FB MC_MoveJog (travel block for jogging mode)
• FB MC_Control (control block)
• FB OutputIM178 (output driver for IM 178-4)
into your project's "Blocks" container.
5.3 Insert the new FC1 in your project, giving it the symbolic name "GetStarted". Open it with the
KOP/AWL/FUP Editor e.g. in the generation language KOP.
5.4 In FC GetStarted, insert calls of the blocks specified in Step 5.2 in the sequence indicated.

5.5 Interconnect the following parameters of the blocks with the axis DB
• Parameter axis with DB_Axis.Ax.
• Parameter Init with DB_Axis.Ax.Init.Ixx.
Ixx in this case stands for one of the parameters I0 to I31. Interconnect each Parameter
Init with exactly one initialization bit in the axis DB which is not used by any other FB.
e.g. EncoderIM178 with DB_Axis.Ax.Init.I0, MC_MoveJog with DB_Axis.Ax.Init.I1 etc.
5.6 Ensure a conditional launch of FC MC_Init, e.g. by placing a make contact with M100.0 in
front of the parameter EN in the ladder diagram symbol.
5.7 Reset the condition for launching FC MC_Init (reset M100.0).

5.8 Interconnect the "EnableDrive" input of FB Output IM178 with the "DriveEnabled" output of
FB MC_Control.
5.9 Interconnect the digital output which you use to enable your power unit with the
"DriveEnabled" output of FB MC_Control.
5.10 Give symbolic names to the instance DBs of the launched FBs. For this, in the context menu
to FB call (right mouse button on FB call), open the menu entry "Edit symbols".
5.11 Save the FC GetStarted that has just been generated. The position control program is
generated but is not yet launched.
5.12 In the OB35 time interrupt, launch FC GetStarted that The position control program is
has been generated above. called using timer control.
Save OB35.
5.13 In OB100 startup, set the condition for launching The position control program is
FC MC_Init in FC GetStarted (e.g. M100.0 see initialized in CPU startup.
Step 5.6).
Save OB100.

Easy Motion Control

8 A5E00100696-02
 31.01.2003

Getting Started

Step 6: Starting up Position Control in Jogging Mode

Step Job Result

6.1 Bring the CPU into STOP, load the previously generated program into the CPU and bring
this into RUN again.
6.2 Open the "Axis error" register of the configuration The error "Stop status requiring
software for your axis. acknowledgement" is displayed.
This error is set on launching
FC MC_Init, to prevent your axis
from running away uncontrollably
after CPU startup.
6.3 Open the register "Axis status" of the configuration software for your axis in order to monitor
position changes and axis status.
Note: As the axis is not yet synchronized, the displayed positions do not coincide with the
actual axis position. You can only recognize whether the axis is moving in the right direction.
The software limit switch is also not monitored in this status.
6.4 Enable your drive by setting the "EnableDrive" input of FB MC_Control at TRUE (e.g. using a
variable table).
6.5 Acknowledge the axis error that is present (group Your axis is at a position-controlled
error) by pressing the button "Group standstill (no group error is
acknowledgement" in the register "Axis status" of the displayed).
configuration software. if not, open the register "Axis error"
and "Parameterization error". In the
Online Help (F1 key), you will find
the possible causes for existing
errors.
6.6 Optimal controller gain can be determined empirically at the axis.
Increase controller gain in steps of 1.0 until the axis starts to oscillate during travel or at a
standstill. If this is the case, reduce controller gain until the tendency to oscillate is no longer
apparent.
6.7 Create a variable table with the following variables of instance DB to FB MC_MoveJog:
• JogPos
• JogNeg
• Velocity
• Acceleration
• Deceleration
• Busy
• MotionAborted
6.8 Specify the values for parameters Velocity, Acceleration and Deceleration. If you have any
questions about the significance of the parameters, open the online help to FB MC_MoveJog
by selecting the block in the SIMATIC Manager and pressing the F1 button.
6.9 Set one of the parameters JogPos or JogNeg to start The axis accelerates and moves as
travel in the positive or negative direction. Observe the you specified in Step 6.7.
effect using the configuration software and at output If your axis does not move, there is
parameters Busy and CommandAborted of the group error again and one of
FB MC_MoveJog. the axis errors, see Step 6.5.

Easy Motion Control

A5E00100696-02 9
 31.01.2003

Getting Started

Test in Simulation Mode

You can also run the test in simulation mode entirely:
• You do not need any distance measurement and output modules, or any drive
or encoder.
In this case, the following steps differ from the procedure described in
Getting Started:

Step Job
2 Not applicable.

3.5 Only change the following parameters once you have recreated the axis DB.

Register Parameter Value

"Configuration" "Simulation mode" Engaged

"Axis" "SW limit switch start" -100 000.0

"SW limit switch end" 100 000.0
"Maximum axis velocity" 50.0
"Maximum axis acceleration" 10.0
"Maximum axis deceleration" 10.0
"Encoder/controller/motor" "Steps per encoder revolution" 2048
"Controller gain" 10.0
4 Entirely inapplicable.
Start-up aids only function with a real drive.
5.2 Also copy FB MC_Simulation into your project.

5.4 After FC MC_Init, call FB MC_Simulation.

5.9 Not applicable.

Easy Motion Control

10 A5E00100696-02