840D SL ONE CMVM 3d Builder Config Man 0324 en-US
840D SL ONE CMVM 3d Builder Config Man 0324 en-US
840D SL ONE CMVM 3d Builder Config Man 0324 en-US
Fundamental safety
instructions 2
Overview 3
SINUMERIK
System requirements and
installation 4
SINUMERIK ONE
Configuring Create MyVirtual Product description and
Machine /3D Builder features 5
Configuration Manual
Kinematic tree and nodes 6
Axis simulation 7
Collision groups 8
Layers 9
Export/import machine
models 10
Valid for
Create MyVirtual Machine /3D Builder V1.4
03/2024
A5E53138809B AC
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.
1 Introduction ........................................................................................................................................... 5
1.1 About SINUMERIK ................................................................................................................ 5
1.2 About this documentation ................................................................................................... 5
1.2.1 Structure, content, target group, ... ...................................................................................... 5
1.3 Documentation on the internet ............................................................................................ 6
1.3.1 Documentation overview SINUMERIK ONE ........................................................................... 6
1.3.2 Documentation overview SINUMERIK operator components ................................................. 7
1.4 Feedback on the technical documentation ........................................................................... 7
1.5 mySupport documentation .................................................................................................. 7
1.6 Service and Support............................................................................................................. 8
1.7 OpenSSL ............................................................................................................................ 10
1.8 Compliance with the General Data Protection Regulation.................................................... 10
2 Fundamental safety instructions......................................................................................................... 11
2.1 General safety instructions................................................................................................. 11
2.2 Warranty and liability for application examples ................................................................... 11
2.3 Cybersecurity information .................................................................................................. 11
3 Overview.............................................................................................................................................. 13
3.1 Overview ........................................................................................................................... 13
4 System requirements and installation................................................................................................. 15
4.1 System requirements ......................................................................................................... 15
4.2 Prerequisite software ......................................................................................................... 16
4.3 Installing CMVM /3D Builder ............................................................................................... 16
4.4 Uninstalling CMVM /3D Builder........................................................................................... 17
4.5 Check file integrity ............................................................................................................. 18
4.6 Checking the signature of the installed files ........................................................................ 19
5 Product description and features ........................................................................................................ 21
5.1 Managing machine model projects..................................................................................... 21
5.1.1 Project overview ................................................................................................................ 21
5.1.2 Sample machine models .................................................................................................... 23
5.1.3 Create new machine model................................................................................................ 25
5.2 Features and functions....................................................................................................... 27
5.2.1 Layers on preview with toggle button................................................................................. 27
5.2.2 Setting camera angle ......................................................................................................... 30
5.2.3 Smart measure .................................................................................................................. 31
Target group
This document is intended for commissioning engineers and machine tool manufacturers. The
documentation provides a detailed description of of the Create MyVirtual Machine /3D Builder
software.
Benefits
The manual instructs the target group on how to install and uninstall the software correctly. It
helps users to familiarize themselves by creating and simulating a kinematic machine model.
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.
The machine manufacturer must document any additions or modifications they make to the
product themselves.
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
Note
Siemens content that supports the mySupport documentation application can be identified by
the presence of the "Configure" link.
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")
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.
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.
*%-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 OpenSSL
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)
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.
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.
Introduction
Create MyVirtual Machine /3D Builder is a windows application to define, create and simulate a
kinematic machine model in an easy way. This document explains installation, usage and
features served by CMVM /3D Builder.
2
1
3 4 6
Note
In this documentation, "Create MyVirtual Machine /3D Builder" is abbreviated as "CMVM /3D
Builder".
Requirement
You require administrator rights to install Create MyVirtual Machine /3D Builder. Only one
version of Create MyVirtual Machine /3D Builder can be installed on a single computer.
After installation, use a user account without administrator rights when working with Create
MyVirtual Machine /3D Builder, in order to protect the system against security risks and
unauthorized manipulation.
Hardware requirements
• Processor:
At least 4 processor cores
(Intel® Core i5 class or comparable)
• RAM:
4 GB memory (minimum)
• Hard disk (available memory):
6 GB (minimum)
• Graphic card:
Intel HD graphic 4000 (or comparable) with the current graphic driver
• Screen:
Resolution 1680x1050 or higher, 15.6"
• Input devices:
Mouse, keyboard
Preinstalled software
The following software is required to run Create MyVirtual Machine /3D Builder.
• Microsoft Windows Desktop Runtime
• Microsoft Visual C++
Note
Install necessary software
Running the Create MyVirtual Machine/3D Builder setup file will also install this required
software. If there is an older version of this software, it will be updated with Microsoft Windows
Desktop Runtime – 6.0.10 (x64) and Microsoft Visual C++ 2015-2022 Redistributable (x64 and
x86) 14.34.31938.
Description
The Create MyVirtual Machine /3D Builder installation package is located on the installation
medium supplied.
Note
The term "installation medium" is synonymous with DVD, download or other supplied media.
Requirement
The hardware and software of the PC meet the system requirements.
• The hardware and software of the PC meet the system requirements.
• You have administrator rights on your computer.
• All running programs are closed.
• Only one version of Create MyVirtual Machine /3D Builder can be installed on a single
computer.
Note
Uninstall older versions before installing
The installation program cannot update an installed version of CMVM /3D Builder to the new
version. Uninstall older versions of CMVM /3D Builder before installing a new version.
4. You must restart the computer once the installation has been completed.
Create MyVirtual Machine /3D Builder is now installed and ready to use.
Introduction
Software packages are uninstalled automatically by the Setup program. Once started, the Setup
program guides you step-by-step through the entire uninstallation.
9. The computer may need to be restarted. Activate the "Yes, restart computer now" checkbox.
Then click the "Restart" button.
10.If the computer does not need to be restarted, click the "Exit" button.
Uninstalled components
• RegKey Path:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Siemens\Automation\_Inst
alledSW\CreateMyVirtualMachine3DBuilder
• 3D Builder Folder: C:\Users\Z004BPAC\AppData\Local\Siemens\Automation\Create
MyVirtual Machine 3D Builder
• 3D Builder Installer Folder: C:\Program Files (x86)\Common
Files\Siemens\Automation\Siemens Installer Assistant\406
• Installer Log Path: C:\ProgramData\Siemens\Automation\Logfiles\Setup
More information
In the SINUMERIK ONE Industrial Security Configuration Manual, you will find more information
on checking options in the section "Checking software signatures".
Introduction
The machine model projects (*.kin) are managed in the Create MyVirtual Machine /3D Builder
project management. In this view, you create, open, duplicate and delete machine model
projects. The application starts with the project view.
Note
Multiple instances and data loss
Multiple application instances can be used. Do not open same machine model project with
different applications at the same time, in this case a data loss might occur.
3 4 5 6
See also
Create new machine model (Page 25)
Description
Create machine model projects in the project overview.
4. Confirm with "Create new machine model". The machine model opens.
6. Create the nodes for the machine model in the "Kinematic Tree".
Open layers
To see the layers, first click the button in the upper left corner of the "3D Preview". To close the
layer Panel, it is sufficient to press the button on the top left of the "3D Preview" again.
Visibility of layers
User can turn the visibility of the layers in that panel (like picture below) on or off as desired.
Example layer
For example, in the picture below, the visibility of 2 layers has been turned off and only some
geometries remain in the simulation.
Activate/deactivate measuring
This feature can be activated with clicking on the ruler icon on the bottom right of the simulation
and then selecting point, arc or circle on geometries. To exit the measuring mode, you can press
the "Esc" button or click on the ruler again.
Example measuring
• Measuring the depth of geometries
5.2.4 Undo/redo
Changes made can be undone with undo and redo buttons. The buttons look like (picture below)
this when they are active.
Example
For example, after the "Axis_A" node was moved under MC1, the "Undo" button was made
active. After pressing "Undo", the "Axis_A" node goes back under MA1 again.
8QGR
Types of nodes
There are 9 different types of nodes that have different features and attributes in the application
which will be explained in the next section (Page 41). When a node is selected in the tree view,
if it has visual items on the simulation (3D Preview) selected node and all of its children are
highlighted.
Note
General info
All names have to be unique, so when the name is changed, the user will not be allowed if the
same name already exists and the border of the textbox there will be red.
1 2 3 4 5 6 7 8 9
① Translational Axis
② Rotational Axis
③ Turret/magazine
④ Geometry
⑤ Tool Slot
⑥ Mount Station
⑦ Group
⑧ Signal
⑨ Switch
Figure 6-2 Node creation menu
Multi selection
The multi selectiom function can be used on the kinematic tree. Nodes can be deleted, copied,
cut and dragged collectively with multi selection.
Pop-up menu
When clicking the right mouse button within the "Kinematic Tree View" window with one node
selected, a pop-up context-sensitive menu appears providing delete function on the kinematic
tree representing the machine model.
When clicking the right mouse button within the "Kinematic Tree View" window with one
node or multiple node selected, a pop-up context-sensitive menu appears providing cut,
copy, paste and delete functionality on the kinematic tree representing the machine model.
• Copy
Copy node feature can be used to copy only one node. The copy subtree can be used to copy
the selected node along with its children.
• Cut
Cut subtree works like copy subtree but it’s removing selected nodes from kinematics tree.
After cut operation Undo-Redo feature can be used for getting back removed nodes.
• Paste
Paste button will be active if the selected node is available to receive children and paste
functionality can be used between multiple 3D Builder so user can paste copied or cut nodes
to different 3D Builder.
• Delete
Delete subtree feature allows the selected node to be deleted and, if the selected node is a
parent, its children are also deleted.
Triangle count
There is a information bottom of the tree view about the total mesh triangle count. It shows the
number of triangles that all geometries in total have.
Properties panel
When a node is selected in the "Kinematic Tree" or in the 3D Preview, the "Properties" panel will
display the properties for that node.
Material removal simulation precision can be adjusted in the machine model by setting the
attribute "Number of Samples" to the needed sample count.
The default precision used in the simulation is depending on the workpiece dimensions. The
workpiece bounding box diagonal is divided by a sample count of 600 and the result defines
the nail distance of the simulation model.
Coupled axis
It is possible to define a coupled axis in CMVM /3D Builder, where the axis is not defined in NC
but driven with an existing axis in NC.
When "Coupled Axis" checkbox is activated, driving axis and gear ratio parts show up. All axes
other than selected axis, can be selected as driving axis. In /3D application, a "Driving Axis"
will make coupled axis move in proportion to gear ratio.
As an example in the images, in /3D application 100 unit movement in MX1("Driving Axis")
will cause a movement in MY1 100 * gear ratio unit. If an axis is coupled axis, it will
not be shown in axis simulation list in 3D Builder.
Counter spindle
For Protect MyMachine /3D Twin, it is required to set the "Counter-Spindle" to see its spinning
simulation on 3D.
Select the "Main-Spindle" in the combobox, if your axis is a counter spindle axis.
Turret/magazine nodes can be used for CNC machines with turrets. A geometry (STEP, STL or
primitive shapes) can be set. A turret node can be created only under a rotational axis node.
Additionally, turret node only can have tool slots as children's nodes.
Combination of tool unit and magazine values should be valid because newly created tools
under a turret node gets its tool unit and magazine.
Only the tool that resides in this place with its current location (non-home) will be able to cut
and will be rotated potentially by a turret spindle.
Driven Tool
It is possible to have a driven tool (by NC Spindle axis) in the turret. The spindle axis name should
be set with the NC axis name of a spindle axis (e.g. MSC3) on the turret node.
Notes/Restrictions
• This spindle axis must not be present as a "RotationAxisNode".
• When using this attribute, "Active Tool Location" must be used.
• Only one tool (the active tool) can spin at a time.
• Configuring these attributes in a way that multiple tools are active when the linked spindle
spins, leads to undefined behavior.
• Turning tools will not be rotated in any case.
• If multiple ancestors of a tool mount station have this attribute configured, this is undefined
behavior.
After clicking above button parametric tool generation popup is opened with the geometry
of turret node.
Firstly, user should define the orientation of the center point. Center point stands for the line
which will be used to rotate first tool around to create other tools. If it's not defined, default
is origin point and default direction is +Z axis. And user must specify the distance of first tool
location from the center point based on global coordinate system. Finally, user must enter
slot count which stands for number of tool slots that will be created.
With A, B and C values of "First Tool Location" user can change the orientation of the tools in
any direction.
After clicking "Import" button all tool slots and holder transforms are created.
After clicking one of these buttons file browser popup is opened. If the selected file is STL
file, CAD file is directly imported. Otherwise, if the selected file is STEP file, a pop up is
shown. User can select any subcomponents of a STEP file and import it.
If user clicks on "Import STEP File" button under Import menu, file browser window is
opened. User can only select a STEP file and when it is selected, a different pop up shows up.
User can create any number of geometries with different subcomponents of the STEP file and
edit the name of corresponding geometries or delete or highlight them.
After selecting the shape type corresponding shape creation windows are shown. User can
create 4 different types of shapes. Block, cylinder, pipe and N-corner shape.
If user enters X, Y, Z value in the STL Origin, primitive shape is moved in the world coordinate
system. Moreover, if user enters A, B, C value in the STL Origin, shape is rotated around X, Y,
Z axes respectively.
User can import the primitive shape only if necessary, fields are filled validly. After clicking the
"Import as STL" button, basic shape and its corresponding stl file has been created.
Visible and hidden properties can be selected over the combo box and applied easily. In order
to use the relative property, press the icon on the right and enter the name of the node
according to which node is desired to be relative.
NOTICE
In a machine model created in ModuleWorks MachineBuilder, when a transform node
containing 2 or more than 2 geometries is selected as relative and then imported to CMVM /3D
Builder, a random geometry will be selected as relative under the transform node.
If there is stock in the transform node, it will be selected relative to it directly.
⇒This is because only a geometry, stock or tool node can be selected as relative in CMVM /3D
Builder.
Note
The transformation for tools under the rotational axis is not supported because it causes a
positioning problem for the tools. If necessary, the user should use the group node as the parent
of the rotational axis and transform the tool and axis together.
Unit, magazine and slot numbers are important for 3D applications as they will simulate the
tools based on the location information on NC.
Holder transform
It is possible to define a separate mount coordinate system for a Tool Slot. This means the /3D
holder/adapter geometry with their mounting points will be placed based on this coordinate
system.
Holder transformation is a feature for machine which has a turret geometry. Under the tool
properties, there is a property for holder transformation and user can set a transform for
holders rotation.
Note
This feature cannot be used for any tool, there is a restriction that tool has to be under turret node
as a child.
After clicking add holder transform button, UI will look like picture below. Additionally, an
info text is available when user hovers mouse on info icon.
For example when the numbers entered like in below picture, small gnomon will be shown
at view and its rotation will be changed according the inputs of user.
Tool slot and mount station orientation - parallel case Tool slot and mount station orientation - perpendicular case
X is as always away from the center line in the examples. In the parallel case the turret is an
upper turret and X points away from the center line. In perpendicular case, the turret is lower
turret and X points away from the center line.
The following applies when creating the parametric tools for the turret:
• parameter values are expressed in the coordinate system known to the NCK ⇒ MCS
coordinate system
• STEP based elements shall be reusable on different turrets without the need to rotate them
additionally
• for parallel type turrets the mount coordinate system is identical to the slot coordinate system
• if the same adapter is to be used on a perpendicular turret, it is required to additionally set a
holder transform for each tool node
NOTICE
Identical nodes
A collision group cannot be created between 2 identical nodes.
After dragging nodes to right box, button will be enabled. User can change the new collision
group name and drag nodes from left to right to create new collision group with nodes which
belong to right box. If user thinks, s/he made a mistake about dragging one node to right
box, user can removed from right box with button which stand right of the node name. If
everything is okay, then user should click the "Done" button to save collision group.
Now collision group window with new collision group looks like image below.
Editing a group
User can also edit collision groups by clicking two times on list item. User can give a new name
and drag new nodes or remove nodes that already in right box.
After saving the changes, edited collision group is added to list on collision groups window.
NOTICE
A node cannot exist in more than one layer.
If user clicks any item on list view, that layer (nodes in that layer) will be colored on "3D
Preview".
After dragging nodes to right box, button will be enabled. User can change the new layer
name and drag nodes from left to right to create new layer with nodes which belong to right
box. If user thinks, s/he made a mistake about dragging one node to right box, a node can
be removed from right box with button which stand right of the node name. If everything is
okay, then user should click the "Done" button to save layer.
Now layer window looks like added new layer image below.
After saving the changes, new edited layer is added to list on layer window.
Further information
For more information about naming of tool and mount stations and turret structures, see the
"Restrictions (Page 84)" chapter.
Further information
For more information about naming of tool and mount stations and turret structures, see the
"Restrictions (Page 84)" chapter.
10.3 Restrictions
Note
The user does not need to change the tool or stock name in the CMVM /3D Builder user interface
(ex-/import machine model).
Mount station
Each stock has its own unique station integer numbers. This is controlled in the application and
the user is not allowed to create another stock with the same station values.
B P
bounding box, 76 Preinstalled software, 16
C R
Checking the signature, 19 RAM, 15
Collision Group, 71 restrictions, 84
Create MyVirtual Machine /3D Builder, 13 mount station, 84
Creating new collision group, 73 turret, 85
Rotational axis node, 43
E
Editing collision group, 75
S
Export /3D File, 83 Sample machine models, 23
Supported operating systems, 15
System equirement, 15
G
geometry node, 53
future position visualization, 57
T
multiple geometries STEP, 55 Tool slot node, 59
primitive shapes, 56 Translation axis node, 42
single geometriy STEP, 54 Turret/magazine node
Graphic, 15 Active Tool Location on NC, 46
group node, 65 Driven Tool, 46
Parametric tool generation, 48
Turret/magazine nodes, 45
H
Hardware requirements, 15
U
Uninstalling, 17
I
Import /3D File, 83
Installing, 16
K
Kinematic Tree, 38
M
machine definition, 41
machine model projects, 21
mount station node, 64