TEC Installation FCT Man en-US
TEC Installation FCT Man en-US
SINAMICS
Technology Extensions
Installation description
Function Manual
03/2020
A5E45590347B
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will be
used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property
damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions. Qualified
personnel are those who, based on their training and experience, are capable of identifying risks and avoiding
potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended or
approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software described.
Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in this
publication is reviewed regularly and any necessary corrections are included in subsequent editions.
1 Introduction...................................................................................................................................................5
1.1 The SINAMICS converter family ..............................................................................................5
1.2 General information about SINAMICS documentation.............................................................6
1.3 General Data Protection Regulation ........................................................................................8
2 Fundamental safety instructions...................................................................................................................9
2.1 General safety instructions.......................................................................................................9
2.2 Warranty and liability for application examples ......................................................................10
2.3 Security information ...............................................................................................................11
3 Installing and activating ..............................................................................................................................13
3.1 Overview of installation and activation ...................................................................................13
3.2 SINAMICS Startdrive .............................................................................................................15
3.2.1 Requirements for installation using Startdrive........................................................................15
3.2.2 Installing and activating the Technology Extension ...............................................................15
3.2.2.1 Installing Technology Extension.............................................................................................15
3.2.2.2 Activating Technology Extension ...........................................................................................18
3.2.2.3 Commissioning Technology Extension ABC_OA...................................................................19
3.2.3 Upgrading Technology Extension ..........................................................................................20
3.2.4 Uninstalling Technology Extension ........................................................................................22
3.3 SINUMERIK Operate .............................................................................................................23
3.3.1 Preconditions for installation using SINUMERIK Operate......................................................23
3.3.2 Installing and activating the Technology Extension ...............................................................23
3.3.2.1 Installing Technology Extension on the drive unit ..................................................................23
3.3.2.2 Activating Technology Extension on the drive object.............................................................25
3.3.2.3 Commissioning Technology Extension ABC_OA...................................................................27
3.3.3 Upgrading Technology Extension ..........................................................................................27
3.3.4 Uninstalling Technology Extension ........................................................................................29
3.4 STARTER or SIMOTION SCOUT..........................................................................................30
3.4.1 Preconditions for installing using STARTER or SIMOTION SCOUT .....................................30
3.4.2 Installing and activating the Technology Extension ...............................................................30
3.4.2.1 Installing the OA Support Package in STARTER...................................................................30
3.4.2.2 Downloading the technology package ...................................................................................32
3.4.2.3 Activating the Technology Extension in the drive object ........................................................33
3.4.2.4 Commissioning Technology Extension ABC_OA...................................................................34
3.4.3 Technology Extension upgrade..............................................................................................34
3.4.3.1 Installing the OA Support Package in STARTER...................................................................34
3.4.3.2 Download the technology package for the new version.........................................................36
3.4.3.3 Additional information about upgrading..................................................................................37
3.4.4 Uninstalling Technology Extension ........................................................................................38
3.4.5 Scripting with STARTER or SIMOTION SCOUT ...................................................................39
3.4.5.1 Information about scripting.....................................................................................................39
Installation description
Function Manual, 03/2020, A5E45590347B 3
Table of contents
Installation description
4 Function Manual, 03/2020, A5E45590347B
Introduction 1
1.1 The SINAMICS converter family
With the SINAMICS converter family, you can solve any individual drive task in the low-voltage,
medium-voltage and DC voltage range. From converters to motors and controllers, all Siemens
drive components are perfectly matched to each other and can be easily integrated into your
existing automation system. With SINAMICS you are prepared for digitization. You benefit from
highly efficient engineering with a variety of tools for the entire product development and
production process. And you also save space in the control cabinet – thanks to the integrated
safety technology.
You can find additional information about SINAMICS at the following address (http://
www.siemens.com/sinamics).
Installation description
Function Manual, 03/2020, A5E45590347B 5
Introduction
1.2 General information about SINAMICS documentation
SINAMICS documentation
The SINAMICS documentation is organized in the following categories:
● General documentation/catalogs
● User documentation
● Manufacturer/service documentation
Standard scope
The scope of the functionality described in this document can differ from that of the drive system
that is actually supplied.
● Other functions not described in this documentation might be able to be executed in the
drive system. However, no claim can be made regarding the availability of these functions
when the equipment is first supplied or in the event of service.
● The documentation can also contain descriptions of functions that are not available in a
particular product version of the drive system. Please refer to the ordering documentation
only for the functionality of the supplied drive system.
● Extensions or changes made by the machine manufacturer must be documented by the
machine manufacturer.
For reasons of clarity, this documentation does not contain all of the detailed information on all
of the product types, and cannot take into consideration every conceivable type of installation,
operation and service/maintenance.
Target group
This documentation is intended for machine manufacturers, commissioning engineers, and
service personnel who use the SINAMICS drive system.
Benefits
This manual provides all of the information, procedures and operator actions required for the
particular usage phase.
Siemens MySupport/Documentation
You can find information on how to create your own individual documentation based on
Siemens content and adapt it for your own machine documentation at the following address
(https://support.industry.siemens.com/My/ww/en/documentation).
Installation description
6 Function Manual, 03/2020, A5E45590347B
Introduction
1.2 General information about SINAMICS documentation
Additional information
You can find information on the topics below at the following address (https://
support.industry.siemens.com/cs/document/108993276):
● Ordering documentation/overview of documentation
● Additional links to download documents
● Using documentation online (find and search in manuals/information)
FAQs
You can find Frequently Asked Questions under Product Support (https://
support.industry.siemens.com/cs/de/en/ps/faq).
Training
At the following address (http://www.sitrain-learning.siemens.com), you can find information
about SITRAIN (Siemens training on products, systems and solutions for automation and
drives).
Technical Support
Country-specific telephone numbers for technical support are provided in the Internet at the
following address (http://support.industry.siemens.com/sc/ww/en/sc/2090) in the "Contact"
area.
Installation description
Function Manual, 03/2020, A5E45590347B 7
Introduction
1.3 General Data Protection Regulation
Installation description
8 Function Manual, 03/2020, A5E45590347B
Fundamental safety instructions 2
2.1 General safety instructions
WARNING
Danger to life if the safety instructions and residual risks are not observed
If the safety instructions and residual risks in the associated hardware documentation are not
observed, accidents involving severe injuries or death can occur.
● Observe the safety instructions given in the hardware documentation.
● Consider the residual risks for the risk evaluation.
WARNING
Malfunctions of the machine as a result of incorrect or changed parameter settings
As a result of incorrect or changed parameterization, machines can malfunction, which in turn
can lead to injuries or death.
● Protect the parameterization against unauthorized access.
● Handle possible malfunctions by taking suitable measures, e.g. emergency stop or
emergency off.
Installation description
Function Manual, 03/2020, A5E45590347B 9
Fundamental safety instructions
2.2 Warranty and liability for application examples
Installation description
10 Function Manual, 03/2020, A5E45590347B
Fundamental safety instructions
2.3 Security information
WARNING
Unsafe operating states resulting from software manipulation
Software manipulations, e.g. viruses, Trojans, or worms, can cause unsafe operating states
in your system that may lead to death, serious injury, and property damage.
● Keep the software up to date.
● Incorporate the automation and drive components into a holistic, state-of-the-art industrial
security concept for the installation or machine.
● Make sure that you include all installed products into the holistic industrial security concept.
● Protect files stored on exchangeable storage media from malicious software by with
suitable protection measures, e.g. virus scanners.
● On completion of commissioning, check all security-related settings.
● Protect the drive against unauthorized changes by activating the "Know-how protection"
converter function.
Installation description
Function Manual, 03/2020, A5E45590347B 11
Fundamental safety instructions
2.3 Security information
Installation description
12 Function Manual, 03/2020, A5E45590347B
Installing and activating 3
3.1 Overview of installation and activation
The subsequent installation descriptions in this chapter refer to the fictitious Technology
Extension "ABC_OA". The procedure described can be analogously applied to any real
Technology Extension.
Precondition
The basic commissioning of the control system and the drive or drive object has been
completed.
Commissioning tools
A Technology Extension (TEC) can be installed in the following ways:
● Startdrive commissioning tool
● SINUMERIK Operate (SINUMERIK control system with SINAMICS Integrated)
● STARTER commissioning tool
● SIMOTION SCOUT engineering software with integrated STARTER
Refer to the readme file for suitable commissioning tools to install the Technology Extension
described in this manual.
Terms
Installation package
The Technology Extension is supplied in a software package, which in turn comprises several
installation packages for different target systems and commissioning tools.
The following installation packages can be included:
● ABC_OA_V1_1.tec for installation with Startdrive
● rmed_abc_oa_v1_1_oaif04402300.tgz for installation with SINUMERIK Operate
● oasp_abc_oa_v1_1_oaif04402300.zip for installation with STARTER (SIMOTION SCOUT)
Installation description
Function Manual, 03/2020, A5E45590347B 13
Installing and activating
3.1 Overview of installation and activation
The file name of the installation package for the fictitious Technology Extension ABC_OA
comprises the following elements:
● oasp = OA Support Package (only for STARTER / SIMOTION SCOUT)
● rmed = RunMyEngineeredDrive (only for SINUMERIK)
● abc_oa = name of the Technology Extension
● v1_1 = version of the Technology Extension
● oaif04402300 = OA interface version (OA interfaces version, only for STARTER and
SINUMERIK)
Version of the SINAMICS firmware from which this Technology Extension can be used
(04402300 = V4.4).
Installation description
14 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.2 SINAMICS Startdrive
Devices
This general description applies to:
● SINAMICS S120, S150, G130, G150, firmware version V5.2 or higher
● SINAMICS MV firmware version V5.2 SP1 or higher
Requirements
1. The Startdrive commissioning tool must be installed with version V16 or higher.
2. The installation package for Technology Extension ABC_OA (abc_oa_V1_2.tec) must be in
a known directory.
Preconditions
1. The Startdrive commissioning tool is open.
2. A project has been created, or an existing project is open.
Installation description
Function Manual, 03/2020, A5E45590347B 15
Installing and activating
3.2 SINAMICS Startdrive
Procedure
Proceed as follows to open the screen form for the Technology Extension:
1. In the "Project tree" window, double-click on "Drive unit" ① > " Drive axis" ② >
"Parameterization" ③.
The function view for parameterization opens in the "Working area" window.
2. In the "Working area" window, double-click on "Technology functions" ④ and click on
"Technology Extensions" ⑤.
The screen form for "Technology Extensions" opens.
Installation description
16 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.2 SINAMICS Startdrive
If the Technology Extension can be activated at this drive object, then the Technology
Extension is displayed in the upper overview.
If the Technology Extension is run in the lower overview "Technology Extensions that cannot
be activated", then check the specified cause. Additional information is provided in the
Startdrive online help.
Installation description
Function Manual, 03/2020, A5E45590347B 17
Installing and activating
3.2 SINAMICS Startdrive
Preconditions
1. The Startdrive commissioning tool is open.
2. A project has been created, or an existing project is open.
3. Technology Extension "ABC_OA" has been installed.
4. Technology Extension "ABC_OA" is run in overview "Technology Extensions that can be
activated for this drive object".
Procedure
1. To activate Technology Extension "ABC_OA" for this drive object, in the "Selection" column,
click on the checkbox of the appropriate TEC.
The TEC is activated and the associated parameters are displayed in the parameter view.
Active Technology Extensions are marked by a check symbol in the checkbox.
Installation description
18 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.2 SINAMICS Startdrive
3. To activate the Technology Extension for the drive object, download the project.
Click on "Go online" and then on "Load to device".
The "Load preview" dialog opens:
Installation description
Function Manual, 03/2020, A5E45590347B 19
Installing and activating
3.2 SINAMICS Startdrive
Preconditions
The following preconditions must be satisfied:
● The Startdrive commissioning tool is open.
● A project has been created, or an existing project is open.
● Installation package "ABC_OA_V1_2_4.tec" has been installed and activated.
● The installation package with the new version "ABC_OA_V1_2_5.tec " is available in a
known directory.
Procedure
To use a higher version of an already installed Technology Extension, you must also install and
activate the higher version.
1. Carry out the installation as described in Chapter "Installing Technology Extension
(Page 15)".
2. Click in the "Version" column on the version number to display all of the installed versions.
3. Click on version "1.2.5" to use the higher version of Technology Extension "ABC_OA".
NOTICE
Parameters are reset to the factory setting
When upgrading, all parameters are restored to the factory setting.
Installation description
20 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.2 SINAMICS Startdrive
Installation description
Function Manual, 03/2020, A5E45590347B 21
Installing and activating
3.2 SINAMICS Startdrive
Procedure
To uninstall a Technology Extension using Startdrive, proceed as follows:
1. In the "Project tree" window, double-click on "Drive unit" --> " Drive axis" -->
"Parameterization".
The function view for parameterization opens in the "Working area" window.
2. In the "Working area" window, double-click on Technology functions and click on
"Technology Extensions".
The screen form for "Technology Extensions" opens.
3. To deactivate Technology Extension "ABC_OA" for this project, in the "Selection" column,
click on the checkbox of the corresponding TEC.
4. To uninstall Technology Extension "ABC_OA" in Startdrive, in column "Uninstall", click on
"Remove".
Installation description
22 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.3 SINUMERIK Operate
Devices
This general description is valid for SINUMERIK control systems with SINAMICS Integrated:
● SINUMERIK 840D sl
● SINUMERIK ONE
Requirements
1. Access level "Manufacturer" must be set in SINUMERIK Operate.
2. A USB memory, which is installed on the portable service system for the NCU, is available.
Note
The SINUMERIK service system, as well as the procedure to generate it on a USB memory,
is described in detail in the following references:
● SINUMERIK ONE New Installation and Upgrade, Installation Manual
● SINUMERIK 840D sl operating system NCU, Commissioning Manual
Installation description
Function Manual, 03/2020, A5E45590347B 23
Installing and activating
3.3 SINUMERIK Operate
Procedure
Install the Technology Extension as follows:
1. Connect the USB memory with portable service system to USB interface X125 or X135 of
the SINUMERIK NCU.
2. Restart SINUMERIK NCU:
– Switch the device off and then on again or
– Press the "Reset" button.
SINUMERIK NCU starts with the service system.
3. In the service system, execute the following actions one after the other:
– In the main menu, select menu item "Update NCU Software and Data".
– Then select menu item "Update system software from USB memory stick".
– Select the file "abc_oa_v1_2_oaif04402300.tgz" and confirm with "OK".
File "abc_oa.cfs" is extracted from file "abc_oa_v1_2_oaif04402300.tgz", and saved to
directory "/oem/sinamics/oa".
4. Restart SINUMERIK NCU (see Step 2).
Technology Extension ABC_OA is installed in directory "/oem/sinamics/oa" when the system
runs up. The appropriate data is made available in the "abc_oa" subdirectory.
Installation description
24 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.3 SINUMERIK Operate
Note
Any error messages that appear can normally be ignored.
File "abc_oa_v1_2_oaif4402300.tgz" is a temporary file (is located in a volatile memory) and is
deleted when the "sc reboot" command is executed or for power on.
Configuration example
A 3-axis SINUMERIK system comprises the following drive objects:
● Control Unit (DO_1)
● Infeed (DO_2)
● X axis (DO_3, AX1)
● Y axis (DO_4, AX2)
● Z axis (DO_5, AX3)
Procedure
Activate Technology Extension on the required axes as follows:
1. Deactivate the pulse enable for SINAMICS (e.g.via the EP terminal)
2. Set "Configure Technology Extension" on the Control Unit:
p0009 = 0 → 50
Installation description
Function Manual, 03/2020, A5E45590347B 25
Installing and activating
3.3 SINUMERIK Operate
3. Perform the following tasks for the first axis or drive object on which this Technology
Extension should be activated (e.g. DO_3, AX1):
p4956[0] = 0 → 1
For SINUMERIK, this is displayed as follows in the drive machine data:
Note
The number of Technology Extensions is displayed in r4950.
r4955[0…8] contains the identifier for Technology Extension 1.
r4955[9…17] contains the identifier for Technology Extension 2, etc.
r4950 = 1 means:
● Only one Technology Extension is available.
● In this case, p4956[0] is used to activate a Technology Extension.
r4950 > 1 means:
● Several Technology Extensions are available.
● The associated index for activating Technology Extension ABC_OA depends on the
designation.
– If r4955[0…8] contains "ABC_OA", p4956[0] applies.
– If r4955[9…17] contains "ABC_OA", p4956[1] applies, etc.
4. Repeat step 3 for all further axes on which this Technology Extension is to be activated (e.g.
DO_4, AX2).
Installation description
26 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.3 SINUMERIK Operate
5. End the configuration for the Technology Extension on the Control Unit:
p0009 = 50 → 0
Note
If extension modules (e.g. NX assembly units) are present, the following is true for axes
calculated on these modules:
For these modules, commissioning mode (p0009 = 50) must be set before the Technology
Extension for these axes can be activated.
Installation description
Function Manual, 03/2020, A5E45590347B 27
Installing and activating
3.3 SINUMERIK Operate
This description to upgrade a Technology Extension is valid both when using an HMI as well as
when using an SFTP client.
The upgrade is essentially a new installation of the latest version of the Technology Extension.
When upgrading, the previously used version of the Technology Extension is overwritten.
Devices
This description is valid for SINUMERIK control systems with SINAMICS Integrated:
● SINUMERIK 840D sl
● SINUMERIK ONE
Preconditions
● The installation package for Technology Extension ABC_OA
"abc_oa_v1_1_oaif04402300.tgz" has been installed and assigned to the required drive
objects, see "Installing and activating the Technology Extension (Page 23)".
● The installation package with the new version of the Technology Extension
"abc_oa_v1_2_oaif04402300.tgz" is ready:
– When using an HMI: on the FAT partition of the USB memory with the portable service
system.
– When using an SFTP client: on a local drive.
Procedure
Install the Technology Extension as described in the following chapters:
● "Installing Technology Extension on the drive unit (Page 23)"
● "Activating Technology Extension on the drive object (Page 25)"
During this procedure, the previously used version of the Technology Extension is overwritten.
Installation description
28 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.3 SINUMERIK Operate
3. The parameters set in a drive object in the previous version of the Technology Extension
and their values are retained.
4. New parameters of the newly installed version of the Technology Extension are
preassigned the factory settings and may have to be set.
Precondition
Deactivate the Technology Extension in the drive object using SINUMERIK Operate, see
"Activating Technology Extension on the drive object (Page 25)".
Procedure
Uninstall the Technology Extension using the SFTP client for Windows (e.g. WinSCP) as
follows:
1. Stop the system:
– Reestablish the connection using Secure Shell (SSH).
– Execute command "sc stop all".
2. Delete the subdirectory and files on the memory card:
– Select the system data.
– Select directory "/oem/sinamics/oa" under the system CF card.
– Select and delete subdirectory "abc_oa".
– Select and delete file "abc_oa.cfs".
Note
Pay attention to the sequence when deleting:
First delete the subdirectory and then the file.
Installation description
Function Manual, 03/2020, A5E45590347B 29
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Devices
This general description applies to:
● SINAMICS S120, S150, G130, G150, MV (CU320-2)
● SINAMICS S120 (CU310-2)
● SIMOTION D4x5-2 with SINAMICS Integrated
● SIMOTION D410-2 with SINAMICS Integrated
● SINAMICS DCM, DCP
Requirements
1. The current STARTER version is recommended for the installation. If scripting is to be used,
STARTER version V5.1 SP1 HF2 or higher should be used.
2. The installation package for Technology Extension ABC_OA
(oasp_abc_oa_v1_1_oaif04402300.zip) must be in a known directory.
Preconditions
The following preconditions must be met before installation:
1. The STARTER commissioning tool has been opened.
2. No project is open.
Installation description
30 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Procedure
Proceed as follows for installation:
1. From the "Tools" menu, choose the "Installation of libraries and technology packages"
function.
The "Installation of libraries and technology packages" window opens.
2. Click on "Add".
3. Open file "oasp_abc_oa_v1_1_oaif04402300.zip".
The technology package belonging to the Technology Extension ABC_OA is added.
4. Click the "Close" button.
Installation description
Function Manual, 03/2020, A5E45590347B 31
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Requirements
The following requirements must be met before downloading:
1. A project matching the device is open.
2. The STARTER commissioning tool is in ONLINE mode.
Procedure
To download, proceed as follows:
1. Right-click the drive unit in the project navigator.
2. Click "Select technology packages" in the shortcut menu.
The "Select technology packages" window opens.
3. For the technology package "ABC_OA", set the action "Load to target device"
Installation description
32 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Preconditions
1. A project matching the device is open.
2. The corresponding drive axes have been created in the project.
3. The STARTER commissioning tool is in the OFFLINE mode.
Procedure
To activate the Technology Extension in the drive object, proceed as follows:
1. In the project navigator, select the drive object for which the functionality is required (e.g.
SERVO_03).
2. Select "Properties" in the shortcut menu.
3. To activate the Technology Extension, select check box "ABC_OA" on the "Technology
packages" tab.
4. Click on "OK".
Note
If multiple versions of a Technology Extension are installed in STARTER, select the required
version, see "Downloading the technology package (Page 32)".
Installation description
Function Manual, 03/2020, A5E45590347B 33
Installing and activating
3.4 STARTER or SIMOTION SCOUT
6. To activate the Technology Extension for the drive object, download the project.
Set the mode to ONLINE and select "Download Project to Target System".
Procedure
To install the OA Support Package "oasp_abc_oa_v1_2_oaif04402300.zip", proceed as
described in Chapter "Installing the OA Support Package in STARTER (Page 30)".
After this installation, both versions of ABC_OA are visible in the window "Installation of libraries
and technology packages".
Installation description
34 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Installation description
Function Manual, 03/2020, A5E45590347B 35
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Requirements
The following requirements must be met before downloading:
1. A project matching the device is open.
2. The STARTER commissioning tool is in ONLINE mode.
Procedure
To download, proceed as follows:
1. Right-click the drive unit in the project navigator.
2. Click "Select technology packages" in the shortcut menu.
The "Select technology packages" window opens.
3. For technology package "ABC_OA", select version V01.20.02.00 under the column
"Version (offline)".
4. For the technology package "ABC_OA", set the action "Load to target device"
5. Click the "Perform actions" button.
6. Confirm the message that the existing technology package should be overwritten.
After successfully performing the action, the information "OK" is displayed for the
corresponding "Result" field.
Version V01.20.02.00 is now used on the drive device.
7. To activate the Technology Extension for the drive object, perform the project download.
Set the mode to ONLINE and select "Download Project to Target System".
Installation description
36 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Installation description
Function Manual, 03/2020, A5E45590347B 37
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Procedure
To uninstall a Technology Extension using STARTER or SIMOTION SCOUT, reverse the
installation sequence.
1. Deactivate the Technology Extension in the drive object, see "Activating the Technology
Extension in the drive object (Page 33)".
2. Delete the technology package belonging to the Technology Extension in the drive unit, see
"Downloading the technology package (Page 32)".
– Deactivate the technology package in OFFLINE mode.
– Save and compile the project.
– Download the project to the target device.
– For the technology package in ONLINE mode, select the "Delete" action and click the
"Perform actions" button.
3. Uninstall the Technology Extension in STARTER.
Installation description
38 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Preconditions
Using the scripting functionality assumes that you are familiar with script programming;
therefore, a general introduction will not be provided here.
The implementation is based on VBScript from MICROSOFT, which has been expanded to
include special objects and methods for STARTER. The current STARTER version is
recommended when using SINAMICS TEC scripting functions with STARTER. As a minimum,
STARTER version V5.1 SP1 HF2 must be used when using SINAMICS TEC scripting
functions.
Devices
This description applies to:
● SINAMICS S120, S150, G130, G150, MV (CU320-2)
● SINAMICS S120 (CU310-2)
● SIMOTION D4x5-2 with SINAMICS Integrated
● SIMOTION D410-2 with SINAMICS Integrated
● SINAMICS DCM, DCP
WARNING
Malfunctions as a result of incorrect scripts
Scripting provides extensive automation options that are required to be able to automate
manual operator actions in STARTER, therefore optimizing the time required for the recurring
configuration of projects and tasks. Incorrect configurations that are not identified in tests can
result in serious injury or death! The script programmer and the script user are responsible for
the operator actions implemented in the scripting.
● Run systematic tests on new and modified scripts to verify and validate them.
● Before running a script, carefully ensure it has the correct content! Verify and validate the
results when running a script by performing tests on the machine.
Installation description
Function Manual, 03/2020, A5E45590347B 39
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Note
Information about scripting, tools and application examples
● Detailed documentation about VBScript is available at the following address (https://
www.microsoft.com).
● Detailed notes for SIMOTION scripts are contained in SIMOTION Utilities & Applications.
This information is available on DVD or in the Internet at the following address (https://
support.industry.siemens.com/cs/document/26340545).
In addition to the SIMOTION Scripting Interface Manual and a script styleguide, there is a
collection of scripts that provide support when working with SIMOTION SCOUT.
Scripting variants
The following scripting variants are available in STARTER:
VBScript Internal
In the STARTER project navigator, script folders can be inserted under the project, each device
and each TO/DO. You can then insert the scripts into this script folder. Scripts are edited using
an internal editor. Scripts can be imported or exported in text format (ASCII) and XML.
VBScript External
Scripts can also be executed from Windows Explorer. STARTER does not have to be started
for this purpose. This allows operators without system knowledge to perform configuration
tasks. In this case, the script is available as a VBScript in an ASCII file "TECupdaten.vbs" in the
Windows file system, for example.
External scripting
For more complex scripting applications, you can implement your own application – which
provides a task-oriented user interface – and internal SIMOTION scripting, which uses the
STEP7 command interface and other scripting interfaces (e.g. for databases or XML). This
form of scripting is implemented using VisualBasic or Visual C#, for example.
Installation description
40 Function Manual, 03/2020, A5E45590347B
Installing and activating
3.4 STARTER or SIMOTION SCOUT
The methods listed can be removed from the complex context and separately applied. For
instance, a text file can be created using "GetActivatedTECs" that can be used for
documentation purposes or as configuration example.
The steps defined using scripting can also be extended to include additional actions. For
example, the results from "GetActivatedTECs" can be compared with the OASP in an
installation folder. If more recent versions are saved to the installation folder, then an update
can be fully automatically performed in STARTER.
Installation description
Function Manual, 03/2020, A5E45590347B 41
Installing and activating
3.4 STARTER or SIMOTION SCOUT
Installation description
42 Function Manual, 03/2020, A5E45590347B
Appendix A
A.1 List of abbreviations
Note
The following list of abbreviations includes all abbreviations and their meanings used in the
entire SINAMICS family of drives.
Installation description
Function Manual, 03/2020, A5E45590347B 43
Appendix
A.1 List of abbreviations
Installation description
44 Function Manual, 03/2020, A5E45590347B
Appendix
A.1 List of abbreviations
Installation description
Function Manual, 03/2020, A5E45590347B 45
Appendix
A.1 List of abbreviations
Installation description
46 Function Manual, 03/2020, A5E45590347B
Appendix
A.1 List of abbreviations
Installation description
Function Manual, 03/2020, A5E45590347B 47
Appendix
A.1 List of abbreviations
Installation description
48 Function Manual, 03/2020, A5E45590347B
Appendix
A.1 List of abbreviations
Installation description
Function Manual, 03/2020, A5E45590347B 49
Appendix
A.1 List of abbreviations
Installation description
50 Function Manual, 03/2020, A5E45590347B
Appendix
A.1 List of abbreviations
Installation description
Function Manual, 03/2020, A5E45590347B 51
Appendix
A.1 List of abbreviations
Installation description
52 Function Manual, 03/2020, A5E45590347B
Appendix
A.1 List of abbreviations
Installation description
Function Manual, 03/2020, A5E45590347B 53
Appendix
A.1 List of abbreviations
Installation description
54 Function Manual, 03/2020, A5E45590347B
Index
A I
ABC_OA Installation package, 13
Activating using SIMOTION SCOUT, 33 Installing the Technology Extension
Activating using SINUMERIK Operate, 25 Alternative installation using an FTP client, 24
Activating using Startdrive, 18 using SIMOTION SCOUT, 30
Activation using STARTER, 33 using SINUMERIK Operate, 23
Commissioning using SIMOTION SCOUT, 34 using Startdrive, 15
Commissioning using SINUMERIK Operate, 27 using STARTER, 30
Commissioning using Startdrive, 19
Commissioning using STARTER, 34
Installation using SIMOTION SCOUT, 30 S
Installation using SINUMERIK Operate, 23
SFTP client, 24
Installation using Startdrive, 15
Installation using STARTER, 30
Uninstalling using SIMOTION SCOUT, 38
Uninstalling using SINUMERIK Operate, 29
T
Uninstalling using Startdrive, 22 Technology Extension ABC_OA
Uninstalling using STARTER, 38 Activating using SINUMERIK Operate, 25
Upgrading using scripting methods, 41 Upgrading using scripting methods, 41
Upgrading using SFTP client, 28
Upgrading using SINUMERIK Operate, 28
Upgrading using Startdrive, 20 U
ABCS_OA
Uninstalling Technology Extension
Upgrading using SIMOTION SCOUT, 34
using Operate, 29
Upgrading using STARTER, 34
using SIMOTION SCOUT, 38
Activating Technology Extension
using Startdrive, 22
using SIMOTION SCOUT, 33
using STARTER, 38
using Startdrive, 18
Upgrading Technology Extension
using STARTER, 33
using scripting methods, 41
using SIMOTION SCOUT, 34
using SINUMERIK Operate, 28
C using Startdrive, 20
Commissioning the Technology Extension using STARTER, 34
using SIMOTION SCOUT, 34 using the SFTP client, 28
using SINUMERIK Operate, 27
using Startdrive, 19
using STARTER, 34 W
Commissioning tools, 13
WinSCP, 24
D
Devices
Installation using SIMOTION SCOUT, 30
Installation using SINUMERIK Operate, 23
Installation using Startdrive, 15
Installation using STARTER, 30
Installation description
Function Manual, 03/2020, A5E45590347B 55
Index
Installation description
56 Function Manual, 03/2020, A5E45590347B
Further information
Siemens:
www.siemens.com
Industry Online Support (service and support):
www.siemens.com/online-support
IndustryMall:
www.siemens.com/industrymall
Siemens AG
Digital Industries
Motion Control
Postfach 31 80
91050 ERLANGEN
GERMANY