Introduction 1

Fundamental safety
instructions 2

Overview 3
SINUMERIK
Layout and operation 4
SINUMERIK ONE
System Manual Run MyVirtual Working with machine
projects 5
Machine
3D simulation (option) 6
System Manual

Open interface (option) 7

Valid for:
MACHINUM
Run MyVirtual Machine V1.4
SINUMERIK ONE
SINUMERIK Virtual CNC software V6.23

01/2024
A5E48105802B AK
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 Aktiengesellschaft. 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.

Siemens Aktiengesellschaft A5E48105802B AK Copyright © Siemens 2017 - 2024.

Digital Industries Ⓟ 01/2024 Subject to change All rights reserved
Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents

1 Introduction ........................................................................................................................................... 7
1.1 About SINUMERIK ................................................................................................................ 7
1.2 About this documentation ................................................................................................... 7
1.3 Documentation on the internet ............................................................................................ 8
1.3.1 Documentation overview SINUMERIK ONE ........................................................................... 8
1.3.2 Documentation overview SINUMERIK operator components ................................................. 9
1.4 Feedback on the technical documentation ........................................................................... 9
1.5 mySupport documentation .................................................................................................. 9
1.6 Service and Support........................................................................................................... 10
1.7 Using OpenSSL .................................................................................................................. 12
1.8 Compliance with the General Data Protection Regulation.................................................... 12
2 Fundamental safety instructions......................................................................................................... 13
2.1 General safety instructions................................................................................................. 13
2.2 Warranty and liability for application examples ................................................................... 13
2.3 Cybersecurity information .................................................................................................. 13
3 Overview.............................................................................................................................................. 15
3.1 Deployed software ............................................................................................................. 15
3.2 General information........................................................................................................... 15
3.3 Demo mode version without license................................................................................... 17
4 Layout and operation........................................................................................................................... 19
4.1 Introduction....................................................................................................................... 19
4.2 User interface .................................................................................................................... 20
4.2.1 Project management.......................................................................................................... 20
4.2.2 Overview of project settings............................................................................................... 21
4.2.3 User interface (machine simulation)................................................................................... 24
4.3 Project settings .................................................................................................................. 29
4.3.1 Adapting the HMI resolution .............................................................................................. 29
4.4 Application settings ........................................................................................................... 30
4.4.1 Switching over the program language user interface .......................................................... 30
4.4.2 Window arrangement - standard, user-defined ................................................................... 30
4.4.2.1 User-defined window arrangement .................................................................................... 30
4.4.2.2 Creating a new window arrangement................................................................................. 31
4.4.2.3 Reset of the window arrangement to the standard ............................................................. 32
4.4.3 Switch between Create/Run MyVirtual Machine .................................................................. 33
4.4.4 Communication settings .................................................................................................... 34
4.4.4.1 Communication settings tab .............................................................................................. 34

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 3
Table of contents

4.4.4.2 Expert settings................................................................................................................... 35

4.5 Information application...................................................................................................... 46
4.5.1 Version information ........................................................................................................... 46
4.5.2 License info ....................................................................................................................... 46
4.6 Licensing ........................................................................................................................... 47
4.6.1 Licensing Create/Run MyVirtual Machine ............................................................................ 47
4.6.2 Local license ...................................................................................................................... 50
4.6.3 License server .................................................................................................................... 50
4.6.4 Installing the license server under Microsoft Windows ........................................................ 51
4.6.5 User interface of the licensing application .......................................................................... 54
4.6.6 Using local licenses ............................................................................................................ 56
4.6.7 Using the license server ..................................................................................................... 57
4.6.8 Command line of the licensing application ......................................................................... 57
4.6.9 Using the command line of the licensing application .......................................................... 59
5 Working with machine projects........................................................................................................... 61
5.1 Manage machine projects .................................................................................................. 61
5.2 Creating a machine project from a template ....................................................................... 62
5.3 Opening a machine project ................................................................................................ 65
5.4 Save the machine project and exit ...................................................................................... 67
5.5 Cross-version use of machine projects ................................................................................ 68
5.6 Project template and access rights...................................................................................... 68
5.7 Virtual memory card .......................................................................................................... 68
6 3D simulation (option)......................................................................................................................... 71
6.1 Product information........................................................................................................... 71
6.2 Using 3D simulation........................................................................................................... 71
6.3 Function scope and configuring.......................................................................................... 73
6.3.1 Function scope of the 3D simulation .................................................................................. 73
6.3.2 3D simulation restrictions .................................................................................................. 75
6.3.3 Constraints 3D Simulation in C/RMVM ................................................................................ 76
6.3.4 Simulation of measurement procedures and machine data ................................................. 78
6.3.5 Cutting off the workpiece and transferring to a counterspindle ........................................... 79
6.3.6 Traversing positioning axes (POS, POSA)............................................................................. 80
6.3.7 Travel to fixed stop ............................................................................................................. 81
6.3.8 Tips ................................................................................................................................... 81
6.3.8.1 3D Simulation is not started/displayed ................................................................................ 81
6.4 Operation and setting ........................................................................................................ 82
6.4.1 Data archiving, export/import, file format ........................................................................... 82
6.4.2 General information on operation ...................................................................................... 83
6.4.3 Operating 3D simulation using the keyboard ...................................................................... 84
6.4.4 Using layers ....................................................................................................................... 86
6.4.5 Settings ............................................................................................................................. 87
6.4.5.1 Settings ............................................................................................................................. 87
6.4.5.2 Exporting/importing archives ............................................................................................. 88
6.4.6 Switching between different unit systems ("metric"/"inch").................................................. 90
6.4.7 Requirements for 3D simulation ......................................................................................... 91

System Manual Run MyVirtual Machine

4 System Manual, 01/2024, A5E48105802B AK
 Table of contents

6.5 Components in the library.................................................................................................. 91

6.5.1 Library............................................................................................................................... 91
6.5.2 Component types and properties ....................................................................................... 94
6.5.3 Reference system of components ....................................................................................... 95
6.5.4 Tool ................................................................................................................................... 98
6.5.5 Adapter ........................................................................................................................... 100
6.5.6 Blank ............................................................................................................................... 101
6.5.7 Protection area (workholder):........................................................................................... 102
6.5.8 Setup (clamping) ............................................................................................................. 103
6.5.9 Creating components using the example of a blank .......................................................... 105
6.5.10 Blank from basic geometrical shapes ................................................................................ 108
6.5.11 Multi-part STP component for individual components....................................................... 110
6.5.12 Assigning mount stations for setups ................................................................................. 112
6.5.13 Multi-part STP component for setups................................................................................ 113
6.5.14 Set mounting point for configurations in the 3D model..................................................... 114
6.5.15 Exporting/importing library components .......................................................................... 116
6.6 Tools................................................................................................................................ 116
6.6.1 Tool manager................................................................................................................... 116
6.6.2 Tool manager and tool list in SINUMERIK Operate ............................................................. 118
6.6.3 Overview of tool types ..................................................................................................... 119
6.6.4 Protection areas for tools.................................................................................................. 121
6.6.5 Defining protection via parameters for milling tools/drill bits ............................................. 124
6.6.6 Defining protection via parameters for turning tools ......................................................... 127
6.6.7 Defining protection for milling tools/drill bits .................................................................... 132
6.6.8 Defining protection for turning tools................................................................................. 133
6.6.9 Adapter geometry "*.stl,*.stp" and library ........................................................................ 135
6.6.10 Using the adapter geometry from the library .................................................................... 137
6.6.11 Defining the adapter and tool geometry via the assembly ................................................. 138
6.6.12 Importing a tool geometry as "*.stl./*.stp"........................................................................ 140
6.6.13 Using the tool geometry from the library.......................................................................... 144
6.6.14 Aligning cutting edge D1 and tool geometry .................................................................... 145
6.6.15 Accepting a reference point from "*.stp" assembly............................................................ 149
6.6.16 Protection for multitools................................................................................................... 151
6.6.17 Defining multitool adapters and slots................................................................................ 153
6.6.18 Tools in the angle head .................................................................................................... 155
6.6.19 Tool-specific stock removal in different colors.................................................................... 157
6.7 Setup (clamping) ............................................................................................................. 159
6.7.1 Setup manager (clampings) ............................................................................................. 159
6.7.2 Fast protection (setup) ..................................................................................................... 160
6.7.3 Detailed protection (setup from library)............................................................................ 162
6.7.4 Changing the position of the MP (mounting point) in a setup ........................................... 164
6.7.5 Align reference point R to a work offset ............................................................................ 165
6.7.6 Several setups for a mount station ................................................................................... 166
6.7.7 Using several mount stations ........................................................................................... 168
6.8 Collisions ......................................................................................................................... 170
6.8.1 Collision detection ........................................................................................................... 170
6.8.2 Activating collision detection ........................................................................................... 173
6.9 Simulating machining operations and workflows.............................................................. 174
6.9.1 Measuring processes in the 3D simulation ........................................................................ 174
6.9.2 Automatic mode with 3D simulation ................................................................................ 175

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 5
Table of contents

6.9.3 Saving the configuration in the project ............................................................................. 176

6.10 Option /3D machine model (CMVM) ................................................................................. 177
6.10.1 Integrating 3D simulation into a project............................................................................ 177
7 Open interface (option) ..................................................................................................................... 181
7.1 Introduction..................................................................................................................... 181
Index .................................................................................................................................................. 183

System Manual Run MyVirtual Machine

6 System Manual, 01/2024, A5E48105802B AK
Introduction 1
1.1 About SINUMERIK
From simple, standardized CNC machines to premium modular machine designs – the
SINUMERIK CNCs offer the right solution for all machine concepts. Whether for individual parts
or mass production, simple or complex workpieces – SINUMERIK is the highly dynamic
automation solution, integrated for all areas of production. From prototype construction and
tool design to mold making, all the way to large-scale series production.
Visit our website for more information SINUMERIK (https://www.siemens.com/sinumerik).

1.2 About this documentation

Target group
This documentation is intended for the following target groups:
• CNC programming personnel for job planning
• Personnel in CNC training
• CNC operators (beginners or retraining)
• Sales personnel for the presentation of CNC or machine features in sales talks

Purpose
This documentation describes the fundamentals and the operation of Run MyVirtual Machine.

Benefits
This documentation enables the addressed target group to operate the system.

Standard scope
This documentation only describes the functionality of the standard version. This may differ
from the scope of the functionality of the system that is actually supplied. Please refer to the
ordering documentation only for the functionality of the supplied drive system.
It may be possible to execute other functions in the system which are not described in this
documentation. This does not, however, represent an obligation to supply such functions
with a new control or when servicing.
For reasons of clarity, this documentation cannot include all of the detailed information
on all product types. Further, this documentation cannot take into consideration every
conceivable type of installation, operation and service/maintenance.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 7
Introduction
1.3 Documentation on the internet

The machine manufacturer must document any additions or modifications they make to the
product themselves.

Websites of third-party companies

This document may contain hyperlinks to third-party websites. Siemens is not responsible for
and shall not be liable for these websites and their content. Siemens has no control over the
information which appears on these websites and is not responsible for the content and
information provided there. The user bears the risk for their use.

1.3 Documentation on the internet

1.3.1 Documentation overview SINUMERIK ONE

Comprehensive documentation about the functions provided in SINUMERIK ONE Version 6.13
and higher is provided in the Documentation overview SINUMERIK ONE (https://
support.industry.siemens.com/cs/ww/en/view/109768483).

You can display documents or download them in PDF and HTML5 format.
The documentation is divided into the following categories:
• User: Operating
• User: Programming
• Manufacturer/Service: Functions
• Manufacturer/Service: Hardware
• Manufacturer/Service: Configuration/Setup
• Manufacturer/Service: Safety Integrated
• Information and training
• Manufacturer/Service: SINAMICS

System Manual Run MyVirtual Machine

8 System Manual, 01/2024, A5E48105802B AK
 Introduction
1.5 mySupport documentation

1.3.2 Documentation overview SINUMERIK operator components

Comprehensive documentation about the SINUMERIK operator components is provided in the
Documentation overview SINUMERIK operator components (https://
support.industry.siemens.com/cs/document/109783841/technische-dokumentation-zu-
sinumerik-bedienkomponenten?dti=0&lc=en-WW).
You can display documents or download them in PDF and HTML5 format.
The documentation is divided into the following categories:
• Operator Panels
• Machine control panels
• Machine Pushbutton Panel
• Handheld Unit/Mini handheld devices
• Further operator components
An overview of the most important documents, entries and
links to SINUMERIK is provided at SINUMERIK Overview - Topic
Page (https://support.industry.siemens.com/cs/document/109766201/sinumerik-an-overview-
of-the-most-important-documents-and-links?dti=0&lc=en-WW).

1.4 Feedback on the technical documentation

If you have any questions, suggestions, or corrections regarding the technical documentation
published in the Siemens Industry Online Support, use the link "Give feedback" link which
appears at the end of the entry.

1.5 mySupport documentation

With the "mySupport documentation" web-based system you can compile your own individual
documentation based on Siemens content, and adapt it for your own machine documentation.
To start the application, click on the "My Documentation" tile on the "mySupport links and
tools" (https://support.industry.siemens.com/cs/ww/en/my) portal page:

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 9
Introduction
1.6 Service and Support

The configured manual can be exported in RTF, PDF or XML format.

Note
Siemens content that supports the mySupport documentation application can be identified by
the presence of the "Configure" link.

1.6 Service and Support

Product support
You can find more information about products on the internet:
Product support (https://support.industry.siemens.com/cs/ww/en/)
The following is provided at this address:
• Up-to-date product information (product announcements)
• FAQs (frequently asked questions)
• Manuals
• Downloads
• Newsletters with the latest information about your products
• Global forum for information and best practice sharing between users and specialists
• Local contact persons via our Contacts at Siemens database (→ "Contact")
• Information about field services, repairs, spare parts, and much more (→ "Field Service")

System Manual Run MyVirtual Machine

10 System Manual, 01/2024, A5E48105802B AK
 Introduction
1.6 Service and Support

Technical support
Country-specific telephone numbers for technical support are provided on the internet at
address (https://support.industry.siemens.com/cs/ww/en/sc/4868) in the "Contact" area.
If you have any technical questions, please use the online form in the "Support Request" area.

Training
You can find information on SITRAIN at the following address (https://www.siemens.com/
sitrain).
SITRAIN offers training courses for automation and drives products, systems and solutions from
Siemens.

Siemens support on the go

With the award-winning "Industry Online Support" app, you can access more than 300,000
documents for Siemens Industry products – any time and from anywhere. The app can
support you in areas including:
• Resolving problems when implementing a project
• Troubleshooting when faults develop
• Expanding a system or planning a new system
Furthermore, you have access to the Technical Forum and other articles from our experts:
• FAQs
• Application examples
• Manuals
• Certificates
• Product announcements and much more
The "Industry Online Support" app is available for Apple iOS and Android.

Digital product information as QR code

The ID link according to IEC 61406 provides you with digital information about your product.
The ID link is a globally unique identifier and appears as a QR code on the product.
You can recognize the ID link by the frame with a black corner at the bottom right.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 11
Introduction
1.8 Compliance with the General Data Protection Regulation

*%
-JOL

In addition to the digital nameplate you will find the following product information:
• Technical specifications
• FAQs
• Manuals
• Certificates
• Product announcements
• Application examples

1.7 Using OpenSSL

This product can contain the following software:
• Software developed by the OpenSSL project for use in the OpenSSL toolkit
• Cryptographic software created by Eric Young.
• Software developed by Eric Young
You can find more information on the internet:
• OpenSSL (https://www.openssl.org)
• Cryptsoft (https://www.cryptsoft.com)

1.8 Compliance with the General Data Protection Regulation

Siemens complies with standard data protection principles, in particular the data minimization
rules (privacy by design).
For this product, this means:
The product processes or stores the following personal data in log files.
• Name of the Windows user account in the specification of the user path (User-Path)
• Time stamp log functions for events that occurred
It does not involve data from the personal or private sphere. The above data is required for
the SINUMERIK Trace diagnostic function. The data saved is limited to the absolute minimum
as this is absolutely necessary for diagnostics purposes.

System Manual Run MyVirtual Machine

12 System Manual, 01/2024, A5E48105802B AK
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.

2.2 Warranty and liability for application examples

Application examples are not binding and do not claim to be complete regarding configuration,
equipment or any eventuality which may arise. Application examples do not represent specific
customer solutions, but are only intended to provide support for typical tasks.
As the user you yourself are responsible for ensuring that the products described are
operated correctly. Application examples do not relieve you of your responsibility for safe
handling when using, installing, operating and maintaining the equipment.

2.3 Cybersecurity information

Siemens provides products and solutions with industrial cybersecurity functions that support
the secure operation of plants, systems, machines and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is
necessary to implement – and continuously maintain – a holistic, state-of-the-art industrial
cybersecurity concept. Siemens’ products and solutions constitute one element of such a
concept.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 13
Fundamental safety instructions
2.3 Cybersecurity information

Customers are responsible for preventing unauthorized access to their plants, systems,
machines and networks. Such systems, machines and components should only be connected
to an enterprise network or the internet if and to the extent such a connection is necessary
and only when appropriate security measures (e.g. firewalls and/or network segmentation)
are in place.
For additional information on industrial cybersecurity measures that may be implemented,
please visit
https://www.siemens.com/cybersecurity-industry.
Siemens’ products and solutions undergo continuous development to make them more
secure. Siemens strongly recommends that product updates are applied as soon as they are
available and that the latest product versions are used. Use of product versions that are no
longer supported, and failure to apply the latest updates may increase customer’s exposure
to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Cybersecurity
RSS Feed under
https://new.siemens.com/cert.
Further information is provided on the Internet:
Industrial Security Configuration Manual (https://support.industry.siemens.com/cs/ww/en/
view/108862708)

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 state-of-the-art, integrated
industrial cybersecurity concept for the installation or machine.
• Make sure that you include all installed products in the integrated industrial cybersecurity
concept.
• Protect files stored on exchangeable storage media from malicious software by with suitable
protection measures, e.g. virus scanners.
• Carefully check all cybersecurity-related settings once commissioning has been completed.

System Manual Run MyVirtual Machine

14 System Manual, 01/2024, A5E48105802B AK
Overview 3
3.1 Deployed software

Software requirements
The installation of Create & Run MyVirtual Machine and other essential software components is
described in the Create & Run MyVirtual Machine Installation Manual. The Installation Manual
can be found on the installation medium in the folder ..\Documents\Readme\[language]\.

3.2 General information

Run MyVirtual Machine (Run MyVirtual Machine /Operate license)

Run MyVirtual Machine is an NC programming workstation with identical controls on the PC for
machine tools using SINUMERIK ONE.
The offline programming workstation Run MyVirtual Machine simulates a machine tool
controlled by SINUMERIK ONE. SINUMERIK Operate, together with a simulated machine
control panel, ensures realistic operation and programming on the PC. You only require
SINUMERIK CNC programming know-how.
Run MyVirtual Machine enables offline CNC programming on the PC, for example in work
preparation. Exactly the same scope of CNC language commands, CNC machining cycles,
and ShopMill/ShopTurn work steps is available as in the real CNC. Regardless of whether CNC
programs were generated via Run MyVirtual Machine itself or via CAM systems, they can be
checked for freedom from errors in the best possible way.
Run MyVirtual Machine is therefore the optimal tool to increase efficiency and process
reliability in CNC programming.
Furthermore, Run MyVirtual Machine permits easy learning and professional training of
CNC operation and programming without a real CNC, for example in training classrooms.
For this purpose, preconfigured sample machines are available for immediate use. Using
SINUMERIK Operate and the original SINUMERIK CNC kernel, all operating processes and NC
programming operations can be used and CNC programs executed, without any restrictions.
New functions and programming options can thus be learned, tested and demonstrated in a
secure environment.
To get the highest possible match with the real CNC, you can load machine projects (*.vcp)
matching the respective machine. Contact your machine manufacturer for this purpose.
Since the machine projects are always assigned to a version of the SINUMERIK Virtual CNC
software, different SINUMERIK Virtual CNC software versions can be stored in Run MyVirtual
Machine.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 15
Overview
3.2 General information

This means that machines from different manufacturers can be provided with different
versions of the SINUMERIK Virtual CNC software at one work station in the CNC work
preparation.

Run MyVirtual Machine /Open

Run MyVirtual Machine /Open is an additional option to Run MyVirtual Machine /Operate. You
need it to operate an external SW application, for example, your own machine room simulation.

Run MyVirtual Machine /3D

Run MyVirtual Machine /3D is an additional option to Run MyVirtual Machine /Operate. This
option extends Run MyVirtual Machine to include integrated 3D machining and material
removal simulation. This enables you to evaluate machine movements visually and to check for
freedom from collision. Using the material removal simulation, workpiece machining can be
tested in advance via simulation.
The 3D Simulation is also ideal for training setup procedures and running in machines on a
virtual model without exposure to any risks whatsoever.

Run MyVirtual Machine demo mode (without license)

Run MyVirtual Machine can also be used without a license. After installation, use Run MyVirtual
Machine without a license in the demo mode variant. In this variant you can only open and work
with special template machine projects. The demo machine projects are provided via the
installation package "Machine Projects Create/Run MyVirtual Machine". The functionality of
these machine projects is limited in demo mode (project cannot be saved).

Demarcation with respect to Create MyVirtual Machine

Create MyVirtual Machine is a software solution that allows machine manufacturers to create
their machine automation software offline without real prototype machines. Create MyVirtual
Machine is also required by machine manufacturers to create individual machine projects
(*.vcp) for the Run MyVirtual Machine software solution.

Components of the Run MyVirtual Machine overall system

Run MyVirtual Machine has software components that correspond to real CNC equipment:
• Virtual CNC core
• Virtual CNC user interface Sinumerik Operate
• Virtual machine control panel (MCP)
• Virtual PLC adaptive control (S7-1500)
• Virtual PLC I/O
• Drive simulation (simDrive)
• 3D Simulation of the machine interior (option)
• Open interface for integration of external simulation tools (option)

System Manual Run MyVirtual Machine

16 System Manual, 01/2024, A5E48105802B AK
 Overview
3.3 Demo mode version without license

3.3 Demo mode version without license

Run MyVirtual Machine can also be used without a license. After installation, use Run MyVirtual
Machine without a license in the "demo mode" variant. In this variant you can only open and
work with special marked machine projects. The functionality of Run MyVirtual Machine in
demo mode is restricted. Demo machines do not support the full scope of functions of Run
MyVirtual Machine or the SINUMERIK CNC software. This means that the changes (e.g. modified
NC programs, created clamping fixtures, etc.) to the started projects cannot be saved and are
reset to the initial state each time the machine project is restarted. The demo machine projects
are provided via the installation package "Machine Projects Create/Run MyVirtual Machine".

Note
With a license, demo machine projects in Run MyVirtual Machine can be used like "normal"
template projects and benefit from the full range of functions. Saving a demo machine project
deletes the use of the demo machine project without a license, i.e. the machine project can then
only be used with Run MyVirtual Machine and a valid license.

Run MyVirtual Machine demo mode (without license)

When using the demo machine projects in Run MyVirtual Machine demo mode, the following
constraints apply.
• Demo machine projects are preconfigured machines that cannot be changed.
• You cannot save changes to demo machine projects. You need a license to save them.
• You can start and operate the demo machines.
• For example, you have the option of transferring workpieces and part programs to the
machine for program simulation and customization, and then exporting them from the
machine for further use on CNCs.
• The access level can only be selected via the keyswitch. It is not possible to enter a password
for higher access levels.

Overview demo machines

The following machines are available as template machines in Run MyVirtual Machine demo
mode. The demo machine projects are marked with the addition (Demo) in the machine project
name.
• Turning machine (SinuTurn-DT (Demo).vcp)
1-channel, 3-axis machine with main spindle and driven tool spindle
• Milling machine (SinuMill3 (Demo).vcp)
1-channel, 3-axis machine

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 17
Overview
3.3 Demo mode version without license

• Milling machine (SinuMill3+2-AC (Demo).vcp)

1-channel, 3+2-axis machine
• Turning machine with robot (Robotics6-Handling (Demo).vcp)
Turning machine with main spindle and handling robot

System Manual Run MyVirtual Machine

18 System Manual, 01/2024, A5E48105802B AK
Layout and operation 4
4.1 Introduction
In Run MyVirtual Machine you work with machine projects for a wide range of different types of
CNC machines with SINUMERIK ONE control systems. Within the respective machine project, the
virtual SINUMERIK with CNC user interface, CNC core functions, and optionally a 3D simulation
of the machine room are available.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 19
Layout and operation
4.2 User interface

4.2 User interface

4.2.1 Project management

You manage machine projects ("*.vcp") in the project management of run MyVirtual Machine.
These are either provided by machine OEMs or saved in the system as template (template/
sample machines for training purposes).

1 2

① Open project
Opens existing projects from the overview.
Create new project
Creates a new project based on a template.
② Overview of recently opened machine projects with storage path, CNC software version used, and date of change.
③ Remove
Removes projects from the project overview. The machine project is only deleted from the overview, and remains on
the data storage medium.
Browse
Searches the data storage medium for projects and enters them into the overview.
Open project
Opens a selected machine project in the overview.
Start project
Opens a selected machine project from the overview. The machine is automatically started.

System Manual Run MyVirtual Machine

20 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.2 User interface

4.2.2 Overview of project settings

Project settings
After opening the project, the "Project settings" are first displayed. Here, you can configure
specific project settings, save and start the project.

2 3 4 5 6
1

7 8

10

Figure 4-1 Project settings using a milling machine as example

① Basic functions
Click on the buttons to use the basic functions of Run MyVirtual Machine.

Displays of the project overview

Settings
Setting the user interface language and the communication connections
Information
Display of the version and license information

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 21
Layout and operation
4.2 User interface

② Title bar
Display of the project name and version of the CNC software.

③ Managing the opened machine project

• Save
Saves the open machine project.
Machine projects can be saved only if the machine simulation has been previously exited.
• Save as
Saves the open machine project under a new name or in another folder.
Machine projects can be saved only if the machine simulation has previously been exited.
• Memory card
Opens Windows Explorer with the storage location of the virtual memory card.
• Close project
Closes an open machine project. If there are unsaved changes, a note is displayed, and you
can save the project before closing.

④ Start simulation

Start simulation of the machine.

The simulation control cannot be operated during the run-up phase.

⑤ Switch between Run/Create MyVirtual Machine

Click on the button to switch between the Run MyVirtual Machine and Create MyVir‐
tual applications. The button becomes only active when a project is opened or started.
If the project is open, a switchover is performed directly. In case of a started project,
a reset of the started machine project is performed. The source application is changed
to the predefined layout and functionality of the target application. A change only
takes place if the previously assigned licenses of the source application are also avail‐
able for the target application.

⑥ Manage window arrangement and windows

Click on the button to create or select a window arrangement. You can save the
arrangement of the individual windows as user-defined arrangement. You can create,
save and delete user-defined window arrangements.
Click on the button to display/hide the window areas. Check/uncheck the checkbox in
front of the respective window name in the displayed list.
You can remove the individual windows using the buttons, and dock them at
any other position in Run MyVirtual Machine. For example, you can display HMI SINUMERIK
Operate in a separate window.

System Manual Run MyVirtual Machine

22 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.2 User interface

⑦ Project information
The following project information is displayed here. You define the project information when
creating the project.
• Project name and project path
• CNC software version
• Displays whether the machine project includes a 3D model (yes/no)
• You can optionally enter a comment.

⑧ Machine diagram
You can optionally assign a unique machine diagram to the project.

Click on the button to integrate a graphic file as machine diagram. You can only select
valid graphic formats.
Click on the button to delete the machine diagram that was inserted.

⑨ HMI settings
You can only change the project settings if the simulation of the machine has not been started.
• HMI resolution
Select the resolution of the HMI of SINUMERIK Operate. The HMI will be displayed in the
selected resolution at the next startup.
• Navigation bar
Activate the checkbox if you want the lateral navigation bar to be displayed in the HMI. Using
the navigation bar, you can quickly access machine areas of the HMI, e.g. program or tool list.

⑩ Machine control panel

The machine control panel displayed is used in the project. This cannot be changed in Run
MyVirtual Machine.
• Control panel type
Display of the machine control panel (e.g. MPC 483 for milling or MCP 483 for turning) used
in the machine project.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 23
Layout and operation
4.2 User interface

4.2.3 User interface (machine simulation)

Using Run MyVirtual Machine corresponds to a real control system equipped with a SINUMERIK
Operate user interface and machine control panel. The machine basic screen is displayed after
the control ramp-up.

1 3 4 5 6 7 8

9 10

11 12

13

14 15

① Basic functions
Click on the buttons to use the basic functions of Run MyVirtual Machine.

Opens the project management/project overview

Settings
Opens the settings to switch between languages and reset the window layout
Information
Displays of the version information

System Manual Run MyVirtual Machine

24 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.2 User interface

② Help and window functions

Open/close Help. The Help is displayed in a separate viewlet. You can extract the
viewlet and display it as a separate window.
Minimizing or maximizing the application window or closing the entire applica‐
tion.
Open/close Help. The Help is displayed in a separate viewlet. You can extract the viewlet and
display it as a separate window.

③ Title bar
Display of the project name and version of the CNC software.

④ Simulation control

Clock cycle counter (optional)

Displaying previous servo clock cycles.
In "Settings", you can configure whether the
clock cycle counter is displayed. As default, it is
hidden.
Change simulation speed from standstill
(pause – system stopped) up to the maximum
speed.
Using the simulation control, you configure how much CPU performance should be used for
Run MyVirtual Machine when in the simulation mode. For normal operation, keep the slider
at the maximum position (+).
• In the left-hand position (-) 0 %, the simulation is in the pause status. In this state, the "frozen"
machining process can be observed. Changes to values and operating actions are not
possible or lead to inconsistent states in the machine project.
• In the center position 100 %, the simulation speed approximates the speed/clock cycle of a
real machine and runs approximately in real-time.
• In the right (+) position, the simulation runs with maximum speed. The percentage display
specifies how much faster the system operates when compared with real-time. For example,
the value 800% corresponds to approximately the 8-fold real-time speed. The maximum
simulation speed is limited by several factors, including the computer power.

Note
Program runtimes and simulation control
The simulation control does not influence determining the program runtimes of NC programs.
Independent of the position of the slider, after running through the simulation or after
executing NC programs, identical runtimes are obtained. Just like at the real machine, only
changes to the override influence the determined program runtime.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 25
Layout and operation
4.2 User interface

⑤ Managing the machine project

• Memory card
Opens Windows Explorer with the storage location of the virtual memory card.
• Close project
Closes an open machine project. If there are unsaved changes, a note is displayed, and you
can save the project before closing.

⑥ Stop/reset simulation

Exit simulation of the machine.

Reset
Initiate NCK/PLC warm restart

⑦ Switch between Run/Create MyVirtual Machine

Click on the button to switch between the Run MyVirtual Machine and Create MyVir‐
tual applications. The button becomes only active when a project is opened or started.
If the project is open, a switchover is performed directly. In case of a started project,
a reset of the started machine project is performed. The source application is changed
to the predefined layout and functionality of the target application. A change only
takes place if the previously assigned licenses of the source application are also avail‐
able for the target application.

⑧ Manage window arrangement and windows

Click on the button to create or select a window arrangement. You can save the
arrangement of the individual windows as user-defined arrangement. You can create,
save and delete user-defined window arrangements.
Click on the button to display/hide the window areas. Check/uncheck the checkbox in
front of the respective window name in the displayed list.
You can detach, dock or close an individual window using the buttons.
To release the window so that it can be moved and shown as an autonomous window, click
on the "v" button.
• Anchor a window at another position in the basic window
Drag the window to the required window icon using the mouse. The window is then
automatically docked.
• Window on a second monitor, e.g. 3D Simulation
Drag the window to the required monitor using the mouse.
Using a docking operation, the separated windows are embedded at the original location in
the basic window. Save the new window arrangement as user-defined window arrangement.

System Manual Run MyVirtual Machine

26 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.2 User interface

⑨ HMI SINUMERIK Operate

The HMI SINUMERIK Operate viewlet contains the SINUMERIK Operate commissioning and
operating software.

⑩ Project settings
Displays the project settings. You can only change the settings if the simulation of the machine
is stopped.

⑪ Display of the component status with time measurement, clock cycle counter, and cycle time
This display provides only information whether the individual component runs correctly.
The time measurement is displayed in the component status display. For non-clocked
components, the booting time and the shutdown time are shown. After the first ramp up, the
shutdown time is still zero.
The clock cycle counters and the cycle times of the clocked components are also shown in
the component status display. The minimum, the maximum and the average cycle time are
shown from top to bottom.
The status of the individual components is indicated using a colored rectangle:

Already started component (green)

Component starting at that instant in time (gray/green)
Component shutting down at that instant in time (green/gray)
Not started component (gray)
Faulty component (red)

Note
The components are monitored during the ramp-up phase and the cyclical operation of the
machine. If no communication can be established between the components (e.g. faulty
components are no longer available or incorrectly configured), the attempt to establish
communication is terminated after a configured interval (timeout). Faulty components remain
in the status red (not available).

⑫ NCU
The display provides information on the current status of the PLC.
PLC status LED

• RN Run/Stop LED
• ER Error LED
• MT Maintenance LED

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 27
Layout and operation
4.2 User interface

PLC mode selector switch

Not available in Run MyVirtual Machine.

⑬ PLC I/O table

You read and write the PLC inputs and outputs with the integrated I/O simulation. Outputs with
status LEDs and inputs with toggle switches are configured in the table rows of the expandable
PLC I/O table. As a machine operator, you do not usually use a PLC I/O table.

Note
In a few exceptional cases, it may be necessary for signals from the integrated adaptation control
to be displayed or influenced. Contact your machine manufacturer for this.

⑭ Virtual machine control panel

• EMERGENCY STOP
The status of the EMERGENCY STOP (pressed) is indicated by a pictogram below the red
button. It may be necessary that you acknowledge the tripping of the EMERGENCY STOP, for
example, using the reset button on the machine control panel. When required, contact the
person who created the machine project.

• Feedrate and spindle override

• Alarm, Channel, Help keys
• User-assignable function keys
• Keyswitch (0-3)

⑮ 3D Simulation (option)
During execution of an NC program in AUTOMATIC mode, 3D Simulation with collision detection
enables you to check the machining process so that any program errors can be detected.

Mechanical properties
Not available in Run MyVirtual Machine.

System Manual Run MyVirtual Machine

28 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.3 Project settings

4.3 Project settings

4.3.1 Adapting the HMI resolution

The screen resolution of the CNC user interface (HMI SINUMERIK Operate) in the machine
project can be set. This gives you the possibility to adjust the representation of the machine
project as best as possible to the respective screen resolution of your simulation PC.

Requirement
You can only change the HMI resolution in the "Project settings" when the project is open. The
machine simulation is in the stop state.

How to adapt the HMI resolution

1. In the opened "Project settings" viewlet, select the respective resolution from the list.

Figure 4-2 Selecting the HMI resolution

2. Start the machine project by pressing button "Start machine".

The machine project is started with the selected resolution of the HMI.

Note
The available HMI resolutions depend on the respective version of the virtual CNC software.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 29
Layout and operation
4.4 Application settings

4.4 Application settings

4.4.1 Switching over the program language user interface

You can switch the program language of the user interface (Create & Run MyVirtual Machine) to
all installed languages.

Note
Languages and HMI SINUMERIK Operate
Switching over the language in Create & Run MyVirtual Machine does not change the language
set in HMI SINUMERIK Operate. You change the language in SINUMERIK Operate in exactly the
same way as at the real machine in area "commissioning" -or switch between installed languages
using key combination "STRG+L".

This is how you switch between program languages

1. Click the "Settings" button .
2. In the window that is displayed, select tab "General settings".
3. Select the new program language.
4. Click "Apply".
The language is only switched over after Create/Run MyVirtual Machine is restarted.

4.4.2 Window arrangement - standard, user-defined

4.4.2.1 User-defined window arrangement

You define the arrangement of the windows and which windows are displayed via the standard
window arrangement or via the user-defined window arrangements. The standard view is
specified and changes cannot be saved. User-defined window arrangements can be freely
configured.

System Manual Run MyVirtual Machine

30 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

Managing window arrangements

① Click on the button to display or close the menu of the window arrangements.
② Save or delete an active user-defined window arrangement or reset it to the last arrangement that
was saved
③ Standard window arrangement
Changes to the standard view cannot be saved. The standard view cannot be deleted.
If you wish to display the application in the standard view, then activate "Standard".
④ Create a new user-defined window arrangement
Enter a name and click on the plus symbol "+". A new window arrangement is created, based on
the current arrangement.
⑤ List of available user-defined window arrangements
In the example "User Layout 1" is active
Figure 4-3 Managing window arrangements

See also
Creating a new window arrangement (Page 31)
Reset of the window arrangement to the standard (Page 32)

4.4.2.2 Creating a new window arrangement

Using user-defined window arrangements, adapt the view of Create or run MyVirtual Machine
in order to create the optimum window arrangement for the particular task. For example, if you
work with 3D simulation, undock the window and shift it to a second monitor. Once you have
set the window arrangement, save it as user-defined view and toggle between the different
views. You can create as many user-defined window arrangements as required.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 31
Layout and operation
4.4 Application settings

This is how you create a user-defined window arrangement

1. In the navigation bar, click on the "Define or edit window arrangement" button .
2. In the window that opens, enter a new name in the "Name of new window arrangement"
field.
The name is marked red if characters or special characters, which are not permissible, are
used in the name. Only letters, numbers and spaces are permitted in the name.
3. Click on the plus symbol "+". A new user-defined window arrangement is created with the
name that was entered.
4. Use the buttons in the title bar of each window to undock individual windows or
to shift a window to another position. You can minimize or close windows that are not
required. Appropriately adjust the window arrangement.
5. In the menu of the window arrangement, click on "Reset window arrangement" , if you
wish to reset changes that have not been saved.
6. After completing the operation, click on "Save" . The current view is saved in the user-
defined window arrangement.
7. You can toggle between the individual views by clicking on the window arrangements that
have been created.

See also
User-defined window arrangement (Page 30)

4.4.2.3 Reset of the window arrangement to the standard

You can set a modified window arrangement back to the original view by clicking on the "Reset
window arrangement" button. Selecting "Standard" corresponds to the specified view.

This is how you reset a modified window arrangement back to "Standard"

You have changed the window arrangement in the "Standard" window arrangement, and you
want to reset this to the original state.
1. In the navigation bar, click on the "Define or edit window arrangement" button .
2. Check whether the "Standard" window arrangement is active.
3. In the menu of the window arrangement, click on "Reset window arrangement" .
The view is reset to "Standard".

This is how you switch from a user-defined window arrangement to "Standard"

You want to switch from a user-defined window arrangement to the "Standard" view.
1. In the navigation bar, click on the "Define or edit window arrangement" button .
2. Activate the "Standard" window arrangement.
The view is set to "Standard".

System Manual Run MyVirtual Machine

32 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

4.4.3 Switch between Create/Run MyVirtual Machine

As of version V1.3.2, you can switch between the Run MyVirtual Machine and Create
MyVirtual Machine products during operation. Depending on the active license and which
application is selected, the range of functions is thus extended or restricted.
Switching between the applications is helpful, for example, if you have completed a machine
project in Create MyVirtual Machine and want to test the machine project in Run MyVirtual
Machine (e.g. machine project for customer).

NOTICE
Restrictions when switching from Run MyVirtual Machine to Create MyVirtual Machine
If Run MyVirtual Machine is active on the computer and you switch to Create MyVirtual
Machine, an export/import of SINAMICS drive data is only possible after you have stopped and
restarted the machine project. A reset of the machine project, as performed when changing the
application, is not sufficient.

Requirement
• Create & Run MyVirtual Machine is installed on the computer.
• The same licenses (basic and optional license) are available for the active (source application)
and on the application to be switched to (target application).

Licenses before the switchover Required licenses for a successful switchover

Basic license: Create MyVirtual Machine Operate Basic license: Run MyVirtual Machine Operate
Optional license: 3D Optional license: 3D

Example of switching from Create MyVirtual Machine to Run MyVirtual Machine

• A machine project is opened or started

Note
You can check which licenses are currently assigned via " > License info".

How to change the application

1. Click the "Switch to the application ..." button .
Before switching, a check is made to ensure that the same licenses exist for the source and
target applications. If no corresponding licenses are found, the switchover is not performed.
If the check is successful, the licenses for the source application are released and the licenses
for the target application are assigned.
2. Confirm the displayed messages with "Yes".
A reset is performed for a started machine project. With an open project, the switchover is
executed immediately.
After the switchover, the user interface and the range of functions are changed to the target
application.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 33
Layout and operation
4.4 Application settings

4.4.4 Communication settings

4.4.4.1 Communication settings tab

In the "Settings" tab in Create & Run MyVirtual Machine, you configure the communication
settings (PG/PC interface), e.g. for communication between HMI and PLC. The communication
settings are automatically configured and displayed. Further settings are usually not necessary.

Checking the communication settings

The communication settings are checked when starting a machine project. If a valid setup is not
available, and communication is not taking place an error message is displayed and the NCU
remains in the stop state.
In this case you must check the current communication settings.

Requirement
• Create & Run MyVirtual Machine and SINUMERIK Virtual CNC software are installed on the
computer and licensed
• Create or Run MyVirtual Machine is open

How to configure/check the communication settings

1. Click the "Settings" button .
2. Select tab "General settings" in the window that opens.
3. In selection list "Access point 1 - S7Online / CP1543", select the interface name of the
hardware that is used (first network adapter). The access points for S7Online and CP1543 are
configured at the same time.
The selection of possible interfaces is logically prefiltered.
Note
You can display information about a specific function using the button.

4. Optional, if you are using a second access point:

In selection list "Access point 2 - CP1543_2", select the interface name of the hardware that
is used (second network adapter).
The selection of possible interfaces is logically prefiltered. If you do not use the second access
point, the selection remains empty or select the "empty" entry.
Note
Only different interfaces can be selected for access point 1 and access point 2.

5. Activate "Support TIA device search".

Default setting, should not be changed.

System Manual Run MyVirtual Machine

34 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

6. Click "Apply".
The "Apply" button is only active if the communication settings have been correctly
configured.
7. If a project was open, restart the machine project after configuring the communication
settings. The new communication settings are active.

Result
The communication settings have been configured. Create & Run MyVirtual Machine can be
used.

More information
If you want to make further settings or work with the "Siemens communication settings"
application, refer to the "Expert settings (Page 35)" section. All settings and special cases are
described in detail in this section.

4.4.4.2 Expert settings

Configuring communication settings (PG/PC interface)

Description
You must configure the communication settings (PG/PC interface) for communications between
the TIA Portal or HMI and PLC.
If you select an interface parameter assignment, then assign this to the access point. This
means that you establish the connection between the access point, the interface parameter
assignment and the interface itself.

Note
Establishing communication with SIMATIC STEP 7 Professional on a second computer
The network adapter configured at the SINUMERIK CP1543 access point is relevant to the
communication between SIMATIC STEP 7 Professional and the MyVirtual Machine products. If
communication takes place across computer boundaries (e.g. SIMATIC STEP 7 Professional on
another computer in the network), the network adapter with which the computer is connected
to the network must be configured at the SINUMERIK CP1543 access point. The same network
adapter must be configured for SINUMERIK CP1543 and S7ONLINE (STEP 7).

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 35
Layout and operation
4.4 Application settings

Options for configuring communications

You have two options when configuring the PG/PC interface
• Configuring in Create/Run My Virtual Machine under "Settings" in tab "Communication
settings (Page 36)"
→ For the compact and simple setup of the PG/PC interface
• Configuring using application "Siemens communication settings (Page 37)"
→ More complex operation with access to additional communication parameters
Both variants configure the same communication parameters and visualize identical settings.

Checking the communication settings

The communication settings are checked when starting a machine project. If a valid setup is not
available, and communication is not taking place an error message is displayed and the NCU
remains in the stop state.
Restart the machine project after configuring the communication settings. The new
communication settings are active.

Configuring access points at the CP and S7Online in MyVirtual Machine

Configure the communication settings for the access points in tab "Settings" in Create/Run
MyVirtual Machine.

Requirement
• Create & Run MyVirtual Machine and SINUMERIK Virtual CNC software are installed on the
computer
• Create or Run MyVirtual Machine is open

This is how you configure communication settings

1. Click the "Settings" button .
2. Select tab "General settings" in the window that opens.
3. In selection list "Access point 1 - S7Online / CP1543", select the interface name of the
hardware that is used (first network adapter). The access points for S7Online and CP1543 are
configured at the same time.
The selection of possible interfaces is logically prefiltered.
Note
You can display information about a specific function using the button.
(Corresponds to communication setting "Configuring access points at the CP and S7Online
(Page 37)")

System Manual Run MyVirtual Machine

36 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

4. Optional, if you are using a second access point:

In selection list "Access point 2 - CP1543_2", select the interface name of the hardware that
is used (second network adapter).
The selection of possible interfaces is logically prefiltered. If you do not use the second access
point, the selection remains empty or select the "empty" entry.
(Corresponds to communication setting "Configuring the second access point at the CP
(optional) (Page 40)")
Note
Only different interfaces can be selected for access point 1 and access point 2.

5. Activate "Support TIA device search".

When the switch is activated, the device search for a locally installed TIA Portal is supported.
For the network adapter set in access point 1, function "DCP" in S7Online is deactivated. DCP
queries are responded to via the CP1543.
(Corresponds to communication setting deactivate DCP in Section "Configuring access points
at the CP and S7Online (Page 37)")
6. Click "Apply".
The "Apply" button is only active if the communication settings have been correctly
configured.
7. If a project was open, restart the machine project after configuring the communication
settings. The new communication settings are active.

Result
You have now configured the access points for the application. Create/Run MyVirtual Machine
can be used.

More information
If SIMATIC STEP7 Professional and Create/Run MyVirtual Machine are installed on different
computers / virtual machines, you must still make settings for cross-computer TCP
communication. Observe the Preparing cross-computer communication via Ethernet
(Page 42) section.

Configuring access points in den "Siemens communications Settings"

Configuring access points at the CP and S7Online

You configure the PG/PC settings using the "Siemens communication settings" application.

Precondition
Create/Run MyVirtual Machine and SINUMERIK Virtual CNC software are installed on the
computer.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 37
Layout and operation
4.4 Application settings

This is how you configure communication settings

1. Enter "Control Panel" in the search field of the Windows taskbar and open the displayed
application.
2. Select "All control elements".
3. Click "Communication settings". The "Siemens communication settings" window opens.
4. Click "Access points" in the navigation. The available access points are displayed in the right-
hand area.
5. Click the arrow in front of "S7ONLINE" to display the settings.
6. In the "Used interface parameter assignment" field, select the entry "<network
adapter>.TCPIP.1". <network adapter> is a placeholder for the interface name of your
deployed hardware.

Figure 4-4 Setting the access point

7. Click "Apply".
8. Click the arrow in front of "SINUMERIK_CP1543" to display the settings.
9. In the "Assigned interface parameter assignment" field, select the entry "<network
adapter>.TCPIP.1". <network adapter> is a placeholder for the interface name as used
previously.
10.Click "Apply".

System Manual Run MyVirtual Machine

38 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

11.Click on "LLDP/DCP" in the navigation. The available protocols are displayed in the area on the
right.
Note
To ensure communication mechanisms/device search between Create/Run MyVirtual
Machine and TIA Portal, you need to deactivate the DCP function on the computer with
Create/Run MyVirtual Machine (S7DOS). If the DCP function is disabled, then the "Livesearch"
function is also functional when searching for the target system for Create/Run MyVirtual
Machine. For the network adapter set in access point 1, function "DCP" in S7Online is
deactivated. DCP queries are responded to via the CP1543.
If DCP is not deactivated, the connection to an incompatible device may be detected and
reported in TIA Portal.

12.Uncheck the DCP box for the network adapter "<network adapter>" (same adapter as in the
section above under point 9).

Figure 4-5 Disabling the DCP function

13.Click "Apply".
14.Select "File > Exit" in the menu to close the window.
15.Restart the computer to apply the changes.

Result
You have now configured the access points for the application. Create/Run MyVirtual Machine
can be used.

More information
If SIMATIC STEP7 Professional and Create/Run MyVirtual Machine are installed on different
computers / virtual machines, you must still configure the settings for cross-computer TCP
communication. Observe the Preparing cross-computer communication via Ethernet
(Page 42) section.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 39
Layout and operation
4.4 Application settings

Configuring a second access point at the CP (optional)

The CP1543 can optionally communicate via a second network. For this purpose, you can assign
another network adapter to the SINUMERIK CP1543_2 access point provided for this purpose.
This can make sense if communications should be established to an external component via the
second network adapter.
Without assignment, the system behaves as before and uses only the two previously known
access points S7ONLINE and SINUMERIK CP1543.
Only when the second access point is assigned to SINUMERIK CP1543_2 will two interfaces
actually be processed by the CP.

Precondition
• Create/Run MyVirtual Machine and SINUMERIK Virtual CNC software are installed on the
computer.
• The "Siemens communication settings" are open (See, Configuring the first access point at
the CP (Page 37)).

This is how you configure the second access point in the communication settings
1. Click "Access points" in the navigation. The available access points are displayed in the right-
hand area.
2. Click the arrow in front of "SINUMERIK_CP1543_2" to display the settings.

System Manual Run MyVirtual Machine

40 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

3. In the "Used interface parameter assignment" field, select the entry "<network
adapter>.TCPIP.1". <network adapter> is the placeholder for the interface name of the
second network adapter.

Figure 4-6 Setting the second access point CP1543_2

4. Click "Apply".
5. When using "Livesearch", deactivate the DCP functions on the second network adapter (See
Configuring the first access point at the CP (Page 37)).
6. Select "File > Exit" in the menu to close the window.

Communication HMI via alternative network adapter

If the HMI is to communicate with SINUMERIK Operate not via the primary network adapter
(localhost) but via the second assigned network adapter, the IP address assigned at the second
network adapter must be entered in the mmc.ini configuration file of HMI Operate.

Requirement
• The Create/Run MyVirtual Machine project is open to modify mmc.ini on the virtual memory
card.
• The second access point CP1543_2 (Page 40) is configured

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 41
Layout and operation
4.4 Application settings

How to enter the IP address of the second network adapter

1. In Create/Run MyVirtual Machine, click . The Windows Explorer opens with the storage
location of the virtual memory card in the directory ...\card\. (%LOCALAPPDATA%
\Siemens\Automation\SINUMERIK ONE\ncu\card).
2. Navigate to the directory "..\addon\sinumerik\hmi\840evo_vc\cfg" and open the file
"mmc.ini" in the editor.
3. Navigate to the line with the IP address ADDRESS1=127.0.0.1.
[840EVOVC}
...
ADDRESS1=127.0.0.1,Line=20,NAME=/PLC,MAX_BUB_CYCLICS=1000
4. Enter the IP address of the second network adapter instead of the IP address 127.0.0.1 of the
localhost.
5. Save the file.
The HMI communicates via the alternative network adapter after starting the machine
project.

General conditions
• The IP address is only stored in the changed machine project. If the HMI is to generally
communicate via the second interface, you must change the IP address in each machine
project.
• If the IP address of the network adapter changes, you must also add it in mmc.ini. This may
be the case, for example, with dynamic IP address assignments via DHCP.
• If the changed machine project is used on another computer, the IP address must also be
adjusted.
• If you want to switch between network adapters (e.g. between WLAN and LAN), then the
configuration of the access points and mmc.ini may have to be adjusted.

Preparing cross-computer communication via Ethernet

Cross-computer TCP communication

If the TCP communication between MyVirtual Machine products and SIMATIC STEP 7 (TIA Portal)
is established across computers and diverse subnets, the inbound connection for the network
areas of local port 102 must be enabled in the active firewall on the computer on which the
MyVirtual Machine product is installed. This is the case, for example, when the applications are
installed on different computers or virtual machines in the network, and you want to go online
with SIMATIC STEP 7 Professional on the computer with MyVirtual Machine products. The
procedure for the Windows Firewall is explained briefly as an example. The basic settings are also
applicable for other firewalls.

Requirement
You are logged in on the computer with installed MyVirtual Machine product and have
administrator rights.

System Manual Run MyVirtual Machine

42 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

Windows Firewall rules for inbound connections, protocols and ports

In the Windows Firewall, you can define the connection security rules for protocols and ports. For
the connection rule, you must enable TCP communication via port 102 for the S7DOS
(s7oiehsx64.exe) program.
1. Enter "Windows Defender Firewall with Advanced Security" in the search field of the Windows
taskbar and open the displayed application.
2. Acknowledge the dialog with "Yes".
3. Click on "Inbound Rule" in the navigation area of the displayed window and select "New Rule"
in the shortcut menu. The wizard opens.
4. In the wizard, first make the settings for which program the rules should apply and click
"Next".
– Rule type: Program
– Program path: %ProgramFiles%\Common Files\Siemens\Automation\Simatic
OAM\bin\s7oiehsx64.exe
– Action: Allow connection
– Profile: Select the appropriate profiles (e.g. domains when a domain controller is used)
– Name: Enter a name for the rule, e.g. S7DOS_Service
5. Click "Finish". The new rule is displayed under "Inbound Rules".
6. Click the newly created rule, and select "Properties" from the shortcut menu.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 43
Layout and operation
4.4 Application settings

7. Select the following settings on the "Protocols and Ports" tab in the displayed dialog.
– Protocol type: TCP
– Local port: Specific ports, 102

Figure 4-7 Windows Firewall rule: Protocols and ports

System Manual Run MyVirtual Machine

44 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.4 Application settings

8. Check the settings on the "Programs and services" tab.

Figure 4-8 Windows Firewall rule: Programs and Services

9. Confirm with "OK".

This completes the definition of the rules.

Figure 4-9 Windows Firewall: Inbound rules

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 45
Layout and operation
4.5 Information application

4.5 Information application

4.5.1 Version information

You can display version information about the installed application by pressing the Info button.

This is how you display the version information

1. Click on the button and switch to the "Version info" tab.
2. The following information is displayed in the window that opens:
– Version of the installed software, e.g. Create or Run MyVirtual Machine Vx.x.

4.5.2 License info

You can display license information about the installed application by pressing the Info button.

Requirement
A machine project must be open for the license information for assigned (active) licenses to be
displayed.

How to display the license information

1. Click on the button and switch to the "License info" tab.
2. The following information is displayed in the window that opens:
– Basic licenses
List of the available basic licenses. The currently assigned license is displayed with a
checkmark.
– Optional licenses
List of optional licenses. The currently assigned licenses are displayed with a checkmark.
3. Click the "Start license app" button if you want to use the "License Tool" to add or delete
licenses.

See also
Licensing (Page 47)

System Manual Run MyVirtual Machine

46 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.6 Licensing

4.6 Licensing

4.6.1 Licensing Create/Run MyVirtual Machine

Description
A license is required for operation of the Create or Run MyVirtual Machine and can be obtained
in a license file (*.lic). A license file can include one or more licenses.
The license is managed using a licensing application (License Tool). The application is
installed automatically when setting up Create & Run MyVirtual Machine.

Licenses for Create MyVirtual Machine and options

The installation of Create MyVirtual Machine also includes the Open Interface and the 3D
Simulation. Additional licenses are required to be able to use the functions of these options.
The following licenses are required to run Create MyVirtual Machine:
• Create MyVirtual Machine /Operate (basic license to use the framework application Create
MyVirtual Machine)
The following licenses can optionally be used:
• Create MyVirtual Machine /Open (license for using the Open interface to connect own
applications)
• Create MyVirtual Machine /3D (license for using 3D Simulation in Create MyVirtual Machine)

Licenses for Run MyVirtual Machine and options

Installation of Run MyVirtual Machine also includes the open interface and 3D Simulation.
Additional licenses are required to be able to use the functions of these options.
The following licenses are required to operate Run MyVirtual Machine:
• Run MyVirtual Machine /Operate (basic license to use the framework application Run
MyVirtual Machine)
The following licenses can optionally be used:
• Run MyVirtual Machine /Open (license for using the Open interface to connect own
applications)
• Run MyVirtual Machine /3D (license for using 3D Simulation in Run MyVirtual Machine)

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 47
Layout and operation
4.6 Licensing

Types of licenses
The license is transferred by way of a license file as follows:
• Local license (node-locked configuration) (Page 50)
Configuration of the license file following installation on the local client or on a connected
storage medium with the licensing application.
• License server (server configuration) (Page 50)
Use of a license server which is managed by the licensing application. The license file with
one or more licenses is located on the license server. The licenses can be used by all
workstations (computers) in the network with an installed and configured licensing
application. Simultaneous use of a license is only ever possible by one open Create/Run
MyVirtual Machine.
The license server can also be installed locally on a work station computer, i.e. the license
server and Create/Run MyVirtual Machine are installed on the same computer.

1RGH/RFNHG&RQILJXUDWLRQ 6HUYHU&RQILJXUDWLRQ

/LFHQVH
/LFHQVH /LFHQVH VHUYHU
ILOH ILOH

/LFHQVHVHUYHUORFDO

&OLHQW &OLHQWQ

Figure 4-10 License file for local computer or server license

License file source of supply

The license file is generated according to your specifications and infrastructure (license
requirement, server, MAC address and computer name of the client) during the order process
and is then made available by email.
Example of the information required for a license:
• Hostname (server or client)
• COMPOSITE Host ID
• Sold-To (customer)

System Manual Run MyVirtual Machine

48 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.6 Licensing

Note
After purchasing Create & Run MyVirtual Machine, you can request a license according to your
task profile by email. During the license ordering process, you will be provided with the
necessary tools to, for example, determine the Hostname or the COMPOSITE Host ID according
to your infrastructure.

Managing licenses
• Managing licenses via the user interface (Page 54)
• Managing licenses via the command line (Page 57)

License check
The license is only checked when opening the machine project. If a valid license is not found, a
message is displayed and you can directly start the licensing application.
Depending on the license, the functionality of Create/Run MyVirtual Machine is limited.
• No license
→ Run MyVirtual Machine in demo mode with reduced functionality. Only demo machine
projects can be opened.
→ No functional scope of Create MyVirtual Machine can be used
• License for Run MyVirtual Machine
→ Full functionality of Run MyVirtual Machine license is available
• Create MyVirtual Machine license
→ Full functionality of Create MyVirtual Machine license is available
• Licenses for Create and Run MyVirtual Machine
→ You can switch between Create MyVirtual Machine and Run MyVirtual Machine in the
open application

More information
Detailed documentation for the installation of the license server (Microsoft Windows and Linux)
and the installation file for setting up the licenses can be found on the installation medium in the
directory "Create and Run MyVirtual Machine\Support\".

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 49
Layout and operation
4.6 Licensing

4.6.2 Local license

NOTICE
Special case local license
The use of a local license is a special licensing case. As a rule, a local license server with a server
license is also used for a single-user station license. Observe the section "License server
(Page 50)".

Description (node-locked configuration)

The license file is copied to the local client or is installed on a computer connected in the network,
e.g. "C:\LicenseFiles\license-myvirtual-machine-node-locked.lic". The license file is only used by
one client. The path for storage of the license file is configured with the licensing application. The
client references directly to the license file. The licenses in the license file are assigned to one
client (computer name, MAC address) and are not available for any other client.

Note
Permitted characters in the path name
Do not use umlauts or special characters in the path name.

Characteristics of stand-alone configuration of a local license file (node-locked configuration):

• No server and no server configuration required
• Suitable for a small number of installations

4.6.3 License server

Description
A license server is used for management of the licenses. This is the standard use case for license
management.
One or more license files used by the clients (floating) are located on the server. A floating
license means that each client in the network can use the number of licenses specified in the
license file.
The license server is set up and configured in advance. The license server can be installed
locally or on a server. The reference to the server with the licensing application is configured
on the clients.

System Manual Run MyVirtual Machine

50 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.6 Licensing

The following license configurations are supported:

• Single server configuration
A server manages the license file.
• Redundant server configuration
Redundant servers manage the license file with a corresponding copy of the master license
file.
• Configuration of several servers
Each server has a stand-alone license file with its own licenses. The client places a license
request at Server 1. If there is no free or available license, the request is forwarded to server
n.

Requirement
The license server is configured according to the documentation "Siemens Digital Industries
Software License Server Installation Instructions" and "Siemens Digital Industries Software
Licensing Manual".
• License server installed and configured.
• License server stored on server and adapted to infrastructure.
• Port for TCP communication for license request is enabled on the server (Windows firewall).
• Name of the "License server" and "Port" are defined and are provided when configuring the
licensing application.

See also
Installing the license server under Microsoft Windows (Page 51)

4.6.4 Installing the license server under Microsoft Windows

The following section describes how to install a license server on a computer with Microsoft
Windows. Depending on the type of license, the license server can be used for several clients in
the network or as a local license server.
With the local license server, Create & Run MyVirtual Machine is installed on the same
computer and uses the license of the locally installed license server. This is the standard use
case for using a server license for a single-user station, e.g. Run MyVirtual Machine work
station for work preparation.

Requirement
• You have administrator rights on the computer.
• A suitable server license file ("*.lic") is available on the computer
• Setup file of the license server is available
Installation medium:
"Create&Run_MyVirtual_Machine\Support\SiemensLicenseServer_<version>_Win64_x86-6
4.exe"

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 51
Layout and operation
4.6 Licensing

How to install a license server

1. Double-click on the setup file "SiemensLicenseServer_<version>_Win64_x86-64.exe" of the
license server.
The setup is started.
2. Select the language of the installation wizard in the dialog that appears and confirm with
"OK".
The installation wizard is started in the selected language.
3. Follow the instructions of the installation wizard. The following information is requested
during the installation process:
– Server license file
Specify the storage location of the license and import it.
– License server port
The license server can be reached via this port. The port must be enabled. Port 29000 is
used by default. If you do not change port's default settings, you do not have to make any
further settings. If you change the port, you must make a note of the port entered and
configure the port activation if necessary.
– Storage location of the installation
– WebKey (Siemens account)
Administrative tasks can be carried out more easily via this Siemens account (email
address). The function is optional.
– Confirm installation (firewall access)
Activate "Allow license server access through local firewall" so that clients in the network
can access the computer with the license server.
Note
License on local license server
If the license server and Create & Run MyVirtual Machine are on the same computer and
there is no access to the license server from other clients in the network, you can also
deactivate "License server access through local firewall".

4. After installing and configuring the license server, click "Finished" to close the wizard.
If you want to import additional licenses, click on "Licensing".
The license server is configured and can now be used. The next step is to configure the port
number and the host name of the license server in the licensing application on the clients or
on the local computer.

Note
Replacing or adding a license
Start the license server setup again if you want to replace the current license or add more
licenses. Select the "Add/replace license file" option.

System Manual Run MyVirtual Machine

52 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.6 Licensing

Repairing or uninstalling the license server

• Repairing the license server
Start the license server setup and select the option "Repair license server software"
• Uninstalling the license server
Start the license server setup and select the "Remove software" option
Uninstall the software via the Windows Control Panel

See also
Using the license server (Page 57)

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 53
Layout and operation
4.6 Licensing

4.6.5 User interface of the licensing application

Licensing application (License Tool)

The user interface of the licensing application allows you to manage the licenses for Create/Run
MyVirtual Machine products. The application is installed on the computer with the Create/Run
MyVirtual Machine products.

4 2 3 13 8

1 9
12

5
7
6

10 11

① List of added license servers or license files. When opening the machine project, a search is made for a valid license in the
license files on the license servers. The search sequence goes from the top to the bottom. The first valid license found is
used.
② The selected license file or the selected license server is shifted either up or down using the arrow keys. This allows you
to change the search sequence for the license check.
③ Clicking on the button removes the selected license file or the selected license server from the list of license
sources.
④ Clicking on the button displays the selection option for a local license file (node locked). By default, the "License
file" selection box is not displayed, because usually only licenses for license servers are in use.
⑤ Selection of the local "license file" (<path and file name>). The selection box is not displayed until you click the button
(see ④).
Select the local license file by clicking on "...".
⑥ Specification and display of the port number and name of the "License server" (<port number>@<Servername/Host‐
name> or <port number>@<IP address>)
The use of the license server is the default use case.
⑦ Clicking on the "+" button adds the license file or the license server to the list of license sources.
⑧ Clicking on the button displays the license information for the selected license in the "License source" section.
Clicking on the button expands all further information about the listed licenses.

Clicking on the button hides all further information about the listed licenses.

System Manual Run MyVirtual Machine

54 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.6 Licensing

⑨ Display of the license information.

Header
• Server/license name
• FlexLM vendor string
• Issuer
• Type of license
• List of licenses found
Click the button in front of the license to display more information.
Licenses (for server license)
• License name: Name of the application or information
• Expiration date: Date until when the license is valid
• Version: Software version for which the license is valid
• All users/PC: List of all users currently occupying a license (only visible if at least one license is occupied)
• In use: Indicates if the license from this client is in use (only if a project is open in C/RMVM)
• Number of licenses: Indicates how many licenses for this product are stored on the server
• Licenses in use: Number of currently used licenses
Licenses (for license file)
• License name: Name of the Application
• Expiration date: Date until when the license is valid
• Version: Software version for which the license is valid
⑩ Saving the license sources
If the list does not contain any license, an empty license entry is saved. As a consequence, the Create/Run MyVirtual
Machine product has no reference to a valid license and the machine project is not opened.
⑪ Closes the licensing application without saving.
⑫ The unique FlexLM vendor string is used to implement the transfer protection of machine projects. Thus the machine
project is linked to the value of the FlexLM vendor string and can only be opened if the linked FlexLM vendor string of the
machine project is identical to the FlexLM vendor string of the license. Only users with this unique license can open the
protected machine project.
⑬ Clicking on the button copies the FlexLM vendor string of the license to the clipboard. You must receive the
copied value of the FlexLM vendor string from an end user, for example, so that you can deliver a machine project
with transfer protection.
Figure 4-11 Managing licenses with the licensing application (using port 28000)

Requirement
Administrator rights are required for configuration of the licenses via the licensing application.

This is how you work with the user interface of the licensing application
1. In the Windows start menu, select "Start > Siemens Automation > License settings for Create
and Run MyVirtual Machine".
2. Acknowledge the confirmation prompt.
The "Licensing" application opens.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 55
Layout and operation
4.6 Licensing

3. Select a new license source.

– Using local licenses (Page 56)
– Using the license server (Page 57)
4. Click on "+" to add the new license source to the list.
5. Click on the arrow keys to change the search sequence for multiple license sources.
You use the sequence to specify which license source should be searched first for a valid
license.
6. Click on the button if you want to remove added license sources from the list.
7. Click "Save" to save the list of license sources. In the window header line, a star "*" is displayed
next to "License Tool" if the changes have still not been saved.
8. Click "Close" to close the application.
When opening the machine project, a search is made for a valid license in the license sources
that have been entered. The machine project is opened in Create/Run MyVirtual Machine if a
valid license is found.

4.6.6 Using local licenses

NOTICE
Special case local license
The use of a local license is a special licensing case. As a rule, a local license server with a server
license is also used for a single-user station license. Observe the section "License server
(Page 50)".

This is how you configure a local license file

1. Copy the license file *.lic locally to a directory on the client, e.g. "C:\LicenseFiles\license-
myvirtual-machine-node-locked.lic".
2. Open the operator interface of the licensing application.
3. Show the "License file" option by clicking the button.
4. Under "License file", select the path for storage of the local license file.
5. Click on "+" to add the new license source to the list.
6. Confirm with "Save".
7. Close the app with "Close".

See also
User interface of the licensing application (Page 54)

System Manual Run MyVirtual Machine

56 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.6 Licensing

4.6.7 Using the license server

This is how you configure access to a license server

1. Open the licensing application.
2. Enter the port number and the name of the host in the "License server" field. The default port
is 29000.
– Syntax: <port>@<host name> or <port>@<IP address>
– Example: 29000@mylicenseserver
– Example for local license server: 29000@127.0.0.1 or 29000@localhost
3. For multiple servers, enter all names, separated by semicolons.
– Example:
29000@mylicenseserver1;29000@mylicenseserver2;29000@mylicenseserver3
4. Click on "+" to add the new servers to the list.
5. Confirm with "Save".
6. Then close the app with "Close".

See also
User interface of the licensing application (Page 54)

4.6.8 Command line of the licensing application

Licensing application "VMxLicenseTool.exe" can be controlled via the command line and is then
executed without user interface. The functional scope is identical to that of the user interface,
and allows licenses to be managed, e.g. for automated licensing procedures.

License Tool storage location

After installing the MyVirtual Machine product you can find the licensing application at the
following storage location:
• "C:\Program Files (x86)\Common Files\Siemens\VMx
Middleware\VMxLicenseTool.exe"

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 57
Layout and operation
4.6 Licensing

Functions
The command VMxLicenseTool.exe is extended by the following parameters (options and
arguments). The parameters are attached to the command using a space followed by a
separator. The different separators and the short and/or long form of the parameter can be used
alternatively.

Sepa‐ Short pa‐ Long parame‐ Arguments Significance/example

rator rameter ter
/ m menu - Starts the user interface and closes the application
- in the command prompt.
-- VMxLicenseTool.exe /m
/ l list - Lists the registered licenses line-by-line (line num‐
- ber 0-n). The sequence in the license list corre‐
-- sponds to the search sequence when checking the
license.
VMxLicenseTool.exe /l
Example of a license list:
Id Type Path
0 File c:\License\mylicense.lic
1 Server 29000@myserver
2 Server 29000@licenseserver
3 Server 29000@backupserver
/ as addServer <port@servername> Inserts a license server at the end of the list.
- Server port and server name VMxLicenseTool.exe /as 29000@myserver
--
/ af addFile <path to file\filename> Inserts a local license (license file) at the end of the
- Path and file name list.
-- VMxLicenseTool.exe /af
c:\License\mylicense.lic
Note:
Do not use umlauts or special characters in the path
name.
/ r remove <Line> Deletes the specified line with the entered license
- Specifies the line ID (line number) (ID of the line).
-- VMxLicenseTool.exe /r 2
/ s swap <src Line> <dst Line> Exchanges the license of the source line <src Line>
- Specifies the line ID (line number) with the destination line <dst Line>. The modified
-- of the source and the destination. license list is displayed after the exchange.
VMxLicenseTool.exe /s 1 3
/ i licenseInf - Lists the license information for the licenses, e.g.
- o license name, expiration date.
-- VMxLicenseTool.exe /i
/ rr removeAll - Deletes all registered licenses from the list. The li‐
- censes are deleted after the prompt by entering DE‐
-- LETE and pressing the ENTER key.
VMxLicenseTool.exe /rr
/ h help - Displays the help for the command.
- VMxLicenseTool.exe /h
--

System Manual Run MyVirtual Machine

58 System Manual, 01/2024, A5E48105802B AK
 Layout and operation
4.6 Licensing

See also
Using the command line of the licensing application (Page 59)

4.6.9 Using the command line of the licensing application

You can manage licenses via the command line directly via the Windows command prompt or
via batch files.

This is how you use the command line to manage licenses

1. In Windows, open the command prompt.
2. Enter the path to the licensing application in the command prompt.
"C:\Program Files (x86)\Common Files\Siemens\VMx Middleware\"
3. Check the current license status using VMxLicenseTool.exe -l.
A list of registered licenses is displayed.
4. Register the local licenses or the license server, for example. At least one license must have
been registered.
5. Manage the licenses with the other parameters of the licensing application.
6. Close the command prompt.

See also
Command line of the licensing application (Page 57)

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 59
Layout and operation
4.6 Licensing

System Manual Run MyVirtual Machine

60 System Manual, 01/2024, A5E48105802B AK
Working with machine projects 5
5.1 Manage machine projects

Introduction
Machine projects (*.vcp; Virtual Commissioning Project) are managed in the Run MyVirtual
Machine project management. In this view, you open and delete projects. You create new
projects based on the templates.
A machine project manages all required data for the machine operation. The machine project
file contains NC, HMI, PLC and drive data stating the version of the CNC software used.

Machine project and CNC software version

To edit a machine project, the matching version of the CNC software must always be installed on
the computer. A machine project can neither be created nor opened without the CNC software
being installed. If the version of the CNC software used in the project is not installed, an error
message stating the missing CNC software is displayed. In this case, first install the stated version
and then edit the machine project.
Multiple CNC software versions can be installed on a single computer. The CNC software
version used in the machine project is displayed in the project management in the "CNC
version" column and in the title bar of the open machine project.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 61
Working with machine projects
5.2 Creating a machine project from a template

Starting the project management

On the desktop, double-click the "Run MyVirtual Machine" symbol - or select "Start > Siemens
Automation > Run MyVirtual Machine". Run MyVirtual Machine project management is
displayed.

Figure 5-1 Project management of Run MyVirtual Machine - open project

5.2 Creating a machine project from a template

Description
Various template projects are available in the project management to help you create machine
projects.

Note
Installing template projects
The template projects are made available via a dedicated installation package. Install the
machine projects if no template projects are displayed in the project management.
More information is provided in the Installation Manual Template Machines Create/Run My
Virtual Machine.

System Manual Run MyVirtual Machine

62 System Manual, 01/2024, A5E48105802B AK
 Working with machine projects
5.2 Creating a machine project from a template

This is how you create a new machine project

Start Run MyVirtual Machine.
1. Click on the "Create new project" tab.
2. The "Template project" option is selected under "Create new project with".
3. Select a template project.
4. Enter a project name.
5. Select the storage path.
6. Confirm with "Create project". The project opens.




Figure 5-2 Creating a new project from a template

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 63
Working with machine projects
5.2 Creating a machine project from a template

7. The Run MyVirtual Machine project view is displayed with "Project settings" and default
values.

Figure 5-3 Run MyVirtual Machine with an open machine project

System Manual Run MyVirtual Machine

64 System Manual, 01/2024, A5E48105802B AK
 Working with machine projects
5.3 Opening a machine project

8. Configure the project in Section "Project settings".

– Optionally, enter a comment and load a typical machine diagram for the project.
– Select "HMI resolution" and display of the "Navigation bar" in the HMI.
Then start the machine in the next step. This brings the machine into the simulation mode.
The starting corresponds to the switch-on and run-up of a real machine.
9. Click the "Start machine" button in the control area. The button can be clicked only when
it is no longer faded.
The machine is started and the HMI with machine control panel opens. The machine cannot
be operated during starting.
The start of the machine is completed when the button "Exit machine" is displayed.

Figure 5-4 Run MyVirtual Machine: machine project newly created from the template after running up

5.3 Opening a machine project

Description
Open existing machine projects in the project in the project management.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 65
Working with machine projects
5.3 Opening a machine project

How to open an existing machine project

Start Run MyVirtual Machine before opening an existing machine project.
1. Click "Open project".
2. Select the project if the project is on the list of recently opened projects. The CNC SW version
used is also stated in the line of the project.
3. Click the "Open project" button. The selected project opens. Continue with step 8.

  

Figure 5-5 Opening a project in Run MyVirtual Machine

4. As an alternative to steps 3. and 8., you can also click on button "Start project". The project
opens and the machine project is started.
5. If the project is not in the list, click the "Browse" button. The file selection dialog opens.
6. Navigate to the desired project. You have access to all local drives and network drives via the
selection dialog.

System Manual Run MyVirtual Machine

66 System Manual, 01/2024, A5E48105802B AK
 Working with machine projects
5.4 Save the machine project and exit

7. Select the project and click "Open". The project is opened in Run MyVirtual Machine.
Note
Virtual CNC SW
Whether the Virtual CNC SW version used in the project is installed on the computer is
checked when the project is opened. If the Virtual CNC SW version is not installed, a message
is output stating the missing version. This Virtual CNC SW version must be installed before
the project can be opened and edited.
When the project is open, the Virtual CNC SW version used in the project is displayed in the
title bar.

8. Then, to start the machine project, click on button "Start machine".

The machine project is automatically added to the list of last opened projects.

5.4 Save the machine project and exit

Description
The current state of the machine project is backed up on saving. When the machine project is
next opened, you continue working with the most recently saved status. Machine projects can
be saved only when the simulation control has Stop status.

File size machine projects

The machine project is saved as a compressed *.vcp file. The maximum size of the stored
machine project is limited to 2 GB. The saving of larger machine projects is aborted with an error.
If the machine project cannot be saved due to the file size, delete unused user data from the
virtual memory card, for example.

This is how you save machine projects

1. In the control area, click the "Exit machine" button. The machine is exited.
2. Select "Save" or "Save as" from the menu bar. The save dialog is displayed
3. Save the project directly, or select a location where you want to save it – and enter a new
name for the machine project.
4. Confirm with "Save". The machine project is saved with the file extension "*.vcp".
Note
If you exit the program or the project without saving the current status, a message appears.
You can also save the current status of the project subsequently.

5. Select "Close project" from the menu bar. The Run MyVirtual Machine project view is
exited and the program management is displayed.
6. Click on "X" in the title bar of the window. The project management and Run MyVirtual
Machine are closed.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 67
Working with machine projects
5.7 Virtual memory card

5.5 Cross-version use of machine projects

Note
Using machine projects in another version
The portability of machine projects ("*.vcp files) to next-higher versions is not guaranteed.

5.6 Project template and access rights

Access rights and keyswitch position

Machine projects that were created from the project template can generally be used with access
level User and in keyswitch position 0. When simulating or when executing the program
examples included, it is possible that an error message is output as write access rights are
required once. These are not permissible in keyswitch position 0.

Adapting the keyswitch position

If simulation or executing the program examples is not possible, then the problem can be
resolved by adapting the keyswitch position.
1. Start the machine project.
2. Set the keyswitch on the machine control panel to position 3.
3. With the new access rights it is possible to simulate and execute the program examples.
4. Save the machine project if you wish to save keyswitch position 3 in the project.

Setting the password for users

Alternatively, in SINUMERIK Operate in area "Commissioning" you can also set password
"CUSTOMER" for access level 3.

5.7 Virtual memory card

Description
Just the same as on the real SINUMERIK control, the virtual SINUMERIK ONE also has a memory
card (SD Card) to store data and manage programs. The virtual memory card is created
temporarily in the Windows User directory when a machine project is started. Each machine
project has its own virtual memory card.
When the machine project is exited, the structure and contents of the virtual memory card
in the machine project are saved, and deleted from the Windows User directory. The virtual
memory card is available when the machine project is next started.

System Manual Run MyVirtual Machine

68 System Manual, 01/2024, A5E48105802B AK
 Working with machine projects
5.7 Virtual memory card

When you save the machine project, the contents of the virtual memory card are stored in
compressed form in the machine project. The storage capacity of the virtual memory card is
limited by the maximum size of the machine project (max. 2 GB). Delete unused user data
from the virtual memory card if the machine project cannot be saved due to the file size.
The structure and the handling of the virtual memory card correspond to those of the real SD
Card.

Virtual memory card storage path

The virtual memory card is only displayed when the machine project is started. The virtual
memory card is saved under the following path:
• C:\Users\<username>\AppData\Local\Siemens\Automation\SINUMERIK ONE\ncu\card

Exchanging data between an NC and a virtual memory card

You can exchange data, e.g. NC programs, with the NC via the virtual memory card. The
following shows the directories on the virtual memory card and the corresponding directory in
the program manager in SINUMERIK Operate.
Directory on virtual memory card
• C:\Users\<username>\AppData\Local\Siemens\Automation\SINUMERIK
ONE\ncu\card\user\sinumerik\data\prog
Directory in the SINUMERIK Operate program manager
• Softkeys: "Program manager > NC Extend"

Note
To exchange data between an NC and a virtual memory card, the key switch on the machine
control panel must be at position 3.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 69
Working with machine projects
5.7 Virtual memory card

Figure 5-6 Same directory opened in the program manager and Windows Explorer on the virtual
memory card

System Manual Run MyVirtual Machine

70 System Manual, 01/2024, A5E48105802B AK
3D simulation (option) 6
6.1 Product information
This product includes or uses libraries of the following software:
• Open CASCADE Technology (https://dev.opencascade.org/)

6.2 Using 3D simulation

Description
Create & Run MyVirtual Machine visualize the machining process and machine movements
using 3D Simulation. You can simulate the processing of NC programs in AUTOMATIC mode, for
example, or manual traversing movements and tool changes in JOG mode.

Note
License
The "Create MyVirtual Machine /3D" or "Run MyVirtual Machine /3D" license is required to use the
3D Simulation.

NOTICE
Saving 3D simulation data in the machine project
All changes in the 3D simulation (e.g. storage folder, library, configurations) are only finally
saved after saving the machine project. Before closing the machine project, you should save the
current state so that no changes are lost.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 71
3D simulation (option)
6.2 Using 3D simulation

Overview of 3D simulation
The 3D simulation is divided into functional areas. To switch between the areas, click on the
corresponding tab.

   

 

 

Figure 6-1 3D simulation, operating areas and functions using the example of a milling machine

System Manual Run MyVirtual Machine

72 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.3 Function scope and configuring

You can perform the following tasks in the areas.

• ① Machine
In the "Machine" tab, you configure the simulation components and visualize the machining
process.
– ⑤ Simulation of the machining process and machine movements (Page 175)
– ⑥ Defining tools (Page 116)
– ⑦ Selecting and activating the setup (clamping) (Page 159)
– ⑧ Saves the current configuration as library elements (current machining state of the
workpiece and configuration)
⑨ Activating collision detection
–
– ⑩ Show/hide machine menu, reset view/workpiece
– ⑪ Show/hide layer menu
• ② Library (Page 91)
In the "Library" you manage the necessary components for the simulation.
– Tools
– Adapters (tool components/holders)
– Protection area (workholder)
– Blanks
– Configurations (clamping)
• ③ Collisions (Page 170)
In the "Collisions" tab, the detected collisions are logged during the execution of an NC
program or during the manual procedure.
• ④ Settings (Page 87)
– Language selection
– Adapter diameter
– Exporting/importing archives

More information
More information with example data and documentation with detailed examples can be
downloaded from the Siemens Service Portal (https://support.industry.siemens.com/cs/ww/en/
view/109815969).

6.3 Function scope and configuring

6.3.1 Function scope of the 3D simulation

Machine processes and machine motion are visualized in the 3D Simulation.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 73
3D simulation (option)
6.3 Function scope and configuring

Functional scope
• Spatial simulation of machine movements on the basis of a stored kinematic machine model
(geometries and kinematic description)
• Support of interchangeable heads (changing of head kinematics)
• Support of multi-spindle machining
• Simulation of drilling, turning and milling operations
– Simulation of stock removal for single and multi-channel machining processes on the
basis of the active setup and tool data
– Several tools being used
– Resetting of the workpiece to the original geometry of the blank
– Monitoring of collision (can be switched on/off) between collision groups specified in the
machine model
– Display of a log of detected collisions and deletion of the log entries
• Turning with driven tools, such as drills or milling cutters, on turning machines with a Y-axis.
This allows you to carry out milling and turning operations on the face and cylinder surfaces
of the workpiece, for example.
• Simulation of measuring processes with switching probe
• Support of inch and metric systems of units
• Tool manager
– Display of tools from the SINUMERIK tool management based on their geometric values
– Support of various tool types
– Linking adapters (tool holders) as "*.stl" and "*.stp" geometries or basic parameterizable
geometry elements (primitive model) with tools from the SINUMERIK tool management
• Library and configurations
– Creating, deleting and editing protection areas (workholders) ("*.stl" and "*.stp"
geometries) in a library
– Creating, deleting, editing and managing blanks ("*.stl" or "*.stp" geometries or from
basic geometry shapes) in a library
– Parametric changing of the spatial position and orientation of library components.
Depending on the type, the components have different reference/coordinate systems. By
defining reference points, workpieces and clamping can be easily positioned.
– Creating, deleting and editing setups (clampings) from the library component protection
area and blank
– Exporting and importing library components and setups
• Activating single or multiple selected setups for consideration in the spatial simulation, e.g.
simulation of multiple workpiece machining operations on one machine (multi-spindle
machine).
• Saving and exporting the in-process workpiece geometry

System Manual Run MyVirtual Machine

74 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.3 Function scope and configuring

• Tool-specific stock removal in different colors. In the tool manager, you can define a specific
cutting edge color for each tool. This means that in stock removal simulation, you can
immediately identify which tool is currently being used for machining or the tool that was
used.
• Show and hide layer structure: Depending on the machine model, you can show or hide
different layers in the 3D Simulation, e.g. showing or hiding machine housings.
• Transfer of workpieces between clamping setups. Among other things, workpieces can be
transferred between the main and counterspindle. In addition, it is possible to simulate
loading and unloading processes, e.g. using robots.
• Travel to fixed stop
• Support of two-channel machines

Figure 6-2 3D Simulation in Create & Run MyVirtual Machine

6.3.2 3D simulation restrictions

The following functions are explicitly not supported for the 3D Simulation:
• Simulation of grinding operations
• Consideration of tools deviating from the tool types (Page 119) listed in the document
(deviating tools are shown as replacement tool)

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 75
3D simulation (option)
6.3 Function scope and configuring

• Using file formats other than "*.stl" and "*.stp" to import 3D geometries
• For parametric tools (definition of the tool via parameters), only the first cutting edge is
supported. It is only possible to position the reference point of the tool on D1.
• Parallel kinematics
• All channels are considered as measuring during a simulated measuring process
• Turning operations are restricted to the tools defined in the document
• The "Machine" tab on the user interface must be active during the inch/metric switchover
process, as this can lead to data loss when processing data.
• If the spindle is stopped by MCP in AUTO mode during a machining operation and the NC is
not configured to stop when the spindle is stopped, PMM /3D Twin cannot stop the machine
when the tool is moved inside the workpiece.

6.3.3 Constraints 3D Simulation in C/RMVM

Simulation of stock removal and collision detection have the following properties.

Stock removal AUTO/MDI (general)

Stock removal with the cutting part of the tool is simulated if the following conditions are met.
Conditions
• The machine (channel of the machine) is not in rapid traverse mode (≠ G0).
– The channels of all axes located above the tool node in the kinematic tree are taken into
account. If an axis does not move, its channel mode has no effect.
If the spindle is rotating, the status of the spindle axis is not taken into account (jog, G0
or G1).
• Tool or workpiece spindle in rotary motion
Milling machines: The tool spindle rotates
Turning machines: The workpiece spindle rotates
If these conditions are not met, no material is removed.
Properties
• If the above conditions are not met, the contact between the cutting part of the tool and the
workpiece is treated as a collision.
• Stock removal is also simulated if the above conditions are met and other components collide
(e.g. machine with adapter).
• Stock removal is carried out at the current position.
• Stock removal is independent of collision detection (active/inactive).
• Stock removal is independent of feedrate/speed of rotation.

System Manual Run MyVirtual Machine

76 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.3 Function scope and configuring

Stock removal JOG

In JOG mode, the following properties apply in addition to the general conditions.
• Stock removal is simulated when using machining cycles in JOG mode.
• During the manual process in JOG with rotating spindle, no stock removal is simulated.

Collision detection
Collision detection has the following properties.
• Collisions are displayed and stored in the log.
• Collision is displayed in color.
– Orange
The minimum clearance between colliding parts within the safety clearance is met. The
default value for the safety clearance is 3 mm. This can be configured in the machine
model (machine manufacturer).
– Red
Collision of the components has been detected.
• If the above conditions in the "Stock removal" section are not met, contact between the
cutting part of the tool and the workpiece is detected as a collision.
• The collision pairs of the machine must be defined in the machine model.
• A collision is detected for collision pairs that are configured in the machine model (machine
manufacturer).
• The contact of machine parts with other machine parts (except tool and workpiece) is always
detected as a collision.
• Collisions in rapid traverse (G0) are always detected irrespective of whether the spindle is
rotating or stopped.
• Collision is detected while the spindle is stopped and during traversing movement G1, G2
and G3.
• There is a special mode for "measuring". Measuring processes are not detected as collisions.
More information can be found in the Measuring processes in 3D simulation (Page 78)
section.

Simulation properties
As a result of the motion modeling, simulation has the following properties.
• To model motion (axis motion) the 3D simulation directly uses the setpoints from the NC, and
not the actual motion executed by the drive system. Functions, which deactivate the
setpoints at the drives, e.g. when using simulation axes or for the program test (PRT)
therefore have no impact on the 3D simulation. Although the drives are not assigned any
setpoints, axis motion is executed in the 3D Simulation.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 77
3D simulation (option)
6.3 Function scope and configuring

6.3.4 Simulation of measurement procedures and machine data

Probe
Measurement performed with switching probes is supported in all operating modes and can be
carried out with active collision avoidance.
The following tool types (probes) are supported:
• 710-714
• 725
• 730

Measuring cycles in the AUTO/MDI mode

During a measuring cycle in the AUTO/MDI mode, the NC sends signal MEAS1 or MEAS2,
depending on the type of measuring cycle, i.e. tool or workpiece measuring cycles. These signals
are interpreted by considering the bit values of MD52740 $MCS_MEA_FUNCTION_MASK. The
bits in $MCS_MEA_FUNCTION_MASK define the significance of the MEAS1 and MEAS2 probe
signals.
• Bit 0 = 0: MEAS1 is connected with a workpiece probe
• Bit 0 = 1: MEAS2 is connected with a workpiece probe
• Bit 16 = 0: MEAS1 is connected with a tool probe
• Bit 16 = 1: MEAS2 is connected with a tool probe
If bit 0 = bit 16, the measuring cycle type is determined based on the tool type in the
spindle. If the tool in the spindle is a probe (see Section Probe above), then the MEAS signal
corresponds to a workpiece measuring cycle. Otherwise, the MEAS signal corresponds to a
tool measuring cycle.

Measuring process and collisions

Collision components treat measuring cycles as a special case, so that a collision alarm is not
initiated for certain collision types.
These types of collisions include:
• In the workpiece measuring cycle
Collisions between the probe/tool shank and other objects, e.g. machine parts, workpieces or
fixtures.
• In the tool measuring cycle
Collisions between the tool shank/unclamped length and the tool measuring system.
If there is still a collision between the tool shank and other objects, when the MEAS signal
is deactivated, collisions between the tool shank and other objects will continue to be
ignored until the tool leaves the collision state. Only afterwards is general collision avoidance
reactivated.

System Manual Run MyVirtual Machine

78 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.3 Function scope and configuring

The tool measuring system must be defined in the machine model. A generally valid
specification has currently still not been defined. This is the reason that tool measuring
systems will only be supported in a future version.
The NC (NCK version ≥ 4.93 or ≥ 6.13) displays alarm 26352 if a measuring cycle is active in
the special collision type cases listed above. This warning is deleted as soon as the measuring
cycle is exited.

Note
Currently, only workpiece measuring cycles are supported. The use of tool measuring cycles will
be implemented in future versions.

Measuring cycles in JOG

A manual measuring cycle can be executed in JOG. However, the machine must be in no-load
operation (idling) to activate the manual measuring cycle via API. During the manual measuring
cycle, the collision avoidance component does not initiate any collision alarm for collisions
between the tool shank/unclamped length and another part of the machine, the workpiece or
fixtures.
The NC (NCK version ≥ 4.93 or ≥ 6.13) displays alarm 26352 if a measuring cycle is active in
the special cases of the collision component listed above. This warning is deleted as soon as
the manual measuring cycle is deactivated.
A manual measuring cycle can either be deactivated via the API if the machine is in no-load
operation (idling mode) or by switching into the AUTO operating mode.

Restrictions for Create MyVirtual Machine

If machine data MD13210 $MN_MEAS_TYPE is = 1, measuring in Create MyVirtual Machine does
not function.

6.3.5 Cutting off the workpiece and transferring to a counterspindle

Machining and transferring workpieces between the main spindle and counterspindle are
supported in the 3D Simulation.

Transferring the workpiece

Transferring workpieces between two clamping operations, e.g. transferring a premachined
workpiece from the main spindle to the counterspindle for turning machines is supported in the
3D Simulation.
Workpiece transfer sequence
1. In "Settings", activate machining setting "Activate/deactivate workpiece transfer".
2. Activate a setup with a blank on the main spindle.
3. Activate a setup without a blank on the counterspindle.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 79
3D simulation (option)
6.3 Function scope and configuring

4. The workpiece transfer procedure is started if the limitation frame of the setup in the
counterspindle intersects with the limitation frame of the setup in the main spindle.
5. The transfer is realized as soon as the distance between the Mount Stations increases.

Cutting off the workpiece

3D Simulation functionally supports cutting off the workpiece and subsequently transferring it.
Cutting off sequence
1. Activate the machining setting "Activate/deactivate workpiece cutting off" in the settings.
2. Activate a setup with a blank on the main spindle.
3. Activate a setup without a blank on the counterspindle.
4. The workpiece transfer procedure is started if the limitation frame of the setup in the
counterspindle intersects with the limitation frame of the setup in the main spindle.
5. When the counterspindle grips the blank and moves in the opposite direction, the blank is
transferred and moves together with the counterspindle to the initial position.
6. If the blank is cut before or after the transfer, some of the blank remains in the main spindle
and the part that has been cut off is clamped in the counterspindle.

Notes and restrictions

• Even if a collision pair is defined between the setups of the main spindle and counterspindle,
collisions between the workpiece to be transferred and the clamping fixture to grip the
workpiece should be ignored if a workpiece transfer is involved.
• If both spindles have workpieces, a transfer is not made and a collision is documented if a
collision group was defined.
• A workpiece falling when clamping or when cutting off is not simulated.

6.3.6 Traversing positioning axes (POS, POSA)

Positioning axes are traversed independently of the path axes at a separate, axis-specific
feedrate. With the POS/POSA commands, the positioning axes are traversed and the sequence
of motions coordinated at the same time.

Behavior of commands POS/POSA in 3D simulation

The following applies when programming commands POS/POSA:
• Material removal and collision avoidance/detection based on G code Group 1 and the spindle
state/status of the axis that is positioned.

System Manual Run MyVirtual Machine

80 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.3 Function scope and configuring

6.3.7 Travel to fixed stop

With the "Travel to fixed stop" function, moving machine parts, e.g. tailstock or mandrel, can be
traversed so that they can apply a definable torque or force with respect to other machine parts
over any time period.

Note
The simulation of "Travel to fixed stop" movements is supported for the processes that are
available in the NC programs for "Travel to fixed stop", e.g. FXS in the NC program.

Implementation in 3D Simulation
Implementation of the function is comparable to the measurement functionality in Create
MyVirtual Machine /3D. 3D Simulation considers overlaps between the 3D geometries during a
"travel to fixed stop" process. As soon as the geometries make contact, the simulation reacts with
the signal "Travel to fixed stop reached" and stops the movement.

Application example
• Parts transfer
• Tailstock moves up to the workpiece contact and then further rotation takes place
• Bar loader pushes the blank to the defined stop, e.g. tool in the turret

Restrictions
• The collision groups in the machine model for the overlapping of the affected components
should be defined in the machine model.
• If the axes continue to move in collision mode, e.g. due to incorrect programming, this is not
detected as a collision.

6.3.8 Tips

6.3.8.1 3D Simulation is not started/displayed

Error case
The 3D Simulation is not displayed or is terminated immediately after starting the machine
project.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 81
3D simulation (option)
6.4 Operation and setting

Requirement
First check that the following requirements are met.
• The system requirements are fulfilled.
• The option "Create MyVirtual Machine /3D" or "Run MyVirtual Machine /3D" is licensed.
• The machine project contains a 3D machine model.

Possible cause graphics card driver

If the installed graphics card driver is not compatible with the graphics hardware or offers
insufficient OpenGL support, the 3D Simulation cannot be started.

Remedy
If possible and available, install an up-to-date graphics card driver with OpenGL support.

Possible cause remote connection

If you use Create MyVirtual Machine or Run MyVirtual Machine with the 3D option activated via
remote access through Microsoft "Remote Desktop Connection" (RDP) from a second computer,
there may be display errors or a black 3D window due to the lack of OpenGL graphics drivers for
this RDP transmission protocol. This depends on the graphics hardware used or the installed
graphics drivers on the remote computer on which Create MyVirtual Machine or Run MyVirtual
Machine is running.

Remedy
A possible remedy is to install a software OpenGL renderer, such as the "Mesa 3D" freeware on
the remote computer running Create MyVirtual Machine or Run MyVirtual Machine.

6.4 Operation and setting

6.4.1 Data archiving, export/import, file format

Storage folder, data exchange 3D Simulation

The 3D Simulation uses a storage folder on the virtual memory card. As default, this folder is
used, for example, to store the exported data or to search for the data to be imported (e.g.
library). Geometry data can only be exchanged with the library using this folder, e.g. geometries
of adapters and workpieces.
You can find the folder on the virtual memory card in your user directory.
• "C:\Users\<username>\AppData\Local\Siemens\Automation\SINUMERIK
ONE\ncu\card\user\sinumerik\3d\"

System Manual Run MyVirtual Machine

82 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.4 Operation and setting

Note
New storage folder
As of version SINUMERIK Virtual CNC software V6.15, the 3D Simulation uses the new path
specified above.

If the term "storage folder" is used in the following description, the specification refers to this
path.

NOTICE
Saving data in the storage folder in the machine project
The data in the storage folder is only finally saved in the machine project when you save the
machine project. All changes since the last time the machine project was saved are no longer
available after exiting the machine project without saving.

Geometry data, geometry files, 3D geometries

3D Simulation can use the geometry data of adapters, workpieces, protection areas and setups
in the following formats:
• STL file ("*.stl")
• STEP file ("*.step", "*.STEP", "*.stp, "*.STP")
When geometry data, geometry files and/or 3D geometries are discussed in the
documentation, then it always involves files in these formats.

6.4.2 General information on operation

Tips and tricks when working with 3D simulation

When working with the 3D simulation, you are supported by helpful functions. The special
features are listed below.
• The 3D simulation is operated with mouse and keyboard. The mouse should have a scroll
wheel.
• Generally, when entering values, only valid values are permitted. Values cannot be saved or
messages are displayed.
• If an error is detected, a red error message is displayed in the upper right area. You can close
it by clicking it or the "X" in the error message.

Figure 6-3 Example of an error message

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 83
3D simulation (option)
6.4 Operation and setting

• Correctly performed actions, e.g. saving, are indicated by a green message in the upper right
area.
• Notes or warnings, e.g. an active component cannot be edited, are displayed as a yellow
message in the upper right area.

Figure 6-4 Example of warning/information

• More information, help screens and videos for the entry fields or functions are displayed
when you click on the button.
• The view of all 3D images, e.g. for library components or in the 3D simulation, can be zoomed
and moved to see details better.
To do this, click in the 3D image and change the view.
– Zooming the view: rotate mouse wheel up/down
– Moving along the axes: left mouse button and move mouse
– Rotating the view: right mouse button and move mouse
– Operation via the keyboard (Page 84)

Figure 6-5 Examples of 3D images that can be zoomed, rotated and moved

6.4.3 Operating 3D simulation using the keyboard

The view of all 3D images, e.g. for library components or in the 3D simulation, can be zoomed
and moved to see details better. You can also use these functions via the keyboard.

System Manual Run MyVirtual Machine

84 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.4 Operation and setting

Functions of the keys and key combinations

The most important functions of the keys are listed in the function overview.

,FZ
HSPVQT
GPS
MJOFBS
NPUJPO ,FZT
GPS
EJBHPOBM
NPWFNFOUT

UPQ
MFGU 1PT
2

UPQ
SJHIU &OE
VQ
EPXO &

CPUUPN
MFGU 1BHF :;

8 MFGU
SJHIU
CPUUPN
SJHIU 1BHF $
" 4 %
 

"EEJUJPOBM
LFZT
POMZ
BT
LFZ
DPNCJOBUJPO

"MU 3PUBUJPO
BSPVOE
UIF
BYJT
JO
UIF
EJBHSBN
QMBOF

1BO 4IJGU
JO
UIF
EJBHSBN
QMBOF

4IJGU 4MPXT
EPXO
NPWFNFOUTIJGU

$USM 4QFFET
VQ
NPWFNFOUTIJGU

2VJDLMZ
UPHHMJOH
CFUXFFO
WJFXT "EEJUJPOBM
GVODUJPOT

  %JTQMBZ
DPNQMFUF
EJBHSBN ' $FOUFST
UIF
EJBHSBN

  7JFX
GSPN
UIF
MFGU ' $USM %JTQMBZ
DPNQMFUF
EJBHSBN

  7JFX
GSPN
UIF
SFBS  /  ;PPN
JO

  7JFX
GSPN
UIF
SJHIU   .  ;PPN
PVU


  7JFX
GSPN
UIF
GSPOU

  7JFX
GSPN
UIF
UPQ

  7JFX
GSPN
UIF
CPUUPN

  'JSTU
*40
WJFX
GSPN
GSPOU
SJHIU

  4FDPOE
*40
WJFX
GSPN
SFBS
SJHIU

Figure 6-6 Functions of keys in 3D simulation

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 85
3D simulation (option)
6.4 Operation and setting

6.4.4 Using layers

The 3D simulation used layers to hide certain layers during the simulation. Depending on the
machine model, you can show or hide different layers in the 3D simulation. By default, all layers
are displayed.
Examples of layers:
• Symbol of the active work offset
• Machine housing
• Tool table
• Setup (clamping operation)

Displaying and using layers

You define the visible layers using the layer menu.
1. For example, in the Machine view, click the Layer button to display the menu.
2. Click the button of the layer you want to hide. The button is grayed out.

Figure 6-7 Showing and hiding a layer: machine housing and table hidden

3. Click the Layer button to hide the menu. The layer setting is saved centrally and used
again at the next start.

Layer settings
The display of layers is used in the "Machine", "Setup" and "Collisions" views. The layer settings
are centrally managed and the same settings are used in all views.

Restrictions
Work offsets are visualized in reference to "Mount Stations". The work offset is incorrectly
visualized if the "Mount Station" is not located at the machine zero.
The work offset only shows the active offset for the 1st channel, referred to the first "Mount
Station" of the machine model.

System Manual Run MyVirtual Machine

86 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.4 Operation and setting

6.4.5 Settings

6.4.5.1 Settings
In the "Settings" tab for example, you switch over the user interface language, define a
standard diameter for the tool holder and export/import archives.

Adapter diameter with definition via parameters

For 3D Simulation, enter a default value for the definition of the tool holder diameter via
parameters for milling tools/drill bits. The default value for the adapter diameter is 50 mm.

How to change the default value for the adapter diameter

1. Enter a new value for the "Adapter diameter for definition via parameters" in the "Settings"
tab.
2. Click "Save".
The change to the adapter diameter only becomes effective for new definitions. You can still
change the default value when defining the adapter in the tool manager.
3. Switch back to the "Machine" tab.

User interface language

The 3D Simulation is available in several user interface languages.

How to change the user interface language

1. Select the new user interface language in the "Settings" tab under "Language selection ".
The user interface language is switched to the selected language.
2. Switch back to the "Machine" tab.

Exporting/importing archives and machine model

Archives
In archives you can save settings and data of the 3D Simulation or exchange them between
two machine projects.
More information on archives can be found in the Exporting/importing archives (Page 88)
section.

Machining settings

Workpiece transfer/cutting off

Activate these machining settings to allow cutting off functions with subsequent workpiece
transfer, e.g. into the counterspindle, in the 3D Simulation.
• Activate/deactivate workpiece transfer
• Activate/deactivate workpiece cutting off

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 87
3D simulation (option)
6.4 Operation and setting

More information on this function is provided in Section Cutting off workpiece and
transferring to the counterspindle (Page 79).

Activating extended turning functions for turning tools

By activating this function, it is possible to simulate the "Shaping". If this option is activated,
the turning tools (type 5xx and 6xx) shape material when the tool spindle or the workpiece
spindle is in positioning mode.

Note
SINUMERIK interpolation cycles are not supported. CAM-based "shaping" and off-center turning
and taper turning are supported.

CAD export settings when using "*.stp" files

You enter the tolerances here for the converting process from STEP to STL. When converting
from STEP to STL, the 3D model is approximated using triangles. Using these tolerances, you
configure permissible tolerances for deviation to the model.

Tolerance Description
Chord tolerance The chord tolerance specifies the maximum distance between a chord and the real curved
surface in mm or inches.
The value of the chord tolerance lies between 0.001 mm (0.00003 inches) and 0.1 mm
(0.00039 inches). The default value is 0.08 mm (0.00315 inches).
Angular tolerance The angular tolerance specifies the maximum angle between adjacent chords in degrees.
The angular tolerance lies between 0 and 90 degrees. The default value is 18 degrees.

This is how you change the tolerances

1. Enter the values for chord and angular tolerance in the "Settings" tab under CAD settings.
2. Click "Save". The tolerances become effective.
3. Switch back to the "Machine" tab.

6.4.5.2 Exporting/importing archives

For data backup or transfer between machine projects, you can export and import "*.zip"
archives in the 3D simulation. You export/import the archive in the "Settings" tab.

Data in the archive

The archive contains the following data.
• All library components (e.g. blanks, tool components)
• Tool data (tools with defined protected areas)
• Machine model
• Settings (e.g. adapter diameter, language)

System Manual Run MyVirtual Machine

88 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.4 Operation and setting

Note
You can only export/import archives when 3D simulation is not active.

Exporting an archive
How to export the 3D simulation data to an archive.
1. Click on the "Export" button.
The "Export archive" window with the selection of the data to be exported and any already
existing archives is displayed.
2. Select the export data. By default, all data is exported.
Note
Tool data can only be exported together with the library data.

3. Enter a name for the "*.zip file" or keep the suggested name.
The length of the name is limited to 40 characters.
4. Click "Export".
The data are saved as "*.zip" file in the selected folder. Once the export is done, a message
about the successful export is displayed.
5. Check the displayed error message if the export is canceled.

Importing an archive
You can import archives in the exchange folder into the 3D simulation.

Requirement
• No setup (clamping) is active in the 3D simulation.
• The "*.zip file" and the data it contains must conform to the import format.
• If the zero point is not present in the machine from an imported setup (clamping connected
to a work offset), the connection is made to the default mount station.

How to import an archive

1. Copy the "*.zip" archive to the storage folder.
2. Click on the "Import" button.
The "Import archive" window with the selection of existing archives is displayed in the
selected folder.
3. Select the archive file.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 89
3D simulation (option)
6.4 Operation and setting

4. Click on "Import" and confirm the message with "Yes".

Note
Before the import, all current data (library, tool data, machine model, settings) are deleted.
Changes since the last archiving are lost in this case.
The selected archive is imported. Once the import is done, the import dialog is closed and a
message about the successful import is displayed.
If an error occurs during an import step, all changes are undone through a rollback
mechanism.
5. Save the machine project before closing it to save the imported data.

6.4.6 Switching between different unit systems ("metric"/"inch")

Unit system in 3D simulation

The 3D simulation works with the system of units that has been set in SINUMERIK Operate. You
can set the effective system of units directly in SINUMERIK Operate or toggle between "metric"
and "inch".

Note
Switching over the system of units
After switching over the system of units in SINUMERIK Operate, the new system of units is not yet
effective in the 3D simulation. To make it effective, you have to restart the NCK. To do this, you
perform a machine project reset, or you end the machine project and restart it.

Requirements
• Machine project has started
• No NC program is being processed
• 3D simulation is not active

How to switch over the system of units

1. In SINUMERIK Operate, click on the extended horizontal softkey bar 2 in the JOG or
AUTOMATIC operating mode.
2. Click the "Settings" softkey in the horizontal softkey bar.
3. In the vertical softkey bar, click the "Toggle inch" or "Toggle Metric" softkey depending on
which system of units is active.
SINUMERIK Operate is switched to the new system of units.

System Manual Run MyVirtual Machine

90 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

4. Click the "Reset" button to restart the machine project.

Following reset, the unit system switchover also becomes effective in the 3D simulation. All
the tool data and other geometric data are displayed and processed in the new system of
units.
5. Save the machine project to ensure that the unit system switchover is permanently saved in
the project.

6.4.7 Requirements for 3D simulation

Requirements
Before you run a 3D simulation with collision detection, the following requirements must be met.
• The machine model is integrated into the machine project ("*.vcp") (by the machine
manufacturer) and the project is saved
• Tools, adapters, setup, blank and protection area are defined in the library
• The protection function and protective areas (workholders) of the tools used are defined
• Setup, matching the NC program, is activated
• Collision detection is activated
You can find more detailed information in the following sections.

See also
Integrating 3D simulation into a project (Page 177)
Components in the library (Page 91)
Tools (Page 116)
Setup (clamping) (Page 159)
Collisions (Page 170)
Simulating machining operations and workflows (Page 174)

6.5 Components in the library

6.5.1 Library
In the library, you manage the components tools, adapters, protection areas, blanks and setups
for 3D Simulation.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 91
3D simulation (option)
6.5 Components in the library

Overview of library
You create, edit and manage components in the symbolic view of the library. A separate tab is
available for each component.

Note
Active components are blocked
Components that are currently active in the 3D simulation cannot be edited or changed.

System Manual Run MyVirtual Machine

92 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library







① Components belonging to a type are saved in different tabs in the library. Click on the appropriate component tab to
manage the components.
② Here, enter a term that you want to search for in the active library tab. The hits are displayed in the tab.
Click on the "X" in the search field to delete the search term.
③ An overview of all configured components of the same type is displayed together with a preview image and names.
To edit, click on the component.
④ By clicking on "+ New library element", the menu is displayed with the component types to be created and the elements
to be imported from the library.
⑤ By clicking on the menu entries you create new components of the selected type.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 93
3D simulation (option)
6.5 Components in the library

⑥ Using "Import element", you import library elements into the library as "*.zip". The imported components are extracted
and displayed in the library. With this function you can import exported components from other machine projects.
The "*.zip" files in the storage folder and/or in the selected directory are available for import.
⑦ Click "Select several " to select one or more components from the library. You can, for example, delete the selected
components or export them as "*.zip". The exported component is saved as a file in the storage folder and/or in the
selected directory.
Figure 6-8 Managing 3D simulation components in the library using component "Protection areas" as example

Automatic creation of library elements

You create components in the library. During protection definition for adapters and tools, library
elements are automatically generated from the imported "*.stl/*.stp" geometries.

6.5.2 Component types and properties

You configure and manage the following components and their parameters in the library.

Component types
In the following table the components are shown with icon and description.

Symbol Component Description

Tool Cutting or non-cutting geometry of the tool, e.g. inserts and shank

Adapter Tool adapter, tool holder

For example, holders for tools with shanks with a steep or hollow taper.
Protection area A protection area locates the blank. Protection areas are, for example, ma‐
chine vises, chucks or clamping jaws.
Blank Workpiece blank
E.g. block, cylinder
Setup The setup consists of a protection area and the matching blank. You can
also set up several protection areas and blanks, e.g. clamping towers or
machine vises, in one setup.

System Manual Run MyVirtual Machine

94 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

Properties and parameters of components

The following table shows the parameters of the components.

Properties/parame‐ Description
ters
Component name and A component has a component name that is unique throughout the project. The name can be a
ID maximum of 40 alphanumeric characters long.
Valid characters are:
• A-Z
• a-z
• 0-9
• Underscore ( _ )
Note:
The character and length restrictions apply to all names assigned within the 3D simulation.
"*.stl", "*.stp" Components are defined as 3D geometry files in the "*.stl", "*.step", "*.STEP", "*.stp", "*.STP" (3D
model) formats.
You create the 3D geometry using an external program and import it when you create a new com‐
ponent. The 3D geometries are available for import as files in the storage folder.
Geometrical shapes Optionally, blanks can be created using parameterizable standard geometries in the library

6.5.3 Reference system of components

Reference systems and meaning

Depending on the type, the components have different reference/coordinate systems. The
coordinate origin/zero point is the basis of a coordinate system that you define for the
components. The reference system can be rotated or moved.
The reference systems of the components in the 3D geometry files (clamping equipment,
blanks, adapters) usually cannot be used for 3D Simulation without modifications. Therefore,
after importing, you can change the zero point and rotations of the coordinate system within
the components.

Note
The files with the 3D geometries for a setup (protection area, blank) should be exported from the
design system with an identical component zero point. In this case, the positions for the
protection area, blank, and positioning in the machine can be used without offsets.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 95
3D simulation (option)
6.5 Components in the library

Table 6-1 Overview of the reference systems

Reference system Description

Reference Point R This point is used to position the component in relation to the machine zero point. A newly created
component has no reference point; only an "empty" reference point is displayed. You must first
define the reference point, i.e. you must enter and save the values for the position.
Blanks and clampings can have several reference points.
Mounting Point MP This point is used to connect a component with other components. The Mounting Point of a com‐
(Plug, Mounting Point) ponent can be connected to the Mount Station of another component. Components can only have
one Mounting Point.
Mount Station MS The Mounting Point of another component can be connected at this point. The components are
(Socket, Mount Station) aligned at the defined points. Mounting Point and Mount Station lie above one another.
Using the Mounting Point and Mount Station functions, you can define a mount station on a machine
vice and a mounting point on the blank. When defining the setup, the machine vice and the blank are
aligned at this point.
Reference systems in • The zero points of the reference system are displayed as a colored sphere in the preview image.
the preview image • The color of the sphere in the preview image corresponds to the color code in the parameters of
the reference system, e.g. the reference point is blue.

Table 6-2 Overview of the parameters of reference systems

Parameters of reference sys‐ Description

tems
ID ID of the reference system. The ID is generated automatically and should not be changed.
Coordinates X, Y, Z The values X, Y and Z define the position of the component along the coordinate axes. Positive
and negative values can be entered for the values. The value range is: [-9999.999 to
+9999.999].
Rotation of axes A, B, C The values A, B, C define the rotation of the component around the coordinate axes. Positive
and negative values from -359.999° to +359.999° can be entered.

System Manual Run MyVirtual Machine

96 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

Example of the blank component

A reference point (blue) was created in the following example at position (140, -140, 0) at the
lower left-hand corner of the blank. The Mounting Point (red) lies centered at the lower side at
(0, 0, 0).

 
 

 

① Preview image of the "*.stl/*.stp" file. You can zoom, rotate or pan the preview image. Changes
to the coordinates of the reference systems are immediately displayed in the preview image.
② Coordinates of the created reference point.
③ Click "+" to create new reference points.
④ Click the "recycle bin" button to delete existing reference points.
⑤ Example of a Mounting Point, centered at the lower side of the blank
⑥ More information, help screens and videos about the input field are displayed by pressing the
information button.
Figure 6-9 Example of blank with defined reference point and Mounting Point

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 97
3D simulation (option)
6.5 Components in the library

6.5.4 Tool

Parameter
A tool has the following parameters.

Parameter Description
Definition Importing an "*.stl file" or "*.stp file" into the library
with name and ID.
Reference systems
Reference point (R) 1
Mounting station (MS) -
Mounting point (MP) 1

Figure 6-10 Tool: Example end mill

System Manual Run MyVirtual Machine

98 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

Cutting edge length tool

You can directly define a cutting edge length for imported tool geometries. If you enter the
cutting edge length and click on "Apply", a new tool geometry with a new name and a cutting
and non-cutting part is created. The cutting edge and the shank are colored differently and two
icons are displayed as symbols in front of the new component name. Enter a new name for the
tool.

Figure 6-11 Tool: Example end mill with cutting edge length

Note
You can use the cutting edge length only once. If you want to change the cutting edge length,
you must import the tool geometry again.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 99
3D simulation (option)
6.5 Components in the library

6.5.5 Adapter

Parameter
An adapter has the following parameters.

Parameter Description
Definition Importing an "*.stl file" or "*.stp file" into the library
with name and ID.
Reference systems
Reference point (R) -
Mounting station (MS) 1
Mounting point (MP) 1

Figure 6-12 Tool component: example milling cutter holder

System Manual Run MyVirtual Machine

100 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

6.5.6 Blank

Definition
A blank has the following parameters.

Parameter Description
Definition Importing an "*.stl file" or "*.stp file" into the library
with name and ID.
Blank from "*.stl/*.stp" file (Page 105)
Creating a 3D model from parameterizable, geo‐
metrical shapes, e.g. a block.
Blank from a parameterizable form (Page 108)
Reference systems
Reference point (R) n (must first be defined)
Mounting station (MS) -
Mounting point (MP) 1

Figure 6-13 Blank imported from *.stl file and reference points defined

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 101
3D simulation (option)
6.5 Components in the library

6.5.7 Protection area (workholder):

Parameter
A protection area has the following parameters.

Parameter Description
Definition Importing an "*.stl file" or "*.stp file" into the library
with name and ID.
Reference systems
Reference point (R) n (must first be defined)
Mounting station (MS) n (must first be defined)
Mounting point (MP) 1

A protection area can also consist of several components, e.g. a stationary and the movable
part of a machine vise. In this case, you define several protection areas in the library and for
the setup, you select the total clamping from the individual protection areas.

Figure 6-14 Example protection area: Machine vise

System Manual Run MyVirtual Machine

102 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

6.5.8 Setup (clamping)

Parameter
A setup is the combination of protection area and blank and can consist of one or several blanks
and protection areas, e.g. multiple clampings.

Parameter Description
Definition
Blank Import of 1 to n blanks from the library.
Protection area Import of 1 to n protection areas from the library.
A setup can be composed of several protection
areas, e.g. a stationary part and the moving part of
a machine vise.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 103
3D simulation (option)
6.5 Components in the library

Overview of "Setup"
A setup with a blank and a machine vice (protection area) is defined in the following example.
The individual setup functions are briefly explained.










① Name of the setup

② Click on button to import a complete setup (blank and protection area) as "*.stp" file.
③ Blank
Click on to create a new blank from an "*.stl" or "*.stp" file.
Click on to create a blank from simple geometric shapes.
Click on to import a blank from the library.
④ Name of the blank
Click on to configure the reference systems.
If the protection area has more than one Mount Station (MS), then for the blank you must still assign the Mounting
Point (MP) to the corresponding Mount Station (Page 112). If a position is not assigned, then the Mounting Point is
automatically assigned to the Mount Station defined in the machine model.
Click on to delete the blank.

System Manual Run MyVirtual Machine

104 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

⑤ Protection area
Click on to create a new protection area from an "*.stl" or "*.stp" file.
Click on to import a protection area from the library.
⑥ Name of the protection area
Click on to configure the reference systems. For protection areas with several Mount Stations, also define the
assignment for the Mounting Point of the blank.
Click on to delete the protection area.
⑦ Use the layer to hide the machine housing if you want to check the position of the configuration in the machining area.
The layer settings are only applied in the view of the configuration in the library. The settings in area "Machine" and
"Activate configuration" remain unchanged.
⑧ The configuration is displayed at the configured position in the machining area. This means that you already have the
possibility of checking the position when creating the configuration. If necessary, adapt the reference systems of the
components so that the clamping equipment is positioned to address your specific requirements.
Figure 6-15 Example of a setup with blank and protection area

6.5.9 Creating components using the example of a blank

You create components in the "Library". The creation procedure is identical for all component
types except "Setup". The procedure is illustrated using a blank as an example.
Define at least one blank in order to use the 3D simulation. All components are necessary for
realistic collision detection and simulation.
• Blank
• Protection area (optional)
• Setup (optional)
• Adapter (optional)
• Tool (optional)

How to create a component in the library

1. Click the "Library" tab.
2. Click on the "+ New library element" button and in the menu that is displayed select "Blank".
A window with an empty component is displayed.
3. Click on button "New blank from" to import a geometry.
A dialog opens.
More information: Optionally, you can also directly create blanks from basic geometrical
shapes (Page 108) in the library.
4. Select the "*.stl / *.stp" file of the 3D model.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 105
3D simulation (option)
6.5 Components in the library

5. The next steps differ depending on the file format of the 3D model.
"*.stl" file
The 3D model is immediately imported.
"*.stp" file
– For multi-section 3D models, select the components that are to be imported.
– Click on button "Add Selected Items as Blank".

Figure 6-16 Example, blank with a component imported as "*.stp" file

– The selection is accepted. Click on to display the selection in the 3D image for checking
purposes.
– Confirm with "Import".
The imported 3D model is displayed.

System Manual Run MyVirtual Machine

106 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

6. Optionally, you can define the reference systems using button .

– Click "+" to create a new reference point.
– Enter new coordinate values for the reference system.
In the example, a new reference point (blue) was defined at the left-hand lower corner. A
Mounting Point (red) was defined centrally on the lower side.

Figure 6-17 Example of blank: Reference point left-hand corner, Mounting Point, centered at the
lower side.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 107
3D simulation (option)
6.5 Components in the library

7. Click "Save". The dialog is closed and the defined geometry for the component is displayed.

Figure 6-18 Example of blank: Components created for the library

8. Save the changes or the component. The window is closed and the new component is
displayed in the library.
9. Create additional components in the library.

6.5.10 Blank from basic geometrical shapes

You create the blank in the library from specified geometrical shapes. You parameterize the
standard shapes when creating the blank. "*.stl" or "*.stp" files are not necessary.

System Manual Run MyVirtual Machine

108 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

Overview of specified shapes for blanks




① When creating a new blank, click on the button to create the blank from a parameterizable shape.
② Select the basic geometrical shape of the blank. The following basic shapes are available:
• Block (dimensions in X, Y, Z)
• Cylinder (diameter and height)
• Pipe (diameter, wall thickness and height)
• N-corner (number of corners, edge length and height)
③ Depending on the selected basic shape, parameterize the dimensions of the geometric shape. The preview is shown
at the top.
④ As default, the basic shape has a Mounting Point at the bottom center of the blank. You can shift the Mounting Point
or rotate the reference system.
⑤ Preview of the parameterized shape
Figure 6-19 Parameterizable geometric shapes to create blanks

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 109
3D simulation (option)
6.5 Components in the library

6.5.11 Multi-part STP component for individual components

When creating a component from the STEP file with subordinate components (e.g. complex
clamping equipment), when importing the STEP file, you can select individual components and
import as new component.

Requirement
A new component is created in the library.
An "*.stp" file is selected as 3D model.

This is how you work with STEP files with several components
In the example, a new protection area is created from a multi-part component.
1. Activate the checkbox in front of the component, which is to be imported as new protection
area.
2. Click on button "Add Selected Items as Protection Area".

System Manual Run MyVirtual Machine

110 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

3. Enter a name for the new component.

Figure 6-20 Individual components of a multi-part STEP model selected for import

4. Confirm with "Import". The imported selection is displayed as 3D model.

Figure 6-21 Protection area created from a STEP model

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 111
3D simulation (option)
6.5 Components in the library

6.5.12 Assigning mount stations for setups

If, in a setup, a protection area is configured with more than two mount stations, for the blank,
the mounting points must be assigned to the mount station. For example, this is the case if you
are using a clamping tower with several clamping ranges.

Requirement
A setup with blank and protection area is open.

This is how you assign the mount station to the blank at the protection area
1. Open the dialog of the reference points at the blank. In addition to the mounting point, a
button is displayed if the protection area has several mount stations.

Figure 6-22 Reference points of the blank: Display of the Mounting Point

2. Click on the button. The dialog to assign the mount station at the protection area is displayed.
3. Click on the mount station that should be assigned to the mounting point of the blank.

Figure 6-23 The mounting point of the blank is assigned mount station MS1

4. Save the dialog and switch to the setup. The points are linked with one another.
5. Repeat the operation if you wish to link additional points.

System Manual Run MyVirtual Machine

112 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

6.5.13 Multi-part STP component for setups

When creating a setup from a STEP file with several components (e.g. completed clamping
towers with blanks), when importing the STEP file, you can select individual components and
define as protection area or blank.

Requirement
A new setup has been created, and the STEP file has been imported with the protection area and
the blanks.

This is how you create a setup from a STEP file

In the example, a setup is created from a clamping tower with three blanks.
1. Activate the checkbox in front of the component, which is to be imported as new protection
area.
2. Click on button "Add Selected Items as Protection Area".
3. Enter a name for the new protection area.
4. Activate the checkbox in front of the component, which is to be imported as new blank.
5. Click on button "Add Selected Items as Blank".
6. Enter a name for the new blank.
7. Repeat the operation if wish to add additional blanks.







Figure 6-24 Importing a clamping tower with blanks as new setup

8. Confirm with "Import". The new setup is imported.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 113
3D simulation (option)
6.5 Components in the library

6.5.14 Set mounting point for configurations in the 3D model

When creating a setup from a STEP file, you can manually set the mounting point in the 3D model
with the mouse pointer when importing.

Requirement
A new setup has been created, and the STEP file has been imported with the protection area and
the blanks.

This is how you define the mounting point in the 3D model

In the example, the mounting point is set in the 3D model for a clamping tower.
1. Click on the button in the 3D model . The coordinate table is displayed.
2. Select a surface in the 3D model. The vertex of the surface is marked with a blue cross.
3. Double-click on the point. The new mounting point is displayed as red sphere and the
coordinates are displayed.
4. You can still shift or rotate the mounting point using the coordinate table.
5. Select the components for blanks and protection area and assign the setup.

System Manual Run MyVirtual Machine

114 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.5 Components in the library

6. Confirm with "Import".





Figure 6-25 Setting the mounting point in the 3D model

7. The mounting point is used and displayed in the setup.

Figure 6-26 Mounting point in the setup

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 115
3D simulation (option)
6.6 Tools

6.5.15 Exporting/importing library components

You can export/import library elements as a "*.zip" file, for example to exchange data with other
projects. The files are exchanged via the storage folder or via a freely selectable directory.

Exporting components
1. In the library, click on the "Select Multiple" button.
2. In the individual tabs of the library, select the component that you wish to export. Multiple
selection is possible.
3. Click on "Export selection".
4. Enter a name in the dialog that appears and confirm with "Save".
The exported "*.zip" file is saved in the storage folder or in the selected directory.

Importing components
1. Copy the "*.zip" file to be imported into the storage folder or into a directory of your choice.
2. In the library, click on the "+ New library element" button and in the menu that is displayed
select "Import element".
3. Select the "*.zip" file in the dialog that appears and confirm with "Open".
The components are extracted and created in the library. If components with the same name
exist, the import is canceled.

6.6 Tools

6.6.1 Tool manager

Managing tools for 3D Simulation

The tool manager is displayed when you click on the tool icon on the start page of the 3D
Simulation. All tools are displayed with the magazine/location number, the tool name, a preview
image and the protection status in a vertical list. You can move the list up or down to display
additional tools by clicking on the tool list with the left-hand mouse key pressed or using the
slider. Tool details are displayed in the right-hand area by clicking on the corresponding tool.
The tool manager is synchronized with the tool list in SINUMERIK Operate and contains the
tools defined there.

System Manual Run MyVirtual Machine

116 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

 




① TOA area for multi-channel machines

For multi-channel machines, each channel has a TOA area with its own tool list. These are selected from the selection
list in the tool manager, e.g. TOA 1 and TOA 2. The corresponding tools are contained within each TOA tool list. Only
TOA 1 is displayed for 1-channel machines.
② Searching for tools in the tool list
Here, enter the search term in the tool manager. At the same time as the entries are made, hits are displayed in the tool
list.
③ The tool list is filtered by clicking on button (shield icon). By clicking several times, the filter criteria change and the
button color correspondingly changes.
• Gray: All tools are displayed
• Green: Only tools with protection definition are displayed
• Red: Only tools without protection definition are displayed
④ The active tool in the spindle is marked with a spindle symbol.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 117
3D simulation (option)
6.6 Tools

⑤ The selected tool is shown with grey background, and the tool details are shown in the right-hand area. A green shield
icon is displayed if the protection (adapter) has already been defined for the tool.
The magazine number/location number of the tool is displayed in the first column. If no location has been assigned for
the tool in the magazine, then only the magazine is displayed, but not a location number, e.g. 1/-.
For multitools, the magazine and location numbers are displayed for the complete multitool adapter. The individual
tools in the multitool are displayed below the adapter without magazine and location numbers.
⑥ You can define a color for every tool. For stock removal simulation in the 3D view, the machined surface is displayed
in the tool color. Click on the paint roller icon to assign a color to a tool. "Red" was selected in the example.
⑦ Tools where protection has not been defined or not completely defined are shown with a red shield icon.
Tools where protection has not been defined are all those tools without a configured adapter (tool holder).
⑧ You can zoom in and out of the tool list using buttons "+" or "-".
⑨ "Fast protection" for the tool is defined in the example.
⑩ Deletes the current protection definition
Click on the red button "Reset tool definition" to delete the current protection definition. You can define a new pro‐
tection after deleting the protection definition.
Figure 6-27 Example: Tool manager for a 1-channel machine

Meaning of the protection

In addition to the geometry data from the SINUMERIK Operate tool list, you also define the
protection. The protection definition describes the tool holder geometry (adapter component)
and other geometry data of the cutting edge or the tool (tool component). Thus a realistic
simulation with collision detection is achieved. You set the additional data before starting the
simulation. Changes made during the simulation only take effect when the simulation is
restarted. Tools with a protection definition are marked using a green shield icon.

6.6.2 Tool manager and tool list in SINUMERIK Operate

The tools in the Manager correspond to the tool list in SINUMERIK Operate. If data of the
SINUMERIK Operate tool list changes, it is also updated in the 3D simulation. If protection
variants have already been defined for the tools, they are transferred to the changed tool or
deleted according to certain rules.

System Manual Run MyVirtual Machine

118 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

Changed tools and protection areas

• If you change a tool parameter in SINUMERIK Operate while you are defining a protection for
this tool in the 3D simulation, the window for defining tools is closed automatically.
• If you change the tool type in SINUMERIK Operate for a tool that has already been defined
with protection in the 3D simulation, the following rules apply.
The defined protection remains in place:
– The new tool type is also a milling tool or even an unsupported tool type.
The defined protection is deleted:
– The old tool type and the new tool type are a turning tool.
– The tool type is changed between milling, turning or drilling.
– The tool length is changed to a value of the < unclamping length.

Tool geometry 3D Simulation and tool data in the tool list

By default, tool data are taken from the SINUMERIK Operate (NC) tool list. Optionally, you can
also import the geometry file ("*.stl/*.stp") of the tool. For collision consideration, in this case,
you can use the geometry data of the imported tool and not the data from the SINUMERIK
Operate tool list, e.g. tool length and diameter. When using an imported tool geometry, you
must compare the dimensions of the tool in the geometry file with the tool data in the
SINUMERIK Operate tool list.

More information
Aligning cutting edge D1 and tool geometry (Page 145)

6.6.3 Overview of tool types

Only a selection of the SINUMERIK Operate tool types is supported in the 3D Simulation.
Supported tools are read in with all parameters from the SINUMERIK Operate tool list. Depending
on the tool type, different protection variants are defined.

Note
Constraints relating to tools
• For unsupported tools, the replacement tools are used when defining the protection variant
and for simulation. The replacement tools can be found in the table of supported tool types.
• For tools with several cutting edges (flutes), D1 is used as criteria as to whether the tool is a
milling or turning tool.
• Internally, drill bits have the same logic as milling tools

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 119
3D simulation (option)
6.6 Tools

Overview of the supported tool types

For more information on the tool types and the associated parameters, refer to the online help
of SINUMERIK Operate.

Technology Tool type number Tool type name/description

Milling tools
110 Ball nose end mill
111 Ball end mill tapered
120 End mill
121 Tapered ball nose end mill
155 Bevel cutter
156 Bevel cutter with corner rounding
--- Tool types that are not listed are still not supported. These are interpreted as
end mills (type 120).
Drill bits
200 Twist drill
220 Centering tool
-- Tool types that are not listed are still not supported. These are interpreted as
end mills (type 120).
Turning tools
500 Roughing tool
510 Finishing tool
520 Plunge cutter
530 Cutting tool
540 Threading tool
550 Button tool
560 Rotary drill
580 3D probe turning machine (probe with cutting edge position parameters)
--- Tool type 585 calibrating tool is interpreted as end mill (type 120).
Tool types 525 and 535 are interpreted as plunge cutter (type 520).
Other tool types not listed above are interpreted as roughing tools (type 500).
Special tools
Probes
710 3D probe
711 Edge finder
712 Mono probe
713 L probe
714 Star probe
725 Calibrating tool
730 Stop
--- Tool types that are not listed are still not supported. These are interpreted as
end mills (type 120).
Options (from CNC-
SW V6.15 SP2)
--- Angle head

System Manual Run MyVirtual Machine

120 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

6.6.4 Protection areas for tools

Protection definition
For tools (milling, drilling and turning tools), you define the protection areas for the adapter (tool
holder) and the tool (tool or tool shank incl. tool tips). You can specify the geometry of the
adapter and the tool by importing a geometry file or via parameters.

$GDSWHU

7RRO

Figure 6-28 Example: Components adapter and tool for turning and milling tools/drill bits

The definition of protection for adapters and tools is optional. If no protection is defined, the
3D Simulation only checks for collisions between the tool and other components. For the
geometry of the tool without a defined protection, the tool data is taken from the SINUMERIK
Operate tool list (NC) and used for the 3D Simulation.
To ensure that the collision consideration is realistic, the adapter should always be defined for
each tool used so that it is also taken into account in the collision check.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 121
3D simulation (option)
6.6 Tools

How to open the protection definition for a tool

1. Open the tool manager.
2. Select the tool for which the protection definition is to be carried out.
3. Click on the "Protection definition" button framed in red to define the protection area for the
selected tool.

Figure 6-29 Defining the protection areas for a tool using the example of an end mill

The window for defining the protection is displayed and you can specify the options for the
protection areas in the next step.

System Manual Run MyVirtual Machine

122 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

Options for protection areas

The protection areas for the adapter and tool are defined independently of each other. You can
define the protection area for the adapter and tool or only for the adapter, for example.

 

  

  

Figure 6-30 Options for protection areas for a tool using the example of an end mill

The following options are available for defining the protection areas:
① Import complete assembly consisting of adapter and tool geometry as "*.stp" file
② Import adapter geometry as "*.stl" or "*.stp" file
③ Adapter geometry is defined via parameters
④ Import adapter geometry from the library
⑤ Import tool geometry as "*.stl" or "*.stp" file
⑥ Tool geometry is defined via parameters

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 123
3D simulation (option)
6.6 Tools

⑦ Import tool geometry from the library

Note
When defining the protection areas via parameters, the geometry for the adapter and the tool is
defined by entering values for predefined parameters without importing an "*.stl" or "*.stp" file.
This option allows you to quickly define protection areas without 3D geometry files for adapters
or tools.

Protection definition and library

If you define a new protection and import adapter or tool geometries as "*.stl" or "*.stp" files,
these components are automatically saved as library components when the protection
definition is saved.

More information
Defining protection via parameters for milling tools/drill bits (Page 124)
Defining protection via parameters for turning tools (Page 127)
Defining protection for milling tools/drill bits (Page 132)
Defining protection for turning tools (Page 133)

6.6.5 Defining protection via parameters for milling tools/drill bits

You can define the geometry of the protection areas for the adapter and optionally for the tool
using predefined parameters. The following parameters are available.
Adapter
• Standard cylindrical shape with defined diameter.
The diameter value entered in the "Settings" tab is used for the adapter diameter. You can still
change this value.
• Protruding length (unclamping length/collar length) of the tool when used in an adapter
The protruding length must always be shorter than the tool length stored in SINUMERIK
Operate.
Tool
• Cutting edge length of the tool (colored area of the tool in the diagram)
• Tool length (taken from SINUMERIK Operate tool list)

System Manual Run MyVirtual Machine

124 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

How to define protection using parameters

1. In the tool manager, click on the tool for which you want to define a protection.
2. Click on the "Protection definition" button. The parameterization window appears.

Figure 6-31 Protection for adapters and tools via parameters

3. In the "Component adapter" area, click on the "Parametric" button . The parameters are
displayed.
4. Enter the values in mm for the "Protruding length" and the "Adapter diameter".
5. In the "Component tool" area, click on the "Parametric" button . The parameters are
displayed.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 125
3D simulation (option)
6.6 Tools

6. Enter the value in mm for the "Flute length". The other tool data is taken from the SINUMERIK
Operate tool list.
The protection area for the adapter and the tool is displayed in the preview image.

Figure 6-32 Defining protection for adapter and tool via parameters using the example of an end mill

System Manual Run MyVirtual Machine

126 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

7. Click on "Save changes". The values are saved and a preview image with a yellow flute length
is displayed.
The tool has the status "defined".

Figure 6-33 Adapter and tool with defined protection

8. Repeat the work steps if you want to define more tools.

Click on the "Machine" tab to close the tool manager.

See also
Defining protection for milling tools/drill bits (Page 132)

6.6.6 Defining protection via parameters for turning tools

You can define the geometry of the protection areas for the adapter and for the tool (tool shank
and cutting plate) using predefined parameters. The adapter and tool parameters are preset with
default values. Change the parameters according to the adapter and tool used. The adapter and
the tool are displayed in the 3D preview. Press the button "V" or "Λ" next to "Legend" to show or
hide a drawing with explanations of the individual parameters.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 127
3D simulation (option)
6.6 Tools

The following parameters are available, for example:

Adapter Tool
• "Axial" or "Radial" adapter • Tool shank "square" or "round"
• Thickness of the cutting plate

Parameters for the tool (shank, insert) with display of the

Parameters for the adapter with display of the legend
legend

System Manual Run MyVirtual Machine

128 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

How to define protection using parameters

In the following, the procedure is illustrated using a turning tool as an example.
1. In the tool manager, click on the turning tool for which you want to define a protection.

Figure 6-34 Protection definition for a turning tool

2. Click on the "Protection definition" button. The parameterization window appears.

3. In the "Component tool" area, click on the "Parametric" button . The parameters are
displayed.
Note
Sequence when defining
When defining, you should first parameterize the tool and then the adapter. This is because
the parameters for the adapter are automatically restricted depending on the shank type.
First define the adapter to be able to use the full selection of parameters.

4. Click the "v" button to display a detailed drawing of the shaft values.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 129
3D simulation (option)
6.6 Tools

5. Select the shank type and enter the parameter values.

Figure 6-35 Defining the shank of the turning tool with parameters

6. In the "Component adapter" area, click on the "Parametric" button . The parameters are
displayed.
7. Click on the "v" button to display a detailed drawing of the adapter.

System Manual Run MyVirtual Machine

130 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

8. Enter the parameter values. The other tool data is taken from the SINUMERIK Operate tool list.
The selection of parameters is restricted for a square shank. For a round shank, first select the
"axial" or "radial" design of the adapter. Other parameters are displayed dependent on this.
The protection area for the adapter and the tool is displayed in the preview image.

Figure 6-36 Defining a parametric adapter using a turning tool as an example

9. Click on "Save changes". The tool has the status "defined".

Note
If you define invalid values for the tool or adapter parameters, no 3D preview is displayed for
this tool. The tool then has no defined protection.

10.Repeat the work steps if you want to define more tools.

Click on the "Machine" tab to close the tool manager.

See also
Defining protection for turning tools (Page 133)

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 131
3D simulation (option)
6.6 Tools

6.6.7 Defining protection for milling tools/drill bits

When defining protection, you assign an adapter to the tool in the tool manager. Optionally, you
can still import a tool geometry. To define protection you can use various import variants of the
3D geometry, and combine them as required; e.g. the geometry of the adapter from the library
and the geometry of the tool by importing a tool assembly ("*.stp").

How to define protection for milling tools/drill bits

An adapter for an end mill is defined in the example. Optionally, you can specify the tool
geometry data using an "*.stl/*.stp" file.
1. Click on the tool for which you want to define protection.
2. Click on the "Protection definition" button. The protection options are displayed.
3. Import an adapter geometry (Page 135) or define an adapter geometry via parameters
(Page 124).
4. Optionally, you can import a tool geometry or define it via parameters. For this example, a
tool geometry is used by importing a "*.stl/stp" file.
Note
Generating a component from NC
As standard, tool data are taken from the SINUMERIK Operate tool list. Optionally, you can
also import the tool geometry file. For collision avoidance, in this case, you can use the
geometry data of the imported tool and not the data from the SINUMERIK Operate tool list,
e.g. tool diameter.

System Manual Run MyVirtual Machine

132 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

5. Import a tool geometry as "*.stl/stp" file.

Figure 6-37 Example of an end mill with imported adapter geometry

6. Click on "Save changes". The values are saved and the tool manager is displayed. The tool is
defined and is displayed with a green shield symbol.
7. Repeat the work steps if you want to define more tools.
Click on the "Machine" tab to close the tool manager.

See also
Importing a tool geometry as "*.stl./*.stp" (Page 140)

6.6.8 Defining protection for turning tools

When defining protection for turning tools, you assign an adapter to the tool in the tool manager.
You also define the tool geometry (shank and cutting plate). To define protection you can use
various import variants of the 3D geometry, and combine them as required; e.g. the geometry
of the adapter from the library and the geometry of the tool by importing a tool assembly
("*.stp").

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 133
3D simulation (option)
6.6 Tools

How to define a protection for turning tools

1. Click on the turning tool for which you want to define the protection.
2. Click on the "Protection definition" button. The protection options are displayed.
3. Import an adapter geometry (Page 135) or define an adapter geometry via parameters
(Page 127).
4. Optionally, you can import a tool geometry or define it via parameters. For this example, the
tool geometry was imported via "*.stl".

Figure 6-38 Example with imported geometries of the adapter and the tool

5. Click on if you wish to configure the reference system to align the components. The tool
must be positioned so that the cutting edge D1 lies on the cutting edge of the tool.
More information: Aligning cutting edge D1 and tool geometry (Page 145)
6. Click on "Save changes". The values are saved and the tool manager is displayed. The tool is
defined.
7. Repeat the work steps if you want to define more tools.
Click on the "Machine" tab to close the tool manager.

System Manual Run MyVirtual Machine

134 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

6.6.9 Adapter geometry "*.stl,*.stp" and library

You import adapter geometries to define the tool protection. This section contains the basic
information for importing and using adapters.

Requirement
The dialog for configuring the "protection definition" for the tool is opened.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 135
3D simulation (option)
6.6 Tools

How to import the adapter geometry for protection definition

In the following, the procedure is illustrated using a milling tool as an example. The procedure
is identical for turning tools.
1. In the window that appears, you can import the geometries via the "Import tool assembly"
button or in the area "Component: Adapter".
– Button
Import an adapter geometry and optionally a tool geometry from a tool assembly ("*.stp")
In parallel to the import, an adapter geometry is created in the library, which can then also
be used as library component.
– Button or
Imports an "*.stl/*.stp" file of the adapter geometry
In parallel to the import, an adapter geometry is created in the library, which can then also
be used as library component.
– Button
Uses the already defined adapter geometries from the library
The following conditions apply to the adapter geometries:
– An adapter can be composed of up to 5 part geometries (import via "*.stl/stp" or library
component) in the specified sequence.
– The positions of the mounting points and mount stations of the individual adapter
geometry define the overall geometry of the adapter.

.PVOUJOH
1PJOUT 
.PVOU
4UBUJPOT

Figure 6-39 Example adapter milling tool/drill bit, composed of three partial geometries

– You set the position of the adapter with respect to the tool using the Mounting Point, e.g.
you can shift the Mounting Point in the Z direction to set the unclamped length of the tool.
2. Click on if you wish to configure the reference system to align the components.
Note
Adapter from library
If you change the values of the reference system, the values of the library component are also
changed.

3. For the milling tool/drill bit adapters, define the property as to whether "Rotating" or "Rigid"
is used. By default, all adapters should be configured as "Rotating". For multi-part adapters,
you only need to define the first element. The subordinate adapter geometries inherit the
property.

System Manual Run MyVirtual Machine

136 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

Figure 6-40 Defining an adapter as rotating or rigid

Note
Angle head/probe
If an angle head or probe is used, the adapter must be configured as "rigid" (tools in the angle
head (Page 155)).

Figure 6-41 Angle head SINUMERIK Operate tool list

See also
Using the adapter geometry from the library (Page 137)
Defining the adapter and tool geometry via the assembly (Page 138)

6.6.10 Using the adapter geometry from the library

Use adapters from the library to define the tool protection.

Requirement
The dialog for configuring the "protection definition" for the tool is opened.

How to import an adapter from the library

In the following, the procedure is illustrated using a milling tool as an example. The procedure
is identical for turning tools.
1. In the area "Component: Adapter", click the button . The library is opened.
2. Select an adapter and click on "Import". The adapter is assigned to the tool.
3. Click on the button next to the geometry if you want to change the values for "Mounting
Point" and "Mount Station".
4. For milling tool/drill bit adapters, define whether it should be used "Rotating" or "Rigid". By
default, all adapters should be configured as "Rotating".
5. Repeat the last steps if you want to assign additional part geometries to the adapter.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 137
3D simulation (option)
6.6 Tools

6. Click on the button if you wish to delete existing adapter geometries.

7. Confirm with "Save changes".

See also
Defining protection for milling tools/drill bits (Page 132)

6.6.11 Defining the adapter and tool geometry via the assembly
To define the protection, you can import an entire assembly (adapter and tool) as an "*.stp" file.
You can import either all or only individual elements of the assembly, e.g. only the tool or only
the adapter.

Requirement
The dialog for configuring the protection for the tool is opened.

How to define protection with an assembly

In the example, an assembly consisting of an adapter and a drill bit with a replaceable head is
imported as an example. The procedure is identical for turning tools.
1. Click on "Import tool assembly".
2. In the dialog that is displayed, select the "*.stp" file and click "Open".
The 3D model ①, the individual elements ②, the "*.stp" file and the selection of the
adapter ④ or the tool ⑤ are displayed in the window.
Note
Mounting Point orientation (Mounting Point) ③
You change the orientation of the tool and/or the assembly in the coordinate system by
specifying the rotation in axes A, B, C of the Mounting Point. Before the import, possibly
adapt the orientation to the current requirements. The orientation must be defined for each
element of the assembly (adapter, non-cutting part of the tool, cutting part of the tool).

3. When importing the "*.stp" file, a check is made as to whether reference points are defined.
Defined reference points are identified and the individual elements with reference point are
marked using a gray circle. You can accept one reference point by clicking on it. The circle of
the selected reference point is then shown in blue. If the file does not contain any reference
points, a message is output that no reference points were found.
More information: Accepting a reference point for a file (Page 149)
4. To import, activate the checkboxes for the individual elements ② that you wish to import as
part geometry. You can activate 1-n elements for a part geometry.

System Manual Run MyVirtual Machine

138 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

5. Then click on the "Add as ..." button to import the selected individual elements into the
component as an adapter or as part of the tool geometry. For multi-part tools, e.g. with tool
tips (inserts), you can import the tool shank (non-cutting part) and the tool tip (cutting part)
separately.
– An adapter can consist of a maximum of 5 adapter part geometries ④.
– A tool can consist of a part geometry for cutting and non-cutting components ⑤.
In the example, the drill shank is defined as a "non-cutting part" and the replaceable head
as a "cutting part".

Figure 6-42 Importing an assembly comprising adapter and tool as protection

6. Optionally, enter a name for the imported geometry.

Note
Name that is unique throughout the project
The name of the component must be unique throughout the project. If the name is already
being used for an existing component, then an error message is displayed when saving the
component. In this case, enter a unique name for the component.

7. As a default, the Mounting Point③ is set at the zero point of the reference system of the STEP
file. You change the orientation of the reference system by rotating axes (A, B, C).

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 139
3D simulation (option)
6.6 Tools

8. Click on "Import" if you have created the required components.

Figure 6-43 Protection created from "*.stp" assembly for adapter and tool

9. If you defined only one tool component (cutting part only), you must enter a cutting edge
length and set it using the "Apply" button.
10.Click on if you wish to configure the reference system to align the components. The tool
must be positioned so that cutting edge D1 is centered on the tip of the tool.
More information: Aligning cutting edge D1 and tool geometry (Page 145)
11.Repeat the last steps if you want to assign additional part geometries to the adapter.
12.Click the button if you wish to delete existing adapter geometries or the tool geometry.
13.Click on "Save changes" to complete the setup.

6.6.12 Importing a tool geometry as "*.stl./*.stp"

To define the tool geometry, import an "*.stl/*.stp" file. For the collision avoidance, tool data
from the SINUMERIK Operate tool list are no longer used, but instead imported tool geometry.
The tool geometry of milling tools/drill bits consists of the shank (non-cutting part) and the tool
tips (cutting part).

System Manual Run MyVirtual Machine

140 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

Requirement
The "Protection definition" dialog for the tool is opened.

This is how you define a tool geometry using imported "*.stl/*.stp" files
In the following, the procedure is illustrated using a milling tool as an example.
1. In the area "Component: Tool", click the button . The dialog to select the "*.stl/*.stp" file is
displayed.
2. Select a file with the 3D geometry of the tool.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 141
3D simulation (option)
6.6 Tools

3. Confirm with "Open". The 3D program is displayed.

The next step depends on the selected file type. The following steps are identical again.
– "*.stl" file
The tool geometry is immediately imported.
– "*.stp" file
If necessary, change the orientation of the reference system ①. To import, activate the
checkboxes for the individual elements ② that you wish to import as part geometry. You
can define a geometry for the non-cutting and cutting part ③. Enter a name for the
component ④. Confirm with "Import".
In the example, the tool is imported as a "cutting part".

2 4

Figure 6-44 Tool geometry imported as "*.stp" file for the cutting part

The imported tool component is displayed. Cutting edge D1 is displayed in the preview
image. This allows you to check whether the imported 3D model matches the data of the tool
offset.

System Manual Run MyVirtual Machine

142 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

Figure 6-45 Tool geometry imported as "*.stp" file

4. Enter a "Flute length" and click on "Apply". A new tool geometry with a cutting and non-
cutting part is created. When creating the new tool geometry, all existing offset values of the
reference systems (e.g. reference point) are set to 0.
The cutting edge and the shank are colored differently and two icons are displayed as symbols
in front of the new component name.
Note
You can change the cutting edge length until you have saved the tool. After saving, you can
only change the cutting edge length by importing a geometry file again.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 143
3D simulation (option)
6.6 Tools

5. Click on if you wish to configure the reference system to align the components. The tool
must be positioned so that cutting edge D1 is centered on the tip of the tool.
More information: Aligning cutting edge D1 and tool geometry (Page 145)
After assigning the cutting edge length and positioning the tool on D1, the tool is defined.

Figure 6-46 Tool with cutting edge length and correct position of D1

6. Import another geometry for the adapter to complete the protection for the tool. The tool is
displayed as "Not-defined" in the tool manager if you do not define an adapter.
7. Confirm with "Save changes". The tool geometry is also saved in the library.
The tool geometry is defined.

6.6.13 Using the tool geometry from the library

To define the protection of the tool, import the tool geometry from the library.

Requirement
The "Protection definition" dialog for the tool is opened.

System Manual Run MyVirtual Machine

144 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

How to import a tool geometry from the library

In the following, the procedure is illustrated using a milling tool as an example. The procedure
is identical for turning tools.
1. Click the button in the area "Component: Tool". The library is opened.
2. Select a tool geometry and click on "Import".
3. Click on the button next to the component if you want to configure the reference system
for aligning the component. The tool must be positioned so that cutting edge D1 is centered
on the tip of the tool.
More information: Aligning cutting edge D1 and tool geometry (Page 145)
4. If no cutting edge length has yet been assigned in the imported tool geometry, you can add
it.
5. Click on the button if you want to delete imported tool geometries.
6. Confirm with "Save changes".

6.6.14 Aligning cutting edge D1 and tool geometry

After importing a tool geometry, the imported tool is usually not aligned with the defined cutting
edge D1 of the tool in the SINUMERIK Operate tool list.
The cutting edge D1 must be positioned on the imported tool geometry. This means, for
example, that D1 must be positioned centrally on the tip of the milling cutter for milling
cutters and on the tip of the insert for turning tools. You can define the correct position by
aligning the reference systems (e.g. values of the reference point) of the imported tool and
adapter components.

Note
Alternatively, you can change the tool data, e.g. the tool lengths, in the SINUMERIK Operate tool
list. However, this only makes sense if you are working with dummy data in the tool list for the
tool lengths in C/RMVM /3D and not with real tool data in PMM /3D Twin.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 145
3D simulation (option)
6.6 Tools

Figure 6-47 Cutting edge D1 positioned on tool geometry of milling cutter or turning tool

System Manual Run MyVirtual Machine

146 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

How to position the cutting edge D1 on the tool geometry

In the following example, an adapter and tool geometry was imported and the cutting edge
length was set. The cutting edge D1 is to be positioned on the tool tip. The procedure is briefly
described using the example of an end mill and can be transferred to other tool types. In the
example, the cutting edge D1 is centered on the end face of the adapter.
1. First, select the reference point for tool positioning. You can choose between the two
variants.

Figure 6-48 Tool and adapter: Tool should be positioned on cutting edge D1

The mounting point of the tool is positioned at the mount station of the adapter.
The reference point of the tool is positioned at cutting edge D1.
2. Click on the button to configure the reference system for aligning the components.
– Variant 1 is selected
For example, move the mounting point of the adapter by the corresponding value in the
z direction. The adapter and tool components are moved together and D1 is positioned
correctly.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 147
3D simulation (option)
6.6 Tools

– Variant 2 is selected.
If a reference point is defined on the cutting edge of the tool geometry (tip of the tool),
you can automatically position the tool correctly using the " on cutting edge D1"
variant.
With a parametric adapter, the tool and adapter are moved together and are positioned.
In the case of an imported adapter geometry, adjust the offset in the adapter's reference
system if necessary.
After positioning, D1 is on the tool tip.

Figure 6-49 Tool positioned on cutting edge D1 using end mill as an example

3. Click on "Save changes" to complete the definition.

System Manual Run MyVirtual Machine

148 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

6.6.15 Accepting a reference point from "*.stp" assembly

If corner points of a Compound or Assembly construction are defined in the "*.stp" file, then
these can be accepted as reference point for tools.
If a reference point is found when importing the file, then this is displayed with a gray circle
symbol and is simultaneously active as toggle button. The reference point can be activated and
accepted using the toggle button. Milling and turning tools can accept the reference point.

Figure 6-50 Reference point is marked in the imported "*.stp" file

Rules for transferring the reference point

• Only one reference point (toggle button) can be activated. If there are several reference
points, only one can be active.
• The combo box in front of the individual element does not have to be activated in order to
accept a reference point. However, at least one individual element must be imported as tool
component in order that the activated reference point is accepted.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 149
3D simulation (option)
6.6 Tools

This is how you accept predefined reference points of an "*.stp" file for import
1. Import the "*.stp" file of an assembly.
Reference points that are found are marked with a gray circle symbol and can be activated.
2. Click on this gray circle symbol (toggle button) next to the individual element whose
reference point you wish to accept.
The circle symbol is shown in blue and the reference point is displayed in the preview image.

Figure 6-51 Accepting a reference point and saving in the tool components using a milling cutter as
example

3. Accept the selection as non-cutting or cutting part and import the tool. The tool and the
marked reference point are accepted.

System Manual Run MyVirtual Machine

150 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

6.6.16 Protection for multitools

Using a multitool you have the possibility of storing more than one tool at a magazine
location. The multitool itself has 2 or more locations to accept tools. The tools are directly
mounted on the multitool. The multitool is located at a location in the magazine.

6ORW

0XOWLWRRO$GDSWHU
6ORWV

7XUQLQJ7RRO 
6KDIW,QVHUW
6ORW

6ORW

7XUQLQJ7RRO 
6KDIW,QVHUW

7XUQLQJ7RRO 
6KDIW,QVHUW

Figure 6-52 Example: Multitool adapter with 3 slots for turning tools

Multitool in the SINUMERIK Operate tool list

In the tool list, a multitool is displayed as an adapter and the tools (slots) it contains are
displayed below it.

Figure 6-53 Multitool with 2 tools in the SINUMERIK Operate tool list

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 151
3D simulation (option)
6.6 Tools

Overview of multitools in the tool manager

The multitool and all tools in the multitool are displayed with a common magazine/location
number. The multitool slots with the tools defined in them are listed below the multitool adapter.

 

① Multitool with the tools contained in it

② Details of the multitool
③ Number of slots in the multitool. In the example, 3 slots.
④ Defining the adapter geometry (protection) for the multitool.
Figure 6-54 Multitool with 2 slots for tools

Defining protection for a multitool

1. Select the multitool in the tool manager.
2. Define a multitool adapter and the positions (Page 153) of the slots in the adapter.
3. Define an adapter (protection) and optionally a tool geometry for each tool in the multitool.

System Manual Run MyVirtual Machine

152 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

6.6.17 Defining multitool adapters and slots

This is how you define the multitool adapter and the slot positions
1. Select the line with the multitool in the tool manager.
2. In the multitool details you have 2 options for defining the adapter geometry.
– Button
Imports an "*.stl/*.stp" file of the adapter geometry
When importing, an adapter geometry (marked with multitool) is created in the library,
which can then also be used as library component.

Figure 6-55 Multitool in the library

Note
The adapter geometry in the library cannot be edited.

– Button
Uses the already defined adapter geometries from the library
The adapter geometry is imported and displayed in the multitool details. The multitool
adapter is applied to the tool mounting point defined in the machine model (or via a defined
adapter transformation).
3. Optionally, enter a name for the multitool adapter and confirm with "Save"
4. After importing the multitool adapter geometry, define the positions of the multitool slots.
This ensures that the adapters of the individual tools under a multitool are located at the
defined multitool slots. The number of multitool locations is obtained from the NC definition
(SINUMERIK Operate tool list). In the example, a multitool with 2 slots was defined in the NC
tool list.
After importing the adapter geometry, define the positions ("Mount Station") of the multitool
adapter slots. To do this, click on the button "Edit slot positions".

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 153
3D simulation (option)
6.6 Tools

5. For the existing slots, enter the values for the "Mount Station".

Figure 6-56 Example with 2 slots: Defining the positions (Mount Stations) of the slots

System Manual Run MyVirtual Machine

154 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

6. Confirm with "Save".

7. Define the protection of the individual multitool tools, e.g. import adapter and tool geometry
via an assembly. After the protection definition, the multitool is displayed with the multitool
adapter and the adapter and tool geometry.

Figure 6-57 Multitool adapter with 2 turning tools

Note
If a tool under a multitool is active on the NC, all tools under the multitool are also active and
can cut.

6.6.18 Tools in the angle head

Angle heads are tool components comprising a stationary part (that does not rotate when the
spindle rotates) and a rotating part. Normally, the axis of rotation of the angle head is not aligned
to the axis of rotation of the spindle. As a result of the angle head, the rotation of the spindle is
"deflected" into another direction e.g. 90° or 45°. This means that the tool cutting edge has an
orientation direction other than the standard orientation.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 155
3D simulation (option)
6.6 Tools

Configuring the angle head

To configure the angle head, in addition to the tool length offset (length 1 to length 3 from
$TC_DP3 to $TC_DP5), the adapter length offset (length 1 to length 3 from $TC_DP21 to
$TC_DP23) is also taken into consideration. The adapter length defines the origin of the
deflected axis of rotation.
The axis to be rotated is derived based on the values of the system variables
for tool orientation $TC_DPV (if possible, based on the value of MD18114
$MN_MM_ENABLE_TOOL_ORIENTATION) or the values of orientation vector $TC_DPV3 to
$TC_DPV5.

MD number Identifier Values Description

MD18114 $MN_MM_ENA‐ 2 or 3 Necessary, if the tool alignment is to be defined using a vector
BLE_TOOL_ORIENTATION via the tool data.
If the vector definition is deactivated, although the HMI always
displays the fields to enter data, these data are not saved and
are not transferred to the 3D simulation.

The tool tip is located at the point of intersection obtained from the tool and adapter offset,
and is aligned corresponding to the tool orientation.
Tool components can be configured so that these belong to the stationary part of the angle
head. The placing for tool components remains unchanged, only the higher-level kinematic
element (either rotates or does not rotate with the spindle) is adapted, based on this setup.

$PSSFDUMZ
BMJHOFE *ODPSSFDUMZ
BMJHOFE

4QJOEMF 4QJOEMF

"EBQUFS
TUBUJPOBSZ "EBQUFS
TUBUJPOBSZ

0꫻TFU

"EBQUFS Tool orientation

Resulting
rotary axis

Tool orientation

0꫻TFU
5PPM

Figure 6-58 Angle head at 45° with specification of the relevant key variables

System Manual Run MyVirtual Machine

156 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.6 Tools

Note
Aligning the tool and axis of rotation
If the tool is not aligned to the axis of rotation, the geometry of the tool together with the cutting
edge is displayed in the 3D simulation; however, it is shown as non-cutting part depicted in dark
grey.

6.6.19 Tool-specific stock removal in different colors

In the tool manager, define a specific cutting edge color for each tool. For stock removal
simulation, in the 3D model, the surface machined by the tool is displayed in the defined cutting
edge color. In stock removal simulation, you can immediately identify which tool is presently
being used for machining or the tool that was used.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 157
3D simulation (option)
6.6 Tools

This is how you define a tool-specific cutting edge color

The cutting edge color of the tool can only be defined if the spindle and feedrate have been
stopped.
1. In the tool manager, for details for the selected tool, click on icon to select the color.
The window to select the color is displayed.
2. Select a color and confirm with "OK".
The tool cutting edge is displayed in the tool manager with the defined color.

Figure 6-59 Example of an end mill: Defining a cutting edge color for a tool

3. Repeat the steps if you want to define additional cutting edge colors for tools.
In the stock removal simulation, the machined surface is displayed in the color of the tool
cutting edge.

System Manual Run MyVirtual Machine

158 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.7 Setup (clamping)

Figure 6-60 Stock removal simulation Machined surfaces are displayed in the colors of the tool
cutting edges, e.g. blue for machining with a "FINISHING_35" tool.

6.7 Setup (clamping)

6.7.1 Setup manager (clampings)

Active setup (clamping)

For the 3D simulation, activate/deactivate the effective setup in the "Setup" tab. The window is
displayed when you click the "Configuration Manager " icon on the 3D simulation start page.

Functions of Setup Manager

You can select the possible setups using the "Fast Protection" or "Detailed Protection" button.
Click on the button in each case to display and parameterize the corresponding setup.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 159
3D simulation (option)
6.7 Setup (clamping)




① Preview of the machine space

② Number of Mount Stations (MS). One MS1 is available as standard.
③ Activate setup as "Fast protection"
④ Activate the setup from the library "Detailed protection"
⑤ Deactivate the setup by clicking on "X"
⑥ Add an additional configuration using the plus character "+".
Figure 6-61 Setup Manager: Example, fast protection has been configured

6.7.2 Fast protection (setup)

With the "fast protection" you define a protection area around a blank geometry. No 3D
geometry required as clamping equipment.

System Manual Run MyVirtual Machine

160 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.7 Setup (clamping)

How to enable "fast protection"

The procedure for activating "Fast Protection" is shown using an example of a milling machine
with one mount station MS1 .
1. Click on the "Fast protection" button. The area is displayed.
2. Click the "Select blank" button. The available blanks from the library are displayed.
3. Select a blank and confirm with "Import". The blank is imported.
4. Enter a "height" for the protection area. The effective protection area size is automatically
scaled on the basis of the protection area stored in the machine model.
5. Click "Activate".
The defined, fast protection is taken over as setup. The blank and the setup are displayed. The
frame of MS1 is shown in green.

Figure 6-62 Active setup with "Fast Protection" The mounting point (red) lies centered at the lower
side of the blank.

6. If the position of the blank is not the required position in the machine space, then you can
adjust the reference points in the library and redefine fast protection. As standard, the
mounting point defined for the blank is placed at the mount station of the machine.
7. You can disable the active protection area by clicking the "X" next to the setup.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 161
3D simulation (option)
6.7 Setup (clamping)

6.7.3 Detailed protection (setup from library)

To define a "detailed protection", activate a setup (clamping) from the library.

System Manual Run MyVirtual Machine

162 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.7 Setup (clamping)

Overview of Setup Manager




   

① 3D preview of the setup for the selected mount station MS1

② Active setup. The "X" deactivates the active setup.
③ List of the components used in the setup. The position of each component can still be changed.
Select the component whose position you wish to change.
④ 3D preview of the selected component (blank, protection area)
⑤ Placement
As standard, the component is placed with the Mounting Point at the Mount Station of the machine. With the place‐
ment, you can position the component in the machine using the reference point of the component and a defined work
offset.
Enter the offset (Z, Y, X) and rotation (rZ, rY, rX) to the Mounting Point of the component. The component is then
mounted based on the new position of the Mounting Point . The new component position is immediately displayed.
⑥ Select reference point
You can align defined reference point R of the component to a defined work offset, e.g. G54. This means that you
change the position of the component.
⑦ Channel
If you align a reference point to a work offset, you must first select the channel in which the work offset is active.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 163
3D simulation (option)
6.7 Setup (clamping)

⑧ Work offset
Here, select the work offset (Gxxx), to which the component reference point should be aligned.
⑨ Click on "Save changes" if the setup should be saved. With "Cancel" the changes are discarded.
Figure 6-63 Setup Manager: Example of a setup from the library

How to enable "Detailed protection"

1. Click on "Detailed protection". The area with the setups from the library is displayed.
2. Double-click the setup from the library that you want to activate. The setup is activated and
can be configured.
3. Optionally, you can change the position of components blank and protection area.
– Changing the position of the mounting point of the component (Page 164)
or
– Align reference point R to a work offset (Page 165)
4. Confirm the setup with "Save changes".
The setup from the library is now active.

Note
An active setup from the library cannot be edited, i.e. reference points cannot be changed. The
setup must be deactivated before it can be edited in the library.

More information
Using several active setups (Page 166)
Using several mount stations (MS) of a machine (Page 168)

6.7.4 Changing the position of the MP (mounting point) in a setup

The position of the mounting point of components (blanks, protection areas) can be changed in
the Setup Manager. For example, this is necessary if the complete clamping is to be shifted on
the machine table, or the position of the blank is to be changed in the clamping equipment.

Requirement
The setup of a "Detailed Protection" is selected in the Setup Manager.

System Manual Run MyVirtual Machine

164 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.7 Setup (clamping)

This is how you change the position of a component mounting point

1. Select the component whose mounting point is to be changed. A blank is used in the
example.
2. Select entry "MP position"
3. Enter the values for the shift and the rotation. In the example, the blank is shifted to
X=-20 mm.

Figure 6-64 Example of blank: Position of the reference point (Mounting Point) shifted to X=-20 mm

6.7.5 Align reference point R to a work offset

Reference point R of a component (blank, protection area) can be assigned to a work offset in the
Setup Manager.

Requirement
• The setup of a "Detailed Protection" is selected in the Setup Manager.
• The component has at least one reference point.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 165
3D simulation (option)
6.7 Setup (clamping)

This is how you connect a reference point with a work offset

1. Select the component whose reference point is to be connected with the work offset. A blank
is used in the example.
2. Select entry "Placement".
3. Select the reference point, e.g. R1.
4. Select the channel in which the work offset is active. For 1-channel machines, the channel is
permanently preassigned with CHAN1.
5. Select the work offset, e.g. G54.

Figure 6-65 Reference point R1 of the blank is connected with work offset G54

6.7.6 Several setups for a mount station

You can define and activate several setups for a mount station in a machine. This is automatically
used for a machine with only one mount station. For several mount stations, first select the
mount station (e.g. MS1 or MS2) that you wish to use.
You can define the setups as "Fast Protection" or "Detailed Protection".

System Manual Run MyVirtual Machine

166 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.7 Setup (clamping)

Requirement
A setup is already activated.

This is how you define several setups

1. Click on "+" next to the active setup.
The area with the setups is displayed.
2. Select setup "Fast Protection" or "Detailed Protection".
3. Define the protection corresponding to the selected setup
– Configuring fast protection
– Configuring detailed protection
The defined setups are displayed.
4. To edit an active setup, click on the corresponding setup. The frame of the active setup is
shown in green.

Figure 6-66 Example, milling machine with one mount station (MS1): Two setups are defined and
activated

5. Repeat the steps if you want to define and activate additional setups.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 167
3D simulation (option)
6.7 Setup (clamping)

6.7.7 Using several mount stations

If the machine has several mount stations (MS), you can define setups for each mount station
and then switch between these. In the 3D simulation, the mount stations are displayed with MS1
to MSx. Mount stations in which setups are defined are shown with a green frame. Mount
stations in which no setup has been defined are shown with a red frame. The active mount
station has a thick frame.

Figure 6-67 Examples of mount stations: MS1 configured and active, MS2 not configured, MS3
configured and not active

System Manual Run MyVirtual Machine

168 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.7 Setup (clamping)

This is how you use several mount stations

1. Click on the mount station that you wish to configure.
The mount station is shown with a thick frame and the area with the setups is displayed.
2. Select setup "Fast Protection" or "Detailed Protection" and define the protection.
You can define several setups for a mount station
3. Save the changes.

Figure 6-68 Example, mount station MS1 is active and configured

The configured and active mount station is marked with a thick, green frame.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 169
3D simulation (option)
6.8 Collisions

6.8 Collisions

6.8.1 Collision detection

During 3D simulation of the machining process, collisions that occur while collision detection is
active are logged and visually displayed in the 3D simulation. The collision components are
marked in color.
• Orange: Safety clearance of the components violated, but no collision yet
• Red: collision of the components

Collision log
In the "Collisions" tab, all collisions that have occurred are displayed in tabular form and with a
3D image and additional information. The collisions are saved at the same time in the
"collision.log" log file.
Storage path for log file:
"C:\Users\<username>\AppData\Local\Siemens\Automation\SINUMERIK
ONE\ncu\card\user\sinumerik\3d\collisions\collision.log"

List of collisions
The following data is listed in the collision list or saved in the log for each collision:
• Collisions type
• Date, time
• Number of components involved
All logged collisions and the saved log can be deleted using the "Delete" button. Single
collisions can be deleted line-by-line in the table.

System Manual Run MyVirtual Machine

170 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.8 Collisions

Figure 6-69 Collision screenshot, components involved are shown in color

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 171
3D simulation (option)
6.8 Collisions

Collision details
Details on the selected collision are displayed in the table in the tabs.

Tab Meaning
3D image of the collision
The 3D image can be zoomed, rotated and moved in order to better
display the details.
From the layer menu, you can specifically hide layers, for example the
machine housing, in order to better analyze the collision situation.

Colliding parts
Which components are involved in the collision, e.g. tool, protection
area, machine component

Channel states
Channel
Select the channel to display the status of that channel during the
collision time. A selection is not possible for single-channel ma‐
chines.
Mode
Operating mode in which the collision occurred, e.g. JOG, AUTO‐
MATIC.
State
State at the time of collision, e.g. ACTIVATED
Program stack and context
Stack level of the program together with the program name and the
line number in which the collision occurred.

System Manual Run MyVirtual Machine

172 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.8 Collisions

6.8.2 Activating collision detection

Before you start the 3D simulation of the machining process, activate collision detection so that
any collisions that occur during machining are displayed and logged. Collision detection cannot
be enabled or disabled during the machining process.

How to activate/deactivate collision detection

1. Click on the red "Deactivated - Click to activate" button in the "Machine" tab in the right-hand
footer of the window.
The button is displayed in green with the caption "Activated". Collision detection is now
active.
2. If you want to disable the collision detection again, click the button again.
The button is shown in red and detection is deactivated again.
Collisions that occur are logged on the "Collisions" tab.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 173
3D simulation (option)
6.9 Simulating machining operations and workflows

6.9 Simulating machining operations and workflows

6.9.1 Measuring processes in the 3D simulation

The 3D simulation simulates and visualizes measuring processes with switching probes. The
measuring process is identical to the procedure on a real machine and has the same
prerequisites.

Figure 6-70 Measuring using the example of a measuring cycle in JOG mode

Note
To record the measured values correctly, only real axes may be used, i.e. the axes must be
assigned to drives, just as on a real machine. Measuring with virtual axes or in simulation mode
does not provide correct results.

Functions
The following functions are supported.
• Measuring the workpiece or clamping
• Use of the workpiece measuring cycles in JOG, MDI and AUTOMATIC
• Support from the first measurement channel
• Contact of the probe with surfaces (e.g. workpiece, clamping) is not evaluated as a collision,
but provides the edge for measured signal acquisition.

System Manual Run MyVirtual Machine

174 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.9 Simulating machining operations and workflows

Restrictions
• No measuring of tools, e.g. with load cells or laser measurement.
• Collisions between the probe (shaft, unclamping) and other collision elements are not
permitted.
• Measurements only with probe-tool types that are listed in Section Probe (Page 119).
• Only HighActive probes are supported (no LowActive).

6.9.2 Automatic mode with 3D simulation

During execution of an NC program in AUTOMATIC mode, 3D simulation with collision detection
enables you to check the processing so that any program errors can be detected.

Requirement
• Requirements for 3D simulation are fulfilled
• The NC program is loaded in AUTOMATIC mode

How to reset the view

Before starting the simulation, reset the view to the "Machine" tab.
1. Click on button "Options" and then "Reset workpiece". The processed workpiece is
reset to the blank view.

How to work with the 3D simulation

1. Check whether all of the requirements have been met.
2. Click CYCLE START in SINUMERIK Operate. The program is processed and machining of the
blank is simulated.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 175
3D simulation (option)
6.9 Simulating machining operations and workflows

Figure 6-71 Example: simulation of machining process

The following functions are provided to assist you during the processing and simulation
• Visualization of the workpiece machining and all machine movements
• Visualization of collisions using colored highlighting
• Logging of the collisions
• Zooming and moving the view to better recognize the details

6.9.3 Saving the configuration in the project

You can save the current machining state of the workpiece and the active setup by pressing
button "Save in-process setup". This may be necessary, for example, to save the current
machining and use it again as a basis for further machining at a later time.
The following components are saved as a copy under an automatically generated name:
• Storage folder:
– STL file of the machined workpiece
• Library:
– Machined workpiece
– Active setup

System Manual Run MyVirtual Machine

176 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.10 Option /3D machine model (CMVM)

Constraints
• Only one setup and one workpiece can be saved.
• Saving is only possible during no-load operation (spindle and feedrate stop).

How to save the machining state

1. Stop the spindle and feedrate.
2. In the "Machine" view, click on button "Options" and then on "Save in-process set up".
The workpiece and the setup are saved. A message signals the successful saving process.
3. Start the spindle and feedrate. Machining is continued.

6.10 Option /3D machine model (CMVM)

6.10.1 Integrating 3D simulation into a project

To use the 3D Simulation functions, various data must be provided in the machine project and
the project appropriately commissioned. The configured machine project can also be used for
Run MyVirtual Machine e.g. to provide customers with a completely configured machine model
to simulate NC programs.
The collision avoidance component is a model-based system. It can only determine
collisions if the model used for collision detection precisely represents reality. The machine
manufacturer must carefully ensure this in order to reduce the risk of any collision. PLC-
controlled actuators, FC18 motions, axis couplings and superimposition corrections are not
taken into account.
Axes that are not included in the machine model may be asynchronously moved. These are
ignored for the collision analysis.

NOTICE
$MA_COLLISION_EXT_AXIS_MASK=0
Please note that $MA_COLLISION_EXT_AXIS_MASK=0 is for axes that are not included in the
machine model.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 177
3D simulation (option)
6.10 Option /3D machine model (CMVM)

Restrictions
Only one 3D machine model can be used in a machine project ("*.vcp"). If there are several 3D
machine models on the virtual memory card in the storage path, then the first 3D machine
model found is always used. Additional 3D machine models are ignored.

Note
Only use one 3D machine model in a machine project.

How you configure a machine project with 3D machine model

1. Create a machine project in Create MyVirtual Machine with a configured and commissioned
machine.
2. Using a suitable software environment, create a 3D machine model with application of the
machine manufacturer for the configured machine.
– Descriptions of kinematics ("*.xml")
– stl geometries (e.g. machine table, magazine, enclosure, axes)

Note
MachineBuilder (ModulWorks) or Create MyVirtual Machine /3D Builder
You create the machine model (kinematics description and geometries) in the Create
MyVirtual Machine /3D Builder or MachineBuilder and export it as "machine container" in the
"*.mkc" format, or use the "*.stl" and "*xml" directly.

3. Export the 3D machine model as "*.mkc" or as "*.stl" and "*.xml".

4. Copy the created 3D machine model to the virtual card of the machine project.
"C:\Users\<username>\AppData\Local\Siemens\Automation\SINUMERIK
ONE\ncu\card\oem\sinumerik\3d\model\".
– "*.mkc"
or
– "*.stl", "*.xml"

System Manual Run MyVirtual Machine

178 System Manual, 01/2024, A5E48105802B AK
 3D simulation (option)
6.10 Option /3D machine model (CMVM)

5. Save the complete machine project.

6. With the machine project started, the "3D Simulation" window is displayed if the
corresponding machine model is integrated and valid.

Figure 6-72 Example of 3D Simulation of a milling machine in MyVirtual Machine

On the basis of the machine model created, you also define setups and tools to be used in
simulating the machining process.

Note
Support for the 3D machine model
For more information, service and support issues for the option /3D, contact the official contact
person (hotline, Service).

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 179
3D simulation (option)
6.10 Option /3D machine model (CMVM)

System Manual Run MyVirtual Machine

180 System Manual, 01/2024, A5E48105802B AK
Open interface (option) 7
7.1 Introduction

Description
The Open Interface of Run MyVirtual Machine allows external applications to control the Run
MyVirtual Machine system and to communicate at runtime. Usually, the Open interface is used
by machine manufacturers or simulation software providers. As a machine operator, you are
provided with a complete solution by the machine manufacturer.
Possible applications of the Open Interfaces are:
• Remotely controlling Run MyVirtual Machine. An external application starts, operates and
exits Run MyVirtual Machine.
• Operating Run MyVirtual Machine in an external simulation product.
• Connecting to an external peripheral simulation.

Note
License
The "Run MyVirtual Machine /Open" license is required to use the Open Interface.

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 181
Open interface (option)
7.1 Introduction

System Manual Run MyVirtual Machine

182 System Manual, 01/2024, A5E48105802B AK
Index

3 C
3D simulation, 80 CNC software
Collision, 170 Version, 61
does not start, 81 Communication settings, 38
Exporting/importing a library, 116 Create/Run My Virtual Machine, 34, 36
inch, 90 Second access point CP1543_2, 40
Key operation, 85 Second access point HMI, 41
Layer, 86 Component /3D
measuring, 174 Naming convention, 95
OpenGL, 82 Component types
Saving the process-internal setup, 176 3D Simulation, 94
Setup, 159 Components
Stock removal simulation color, 157 3D Simulation, 95
Switching between different unit systems, 90 Configuring communication settings, 35, 38
3D Simulation, 71 Create MyVirtual Machine
3D machine model, 177 Licensing, 47
Adapter geometry library, 145
Adapter library, 137
Archive, 88 F
Automatic, 175
Firewall
Basic blank shape, 108
Settings, 42
Creating components, 105
Data storage, 82
File format, 83
Functional scope, 74
L
Importing an adapter geometry, 136 Library
Library, 92 Adapter, 100
Milling tools/drill bits protection, 132 Blank, 101
Parametric protection area, 125, 129 Protection area, 102
Protection milling tool, 121 Tool, 98
Protection turning tool, 134 License, 47
Reference systems, 95 Application, 54
Resetting the view, 175 Command line, 57
Restrictions, 75 Configuring a local license file, 56
STEP assembly, 138 configuring on the license server, 57
Storage folder, 82 Create MyVirtual Machine /3D, 47
Tool manager, 116 Create MyVirtual Machine /Open, 47
Tool types, 120 Create MyVirtual Machine /Operate, 47
Zoom, 175 FlexLM vendor string, 54
Installing the license server, 52
License server, 48, 50
A Local, 48
Local license, 50
Adapting the HMI resolution, 29
Run MyVirtual Machine /3D, 47
Run MyVirtual Machine /Open, 47
Run MyVirtual Machine /Operate, 47
User interface, 54

System Manual Run MyVirtual Machine

System Manual, 01/2024, A5E48105802B AK 183
Index

License info, 46 Run MyVirtual Machine /Operate

License server Overview, 15
Documentation, 49
installing, 51
Uninstalling, 53 S
License tool, 54
Set PG/PC interface, 34, 35, 36, 38
Siemens communication settings, 37, 40
Switch application, 33
M Switching over the language, 30
Machine project, 61
Creating, 63
File size, 67 T
Open, 66
TCP communication, 42
Save, 67
Travel to fixed stop
Machining settings
3D Simulation, 81
Workpiece transfer/cutting off, 87
Memory card
Exchanging NC programs, 69
Memory card, virtual, 68
V
Version information, 46

O
Open Interface., 181
W
Window arrangement
Create, 32
P reset to standard, 32
Standard, 31
POS/POSA, 80
User-defined, 31
Project
Creating, 63
Open, 66
Save, 67
Project management, 20, 61
Project template
Access rights, 68

R
Reference point from "*.stp" file, 149
Run MyVirtual Machine
Components, 16
Demo mode, 17
Project settings, 21
User interface, 24
Run MyVirtual Machine (demo mode)
Overview, 16
Run MyVirtual Machine /3D
Overview, 16
Run MyVirtual Machine /Open
Overview, 16

System Manual Run MyVirtual Machine

184 System Manual, 01/2024, A5E48105802B AK