840D OPCUA en en-US

Basesoftware and operating software ___________________
Preface
Fundamental safety
___________________
instructions 1
SINUMERIK
___________________
SINUMERIK Operate (IM9) 2
SINUMERIK Integrate
___________________
Access MyMachine / OPC UA 3
SINUMERIK 840D sl
Basesoftware and operating SINUMERIK Integrate
___________________
Run MyScreens (BE2) 4
software
___________________
NCU Operating System (IM7) 5
Commissioning Manual
___________________
PCU base software (IM8) 6
___________________
PCU base software (IM10) 7
___________________
Appendix A
Valid for
Control:
SINUMERIK 840D sl/840DE sl
Software:
CNC Software V4.7 SP2
SINUMERIK Operate V4.7 SP2
10/2015
6FC5397-1DP40-5BA3
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.
Siemens AG Order number: 6FC5397-1DP40-5BA3 Copyright © Siemens AG 2006 - 2015.

Division Digital Factory Ⓟ 11/2015 Subject to change All rights reserved
Postfach 48 48
90026 NÜRNBERG
GERMANY
Preface
SINUMERIK documentation
The SINUMERIK documentation is organized in the following categories:
● General documentation
● User documentation
● Manufacturer/service documentation
Additional information
You can find information on the following topics at www.siemens.com/motioncontrol/docu:
● Ordering documentation/overview of documentation
● Additional links to download documents
● Using documentation online (find and search in manuals/information)
Please send any questions about the technical documentation (e.g. suggestions for
improvement, corrections) to the following address:
[email protected]
My Documentation Manager (MDM)

Under the following link you will find information to individually compile OEM-specific
machine documentation based on the Siemens content:
www.siemens.com/mdm
Training
For information about the range of training courses, refer under:
● www.siemens.com/sitrain
SITRAIN - Siemens training for products, systems and solutions in automation technology
● www.siemens.com/sinutrain
SinuTrain - training software for SINUMERIK
FAQs
You can find Frequently Asked Questions in the Service&Support pages under Product
Support. http://support.automation.siemens.com
Basesoftware and operating software

Commissioning Manual, 10/2015, 6FC5397-1DP40-5BA3 3
Preface
SINUMERIK
You can find information on SINUMERIK under the following link:
www.siemens.com/sinumerik
Target group
This documentation is intended for commissioning personnel.
The plant or system is readily assembled and wired. For the
following steps, e.g. configuring the individual components,
the Commissioning Manual contains all necessary information or at least references.
Benefits
The intended target group can use the Commissioning Manual to test and commission the
system or the plant correctly and safely.
Utilization phase: Setup and commissioning phase
Standard scope
This documentation only describes the functionality of the standard version. Additions or
revisions made by the machine manufacturer are documented by the machine manufacturer.
Other functions not described in this documentation might be executable in the control. This
does not, however, represent an obligation to supply such functions with a new control or
when servicing.
For the sake of simplicity, this documentation does not contain all detailed information about
all types of the product and cannot cover every conceivable case of installation, operation, or
maintenance.
Technical Support
You will find telephone numbers for other countries for technical support in the Internet under
http://www.siemens.com/automation/service&support

4 Commissioning Manual, 10/2015, 6FC5397-1DP40-5BA3
Preface
CompactFlash Cards
● Do not remove the memory card while it is being accessed. This can lead to damage of
the memory card and the SINUMERIK as well as the data on the memory card.
● Insert the memory card carefully and the right way round into the memory card slot
(observe indicators such as arrow or similar). This way you avoid mechanical damage to
the memory card or the device.
● Only use memory cards that have been approved by Siemens for use with SINUMERIK.
Even though SINUMERIK follows general industry standards for memory cards, it is
possible that memory cards from some manufacturers will not function perfectly in this
device or are not completely compatible with it (you can obtain information on
compatibility from the memory card manufacturer or supplier).
● For further information on handling CompactFlash cards, please refer to the NCU
manuals.

Preface

Table of contents
Preface ................................................................................................................................................... 3
1 Fundamental safety instructions .............................................................................................................. 9
1.1 General safety instructions ....................................................................................................... 9
1.2 Handling electrostatic sensitive devices (ESD) ......................................................................12
1.3 Industrial security ....................................................................................................................13
1.4 Residual risks of power drive systems....................................................................................13
2 SINUMERIK Operate (IM9) ................................................................................................................... 17
3 SINUMERIK Integrate Access MyMachine / OPC UA .......................................................................... 663
4 SINUMERIK Integrate Run MyScreens (BE2) ..................................................................................... 701
5 NCU Operating System (IM7) .............................................................................................................. 973
6 PCU base software (IM8) .................................................................................................................. 1067
7 PCU base software (IM10) ................................................................................................................ 1205
A Appendix........................................................................................................................................... 1363
A.1 Documentation overview ....................................................................................................1363

Table of contents

Fundamental safety instructions 1
1.1 General safety instructions
DANGER
Danger to life due to live parts and other energy sources
Death or serious injury can result when live parts are touched.
• Only work on electrical devices when you are qualified for this job.
• Always observe the country-specific safety rules.
Generally, six steps apply when establishing safety:
1. Prepare for shutdown and notify all those who will be affected by the procedure.
2. Disconnect the machine from the supply.
– Switch off the machine.
– Wait until the discharge time specified on the warning labels has elapsed.
– Check that it really is in a no-voltage condition, from phase conductor to phase
conductor and phase conductor to protective conductor.
– Check whether the existing auxiliary supply circuits are de-energized.
– Ensure that the motors cannot move.
3. Identify all other dangerous energy sources, e.g. compressed air, hydraulic systems, or
water.
4. Isolate or neutralize all hazardous energy sources by closing switches, grounding or
short-circuiting or closing valves, for example.
5. Secure the energy sources against switching on again.
6. Ensure that the correct machine is completely interlocked.
After you have completed the work, restore the operational readiness in the inverse
sequence.
WARNING
Danger to life through a hazardous voltage when connecting an unsuitable power supply
Touching live components can result in death or severe injury.
• Only use power supplies that provide SELV (Safety Extra Low Voltage) or PELV-
(Protective Extra Low Voltage) output voltages for all connections and terminals of the
electronics modules.

Fundamental safety instructions
WARNING
Danger to life when live parts are touched on damaged devices
Improper handling of devices can cause damage.
For damaged devices, hazardous voltages can be present at the enclosure or at exposed
components; if touched, this can result in death or severe injury.
• Ensure compliance with the limit values specified in the technical data during transport,
storage and operation.
• Do not use any damaged devices.
WARNING
Danger to life through electric shock due to unconnected cable shields
Hazardous touch voltages can occur through capacitive cross-coupling due to unconnected
cable shields.
• As a minimum, connect cable shields and the cores of cables that are not used at one
end at the grounded housing potential.
WARNING
Danger to life due to electric shock when not grounded
For missing or incorrectly implemented protective conductor connection for devices with
protection class I, high voltages can be present at open, exposed parts, which when
touched, can result in death or severe injury.
• Ground the device in compliance with the applicable regulations.
WARNING
Danger to life due to fire spreading if housing is inadequate
Fire and smoke development can cause severe personal injury or material damage.
• Install devices without a protective housing in a metal control cabinet (or protect the
device by another equivalent measure) in such a way that contact with fire is prevented.
• Ensure that smoke can only escape via controlled and monitored paths.

WARNING
Danger to life through unexpected movement of machines when using mobile wireless
devices or mobile phones
Using mobile wireless devices or mobile phones with a transmit power > 1 W closer than
approx. 2 m to the components may cause the devices to malfunction, influence the
functional safety of machines therefore putting people at risk or causing material damage.
• Switch the wireless devices or mobile phones off in the immediate vicinity of the
components.
WARNING
Danger to life due to fire if overheating occurs because of insufficient ventilation clearances
Inadequate ventilation clearances can cause overheating of components with subsequent
fire and smoke. This can cause severe injury or even death. This can also result in
increased downtime and reduced service lives for devices/systems.
• Ensure compliance with the specified minimum clearance as ventilation clearance for
the respective component.
WARNING
Danger to life when safety functions are inactive
Safety functions that are inactive or that have not been adjusted accordingly can cause
operational faults on machines that could lead to serious injury or death.
• Observe the information in the appropriate product documentation before
commissioning.
• Carry out a safety inspection for functions relevant to safety on the entire system,
including all safety-related components.
• Ensure that the safety functions used in your drives and automation tasks are adjusted
and activated through appropriate parameterizing.
• Perform a function test.
• Only put your plant into live operation once you have guaranteed that the functions
relevant to safety are running correctly.
Note
Important safety notices for Safety Integrated functions
If you want to use Safety Integrated functions, you must observe the safety notices in the
Safety Integrated manuals.

1.2 Handling electrostatic sensitive devices (ESD)
WARNING
Danger to life or malfunctions of the machine as a result of incorrect or changed
parameterization
As a result of incorrect or changed parameterization, machines can malfunction, which in
turn can lead to injuries or death.
• Protect the parameterization (parameter assignments) against unauthorized access.
• Respond to possible malfunctions by applying suitable measures (e.g. EMERGENCY
STOP or EMERGENCY OFF).
1.2 Handling electrostatic sensitive devices (ESD)

Electrostatic sensitive devices (ESD) are individual components, integrated circuits, modules
or devices that may be damaged by either electric fields or electrostatic discharge.
NOTICE
Damage through electric fields or electrostatic discharge
Electric fields or electrostatic discharge can cause malfunctions through damaged
individual components, integrated circuits, modules or devices.
• Only pack, store, transport and send electronic components, modules or devices in their
original packaging or in other suitable materials, e.g conductive foam rubber of
aluminum foil.
• Only touch components, modules and devices when you are grounded by one of the
following methods:
– Wearing an ESD wrist strap
– Wearing ESD shoes or ESD grounding straps in ESD areas with conductive flooring
• Only place electronic components, modules or devices on conductive surfaces (table
with ESD surface, conductive ESD foam, ESD packaging, ESD transport container).

1.3 Industrial security
1.3 Industrial security
Note
Industrial security
Siemens provides products and solutions with industrial security functions that support the
secure operation of plants, solutions, machines, equipment and/or networks. They are
important components in a holistic industrial security concept. With this in mind, Siemens’
products and solutions undergo continuous development. Siemens recommends strongly
that you regularly check for product updates.
For the secure operation of Siemens products and solutions, it is necessary to take suitable
preventive action (e.g. cell protection concept) and integrate each component into a holistic,
state-of-the-art industrial security concept. Third-party products that may be in use should
also be considered. For more information about industrial security, visit this address
(http://www.siemens.com/industrialsecurity).
To stay informed about product updates as they occur, sign up for a product-specific
newsletter. For more information, visit this address (http://support.automation.siemens.com).
WARNING
Danger as a result of unsafe operating states resulting from software manipulation
Software manipulation (e.g. by viruses, Trojan horses, malware, worms) can cause unsafe
operating states to develop in your installation which can result in death, severe injuries
and/or material damage.
• Keep the software up to date.
You will find relevant information and newsletters at this address
(http://support.automation.siemens.com).
• Incorporate the automation and drive components into a holistic, state-of-the-art
industrial security concept for the installation or machine.
You will find further information at this address
(http://www.siemens.com/industrialsecurity).
• Make sure that you include all installed products into the holistic industrial security
concept.
1.4 Residual risks of power drive systems
The control and drive components of a drive system are approved for industrial and
commercial use in industrial line supplies. Their use in public line supplies requires a
different configuration and/or additional measures.
These components may only be operated in closed housings or in higher-level control
cabinets with protective covers that are closed, and when all of the protective devices are
used.

These components may only be handled by qualified and trained technical personnel who
are knowledgeable and observe all of the safety instructions on the components and in the
associated technical user documentation.
When assessing the machine's risk in accordance with the respective local regulations (e.g.,
EC Machinery Directive), the machine manufacturer must take into account the following
residual risks emanating from the control and drive components of a drive system:
1. Unintentional movements of driven machine components during commissioning,
operation, maintenance, and repairs caused by, for example,
– Hardware and/or software errors in the sensors, control system, actuators, and cables
and connections
– Response times of the control system and of the drive
– Operation and/or environmental conditions outside the specification
– Condensation/conductive contamination
– Parameterization, programming, cabling, and installation errors
– Use of wireless devices/mobile phones in the immediate vicinity of the control system
– External influences/damage
2. In the event of a fault, exceptionally high temperatures, including an open fire, as well as
emissions of light, noise, particles, gases, etc. can occur inside and outside the inverter,
e.g.:
– Component failure
– Software errors
Inverters of the Open Type/IP20 degree of protection must be installed in a metal control
cabinet (or protected by another equivalent measure) such that contact with fire inside
and outside the inverter is not possible.
3. Hazardous shock voltages caused by, for example,
– Component failure
– Influence during electrostatic charging
– Induction of voltages in moving motors
– Condensation/conductive contamination

4. Electrical, magnetic and electromagnetic fields generated in operation that can pose a
risk to people with a pacemaker, implants or metal replacement joints, etc., if they are too
close
5. Release of environmental pollutants or emissions as a result of improper operation of the
system and/or failure to dispose of components safely and correctly
Note
The components must be protected against conductive contamination (e.g. by installing them
in a control cabinet with degree of protection IP54 according to IEC 60529 or NEMA 12).
Assuming that conductive contamination at the installation site can definitely be excluded, a
lower degree of cabinet protection may be permitted.
For more information about residual risks of the components in a drive system, see the
relevant sections in the technical user documentation.


System overview 1
Principles of start-up 2
General settings 3
SINUMERIK
Licensing 4
SINUMERIK 840D sl
SINUMERIK Operate (IM9) 5
Creating drive connections
Channel menu 6
Machine and setting data 7

Customizing the "Machine"
operating area 8
Simulation and simultaneous
recording 9
Spindle functions 10
Drive system 11
Tool management 12
Configuring alarms 13
Collision avoidance 14
Valid for
Control:
SINUMERIK 840D sl/840DE sl
Data backup 15
Software:
CNC Software V4.7 SP2
SINUMERIK Operate V4.7 SP2 Configuring the network 16
10/2015 Continued on next page

6FC5397-1DP40-5BA3
Postfach 48 48
90026 NÜRNBERG
GERMANY
Continuation
Service and diagnostics 17
OEM-specific online help 18

SINUMERIK Integrate -
AMB, AMC, AMM 19
SINUMERIK 840D sl
SINUMERIK Operate (IM9)
Safety Integrated 20
Configuring cycles 21
Additional language 22
SINUMERIK Operate on PC/
PCU 23
HT 8 24
List of abbreviations/
acronyms A
Legal information
DANGER
WARNING
CAUTION
NOTICE
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
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.
Note the following:
WARNING
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
Trademarks
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.

Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents
1 System overview........................................................................................................................................17
1.1 System overview....................................................................................................................17
1.2 System requirements.............................................................................................................18
2 Principles of start-up...................................................................................................................................19
2.1 Data structure of SINUMERIK Operate..................................................................................19
2.2 Editing files.............................................................................................................................22
2.2.1 Editing the file at the controller...............................................................................................22
2.2.2 Editing a file externally...........................................................................................................24
3 General settings.........................................................................................................................................27
3.1 Changing the language..........................................................................................................27
3.2 Set date/time..........................................................................................................................28
3.3 Using the time server.............................................................................................................30
3.4 Configuring Caps Lock...........................................................................................................31
3.5 Activating/deactivating the virtual keyboard...........................................................................31
3.6 Defining the access rights for the "HMI restart" softkey.........................................................32
3.7 Setting the screensaver.........................................................................................................32
3.8 Inserting a user-specific run up screen..................................................................................33
3.9 Access levels ........................................................................................................................33
3.9.1 Definition of access levels......................................................................................................33
3.9.2 Modifying the access levels password...................................................................................34
3.9.3 Access levels for programs....................................................................................................35
3.9.4 Access rights for files.............................................................................................................37
3.9.5 Access levels for softkeys......................................................................................................38
3.9.6 This is how you define new access levels for softkeys..........................................................39
3.10 Program selection..................................................................................................................41
3.10.1 Displaying the softkey............................................................................................................41
4 Licensing....................................................................................................................................................43
4.1 Determining the license requirement.....................................................................................44
4.2 Activating the test license.......................................................................................................46
4.3 Exporting license requirements..............................................................................................47
4.4 Reading in the license key.....................................................................................................47
4.5 Backing up the license of a new CompactFlash card............................................................48
5 Creating drive connections.........................................................................................................................51
5.1 Setting up drives....................................................................................................................51

Table of contents
5.2 Setting EXTCALL...................................................................................................................52

5.3 Setting the EES......................................................................................................................52
5.4 Creating a global part program memory................................................................................53
6 Channel menu............................................................................................................................................55
6.1 Configuring a channel menu..................................................................................................55
6.2 Constraints.............................................................................................................................56
6.3 General structure of the channel menu..................................................................................56
6.4 Defining channel groups in the "netnames.ini" file.................................................................57
6.5 Configuring operating stations in the "config.ini" file..............................................................59
6.6 Example: Settings for 1:N......................................................................................................59
6.7 Distribution via job lists in the case of 1:N..............................................................................61
7 Machine and setting data...........................................................................................................................65
7.1 Machine and setting data.......................................................................................................65
7.2 Displaying/editing machine data............................................................................................65
7.3 Displaying/editing display machine data................................................................................68
7.4 Displaying/editing setting data...............................................................................................68
7.5 Displaying/editing drive parameters.......................................................................................70
7.6 Machine data display options.................................................................................................72
7.7 Editing machine data and drive parameters ..........................................................................74
7.7.1 Editing hexadecimal values ...................................................................................................74
7.7.2 Editing BICO values...............................................................................................................75
7.7.3 Editing enum values...............................................................................................................75
7.8 Searching for data..................................................................................................................76
7.9 Managing data.......................................................................................................................78
7.10 User views..............................................................................................................................80
7.10.1 Creating a user view..............................................................................................................81
7.10.2 Editing the user view..............................................................................................................82
7.10.3 Deleting a user view...............................................................................................................84
7.11 Plain texts for machine and setting data................................................................................84
8 Customizing the "Machine" operating area................................................................................................87
8.1 Setting the font size of the actual value display.....................................................................87
8.2 Inserting a user-specific logo.................................................................................................87
8.3 Configuring the display of the G-code groups........................................................................88
8.4 Configuring the channel operational message.......................................................................89
8.5 Deactivating program test......................................................................................................93
8.6 Activating the "Teach In" function..........................................................................................93
8.7 Block search...........................................................................................................................95

Table of contents
8.7.1 Activating block search mode................................................................................................95

8.7.2 Accelerated block search for execution from external...........................................................96
8.8 Multi-channel support.............................................................................................................96
8.9 Manual machine.....................................................................................................................98
8.10 User status display (OEM)...................................................................................................100
8.11 Configuring the offset display...............................................................................................103
8.12 Activate machining time recording.......................................................................................103
9 Simulation and simultaneous recording....................................................................................................105
9.1 Simulation overview.............................................................................................................105
9.2 Setting the technology for simulation...................................................................................107
9.3 Simultaneous recording overview........................................................................................109
9.4 Clamping a blank.................................................................................................................110
10 Spindle functions......................................................................................................................................115
10.1 Spindle control.....................................................................................................................115
10.2 Analog spindle......................................................................................................................116
10.3 Leadscrew error compensation............................................................................................117
10.4 Spindle diagnostics..............................................................................................................118
10.4.1 Spindle diagnostics..............................................................................................................118
10.4.2 Temperatures.......................................................................................................................120
10.4.3 Motor temperature sensor....................................................................................................122
10.4.4 Additional temperature sensor.............................................................................................123
10.4.5 Temperature histograms......................................................................................................123
10.4.6 Speed/torque........................................................................................................................124
10.4.7 Clamping system..................................................................................................................124
10.4.8 Clamping system: Speed limits............................................................................................126
10.4.9 Clamping system: Diagnostic statistics................................................................................127
10.4.10 Clamping system: Clamping time statistics..........................................................................128
10.4.11 Fetching the logistics data....................................................................................................128
11 Drive system.............................................................................................................................................131
11.1 Commissioning of drives .....................................................................................................131
12 Tool management.....................................................................................................................................133
12.1 Machine data for tool management......................................................................................133
12.1.1 Settings with/without magazine management......................................................................133
12.1.2 Configuring the access levels of the tool management........................................................134
12.1.3 Additional settings................................................................................................................136
12.2 Configuring the user interface..............................................................................................139
12.2.1 General settings...................................................................................................................142
12.2.2 Configuring tool lists.............................................................................................................147
12.2.2.1 Tool parameter identifiers....................................................................................................151
12.2.2.2 Cutting edge parameter identifiers.......................................................................................153
12.2.2.3 Monitoring parameter identifiers...........................................................................................156
12.2.2.4 Grinding parameter identifiers..............................................................................................157

Table of contents
12.2.2.5 Magazine location parameter identifiers..............................................................................158

12.2.2.6 Magazine location adapter parameter identifiers.................................................................159
12.2.2.7 Multitool parameter identifiers..............................................................................................159
12.2.2.8 Multitool location parameter identifiers.................................................................................160
12.2.3 Configuring list parameters..................................................................................................161
12.2.4 List of tool types...................................................................................................................165
12.2.5 Configure tool types.............................................................................................................167
12.2.6 Configuring the "Additional Data" window............................................................................169
12.2.7 Configure the "New tool - favorites" window........................................................................171
12.2.8 Configuring the "New Tool" window.....................................................................................172
12.2.9 Configuring the "New Multitool" window...............................................................................172
12.2.10 Configuring the "New Tool from Code Carrier" window.......................................................173
12.2.11 Configuring the "New Tool from File" window......................................................................173
12.2.12 Configuring default values for new tools..............................................................................174
12.2.13 Configuring the "Details" window.........................................................................................178
12.2.14 Assigning a name for magazines and magazine locations..................................................178
12.2.15 Configuring the "Assign Tooltips for Multitool Locations" window........................................180
12.2.16 Assigning a name for magazine location types....................................................................181
12.2.17 Assignment of magazines and magazine locations to channels..........................................182
12.2.18 Assignment between magazines and magazine locations and coordinate systems............184
12.2.19 Disabling the softkey depending on filters............................................................................185
12.2.20 Configuring the "Load Station Selection" window................................................................186
12.2.21 Coolant and tool-specific functions......................................................................................187
12.2.22 Reason for the tool change when reactivating.....................................................................190
12.2.23 Configure the code carrier connection.................................................................................194
12.2.24 Configuring Save to file........................................................................................................197
12.3 Creating OEM texts..............................................................................................................198
12.3.1 Identifiers of the standard texts............................................................................................199
12.3.2 Examples of OEM texts........................................................................................................202
12.4 Examples.............................................................................................................................204
12.4.1 Example: Configuring an OEM tool list................................................................................204
12.4.1.1 Adapting the configuration file..............................................................................................204
12.4.1.2 Adaptation of the customer text file......................................................................................206
12.4.2 Example: Configuring magazine location types with names................................................208
12.4.2.1 Adapting the configuration file..............................................................................................208
12.4.2.2 Adaptation of the customer text file......................................................................................209
12.5 Working with two tool holders..............................................................................................212
12.6 Editor for the tool and magazine management....................................................................214
12.6.1 Overview..............................................................................................................................214
12.6.2 Calling the tool management...............................................................................................215
12.6.3 Editing the tool management...............................................................................................216
12.6.4 Parameterizing the tool management..................................................................................218
12.6.4.1 Create tool unit.....................................................................................................................218
12.6.4.2 Define buffer locations.........................................................................................................219
12.6.4.3 Define loading location.........................................................................................................220
12.6.4.4 Create magazine configuration............................................................................................220
12.6.4.5 Link assignments.................................................................................................................222
13 Configuring alarms...................................................................................................................................225
13.1 Creating alarm and message texts via the user interface....................................................225

Table of contents
13.2 Configuring alarm and message texts via alarm text files....................................................227
13.2.1 Creating in-house alarm texts..............................................................................................228
13.2.2 Creating texts for indexed alarm parameters.......................................................................230
13.2.3 Creating part program message texts..................................................................................233
13.2.4 Changing alarm attributes....................................................................................................236
13.2.5 Replacing standard alarm texts............................................................................................240
13.2.6 Range of alarms...................................................................................................................244
13.2.7 Parameter specifications in alarm texts...............................................................................245
13.2.8 Opening error file.................................................................................................................246
13.3 Configuring an alarm log......................................................................................................247
13.3.1 Setting alarm logs from the user interface...........................................................................248
13.3.2 Loading alarm log via configuration file................................................................................248
13.4 PLC alarms with parameters ...............................................................................................252
13.4.1 Definition of a parameter of the octet string data type.........................................................252
13.4.2 Definition of the language-dependent formatting.................................................................255
13.5 Deactivating a warning.........................................................................................................256
14 Collision avoidance...................................................................................................................................259
14.1 Overview..............................................................................................................................259
14.2 General sequence................................................................................................................260
14.3 Set collision avoidance.........................................................................................................261
14.4 Graphic machine model editor.............................................................................................262
14.5 Editing the machine model...................................................................................................263
14.6 Changing and adapting the machine model view................................................................265
14.6.1 Enlarging or reducing the machine graphic..........................................................................265
14.6.2 Changing the section of the machine graphic......................................................................265
14.6.3 Rotating and shifting the machine graphics.........................................................................266
14.6.4 Various machine model views..............................................................................................267
14.6.5 Displaying protection area elements for collision avoidance................................................268
14.7 Creating a kinematic structure.............................................................................................269
14.7.1 Kinematic elements..............................................................................................................269
14.7.1.1 Creating a kinematic chain element.....................................................................................269
14.7.1.2 Kinematic rotation and parallel kinematic rotation................................................................270
14.7.1.3 Linear axis and parallel linear axis.......................................................................................271
14.7.1.4 Rotary axis and parallel rotary axis......................................................................................272
14.7.1.5 Offset and parallel offset......................................................................................................272
14.7.1.6 Switch and parallel switch....................................................................................................273
14.7.2 Protection areas...................................................................................................................273
14.7.2.1 Creating protection areas.....................................................................................................273
14.7.2.2 Tool protection area ............................................................................................................274
14.7.2.3 Machine protection area.......................................................................................................275
14.7.3 Protection area elements.....................................................................................................276
14.7.3.1 Creating protection area elements.......................................................................................276
14.7.3.2 Frame and parallel frame protection area element..............................................................278
14.7.3.3 Box and parallel box protection area elements....................................................................279
14.7.3.4 Sphere and parallel sphere protection area elements.........................................................281
14.7.3.5 Cylinder and parallel cylinder protection area element........................................................282

Table of contents
14.7.3.6 File and parallel 3D file protection area element..................................................................284

14.7.4 Collision pair.........................................................................................................................286
14.7.4.1 Creating a collision pair........................................................................................................286
14.7.4.2 Collision pair.........................................................................................................................287
14.7.5 Supplementary condition......................................................................................................288
14.8 Collision avoidance example................................................................................................288
14.8.1 Fundamentals......................................................................................................................288
14.8.2 Create machine model example..........................................................................................291
14.8.2.1 Creating kinematic elements................................................................................................291
14.8.2.2 Creating machine protection areas......................................................................................293
14.8.2.3 Creating a tool protection area.............................................................................................296
14.8.2.4 Creating collision pairs.........................................................................................................297
15 Data backup.............................................................................................................................................299
15.1 Creating a start-up archive...................................................................................................300
15.2 Reading-in a start-up archive...............................................................................................302
15.3 Backing up the hardware configuration................................................................................303
15.4 Creating an archive with original data..................................................................................304
15.5 Reading in an archive with original data..............................................................................306
15.6 Generating the complete archive.........................................................................................307
15.7 Serial interface (V24 / RS232).............................................................................................307
15.7.1 Reading-in and reading-out archives via a serial interface..................................................307
15.7.2 Setting interface parameters................................................................................................309
15.8 Backing up setup data..........................................................................................................311
15.9 Network settings...................................................................................................................311
16 Configuring the network............................................................................................................................315
16.1 Displaying the network overview..........................................................................................315
16.2 Settings of the system network............................................................................................316
16.3 Settings of the factory network.............................................................................................319
16.4 Saving network settings.......................................................................................................321
16.5 Configuring operator panels.................................................................................................322
16.5.1 Displaying the available operator panels.............................................................................322
16.5.2 Configuring VNC connections..............................................................................................323
16.5.3 T:M:N configuration..............................................................................................................324
16.6 Station-related network diagnostics.....................................................................................325
16.6.1 Displaying network adapters................................................................................................326
16.6.2 Error analysis.......................................................................................................................327
16.6.2.1 Performing error diagnostics................................................................................................327
16.6.2.2 MCP/EKS as network participant cannot be accessed........................................................328
16.6.2.3 HMI on the PCU cannot establish a network connection to the NC ....................................329
16.6.2.4 TCU cannot establish a network connection to the HMI......................................................333
16.6.2.5 The TCU cannot establish a network connection to the assigned PCU...............................335
16.6.3 Configuring TCP/IP diagnostics...........................................................................................336
16.6.4 Ethernet network diagnostics...............................................................................................340

Table of contents
16.6.4.1 Diagnostics of the network and DHCP server......................................................................340

16.6.4.2 Messages.............................................................................................................................341
16.6.4.3 Network trace.......................................................................................................................341
16.6.4.4 Accessible nodes.................................................................................................................345
17 Service and diagnostics............................................................................................................................349
17.1 NC/PLC variables.................................................................................................................349
17.1.1 Displaying and editing PLC and NC variables.....................................................................349
17.1.2 Saving and loading screen forms.........................................................................................352
17.2 Displaying the Service overview..........................................................................................353
17.2.1 Selecting axes and drives....................................................................................................354
17.2.2 Axis diagnostics...................................................................................................................356
17.2.3 Service drive........................................................................................................................361
17.3 System utilization.................................................................................................................368
17.4 Creating screenshots...........................................................................................................369
17.5 Machine identity...................................................................................................................370
17.5.1 Entering machine-specific information.................................................................................371
17.5.2 Creating a selection file........................................................................................................372
17.5.3 Reading in a selection file....................................................................................................374
17.5.4 Save information..................................................................................................................376
17.5.5 Adding hardware components.............................................................................................377
17.5.6 Configuration data................................................................................................................379
17.6 Logbook...............................................................................................................................379
17.6.1 1. Documenting startup........................................................................................................380
17.6.2 2. Defining start-up...............................................................................................................380
17.6.3 Making a logbook entry........................................................................................................381
17.7 Action log.............................................................................................................................382
17.7.1 Setting the action log............................................................................................................382
17.7.2 Displaying the log file...........................................................................................................384
17.7.3 Searching in the log files......................................................................................................385
17.7.4 Storing a log.........................................................................................................................385
17.7.5 Structure of a log file............................................................................................................386
17.7.6 Advanced settings................................................................................................................388
17.8 HMI trace..............................................................................................................................389
17.9 PROFIBUS diagnosis...........................................................................................................390
17.9.1 Displaying details for DP slaves...........................................................................................392
17.10 Drive system........................................................................................................................393
17.10.1 Displaying drive states.........................................................................................................393
17.10.2 Displaying details of the drive objects..................................................................................394
17.11 Remote diagnostics..............................................................................................................396
17.11.1 Adapting remote diagnostics................................................................................................396
17.11.2 Remote diagnostics via Teleservice adapter IE at X127......................................................397
17.11.3 PLC control for remote access.............................................................................................400
17.12 Trace....................................................................................................................................401
17.12.1 General procedure...............................................................................................................402
17.12.2 Trace session.......................................................................................................................403
17.12.2.1 Creating a session file..........................................................................................................403

Table of contents
17.12.2.2 Saving the trace file..............................................................................................................403

17.12.2.3 Load trace session file.........................................................................................................404
17.12.3 Variable for trace..................................................................................................................405
17.12.3.1 Variables filter/search...........................................................................................................405
17.12.3.2 Selecting attributes of a variable..........................................................................................407
17.12.3.3 Displaying details of a variable.............................................................................................410
17.12.4 Trace settings.......................................................................................................................411
17.12.4.1 Trace settings (PLC, NC, servo)..........................................................................................411
17.12.4.2 Trace settings (drive)...........................................................................................................411
17.12.4.3 Trace options.......................................................................................................................413
17.12.4.4 Starting the trace..................................................................................................................413
17.12.5 Evaluate a trace...................................................................................................................414
17.12.5.1 Setting trace views...............................................................................................................414
17.12.5.2 Selecting a variable..............................................................................................................415
17.12.5.3 Scaling the display...............................................................................................................416
17.12.5.4 Zooming the display.............................................................................................................417
17.12.5.5 Position the cursor...............................................................................................................418
17.12.5.6 Acquiring measured values..................................................................................................419
17.13 PROFIBUS/PROFINET and AS-i bus diagnostics...............................................................420
17.13.1 PROFIBUS/PROFINET........................................................................................................420
17.13.2 Displaying PROFIBUS/PROFINET diagnostics...................................................................420
17.13.3 Configuring the AS-i bus......................................................................................................422
17.13.4 Displaying AS-i bus diagnostics...........................................................................................424
18 OEM-specific online help..........................................................................................................................427
18.1 Overview..............................................................................................................................427
18.2 Generating HTML files.........................................................................................................428
18.3 Generating the help book.....................................................................................................431
18.4 Integrating the online help in SINUMERIK Operate.............................................................433
18.5 Saving help files...................................................................................................................435
18.6 Generating online help for user alarms and machine data..................................................435
18.7 Example: This is how you create an online help for NC/PLC variables...............................438
18.8 Example: This is how you create a programming online help..............................................441
18.9 Help files in PDF format.......................................................................................................443
19 SINUMERIK Integrate - AMB, AMC, AMM...............................................................................................445
20 Safety Integrated......................................................................................................................................447
20.1 Displaying machine data and parameters............................................................................447
20.1.1 View of the axes...................................................................................................................447
20.1.2 General machine data for Safety Integrated........................................................................448
20.1.3 Axis-specific machine data in Safety Integrated..................................................................449
20.1.4 Drive machine data in Safety Integrated..............................................................................450
20.1.5 Copying and confirming Safety Integrated data...................................................................451
20.1.6 Activating/deactivating start-up mode..................................................................................452
20.1.7 Displaying the Safety-Integrated settings.............................................................................453
20.2 Safety Integrated diagnostics...............................................................................................454
20.2.1 Status display for NCK Safety Integrated.............................................................................454

Table of contents
20.2.2 Display SGE/SGA signals....................................................................................................455

20.2.3 Display SPL signals.............................................................................................................456
20.2.4 Displaying Safety Integrated checksums.............................................................................457
20.2.5 Safety Integrated Basic Functions (Drive)............................................................................458
20.2.6 Safety Integrated fail-safe I/O..............................................................................................459
20.2.7 Displaying cam signals.........................................................................................................460
20.2.8 Displaying SI communication data.......................................................................................461
20.2.9 SI communication send connections....................................................................................461
20.2.10 SI communication receive connections................................................................................463
21 Configuring cycles....................................................................................................................................465
21.1 Activating turning/milling/drilling/grinding technologies........................................................465
21.2 Technology cycles for drilling...............................................................................................470
21.3 Manufacturer cycles.............................................................................................................472
21.3.1 Manufacturer cycles.............................................................................................................472
21.3.2 Prerequisites for the simulation mode..................................................................................474
21.3.3 Extending the PROG_EVENT standard cycle......................................................................474
21.3.4 Manufacturer cycle for tool change CUST_T and CUST_M6...............................................475
21.3.5 CUST_TECHCYC.SPF manufacturer cycle.........................................................................476
21.3.6 CUST_MULTICHAN user cycle...........................................................................................479
21.4 Milling...................................................................................................................................479
21.4.1 General................................................................................................................................479
21.4.2 Technology cycles for milling...............................................................................................480
21.4.3 Setting-up ShopMill cycles for milling...................................................................................481
21.4.4 Cylinder surface transformation (TRACYL)..........................................................................483
21.4.5 Example: Milling machine with the XYZ-AC axis configuration............................................484
21.4.6 ShopMill cycles for multiple clamping..................................................................................488
21.5 Turning.................................................................................................................................490
21.5.1 General................................................................................................................................490
21.5.2 Setting up cycles for turning.................................................................................................490
21.5.3 Setting-up ShopTurn cycles for turning................................................................................494
21.5.4 Setting up a counterspindle..................................................................................................496
21.5.5 Setting up the counterspindle under ShopTurn....................................................................498
21.5.6 Technology cycles for turning..............................................................................................500
21.5.7 Axis configuration of a lathe.................................................................................................504
21.5.8 Cylinder surface transformation (TRACYL)..........................................................................505
21.5.9 End face machining (TRANSMIT)........................................................................................508
21.5.10 Inclined Y axis (TRAANG)....................................................................................................511
21.5.11 Spindle speed limitation for current program.......................................................................514
21.6 grinding................................................................................................................................515
21.7 Swiveling..............................................................................................................................517
21.7.1 Technology cycles for swiveling...........................................................................................517
21.7.2 CYCLE800 checklist for the identification of the machine kinematics..................................526
21.7.3 Commissioning swivel data (kinematics chain)....................................................................526
21.7.4 Examples of machine kinematics for the commissioning of the Swivel function..................537
21.7.5 Manufacturer cycle CUST_800.SPF....................................................................................548
21.7.6 CYCLE996 measure workpiece kinematics.........................................................................554
21.8 Turning on milling machines................................................................................................556
21.8.1 Setting up machine data and setting data............................................................................556

Table of contents
21.8.2 Setting up a kinematics transformation................................................................................561

21.8.3 Behavior at reset and power on...........................................................................................563
21.8.4 Setting the tool clamping angle............................................................................................563
21.8.5 Setting up the Hirth joint.......................................................................................................564
21.8.6 Different coordinate systems for milling and turning............................................................565
21.8.7 Adaptations for CUST_800..................................................................................................566
21.8.8 Rotary axis positioning during block search.........................................................................569
21.9 High-speed machining.........................................................................................................569
21.9.1 High speed settings: Configuring CYCLE832......................................................................569
21.9.2 Manufacturer cycle CUST_832.SPF....................................................................................572
21.9.3 Top Surface: CYCLE832 extension.....................................................................................573
21.10 Measuring cycles and measurement functions....................................................................575
21.10.1 Measuring cycles and measurement functions, general......................................................575
21.10.2 Manufacturer and user cycle CUST_MEACYC.SPF............................................................578
21.10.3 Measuring in JOG mode......................................................................................................580
21.10.3.1 Measuring workpieces at the milling machines....................................................................582
21.10.3.2 Measuring tools at the milling machines..............................................................................584
21.10.3.3 Measuring tools at the turning machines.............................................................................589
21.10.3.4 Measuring without electronic probe in JOG.........................................................................590
21.10.4 Measuring in the AUTOMATIC mode..................................................................................590
21.10.4.1 Measuring workpieces, general ..........................................................................................592
21.10.4.2 Measuring workpieces at the milling machines....................................................................595
21.10.4.3 Measuring tools at the milling machines..............................................................................596
21.10.4.4 Measuring workpieces at the turning machines...................................................................602
21.10.4.5 Measuring tools at the turning machines.............................................................................603
21.10.5 Logging................................................................................................................................604
21.10.5.1 Logging the measuring, general...........................................................................................604
21.10.5.2 Logging while measuring in the JOG mode.........................................................................605
21.10.5.3 Logging while measuring in the AUTOMATIC mode...........................................................605
21.10.5.4 Manufacturer and user cycle CUST_MEAPROT.SPF.........................................................606
21.11 Compare cycles version.......................................................................................................607
21.11.1 Display cycles version..........................................................................................................607
21.11.2 Specify cycles version..........................................................................................................609
22 Additional language..................................................................................................................................611
22.1 Installing additional languages.............................................................................................611
22.2 Uninstalling languages.........................................................................................................612
22.3 Supported languages...........................................................................................................612
23 SINUMERIK Operate on PC/PCU............................................................................................................615
23.1 Link OEMFrame application.................................................................................................615
23.2 Using interactive or silent installation versions.....................................................................619
23.3 Setting the IP address of the NCU.......................................................................................621
23.4 SINUMERIK Operate exiting................................................................................................622
24 HT 8..........................................................................................................................................................623
24.1 Configuring the traversing keys............................................................................................623
24.2 Configuring user-specific key labeling..................................................................................627

Table of contents
24.3 Configuring the function display at user-specific keys (U keys)...........................................630

A List of abbreviations/acronyms.................................................................................................................633
Index.........................................................................................................................................................637

Table of contents

System overview 1
1.1 System overview
NCU
The SINUMERIK Operate V4.x operating software is an integral component of the CNC
software V4.x and can therefore run on an NCU 7x0.3. The NCU's CompactFlash card is the
standard data carrier of the CNC software.
The SINUMERIK Operate operating software is started automatically when the NCU software
boots and in the delivery state offers its standard functional scope, which depends on the actual
NC and PLC configuration.
PCU
The SINUMERIK Operate operating software is supplied on DVD and must then be installed
on the hard disk of the PCU. The operating software is automatically started when the controller
boots.
PC
The SINUMERIK Operate operating software is supplied on DVD and can be installed in a
freely selectable directory.
The following sections describe the expansions and adaptations that the machine
manufacturer can make using the SINUMERIK Operate operating software.
References
For a description of the commissioning procedure for the SINUMERIK 840D sl controller,
please refer to the following documentation:
CNC Commissioning Manual: NCK, PLC, Drive

System overview
1.2 System requirements
1.2 System requirements
Overview
It is a requirement that all system components be fully mounted, installed and configured.
Commissioning of the NC and PLC must have been completed. The PLC is in the "Run"
condition.
● USB keyboard: Handles text input with upper- and lower-case letters.
● Storage medium, e.g. USB FlashDrive and/or network connection: Handles data exchange
with an external PC/PG.
Note
When you load user data with a USB FlashDrive, the data size must not be larger than 4
GB!
SINUMERIK Operate under Windows

You require the following software if you use SINUMERIK Operate under Windows:
● PCU 50.5: WinXP PCU basic software as of V1.2
● PC: Windows XP SP3 / Windows 7 operating system
Additional programs
● TextPad text editor: Used for the external creation and editing of XML and INI files in
Windows. The program is available on the Internet at: http://www.textpad.com/
● WinSCP: Enables protected data transfer between different computers (NCU - PC). The
program is available on the Internet at: http://winscp.net/eng/index.php
● RCS Commander: Permits the remote maintenance for machines with the SINUMERIK
Operate operating software from a standard Windows PC.
● As of V4.5, the RCS Commander provides a special conversion function to transfer alarm
texts of HMI Advanced or HMI Embedded to SINUMERIK Operate.
● System Network Center (SNC): Sets up the Ethernet connection of one or more TCUs to
NCU/PCU.
References
A detailed description of the structure and commissioning of the system network with controller
and operator components is provided in the following description:
SINUMERIK 840D sl/840Di sl Operator Components and Networking

Principles of start-up 2
2.1 Data structure of SINUMERIK Operate
For SINUMERIK Operate, all files are saved on the CompactFlash card (NCU) or on the hard
disk (PCU) or DVD (PC).
The file system is at the uppermost level:
● On the NCU in the "/System CF-Card/" directory
● On the PCU in the "F:\hmisl\" directory
● On the PC, the drive can be freely selected, e.g. "C:\Programs\siemens\sinumerik
The directory structure comprises the following directories:
● addon
● compat (only PC/PCU)
● oem
● siemens
● user
These directories have essentially an identical structure.
Note
The files in the “siemens” directory represent the original status and cannot be modified!
Files, whose contents can be supplemented or modified, are available as templates (specimen
files) in the following directories:
Files Directory
Configuration files /siemens/sinumerik/hmi/template/cfg
Text files /siemens/sinumerik/hmi/template/lng
Before making any changes/supplements, these files should be copied into the /cfg or /lng in /
oem/sinumerik/hmi/, /addon/sinumerik/hmi/ or /user/sinumerik/hmi/ directories.
Structure
The section of the directory structure relevant for SINUMERIK Operate is shown below:
siemens directory
/siemens/sinumerik
/hmi
/appl // applications (operating areas)
/base // basis system components

Principles of start-up
siemens directory
/cfg // all configuration files
/data // version data
/hlp // online help files
/hlps // online help files, zipped and version files
/ico // symbol files
/Ico640 // icons in resolution 640x480
/ico800 // icons in resolution 800x600
/lng // text files
/lngs // text files zipped and versions files
/osal
/ace // ACE/TAO
/qt // Qt
/proj // EasyScreen configuring
/template // various templates
/cfg // templates for configuration files
/ing // templates for text files
/tmpp // storage, temporary data
/sys_cache/hmi // various log files
compat directory
/compat // files for integrating the OEMFrame applications
/add_on
/hmi_adv
/mmc2
/oem
/user
addon directory
/addon/sinumerik
/hmi
/cfg // configuration files
/hlp // online help files, zipped and version files

addon directory
/lng // text files
oem directory
/oem/sinumerik
/archive // manufacturer archive
/hmi
/hlps // online help files, zipped and version files
/lng // text files
user directory
/user/sinumerik
/archive // user-specific archive
/prog // user-specific programs
/hmi

2.2 Editing files
user directory
/lng // text files
/log // log files
/md // machine data views
2.2 Editing files
2.2.1 Editing the file at the controller

Use can use a copy of the sample file in order to make specific adjustments. Template files
are available in the following directories:
/siemens/sinumerik/hmi/template/cfg and /siemens/sinumerik/hmi/template/lng
Save the sample file in the "user" or "oem" directory - in the appropriate folder.
Note
As soon as the file is in the user-specific directory, the entries of this file have priority over the
Siemens file. If an entry is missing in a user-specific file, the corresponding entry from the
Siemens file is used instead.
You need to restart the operating software for the settings made in the file to take effect.
Precondition
● If you copy files, you require access level 1 (manufacturer).
● When assigning a new file name, ensure that only files with a maximum name length of 49
characters can be managed.
Copying / pasting / opening a file
1. Select the "Start-up" operating area.
2. Press the "System data" softkey.

The data tree is displayed.
3. For instance, on the NCU directory, "System CF card", under "siemens"
open the required directory (e.g. /sinumerik/hmi/template/cfg).

2.2 Editing files
4. Position the cursor on the desired file.

5. Press the "Copy" softkey.
6. For instance, on the NCU in the "System CF card" directory, under "oem"
or "user" open the required directory (e.g. /sinumerik/hmi/cfg), in which
the copied file should be saved.
7. Press the "Paste" softkey.
If a file of the same name already exists, you receive a message. You can
overwrite or rename the file.
8. Press the "OK" softkey.
9. You can open the selected file in the editor by pressing the "Open" softkey.
- OR -
Press the <INPUT> key.
- OR -
Double-click the highlighted file.
Rename file
1. Select the required file.

2. Press the ">>" and "Properties" softkeys.
The "Properties of..." window opens.
The following data is displayed:
● Path:
● Name:
● Creation date and time:
● Date of change and time:
3. To change the file name, place the cursor in the "Name" entry field and
overwrite the name. Date of change and time are simultaneously updated.
4. Press the "OK" softkey to save the new name.
Cut-out/delete file

2. Press the "Cut" softkey.
The file is copied into the buffer and at the same time deleted from the
previous directory.
As the file is located in the buffer, you can also insert the file into another
directory.

2.2 Editing files
- OR -
2. Press the ">>" and "Delete" softkeys.
You receive an alarm and you can delete the file by pressing the "OK"
softkey.
Press the "Cancel" softkey to cancel the delete operation.
Displaying the file in the preview window

2. Press the ">>" and "Preview window" softkeys.
The preview window is displayed in the lower area of the window together
with the file contents.
Press the "Preview window" softkey again to close the window.
2.2.2 Editing a file externally

To create or edit an XML file on an external PC with Windows, use a text editor that supports
the required "UTF-8" coding, e.g. "TextPad".
This means that you can enter or directly insert all characters of the unicode system without
rewriting them using the keyboard.
If files with a different coding are saved, the special characters are not correctly displayed in
the editor. In SINUMERIK Operate, there is no automatic conversion into the UTF-8 coding!!
Saving the XML file in UTF-8 coding

1. Select the "Save As" dialog box.
2. Set the character set to "UTF-8".
Entering comments in an XML file

If you are entering comments to explain a program, you must keep the following in mind:
● A comment always begins with the sequence: 

2.2 Editing files
Example

Note
In the comment itself, you can never use two minus signs one right after the other!
Special characters
If you use characters in the text where the syntax of XML is of significance, then these must
specifically formatted:
Special characters Notation

& &
' '
< <
> >
" "
Comments in an ini file

If you enter a comment in an ini file, start the comment line with a semicolon.
Copy file
Using the "WinSCP" or "RCS Commander" program, copy the file from an external computer
to the NCU via a network connection – or in the opposite direction from the NCU to an external
PC.
For a detailed description, see the following sub-book:
References
NCU Operating System (IM7): Backing up and restoring data and WinSCP and PuTTY service
tools
See also
Configuring alarm and message texts via alarm text files (Page 227)

2.2 Editing files

General settings 3
3.1 Changing the language
The operating software is available as standard in several languages.
Selecting a language
You can define the language selection mode using the following machine data.
MD9100 $MM_CHANGE_LANGUAGE_MODE Language selection mode

=1 The user-interface language is specified via the "Language Selection" window (default val‐
ue).
2. Press the "Change language" softkey.

The "Language Selection" window opens. The language most recently
set is highlighted.
3. Switch the cursor to the required language.
4. Press the <INPUT> key.
- OR -
Press the "OK" softkey.
The operating software switches to the language selected.
Defining two languages
MD9100 $MM_CHANGE_LANGUAGE_MODE Language selection mode

=2 Selection of two languages. During operation, the "Change language" softkey can be used
to toggle between these languages.
2. Press the "HMI" softkey.
3. Press the ">>" softkey.

General settings
3.2 Set date/time
4. Press the "Language selection" softkey.

The "Language Selection" window opens.
All the installed languages are displayed in the fields "First language" and
"Second language".
5. Select a language in each of these.
- OR -
During operation, you can switch between the two languages by pressing
the "Change language" softkey.
3.2 Set date/time

You have the possibility of manually setting the date and time for the NCU (PLC and Linux) or
PCU/PC (Windows). In so doing, you can select from various display formats.
Formats of the date display
Format Example
d.M.yy 3.1.09
dd.MM.yy 03.01.09
dd.MM.yyyy 03.01.2009
d/M/yy 3/01/09
dd/MM/yy 03/01/09
dd/MM/yyyy 03/01/2009
M/d/yy 1/3/09
MM/dd/yy 01/03/09
MM/dd/yyyy 01/03/2009
yyyy/MM/dd 2009/01/03
The following applies:
Date Description of the entry

d Single or double digit day of the month (1 - 31).
dd Double digit day of the month, with leading zero (01 - 31).
M Single or double digit month of the year (1 - 12).
MM Double digit month of the year, with leading zero (01 - 12).
yy Double digit year (00 - 99).
yyyy Four-digit year (e.g. 2009).

General settings
3.2 Set date/time
Time display formats
Format Example Hour system

H:m:s AP 1:2:4 PM 24 hour system, with display of "AM" / "PM"
h:m:s ap 1:2:8 pm 12 hour system, with display of "am" / "pm"
HH:mm:ss AP 13:02:08 PM 24 hour system, with display of "AM" / "PM"
hh:mm:ss ap 01:02:09 pm 12 hour system, with display of "am" / "pm"
H:mm:ss AP 1:02:09 PM 24 hour system, with display of "AM" / "PM"
h:mm:ss ap 1:02:09 pm 12 hour system, with display of "am" / "pm"
h:mm:ss 13:02:09 24 hour system
hh:mm:ss 13:12:04 24 hour system
The following applies:
Time symbol: Description of the entry

h Single or double digit hour (0 - 23 or 1 - 12 for am/pm).
hh Double digit hour, with leading zero (00 - 23 or 01 - 12 for am/pm).
H Single or double digit hour (0 - 23 for AM/PM).
HH Double digit hour, with leading zero (00 - 23 for AM/PM).
m Single or double digit minute (0 - 59).
mm Double digit minute, with leading zero (00 - 59).
s Single or double digit second (0 - 59).
ss Double digit second, with leading zero (00 - 59).
AP Display of the time of day: AM or am = before midday or
PM or pm = after midday
Procedure
3. Press the "Date/Time" softkey.

The "Set Date and Time" window opens.
4. Select the required formats for the date and time with the <SELECT> key
in the "Format" field.
5. For SINUMERIK Operate in the NCU: In the entry fields after "new" enter
the actual date and time.
For SINUMERIK Operate on PCU/PC: In the entry fields after "new NCU
+ PCU" enter the actual date and time.
6. Confirm the entry with the "OK" softkey.
The new date and time details are accepted and output in the fields "actual
NCU" and "actual PCU".

General settings
3.3 Using the time server
Note
You require administrator rights to set the date and time on the PCU/PC.
3.3 Using the time server

To ensure that the correct time information is always automatically available to the control, you
can connect up to three time servers to the operating software. Make your settings in the "Set
Date and Time" window.
Note
The setting "Use time server" is not available to SINUMERIK Operate on PCU/PC.
Requirement
You require as a minimum access level 3 (User) to use time servers.
Checking the connection status

The icon on the right in field "Name / IP" shows the status of the server connection.
Icon Meaning
The connection status is unknown. The settings have not yet been processed or set.
You are connected to the time server. The system is successfully synchronizing times.
The system is still attempting to synchronize with a time server.
Note
The system checks the time server connection cyclically. If a change is made, it may take a
few seconds for the setting to take effect.
Procedure
1. Select the "Setup" operating area.
3. Press the "Date/Time" softkey.

The "Set Date and Time" window opens.

General settings
3.5 Activating/deactivating the virtual keyboard
4. Select the "Use time server" check box.

The input fields "Name / IP" and "Time zone" open.
5. In field "Name / IP," enter the DNS name or IP address of the time server.
You can enter up to three time servers separated by blanks.
6. In the field "Time zone," enter your time zone.
7. Press the "Set time server" softkey.
If a connection to a time server exists, the settings will be synchronized
with the system immediately. After that, a cyclic check is made as to
whether the settings are effective. The "Set Date and Time" window re‐
mains open.
The time server settings and the current times are taken over from the
control.
Note
If the field "Use time server" is cleared again, the standard "UTC" time zone will apply again.
3.4 Configuring Caps Lock

The "CAPSLOCK on" function ensures that text entered via an external keyboard is always
entered in upper case and not in lower case.
The key behavior is set using the following display machine data.
Setting
MD9009 $MM_KEYBOARD_STATE
=0 CAPSLOCK off (default value)
=2 CAPSLOCK on
If the machine data is changed, the system must be rebooted.
3.5 Activating/deactivating the virtual keyboard

The virtual keyboard is configured in the file "slguiconfig.ini".
Procedure
1. Copy the "slguiconfig.ini" file from the folder
/siemens/sinumerik/hmi/template/cfg.
2. Paste the copy of the file into the following directory:
/oem/sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg.
3. Open the file in the editor.

General settings
3.7 Setting the screensaver
4. To activate or deactivate the keyboard, make the following settings:

– Activating the virtual keyboard:
In the section [TouchPanel], EnableTouch = true
In the section [Keyboard], EnableVirtualKeyBoard = true
– Deactivating the virtual keyboard:
In the section [TouchPanel], EnableTouch = true
In the section [Keyboard], EnableVirtualKeyBoard = false
5. Double click in the input field to display the keyboard.
3.6 Defining the access rights for the "HMI restart" softkey
Displaying the machine data

Using the following display machine data, set the access rights from which access level the
"HMI restart" softkey is displayed.
For SINUMERIK Operate on PC or PCU, the "EXIT" softkey is displayed.
MD9110_$MM_ACCESS_HMI_EXIT Access level of the "EXIT" softkey

=1 Access level 1 (manufacturer), default value
3.7 Setting the screensaver
Defining the time until the screen is darkened (screensaver)

The duration (in minutes), after which the screen is automatically darkened if no keyboard key
is pressed, can be specified using the display machine data
MD9006 $MM_DISPLAY_SWITCH_OFF_INTERVAL.
NOTICE
Influence of screen darkening on the service life
To extend its service life, the recommended duration for darkening a screen is 60 minutes.
If you significantly reduce the duration, i.e. the screen is switched dark too often, this tends
to shorten the screen service life.
Interface signal
The screen is darkened by setting an interface signal.
DB 19 byte Signals to the operator panel front (PLC → HMI)

DBB0 Bit 1 Bit 0
Darken screen Brighten screen

General settings
3.9 Access levels
The following applies when actively darkening the screen using the interface signal:
● It is no longer possible to light up the screen again from the keyboard.
● The first keystroke on the operator panel already triggers an operator action.
Note
In order to prevent accidental operator actions via the interface signal when the screen is
darkened, we recommend disabling the keyboard at the same time.
3.8 Inserting a user-specific run up screen
OEM-specific run up screen

You can replace the Siemens run up screen by your own run up screen.
Procedure:
1. Call your own run up screen "splash.png".
Note
The file name must not contain any lower case letters.
2. Save your own run up screen in one of the following directories:

/user/sinumerik/hmi/ico/ico640 or
/oem/sinumerik/hmi/ico/ico640 or
/addon/sinumerik/hmi/ico/ico640
Note
The size of the screen is of no significance. A resolution of 640x480 pixels is always set.
3.9 Access levels
3.9.1 Definition of access levels

Access to programs, data and functions is protected in a user-oriented hierarchical system of
seven access levels. These are divided into
● Three password levels for manufacturer, service and users
● Four keyswitch positions for users
There are access levels 1 to 7 (see table below); where
● 1 is the highest and
● 7 is the lowest level.

General settings
3.9 Access levels
Table 3-1 Access level concept
Access level Protected by Area

1 Password: SUNRISE (default value) Manufacturer
2 Password: EVENING (default value) Service
3 Password: CUSTOMER (default value) User
4 Keyswitch 3 Programmer, machine setter
5 Keyswitch 2 Qualified operator
6 Keyswitch 1 Trained operator
7 Keyswitch 0 Semi-skilled operator
3.9.2 Modifying the access levels password
Overview
You can activate the access levels protected with passwords from the user interface.
The following options are available for editing the passwords:
● Set new password
● Change password
● Delete password
Setting the password
2. Press the "Password" softkey.
3. Press the "Set password" softkey.

The "Set Password" window opens.
4. Enter one of the possible default passwords and press the "OK" soft‐
key to confirm the entry.
A permissible password is set and the valid access level is displayed.
Invalid passwords will be rejected.
Change password
You must change the standard passwords to obtain a secure access protection.
1. Press the "Change password" softkey.

The "Change Password" window opens.
2. Select the area (e.g. user) for which you want to assign a new password.

General settings
3.9 Access levels
3. Enter the new password in the input fields "New password" and "Repeat
password".
4. Press the "OK" softkey to confirm your entry.
A new, valid password is only accepted if the two terms entered are
identical.
Delete password
Press the "Delete password" softkey. The access authorization is re‐

set.
Note
Access authorization is not automatically deleted at POWER ON.
When a general NC reset is performed, the passwords are reset to the default passwords.
3.9.3 Access levels for programs
Objective
Access levels can be allocated to protect information; they can also be used to prevent
unauthorized operation or deliberate damage to the control system or machine.
With access authorization levels to files and directories, it can be defined as to which users
are authorized to execute which operations on a directory or a file in a file system. Operations
in this sense include:
● Reading the contents of a file (READ), copying the file or placing the file in an archive.
● Changing the contents of a file (WRITE) or deleting the file.
● Executing a file (EXECUTE).
● Listing and displaying a file in a directory (SHOW).
● Creating a file in a directory.
● Displaying or reading the contents of a directory.
● Creating or deleting a directory.
Description of functions
The individual allocation of access rights acts, in the passive NC file system, on the following
directories:
● Part programs
● Subprograms
● Manufacturer cycle directory

General settings
3.9 Access levels
● User cycle directory

● Workpieces directory
● Workpiece directories
Further, the function acts on the files of the main program type (*.mpf) and subprograms or
cycle (*.spf).
In addition, the technique can be expanded to include the following directories on the local
drive:
● Part programs
● Subprograms
● Workpieces directory
● Workpiece directories
Note
Working via remote access
When working via remote access (e.g. WinSCP or RCS Commander) the same access
rights apply for editing or saving files and directories as directly at the controller.
Access rights via machine data

The following machine data is still available to globally allocate access rights:
MD51050 $MNS_ACCESS_WRITE_PROGRAM
Default setting = 4 (access level: User)
Note
Effect of access rights
The more restrictive setting is always effective both when individual access rights have been
allocated and when settings have been made via
MD51050 $MNS_ACCESS_WRITE_PROGRAM.
Settings in the slfsfileattributes.ini file

The slfsfileattributes.ini file is available as a template in the following directory:
../siemens/sinumerik/hmi/template/cfg
The values from 0 ... 7 correspond to the access levels that, for example, also apply to the
password. The 4-digit numbers designate the sequence according to the following rights:
Significance from left to right: R W X S

R READ Reading files and directories
W WRITE Changing, deleting or creating files and directories
X EXECUTE Executes program: For files, for directories, always 7
S SHOW Outputs a list of files and directories

General settings
3.9 Access levels
Copy the slfsfileattributes.ini file into one of the following directories:

../oem/sinumerik/hmi/cfg or ../user/sinumerik/hmi/cfg
The operating software must be restarted in order that the changes become effective.
Example
The paths are composed of the data type identifiers. In the following example, "\wks.dir\*.wpd
\*.mpf" comprises the data type for workpiece directories "wks.dir" the workpieces "*.wpd" and
the part programs "*.mpf".
For all workpieces, 7777 is defined as default setting for new part programs.
All entries are in the section [ACCESSMASKS] and have the following form:
[ACCESSMASKS]
\wks.dir\*.wpd\*.mpf = 7777
\mpf.dir\*.mpf = 6577
\cus.dir\*.spf = 6577
See also
Definition of access levels (Page 33)
3.9.4 Access rights for files
Changing access rights

Access rights for execution, writing, listing and reading are displayed in the "Properties"
window.
● Execute: is used for the selection for execution.
● Write: controls the changing and deletion of a file or a directory.
For NC files, you have the option to set the access rights from keyswitch 0 to the current access
level, to be set separately for each file.
If an access level is higher than the current access level, it cannot be changed.
For external files (e.g. on a local drive), the access rights are displayed to you only if settings
have been executed for these files by the machine manufacturer. They cannot be changed via
the "Properties" window.
Note
Settings for the access rights to directories and files
Via the configuration file and MD51050, access rights of the directories and file types of the
NC memory and user memory (local drive) can be changed and pre-assigned.

General settings
3.9 Access levels
Configuration file slfsfileattributes.ini

The access rights defined in the configuration file slfsfileattributes.ini and in MD51050 become
valid in the NC when creating new files and can then be changed individually in the Program
Manager with the "Properties" function. The access rights are an individual attribute of each
file in the NC.
The access rights defined in the configuration file slfsfileattributes.ini and MD51050 become
valid for external data on the CompactFlash Card of the NCU, or on the hard disk of the PCU/
PC immediately for all the specified directories and file types, and cannot be changed through
operation. The access rights can only be set globally for external data.
3.9.5 Access levels for softkeys
Use
The display and operation of softkeys can be suppressed by both the OEM as well as the user.
This allows the operating software to be specifically adapted to the required functional scope
and therefore be configured as transparently as possible.
This means that the functional scope of the system is restricted, to prevent access to functions
in the operating software, or to restrict the possibility of operator errors.
Access hierarchy
A new access level can only be allocated for those softkeys that are also visible and can be
used in the actual access level.
Example: If a softkey is only accessible with the "Manufacturer" access level, then the access
level cannot be changed by an operator with access level "Key-operated switch setting 3".
Restrictions
In order to guarantee that the system remains stable and operable, certain softkeys are
excluded from the access level change, e.g. the "Customize softkeys" softkey itself, in order
that the undo path is not cut-off or the softkey "<< Back" to the vertical softkey bar.
The following softkeys cannot be hidden or the access level changed:
● All "OK" softkeys
● All "Cancel" softkeys
● All "Accept" softkeys
● All "<<" Back and ">>" Continue softkeys

General settings
3.9 Access levels
The access level for softkeys in the cycle dialog boxes can also be changed; this does not
apply to softkeys in Easy Screen dialog boxes.
Note
Software upgrade
As all changes of the access levels for softkeys are described using the softkey ID, they still
remain valid after a software upgrade, which may have resulted in softkeys being shifted.
Softkeys, where access is already protected by machine data - for example MD51045
$MNS_ACCESS_TEACH_IN - are only protected by the allocated access level after a new
one has been allocated. The machine data is no longer evaluated.
All of the softkeys hidden using this mechanism can be temporarily displayed again using the
access rights specified by the system. This is done using the "Show all softkeys" softkey. The
softkey is deactivated as long as no softkeys have been allocated new access levels: This
setting remains effective until the system is rebooted.
3.9.6 This is how you define new access levels for softkeys
General sequence
In order to assign a new access level to a softkey, proceed as follows:
● Activate the adaptation mode.
● Change the access level of a softkey.
● Accept the changes and confirm.
Preconditions
Access to the "Customize softkeys" is protected using a general MD51073
$MNS_ACCESS_SET_SOFTKEY_ACCESS. This machine data is pre-assigned access level
3, i.e. the function is available from "Service" password and higher. In order that an operator
with "User" access level can use this function, this machine data should be set to a value > 3.
An external mouse is required in order to make changes.
Changing the access level of a softkey

Procedure:
1. In the "Start-up" operating area, select the "HMI" menu.
2. On the expansion bar ">>" select the "Customize softkeys" softkey.
You can obtain precise information about the procedure in the following dialog.
1. Confirm with "OK", in order to activate the "Customize the softkey access levels active"
mode. A table is displayed.
2. Select an operating area.

General settings
3.9 Access levels
3. Place the mouse cursor on a softkey and using the right-hand mouse key call the context
menu "Define access level", in order to define a new access level for this softkey.
– The displayed access level is the default setting.
– A softkey is practically made invisible with "Always hide".
– You can reset the additionally allocated access level using "Original setting". This
selection is only listed after an individual access level was set.
4. In order to accept changes, return to the "Start-up" operating area and there, press the
"Close customizing" softkey. This means that you exit the "Customize the softkey access
levels active" mode.
If you acknowledge the following query with "OK", then the changes are accepted and
become effective once the system has rebooted.
5. If the changes to a softkey are not to be applied, select the line and press the "Original
setting" softkey. This means that in the "New access level" column, the "Original setting"
identifier is entered, which functions in the same way as deletion. This entry is no longer
available following a system restart. "
Example
The following access levels were changed:
Softkey New access level

SISuMainScreenMenuHu::0::3 Manufacturer
SIMaJogMillMenuHU::jogHuMore::6 User
SISuPaUserDataMenu::::4 Service
Once selected, the identifier and position of the softkey are transferred to the "Softkey" column.
Result
When the changes have been accepted, a configuration file with the "slsoftkeyaccess.xml"
name is created and is saved in the file system under the following path: ../user/sinumerik/hmi/
cfg. Files can also be saved in the /oem path, which are evaluated when the system boots.
The following priority applies: oem < user.
Note
Editing the file "slsoftkeyaccess.xml"
In order to avoid errors in the xml syntax and for the softkey identifier the "slsoftkeyaccess.xml"
file may only be edited via the operating software as described above, and not directly in the
file system under "System data". It is possible that the complete file or individual entries for
softkeys can no longer be interpreted.

General settings
3.10 Program selection
3.10.1 Displaying the softkey

The softkeys on the user interface for calling the program lists are activated via general
configuration machine data.
Configuring a softkey
MD51041 $MNS_ENABLE_PROGLIST_USER
0 No softkey
1 The "Prog. list" softkey is displayed
MD51043 $MNS_ENABLE_PROGLIST_MANUFACT
0 No softkey
1 The "MANUFACTURER" softkey is displayed
Precondition
To create program lists, you require the following authorization:
● "Program manager" operating area: Access level 3 (password: User) or
● "Start-up" operating area: Access level 1 (password: Manufacturer).
Program lists
You can create a program list by combining desired programs from the NC data, e.g.
workpieces, part programs and subprograms. These programs can then be selected by the
PLC for execution.
Program lists Directory

plc_proglist_user.ppl /user/sinumerik/hmi/plc/programlist
plc_proglist_manufacturer.ppl /oem/sinumerik/hmi/plc/programlist
Procedure
1. Select the "Start-up" operating area if you have the authorization for ac‐
cess level 1 (password: Manufacturer).
- OR -

General settings
Select the "Program manager" operating area if you have the authoriza‐
tion for access level 3 (password: User).
2. Press the menu forward key and the "Prog. list" softkey.
The "Program List" window opens.
3. Press the "Manufacturer" softkey if you want to create a program list that
can be used for all machines of a certain series.
4. Place the cursor in the desired line (program number).
5. Press the "Select program" softkey.
The "Programs" window opens. The data tree of the NC memory with the
directories "Workpieces", "Part programs" and "Subprograms" is dis‐
played.
6. Place the cursor on the desired program and press the "OK" softkey.
The selected program is inserted in the first line of the list together with
its path.
- OR -
Enter the program name directly in the list.
If you are making entries manually, check that the path is correct (e.g. //
NC/WKS.DIR/MEINPROGRAMM.WPD/MEINPROGRAMM.MPF).
If required, the extension (.MPF) is added.
Note:
A syntax check is not performed.
With workpieces, make sure that there is a main program or a job list with
the same name in the workpiece itself.
7. To remove a program from the list, place the cursor on the appropriate
line and press the "Delete" softkey.
- OR -
To delete all programs from the program list, press the "Delete all" softkey.

Licensing 4
Licenses are required for the activated options. When you purchase licenses you receive a
"license key" that contains all options requiring a license and which is only valid for your
CompactFlash card.
Requirement
If you wish to set or reset the options for a machine, you require at least access level 3 (user).
You can only license options for a machine from this access level and higher.
General information
Serial number of the Com‐ Permanently defined serial number of the CompactFlash card
pactFlash card
Hardware type Data of the control
Machine name/No. Displays the data that is saved in machine data
MD17400 $MN_OEM_GLOBAL_INFO
Only with access level 1 (manufacturer) can a display field be edi‐
ted.
License key Information about options that require a license
Procedure:
1. Select the "Setup" operating area.
2. Press the menu forward key.
3. Press the "Licenses" softkey.

The "Licensing" window appears and you can select the following
with the vertical softkeys:
● Determining the license requirement
– Overview
– All options
– Missing licenses
● Activating the test license
● Exporting license requirements
● Entering or reading in the "License key"
● Entering the lock file

Licensing
4.1 Determining the license requirement
License database
The license is purchased from the Web License Manager in the Internet, administered by
Siemens Industry.
For a detailed description, please refer to the following documentation:
References
CNC Commissioning Manual: NCK, PLC, drive
Section "Licensing"
Deactivate options
When importing old archives from other HMI systems, it can occur that options are set which
are no longer required in the actual system – however, these are subject to the license check:
Order number Option

6FC5800-0AP04-0YB0 Machining step programming
6FC5800-0AP11-0YB0 Manual machine
6FC5800-0AP15-0YB0 ShopTurn HMI/ShopMill HMI for SINUMERIK 840Di sl incl. HMI-
Advanced
6FC5800-0AP20-0YB0 3D simulation of the finished part
6FC5800-0AP21-0YB0 Simulation, milling (2D dynamic; 3D static)
6FC5800-0AP23-0YB0 Simultaneous recording, ShopMill (real-time simulation)
6FC5800-0AP24-0YB0 Simultaneous recording, ShopTurn (real-time simulation)
Procedure
1. Press the "All options" softkey to list all the options that can be selected
for this controller.
- OR -
Press the "Missing lic./opt." softkey.
You receive an overview of all options that
● are not adequately licensed
● are licensed, but which were not set
2. Activate or deactivate the required options in the "Set" column:
● Activate the checkbox or
● Enter the number of options
Options shown red are activated, however, not yet licensed or not licensed
in adequate number.
- OR -

Licensing
Press the "Set option acc. to license" softkey to activate all of the options
contained in the license key.
You obtain a confirmation prompt that you must confirm with "OK".
3. To activate new selected options, press the "Reset (po)" softkey. A safety
prompt appears.
For several options, you will have to also restart SINUMERIK Operate.
Corresponding prompts will appear in the user response line.
4. Press the "OK" softkey to trigger a warm restart.
- OR -
Press the "Cancel" softkey to cancel the process.
Note
If you activate the "Set option acc. to license" function, the sum of the axes that can be activated
may be exceeded. Therefore, reduce the number of actually used axes in the corresponding
options.
Searching for options

You have the possibility of finding options using the search function.
1. The window "Licensing: All Options" or "Licensing: Non-licensed Options"

is open.
2. Press the "Search" softkey and enter the required option in the search
form.
The cursor is positioned on the first entry that corresponds to the search
term.
3. Press the "Continue search" softkey if the term that was found is not the
option that you were looking for.
Additional search option
Press the "Go to beginning" softkey to start the search at the first option.
Press the "Go to end" softkey to start the search at the last option.
Note
Use of non-licensed options
Before licensing options, you can also activate them temporarily without the license keys and
use them for test purposes. In this case, the control displays alarm 8080/8081 periodically,
indicating that the option used has not yet been assigned the required license. Further, in this
state, the NC cannot be started.

Licensing
4.2 Activating the test license
4.2 Activating the test license

If you wish to use options without any restrictions – and without purchasing a license – you
can activate these for a limited time using the test license. Six test license periods are available.
The first test license period has a longer operating time. The operating time depends on the
NCU being used. Generally, the additional test license periods are 150 operating hours of the
control system.
Duration of the first test license period
NCU Operating time duration

710.3 1000 h
720.3 2000 h
730.3 3000 h
Requirement
If you wish to activate the test license, you require access level 2 (service).
Procedure
1. Press the "Activate test license" softkey.

A message informs you of the remaining number of test license
periods.
The test license period is now active.
The active test license periods and the remaining operating time
are now displayed.
Note
In the message line, the control displays the operating time still available for the current test
license period every hour.
Note
Interruption of the test license
A test license period is interrupted in the following cases:
● If no axis is operated actively, e.g. during simulation mode.
● If all non-licensed options are reset.
The test license continues when a non-licensed option is set again.

Licensing
4.4 Reading in the license key
Note
End of the test license
A test license period is terminated in the following cases:
● If the time has expired.
● If a new valid license key is entered.
No further test license can be activated on the NCU if all test license periods have expired.
4.3 Exporting license requirements

After you have determined the license requirement, you can export the data via the set-up
external storage locations.
Procedure
1. Press the "Export license requirement" softkey.

A small window opens listing the set-up storage locations.
2. Select "USB" for example, if you export the licenses on a USB flash drive.
The set options, the options which are not set but are licensed options,
the license requirement and the license key are stored in an Alm file. In
addition, an Internet connection is established for the Web License Man‐
ager.
A detailed description of the license management is provided in the following documentation:
References
Section "Licensing"
4.4 Reading in the license key

The newly purchased license key can be loaded to the controller as follows:
● Enter license key manually
● Read in license key electronically
Procedure
1. Press the "Licenses" softkey.
- OR -

Licensing
4.5 Backing up the license of a new CompactFlash card.
Press the "Overview" softkey.

The "Licensing" window opens.
2. If you obtain the license key via the Web License Manager, enter the
license key manually in the field "You can enter a new license key here".
If the license key is valid, the message "License key set" is displayed.
- OR -
If you have the appropriate license key in the form of an alm file, then
press the "Read-in license key" softkey.
... Open the appropriate storage location (e.g. USB) with "OK".
The matching .alm file is detected automatically and the license key is
read in.
Note:
If several matching .alm files are in the directory, they will be offered to
you in a subsequent selection dialog box.
Select the desired file.

If, for example, you want to replace a defective card on the control and transfer an existing
archive to a new empty CompactFlash card, you must back up the license of the new CF card
before restoring. If you restore without backing up, the license key of the CompactFlash card
will be overwritten.
Requirement
To back up the license key, you require a multi-card reader with USB on a PG/PC.
Procedure
1. The CompactFlash card has been inserted into the multi-card reader, which is connected
to the PG/PC.
2. Open directory cards/keys/sinumerik/.
Here you will find the license key in the form of a txt file.
3. Copy the license key to your back-up directory.
4. Insert the CompactFlash Card into the control and perform the restore action.
5. Insert the CompactFlash card into the multi-card reader again.
6. Copy the license key, renamed keys.txt, back to directory cards/keys/sinumerik.
7. Insert the CompactFlash card into the control again.
After the control has been powered up again, the license key will be installed from the file
keys.txt onto the system and be activated. The system renames the txt file to the installation
date.

Licensing
What to do if you lose the license key

To obtain a valid license key for the new, empty CompactFlash Card, please contact the
SINUMERIK hotline. They will then send you a new license key without delay.

Licensing

Creating drive connections 5
Up to 21 connections to so-called logical drives (data carriers) can be configured. These drives
can be accessed in the "Program manager" and "Startup" operating areas.
The following logical drives can be set up:
● USB interface
● CompactFlash card of the NCU, only for SINUMERIK Operate in the NCU
● Network drives
● Local hard disk of the PCU, only for SINUMERIK Operate on the PCU
Software option
In order to use the CompactFlash card as data carrier, you require the "Additional
HMI user memory on CF card of the NCU" option (not for SINUMERIK Operate on
PCU or PC).
Note
The USB interfaces of the NCU are not available for SINUMERIK Operate and therefore cannot
be configured.
5.1 Setting up drives

The "Set up drives" window is available in the "Start-up" operating area for configuring the
softkeys in the Program Manager.
Information on the procedure and configuration can be found in the following documentation:
References
Operating Manual, Universal/Turning/Milling/Grinding, Chapter "Managing programs" >
"Setting up drives"
File
The created configuration data is stored in the "logdrive.ini" file. This file is located in the /user/
sinumerik/hmi/cfg directory.

5.3 Setting the EES
General information
Note
We do not recommend that a USB front interface is permitted for part program execution using
EES if a system has several local USB front interfaces (several TCUs, the use of a HT8, etc.).
The connection to the USB FlashDrive can be interrupted as a result of the TCU switchover.
This setting should be made using the checkbox "Use this drive for program execution with
EES".
Note
If a global USB front interface should be used via PCU, then the PCU must be configured as
server via the VNC connection, see Chapter "Configuring VNC connections (Page 323)".
5.2 Setting EXTCALL

Using the EXTCALL command, a program on an external program memory can be called from
a part program.
EXTCALL must be switched off, when in certain configurations two SINUMERIK Operate are
connected to one NCU.
Activating the function

Processing EXTCALL calls is switched-on or switched-off using the following display machine
data.
MD9106 $MM_SERVE_EXTCALL_PROGRAMS
=0 HMI ignores EXTCALL instructions and selection via PLC
=1 HMI processes EXTCALL instructions and selection via PLC (default value)
=2 HMI processes EXTCALL instructions and ignores selection via PLC
=3 HMI ignores EXTCALL instructions and processes selection via PLC
Note
A main program selected from an external program memory is selected again automatically
after a power-on if the same program memory is still available and execution of EXTCALL calls
has been activated in MD9106.
5.3 Setting the EES

The EES (Execution from External Storage) function allows part programs for drives enabled
for EES to be processed directly without reload buffer. The behavior is the same as that for
processing from the NC part program memory without the restrictions that apply to "processing
external".

5.4 Creating a global part program memory
Activating the function
Software option
To use this function together with the user memory (100 MB) on the CompactFlash
Card, you require the software option
"CNC extended user memory."
If you also have the option "Additional HMI-Us.memory on CF card of NCU," you can expand
this memory to 6 GB.
Software option
To have unlimited use of this function, you require the software option
"Execution from External Storage (EES)."
Note
The EES function makes EXTCALL calls superfluous. If required, existing EXTCALL calls can
be converted. EXTCALL calls without conversion are also executed for an active EES, although
still as EXTCALL.
A detailed description of the EES function is provided in the following documentation:
References
Function Manual Basic Functions; Mode Group, Channel, Program Operation, Reset
Response (K1)
Chapter "EES (Execution from External Storage)"

With the global part program memory (GDIR), a structure is provided analog to the passive
file system of the NC. It is integrated in the search path of the NC for subprogram calls. If you
create a GDIR, all participants in the system have access to the same logical drive. The
participants can directly execute part programs from the common program memory. The GDIR
so replaces or extends the part program memory of the NC.
Note
The global part program memory plays a role only for the EES function. The creation of a GDIR
is, however, not essential for the EES operation.
Possible procedure
1. Declare the global part program memory in the "Creating drives" window
2. Shift the content of the local program memory with SPF, MPF and WCS directory to an
external drive, e.g. to a USB-FlashDrive.
3. Copy the directories that have been backed up to the global part program memory.

Additional information about managing the program memory is available in the following
documentation:
References
Job Planning Programming Manual, Chapter "File and Program Administration" > "Program
memory"

Channel menu 6
6.1 Configuring a channel menu
Q
The channel menu is activated for display via the channel switchover key.
&+$11(/
The channel menu is used to switchover the NC channel displayed in the SINUMERIK Operate
or more precisely at the operator station. If a channel menu has been configured, when the
channel switchover key is pressed, the channel menu for the channel switchover is displayed
to make the appropriate operator action. If there is no channel menu, then the channel
switchover key results in the HMI display advancing to the next NC channel.
Configuring
The configuration is made in the "netnames.ini" file for the operating software, as well as in
the particular "config.ini" files for the individual operator stations.
To configure the data for the operator stations (entries in the "config.ini" files), instead of directly
editing in the "config.ini" file, we recommend that you use the "System Network Center (SNC)"
program.
The "netnames.ini" file must be generated using an editor.
Storage
The "netnames.ini" file is stored for SINUMERIK Operate in the following directory:
/oem/sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg
The "config.ini" file is located in the relevant directory:
● On the NCU:
/user/common/tcu/<TCU name>/common/tcu/config.ini
● On the PCU:
F:\user_base\common\tcu\<TCU name>\common/tcu/config.ini
For <TCU name>, the TCU name of the operator station should be used that was assigned at
the system when a TCU powered-up for the first time. If you work with the "System Network
Center (SNC)" tool, then these file paths are of no significance.
Using the channel menu

● For a system comprising several operator stations and several NCUs within the framework
of operator unit management, if the NC channels of several NCKs are operated from one
operator station.
● For a simple system with many NC channels, as an alternative to the standard mechanism,
the channel switchover can be made using the channel switchover key.

Channel menu
6.3 General structure of the channel menu
The basic philosophy of the channel menu is to provide - in a selection menu - the operator
with a view of the NC channels of all NCUs that are to be operated with the channel menu. In
conjunction with this, a logical grouping/structuring is introduced using the so-called channel
groups. The desired NC channel can be directly selected using the selection menu. Without
a channel menu, when pressing the channel switchover key, the NC channels must be scrolled
through consecutively until the desired NC channel has been selected. An operator station
can only be switched over across NCUs using the channel menu.
6.2 Constraints
● Only one SINUMERIK Operate on a PCU/ PC may be permanently connected to one NCK.
It is not possible to switch over to another NCK.
● SINUMERIK Operate of an NCU can only operate with its own NCK and cannot be switched
over to another NCU.
6.3 General structure of the channel menu
Overview
For the channel menu, a logical view is defined across all of the channels of all NCKs involved;
this logical view is structured in channel groups and this in turn in specific NC channels.
A channel group list is defined for the channel menu in order to be able to switch over operation.
A channel group list comprises one or several channel groups. In turn, a channel group
comprises one or several NC channels.
In the channel menu, the channel groups can be selected using the horizontal softkeys.
The channels of a selected channel group can be selected with the vertical softkeys.
A certain NC channel of a specific NCU is always a switchover target that can be selected. A
switchover to another channel triggered via the channel menu can implicitly mean switchover
to another NCU.

Channel menu
6.4 Defining channel groups in the "netnames.ini" file
&KDQQHOJURXS
OLVW
$VVLJQPHQWIRUKRUL]RQWDO
&KDQQHOJURXS VRIWNH\V
$VVLJQPHQWIRUYHUWLFDO
1&FKDQQHO VRIWNH\V
Note
In a system, for example, a channel group can correspond to a machining station, the channels
contained in it, machining units.
Up to 32 channel groups each with up to 8 channels can be configured in a channel menu.
Configuring the total structure

For a system, the total structure of the channel menu is configured in the "netnames.ini" file.
The configuring in the "netnames.ini" file includes all switchover targets that are used at the
system. This configuration must be saved or distributed in a standard form across all
SINUMERIK Operate systems that provide the channel menu.
An individual channel menu for the operating station is configured for each operating station
in the particular "config.ini" file.
Two-stage procedure
1. In the first stage, all channel groups that are used in the system are defined in the
"netnames.ini" file, irrespective of the actual operating stations.
2. In the second stage, the version of the channel menu for the specific operating station is
defined in the "config.ini" files belonging to the station.
Defining channel groups

All channel groups that are used at the system are defined in the "netnames.ini" file.
Independent of the specific operator stations.
A separate section [CH_GRP_x] (1 <= x <= 32) should be created for every channel group.

Channel menu
The entries required for a channel group are as follows:

● The text to be displayed in the channel for the channel group at the corresponding horizontal
softkey.
● The list of jump destinations summarized in this channel group, i.e. NC channels. The jump
destinations are defined in a consecutively numbered list with the following entries:
– Membery.Target: Jump destination
– Membery.Text: Softkey text to be displayed in the channel menu (1 <= y <= 8).
"netnames.ini" file
A channel group, e.g. channel group 1 is therefore specified as follows:
[CH_GRP_1] ; Name of the channel group; the notation

; must follow this scheme. The groups are
; consecutively numbered at the last
; position.
Text = Process1 ; Softkey text for the channel group for
; display in the channel menu (horizontal
; softkey) switchover designation 1 of the
; channel group.
Member1.Target = ; Computer name (host name) or the IP
[<HMI>.]<NC>.#<channel ; address of the computer on which the HMI
number> ; to be selected runs (NCU or PCU):
; <HMI> = <IP address or name of the HMI
; host (PC/PCU)>
; <HMI> can be omitted if the HMI runs
; locally on the NCU
; <NC> = <IP address or name of the NC>
; Alternatively, the machine name can also
; be specified from the mmc.ini.
; Using ".#Channel number", optionally the
; NC channel can be specified that should
; be taken when switching over.
;
Member<No>.Text = NCU730_K1 ; Softkey text for the display in the
; channel menu (vertical softkey). If, for
; "Target" a channel number is specified,
; then instead of a text, using the fixed
; value "$MC_CHAN_NAME", it can also be
; defined that the text to be displayed
; should be the channel name defined in the
; NCK machine data.
;
Member2.Target =
Member2.Text ; Same as for the vertical softkey 2

Channel menu
6.6 Example: Settings for 1:N
6.5 Configuring operating stations in the "config.ini" file

The version of the channel menu is individually defined for the operator stations in the
"config.ini" files belonging to the station. The data defined in the "netnames.ini" file is used.
Here, the channel groups are assigned a softkey in the channel menu.
"config.ini" file
● The data is defined in section [T2M2N].
● The references CH_GRP_xx of the softkeys refer to the channel groups which are defined
in the "netnames.ini" file. This notation is binding.
● SKx in this case, designates the xth horizontal softkey in the channel menu.
Example
...
[T2M2N]
SK1=CH_GRP_1
SK2=CH_GRP_3
SK8=CH_GRP_15
1:N configuration
For a 1:N configuration the following requirements apply:
● A PCU with SINUMERIK Operate can be connected to a maximum of four NCUs.
● SINUMERIK Operate must be switched off on all NCUs.
● The following configuration files must be adapted:
siemens/sinumerik/hmi/template/cfg/netnames.ini
siemens/sinumerik/hmi/template/cfg/mmc.ini
This is illustrated in the following sections using an example with 1 PCU and 2 NCUs.
Example mmc.ini
[Global]
NcddeMachineNames=net, NCU840D_1, NCU840D_2
NcddeDefaultMachineName=NCU840D_1
[NCU840D_1]
ADDRESS0=192.168.214.1,LINE=14,NAME=/NC,SAP=040d,PROFILE=CLT1__CP_L4_INT
ADDRESS1=192.168.214.1,LINE=14,NAME=/PLC,SAP=0202,PROFILE=CLT1__CP_L4_INT

Channel menu
ADDRESS2=192.168.214.1,LINE=14,NAME=/CP,SAP=0502,PROFILE=CLT1__CP_L4_INT
ADDRESS10=192.168.214.1,LINE=14,NAME=/DRIVE_00_000,SAP=0201,
SUBNET=0046-00000000:000,PROFILE=CLT1__CP_L4_INT
PROFILE=CLT1__CP_L4_INT
[NCU840D_2]
ADDRESS0=192.168.214.2,LINE=14,NAME=/NC,SAP=040d,
ADDRESS1=192.168.214.2,LINE=14,NAME=/PLC,SAP=0202,
ADDRESS2=192.168.214.2,LINE=14,NAME=/CP,SAP=0502,
SUBNET=0000-00000000:000,PROFILE=CLT1__CP_L4_INT
Example netnames.ini
;******************************************************************
; netnames.ini - EXAMPLE -
;
; This is an example of a netnames.ini for 1:N NCU-switching in
; a configuration of 3 NCU and a PCU50.
;*******************************************************************
[own]
owner = HMI
;***************************
; ChanMenu
;***************************
[chan HMI]
ShowChanMenu = true
;*******************************************************************
;Channel-groups
;Correlation from channel-group to horizontal softkeys
; -> see config.ini of the TCU
;The section [T2M2N] can also be created in the netnames.ini file
;instead of config.ini file. This configuration applies to all TCU,
;which are not configured by their config.ini.
;*******************************************************************
[T2M2N]
SK1 = CH_GRP_1
SK2 = CH_GRP_2
[CH_GRP_1]
Text = 1. NCU

Channel menu
6.7 Distribution via job lists in the case of 1:N
Member1.Target = 192.168.214.241.192.168.214.1.#1
Member1.Text = NCU1%nKanal 1
Member2.Target = 192.168.214.241.192.168.214.1.#2
[CH_GRP_2]
Text = 2. NCU
Member1.Target = 192.168.214.241.192.168.214.2.#1
Member2.Target = 192.168.214.241.192.168.214.2.#2
Note
For switching over an MCP with the operating software, the PLC block FB9 must not be used
(FB9 must not be active). If necessary, the MCP must be switched over in the PLC user
program.
Solution
In the OB100 (call for FB1), set MCP1BusAdr to 255 and MCP1Stop to "true".
In the OB1, scan the "MMCBTSSready" (DB10.DBX108.3) signal. If this is set, write the MCP
address from DB19.DBB123 (MCP index) to the DB7.DBB27 before removing the MCP stop
bit DB7.DBX62.1. The MCP is now active.
If the "MMCBTSSready" (DB10.DBX108.3) is removed again (operating software switches to
another NCU), the MCP stop bit DB7.DBX62.1 will have to be reset.
Simplified selection of programs

The function is only available in a group of several NCUs ands must be enabled in the
"systemconfiguration.ini " configuration file:
[miscellaneous]
distributeJoblist=true
The sources are located on the local drive of the PCU or the PC.
The distribution of the programs is done by selecting a job list which is located in a workpiece.
The job list may contain COPY and SELECT instructions:
; Copy A.MPF to NCU1:
COPY A.MPF NC=NCU1
; Copy B.MPF to NCU2:

Channel menu
COPY B.MPF NC=NCU2

; Copy all subprograms to all NCUs:
COPY *.SPF *
; Select A.MPF on NCU1 in channel 1.
SELECT A.MPF ch=NCU1,1
; Select B.MPF on NCU2 in channel 2.
SELECT B.MPF ch=NCU2,2
Sequence:
1. If a distributed job list is active during the selection, all distributed programs on the NCU
are deleted without confirmation. If the workpiece on the NCUs is empty, it will be deleted
there.
2. The programs are copied to the corresponding workpieces of the relevant NCU.
3. Existing programs are overwritten without any message.
4. Following a change in a distributed program on the local drive, the modified programs using
the Editor are copied to the corresponding NCU.
Sample structure
/user/sinumerik/data/ prog/ NCU1 NCU2

JOBA.WPD
JOBA.JOB WKS.DIR WKS.DIR
A.MPF WKS.DIR/JOBA.WPD WKS.DIR/JOBA.WPD
B.MPF WKS.DIR/JOBA.WPD/B.MPF WKS.DIR/JOBA.WPD/B.MPF
UP1.SPF JOBA.WPD/UP1.SPF JOBA.WPD/UP1.SPF
UP2.SPF WKS.DIR/JOBA.WPD/UP2.SPF WKS.DIR/JOBA.WPD/UP2.SPF
/user/sinumerik/data/ prog/ NCU1 NCU2

wks.dir/JOBA.WPD
JOBA.JOB WKS.DIR WKS.DIR
A.MPF WKS.DIR/JOBA.WPD WKS.DIR/JOBA.WPD
B.MPF WKS.DIR/JOBA.WPD/B.MPF WKS.DIR/JOBA.WPD/B.MPF
UP1.SPF JOBA.WPD/UP1.SPF JOBA.WPD/UP1.SPF
UP2.SPF WKS.DIR/JOBA.WPD/UP2.SPF WKS.DIR/JOBA.WPD/UP2.SPF
Supplementary conditions
Special behavior:
● Distributed programs are retained during a restart of the operating software.
● On the local drive, distributed programs can neither be deleted nor renamed nor overwritten
using copy/move.

Channel menu
● Changes of distributed programs on the NCU are lost, if they are not manually saved.
● The program correction in the machine is not offered.
● When creating a commissioning archive, all data of the local drive is also automatically
saved.
Restrictions:
● In the event of changes of distributed programs on the local drive using the Editor, it should
be noted that only the channel states are monitored on the NCU currently connected. If the
program is still interrupted or active on another NCU, it cannot be correctly distributed after
the change.
● The display of the active block, the marking of the block search as well as the read-only
handling of the program opened in the Editor are executed only for the active programs of
the currently connected NCU.
● In the Editor, programs are always opened in the context of the currently connected NCU.
This can lead to a faulty step recognition with distributed programs.
● In the current block display in the "Machine" operating area, you can display only the active/
distributed programs of the currently connected NCU.
● The simulation of job lists via several machines is not possible.
● If distributeJoblist=true is configured in the systemconfiguration.ini file, then part
or subprograms can no longer be selected via the "Program Manager" operating area.

Channel menu

Machine and setting data 7
7.1 Machine and setting data
Overview
Prefix Number ranges Machine/setting data Storage in range

(softkey)
$MM 9000 - 9999 Display machine data Display MD
$MNS 51000 - 51299 General configuration machine data General MD
51300 - 51999 General cycle machine data
$MCS 52000 - 52299 Channel-specific configuration machine data Channel MD
52300 - 52999 Channel-specific cycle machine data
$MAS 53000 - 53299 Axis-specific configuration machine data Axis MD
53300 - 53999 Axis-specific cycle machine data
$SNS 54000 - 54299 General configuration setting data General SD
54300 - 54999 General cycle setting data
$SCS 55000 - 55299 Channel-specific configuration setting data Channel SD
55300 - 55999 Channel-specific cycle setting data
$SAS 56000 - 56299 Axis-specific configuration setting data Axis SD
56300 - 56999 Axis-specific cycle setting data
References
You can find a detailed description of the machine and setting data in the following
documentation:
Machine Data and Parameters List Manual
7.2 Displaying/editing machine data

You can access the following machine data in the "Start-up" operating area.
● General machine data ($MN) and general configuration machine data ($MNS)
● Channel-specific machine data ($MC) and channel-specific configuration machine data
($MCS)
● Axis-specific machine data ($MA) and axis-specific configuration machine data ($MAS)
● Drive-specific machine data ($M_)
● Machine data control unit: Drive parameters
● Machine data feed-in: Drive parameters

Machine and setting data
● I/O component parameters: Drive parameters

● Communication parameters (CULINK, DMC): Drive parameters
Note
The display of the machine data / drive parameters depends on the configuration of your
control.
Access authorization to the machine data operating area can be controlled by keyswitch
position or password.
Read-access to machine data is possible as of access level 4 (keyswitch 3).
Machine data can be changed with access level 1 (manufacturer).
WARNING
Incorrect parameterization
Changes in the machine data have a considerable influence on the machine. Incorrect
configuration of the parameters can endanger human life and cause damage to the
machine.
Information about machine data

The following information is displayed from left to right:
● Machine data number, with array index if applicable
● Machine data name
● Machine data value
● Machine data unit
● Effective
Note
If the machine data does not use units, the corresponding column is empty. If the data is not
available, the hash symbol "#" is displayed instead of the value. If the value ends in an "H", it
is a hexadecimal value.
The physical units of machine data are displayed on the right-hand side of the input field.
For each machine data item, an activation type can be read in the column on the right.
so Immediately active: No action required

cf Configuration: "Set MD to active (cf)" softkey
re Reset: <Reset> key on the machine control panel
po POWER ON: "Reset(po)" softkey
Additional Information
In the footer you are given a brief explanation of the selected machine or setting data item.

Procedure
2. Press the "Mach. data" softkey. Additional softkeys for the individual ma‐
chine data areas are displayed.
3. Press the "General MD", "Channel MD", or "Axis MD" softkey.
The window opens and the selected machine data is displayed.
4. Place the cursor on a machine data item.

5. Position the cursor on the entry to be modified and enter the required
value.
6. Depending on the activation type, there are two ways of activating the
settings:
Press the "Activate MD (cf)" softkey. The value is applied.
- OR -
Press the "Reset (po)" softkey.
A safety prompt appears.
- OR -
Press the "Cancel" softkey if you do not want to apply the settings.
Axis selection
If several components are available for the area selected (e.g. "Axis MD"), you can choose
from the following options:
1. Press the "Axis +" or "Axis -" softkey.

The values of the next (+) and the previous (-) axes are displayed.
- OR -
Press the "Direct selection..." softkey.
The "Axis Direct Selection" window opens.
2. Select the required axis directly from those available in the drop-down list
box.

7.4 Displaying/editing setting data
3. Press the "OK" softkey to save the setting.
- OR -
Press the "Cancel" softkey to reject the settings.
7.3 Displaying/editing display machine data

You can access the display machine data via the user interface in the "Start-up" operating
area.
Procedure
2. Press the "Mach. data" softkey.

Further softkeys are displayed.
4. Press the "Display MD" softkey.
The display machine data appears.
value.
6. Press the "Reset (po)" softkey.
- OR -

You can access the following setting data via the user interface in the "Startup" operating
area.
● General setting data
● Channel-specific setting data
● Axis-specific setting data

Procedure

The softkeys "General SD", "Channel SD", and "Axis SD" are displayed.
4. Press the relevant softkey to display a particular setting data area.
The window opens and the selected setting data is displayed.
5. Place the cursor on the desired setting data and position the cursor on
the entry to be changed. Enter the desired value.
6. Depending on the activation type, there are two ways of activating the
settings:
Press the "Activate MD (cf)" softkey.
- OR -
- OR -

7.5 Displaying/editing drive parameters
Axis/channel selection
If several components are available for the area selected (e.g. "Axis SD" or "Channel SD"),
you can choose from the following options:
1. Press the "Axis +" or "Axis -" or "Channel +" or "Channel -" softkey.
The values of the next (+) and the previous axis/channel (-) are displayed.
- OR -
Press the "Direct selection..." softkey.
The "Direct Selection" window opens.
2. Select the required axis directly from those available in the drop-down list
box.
3. Press the "OK" softkey to save the setting.
- OR -
Press the "Cancel" softkey to reject the setting.

The "Control Unit MD", "Infeed MD" and "Drive MD" softkeys as well as the "I/O comp. MD"
and "Comm MD" on the menu forward key are available to display and edit drive parameters.
A separate list display is provided for each of these areas in which you can view and edit drive
data.
Precondition
Settings for drive parameters are protected with access level 2 (service).
The lists of the drive parameters are visible with access level 4 (keyswitch 3).
Please refer to the following documentation for information on commissioning the drive:
References
CNC Commissioning Manual: NCK, PLC, drives

Procedure

The "Control unit parameters", "Supply MD" and "Drive MD" softkeys are
displayed.
3. Press the softkey of an area to show its parameters.
4. Place the cursor on the desired parameter.
value.
6. In order to activate the settings, you have the option of saving or carrying
out a reset.
Press the "Save/reset" softkey.
7. Press the "Save" softkey.
You are prompted "What do you wish to save?"
You can make the following selection per softkey:
● Actual drive object
● Drive unit
● Drive system
- OR -
You are prompted as to whether you wish to initiate a warm restart for the
NCK and the complete drive system.
Confirm the prompt with the "Yes" softkey.
Reject the warm restart with the "No" softkey.
Extended reset
If you wish to carry out a warm restart only for specific objects or specific areas, then additional
softkeys are available for this purpose.
Press the "Extended reset" softkey.

You are prompted to enter for which objects you wish to initiate a warm
restart.
You can make a selection with the following softkeys:
Only the NCK is restarted.

7.6 Machine data display options
All of the control units and the NCK in the system are restarted. This
softkey corresponds to the "Reset (po)" softkey if you confirm the prompt
with "Yes".
All of the control units and the NCK in the system as well as the operator
software are restarted.
Hiding the expanded softkey bar

The "Extended reset" softkey is defined in the "slsuconfig.ini" file. If the softkey is not to be
displayed, proceed as follows:
1. Copy the "slsuconfig.ini" file from the /siemens/sinumerik/hmi/template/cfg/ directory.
2. Insert the file into the following directory:
/user/sinumerik/hmi/cfg/
3. Open the file and in the section
[Softkeys] and enter
AdvancedReset = 0

Through the use of the machine data display filter, it is possible to reduce the number of
displayed machine data relating to a certain area, e.g. general machine data, for special
purposes.
Machine data areas

Display filters are available for the following machine data areas:
● General machine data
● Channel-specific machine data
● Axis-specific machine data
● Drive machine data
● Display machine data
Filter options
It is possible to limit the machine data display using the following filtering methods:
● Only display axes that are used
● According to indices
● According to display groups
● Display expert parameters

Only display axes that are used

If this checkbox is activated, axes that are not used are hidden when scrolling.
Indices from ... to

The index filter refers to the machine data arrays. On the display, this machine data can be
identified by the field index attached to the machine data string.
Example: 10000[index]AXCONF_MACHAX_NAME_TAB
If the index filter is activated, machine data arrays are only displayed in the specified index
area.
Display groups
A display group contains machine data within a machine data area that belongs to the same
topic.
Note
To find out which display group a machine data item belongs to, refer to the "Display filter"
parameter associated with the description of the machine data element in question.
References: List Manual (book 1)
Select/deselect display groups to increase or decrease the number of machine data items
displayed for the current machine data area.
Display expert parameters

If the "Display expert parameters" filter is disabled, only the machine data in a machine data
area that is required for the basic functionality of the NC is displayed.
Procedure
3. Press the softkey of a particular data area, e.g. "General MD".

The list of general machine data is displayed.
4. Press the ">>" and "Display options" softkeys.
The window "Display options: ..." for the selected machine data opens.

7.7 Editing machine data and drive parameters
5. Select the required filter options (according to display groups, indices or

expert parameters) by activating the checkboxes.
6. Press the "Select all" softkey to activate all display groups.
- OR -
Press the "Deselect all" softkey.
All checkmarks are removed and you can select individual display groups.
Press the "OK" softkey to save the settings.
7.7.1 Editing hexadecimal values

You can use a bit editor to enter the required values for machine data in hexadecimal format.
Procedure
2. Press the "Mach. data" softkey and select the required machine data area
(e.g. general machine data).
3. Position the cursor on the entry to be edited.

4. Press the <SELECT> or <INSERT> key.
The "Bit Editor" window opens.
All bits of the machine data item that have a description text are displayed.
5. If you activate the "Display all bits" checkbox, all bits regardless of their
data type (8, 16 or 32 bits) are displayed. Activate the relevant bit.
6. Press the "OK" softkey. The setting is checked and an error message may
be output.
The window closes and you return to the machine data overview.
The new value is displayed in hexadecimal format.

7.7.2 Editing BICO values

You can use the BICO editor to enter BICO values for drive parameters.
Note
BICO values can also be entered by copying and inserting or also directly entered the field.
Procedure
3. Press the "Control unit MD" softkey and select a BICO parameter, e.g.
"p738".
4. Position the cursor on the entry to be changed, e.g. BICO 63.2091.0
The "BICO Editor" window opens.
6. Complete the "Drive object number", "Parameter number", "Bit/Index" and

"Parameter value (hex)" fields.
Note
The BICO editor also opens if you enter a value other than 0 or 1 for the value to be changed.
7.7.3 Editing enum values

For drive parameters, you have the option of editing enum elements (e.g. r2, p3, p4, p97 etc.)
using a selection list.

7.8 Searching for data
Procedure
3. Select the desired drive parameter area, e.g. "Control unit MD".
4. Select the desired parameter, e.g. "p3" and position the cursor at the entry
to be changed, e.g. "[1] Display, Si...".
A window containing a list of all defined enum values and their descrip‐
tions opens.
6. You can select a value from the list.

- OR
You can also directly enter the value as decimal number into the brackets
[ ].

You can search for specific machine, setting and display machine data.
Search strategies
● When a digit or a digit with an index is entered, an exact search for this parameter is
performed.
Example: If "9" is entered > p9 will be found (but not p99)
● When text is entered, a full-text search is performed: i.e. the term is sought in the relevant
table and in the explanations in the footers.
Note
Search with place holders
When searching for machine data, you have the option of using place holders:
● "*": Replaces any character string
● "?": Replaces any character

Searched fields
A search is made in the following fields of the machine data for the character string that has
been entered if the "Additionally search in the explanation texts" option is not set:
● Machine data number
● Symbolic name
● Unit
The following fields are additionally searched if the "Additionally search in the explanation
texts" option is set:
● Descriptive text
● Bit texts
● Enum texts (only for drives)
Procedure
3. Select the required area by pressing the relevant softkey.

4. Press the "Search..." softkey and enter the required text or digit in the
search screen.
5. If you wish to restrict the search only to the texts in the tables that are
displayed, deactivate the "Search explanation texts too" checkbox.
6. Select the search direction required (forwards, backwards) in the "Direc‐
tion" field.
term.
7. Press the "Continue search" softkey if this machine, setting or display
machine data item is not the one you are looking for.
Press the "Go to start" softkey to start the search at the first data.
Press the "Go to end" softkey to start the search at the last data.

7.9 Managing data
7.9 Managing data
Overview
The "Manage data" function is used to simplify the commissioning and permits the transfer,
backup, loading and comparing of machine, setting, compensation and drive data at the file
level. The files are saved in the .tea ASCII format.
The "Manage data" softkey is visible as of access level "Service" (= 2).
The following option fields are available in the "Transfer Machine Data" window:
● Transfer data within the controller
Only those controller objects are listed that are currently available in the controller.
● Save data to a file
Additional files with the extensions .acx and .log are created for the SINAMICS parameters:
– Files with the extension .acx contain the parameter descriptions for the selected drive
object.
– The log file may also contain the warnings and errors that occurred during the conversion
from .acx to .tea.
● Load data from a file
Note
An NCK and drive reset is only triggered automatically for drive objects after loading. A
reset must be triggered manually for all other controller objects.
● Compare data
Several files (.tea) and/or controller objects (axis, channel, servo, infeed, etc. ) can be
compared at the same time. An online comparison of constantly changing data is not
possible because the values are saved temporarily at the time of the comparison.
Up to eight elements can be taken into the list of the data to be compared.
Procedure

The "Manage data" softkey is available in each machine data area, except
in "User views".
- OR -
Press the "System data" softkey and select the HMI data/Data backups/
IB data directory.
3. Press the "Manage data" softkey.
The "Transfer Machine Data" window opens.
4. Activate the required option filed and press "OK".

7.9 Managing data
Transfer data within the controller

5. Position the cursor on a controller object and confirm with "OK".
6. In the window that opens, select the target controller object and confirm
with "OK".
Save data to a file
5. Position the cursor on a controller object and confirm with "OK".
6. The "Save Under: Select Archive" window opens and the appropriate
storage location is preselected.
If required, press the "New directory" softkey to generate a new subdir‐
ectory. Enter the required name in the "New Directory" window and con‐
firm with "OK".
7. In the "New File" window, enter the required name for the file to be saved
and confirm with "OK".
The stored files can be found in the data tree of the "System data" in the
HMI data/Data backups/IB data directory.
Load data from a file
5. The "Load Trace: Select File" window opens.
Position the cursor on a .tea file that is located either in the IB data direc‐
tory or on a USB-FlashDrive and confirm with "OK".
Please note: If the source and target drive object numbers differ when
loading drive data, you must adapt individual parameters. To do this,
press the "Adapt" softkey and edit the parameter values in the window
that appears.
Compare data
5. In the "Compare Data - Controller" window, select an element to be com‐
pared from the tree structure of the control objects.
- OR -
Press the "File" softkey to select a .tea file to be compared from the tree
structure of the files.
6. Press the "Add to list" softkey.
The list of the data to be compared is displayed in the lower part of the
window and the selected element is added.
7. Press the "Delete from list" softkey to remove individual elements from
the comparison list.
- OR -
Deactivate the checkbox of the selected element in the list of the data to
be compared.
8. When at least two elements are listed, the "Compare" softkey is enabled.
Press this softkey to perform the comparison.

7.10 User views
7.10 User views
Use
In the "User Views" window you can create and adapt all machine data relevant to a particular
functionality. Machine data is individually collated to simplify the user's task.
You can include additional comments when creating and/or editing user views.
Note
Importing user views (compatibility)
If you have already created user views in HMI-Advanced, copy the *.klb files to /user/sinumerik/
hmi/template/user_views to use them in SINUMERIK Operate.
Display in the the "Parameter" operating area

Proceed as follows to show user views also in the "Parameters" operating area:
2. Press the "Machine data" softkey.
3. Press the "User views" softkey.
4. Press the "Manage view” softkey.
5. Press the "New view" softkey.
6. Activate the checkbox "Display parameter / use setting data", if you also wish to display the
new user view in the "Parameter" → "Setting data" → "Data lists".
7. Enter a name for the user view.
8. Confirm with "OK".

7.10 User views
7.10.1 Creating a user view
Procedure
1. Select the "Start-up" operating area and press the "Mach. data" softkey.
2. Press the softkeys "User views",

"Manage view" and
"New view".
The "New View" window opens.
3. Enter the desired view name.
If a user view already exists with the same name, you receive a safety
prompt as to whether the existing view should be overwritten.
4. Press the "Enter data" softkey.
The "Insert data" selection box opens.
5. Open the selection list with the <INSERT> key, select a machine data
area and press the <INPUT> key.
Select a machine data item with the cursor keys or using the "Find"
softkey.
6. Press the "Insert before line" or "Insert after line" softkey to insert the
selected machine data at the required position in the user view.
Note:
You can navigate in the open user view with the mouse and select a
line without closing the list box.

7.10 User views
7. Press the "Back" softkey to close the list box and return to the user view
you want to edit.
Your entries are automatically stored.
8. Press the "Insert text" softkey to insert any text in the open user view.
The "Insert Text" input window opens.
9. Enter a text and explanatory description for the text and press the "Insert
before line" or "Insert after line" softkey to accept the text.
10. Press the "Back" softkey to save your entries and return to the user view
you are editing.
Selecting a particular machine data item
You can use the Search dialog box to look for a particular data item.
7.10.2 Editing the user view

Depending on the row you have selected, you can use the "Properties" softkey to change
comments and, in the case of machine data, the data source (channel, axis, drive unit) and
view the description and, if required, change.
● Machine data
Depending on the data type you can select either a fixed or a variable data source for
machine data.
The entry "variable(*)" means that when you can select another data source (channel, axis,
drive unit) with vertical softkeys 1- 3 (+, - and direct selection) the value displayed changes
to refer to the data source currently selected.
Alternately, you can select a fixed data source so that the displayed value does not change
when you select a different data source.
● Comment texts
Text and description
Procedure
1. Select the "Start-up" operating area and press the "Mach. data" softkey.

The "User Views" window opens.

7.10 User views
3. Press the "Edit view” softkey. Additional softkeys to edit the user view are
listed.
4. Press the "Insert data" softkey if you wish to enter another data item.
5. Select a machine data item with the cursor keys.
6. Press the "Up" or "Down" softkeys to move the selected row.
- OR -
Press the "Delete line" softkey to remove the selected line from the view.
The data item is removed without a prompt.
- OR -
Press the "Properties" softkey to view the texts for comments and, if re‐
quired, change.
The "Properties" window is opened. For machine data, depending on the
setting, the description or the machine data is displayed in the lower left-
hand window.
7. Press the "Back" softkey to save your changes.
Selecting a particular machine data item
You can use the Search dialog box to look for a particular data item.
Press the "Go to start" softkey to start the search at the first entry.
Press the "Go to end" softkey to start the search at the last entry.
Press the "Continue search" softkey if the data found during the search
does not match up with what you are looking for.

7.11 Plain texts for machine and setting data
7.10.3 Deleting a user view
Procedure
2. press the "Machine data" softkey.
4. Press the "Manage view” softkey.
5. Select the desired view from the selection list.

6. Press the "Delete view" softkey.
With the final confirmation prompt you will be requested to confirm with
either "Yes" or cancel with "No".
or
The "User views" dialog is then redisplayed.
Just like before, as an alternative, it is possible to delete a user view under "System data"
under the following path: ../user/sinumerik/hmi/template/user_views

Application-specific and language-dependent plain texts can be configured for machine and
setting data depending on the version [Index].
Displaying the plain texts

You set the display of the plain texts using the following display machine data:
MD9900 $MM_MD_TEXT_SWITCH Plain texts instead of MD identifier

=1 Plain text is displayed in the table
=0 Plain text is displayed in the dialog line

Files
File Machine/setting data

nctea_xxx.txt General machine/setting data
chtea_xxx.txt Channel-specific machine/setting data
axtea_xxx.txt Axis-specific machine/setting data
hmitea_xxx.txt Display machine data
For "xxx" the specified language code must be used, e.g. "deu" for German, "eng" for English,
etc.
Supported languages (Page 612)
Ensure that the file names are written in lower case letters.
Procedure
1. Depending on the machine or setting data for which you wish to change the plain text,
create the corresponding file, e.g. "nctea_xxx.txt".
2. Save the file with the UTF-8 coding in order that umlauts and special characters are
correctly displayed in SINUMERIK Operate.
3. Place the file in SINUMERIK Operate in the following directory:
System CF card/user/sinumerik/hmi/Ing or
System CF card/oem/sinumerik/hmi/Ing or
System CF card/addon/sinumerik/hmi/Ing
Note
The files are searched through in the sequence of the directories "user", "oem" and "addon".
The first file that is found is evaluated. If, e.g. text files are available in the "user" and "oem"
directories, the files are evaluated in the "user" directory.
Note
If a machine data item has different indices and you do not specify an index for the plain text,
the same plain text appears for all the indices of the machine data item.
The parameters and indices must be sorted in an ascending order.
Example of a file with German texts

14510 Mein Integer-Text für PLC_MD 14510
14510[1] Mein Integer-Text für MD 14510[1]
14512[1] Mein Text für HEX-Datum 14512[1]

Result in the display

The plain text is displayed in the table or in the diagnostics line in the operating area "Startup",
"General MD".
Machine data Text

14510 My integer text for PLC_MD 14510
14510[1] My integer text for MD 14510[1]
14512[1] My text in HEX data 14512[1]

Customizing the "Machine" operating area 8
Automatic changeover
The circumstances under which an automatic changeover is made into the "Machine" operating
area are set in MD51040 $MNS_SWITCH_TO_MACHINE_MASK.
MD51040 $MNS_SWITCH_TO_MACHINE_MASK 0 (default setting)

Bit 0 = 1 For program selection in the Program Manager, an automatic change is not made into
the Machine operating area.
Bit 1 = 1 For program selection in the Program Manager, an automatic change is not made into
the Machine operating area.
When changing over the operating mode via the machine control panel, an automatic
change is not made into the Machine operating area.
Bit 2 = 1 For program selection in the Program operating area, an automatic change is not made
into the Machine operating area.
Bit 3 = 1 When selecting a program/executing a program in the Program operating area, the block
search is not automatically started.
8.1 Setting the font size of the actual value display
Setting font size

The actual values for the machine coordinate system or workpiece coordinate system can be
displayed in two different font sizes in the "Machine" operating area.
Using a channel machine data item, you can set how many axes should be displayed in a
larger font.
MD52010 $MCS_DISP_NUM_AXIS_BIG_FONT Number of actual values with a large

font
=3 Number of actual values with a larger font (default setting)
8.2 Inserting a user-specific logo
OEM-specific logo
The Siemens logo is visible in the header of the "Machine" operating area.

Customizing the "Machine" operating area
8.3 Configuring the display of the G-code groups
You can replace the Siemens logo with your own logo.
Procedure:
1. Name your own logo "logo.png".
Note
The file name must not contain any lower case letters.
2. Save your own logo depending on the bitmap size, in one of the directories: /oem/sinumerik/
hmi/ico or /user/sinumerik/hmi/ico
Directory Bitmap size

/Ico640 122 x 19
/Ico800 160 x 24
/Ico1024 199 x 30
8.3 Configuring the display of the G-code groups

The "G-functions" pane is visible in the "Machine" operating area.
Up to a maximum of 16 G-code groups are displayed in this pane. Configure the
"slmagcodeconfig.ini" file accordingly to determine which G-code groups should be displayed,
and where.
Configuring G-code groups
Section Meaning
Selected G groups This area is intended for operation of the controller in Siemens mode.
Selected G groups ISO This area is intended for operation of the controller in ISO mode.
mode
Enter the G-code group and position as follows:
SelectedGGroupN = M
N Position where G-code group M will be displayed.
If you want to leave a position empty, omit the number (M), e.g. "SelectedGGroup1 = "
M The number of the G-code group to be displayed at position N
Structure of the file
[Selected G-Groups]
SelectedGGroup1 = 1
SelectedGGroup2 = 2
SelectedGGroup3 = 3

8.4 Configuring the channel operational message
SelectedGGroup4 = 4
SelectedGGroup5 = 5
SelectedGGroup6 = 6
SelectedGGroup7 = 7
SelectedGGroup8 = 8
SelectedGGroup9 = 9
SelectedGGroup10 = 11
[Selected G-Groups ISO-Mode]
... (as with section for Siemens)
Procedure
1. Copy the "slmagcodeconfig.ini" file from the folder
/siemens/sinumerik/hmi/template/cfg.
2. Place the file in the following directory: /oem/sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg.
As soon as the file is located in the user-specific directory, the entries for this file take
precedence over the Siemens file. If an entry is missing in a user-specific file, the
corresponding entry from the Siemens file is used instead.
3. Open the file and enter the number of the G code in question at the required position
"SelectedGGroup1 = 5".
I.e. the 5th G code group will be displayed at the 1st position.
Overview
The channel operational messages are displayed in the third line of the header in the "Machine"
operating area. There are two types of channel operational messages:
1. Channel operational messages that require an operator action to continue a program, e.g.
feed enable missing, M01 active.
The channel operational messages are identified by exclamation marks.
2. Channel operational messages that do not require an operator action to continue a program.
A stop condition is active for a length of time (>1 s) and is interrupted by the program
processing, e.g. dwell time active, waiting for tool change.
The channel operational message is identified by a clock icon and disappears after a certain
time.

File
The settings for this are specified in the "slmahdconfig.ini" file.
Configuring the channel operational message
Section Meaning
CondStopIcons Specification of an icon that is to be displayed with a certain channel operational
message.
If no icon is specified for a certain channel operational message, then the icon
specified for "DefaultIcon" is displayed.
CondDelayTime Specification of how long (in milliseconds) a certain message must be present
before it is displayed.
● If no time is specified for a certain channel operational message, then the time
specified at "CondDelayTime" is used.
● If the channel operational message is to be displayed immediately, "0" must
be specified as time.
Procedure
1. Copy the "slmahdconfig.ini" file from the /siemens/sinumerik/hmi/template/cfg directory.
2. Place the file in the following directory: /oem/sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg.
3. Open the file and make the required settings.
"slmahdconfig.ini" file
Standard configuration
[CondStopIcons]
Default icon = condwait.png
1 = condstop.png ; No NC ready
2 = condstop.png ; No mode group ready
3 = condstop.png ; EMERGENCY STOP active
4 = condstop.png ; Alarm with stop active
5 = condstop.png ; M0/M1 active
6 = condstop.png ; Block in SBL mode terminated
7 = condstop.png ; NC stop active
8 = condstop.png ; Read-in enable missing
9 = condstop.png ; Feed enable missing
10 = condwait.png ; Dwell time active
11 = condwait.png ; Aux. function acknowledgment missing
12 = condstop.png ; Axis enable missing
13 = condwait.png ; Exact stop not reached

14 = condwait.png ; Waiting for positioning axis

15 = condwait.png ; Waiting for spindle
15 = condwait.png ; Waiting for other channel
17 = condstop.png ; Waiting for feedrate override
18 = condstop.png ; Error in NC block
19 = condstop.png ; Waiting for external NC blocks
20 = condwait.png ; Waiting for synchronized action
21 = condwait.png ; Block search active
22 = condstop.png ; Spindle enable missing
23 = condstop.png ; Axis feedrate override
24 = condwait.png ; Waiting for tool change acknowledgment
25 = condwait.png ; Gear step change
26 = condwait.png ; Waiting for position control
27 = condwait.png ; Waiting for thread cut
28 = condwait.png ; Reserved
29 = condwait.png ; Waiting for punching
30 = condwait.png ; Waiting for safe operation
31 = condwait.png ; No channel ready
32 = condstop.png ; Oscillation active
33 = condwait.png ; Axis replacement active
34 = condwait.png ; Axis container rotation
35 = condwait.png ; AXCT: Following axis active
36 = condwait.png ; AXCT: Leading axis active
37 = condwait.png ; AXCT: Follow-up active
38 = condwait.png ; AXCT: Internal status change
39 = condwait.png ; AXCT: Axis/spindle disable
40 = condwait.png ; AXCT: Corr. motion active
41 = condwait.png ; AXCT: Axis replacement active
42 = condwait.png ; AXCT: Axis interpolator active
43 = condwait.png ; Waiting for compile cycle
44 = condwait.png ; Access to system variable
45 = condstop.png ; Search target found
46 = condwait.png ; Rapid retraction started
47 = condwait.png ; AXCT: Wait for spindle stop
48 = condwait.png ; Machine data match
49 = condwait.png ; Axis replacement: Axis coupled
50 = condwait.png ; Axis replacement: Liftfast active
51 = condwait.png ; Axis replacement: New config active
52 = condwait.png ; Axis replacement: AXCTSW active
53 = condwait.png ; Axis replacement: Waitp active
54 = condwait.png ; Axis in another channel
55 = condwait.png ; Axis replacement: Axis is PLC axis

56 = condwait.png ; Axis replacement: Axis is oscillating axis

57 = condwait.png ; Axis replacement: Axis is Jog axis
58 = condwait.png ; Axis replacement: Command axis
58 = condwait.png ; Axis replacement: Axis is OEM axis
60 = condwait.png ; Coupled following axis
61 = condwait.png ; Coupled-motion following axis
62 = condwait.png ; Coupled slave axis
63 = condstop.png ; Stop at cycle end M0
64 = condstop.png ; Stop at cycle end M1
65 = condwait.png ; Wait: Axis is at fixed stop
66 = condwait.png ; Master-slave switchover active
67 = condwait.png ; Axis replacement: Axis is single axis
68 = condstop.png ; Stop: Target reached after block search
69 = condwait.png ; Synchronism: Synchronous spindle
70 = condwait.png ; Deactivation position synch. spindle
71 = condwait.png ; Waiting for transformer axis enable
72 = condstop.png ; Waiting because of possible collision
73 = condstop.png ; Jog: Position reached
74 = condstop.png ; Jog: Direction blocked
75 = condwait.png ; Brake request
76 = condwait.png ; Wait: G4 still: U
77 = condstop.png ; Axial feed disable from PLC
78 = condstop.png ; Waiting for axial feed enable
79 = condwait.png ; Axial feed disable from SYNACT
80 = condwait.png ; Waiting for master spindle speed
81 = condwait.png ; Waiting for parameter set change
82 = condwait.png ; Waiting for end of motion before
transformation change
83 = condwait.png
84 = condwait.png
85 = condwait.png
[CondDelayTime]
Default delay time = 1000
1 = 0 ; No NC ready
2 = 0 ; No mode group ready
3 = 0 ; EMERGENCY STOP active
4 = 0 ; Alarm with stop active
5 = 0 ; M0/M1 active
6 = 0 ; Block in SBL mode terminated
7 = 0 ; NC stop active
8 = 0 ; Read-in enable missing

8.6 Activating the "Teach In" function
9 = 0 ; Feed enable missing

10 = 0 ; Dwell time active
12 = 0 ; Axis enable missing
16 = 0 ; Waiting for other channel
17 = 0 ; Waiting for feedrate override
18 = 0 ; Error in NC block
19 = 0 ; Waiting for external NC blocks
22 = 0 ; Spindle enable missing
23 = 0 ; Axis feedrate override
32 = 0 ; Oscillation active
45 = 0 ; Search target found
76 = 0 ; Wait: G64 still U
8.5 Deactivating program test

There are several program test options to test and run-in a part program that are executed
using the "Program Test" function.
This function is active as standard. You can select the program test in the "Machine" operating
area, in the "Program control" window and using the "PRT" check box.
Deactivating the program test

You can deactivate the program test using the following configuration machine data. "PRT" is
no longer displayed in the status line.
MD51039 $MNS_PROGRAM_CONTROL_MODE_MASK Options for machine - program

control
Bit 0 = 0 Function program test not available
The test option is described in the following documentation:
References
Function Manual, Basic Functions, Mode Group, Channel, Program Operation, Reset Behavior
(K1)
Activate TEACH IN
The TEACH IN function is activated in part via the general configuration machine data.

Settings
MD51034 $MNS_TEACH_MODE
Bit 0 = 1 The "Teach progr." softkey is displayed. The approached position is accepted into the
program with the "Accept" softkey, default value.
Bit 1 = 1 The acceptance of the teach-in block can be blocked by the PLC.
DB19.DBX13.0 = 0 Block is accepted
DB19.DBX13.0 = 1 Block is not accepted
Access to the function still depends on access rights.
MD51045 $MNS_ACCESS_TEACH_IN Protection level TEACH IN

=7 The protection level for the execution of traversing movements to MDA buffer / part
program for TEACH IN is specified, default value.
MD51050 $MNS_ACCESS_WRITE_PROGRAM Protection level write part program

=7 The protection level for writing part programs is specified, default value.
Set the channel-specific machine data:
MD20700 $MC_REFP_NC_START_LOCK NC-Start disable without reference point

=0
Activating TEACH IN
1. Set the machine data and initiate a reset.
2. Now change into the "AUTO" and "MDA" operating mode.
3. Select the TEACH IN machine function.
4. Press the "Teach prog." softkey.
TEACH IN not active

If the "Prog. teach in" softkey is not active, the reasons can be as follows:
● The program is not in the stop, reset or interrupt state.
● Not all of the axes that require referencing are referenced.
Accept STAT and TU

If you wish to accept the joint position of the machine and the rotary axes in the traversing
block, then activate the "STAT" and "TU" checkboxes.
In order that the checkboxes are displayed, set the following general configuration machine
data:
MD51032 $MNS_STAT_DISPLAY_BASE Number base for display of the joint position STAT
=2 Binary display, joint position STAT (standard)

8.7 Block search
MD51033 $MNS_TU_DISPLAY_BASE Number base, display of the rotary axes TU posi‐

tion
=2 Binary display, position of the rotary axes TU (standard)
The following machine data have a similar effect, but it is channel-specific effect in this case:
MD52032 $MCS_STAT_DISPLAY_BASE Number base for display of the joint position STAT
=0 Value from MD51032 effective
If the value from MD52032 is > 0, MD51032 is ignored for this channel.
MD52033 $MCS_TU_DISPLAY_BASE Number base, display of the rotary axes TU posi‐

tion
=0 Value from MD51033 effective
If the value from MD52033 is > 0, MD51033 is ignored for this channel.
The possible input values (values > 0) in MD52032 and MD52033 correspond to MD51032
and MD51033.
For further information about STAT and TU, please refer to the following documentation:
References
Extended Functions Function Manual; Kinematic Transformation (M1)
Section "Cartesian PTP travel."
8.7 Block search
8.7.1 Activating block search mode
Block search mode settings

The following machine data can be used to set the possible variants for the block search with
G-code programming:
MD51028 $MNS_BLOCK_SEARCH_MODE_MASK Bit mask for the available search modes

Bit 0 = 1 Block search with calculation, without approach
Bit 1 = 1 Block search with calculation, with approach
Bit 4 = 1 Block search without calculation
Bit 5 = 1 Block search with test run

8.8 Multi-channel support
The following machine data can be used to set the possible variants for the block search in a
JobShop program (ShopMill, ShopTurn):
MD51024 $MNS_BLOCK_SEARCH_MODE_MASK_JS Bit mask for the available search modes

(ShopMill, ShopTurn, single-channel)
Bit 0 = 1 Block search with calculation, without approach (default setting)
Bit 1 = 1 Block search with calculation, with approach
Notice:
In a ShopMill/ShopTurn program, the search is performed only on G code-blocks.
Bit 3 = 1 Skip EXTCALL programs
Bit 5 = 1 Block search with test run
Note
The "Block search mode" softkey is only displayed, if, in the machine data MD51024 or
MD51028, more than one version for the block search has been defined; for example "Block
search with calculation without approach" and "Block search with calculation with approach".
When so doing, take into account that the search versions set active in the "Block search
mode" window are also referred to the program.
8.7.2 Accelerated block search for execution from external

The accelerated block search function allows you to run the part program forward until you
reach the block you require.
Settings
If you activate the "Skip EXCALL" function, then you must set the following general
configuration machine data:
MD51028 $MNS_BLOCK_SEARCH_MODE_MASK Bit mask for the available search modes

Bit 3 = 1 (33H to 3BH)
For an external main program, a block search without calculation is always a fast block search.
Only the blocks from the search position are loaded.

In the "Machine" operating area, up to any four channels of a mode group can be displayed
side by side. The number of channels is dependent on the display size and resolution of the
operator panel used.

Using the multi-channel editor, for a multi-channel machine, you can open, change or generate
programs simultaneously that are independent of one another from a time perspective. In this
case, the programs involved are displayed next to one another in the editor.
Further, you have the option of simulating the programs before they are actually processed at
your control.
In addition, you can align the programs according to synchronization points.
Precondition
● Multi-channel data only involve machines where the first technology is turning.
● For multi-channel machine, the following data must be the same for all channels:
– Measurement unit
– Work offset (e.g. G54)
– Z value of the work offset (optional)
– Blank
– Speed limitation
● Further, the following JobShop-specific data must be the same for all channels:
– Retraction plane (one each for the main and counterspindle)
– Tailstock (one each for the main and counterspindle)
– Tool change point (one each for the main and counterspindle)
– Safety clearance
– Climbing/ and conventional
Creating a multi-channel program

For multi-channel machining, you require a job list with the following data:
● Program names
● Program type
● G code
● ShopTurn program
● Channel assignment
Software option
You require the "ShopMill/ShopTurn" option to generate and edit ShopTurn/
ShopMill programs.
After you have created a job list, in the "multi-channel data" parameter screen, you can combine
the data from the G code and JobShop, which is then saved as cycle call in the job list. The
"multi-channel data" parameter screen is displayed as soon as at least one ShopTurn program
is contained in a job list.

8.9 Manual machine
Only programming G code programs

If the job list only contains G code programs, then you can deactivate the "multi-channel data"
function. To do this, set the following machine data:
MD51228 $MNS_FUNCTION_MASK_TECH Cross-technology function mask

Bit 0 G code programming without multi-channel data
= 1 Multi-channel data are not listed for job lists that only contain G code programs. The "multi-
channel data" softkey is not displayed.
8.9 Manual machine
General information
"Manual machine" allows you to work with large cycles in manual mode without having to write
programs especially for this purpose.
Software option
You require the following software option in order to use this function:
"ShopMill/ShopTurn"
Activation
MD52212 $MCS_FUNCTION_MASK_TECH Cross-technology function mask

Bit 8 Manual machine (ShopMill/ShopTurn)
Enables
MD52214 $MCS_FUNCTION_MASK_MILL Milling function screen

Bit 5 Enable spindle control, tool spindle
= 0 via the NC/PLC interface
= 1 via the user interface
Bit 6 Enable spindle control, rotating spindle
MD52218 $MCS_FUNCTION_MASK_TURN Turning function screen

Bit 3 Enable spindle control, main spindle
Bit 4 Enable spindle control, counterspindle

8.9 Manual machine
Bit 5 Enable spindle control, tool spindle

SD43200 $SA_SPIND_S Speed for spindle start using NC/PLC

interface signal; value outputs using
the operating software
SD43202 $SA_SPIND_CONSTCUT_S Cutting speed for spindle start using
NC/PLC interface signal; value outputs
using the operating software
SD43206 $SA_SPIND_SPEED_TYPE Spindle speed pipe for spindle start us‐
ing NC/PLC interface signal; value out‐
puts using the operating software
Additional parameter assignments

We recommend the following additional parameter assignments:
Handwheel
MD11346 $MN_HANDWH_TRUE_DISTANCE = 3 Handwheel path or velocity specifica‐
tion
MD11602 $MN_ASUP_START_MASK bit 0, 3 =1 Ignore stop conditions for ASUB
MD20150 $MC_G_CODE_RESET_VALUE [7] = 2 Delete position of the G groups; run-up
G54 active
MD20624 $MC_HANDWH_CHAN_STOP_COND = 0xFFFF Definition of the behavior of traveling
with handwheel, channel-specific
MD32084 HANDWH_STOP_COND = 0x7FF Behavior, handwheel travel
MD52212 FUNCTION_MASK_TECH Bit 9 = 1 Function screen form across technolo‐
gies; work offset via softkey
Note
If, in machine data MD52212 FUNCTION_MASK_TECH bit 9 is set, the "WO selection" softkey
is displayed in the "Work Offset – G54 … G599" window.
Working area limits

MD28600 $MC_MM_NUM_WORKAREA_CS_GROUPS > 0 Number of coordinate system-specific
working area limits
MD20150 $MC_GCODE_RESET_VALUES[59] = 2 Delete position of the G groups; acti‐
vate working area limits of the group
Note
If $MC_GCODE_RESET_VALUES[59] = 2 is set in the MD20150 machine data, the "Limit
stops" softkey is displayed in the "Manual Machine" window. This requires that
$MC_MM_NUM_WORKAREA_CS_GROUPS also has the value 1 for MD28600.

8.10 User status display (OEM)
Feedrate
SD42600 $SC_JOG_FEED_PER_REV_SOURCE = -3 Revolutional feedrate control in JOG
mode
SD43300 $SA_ASSIGN_FEED_PER_REV_SOURCE [X ax‐ Revolutional feedrate for positioning
is] = -3 axis X
SD43300 $SA_ASSIGN_FEED_PER_REV_SOURCE [Z ax‐ Revolutional feedrate for positioning
is] = -3 axis Z
Note
Ensure that the axis-specific setting data SD43300 SA_ASSIGN_FEED_PER_REV_SOURCE
are set the same.
References
● Operating:
Operating Manual, Turning/Milling, Chapter "Working with a manual machine"
● Programming:
Programming Manual, Fundamentals; Chapter "Working area limit"
Function
User icons can be displayed in the Machine operating area in the second line in the header.
In this case, the program name is displayed in the right-hand field of the third line in the header.
Active hold conditions hide the program name.
The display of the user icons is controlled via PLC bits. The icons are provided in the form of
PNG files and stored resolution-specifically in the file system at: /user/sinumerik/hmi/
ico/ico640, etc. Maximum 16 positions are available in the header to display the user icons.
Configuration
The user icons are configured in the slmahdconfig.ini file in Section [UserIcons]. The
following data is required:
● The start address of the PLC double word with the bits to control the display of the user
icons.
● For each bit used, the file name of the icon and the position at which the icon should be
displayed.

Alternatively, you can use the following parameters for the definition:
● USER_ICON_BASE
This means that 32 bits are available with UI_0 (highest bit) to UI_31 (lowest bit).
Example: USER_ICON_BASE=DB80.DBB0
⇒ UI_0 = DB80DBX3.0 and UI_31 = DB80.DBX0.7
● USER_ICON_BASE256
This means that 256 bits are available with UI_0 (highest bit) to UI_255 (lowest bit).
Example: USER_ICON_BASE256=DB19.DBB80
⇒ UI_0 = DB19.DBX111.0 and UI_255 = DB19.DBX80.7
Example
[UserIcons]
USER_ICON_BASE=DB19.DBB80
; set the start byte of the PLC double word that displays the icons (DB19.DBD80)
UI_0 = icon1.png,4
; show icon1.png on position 4 if bit 0 (DB19.DBX83.0) is set
UI_1 = icon2.png,6
; show icon2.png on position 6 if bit 1 (DB19.DBX83.1) is set
Superimposition
With a non-unique selection (bits for multiple identifiers whose image is to be displayed at the
same position):
The image with the lower identifier number is superimposed with the image with the higher
identifier number for the same position. Non-unique selection can also be used with less than
16 active selection bits. The PLC can deliberately use this superimposition to overlay less
important displays (with lower identifier numbers) with important displays (high identifier
numbers).
Note
If two HMI applications are assigned to one NC/PLC unit (M:N), the PLC must first determine
from the interface which of the HMI interfaces is active. Icons can be requested by the PLC
for the active HMI application only.
Possible applications
With a unique selection, a maximum of 16 bits are set simultaneously in the four selection
bytes for each of the different positions.
● 32 alternative images for a position, each selected with a different bit (currently only one
active selection bit)
● Two alternative images for each of the permissible 16 positions, each position requires two
of the 32 selection bits (maximum 16 active selection bits at any one time)

● Combination thereof with a maximum total of 32 images for the maximum 16 positions
(maximum of 16 active selection bits at any one time)
● More than 16 selection bits.
Configuring OEM texts

Machine manufacturers can display their own texts in the program directory and program name
lines. These texts cannot include % parameters as is possible in user texts. The lines are
divided into <OEM_NUMBER_TEXTFIELD> areas according to the entry in HEADER.INI.
The data is provided in a user data block. The number of the data block and the exact offset
are declared in the HEADER.INI file. The following entries are available in the [OEMTextInfo]
section for this purpose:
[OEMTextInfo]
OEM_NUMBER_TEXTFIELD = 1 ; maximum of 3 text fields per line
OEM_TEXT_BASE = DBx.DBBy
The interface in the user DB has the following format:
Start-DBB byte Bit0=1: there is something to do

or All bits=1: job is acknowledged by HMI
Start-DBB +18 byte All bits=0: PLC can write to interface again.
Start-DBB +1 word Offset for text from alpu_xx.com to be displayed;
or 700 000 is the base address and is always summed internally.
Start-DBB +19 word All bits=0: Delete line
Start-DBB + 3 string
or String containing a maximum of 12 characters
Start DBB+20 double Word
The first parameter contains an offset for a text number with a base of 700,000 (user PLC
texts). If this parameter = 0, the corresponding line is deleted. The second parameter contains
a maximum 12-character string. Unless empty, this text is output instead of the user PLC text.
The parameters must be written from "back to front" in the PLC, i.e. all parameters must be
initialized before the first byte is set. The data for the next line is located exactly 18 bytes after
the start byte. The lines are output from left to right; a maximum of three output fields per line
are provided (i.e. a total of six fields are possible).
A hotlink to the first byte for each line is set up in the operating software. If a change occurs
in that byte, the operating software responds. If the operating software displayed the data, it
writes a -1 to the first variable. The operating software is informed about this change by means
of the hotlink, whereupon it writes a 0 to this variable.
The HMI itself does not have to react to this change. The PLC can only write data to the
interface again if the variable is set to 0. This mechanism ensures that the operating software
knows about all parameter changes.

8.12 Activate machining time recording
Configuring OEM icons

OEM icons indicating the machine state can be output in the field provided for the program
control display (e.g. SBL, M01, etc.). If OEM icons are defined, the elements for the program
control display are hidden.
The icon names are identified in the HEADER.INI configuration file, similar to user icons:
[OemIcons]
OI_0= <name.png>, <position>
...
OI_31= <name.png>, <position>
Here, <name> is the file name of the bit map and <Position> is the output position (from 1 to
16) in the display line. Multiple bit maps can be output at the same position. If more than one
bit map is active simultaneously at the same position, the bit map with the highest screen
number is displayed.
The output is controlled by means of a PLC double word. This double word is declared in the
next section in the HEADER.INI file:
[OemIcons]
Oem_ICON_BASE = DBx.DBBy
Each bit in this double word represents exactly one OEM icon corresponding to the screen
number. Thus, if bit 0 is set, bit map OI_0 is displayed. If a bit is reset, the associated bit map
is deleted.
A maximum of 16 icons can be displayed, enabling a total of 16 display positions. Empty
positions need not be specified.
8.11 Configuring the offset display
Configuring the screen display

The screen display for offset can be configured using the following channel-specific machine
data:
MD52210 $MCS_FUNCTION_MASK_DISP Function screen display

Bit 14 Display DRF offset under Machine
Bit 15 Display tool offset ($AA_TOFF) under Machine

If you want to record and store the machining time in Automatic mode, you can make the
settings on the user interface.

You will find additional information about making these settings in the following document:
References
Universal/Turning/Milling/Grinding Operating Manual
● Section "Machining a workpiece" > "Settings for Automatic mode mode"
● Section "Machining a workpiece" > "Editing a program" > "Settings for the editor"
Switching on the time recording

To be able to make use of the function, the following machine data must be set:
MD18370 $MN_MM_PROTOC_NUM_FILES[1] Maximum number of log files

=2 For OEM applications
MD18371 $MN_MM_PROTOC_NUM_ETPD_STD_LIST[1] Number of standard ETPD data lists

=6 Number of standard data lists in the OPI module ETPD that are needed for Trace system
functions.
MD28300 $MC_MM_PROTOC_USER_ACTIVE[1] Activate logging for one user

=1 For system functions
MD28302 $MC_MM_PROTOC_NUM_ETP_STD_TYP[1] Number of ETP standard event types

=5 Number of standard event types in the OPI module ETP that are needed
Note
Machine data MD18370, MD18371, and MD28302 are still valid for machining time recording
when they are assigned higher values.

Simulation and simultaneous recording 9
9.1 Simulation overview
Software option
You require the "3D simulation 1 (finished part)" option
for the 3D representation of the simulation.
Simulation is supported with its own program interpreter (SNCK) and a separate simulation-
data environment in SINUMERIK Operate. The SNCK considers the complete syntax of the
SINUMERIK control family, including the possibility of incorporating special user options on
the machine by comparing data with the NC environment. The simulation data can be matched
statically as required with the NC environment (initialization data, macros, user data, tool data,
machining cycles) or also dynamically when tool data or machining cycles are changed.
Machining simulations, with emphasis on the drilling, milling, turning and grinding technologies,
can be performed in the workpiece coordinate system for certain machine kinematics on the
user interface of the controller:
● The simulation of the finished part is performed with the real NC data.
● The NC data is automatically compared at each change of the part program.
● The simulation allows a dynamic representation of the machining, even for active 5-axis
transformation (TRAORI) and swiveled planes.
● Turning on milling machines.
● Simulation of a machining channel for conventional milling machines.
● Simulation of up to four machining channels for turning machines with B axis.
● Intelligent determination of the block times and the program execution time.
● Very fast graphical representation through the continuous refinement of the workpiece.
● Optimum resolution for each selected picture area.
● Any sections are possible.
● In parallel to the machining of one workpiece, the machining of another workpiece can be
simulated (as of NCU 720.x).
● 3D representation of simulation (option).
General conditions for the simulation

● Very fast simulation result, this means, however, low dynamic resolution.
● For complex representations, fine recording is too slow or does not run for very complex
parts.
● "Quickview" for mold-making part programs.
● The simulation cannot be used for compile cycles with special kinematics.

Simulation and simultaneous recording
9.1 Simulation overview
● Compile cycles are supported only to a limited extent.

● Blank CAD data cannot be imported (for example, for castings).
● Couplings cannot be simulated (coupled motion, axial master-value coupling, electronic
gearbox):
– Coupled motion: TRAILON(<following axis>, <leading axis>, <coupling factor>)
– Axial master-value coupling: LEADON(Faxis, LAxis, curve table n) actual value and
setpoint coupling
– Electronic gearbox: EGDEF(FA, LA1, coupl.1, LA2, coupl.2, ... LA5, coupl.5), EGON,
EGONSYN, EGONSYNE
● Reference point approach G74 is not operative during simulation
● The following is not supported:
– Axis container
– Dependencies on part programs and PLC
– Multiple clamping
– CNC function Synchronized actions for safe programmable logic (SPL) in the NC
● Different technologies in different channels with different axis coordinate systems are not
fully supported.
● A 3D simulation is not possible for the grinding technology.
● The software limit switches are not evaluated:
In a manufacturer cycle for the tool replacement, the "Software limit switch + the Z axis"
machine data is used as replacement position:
G0 Z=$MA_POS_LIMIT_PLUS[Z]-0.1
However, not this position but the machine data default setting = 1e8 = 100,000,000 is used
in simulation. This default position is traversed in the simulation. This makes the simulation
very slow and causes the machining time to explode, e.g. 555 hours rather than 2 minutes.
● Program start in the simulation:
If MD22622 $MCS_DISABLE_PLC_START is set in a channel, then the channel is not
automatically started in the simulation. It can then only be started from another channel
using the part program command "START". This function is not available for the
SINUMERIK 828D.
● Alarm display in the simulation:
Alarms are output in the simulation exactly the same way as alarms in the normal program
execution, but no more than five alarms are displayed (above the graphic, to distinguish
them from the machine alarms).
If a different error signaling behavior (e.g. syntax error) occurs between simultaneous
recording and simulation, then, for example, the reason can be due to the hardware access
operations in the programming. The simulation does not access the hardware, however,
internally it reads the input with 0 and is then exited. On the other hand, for simultaneous
recording, an alarm is output.

9.2 Setting the technology for simulation
Turning technology
Examples of machine kinematics:
● Conventional turning with two geometry axes
● Three spindles: Main spindle, counterspindle, tool spindle
● Counterspindle slides, tailstock as NC axis
● B axis: Aligning turning tools in the tool spindle
● Milling with geometry axes: TRANSMIT, TRACYL, TRAANG
Machine data for the turning technology:
MD52200 $MCS_TECHNOLOGY = 1 Turning technology

MD52000 $MCS_DISP_COORDINATE_SYSTEM = 34 Position of the coordinate system (exam‐
ple)
Milling technology
Examples of machine kinematics:
● Milling with five axes: Swivel/TRAORI
● Swivel head change
Machine data for the milling technology:
MD52200 $MCS_TECHNOLOGY = 2 Milling technology

MD52000 $MCS_DISP_COORDINATE_SYSTEM = 0 Position of the coordinate system (example)
Grinding technology
Machine data for the grinding technology:
MD52200 $MCS_TECHNOLOGY = 3 Cylindrical grinding technology

MD52200 $MCS_TECHNOLOGY = 4 Surface grinding technology
MD52000 $MCS_DISP_COORDINATE_SYSTEM = 0 Cylindrical grinding and surface grinding
with moving column (example)
MD52000 $MCS_DISP_COORDINATE_SYSTEM = 6 Surface grinding with table machine (exam‐
ple)
Meaning of the axes
MD52206 $MCS_AXIS_USAGE[n] Meaning of the axes in the channel

[n] channel axis number
=0 No special meaning
=1 Tool spindle (driven tool)

=2 Auxiliary spindle (driven tool)

=3 Main spindle (turning)
=4 C axis of the main spindle (turning)
=5 Counterspindle (turning)
=6 C axis of the counterspindle (turning)
=7 Linear axis of the counterspindle (turning)
=8 Tailstock (turning)
=9 Back rest (turning)
Enter the direction of rotation for the rotary axes that are not configured in a toolholder or a 5-
axis transformation via the following channel-specific machine data.
MD52207 $MCS_AXIS_USAGE_ATTRIB[n] Attributes of the axes

Bit 0 Rotation around 1st geometry axis (for rotary axes)
Bit 1 Rotation around 2nd geometry axis (for rotary axes)
Bit 2 Rotation around 3rd geometry axis (for rotary axes)
Bit 3 Reversal of direction of rotation (for rotary axes)
The MD52290 $MCS_SIM_DISPLAY_CONFIG machine data acts only on the OP019. It has
no significance for SINUMERIK 828D.
MD52290 $MCS_SIM_DISPLAY_CONFIG Position of the status display of the channel in the

simulation.
Bit 0 Upper left-hand corner
Bit 1 Upper right-hand corner
Bit 2 Lower left-hand corner
Bit 3 Lower right-hand corner
In the channel-specific machine data, for at least one geometry axis per channel, enter a value
other than 0.0, e.g. 0.001. If the value is 0.0, the system assumes that this parameter has still
not been set.
MD53230 $MCS_SIM_START_POSITION Axis position when starting the simulation

Simulation is only possible if a value not equal to 0 has been set for at least one geometry axis.
Deactivating simulation
The following machine data must be set to deactivate the simulation:
MD51226 $MNS_FUNCTION_MASK_SIM Simulation function screen

Bit 1 = 1 Deactivate simulation
Bit 10 = 1 Hide zero point symbol

9.3 Simultaneous recording overview
9.3 Simultaneous recording overview
Software option
You require the option "Simultaneous recording (real-time simulation)"
for the "Simultaneous recording" function.
Software option
You require the "ShopMill/ShopTurn" option to display the tailstock
Software option
You require the "3D simulation 1 (finished part)" option
for the 3D representation of the simultaneous recording function.
During machining, the tool paths can be simultaneously recorded on the display of the
controller in a three-side view or 3D view. Workpiece graphics and views correspond to the
graphic simulation.
Note
To prevent an incomplete representation, you must activate the simultaneous recording prior
to the NC start.

9.4 Clamping a blank
Example: Activating the tailstock representation in the spindle chuck data

Procedure:
1. Make the tailstock visible by making the selection in the program.
2. Specify the tailstock dimensions:
Select in the operating area "Parameters" → "Setting data" → "Spindle chuck data", and
enter the "ZR" and "XR" parameters for the tailstock length and tailstock diameter.
The tailstock dimensions are written into the following machine data:

Bit 2 = 1 Tailstock enable:
The tailstock becomes visible if selected in the "tailstock" program.
MD53240 $MAS_ SPINDLE_PARAMETER[i] Spindle chuck data in mm

[0]: Chuck dimension
[1]: Stop dimension
[2]: Jaw dimensions
MD53241 $MAS_ SPINDLE_CHUCK_TYPE Spindle jaw type

0 = clamp from the outside
1 = clamp from the inside
MD53242 $MAS_TAILSTOCK_PARAMETER[i] Tailstock data in mm

[0]: Tailstock dimension
[1]: Tailstock length
Activating the machining time display

Timers are provided as system variables in the Program runtime function. While the NC-
specific timers are always activated (for time measurements since the last controller power-
up), the channel-specific timers must be started via the following channel-specific machine
data.
MD27860 $MC_PROCESSTIMER_MODE Activate the program runtime measurement.

Bit 0 = 1 The measurement of the total runtime for all part programs is active
($AC_OPERATING_TIME).
Bit 1 = 1 The measurement of the actual program runtime is active
($AC_CYCLE_TIME).
Bit 4 = 1 Measurement also during active dry run feedrate.
Bit 5 = 1 Measurement also during program test.

The blank clamping function allows you to select and specify in more detail the clamping
location for the blank.
You require this function if your machine satisfies one or more of the following requirements:

Requirements
● The machine has several clamping options available for selection.
● The machine has a clamping option that does not point in the Z direction as standard (e.g.
a boring mill).
Under the following circumstances, you can specify the position and orientation of the rotary
axes in the machine data MD53220 and MD52207:
● The position and orientation of the rotary axis is offset against the MCS zero point, but not
specified by a tool holder or a TRAORI.
● In a turning machine, the reference points of the main spindle or counterspindle are offset
against the MCS zero point in X or Z.
● The counterspindle cannot be traversed with a saddle, but rather is at a fixed position.
In order that for simulation / simultaneous recording, the rotary axes are displayed at the correct
location, their positions in the machine coordinate system must be specified using the following
machine data:
MD53220 $MAS_AXIS_MCS_POSITION[n] Position of the axis in the MCS

[n] 0 = X, 1 = Y, 2 = Z
For further information about the transformation of a rotary axis, see Chapter"Configuring
cycles (Page 465)".
Function
Set the following channel-specific machine data:
MD52207 $MCS_USAGE_ATTRIB[n] Attribute of the axes in the channel

Bit 0 Rotation around the 1st geometry axis (for rotary axes)
Bit 1 Rotation around the 2nd geometry axis (for rotary axes)
Bit 2 Rotation around the 3rd geometry axis (for rotary axes)
Bit 8 Offer rotary axis for blank clamping (on milling machines)

Bit 1 Offer fixed table for blank clamping (on milling machines)
Take the machine configuration for MD20080 from the example.

Function options
In the program header, a blank can be optionally set to A, B, C and table clamping:
Clamping View Machine data

A axis MD52207 $MCS_USAGE_ATTRIB bit 0 and bit 8 = 1
B axis MD52207 $MCS_USAGE_ATTRIB bit 1 and bit 8 = 1
C axis MD52207 $MCS_USAGE_ATTRIB bit 2 and bit 8 = 1
Table MD52214 $MCS_FUNCTION_MASK_MILL bit 1 = 1
Note
To obtain the selection option in the program header, two rotary axes must be defined for the
raw part clamping.

Example for the machine configuration

Example for a machine configuration when the A axis should rotate at the X axis:
63 =
<
&
MD20080 $MC_AXCONF_CHANAX_NAME_TAB[n] Channel axis name in channel [n]

[0] X
[1] Y
[2] Z
[3] Spindle
[4] A
[5] C
MD52207 $MCS_USAGE_ATTRIB[4] Attribute of rotary axis A in channel 4

= 181H
Bit 0 = 1 Rotation around the 1st geometry axis (for rotary axes)
Bit 8 = 1 Offer rotary axis for blank clamping (on milling machines)
References
Operating Manual, Milling
● Chapter "Create ShopMill program" > "Program header"
● Chapter "Create ShopMill program" > "Change program settings"


Spindle functions 10
10.1 Spindle control
You can select from the following spindle control settings:
End of program
The following M functions are used for the end of program:
M function from Main program end Spindle continues

MD10714 $MN_M_NO_FCT_EOP to run
M2, M30 End of main program and return jump to Spindle stops
beginning of program
M17 End of subprogram and return jump into Spindle continues
the main program to run
If machine data MD10714 $MN_M_NO_FCT_EOP is not equal to zero, then a distinction is

made between M2 / M30 (program end of an NC program) and the M function set in
MD10714 $MN_M_NO_FCT_EOP.
Example
MD10714 $MN_M_NO_FCT_EOP = 32 means "M32" for the program end of a program
generated in the "JOG" or "MDA" operating mode.
Among other things, this functionality is required in order to continuously start the spindle in
manual operation (e.g. for scratching).
Configuring keys
If you implement a manual control using the keys on the machine control panel, then this is
realized via the following interface signals in the spindle data block:
DB3x.DBX30.0 Spindle stop

DB3x.DBX30.1 Spindle start, clockwise rotation
DB3x.DBX30.2 Spindle start, counter-clockwise rotation
The spindle can be started and stopped in the following state:
DB21.DBX35.7= 1 Channel in reset state

DB21.DBX35.6 = 1 Channel state interrupted
DB21.DBX35.3 = 1 Program state interrupted

Spindle functions
10.2 Analog spindle
Note
If the spindle must be stopped when the program is running, then set the interface signal
DB3x.DBX4.3, "Feed stop/spindle stop" in the user PLC.
Additional settings:
MD11450 $MN_SEARCH_RUN_MODE Search run parameterization

Bit 1 = 1 Automatic ASUB start after output of the action blocks (see also
MD11620 $MN_PROG_EVENT_NAME). Alarm 10208 is not output until the ASUB is
completed.
References
For a detailed description how to to configure the spindle, see
Function Manual, Basic Functions; Spindles (S1)
Direction of rotation (only for ShopTurn)

In the ShopTurn user interface, ensure that the direction of rotation of the spindle and C axis
is correctly displayed and when programming ShopTurn functions, that the correct direction
of rotation is executed. You must base these settings on the actual direction of rotation of the
spindle / C axis on the machine.
● If you use the functions cylinder surface transformation and face machining, then a
precondition is that the function was correctly commissioned.
See Cylinder surface transformation (TRACYL) (Page 505)
● The direction of rotation of the spindle / C axis for the M function M3 that is displayed in the
ShopTurn interface is defined in part using machine data:
See: Defining the direction of rotation in Section: Setting-up ShopTurn cycles for turning
(Page 494)
● The spindle direction of rotation (M3/ M4) is assigned to the positive direction of rotation of
the C axis via the interface signal DB3n.DBX17.6. The bit defines whether M3 and C+ rotate
in the same direction (= 0) or in opposite directions (= 1). The corresponding setting options
can be found in the following sections:
– Direction of rotation of counter-spindle Setting up the counterspindle under ShopTurn
(Page 498)
– Direction of rotation of main spindle Setting-up ShopTurn cycles for turning (Page 494)
10.2 Analog spindle
Machine axis index for analog spindle

For a spindle which is not assigned to any drive (FD, MSD, SLM), the power display can be
controlled via the PLC.

Spindle functions
10.3 Leadscrew error compensation
In order that the operating software identifies the spindle as analog spindle, enter the axis
index of the analog spindle in the following machine data:
MD51068 $MNS_SPIND_DRIVELOAD_FROM_PLC1 Machine axis index spindle 1

Utilization display from the PLC
Machine axis index of a spindle (analog) that draws the data for the utilization display in
the T,F,S window from the PLC (DB19.DBB6).
MD51069 $MNS_SPIND_DRIVELOAD_FROM_PLC2 Machine axis index spindle 2

Utilization display from the PLC
Machine axis index of a spindle (analog) that draws the data for the utilization display in
the T,F,S window from the PLC (DB19.DBB7).
10.3 Leadscrew error compensation

Instead of transferring the compensation data via the part program or INI file to the NC, you
can enter and check the compensation data for all axes or change the configuration in an input
screen.
Finally, the changed data is activated in the NC in one step. The machine data required when
activating is set automatically.
Procedure
1. Select the "Start-up" operating area and press the "NC" softkey.
2. Press the "Leadscrew error" softkey.

The "Values of the Compensation Tables" window opens and displays
the default compensation tables for an axis or, if no compensation values
are available, the measuring system used.
3. Press the "Axis +" or "Axis -" softkey to select the desired axis.
- OR -
Press the "Select axis" softkey.
The "Axis Direct Selection" window opens. Position the cursor on the de‐
sired axis and confirm with "OK".

Spindle functions
10.4 Spindle diagnostics
4. Press the "Configuration" softkey to edit the compensation values for a

selected axis.
The "Configuration of the Compensation Tables" window opens.
5. Enter the following:
● Type of compensation: EEC or CEC.
● Start position, end position and interpolation point spacing.
● Only for EEC:
Used measuring system - if several measuring systems are available,
select the desired system from the selection menu.
● Only for CEC:
– Compensation table (-): Index of the table in the negative direction.
– Compensation table (+): Index of the table in the positive direction.
6. Confirm your entries with the "Activate" softkey.
A dialog box to carry out a NC warm restart is then displayed to activate
the compensation. Confirm with "OK".
The "Values of the Compensation Tables" window opens.
7. Enter the desired compensation values for each interpolation point.
8. Press the "Activate" softkey again to transfer the compensation values to
the NC.
A more detailed description is provided in the following documentation:
References
Extended Functions Function Manual; Compensations (K3)
10.4.1 Spindle diagnostics
Software option
For the "Spindle diagnostics" you require the "S-Monitor" option.
Main spindle drives are monitored via various status signals. The DRIVE-CLiQ connection at
the spindle can be used to evaluate these signals in the drive. The status signals are evaluated
for more effective diagnostics of the spindle operating states. The following information is
displayed on the user interface with the aid of the "S-Monitor" software option:
● Operating hours
● Temperatures
● Speed/torque

Spindle functions
● Clamping system
● Logistics data
Requirements
● A spindle has an SMI24 sensor module:
r0459, bit 14 = 1.
● Drive telegram 139 is configured for the spindle.
● The spindle functionality for the machine axis is present, when:
MD35000 $MA_SPIND_ASSIGN_TO_MACHAX > 0
The value corresponds to the spindle number.
References
For further information, please refer to the following documentation:
● Basic Functions (S1), Function Manual; Section "Spindle with SMI24"
● "Start-up a hybrid spindle with SMI24" application description on the Internet at:
Commissioning of a hybrid spindle with SMI 24 (http://support.automation.siemens.com/),
Entry ID 67598396
Data overview
The "S1 Spindle Diagnostics" window shows the following information:
Parameter Value
Operating hours h
● Spindle under control
● Spindle under speed
Number of clamping cycles (tool change)
Definition of a clamping cycle: Released clamping state [3] → Clamped clamping state
[7, 8 or 10] → Released clamping state [3].
Motor temperature °C
Clamping state (sensor 1) V
Piston free (sensor 4)
e.g. defined rotary angular position of the shaft (sensor 5) Yes/No
Maximum speed rpm
Procedure
1. Select the "Diagnostics" operating area.

2. Press the menu forward key twice.
3. Press the "Spindle diag." softkey to obtain a data overview.
The "S1 Spindle Diagnostics" window opens.

Spindle functions
Note
If several spindles are in operation, select the desired spindle using the "Spindle +" or "Spindle
-" softkey.
10.4.2 Temperatures
Which temperatures are evaluated and displayed depends on the number and the mounting
location (e.g. for sensor S6, bearing temperature front) of the sensors installed in the spindle.
The motor temperature is not displayed when the temperature sensor sensor type parameter
p0601 = 0 or 1.
Note
Temperature limits
The limit values displayed here refer to the spindle monitoring and have no effect on the drive
parameter values set in the drive that apply for the shutdown response of the spindle. The
temperature limit values are preset in the SMI24 and cannot be changed in this window. If
necessary, you must adapt the shutdown limit values for the drive.
Up to three temperatures can be evaluated:
Signal Sensor Column/meaning Description

Motor temperature KTY Actual Current motor temperature. If an
(Page 122) overtemperature protection is
present and responds, the value 250°
C is displayed.
Motor temperature Limit Stored threshold for motor overtem‐
Alarm perature as of which an alarm is is‐
sued due to KTY motor overtemper‐
ature.
Duration of the upper Displays the accumulated hours dur‐
limit violation ing which an upper limit violation was
present.
Last upper limit viola‐ Displays the time stamp [date] and
tion [time] at which the last upper limit vi‐
olation was present.
Number of Accumulated number of upper limit
upper limit violations violations.

Spindle functions

Motor temperature Limit Stored threshold for motor overtem‐
Fault perature as of which a fault is issued
due to KTY motor overtemperature.
present.
Overtemperature protec‐ PTC Actual When the overtemperature protec‐
tion tion responds, "Active" is displayed
(in red). The value 250° C is dis‐
played in the "Actual" column as mo‐
tor temperature.
Limit Stored threshold for motor overtem‐
perature as of which a fault is issued
due to PTC winding motor overtem‐
perature.
Additional temperature S6 (KTY) Actual Current temperature at the measur‐
(Page 123) ing point.
(e.g. bearing temperature
front)
Additional temperature Limit Stored temperature threshold as of
Alarm which an alarm is issued, e.g. due to
bearing overtemperature.
present.

Spindle functions

Additional temperature Limit Stored temperature threshold as of
Fault which a fault is issued, e.g. due to
bearing overtemperature.
present.
10.4.3 Motor temperature sensor
Shutdown response
The alarm and fault thresholds of the motor temperature sensor that are displayed on the user
interface as limits, are stored in the SMI24. They are used for the statistical evaluation of the
SMI24 and for the shutdown response of the drive. A delay time setting for the violation of the
alarm threshold stored in the SMI24 until the fault is triggered is not relevant for the display.
Please note: The motor parameter values of p0604, p0605 (alarm/fault threshold) and the
delay time p0606 are predefined and cannot be changed.
The delay time in p0606 has no effect on the values displayed on the user interface. This
means: When the alarm threshold is violated and the delay time set in p0606 has expired, the
"Motor temperature fault" signal does not change the "Last upper limit violation" display value
and the "Number of upper limit violations" is not incremented.
The parameter values of p0604, p0605 (alarm/fault threshold) and p0606 (delay time) have
an effect on the shutdown response of the spindle. The spindle is shut down when the fault
threshold is violated or the alarm threshold is violated and the delay time set in p0603 has
expired.
Currently, the delay time is not predefined by the SMI24. The parameter value of p0603 is set
to the factory setting (240 s).
Alarms:
● 207015 = motor temperature sensor alarm
● 207016 = motor temperature sensor fault

Spindle functions
10.4.4 Additional temperature sensor
Shutdown response
The alarm and fault thresholds of the additional temperature sensor that are displayed on the
user interface as limits, are stored in the SMI24. They are used only for the statistical evaluation
of the SMI24. A delay time setting for the violation of the alarm threshold stored in the SMI24
until the fault is triggered is not relevant for the display.
Please note: The parameter values of p4102[0..1] (alarm/fault threshold) and p4103 (delay
time) are predefined and cannot be changed.
Changing the parameter values of p4102[0..1] (alarm/fault threshold) and p4103 (delay time)
has no effect on the values displayed on the user interface.
The parameter values of p4102[0..1] (alarm/fault threshold) and p4103 (delay time) have an
effect on the shutdown response of the spindle. The spindle is shut down when the fault
threshold is violated or the alarm threshold is violated and the delay time set in p4103 has
expired. These parameters can be adapted accordingly to prevent an unwanted shutdown of
the spindle.
Currently, the delay time is not predefined by the SMI24. The parameter value of p4103 is set
to the factory setting (0 s). This means: The timer is deactivated.
Alarms:
● 207017 = additional temperature alarm threshold violated
● 207018 = additional temperature fault threshold violated
10.4.5 Temperature histograms

The motor temperature and optionally additional temperatures, such as bearing temperature
or housing temperature, are displayed in a histogram. The color coding indicates the following
temperature ranges:
Color Meaning
Temperature range up to the first limit.
Temperature range between the first and second limit.
Temperature range above the second limit.
The heights of the individual bar fields correspond to the parameterized temperature ranges
of the relevant temperature measuring point.
The specified times for the individual temperature ranges of a measuring point (sensor) are
the operating hours under speed.
The currently measured temperatures are displayed below the bars.

Spindle functions
10.4.6 Speed/torque
To check the loads on the spindle, the speed and the torque are recorded in a histogram as
a function of the operating hours. The color coding indicates the following states:
● Light green: low load
● Green: rated load
● Yellow: high load
● Orange: critical load
The heights of the individual bars correspond to the percentage time shares (dwell time) in
relation to the operating hours under speed. The accumulated number of operating hours under
speed for the spindle are shown above or below the respective bar for the corresponding speed
or torque range. The width of the bar corresponds to the evaluated speed or torque range.
Possible conclusions
● The speed histogram is an indication of the load on the bearings and rotary gland caused
by the speed.
● The speed histogram is an indication of the load on the bearings caused by the stock
removal forces. The relationship between torque and radial force changes depending on
the tool diameter (lever arm), the milling arc (superimposition of the cutting forces of the
individual cutting edges) and the cutting force coefficients (the stock removal force consists
of cutting force, feedrate force and passive force - only the cutting force is acquired via the
torque).
10.4.7 Clamping system

The diagnosis of the clamping system offers the following capabilities:
● Fast and robust detection of the clamping states.
● Monitoring of the clamping task and the clamping system.
● Sensors S1 and S4 in the spindle provide information about the clamping device.
● Sensor S5 detects a position, e.g. the defined rotatory angular position of the shaft.
Clamping states
The preset limits for the three clamping states are displayed in the upper section of the window.
The clamping state is defined for the specified voltage range of the analog output signal of
sensor S1.
The values in the "Voltage min." and "Voltage max." columns indicate in which voltage range
the analog signal of sensor S1 must lie for the corresponding clamping state.
The preset speed limitation "Speed max." specifies the maximum permissible speed for the
clamping state and is limited to this by the drive.
Signal overview

Spindle functions
The current state values of the sensors, the tool clamping, the speed setpoint and the active
speed limitation are displayed in the signal overview
Signal Sensor Description Value Meaning

State S1 Clamping state 3 Released
7 or 8 Clamped with tool
10 Clamped without tool
Piston free S4 Plunger sensing Yes Release plunger not in contact with the
shaft.
No Release plunger in contact with the shaft.
Shaft in the S5 Position sensing Yes For example, shaft is at a defined rotary
change posi‐ angular position.
tion No For example, shaft is not at a defined ro‐
tary angular position.
Speed set‐ Specification of the Speed specification by the user.
point speed
State Clamping states 0 Sensor S1 not available or state values
inactive.
1 The state initialization is in progress.
2 Released with signal (error state)
3 Released
4 Clamping with tool
5 Releasing with tool
6 Releasing without tool
7 Clamped with tool and S4 = 0 (No).
8 Clamped with tool and S4 = 1 (Yes).
9 Clamping without tool
10 Clamped without tool
11 Clamped with signal (error state)
State bar diagram

The clamping state is displayed by a state bar. The ranges shown in green indicate the state
ranges for "Clamped with or without tool" and "Tool released". The arrow marking indicates
the current analog sensor voltage of sensor S1.
References
For information on the associated interface signals (NC → PLC), refer to the following
references:
● NC Variable and Interface Signals List Manual, Section "Axis/spindle-specific signals".

Spindle functions
Procedure
1. The "S1 Spindle Diagnostics" window is open.

The "S1 Clamping System" window is open without the "S-Monitor" software option.
2. Press the "Clamping system" softkey.
The "S1 Clamping System" window opens and displays the acquired data.
Speed limitation
3. Press the "Speed limitation" softkey to change the limit values for the speeds of the
clamping states.
The "S1 Speed Limitations" window opens.
4. Press the "Change" softkey to enter the desired speed limits depending on the clamp‐
ing state.
Confirm with "OK".
- OR -
3. Press the "Statistics" softkey to read out the clamping times and perform a diagnosis
of the clamping system.
The "S1 Clamping System Statistics" window opens and displays the acquired data.
- OR -
3. Press the "Back" softkey to return to the data overview.
10.4.8 Clamping system: Speed limits

For safety reasons and to protect the spindle, only maximum speeds are permitted for certain
clamping states. The drive limits the spindle speed in the respective clamping state to the
entered speed.
Clamping state Meaning

Released The tool clamping system is in contact with the release plunger.
Please note: The release plunger presses with the release force
on the clamping system.
Clamping The tool clamping system is in the transition state from "Re‐
leased" to "Clamped with tool".
Releasing from state The tool clamping system is in the transition state from "Clamped
"Clamped with tool" with tool" to "Released".
Releasing from state The tool clamping system is in the transition state from "Clamped
"Clamped without tool" without tool" to "Released".
Clamped with tool The tool clamping system is in the "Clamped with tool" state.
Clamping without tool The tool clamping system is in the transition state from "Clamped
with tool" to "Clamped without tool".
Clamped without tool The tool clamping system is in the "Clamped without tool" state.

Spindle functions
You can adapt the preset speed limits to your requirements by pressing the "Change" softkey.
NOTICE
Damage to the spindle through too high a speed
Changes to the preset speed limits can result in safety-relevant changes of the operating
states and to damage on the spindle.
10.4.9 Clamping system: Diagnostic statistics

This window displays the statistics for clamping operations and speed violations.
Statistical data Meaning

Number of correct clamping cycles Accumulated number of correct clamping cycles with or without
tool.
Correct clamping cycle means: "Released" clamping state [3] →
"Clamped" clamping state [7, 8 or 10] → "Released" clamping
state [3]. A clamping cycle is considered to be correct when a
clamping and subsequent release operation are performed via
the appropriate clamping states (without "State return"). Starting
from one clamping state, the next clamping state that can be
reached must not be the previous state. There is no dependency
on time.
Clamping time (without tool) The time within a clamping operation between the clamping
states "Tool released" and "Clamped without tool".
● Within tolerance Accumulated number of clamping operations without tool that
were within the specified time.
● Outside tolerance Accumulated number of clamping operations without tool that
were outside the specified time.
● Specification Factory specification of the time for the clamping operation with‐
out tool.
● Current Measured time for the last performed clamping operation with‐
out tool.
Clamped (without tool) Diagnostics during the "Clamped without tool" clamping state.
● Speed violations Accumulated number of events during which the spindle speed
was greater than the set limit as delivered.
● Speed threshold Limit for the spindle speed in the "Clamped without tool" clamp‐
ing state (as-delivered value).
Changing this speed limit via the diagnostics overview "S1
clamping system" → "Speed limits" → "Change" has no effect on
the value specified here.
Faulty clamping/releasing opera‐ Accumulated number of clamping operations that have not run
tions (total) through the clamping states "Released" clamping state [3] →
"Clamped" clamping state [7, 8 or 10] → "Released" clamping
state [3] without interruption.
A clamping cycle is considered to be faulty when, starting from
one state, the next state that is reached is the previous state
again ("State return").

Spindle functions
10.4.10 Clamping system: Clamping time statistics

This window displays the statistics for the determined clamping times.
Statistical data Meaning

Last determined clamping time Measured time for the last performed clamping operation.
Definition of a clamping operation: "Released" clamping state
[3] → "Clamped with tool" clamping state [7 or 8]. Clamping state
3 = Released; clamping state 7 = Clamped with tool and S4 = 0
(No); clamping state 8 = Clamped with tool and S4 = 1 (Yes)
Reference clamping time (with tool) During the spindle start-up phase, the first 100 clamping opera‐
tions are measured by the SMI24 and the minimum value, max‐
imum value and the mean value determined.
● Minimum The shortest clamping time determined from the first maximum
100 clamping operations.
● Maximum The longest clamping time determined from the first maximum
● Mean The mean clamping time determined from the first maximum
Mean clamping time (without tool) After the first 100 clamping times determined for the reference
time, the mean values for the other measured clamping times
are calculated.
● 24 h Mean clamping time of the clamping cycles determined in the
last 24 hours.
● 10 days Mean clamping time of the clamping cycles determined in the
last 10 days.
● 100 days Mean clamping time of the clamping cycles determined in the
last 100 days.
If a Power On of the SMI24 is performed during the start-up phase, the previously determined
values are discarded. The counter for the first 100 clamping operations is set to zero and the
reference times up to the 100th clamping operation can be determined again. After the start-
up phase (first 100 clamping operations), the values of the reference clamping time are
"frozen". Even after a Power On of the SMI24, the values remain stored and can no longer be
changed.
10.4.11 Fetching the logistics data
Requirement
The spindle characteristics can only be read out with the "Service" access level.
Spindle characteristics
The following spindle manufacturer characteristics can be read out via DRIVE-CLiQ:
● Manufacturer's identifier
● Drawing number

Spindle functions
● Serial number
● Date of manufacture
● Service date and service information (1...4):
The service information corresponds to the reference number for the service report from
the WEISS Spindeltechnologie GmbH company.

Spindle functions

Drive system 11
11.1 Commissioning of drives
Procedure
Once commissioning of the PLC has been completed, you can carry out commissioning of the
SINAMICS drives via the user interface of SINUMERIK Operate.
2. Press the "Drive system" softkey.

The "Drive system overview" window opens.
A message is output whether the drive system has already been commis‐
sioned or not.
References
The procedure for commissioning the SINAMICS drives is described in the following
documentation:

Drive system
11.1 Commissioning of drives

Tool management 12
12.1 Machine data for tool management
12.1.1 Settings with/without magazine management
Setting without magazine management

Make the following settings if you are commissioning the tool management without NC
magazine management:
MD18080 $MN_MM_TOOL_MANAGEMENT_MASK Memory for the tool management is re‐

served step-by-step (SRAM).
= 02H
Bit 1 Provide monitoring data.
MD20310 $MC_TOOL_MANAGEMENT_MASK Activating the tool management functions.

= 02H
Bit 1 Monitoring functions of tool management active.
MD17530 $MN_TOOL_DATA_CHANGE_COUNTER Marking the changed tool data for HMI.

= 1FH
Bit 0 Tool status change.
Bit 1 Tool remaining unit quantity change.
Bit 2 Tool data change service.
Bit 3 Magazine data in the change service.
Bit 4 ISO data in the change service.
MD28450 $MC_MM_TOOL_DATA_CHG_BUFF_SIZE Buffer for changing tool data (DRAM).

= 100 Number of entries in the buffer for the OPI change service for tool data. Dynamic memory
is used. This buffer is only created if either bit 2 or bit 3 is set in MD17530 $MN_TOOL_DA‐
TA_CHANGE_COUNTER.
MD19320 $ON_TECHNO_FUNCTION_MASK
=2000000H
Bit 25 Enables the tool monitoring function without magazine management.

Tool management
Setting with magazine management

Make the following settings if you are commissioning the tool management with NC magazine
management:
MD18080 $MN_MM_TOOL_MANAGEMENT_MASK Memory for the tool management is re‐

served step-by-step (SRAM).
= 03H
Bit 0 Provide tool management data.
Bit 1 Provide monitoring data.
MD20310 $MC_TOOL_MANAGEMENT_MASK Activating the tool management functions.

= 03H
Bit 0 Magazine management active.
Bit 1 Monitoring functions of tool management active.
MD17530 $MN_TOOL_DATA_CHANGE_COUNTER Marking the changed tool data for HMI.

= 1FH
Bit 0 Tool status change.
Bit 1 Tool remaining unit quantity change.
Bit 2 Tool data change service.
Bit 3 Magazine data in the change service.
Bit 4 ISO data in the change service.
MD28450 $MC_MM_TOOL_DATA_CHG_BUFF_SIZE Buffer for changing tool data (DRAM).

= 100 Number of entries in the buffer for the OPI change service for tool data. Dynamic memory
is used. This buffer is only created if either bit 2 or bit 3 is set in MD17530 $MN_TOOL_DA‐
TA_CHANGE_COUNTER.
MD19320 $ON_TECHNO_FUNCTION_MASK
= 10H
Bit 4 Enables the tool monitoring function with magazine management.
12.1.2 Configuring the access levels of the tool management
Access levels for selected parameters
MD51199 $MNS_ACCESS_WRITE_TM_GRIND Access level, write TM grinding data.

MD51200 $MNS_ACCESS_WRITE_TM_GEO Access level, write TM geometry data.
MD51201 $MNS_ACCESS_WRITE_TM_WEAR Access level, write TM wear data.
MD51202 $MNS_ACCESS_WRITE_TM_WEAR_DELTA Access level, restricted writing of tool
wear values.

Tool management
MD51203 $MNS_ACCESS_WRITE_TM_SC Access level, write TM additive offsets.

MD51204 $MNS_ACCESS_WRITE_TM_EC Access level, write TM operating off‐
sets.
MD51205 $MNS_ACCESS_WRITE_TM_SUPVIS Access level, write TM monitoring data.
MD51206 $MNS_ACCESS_WRITE_TM_ASSDNO Access level, write TM unique D num‐
ber.
MD51207 $MNS_ACCESS_WRITE_TM_WGROUP Access level, write TM wear groups
(magazine location / magazine).
MD51208 $MNS_ACCESS_WRITE_TM_ADAPT Access level, write TM tool adapter ge‐
ometry data.
MD51209 $MNS_ACCESS_WRITE_TM_NAME Access level, write TM tool name and
duplo.
MD51210 $MNS_ACCESS_WRITE_TM_TYPE Access level, write TM tool type.
The access level of individual parameters can be overlaid through settings in the
<PARAMETERCONFIGURATION> tag, "Access level" entry (see SectionConfiguring list
parameters (Page 161)).
Access levels for window "Internal Data"
MD51198 $MNS_ACCESS_READ_TM_ALL_PARAM Protection level TOOLMAN details -

Read internal data.
Depending on the machine data, the
"Internal Data" softkey is either hidden
or displayed.
MD51215 $MNS_ACCESS_WRITE_TM_ALL_PARAM Access level TOOLMAN details - Write
internal data.
Access levels for certain functions of the tool management
MD51216 $MNS_ACCESS_TM_TOOL_CREATE Access level, TM, create tool.

MD51217 $MNS_ACCESS_TM_TOOL_DELETE Access level, TM, delete tool.
MD51218 $MNS_ACCESS_TM_TOOL_LOAD Access level, TM, load tool.
MD51219 $MNS_ACCESS_TM_TOOL_UNLOAD Access level, TM, unload tool.
MD51220 $MNS_ACCESS_TM_TOOL_MOVE Access level, TM, move tool.
MD51221 $MNS_ACCESS_TM_TOOL_REACTIVATE Access level, TM, reactivate tool.
MD51222 $MNS_ACCESS_TM_TOOL_MEASURE Access level, TM, measure tool.
MD51223 $MNS_ACCESS_TM_TOOLEDGE_CREATE Access level, TM, create tool cutting
edge.
MD51224 $MNS_ACCESS_TM_TOOLEDGE_DELETE Access level, TM, delete tool cutting
edge.
MD51225 $MNS_ACCESS_TM_MAGAZINE_POS Access level, TM, position magazine.

Tool management
12.1.3 Additional settings
Additional settings
You can enable further functions on the user interface via the following machine data / setting
data:
MD52270 $MCS_TM_FUNCTION_MASK
Bit 0 Creating a tool at the magazine location is not permitted.
Bit 1 Load/unload lock if the machine is not in the reset state.
Bit 2 Load/unload lock for EMERGENCY OFF.
Bit 3 Loading/unloading or relocating tool in/out of spindle locked.
Bit 4 Tool loaded directly into spindle.
Bit 5 Using the grinding configuration file.
Bit 6 Relocating a tool in/out of spindle is permitted despite lock (see bit 3).
Bit 7 Tool is created using the number.
Bit 8 Hide tool relocation.
Bit 9 Hide magazine positioning.
Bit 10 Reactivate tool with magazine positioning.
Bit 11 Reactivate tool in all monitoring types.
Bit 12 Hide reactivating tool.
SD54215 $SNS_TM_FUNCTION_MASK_SET
Bit 0 Diameter display for rotating tools.
Cutting edge parameters 6 (tool nose radius) and 15 (wear radius) are not displayed as a
radius value, but as a diameter value for the following tool types: Types 100 to 299, 580,
710, 711, 712, 713, 714 and 725.
Cutting edge parameter 7 (outside radius) is not displayed as a radius value, but as a diam‐
eter value for the following tool types: Types 140 and 714.
Bit 1 M4 is the standard direction of rotation for all turning tools. When creating turning tools, the
direction of rotation is pre-assigned with M4.
Bit 2 A name is not suggested when creating a tool.
Bit 3 Input lock, tool name and tool type for loaded tools. For loaded tools, the tool name and the
tool type can no longer be changed.
Bit 4 Input lock for loaded tools if the channel is not in the reset state.
Bit 5 Tool wear entries are added: Wear data is entered in addition to the already existing wear
value.
Bit 6 Only numerical entries are permitted in the "Tool identifier".
Bit 7 Hide tool monitoring parameters. The tool monitoring parameters are hidden in the user
interface.
Bit 8 Diameter display for face axis - geometry. The geometry value of the transverse axis is
displayed as a diameter value, if a transverse axis is defined in MD20100 $DIAME‐
TER_AX_DEF and SD42940 $TOOL_LENGTH_CONST is set to 18 and SD42950
$TOOL_LENGTH_TYPE is set to 2.

Tool management
Bit 9 Diameter display for face axis - wear. The wear value of the transverse axis is displayed as
a diameter value, if a transverse axis is defined in MD20100 $DIAMETER_AX_DEF and
SD42940 $TOOL_LENGTH_CONST is set to 18 and SD42950 $TOOL_LENGTH_TYPE is
set to 2.
Bit 10 Enable tool load/relocate to buffer storage locations. The magazine number can be entered
into the load dialog box. It is therefore possible to access the buffer storage via magazine
number 9998.
Bit 11 Creating new tools at gripper locations is blocked.
Bit 12 Measuring tools are not unloaded with the "Unload all" function.
Bit 13 The wear value is not deleted when a tool geometry value is entered.
Bit 14 Load or relocate tool. Empty location search performed without default value with the tool
magazine last used.
= 0 Empty location always starts with the tool magazine last used.
= 1: Empty location search follows the set search strategy.
Dependencies
The setting data SD54215 $TM_FUNCTION_MASK_SET and the machine data MD20360
$TOOL_PARAMETER_DEF_MASK have the following dependencies:
Dependency Description Recommendation

SD54215 ⇔ MD20360
Bit 9 ⇔ Bit 0 If bit 0 is set in MD20360, then SD54215 It is recommended that the setting MD20360
bit 9 has no effect because the NC already bit 0 and bit 1 not be used.
returns the linear wear value of the trans‐ Instead, use SD4215 bit 9 and bit 8.
verse axis as a diameter value. MD20360 bit 0 and bit 1 are effective only for
Bit 8 ⇔ Bit 1 If bit 1 is set in MD20360, then SD54215 turning and grinding tools. This setting there‐
bit 8 has no effect because the NC already fore cannot be used on a turning/milling ma‐
returns the linear geometry value of the chine because the linear component of the
transverse axis as a diameter value. transverse axis applies for turning tools in the
diameter and for milling tools in the radius.
When the setting data is used, only the display
goes to diameter, the internal value in the NC
remains at radius.
Bit 0 ⇔ Bit 11 If bit 11 is set in MD20360, then SD54215 It is recommended that the setting MD20360
bit 0 has no effect with regard to cutting bit 11 and bit 12 not be used.
edge parameter 6 (tool nose radius) be‐ Instead, set bit 0 in SD54215.
cause the NC already returns the tool nose MD20360 bit 11 and bit 12 apply to all tool
radius as a diameter value. types, i.e. also to turning tools. This setting
Bit 0 ⇔ Bit 12 If bit 12 is set in MD20360, then SD54215 therefore cannot be used on a turning/milling
bit 0 has no effect with regard to cutting machine because the tool nose radius of a
edge parameter 15 (wear radius) because turning tool should never be specified in the
the NC already returns the wear radius as diameter.
a diameter value. When the setting data is used, only the display
goes to diameter, the internal value in the NC
remains at radius.

Tool management
Enabling the graphic tool and magazine display function

Make the following settings when the tools and the magazine should be represented
graphically:
MD52271 $MCS_TM_MAG_PLACE_DISTANCE Distance between individual magazine lo‐

cations in the unit of measurement of the
basic NC system.
>0 The tools and magazine locations are displayed graphically.
=0 The tools and magazine locations are not displayed graphically.
You must make the following settings on the user interface:

1. Press the "Settings" softkey in the "Tool list" window.
The "Settings" window opens.
2. Activate the "Switch on graphical magazine display" checkbox.
This checkbox is offered only when the MD52271 $MCS_TM_MAG_PLACE_DISTANCE
machine data has a value > 0.
Supplementary conditions:
● MD52200 $MCS_TECHNOLOGY = 2 (milling)
● MD52201 $MCS_TECHNOLOGY_EXTENSION = 0
Default settings for unloading/loading and relocating
MD52272 $MCS_TM_TOOL_LOAD_DEFAULT_MAG Default magazine for loading tools.

=0 No default magazine, default value
MD52273 $MCS_TM_TOOL_MOVE_DEFAULT_MAG Default magazine for relocating tools.

=0 No default magazine, default value
MD52274 $MCS_TM_TOOL_LOAD_STATION Number of loading station.

=0 All configured stations are considered, default value
Input limits for wear input
MD51212 $MNS_TM_WRITE_WEAR_ABS_LIMIT Maximum value of the tool wear.

MD51213 $MNS_TM_WRITE_WEAR_DELTA_LIMIT Maximum differential value of restricted tool
wear input.
MD51214 $MNS_TM_WRITE_LIMIT_MASK Range of validity of the restricted tool wear
input.

Tool management
12.2 Configuring the user interface
Setting the manual tool function
MD22562 $MC_TOOL_CHANGE_ERROR_MODE Response when errors occur at tool

change.
Bit 1 = 1 Manual tools can be loaded.
Bit 2 = 1 Active D No. > 0 and active T No. = 0 generate an alarm message.
Active D No. > 0 and active D No. = 0 generate an alarm message.
Note
If, in machine data MD22562 $MC_TOOL_CHANGE_ERROR_MODE bit 2 = 1, then you have
the option, using a correction selection (D No.) in the program, to stop the machine until the
PLC signals that the tool change has been completed. To do this, machine data MD20270
$MC_CUTTING_EDGE_DEFAULT must be set to = 0.
Configurable settings
The following settings can be configured:
● General settings
● Configure the tool lists
● Configure the list parameters
● Configure the tool types
● Configure the "Additional Data" window
● Configure the "New Tool - Favorites" window
● Configure the "New Tool" window
● Configuring the "New Multitool" window
● Configuring the "New Tool from Code Carrier" window
● Configuring the "New Tool from File" window
● Configure the default values for new tools
● Configure the "Details" window
● Assign names for magazines and magazine locations
● Configuring the "Assign Tooltips for Multitool Locations" window
● Assign names for magazine location types
● Assignment of magazines and magazine locations to channels
● Assignment of magazines to coordinate systems
● Disabling the softkey depending on filters

Tool management
● Configuring the "Load Station Selection" window

● Coolant and tool-specific functions
● Reason for the tool change when reactivating
● Configure the code carrier connection
● Configuring store to file
The following sections explain how you configure these adaptations.
Procedure
1. Open the directory: /siemens/sinumerik/hmi/template/cfg.
2. Copy the "oem_sltmlistconfig.xml" template file
3. Copy the file to the directory /oem/sinumerik/hmi/cfg
OR: /user/sinumerik/hmi/cfg.
4. Change the file name according to the set technology:
File name MD52200 technology MD52201 technology exten‐

sion
sltmlistconfig.xml Milling technology
sltmturninglistconfig.xml Turning technology
sltmmillturnlistconfig.xml Milling technology Turning technology
sltmcirculargrindinglistconfig.xml Cylindrical grinding technolo‐
gy
sltmsurfacegrindinglistconfig.xml Surface grinding technology
sltmplclistconfig.xml PLC tool management
"TRANSLINE 2000"
5. Remove the comments of the example in the template to create your specific configuration.
Configuration examples
Examples for all possible configurations are provided in the template oem_sltmlistconfig.xml,
which are described individually in the following sections:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

- <CONFIGURATION>



Configuration examples




</CONFIGURATION>

Tool management
Enter your configuration using the following xml identifiers:
Identifier <tag> for the following setting:

<SETTINGS> General settings (Page 142)
<LISTCONFIGURATION> Configuring tool lists (Page 147)
<PARAMETERCONFIGURATION> Configuring list parameters (Page 161)
<TOOLTYPECONFIGURATION> Configure tool types (Page 167)
<MOREDATACONFIGURATION> Configuring the "Additional Data" window
(Page 169)
<NEWTOOLFAVORITECONFIGURATION> Configure the "New tool - favorites" window
(Page 171)
<NEWTOOLCONFIGURATION> Configuring the "New Tool" window (Page 172)
<NEWMULTITOOLCONFIGURATION> Configuring the "New Multitool" window
(Page 172)
<NEWTOOLIDENTCONNECTIONCONFIGURATION> Configuring the "New Tool from Code Carrier"
window (Page 173)
<NEWTOOLSAVETOOLDATACONFIGURATION> Configuring the "New Tool from File" window
(Page 173)
<NEWTOOLDEFAULTVALUECONFIGURATION> Configuring default values for new tools
(Page 174)
<DETAILSCONFIGURATION> Configuring the "Details" window (Page 178)
<MAGAZINEPLACENAMECONFIGURATION> Assigning a name for magazines and magazine
locations (Page 178)
<MULTITOOLPLACETOOLTIPCONFIGURATION> Configuring the "Assign Tooltips for Multitool Lo‐
cations" window (Page 180)
<PLACETYPECONFIGURATION> Assigning a name for magazine location types
(Page 181)
<CHANNELMAGAZINEASSIGNMENT> Assignment of magazines and magazine loca‐
tions to channels (Page 182)
<COORDSYSMAGAZINEASSIGNMENT> Assignment between magazines and magazine
locations and coordinate systems (Page 184)
<FILTERCONFIGURATION> Disabling the softkey depending on filters
(Page 185)
<LOADSTATIONSHANDLEALLTOOLS> Configuring the "Load Station Selection" win‐
dow (Page 186)
<TOOLCHANGEREASON> Reason for the tool change when reactivating
(Page 190)
<IDENTCONNECTIONCONFIGURATION> Configure the code carrier connection
(Page 194)
<SAVETOOLDATACONFIGURATION> Configuring Save to file (Page 197)

Tool management
12.2.1 General settings
<SETTINGS> tag
The general settings for the tool management user interface are stored in the <SETTINGS>
tag.
Entries Meaning
ReactivateWithMagPos True - reactivate with positioning of the tool to the tool mag‐
azine loading point.
False - default setting, reactivate without positioning the tool
magazine.
ReactivateAllMonitorModes True - the actual values of all the monitoring types set in the
NC are reset.
False - default setting, actual value of the active monitoring
type is reset.
ReactivateEnabled True - default setting, reactivation is enabled.
False - reactivation is disabled.
CreateNewToolDialog True - the "New Tool" window is displayed. In this window,
you can specify the tool name and the size of the tool (over‐
sized tool) before actually creating the tool. Other input op‐
tions can be defined by configuring the "New tool" window.
False - default setting, the "New Tool" window is not dis‐
played. Once the name has been entered, the tool will be
created directly in the tool list.
CreateNewMultiToolDialog True - default setting, the "New Multitool" window is dis‐
played. In this window, you can configure the following be‐
fore actually creating the multitool:
● Multitool names
● Number of multitool locations
● Type of clearance input
● Value of the location clearance for each multitool location
False - the "New Multitool" window is not displayed. Once
the name has been entered, the multitool will be created
directly in the tool list.
MagazineSelectionDialog True - a dialog box displaying the buffer, tool magazine and
NC memory is displayed. A mark can be added to or re‐
moved from each of these elements to indicate whether that
element appears in the list display. The "Go to" softkey can
be used to select an element directly in the list display.
False - no dialog box for magazine selection. The system
switches between the buffer, the tool magazines and the
NC memory.
If there is no MagazineSelectionDialog entry in the
<Settings> tag, the dialog box is automatically displayed
with more than one tool magazine (excluding the system
magazine) when magazine configuration is taking place. If
there is only one tool magazine, the switchover function is
used.

Tool management
Entries Meaning
NewToolFavoritesOnly Refers to the "New tool" function.
True - only those tool types that are configured as favorites
are listed.
False - default setting, all tool types are listed.
SortationInFirstEtcLevel True - the "Sorting" function is placed at the first softkey
level. The "Continue" function is omitted.
False - default setting, sorting at all softkey levels.
ToolBufferOnceOnTop True - default setting, buffer is displayed at the start of the
list.
False - buffer is displayed for each magazine. Only those
locations are displayed that are assigned to the magazine.
UnloadToolFromLoadPlaceEnabled True - a tool at the load station can be removed from the
load station using the "Unload" softkey.
False - default setting. The "Unload" softkey is not displayed
for a tool at the load position.
CreateNewToolWithCuttPos9Enabled True - cutting edge position 9 is offered in the cutting edge
position selection.
True - default setting, cutting edge position 9 is not offered
in the cutting edge position selection.
AutoHNumberDisplayEnabled Column of the cutting edge parameter "IsoHNoDPH - ISO
H number" depending on the machine configuration.
True - default setting, the column is automatically displayed.
False - the column is not automatically displayed.
AutoUniqueDNumberDisplayEnabled Column of the cutting edge parameter "UniqueDNo" de‐
pending on the machine configuration.
True - default setting, the column is automatically displayed.
False - the column is not automatically displayed.
AccessLevelDeleteAllDNos The following entry specifies the access level as of which
the "Delete all D numbers delete" function is offered.
Default setting: Access level 3 (user) - relevant only when
the "Unique D number" setting has been made.
MagazineNumberOfDCheckAndActivate Default setting: -2 - the tools of all magazines are considered
by the function "Check for unique D number and activate
tool."
>0 - The above function only considers the tools of the
named magazine.
AutoFixedPlaceDisplayEnabled Column of the tool parameter "ToolStateFixed" - tool status
- tool is fixed-location coded and acts dependent on the
magazine configuration.
True - default setting, the column is automatically hidden, if
all of the configured magazines are fixed location coded.
False - the column is not automatically hidden.
MagPlaceAdapterDisplayEnabled Columns of the magazine location adapter parameters are
displayed in the "Magazine" window.
False - default setting, parameters are not displayed.

Tool management
Entries Meaning
AdaptTransDataViewEnabled The magazine location adapter transformed display of the
cutting edge parameters is enabled. It can be switched on
and off in the settings dialog of the tool lists.
False - default setting, the magazine location adapter trans‐
formed display of the cutting edge parameters is not ena‐
bled.
ActiveCompensationsEnabled The "Working offsets" function is enabled. This function de‐
pends on the machine configuration. Unique D number,
magazine location adapter and magazine management
must be set.
False - default setting, the "Working offsets" function is not
enabled.
M2NLockEnabled Locking of an M to N switchover while a function of the tool
management is being executed.
True - default setting, switchover is locked.
SDToolLengthInListEnabled True - default setting, evaluation of SD42940, SD42942,
and SD42950 in axis name display in the tool lists.
False - the setting data are not evaluated in the axis name
display.
DisableMultiTools True - even though the Multitools function is set in the NC,
they are not offered in the tool lists.
False - default setting, if the Multitools function is set in the
NC, they are offered in the tool lists.
CursorPositionInfoEnabled True - information about the tool on which the cursor is posi‐
tioned is written to the SlCap local variable "/Hmi/TMHMI‐
CurData".
False - default setting, no information about the tool on
which the cursor is positioned is made available on an in‐
terface for the OA.
EnableMonAndBasisGrindingToolTypes True - enable switchover of grinding tool types in respect of
"with/without grinding-specific tool monitoring," "with/with‐
out consideration of the base dimension when calculating
the grinding wheel radius."
False - default setting, switchover not enabled.
ErrorMessageWithoutProgressBar True - error messages are output without a progress bar
and must be acknowledged via softkey.
False - default setting, error message is automatically
closed when the progress bar reaches the end.
ColumnZoomByResolution True - column width is adapted to the resolution of the HMI.
False - default setting, the column width is adapted to the
font size in the HMI. With this setting, with higher resolutions
more columns can be displayed next to each other without
needing to scroll.
AccessLevelReadDetailsAllParameter The following entry specifies the access level as of which
the "Further details" function is offered in the "Details" dialog.
Default setting: Access level 7 (keyswitch position 0) - can
be overlaid through the setting in MD51198.
FixNumberOfMultiToolPlaces Multitools are created with a fixed number of multitool loca‐
tions. There is no prompt when you create the multitool.

Tool management
Entries Meaning
FixKindOfDistInMultiTools Multitools are created with a fixed type of clearance input of
the multitool locations. There is no prompt when you create
the multitool.
Possible input value: 3 - clearance of the multitool locations
as an angle.
DlDisplayMode ● DisplayDistributed - default setting, the setup offsets EC
are displayed in the tool list and the additive offsets SC
are displayed in the tool wear list.
● EcInWearList - the setup offsets EC are displayed in the
tool wear list and the additive offsets SC are not
displayed.
CombinedToolMonitoring Specifies the combined monitoring types offered in the tog‐
gle field:
● Time/Count - tool life and workpiece count
● Time/Wear - tool life and wear monitoring
● Count/Wear - workpiece count and wear monitoring
● Time/WearDlSc - tool life and wear monitoring for
additive and setup offsets
● Count/WearDlSc - workpiece count and wear monitoring
for additive and setup offsets
● Time/Count/Wear - tool life, workpiece count and wear
monitoring
● Time/Count/WearDlSc - tool life, workpiece count and
wear monitoring for additive and setup offsets
FiltersCombinedWithOr Defines the filter criteria, which are linked in the filter window
using a logical OR. The default setting for all the filter criteria
is a logical AND. The possible entries are:
● "StandBy" - for tools that are ready for use
● "Active" - for tools with active identifier
● "Locked" - for locked tools
● "Prewarn" - for the prewarning limit
● "RemainingPieces" - for the remaining unit quantity
● "RemainingTime" - for the remaining tool time
● "MarkedToUnload" - for the unload identifier
● "MarkedToLoad" - for the load identifier
MagazineMoveMessage True - "Magazine movement running" or "Magazine move‐
ment ended" message is displayed.
False - default setting, message is not displayed.
ToolLoadErrorMessage Refers to the output of the fault message due to a negative
PLC.
True - default setting, the fault message is displayed.
False - the fault message is not displayed.
The following settings refer to markings in the lists:

True - marking is displayed.

Tool management
False - marking is not displayed (default setting).

If several markings apply to one location, the most important information is displayed. For
instance, if a tool is locked, and at the same time, the "Tool position" and the "Reference
direction holder angle" for this tool do not match, then a red cross is displayed for locked. The
yellow triangle for the conflict cannot be seen.
Entries Meaning
ShowSymbolActivePlace Marking of the magazine location at the machining position.
True - default setting applies for the "Turret" magazine type.
False - setting for all other magazine types.
ShowSymbolActiveMultiToolPlace Marking of the multitool location at the machining position. Is
only displayed when the multitool is located in the spindle or
the tool holder.
True - default setting.
ShowSymbolLoadPlace Selection of the magazine location at the loading position.
True - default setting applies for all magazine types (except
Turret is true).
False - setting for the "Turret" magazine type.
ShowSymbolChangeInSpindlePlace Marking of the magazine location at the change position.
True - default setting applies for all magazine types (except
Revolver is true).
False - setting for the "Turret" magazine type.
ShowSymbolActiveTool Marking of the active tool.
False - default setting.
ShowSymbolProgrammedTool Marking of the follow-on tool.
ShowSymbolActiveDNo Marking of the active cutting edge.
False - default setting.
ShowSymbolActiveDNoInTool Marking of the active tool by marking the active cutting edge.
True - default setting for configuration without magazine
management.
False - setting for configuration with magazine management.
ShowSymbolAcitveDlNo Marking of the active DL number.
ShowConflictPositionAndDirection Marking of a conflict; tool position and cutting direction do not
match.
ShowConflictActiveToolWarning Marking of a conflict; turret magazine type and the active tool
are not at the the machining position.
Example
<SETTINGS>
<ReactivateWithMagPos value="false" type="bool" />
<MagazineMoveMessage value="false" type="bool" />

Tool management
<CreateNewToolDialog value="true" type="bool" />

<MagazineSelectionDialog value="false" type="bool" />
<AccessLevelWriteDetailsAllParameter value="4" type="int" />
</SETTINGS>
12.2.2 Configuring tool lists
<LISTCONFIGURATION> tag
The entries used for configuring the following list views are located in the
<LISTCONFIGURATION> tag:
● "Tool List" window, identifier <SlTmToollistForm>, see the 1st example.
● "Tool Wear" window, <SlTmToolwearForm> identifier
● "Magazine" window, <SlTmToolmagazinForm> identifier
● "Tool Data OEM" window, <SlTmTooloemForm>identifier
This window is hidden in the default configuration. The window is only displayed when you
enable it with <Enabled>, see the 3rd example.
● "Tool Selection" window, <SlTmToolselectionForm> identifier: In order to select a tool
this window can be displayed in the program input screen.
Entry Meaning
Enabled True - window is displayed.
False - window is hidden.
CAPTION Definition of the list name.
Text Used as label/item below the "CAPTION" to define the heading text.
COLUMNX Column selection: X stands for the column number.
TOOLTYPE_ALL The column setting applies to all tool types.
TOOLTYPE_ALL_XXX The column setting applies to all tool types of a group. XXX stands for
the group number of the tool types. The hundreds position is used as the
group number, for example, TOOLTYPE_ALL_100 or TOOL‐
TYPE_ALL_200 etc.
TOOLTYPE_XXX The column setting applies to a particular tool type. XXX stands for the
number of the tool type.
EMPTY_MAG_PLACE The column setting applies to an empty magazine location. Empty mag‐
azine locations appear in a list sorted according to magazine.
Item Identifier of the list parameter.
See example: The column in which the magazine location type is dis‐
played is created with the identifier "MagPlaceType."
Tool parameter identifiers (Page 151)
Cutting edge parameter identifiers (Page 153)
Monitoring parameter identifiers (Page 156)
Magazine location parameter identifiers (Page 158)

Tool management
Entry Meaning
DELETE_COLUMN Delete column.
INSERT_COLUMN Insert column.
Note
Independent of their programming, the entries are effective in the following sequence:
1. COLUMNX
2. DELETE_COLUMN
3. INSERT_COLUMN
Note
The Enabled entry does not apply for the "Tool Selection" window. The other entries apply.
Example 1: Configuring the magazine list - magazine location and tool location type
Note
The columns of the list configuration cannot be taken from the display in the user interface in
all cases because some columns are automatically inserted and therefore not included in the
count of the configuration.
Variant 1
Column 10 and column 11 are overwritten. If column 10 and column 11 do not exist, the new
columns will be added to the existing columns.
<LISTCONFIGURATION>

<SlTmToolmagazinForm>

<COLUMN10>

<TOOLTYPE_ALL>

<Item value="MagPlaceType" type="QString" />
</TOOLTYPE_ALL>
</COLUMN10>

<COLUMN11>
<TOOLTYPE_ALL>

<Item value="ToolPlaceSpec" type="QString" />

Tool management
</TOOLTYPE_ALL>

<TOOLTYPE_9997>

<Item value="MultiToolPlaceSpec" type="QString" />
</TOOLTYPE_9997>
</COLUMN11>
</SlTmToolmagazinForm>
</LISTCONFIGURATION>
Variant 2
The new columns are inserted in the standard configuration between the "Magazine location
locked" and "Oversized tool" columns.
<LISTCONFIGURATION>


<INSERT_COLUMN>

<COLUMN7>
<TOOLTYPE_ALL>
<Item value="MagPlaceType" type="QString" />
</TOOLTYPE_ALL>
</COLUMN7>

<COLUMN8>
<TOOLTYPE_ALL>
<Item value="ToolPlaceSpec" type="QString" />
</TOOLTYPE_ALL>
<TOOLTYPE_9997>
<Item value="MultiToolPlaceSpec" type="QString" />
</TOOLTYPE_9997>
</COLUMN8>
</INSERT_COLUMN>

Tool management
Example 2: Configuring the magazine list - "Oversized tool" column is deleted
Note
The columns of the list configuration cannot be taken from the display in the user interface in
all cases because some columns are automatically inserted and therefore not included in the
count of the configuration.
<LISTCONFIGURATION>


<DELETE_COLUMN>
<COLUMN7 />
</DELETE_COLUMN>
Example 3: Enabling the OEM tool data list

<SlTmTooloemForm>
<Enabled value="true" type="bool" />
</SlTmTooloemForm>

Tool management
Result
● The "OEM Tool Data" window is displayed. It automatically displays the columns shown in
the figure.
● The new "OEM tools" softkey appears and can be operated.
12.2.2.1 Tool parameter identifiers
Tool parameters
For the tool parameters, the following identifiers are used in the configuration file:
Identifier Parameter or property System variable *)

Empty Empty field -
ToolNo Number of the tool -
AdaptNo Adapter number assignment $TC_MPP8
DuploNo Duplo number $TC_TP1
DuploNoRW Duplo number, read and write access $TC_TP1
NumCuttEdges Number of cutting edges of tool $P_TOOLND
ToolIdent Tool name $TC_TP2
ToolIdentRO Tool name, read only access $TC_TP2
ToolInfo Tool information $TC_TP11
ToolInMag Magazine in which the tool is located $A_TOOLMN
ToolInPlace Magazine location containing the tool $A_TOOLMLN

Tool management

ToolInMagInPlace Magazine number/Magazine location $A_TOOLMN /
$A_TOOL_MLN
ToolMonTCW Type of tool monitoring, tool life, workpiece $TC_TP9
count and wear. If wear monitoring has not been
enabled via the machine data, this parameter is
handled like ToolMonTC.
ToolMonTC Type of tool monitoring, tool life and workpiece $TC_TP9
count
ToolPlaceSpec Location type $TC_TP7
ToolPlaceSpecIdent Location type, if it is to be displayed as text. The $TC_TP7
precondition is that the text for the location type
was configured.
ToolSearch Tool search type for replacement tools $TC_TP10
ToolMyMag Owner magazine of the tool $A_MYMN
ToolMyPlace Owner magazine location of the tool $A_MYMLN
ToolSizeLeft Tool size left in half locations $TC_TP3
ToolSizeRight Tool size right in half locations $TC_TP4
ToolSizeUpper Tool size upper in half locations $TC_TP5
ToolSizeDown Tool size lower in half locations $TC_TP6
ToolOverSize Tool size as fixed setting - two half locations left, $TC_TP3 -
two half locations right, one half location top, $TC_TP6
one half location bottom
ToolState Tool status in the hexadecimal notation $TC_TP8
ToolStateActiv Tool status - tool active $TC_TP8, Bit0
ToolStateEnabled Tool status - tool released $TC_TP8, Bit1
ToolStateLocked Tool status - tool locked $TC_TP8, Bit2
ToolStateLockedRO Tool status - tool locked, only read access $TC_TP8, Bit2
ToolStateMeasured Tool status - tool measured $TC_TP8, Bit3
ToolStatePrewarn Tool status - tool has reached prewarning limit $TC_TP8, Bit4
ToolStatePrewarnRO Tool status - tool has reached prewarning limit, $TC_TP8, Bit4
only read access
ToolStateInChange Tool status - tool is being changed $TC_TP8, Bit5
ToolStateFixed Tool status - tool fixed place coded $TC_TP8, Bit6
ToolStateUsed Tool status - tool was in use $TC_TP8, Bit7
ToolStateAutoReturn Tool status - automatic return $TC_TP8
ToolStateIgnoreLocked Tool status - do not observe locked $TC_TP8, Bit9
ToolStateMarkedToUnload Tool status - tool is marked to unload $TC_TP8, Bit10
ToolStateMarkedToLoad Tool status - tool is marked to load $TC_TP8, Bit11
ToolStatePermanent Tool status - tool is permanent $TC_TP8, Bit12
ToolState1To1Exchange Tool status - one to one replacement $TC_TP8, Bit14
ToolStateHandTool Tool status - manual tool $TC_TP8, Bit15
ToolProtAreaFile File name of the tool description which is re‐ $TC_TP_PROTA
quired to define the protection zone
ToolMaxVelo Maximum speed $TC_TP_MAX_VE‐
LO

Tool management

ToolMaxAcc Maximum acceleration $TC_TP_MAX_AC
C
ToolInMultiTool Multitool in which the tool is located $A_TOOLMTN
ToolInMultiToolPlace Multitool location containing the tool $A_TOOLMTLN
ToolMyMultiTool Owner multitool of the tool $A_MYMTN
ToolMyMultiToolPlace Owner multitool location of the tool $A_MYMTLN
ToolAlarmIsExtended PLC tool status - function "extended alarm" ac‐ -
tive
ToolAlarmLimit PLC tool status - alarm limit reached -
ToolExtAlarmLimit PLC tool status - limit "extended alarm" reached -
ToolUser_1, ... ToolUser_10 OEM tool parameters 1 to 10 $TC_TPC1, ...
$TC_TPC10
ToolAppl_1, ... ToolAppl_10 Siemens application tool parameters 1 to 10 $TC_TPCS1, ...
$TC_TPCS10
*)
Parameter corresponds to the system variable or the system variable is the basis for this parameter.
Note
Tool name "ToolIdent"
The maximum length of tool names is 31 ASCII characters.
The number of characters is reduced for Asian characters or Unicode characters.
The following special characters are not permitted: | # "
12.2.2.2 Cutting edge parameter identifiers

For the cutting edge parameters, the following identifiers are used in the configuration file:
Identifier Parameter or property System variable

*)
EdgeNo D number -
EdgeNoIdx Cutting edge number -
ToolType Tool type, cutting edge parameter 1 $TC_DP1
CuttEdgePos Cutting edge position, cutting edge param‐ $TC_DP2
eter 2
GeoLength1 Length 1, cutting edge parameter 3 $TC_DP3
GeoLengthGeoAx1 Length of geometry axis 1, cutting edge $TC_DP3
parameter 3, e.g. length X
GeoLengthGeoAx1DiscDiameter Grinding wheel diameter in geometry axis $TC_DP3
1, cutting edge parameter 3
GeoLengthGeoAx1DresserDiameter Dressing tool diameter in geometry axis 1, $TC_DP3
cutting edge parameter 3
GeoLength Length, cutting edge parameter 3 $TC_DP3

Tool management

*)

parameter 4, e.g. length Z
parameter 5, e.g. length Y
GeoRadius Radius, cutting edge parameter 6 $TC_DP6
GeoOutsideRadius714 External radius for the star probe, tool type $TC_DP6
GeoCuttEdgeRadius Tool nose radius, cutting edge parameter $TC_DP6
6
GeoCornerRadius Corner radius, cutting edge parameter 7 $TC_DP7
GeoOutsideRadius Outside radius, cutting edge parameter 7 $TC_DP7
GeoBoomLength Cantilever length, cutting edge parameter $TC_DP7
7
GeoSlotWidth Slot width, for example, for slotting saw, $TC_DP7
GeoRadius714 Ball radius for the star probe, tool type 714, $TC_DP7
PlateLength Cutting tip length, cutting edge parameter $TC_DP8
8
GeoProjection Protrusion, for example, for slotting saw, $TC_DP8
GeoWidth Width, cutting edge parameter 9 $TC_DP9
PlateWidth Cutting tip width, cutting edge parameter 9 $TC_DP9
GeoPitch Thread pitch, cutting edge parameter 9 $TC_DP9
BoreRadius Hole radius, cutting edge parameter 9 $TC_DP9
GeoAngle1 Angle 1, cutting edge parameter 10 $TC_DP10
HolderAngle Holder angle, cutting edge parameter 10 $TC_DP10
CorrectionAngle Correction angle to align the probe, cutting $TC_DP10
edge parameter 10
GeoAngle2 Angle 2, cutting edge parameter 11 $TC_DP11
AngleConicalMillTool Angle conical mill tools, cutting edge pa‐ $TC_DP11
rameter 11
CuttDirection Reference direction holder angle, cutting $TC_DP11
edge parameter 11
WearLength1 Wear length 1, cutting edge parameter 12 $TC_DP12

Tool management

*)
WearLengthGeoAx1 Wear length of geometry axis 1, cutting $TC_DP12

edge parameter 12,
e.g. Δ length X
WearLength Wear length, cutting edge parameter 12 $TC_DP12
edge parameter 13,
e.g. Δ length Z
edge parameter 14,
e.g. Δ length Y
WearRadius Wear radius, cutting edge parameter 15 $TC_DP15
WearOutsideRadius714 Wear external radius for the star probe, $TC_DP15
tool type 714, cutting edge parameter 15
WearCuttEdgeRadius Wear tool nose radius, cutting edge pa‐ $TC_DP15
rameter 15
WearCornerRadius Wear corner radius, cutting edge parame‐ $TC_DP16
ter 16
WearSlotWidth Wear slot width, for example, for slotting $TC_DP16
saw, cutting edge parameter 16
WearProjection Wear protrusion, for example, for slotting $TC_DP17
saw, cutting edge parameter 17
WearAngle1 Wear angle 1, cutting edge parameter 19 $TC_DP19
WearAngle2 Wear angle 2, cutting edge parameter 20 $TC_DP20
AdaptLength1 Adapter length 1, cutting edge parameter $TC_DP21
21
AdaptLengthGeoAx1 Adapter length of geometry axis 1, cutting $TC_DP21
edge parameter 21, e.g. adapter length X
AdaptLength Adapter length, cutting edge parameter 21 $TC_DP21
22
edge parameter 22, e.g. adapter length Z
23
edge parameter 23, e.g. adapter length Y
ReliefAngle Relief angle, cutting edge parameter 24 $TC_DP24
PlateAngle Cutting tip angle, combination of cutting $TC_DP24 and
parameter 24 and cutting edge parameter $TC_DP10
10
NoseAngle Nose angle, cutting edge parameter 24 $TC_DP24
CuttRate Cutting rate, cutting edge parameter 25 $TC_DP25

Tool management

*)
SpindleDirection For rotating tools, direction of rotation of $TC_DP25 bit8

the tool spindle. For turning tools, direction and bit9
of rotation of the main spindle
Coolant1 Coolant 1 $TC_DP25 Bit10
Coolant2 Coolant 2 $TC_DP25 Bit11
MFunction1 M function 1 $TC_DP25 Bit0
IsoHNoDPH ISO H number $TC_DPH
OrientNo Cutting edge orientation $TC_DPV
OrientV1 Cutting edge orientation vector 1 $TC_DPV3
OrientVGeoAx1 Cutting edge orientation vector of geome‐ $TC_DPVN3
try axis 1, cutting edge orientation param‐
eter 3, e.g. vector X
eter 4, e.g. vector Z
eter 5, e.g. vector Y
TeethCount Number of teeth, cutting edge parameter $TC_DPNT
34
BasicRotationAngle Clamping angle of tool, cutting edge pa‐ $TC_DPROT
rameter 35
UniqueDNo Unique D number $TC_DPCE
EdgeUser_1, ..., EdgeUser_10, OEM cutting edge parameters 1 to 10 $TC_DPC1, ...
$TC_DPC10
EdgeAppl_1, ..., EdgeAppl_10x Siemens application cutting edge parame‐ $TC_DPCS1, ...
ters 1 to 10 $TC_DPCS10
*)
12.2.2.3 Monitoring parameter identifiers

For the monitoring parameters, the following identifiers are used in the configuration file:

SupWarning Warning limits, taking the current monitoring type -
into consideration
SupRemaining Actual value, taking the current monitoring type into -
consideration
SupDesired Setpoint, taking the current monitoring type into -
consideration

Tool management

SupWarningTime Tool life warning limit $TC_MOP1
SupRemainingTime Tool life actual value $TC_MOP2
SupWarningPieces Prewarning limit for workpiece count $TC_MOP3
SupRemainingPieces Actual value for workpiece count $TC_MOP4
SupDesiredTime Setpoint for tool life $TC_MOP11
SupDesiredPieces Setpoint for workpiece count $TC_MOP13
SupWarningWear Prewarning limit for wear $TC_MOP5
SupRemainingWear Actual value for wear $TC_MOP6
SupDesiredWear Setpoint for wear $TC_MOP15
SupExtendedAlarm PLC tool management: Extended alarm -
SupWarningPiecesIncre‐ PLC tool management: Prewarning limit for work‐ $TC_MOP13 -
mental piece count $TC_MOP3
SupActualPieces PLC tool management: Actual value for workpiece $TC_MOP13 -
count $TC_MOP4
EdgeSupUser_1, ... OEM cutting edge monitoring parameters 1 to 10 $TC_MOPC1, ...
EdgeSupUser_10 $TC_MOPC10
EdgeSupAppl_1, ... Edge‐ Siemens application cutting edge monitoring pa‐ $TC_MOPCS1, ...
SupAppl_10 rameters 1 to 10 $TC_MOPCS10
*)
12.2.2.4 Grinding parameter identifiers

For grinding parameters, the following identifiers are used in the configuration file:
Identifier/parameter Meaning System variable *)

GrindingSpindleNo Spindle number $TC_TPG1
GrindingConnectionRule Chaining rule $TC_TPG2
MinimalDiscRadius Minimum grinding wheel radius $TC_TPG3
ActualDiscRadius Actual grinding wheel radius (read ac‐ -
cess only)
MinimalDiscWidth Minimum grinding wheel width $TC_TPG4
ActualDiscWidth Actual grinding wheel width $TC_TPG5
MaximalDiscSpeed Maximum grinding wheel speed $TC_TPG6
MaximalDiscPeripheralVelocity Maximum grinding wheel peripheral ve‐ $TC_TPG7
locity
AngleBevelDisc Angle of inclined wheel $TC_TPG8
ParamForRadiusCalculation Parameters to calculate the radius $TC_TPG9
DressingProgram Dressing program name $TC_TPG_DRSPROG
DressingPath Directory of the dressing program $TC_TPG_DRSPATH
*)

Tool management
The following parameters are assigned to the cutting edges of the grinding tool:
Identifier/parameter Meaning
GrindingMonitoring Grinding-specific tool monitoring
GrindingUseBaseLength Taking into account the base dimension when calculating the
grinding wheel radius
12.2.2.5 Magazine location parameter identifiers

For the magazine location parameters, the following identifiers are used in the configuration
file:

MagPlaceKind Location kind $TC_MPP1
MagPlaceType Location type $TC_MPP2
MagPlaceTypeIdent Location type as text $TC_MPP2
MagPlaceTNo Tool number of the tool in this location $TC_MPP6
MagPlaceWatchNeighbour Consider adjacent location $TC_MPP3
MagPlaceStateLocked Magazine location locked $TC_MPP4, Bit0
MagPlaceStateEmpty Magazine location free $TC_MPP4, Bit1
MagPlaceStateResInterMag Reserved for tool in buffer $TC_MPP4, Bit2
MagPlaceStateResLoadTool Reserved for tool to be loaded $TC_MPP4, Bit3
MagPlaceStateOccupiedLeft Magazine location occupied, left half location $TC_MPP4, Bit4
MagPlaceStateOccupiedRight Magazine location occupied, right half loca‐ $TC_MPP4, Bit5
tion
MagPlaceStateOccupiedUpper Magazine location occupied, upper half loca‐ $TC_MPP4, Bit6
tion
MagPlaceStateOccupiedDown Magazine location occupied, lower half loca‐ $TC_MPP4, Bit7
tion
MagPlaceStateReservedLeft Magazine location reserved, left half location $TC_MPP4, Bit8
MagPlaceStateReservedRight Magazine location reserved, right half location $TC_MPP4, Bit9
MagPlaceStateReservedUpper Magazine location reserved, upper half loca‐ $TC_MPP4, Bit10
tion
MagPlaceStateReservedDown Magazine location reserved, lower half loca‐ $TC_MPP4, Bit11
tion
MagPlaceMagazineNo Magazine number -
MagPlaceTypeIdx Type index $TC_MPP5
MagPlaceWearGroup Wear group number $TC_MPP5
MagPlaceAdaptNo Adapter number $TC_MPP7
MagPlaceNo Magazine location number -
MagNoMagPlaceNo Magazine number/Magazine location number -
MagPlaceUser_1, ... MagPla‐ OEM magazine location parameters 1 to 10 $TC_MPPC1, ...
ceUser_10 $TC_MPPC10
MagPlaceAppl_1, ... MagPla‐ Siemens magazine location parameters 1 to $TC_MPPCS1, ...
ceAppl_10 10 $TC_MPPCS10

Tool management
Parameter corresponds to the system variable or the system variable is the basis for this
*)
parameter.
12.2.2.6 Magazine location adapter parameter identifiers

The following identifiers are used in the configuration file for the magazine location adapter
parameters:

MagPlaceAdapterLength1 Magazine location adapter length 1 $TC_ADPT1
MagPlaceAdapterLengthGeoAx1 Magazine location adapter geometry axis 1 $TC_ADPT1
MagPlaceAdapterTrafoNo Magazine location adapter transformation $TC_ADPT4
number
*)
12.2.2.7 Multitool parameter identifiers

For the multitool parameters, the following identifiers are used in the configuration file:

MultiToolNo Number of the multitool -
MultiToolNumberOfPlaces Number of multitool locations $TC_MTPN
MultiToolNumberOfPlacesRO Number of multitool locations, only read ac‐ $TC_MTPN
cess
MultiToolIdent Name of the multitool $TC_MTP2
MultiToolInMag Magazine in which the multitool is located $A_TOOLMN
MultiToolInPlace Magazine location containing the multitool $A_TOOLMLN
MultiToolInMagInPlace Magazine number/Magazine location $A_TOOLMN /
$A_TOOLMLN
MultiToolMyMag Owner magazine of the multitool $A_MYMN
MultiToolMyPlace Owner magazine location of the multitool $A_MYMLN
MultiToolPlaceSpec Location type $TC_MTP7
MultiToolPlaceSpecIdent Location type as text $TC_MTP7
MultiToolSizeLeft Multitool size to the left in half locations $TC_MTP3
MultiToolSizeRight Multitool size to the right in half locations $TC_MTP4
MultiToolSizeUpper Multitool size to the top in half locations $TC_MTP5
MultiToolSizeDown Multitool size to the bottom in half locations $TC_MTP6
MultiToolOverSize Multitool size as fixed setting - two half lo‐ $TC_MTP3 -
cations left, two half locations right, one half $TC_MTP6
location top, one half location bottom
MultiToolPosition Multitool position $TC_MTP_POS

Tool management

MultiToolProtAreaFile File name of the multitool description which $TC_MTP_PROTA
is required to determine the protection zone
MultiToolKindOfDist Type of distance input of the multitool loca‐ $TC_MTP_KD
tions
MultiToolKindOfDistRO Type of distance input of the multitool loca‐ $TC_MTP_KD
tions, only read access
MultiToolDistAngle Type of distance input of the multitool loca‐ $TC_MTP_KD
tions as an angle
MultiToolDistAngleRO Type of distance input of the multitool loca‐ $TC_MTP_KD
tions as an angle, read only access
MultiToolState Multitool status in the hexadecimal notation $TC_MTP8
MultiToolStateEnabled Multitool status - multitool released $TC_MTP8, Bit1
MultiToolStateLocked Multitool status - multitool locked $TC_MTP8, Bit2
MultiToolStateLockedRO Multitool status - multitool locked, only read $TC_MTP8, Bit2
access
MultiToolStateInChange Multitool status - multitool is being changed $TC_MTP8, Bit5
MultiToolStateFixed Multitool status - multitool fixed location co‐ $TC_MTP8, Bit6
ded
MultiToolStateUsed Multitool status - multitool was in use $TC_MTP8, Bit7
MultiToolStateAutoReturn Multitool status - automatic return $TC_MTP8, Bit8
MultiToolStateIgnoreLocked Multitool status - do not observe locked sta‐ $TC_MTP8, Bit9
tus
MultiToolStateMarkedToUnload Multitool status - multitool is selected to be $TC_MTP8, Bit10
unloaded
MultiToolStateMarkedToLoad Multitool status - multitool is selected to be $TC_MTP8, Bit11
loaded
MultiToolStatePermanent Multitool status - multitool is a master tool $TC_MTP8, Bit12
MultiToolState1To1Exchange Multitool status - one to one replacement $TC_MTP8, Bit14
MultiToolStateHandTool Multitool status - manual tool $TC_MTP8, Bit15
MultiToolStateLockMtIfToolLock Multitool status - multitool is locked if a tool $TC_MTP8, Bit16
is locked in multitool
MultiToolUser_1, ... MultiToolUs‐ OEM multitool parameters 1 to 10 $TC_MTPC1, ...
er_10 $TC_MTPC10
MultiToolAppl_1, ... MultiToo‐ Siemens application multitool parameters $TC_MTPCS1, ...
lAppl_10 1 to 10 $TC_MTPCS10
*)
parameter.
12.2.2.8 Multitool location parameter identifiers

For the multitool location parameters, the following identifiers are used in the configuration file:

MultiToolDist Multitool location distance taking into account -
the actual type of distance input of the multitool
MultiToolDistLength Multitool location distance, length $TC_MTPPL

Tool management

MultiToolDistAngle Multitool location distance angle, angle $TC_MTPPA
MultiToolPlaceType Location type $TC_MTPP2
MultiToolPlaceTypeIdent Location type as text $TC_MTPP2
MultiToolPlaceState Multitool status in the hexadecimal notation $TC_MTPP4
MultiToolPlaceStateLocked Multitool location locked $TC_MTPP4, Bit0
MultiToolPlaceStateEmpty Multitool location empty $TC_MTPP4, Bit1
MultiToolPlaceTNo Tool number of the tool in this multitool location $TC_MTPP6
MultiToolPlaceAdaptNo Adapter number $TC_MTPP7
MultiToolPlaceNo Multitool location number -
MultiToolPlaceUser_1, … Mul‐ OEM multitool location parameters 1 to 10 $TC_MTPPC1, …
tiToolPlaceUser_10 $TC_MTPPC10
MultiToolPlaceAppl_1, … Mul‐ Siemens application multitool location parame‐ $TC_MTPPCS1, …
tiToolPlaceAppl_10 ters 1 to 10 $TC_MTPPCS10
*)
parameter.
12.2.3 Configuring list parameters
<PARAMETERCONFIGURATION> tag
In the <PARAMETERCONFIGURATION> tag, you have the following options:
1. Changing list parameters.
2. Creating new list parameters based on an existing parameter.
Changing list parameters

You can change all list parameters included in the system.
Grinding parameter identifiers (Page 157)
Magazine location parameter identifiers (Page 158)
Magazine location adapter parameter identifiers (Page 159)
Multitool parameter identifiers (Page 159)

Tool management
Multitool location parameter identifiers (Page 160)
Entries Meaning
HeadLine Column header. Text entered is displayed as a header.
Example: Text "Radius" is displayed as a header (default).
Tooltip Text that is displayed in the tooltip.
Example: Text "Geometry radius" is displayed in the tooltip (default).
ShortText Text if the parameter is displayed in the "More Data" window.
Example: Text "Rad." is displayed in the "More Data" window (default).
DetailsText Text, if the parameter is displayed in the "Details" window.
Example: Text "Radius" is displayed in the "Details" window (default).
Width Column width in pixels in relation to a 640 x 480 resolution.
See example below: The default column width is changed to 53 pixels.
DisplayMode Values that the parameter is displayed with.
See example below: The default setting is changed to "DoubleMode".
The following values can also be accepted:
AnyMode All characters
IntegerMode Integers
UnsignedIntegerMode Unsigned integers
DoubleMode Values with decimal places
The number of decimal places is specified in "Dec‐
imalPlaces"
UnsignedDoubleMode Unsigned values with decimal places
The number of decimal places is specified in "Dec‐
imalPlaces"
Length Specified length
Angle Specified angle
LinearFeedPerTime Linear feed in mm/minute
LinearFeedPerRevolution Linear feed in mm/revolution
LinearFeedPerTooth Linear feed in mm/tooth
RevolutionSpeed Speed
ConstantCuttingSpeed Constant cutting rate
DecimalPlaces Number of decimal places if "DoubleMode" or "UnsignedDoubleMode" is selected
in the DisplayMode.
See example: Two decimal places are entered.
ItemType Field types in which a value is displayed.
TextField Input/output field for values and texts
TextFieldReadOnly Output field for values and texts
CheckBox Input/output field for states
CheckBoxReadOnly Output field for states
BitMask Bit mask for the display of a bit from a value. The bit mask is entered as integer
value. Bit 0 → 1, Bit 1 → 2, Bit 2 → 4
AccessLevel Value for the access level that is used for these parameters in the user interface.
Value range 1 to 7

Tool management
Entries Meaning
UpperLimit Upper input limit for these parameters in the user interface.
Only applies for numerically entered parameters.
LowerLimit Lower input limit for these parameters in the user interface.
Only applies for numerically entered parameters.
Example
In the following example, the <GeoRadius> parameter is used.
Only enter the modified data.
<PARAMETERCONFIGURATION>
<GeoRadius>
<Width value="53" type="int" />
<DisplayMode value="DoubleMode" type="QString" />
<DecimalPlaces value="2" type="int" />
</GeoRadius>
</PARAMETERCONFIGURATION>
Configuring new list parameters based on an existing list parameter.

Assign a new parameter name and enter only the changed data:
Entries Meaning
Assign new parameter name
See example 1: Text "NewGeoRadius"
Base Name of the parameter on which the new parameter is based.
See example 1: "GeoRadius" parameter is used as a template.
Also enter only the changed data here. All other data is taken from the existing
parameter.
See example 1: Column width changed to 46 pixels. Number of decimal places
changed to 1.
Example 1
<NewGeoRadius>
<Base value="GeoRadius" type="QString" />
<DisplayMode value="DoubleMode" type="QString" />
<DecimalPlaces value="1" type="int" />
</NewGeoRadius>

Tool management
Example 2
Entries Meaning
Assign new cutting edge parameter name
The name is "EdgeUser_1_Bit0" in the following example.
Base Name of the parameter on which the new parameter is based.
In the following example, the "EdgeUser_1" parameter is used as template.
Also enter only the changed data here. All other data is taken from the existing
cutting edge parameter.
The following entries are changed:
Field type: Input/output field for states
Value output: All characters
Bit mask: Bit 0
Column width changed to 17 pixels.
Header changed to "TM_HL_EDGE_USER_1_Bit0"
Text in the tooltip changed to "TM_TT_EDGE_USER_1_Bit0"
<EdgeUser_1_Bit0>
<Base value="EdgeUser_1" type="QString" />
<ItemType value="CheckBox" type="QString" />
<DisplayMode value="AnyMode" type="QString" />
<BitMask value="1" type="int" />
<HeadLine value="TM_HL_EDGE_USER_1_Bit0" type="QString" />
<ToolTip value="TM_TT_EDGE_USER_1_Bit0" type="QString" />
</EdgeUser_1_Bit0>

Tool management
12.2.4 List of tool types
Coding of tool types for milling tools

Group with type 1xy (milling tool):
100 Milling tool according to CLDATA (DIN 66215)

110 Ballhead cutter (cylindrical die milling tool)
111 Ballhead cutter (tapered die milling tool)
120 End mill (without corner rounding)
121 End mill (with corner rounding)
130 Angle head cutter (without corner rounding)
131 Angle head cutter (with corner rounding)
140 Facing cutter
145 Thread cutter
150 Side mill
151 Saw
155 Bevel cutter (without corner rounding)
156 Bevel cutter (with corner rounding)
157 Tapered die-sinking cutter
160 Drill and thread milling cutter

Tool management
Coding of tool types for drills

Group type 2xy (drills):
200 Twist drill

205 Solid drill
210 Boring bar
220 Center drill
230 Countersink
231 Counterbore
240 Tap regular thread
241 Tap fine thread
242 Tap Whitworth thread
250 Reamer
Coding of tool types for grinding tools

Group type 4xy (grinding tools):
400 Grinding wheel circumference

410 Face grinding wheel
490 Dresser
494 Dressing roller for cylindrical grinding
495 Dressing roller for surface grinding
496 Dressing wheel for cylindrical grinding
497 Dressing wheel for surface grinding
Grinding tool types 401, 402, 403 as well as 411, 412, 413 are not listed as tool types that can
be selected. The grinding-specific tool monitoring - taking into account the basic dimension
when calculating the grinding wheel radius - is set using dedicated parameters. These
parameters act on the tool types in the usual form.
Coding of tool types for turning tools

Group type 5xy (turning tools):
500 Roughing tool

510 Finishing tool
520 Plunge cutter
530 Parting tool
540 Threading tool
550 Steel profile
560 Rotary drill (ECOCUT)
580 Orientated probe
585 Calibration tool

Tool management
Coding of tool types for special tools

Group type 7xy (special tools):
700 Slotting saw

710 3D probe
711 Edge probe
712 Mono probe
713 L probe
714 Star probe
725 Calibration tool
730 Stop
731 Spindle sleeves
732 End support
900 Auxiliary tools
12.2.5 Configure tool types
<TOOLTYPECONFIGURATION> tag
The entries used for configuring the tool types are located in the
<TOOLTYPECONFIGURATION> tag:
Entries Meaning
TOOLTYPE_XXX XXX stands for the number of the tool type.
For the assignment of the tool type and number, please refer to Section
"List of tool types (Page 165)".
Tooltype Number (XXX) of the tool type
Name Text identifier of the tool name. The tool name is displayed in the following
windows:
● "New Tool - Favorites"
● "New Tool - Milling Cutter 100 - 199"
● "New Tool - Drill 200 - 299"
● "New Tool - Grinding Tool 400 - 499"
● "New Tool - Special and Auxiliary Tools 700 - 900"
See example: For the text identifier "TM_PAR_SHANK_END_CUTTER",
the name "End mill" appears on the user interface.
Shortname Text identifier of the tool name. Tool name is displayed in the tool list.
See example: For the text identifier "TM_PPTT_SHANK_END_CUTTER",
the name "MILLING CUTTER" appears on the user interface.
Tooltip Text identifier of the tool name. This tool name is displayed in the tooltip.
See example: For the text identifier "TM_TTTT_SHANK_END_CUTTER",
the name "End mill" appears on the user interface.

Tool management
Entries Meaning
Icon9 - for milling technology Icon representing the tool type.
The icons are displayed in the following windows:
● "Tool List" in the "Type" column
● "New Tool - Favorites" in the "Tool position" column
● "New Tool - Milling Cutter 100 - 199" in the "Tool position" column
● "New Tool - Drill 200 - 299" in the "Tool position" column
● "New Tool - Special Tool 700 - 900 in the "Tool position" column.
The icons are in ".png" format. They are stored according to image res‐
olution in the following directories:
/oem/sinumerik/hmi/ico/ico640, oder ico800, or ico1024
/user/sinumerik/hmi/ico/ico640, oder ico800, or ico1024
IconX - for the turning and Icon representing the tool type (see Icon9 - for milling technology)
grinding technologies Special feature - tool positions are supported in the turning and grinding
technologies.
X is for the tool position represented by the icon. Position 9 is an unde‐
fined position represented by a cross.
Icon9_2 Icon representing the tool type in cutting edge position 9. It is used when
cutting edge position 9 is to be treated as a valid cutting edge position.
(see <SETTINGS> - CreateNewToolWithCuttPos9Enabled, Chapter
"General settings (Page 142)")
Iconorder Order in which the tool positions, represented by icons, are switched.
DisableInNewToolDialog With this entry, the tool type in question is not offered when new tools
are created. If the tool list finds a tool of this type that already exists, it is
correspondingly displayed.
DELETE_TOOLTYPE All predefined tool types that are not to be supported in the tool lists.
GrindingTooltypes All tool types that are to be used as grinding tool types.
Example 1
<TOOLTYPECONFIGURATION>
<TOOLTYPE_120>
<Tooltype value="120" type="uint" />
<Name value="TM_PAR_SHANK_END_CUTTER" type="QString" />
<Shortname value="TM_PPTT_SHANK_END_CUTTER" type="QString" />
<Tooltip value="TM_TTTT_SHANK_END_CUTTER" type="QString" />
<Icon9 value="to_poly_shank_end_cutter_down.png" type="QString" />
</TOOLTYPE_120>
</TOOLTYPECONFIGURATION>

Tool management
Example 2
<TOOLTYPECONFIGURATION>
<DELETE_TOOLTYPE>
<TOOLTYPE_110 />
</DELETE_TOOLTYPE>
</TOOLTYPECONFIGURATION>
12.2.6 Configuring the "Additional Data" window
<MOREDATACONFIGURATION> tag
The entries used for configuring the "Additional Data" window are located in the
<MOREDATACONFIGURATION> tag. Various data items can be displayed for each tool type
in a number of rows and columns. Each data item to be displayed is specified by entering a
list parameter:

Tool management
A brief description of the parameter (ShortText) then appears in the window with the value
itself beside it. Configuring list parameters (Page 161).
If another description text is required in the "More Data" window, a text can also be entered in
a row or column. In the window, the width of the text is made to conform to that of the brief
description and value of a parameter.
Any number of rows and columns can be created. A scrollbar appears when the window
reaches a certain size.
Entries Meaning
TOOLTYPE_XXX Number of the tool type.
See example: Tool type 111 = Ball end mill (tapered die-sinking cutter).
ROWX_COLY Particular rowX_columnY.
If there is no entry after rowX and columnY, this field remains blank.
See example: In the "More Data" window, the first row is blank.
Item The following entries are possible:
● Parameter identifier
● Text
See example:
The header "Corner radius" appears in the second row of the window.
The text "Radius" and an input field for the value appear in the third row of
the window.
The fourth row is blank.
TOOLTYPE_ALL_XXX The setting applies to all tool types of a group. XXX stands for the group
number of the tool types. The hundreds position is used as the group num‐
ber, for example, TOOLTYPE_ALL_100 or TOOLTYPE_ALL_200 etc. (see
example).
WITHOUT_MORE_DA‐ Tool types of a tool group for which no "further data" are to be displayed can
TA be excluded with this identifier (see example).
Example 1
<MOREDATACONFIGURATION>
<TOOLTYPE_111>
<ROW1_COL1>
</ROW1_COL1>
<ROW2_COL1>
<Item value="TM_DGL_CORNER_RADIUS" type="QString" />
</ROW2_COL1>
<ROW3_COL1>
<Item value="GeoCornerRadius" type="QString" />
</ROW3_COL1>
<ROW4_COL2>
</ROW4_COL2>
</TOOLTYPE_111>
</MOREDATACONFIGURATION>

Tool management
Example 2
<MOREDATACONFIGURATION>
<TOOLTYPE_ALL_500>
<ROW1_COL1>
<Item value="TM_DGL_LENGTH" type="QString" />
</ROW1_COL1>
<ROW2_COL1>
<Item value="GeoLengthGeoAx3" type="QString" />
</ROW2_COL1>
...
</TOOLTYPE_ALL_500>
<WITHOUT_MORE_DATA>
<TOOLTYPE_580 />
</WITHOUT_MORE_DATA>
</MOREDATACONFIGURATION>
12.2.7 Configure the "New tool - favorites" window
<NEWTOOLFAVORITECONFIGURATION> tag
In the tag <NEWTOOLFAVORITECONFIGURATION> you define the tool types that are most
frequently used. The specified tool types are displayed in the "New Tool - Favorites" window.
Entries Meaning
StaticTooltypes Numbers of tool types Enter the individual numbers, separated by blanks.
The following section describes the assignment of the tool type and num‐
ber: List of tool types (Page 165)
Example
<NEWTOOLFAVORITECONFIGURATION>
<StaticTooltypes value="120 140 200 220 710 711" type="QString"/>
</NEWTOOLFAVORITECONFIGURATION>

Tool management
12.2.8 Configuring the "New Tool" window
<NEWTOOLCONFIGURATION> tag
You use the "New Tool" dialog to supply a new tool with specific tool data before creating the
tool or before loading the tool to a magazine location. These are typically the tool size and/or
the tool location type because these parameters can no longer be changed when the tool is
loaded. It is also useful to display the tool type and the tool names in this window.
Specify the parameters in the <NEWTOOLCONFIGURATION> tag that are to be displayed in
the "New Tool" dialog.
Note
The number of parameters is limited by the size of the window.
Entries Meaning
ItemX Entry of the identifier of the tool parameter. "X" specifies the order in which the pa‐
rameters are displayed in the window.
The identifier of the tool parameter can be found in Chapter:
Example
<NEWTOOLCONFIGURATION>



<Item2 value="ToolPlaceSpec" type="QString"/>
<Item3 value="ToolSizeLeft" type="QString"/>
<Item4 value="ToolSizeRight" type="QString"/>
</NEWTOOLCONFIGURATION>
12.2.9 Configuring the "New Multitool" window
<NEWMULTITOOLCONFIGURATION> tag
You use the "New Multitool" dialog to supply a new multitool with specific multitool data before
creating the multitool or loading it into to a magazine location. Multitool data typically includes
the number of multitool locations and spacing between locations, as these parameters cannot
be changed once the multitool has been created. The same applies to the multitool size and/
or multitool location type as to the tool size and tool location type. These parameters, too,
cannot be changed once they have been loaded into the tool. It is also a good idea to display
the multitool name in this window.

Tool management
In the <NEWMULTITOOLCONFIGURATION>tag, specify the parameters that you wish to

have displayed in the "New Multitool" dialog.
Entries Meaning
ItemX Entry of the identifier of the multitool parameter. "X" specifies the order in
which the parameters will be displayed in the window.
The identifier of the multitool parameter can be found in Chapter:Multitool
parameter identifiers (Page 159)
12.2.10 Configuring the "New Tool from Code Carrier" window
<NEWTOOLIDENTCONNECTIONCONFIGURATION> tag
You use the "New Tool from Code Carrier" dialog to identify a new tool before creating it. It is
therefore a good idea to display the tool type and the tool name in this window. In addition, the
same rules apply as for configuration of the window "New Tool," Section "Configuring the "New
Tool" window (Page 172)."
In the <NEWTOOLIDENTCONNECTIONCONFIGURATION>tag, define the parameters that
you wish to have displayed in the "New Tool of Code Carrier" dialog.
Entries Meaning
12.2.11 Configuring the "New Tool from File" window
<NEWTOOLSAVETOOLDATACONFIGURATION> tag
You use the "New Tool from File" dialog to identify a new tool before creating it. It is therefore
a good idea to display the tool type and the tool name in this window. In addition, the same
rules apply as for configuration of the window "New Tool," Section "Configuring the "New Tool"
window (Page 172)."
Specify the parameters in the <NEWTOOLSAVETOOLDATACONFIGURATION>tag that are
to be displayed in the "New Tool from Tile" dialog.
Entries Meaning

Tool management
12.2.12 Configuring default values for new tools
<NEWTOOLDEFAULTVALUECONFIGURATION> tag
In the <NEWTOOLDEFAULTVALUECONFIGURATION> tag, you can specify default values
for tools that you create via the user interface. These values can be configured depending on
the tool type and, if required, also depending on the cutting edge position:
Entries Meaning
TOOLTYPE_ALL The parameter setting applies to all tool types.
TOOLTYPE_XXX The parameter setting applies to a specific tool type. XXX stands for the
number of the tool type.
CUTTEDGEPOS_XXX The parameter setting applies to a specific cutting edge position. XXX
stands for the number of the cutting edge position.
Default Default value of the parameter.
Example
<NEWTOOLDEFAULTVALUECONFIGURATION>

<TOOLTYPE_ALL>
<GeoLengthGeoAx1>
<Default value="70.0" type="double" />
</GeoLengthGeoAx1>
</TOOLTYPE_ALL>

<TOOLTYPE_200>
<NoseAngle>
</NoseAngle>
</TOOLTYPE_200>
<TOOLTYPE_500>

<PlateAngle>
</PlateAngle>

<HolderAngle>
<CUTTEDGEPOS_1>
</CUTTEDGEPOS_1>
<CUTTEDGEPOS_2>
</CUTTEDGEPOS_2>

Tool management
<CUTTEDGEPOS_3>
</CUTTEDGEPOS_3>
<CUTTEDGEPOS_4>
</CUTTEDGEPOS_4>
<CUTTEDGEPOS_5>
</CUTTEDGEPOS_5>
<CUTTEDGEPOS_6>
</CUTTEDGEPOS_6>
<CUTTEDGEPOS_7>
</CUTTEDGEPOS_7>
<CUTTEDGEPOS_8>
</CUTTEDGEPOS_8>
</HolderAngle>
</TOOLTYPE_500>

<TOOLTYPE_520>
<Coolant2>
<Default value="true" type="bool" />
</Coolant2>
</TOOLTYPE_520>
</NEWTOOLDEFAULTVALUECONFIGURATION>
Default values when creating new tools
System variables Default value

Tool size
Size on left $TC_TP3 1
Size on right $TC_TP4 1
Size above $TC_TP5 1
Size below $TC_TP6 1
Magazine location type of the tool
Created outside of the magazine $TC_TP7 1
Created in a magazine location $TC_TP7 Location type of the magazine location
Tool status
released $TC_TP8 2

Tool management
The following combinations between the cutting-edge position and the cutting direction result
dependent on the tool type. When creating the new tool, the operator selects a combination
in the "New Tool - Favorites" window.
Tool type $TC_DP1 Default values

Cutting edge $TC_DP2 Cutting direction $TC_DP11
Type 500 roughing tool 1 4
Type 510 finishing tool 2 3
Type 560 rotary drill 3 3
4 4
5 1
6 3
7 1
8 3
Type 520 plunge cutter 1 2
Type 530 cut-off tool 1 4
Grinding tool types 4 4
3 1
4 1
2 3
3 3
2 2
Type 540 threading tool 5 2
5 1
8 3
8 4
6 3
6 4
7 2
7 1
If the ShopMill/ShopTurn option is set, the direction of spindle rotation is preassigned:
Tool type $TC_DP1 Default value $TC_DP25 Direction of spindle rotation

Measuring tools
Type 580/585/710/712/713/725 Bit 8 = 0 Spindle stop
Bit 9 = 0
Turning tools dependent on SD54215 TM_FUNCTION_MASK_SET bit 1
SD54215 bit 1 = 0 Bit 8 = 1 Spindle right
Bit 9 = 0
SD54215 bit 1 = 1 Bit 8 = 0 Spindle left
Bit 9 = 1
Special tools

Tool management
Tool type $TC_DP1 Default value $TC_DP25 Direction of spindle rotation

Type 730/731/732 Bit 8 = 0 Spindle stop
Bit 9 = 0
All other tool types
- Bit 8 = 1 Spindle right
Bit 9 = 0
Tool type $TC_DP1 Default value $TC_DP25 for switching direction

Type 712 mono probe Bit 17 = 1
Bit 20 = 1
Type 713 L probe Bit 17 = 1
Bit 21 = 1
Type 714 star probe Bit 16 = 1
Bit 17 = 1
Bit 18 = 1
Bit 19 = 1
Tool type $TC_DP1 Default value $TC_DP24 for tip angle

Type 200 twist drill 118
Type 220 centering tool 90
The plate angle rather than the clearance angle is displayed on the screen:
plate angle = 180 - holder angle - clearance angle
Tool type Default values

$TC_DP1 Cutting edge position Holder angle Clearance angle
$TC_DP2 $TC_DP10 $TC_DP24
Type 500 roughing tool 1 to 4 95 5
5 to 8 50 50
Type 510 finishing tool 1 to 4 93 32
5 to 8 62.5 62.5
Type 560 rotary drill - 90 2
Tool type $TC_DP1 Unit of measure‐ Default value $TC_DP8 for plate length
ment
Type 500 roughing tool metric 11
Type 510 finishing tool inch 0.4
For all grinding tools, the parameter for calculating the radius:
$TC_TPG9 = 3 (corresponds to length 1) applies

Tool management
12.2.13 Configuring the "Details" window
<DETAILSCONFIGURATION> tag
In the tag <DETAILSCONFIGURATION>, you can make the settings for the "Detail" window:
Entries Meaning
ShowToolNumber The tool number is displayed in the upper right field of the "Detail" window.
UseAxisNameInLength The tool length is displayed with axis identifiers, for example, Length X
instead of Length 1.
If no data is specified, then the setting is taken from the tool lists.
ShowBaseLength The basic length is displayed in the "Detail" window (AdaptLength1,
AdaptLength2 and AdaptLength3).
ShowYAxis The Y axis is displayed in the "Detail" window.
AutoDisplayAxisEnabled Several components of the tool length are displayed, even if only one
tool length is displayed in the tool list.
Example
<DETAILSCONFIGURATION>
<ShowToolNumber value="true" type="bool" />
</DETAILSCONFIGURATION>
12.2.14 Assigning a name for magazines and magazine locations
<MAGAZINEPLACENAMECONFIGURATION> tag
The entries to assign dedicated magazine location names are located in the
<MAGAZINEPLACENAMECONFIGURATION> tag. Magazine locations can be displayed with
texts. Instead of the identifier, e.g. 1/5 for the first magazine, location five, the configured text
is then output in the tool lists.
Entries Meaning
MAGAZINE_XXX XXX stands for the magazine number.
PLACE_XXX XXX stands for the location number.
Name Text identifier of the magazine location.
Example
<MAGAZINEPLACENAMECONFIGURATION>
<MAGAZINE_9998>

Tool management
<PLACE_2>
<Name value="TM_SPECIAL_MAG_PLACE_1" type="QString" />
</PLACE_2>
</MAGAZINE_9998>
<MAGAZINE_1>
<PLACE_3>
<Name value="TM_SPECIAL_MAG_PLACE_2" type="QString" />
</PLACE_3>
</MAGAZINE_1>
</MAGAZINEPLACENAMECONFIGURATION>
Name for a magazine

Dedicated texts can also be allocated for magazines. The text or the text identifier is entered
into the magazine configuration file (ini file) of the NC. The system variable for the magazine
name is $TC_MAP2[magNo]. The magazine name is displayed at the top right in the tool lists.
Example
Magazine 1 should have the name "main magazine".
$TC_MAP2[1]="main magazine"
If the "main magazine" text is to be output language-dependent, then the language-dependent
texts for the text identifier "main magazine" must be created.

Tool management
See also
Please refer to the following section for the procedure to create language-dependent text:
Creating OEM texts (Page 198)
12.2.15 Configuring the "Assign Tooltips for Multitool Locations" window
<MULTITOOLPLACETOOLTIPCONFIGURATION> tag
You will find the entries for assigning tooltips in the tag
<MULTITOOLPLACETOOLTIPCONFIGURATION>. This is particularly useful if all the
multitools used on a turning machine have two locations and a fixed assignment between
multitool locations and the main spindle or the counter spindle exists, for example,
location 1 - main spindle location 2 - counter spindle. In this case, the tooltip for location 1
could be "Tool Holder for Main Spindle."
Entries Meaning
PLACE_XXX XXX stands for the multitool location number.
Tooltip Text identifier of the magazine location.
Example
<MULTITOOLPLACETOOLTIPCONFIGURATION>
<PLACE_1>
<ToolTip value="TM_HOLDER_OF_MAIN_SPINDLE" type="QString" />
</PLACE_1>
<PLACE_2>
<ToolTip value="TM_HOLDER_OF_COUNTER_SPINDLE" type="QString" />
</PLACE_2>
</MULTITOOLPLACETOOLTIPCONFIGURATION>
See also

Tool management
12.2.16 Assigning a name for magazine location types
<PLACETYPECONFIGURATION> tag
You can find entries to allocate your own location type identifiers in the tag
<PLACETYPECONFIGURATION>. Magazines and magazine location types can be displayed
with texts in the tool lists. Instead of identifier 2, e.g. for location type 2, the configured text is
then output in the tool lists.
Entries Meaning
PLACETYPEXXX XXX stands for the number of the location type.
Text Text identifier of the location type.
Tooltip Tooltip text identifier of the location type.
Example
<PLACETYPECONFIGURATION>
<PLACETYPE1>
<Text value="TM_PLACETYPE_1" type="QString" />
<Tooltip value="TM_TT_PLACETYPE_1" type="QString" />
</PLACETYPE1>
<PLACETYPE2>
</PLACETYPE2>
<PLACETYPE3>
</PLACETYPE3>
</PLACETYPECONFIGURATION>

Tool management
See also
12.2.17 Assignment of magazines and magazine locations to channels
Requirement
Turning technology or milling technology and technology extension turning have been set:
Name of the associated configuration file sltmturninglistconfig.xml or sltmmillturnlistconfig.xml.
Assignment between magazine and magazine locations and channel

With this setting, magazines and magazine locations can be assigned to channels. This makes
sense if the machine is configured so that several channels are assigned to one tool area (TOA
area). If each magazine is only used in one channel, it is possible to define this assignment
between the magazine or magazine locations and the channel here.
As a consequence of this configuration, the tool icons are output with reference to their position
depending on the channel. Every channel can be assigned a position using the channel
machine data MD52000 MCS_DISP_COORDINATE_SYSTEM. If a tool is at a magazine

Tool management
location which is assigned a channel via this configuration, then the tool icon is output
depending on this position that has been set.
This setting option is only available in turning technology and in milling technology with the
technology extension milling. This can be especially helpful if, on a multi-channel machine, a
magazine is used before the turning center and another magazine after the turning center.
This means that the tools can be entered into the tool list in a position visible for the operator.
The assignment between magazine locations and channels is useful when instead of two
magazines, two tool holders/tool spindles exist that fetch their tools from a magazine. One tool
holder is used in front of the turning center and one is used behind the turning center, so that
different views onto the tool result.
<CHANNELMAGAZINEASSIGNMENT> tag
In tag <CHANNELMAGAZINEASSIGNMENT> , you will find the entries for the assignment
between the magazines or magazine locations and the channels.
Entries Meaning
CHANNELNO_XXX XXX stands for the channel number.
Magazines Number of magazines that are assigned to the channel.
MAGAZINE_XXX Number of the magazine whose locations will be assigned to the channel.
Places Number of magazine locations that will be assigned to the channel.
Example 1
The following assignment between magazine and channel should apply:
Magazine 1-3 Channel 1

Magazine 4 Channel 2
<CHANNELMAGAZINEASSIGNMENT>
<CHANNELNO_1>
<Magazines value="1 2 3" type="QString" />
</CHANNELNO_1>
<CHANNELNO_2>
<Magazines value="4" type="QString" />
</CHANNELNO_2>
<CHANNELNO_3>
</CHANNELNO_3>
<CHANNELNO_4>
</CHANNELNO_4>
</CHANNELMAGAZINEASSIGNMENT>

Tool management
Example 2
Magazine location 1 of the buffer will be assigned to channel 1.
Magazine location 2 of the buffer will be assigned to channel 2.
<CHANNELMAGAZINEASSIGNMENT>
<CHANNELNO_1>
<MAGAZINE_9998>
<Places value="1" type="QString" />
</MAGAZINE_9998>
</CHANNELNO_1>
<CHANNELNO_2>
<MAGAZINE_9998>
</MAGAZINE_9998>
</CHANNELNO_2>
</CHANNELMAGAZINEASSIGNMENT>
12.2.18 Assignment between magazines and magazine locations and coordinate systems
Requirement
Turning technology or milling technology and technology extension turning have been set:
Name of the associated configuration file sltmturninglistconfig.xml or sltmmillturnlistconfig.xml.
Assignment between the magazine or magazine locations and the coordinate system
With this setting, magazines and magazine locations can be assigned to coordinate systems.
This is useful if the machine is configured in such a way that a magazine or magazine location
does not match the position of the coordinate system set in the channel. The assignment
between magazine or magazine location and coordinate system can be defined here.
As a consequence of this configuration, the tool icons are output with reference to their position
depending on the coordinate system.
This setting option is only available in turning technology and in milling technology with the
technology extension milling.
<COORDSYSMAGAZINEASSIGNMENT> tag
In tag <COORDSYSMAGAZINEASSIGNMENT>, you will find the entries for the assignment
between magazines or magazine locations and coordinate systems.
Entries Meaning
COORDSYSNO_XXX XXX stands for the number of the coordinate system.
Magazines Number of the magazines that are assigned to the channel.

Tool management
Entries Meaning
MAGAZINE_XXX Number of the magazine whose locations will be assigned to the coordinate
system.
Places Number of magazine locations that will be assigned to the coordinate system.
Example
The following assignment between magazines or magazine locations and coordinate systems
is to apply:
Magazine 1,3, and 4 Coordinate system 34

Magazine 2 Coordinate system 33
Magazine 9998 location 2 Coordinate system 33
<COORDSYSMAGAZINEASSIGNMENT>
<COORDSYSNO_34>
<Magazines value="1 3 4" type="QString" />
</COORDSYSNO_34>
<COORDSYSNO_33>
<MAGAZINE_9998>
</MAGAZINE_9998>
</COORDSYSNO_33>
</COORDSYSMAGAZINEASSIGNMENT>
12.2.19 Disabling the softkey depending on filters
Tag <FILTERCONFIGURATION> in combination with Tag <SOFTKEYLOCK>

Some softkeys can be hidden depending on filter settings. For example, the "New Tool" softkey
is hidden if the filter "Only disabled tools" is set. This is not a good idea because the new tool
is not created as a disabled tool and is thus directly filtered out of the display. This means that
the new tool would not be displayed after being created.
Softkey identifiers of the softkey, which can be hidden:
Entries Meaning
NewTool New tool
Edges Cutting edges

Tool management
Entries Meaning
FirstEdge Filter "Only first cutting edge," default setting "Edges"
StandBy Filter "Only tools that are ready to use," default setting "NewTool"
Active Filter "Only tools with active code," default setting "NewTool"
Locked Filter "Only disabled tools," default setting "NewTool"
Prewarning Filter "Only tools that have reached the pre-alarm limit," default setting "New‐
Tool"
RemainingPieces Filter "Only tools with remaining quantity," default setting "NewTool Edges"
MarkedToUnload Filter "Only tools with unload identifier," default setting "NewTool Edges"
MarkedToLoad Filter "Only tools with load identifier," default setting "NewTool Edges"
Example
<FILTERCONFIGURATION>
<SOFTKEYLOCK>
<Locked value="NewTool Edges" type="QString" />
</SOFTKEYLOCK>
</FILTERCONFIGURATION>
12.2.20 Configuring the "Load Station Selection" window
<LOADSTATIONSHANDLEALLTOOLS> tag
For functions "Delete all," "Unload all," and "Load all," you must specify a load station if multiple
load stations are configured in the magazine configuration of the NC. The load station is defined
in a dialog called "Select Load Station" or via the load station configuration with tag
<LOADSTATIONSHANDLEALLTOOLS>.
Entries Meaning
DialogEnabled Offer window "Load Station Selection," default setting "true"
MAGAZINE_XXX Number of the magazine to which a load station will be assigned.
LoadStation Load station to be assigned to the magazine.
Example
<LOADSTATIONSHANDLEALLTOOLS>
<DialogEnabled value="true" type="bool" />
<MAGAZINE_1>
<LoadStation value="2" type="uint" />
</MAGAZINE_1>
<MAGAZINE_2>
<LoadStation value="1" type="uint" />

Tool management
</MAGAZINE_2>
</LOADSTATIONSHANDLEALLTOOLS>
12.2.21 Coolant and tool-specific functions
Assigning coolant (ShopMill/ShopTurn)

In the tool management of ShopMill/ShopTurn, you can assign coolant and tool-specific
functions to each tool. These are activated when the tool is changed. You assign the coolant
to the corresponding machine functions (M functions) using the following machine data:
MD52230 $MCS_M_CODE_ALL_COOLANTS_OFF M code for all coolants OFF

MD52231 $MCS_M_CODE_COOLANT_1_ON M code for coolant 1 ON
MD52232 $MCS_M_CODE_COOLANT_2_ON M code for coolant 2 ON
MD52233 $MCS_M_CODE_COOLANT_1_AND_2_ON M code for both coolants ON
Tool-specific functions (ShopMill)

Tool-specific functions 1 ... 4 are intended for other M functions that can be activated for a tool,
for example, third coolant, speed monitoring, tool breakage, etc.
Up to eight M functions can be programmed for the activation or deactivation of the tool-specific
functions. Definition is realized using the following machine data:
MD52281 $MCS_TOOL_MCODE_FUNC_ON[0...3] M code for tool-specific function ON

=-1
MD52282 $MCS_TOOL_MCODE_FUNC_OFF[0...3] M code for tool-specific function OFF

=-1
The M functions for the tool-specific functions are executed by the ShopMill cycles at the tool
change. If the checkbox is activated, the corresponding M code is generated from MD52281.
If the checkbox is not activated, the corresponding M code is generated from MD52282.
If you do not want to automatically execute additional M commands at the tool change, then
set the associated machine data to -1 for the M commands of this tool-specific function. This
also hides the associated fields in the tool list.
The default value of the machine data is -1 so that no M values are output for the corresponding
functions.
Technical procedure
The M functions for the tool-specific functions are generated by the ShopMill cycles in a set
(up to four M commands are possible).
The number and also the sequence of the M commands are dependent on the settings of the
machine data (MD52281 to MD52282) and the programming.

Tool management
If M functions less than 100 are used, the number and sequence of the M commands has no
significance. They are located in the user PLC in the decoded area (DB21.DBB194 to
DB21.DBB206), independent of the number and the sequence when programming.
However, if M functions from 100 and higher are used, then you must decode these yourself
in the user PLC. In this case, you must take into consideration the number and sequence (M
function 1 to M function 4).
JOG mode
In the JOG mode, no coolant and tool-specific functions are output to the interface. For a tool
change in the JOG mode, these functions can be initiated by the operator using the keys on
the machine control panel (implementation via the PLC user program).
Example: Machine data settings
MD52281 $MCS_TOOL_MCODE_FUNC_ON[0] = 90
MD52282 $MCS_TOOL_MCODE_FUNC_OFF[0] = 91
MD52282 $MCS_TOOL_MCODE_FUNC_OFF[1] =-1
As a result, fields 1 to 4 of the tool-specific functions are displayed in the tool list.
The following fields are activated:
Tool-specific function 1: On
Tool-specific function 2: Off
The M functions M90, M95 and M97 are generated by the ShopMill cycles at the tool change.
You can change the texts for "Coolant 1/2 on/off" and "Tool-spec. fct. 1, ..." (see Section
Identifiers of the standard texts (Page 199)). So that the texts between the tool list and program
area machine functions match, please note the following section.
Creating user-specific texts for the "Machine Functions" window.

If you require an additional possibility of switching on or switching off coolant and tool-specific
functions, then you can program this in the "Program" operating area using the input window
"Machine Functions". You can create the texts and the tooltips for the tool-specific functions
which are used in this window.
Define the texts for the M functions in the file "slstepforms_xxx.ts".

Tool management
If you require the texts in additional languages, then you must create a separate file for each
language. The names of the files only differ by the language code "xxx" (Supported
languages (Page 612)). Use only the specified language codes.
File "slstepforms_xxx.ts "
Tag Meaning
source Text identifier for label: SlStepLabels
A maximum of up to four M functions can be defined:
T_LAB_USER_MACHINE_FUNC_1
Text identifier for tooltip: SlStepToolTip
There are 3 tooltips for every machine function x (1 - 4):
T_TT_USER_MACHINE_FUNC_x: Standard tooltip if the machine function was not
selected.
T_TT_USER_MACHINE_FUNC_x _ON: Tooltip when the machine function is acti‐
vated
T_TT_USER_MACHINE_FUNC_x_OFF: Tooltip for deactivated machine function
translation Text, which is displayed at the user interface.
Label texts: You can only enter texts on one line. The "lines" entry is not applicable.
Tooltip: You can enter multi-line texts. A line break is set using the "%n" character.
chars Text length
The maximum text length is 30 characters.
lines Number of lines
The maximum number of lines is three.
remark Own comment - entry is not displayed at the user interface.
Procedure
1. You can copy the sample file "oem_slstepforms_deu.ts" from the following directory: /
siemens/sinumerik/hmi/template/lng
2. Save or create the file in the /oem/sinumerik/hmi/lng or /user/sinumerik/hmi/lng directory.
3. Change the file name to "slstepforms_deu.ts".
If you require texts for additional languages, then a separate file must be created for each
language. Save the file with the appropriate language code in the file name.
4. Open the file and define the texts in the <message> and </message> areas.
5. Restart the system.
The file must still be converted into a binary format in order that the texts are displayed
during the program runtime. This data is only converted during power up.

Tool management
Example of a file "slstepforms_deu.ts"

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE TS><TS>
<context>
<name>SlStepLabels</name>
<message>
<source>T_LAB_USER_MACHINE_FUNC_1</source>
<translation>tool-specific function 1</translation>
<chars>20</chars>
</message>
<context>
<name>SlStepToolTip</name>

<message>
<source>T_TT_USER_MACHINE_FUNC_1</source>
<translation>User%nMachine functions 1</translation>
<chars>25</chars>
<lines>3</lines>
</message>
</context
</TS>
12.2.22 Reason for the tool change when reactivating
Precondition
Software option
You require the "MC Information System TDI Statistic" option for this function
Function
When reactivating a tool, you have the option of specifying the reason for the tool change, e.g.
to use this information for statistical purposes. The "Reason for Tool Change" selection window
is opened after pressing the "Reactivate" softkey. In a checkbox, you can select the reason
for the tool change. The tool change is entered in a tool parameter to be configured or in a
local variable of the SlCap service.

Tool management
Tool change reasons

You can adapt or expand the tool change reasons as required. The operating software provides
the following pre-defined texts for the configuration:
Text identifier Text

TM_DGL_DESIRED_PIECES_ELAPSED Unit quantity setpoint (desired pieces) elapsed
TM_DGL_TOOL_BREAKAGE Tool breakage
TM_DGL_CUTTING_EDGE_DAMAGE Cutting edge damage
TM_DGL_PREMATURE_WEAR Premature wear
TM_DGL_TYPE_REEQUIPPING Type reequipping
TM_DGL_TOOL_TRIAL Tool trial
TM_DGL_PREVENTIVE_CHANGE Preventive change
<TOOLCHANGEREASON> tag
You configure the function in the <TOOLCHANGEREASON> tag:
Parameter Designation
Enabled True - "Reason for tool change" selection window is displayed when
reactivating.
False - default value, selection window is not displayed.
OnlyOneReasonAllowed It is only permissible to select one tool change reason.
UseCapLocalParameter The reason for the tool change is entered into a local variable of the
SlCap service.
REASONXXX XXX stands for an internal number. The numbers for the tool change
reason must be clear and unique.
Text Text identifier of the tool change reason.
Parameter Parameter identifier of the parameter in which it is entered whether the
tool change reason was selected.
BitMask Bit mask to enter the reason for the change in the local variable of the
SlCap service. The bit mask is entered as integer value. Bit 0 → 1,
bit 1 → 2, bit 2 → 4
Local variable of the SICap service

The identifier of the local variables is called "/Hmi/ToolEdgeReplacementReason". The
variable is the string type.
The table below lists the most important arguments and their significance:
Argument Meaning
datetime Date and time of the event
containerNo Number of the management area
toaNo Number of the TO area
toolNo Tool number
edgeNo Cutting edge number
toolIdent Tool name

Tool management
Argument Meaning
toolDuplo Replacement tool number
ncuName Name of the NCU
reactivationReason Reason for tool change
monitoringMode Monitoring type
remainingBefore Remaining unit quantity/tool lifetime before reactivation
Example 1
The following example uses the texts for the tool change reason, already prepared in the
operating software. In this example, the tool change reason is stored in parameters that still
have to be configured, e.g. the OEM tool data 1, bit 1 and following.
<TOOLCHANGEREASON>
<REASON1>
<Text value="TM_DGL_DESIRED_PIECES_ELAPSED" type="QString" />
<Parameter value="ToolUser_1_Bit1" type="QString" />
</REASON1>
<REASON2>
<Text value="TM_DGL_TOOL_BREAKAGE" type="QString" />
</REASON2>
<REASON3>
<Text value="TM_DGL_CUTTING_EDGE_DAMAGE" type="QString" />
</REASON3>
<REASON4>
<Text value="TM_DGL_PREMATURE_WEAR" type="QString" />
</REASON4>
<REASON5>
<Text value="TM_DGL_TYPE_REEQUIPPING" type="QString" />
</REASON5>
<REASON6>
<Text value="TM_DGL_TOOL_TRIAL" type="QString" />
</REASON6>
<REASON7>
<Text value="TM_DGL_PREVENTIVE_CHANGE" type="QString" />
</REASON7>
</TOOLCHANGEREASON>

Tool management
Example 2
Also in this example, the prepared texts for the reason for the change are used. It is only
permitted to enter one reason for the change as a valid entry. The reason for the tool change
is saved in the local variable of the SlCap service.
<TOOLCHANGEREASON>
<OnlyOneReasonAllowed value="true" type="bool" />
<UseCapLocalParameter value="true" type="bool" />
<REASON1>
<Text value="TM_DGL_DESIRED_PIECES_ELAPSED" type="QString" />
</REASON1>
<REASON2>
<Text value="TM_DGL_TOOL_BREAKAGE" type="QString" />
</REASON2>
<REASON3>
<Text value="TM_DGL_CUTTING_EDGE_DAMAGE" type="QString" />
</REASON3>
<REASON4>
<Text value="TM_DGL_PREMATURE_WEAR" type="QString" />
</REASON4>
<REASON5>
<Text value="TM_DGL_TYPE_REEQUIPPING" type="QString" />
</REASON5>
<REASON6>
<Text value="TM_DGL_TOOL_TRIAL" type="QString" />
</REASON6>
<REASON7>
<Text value="TM_DGL_PREVENTIVE_CHANGE" type="QString" />
</REASON7>
</TOOLCHANGEREASON>
See also
For configuring new parameters, see Configuring list parameters (Page 161).

Tool management
12.2.23 Configure the code carrier connection
Requirement
Software option
You require the "Access MyTool ID" option for this function (Tool Ident Connec‐
tion).
<IDENTCONNECTIONCONFIGURATION> tag
The entries used for configuring the code carrier connection in the tool list of the user interface
are located in the <IDENTCONNECTIONCONFIGURATION> tag. The code carrier
connection is implemented via TDI Ident Connection.

Tool management
The following functions in the tool list are available:

1. Creating tools for the code carrier:
Figure 12-1 New tool from code carrier
The data of the tool are read from the code carrier tool and displayed in the "New Tool"
window. Click OK to create the tool in the NC and to initialize it with the code carrier data.
2. Unloading tools on the code carrier:
The tool is unloaded and the data of the tool is written to the code carrier. The tool can also
be deleted using a setting (see below).
3. Deleting the tool on the code carrier:
The tool is unloaded and the data of the tool is written to the code carrier. The tool is then
deleted from the NC. Using a setting (see below), the "On code carrier" softkey can also
be hidden for deleting a tool.
The following settings can be made:
Entries Meaning
Enabled true - code carrier connection is offered.
false - code carrier connection is not offered.
ShowInternalMessage true - internal messages for error analysis are also displayed.
false - default setting, no internal messages are displayed.
UnloadWithoutIdentconnection true - The "On code carrier" function is not offered during unload‐
ing. It is displayed during "Delete tool."
false - Default setting, the "On code carrier" function is offered
during unloading.

Tool management
Entries Meaning
UnloadWithDelete true - the tool is deleted when unloaded to the code carrier. The
"On code carrier" function is not offered for "Delete tool".
false - default setting, the tool is only unloaded for "unload to code
carrier" and remains in the NC memory.
OnlyInLoadStation true - default setting, on the one hand, only loaded tools are stored
"on code carrier", on the other hand, new tools "from code carrier"
can be created only directly in the magazine.
false - tools can be created independently of the "from code car‐
rier" magazine slot or deleted "on code carrier".
CreateNewToolWithDialog true - default setting, before creating the tool for code carrier, the
tool data is displayed in the "New Tool" window.
false - the tool is created directly in the tool list.
ForceSisterToolNumber true - The sister tool number specified by the code carrier data is
kept when the tool is created.
false - Default setting, the sister tool number is freely assigned.
UseDefaultData true - The new tool is initialized with the configured default data
before the code carrier data are applied (see tag <NEWTOOL‐
DEFAULTVALUECONFIGURATION> Section "Configuring de‐
fault values for new tools (Page 174)").
false - Default setting, the new tool is not initialized with the con‐
figured default data.
OrderFirstWriteThanUnload true - During unloading/deletion, first the data are written to the
code carrier and then the tool is unloaded or deleted.
false - Default setting, during unloading/deletion first the tool is
unloaded, then the data are written to the code carrier and finally,
if requested, the tool is deleted.
Example
<IDENTCONNECTIONCONFIGURATION>
<ShowInternalMessage value="false" type="bool" />
<UnloadWithDelete value="false" type="bool" />
<OnlyInLoadStation value="true" type="bool" />
<CreateNewToolWithDialog value="true" type="bool" />
</IDENTCONNECTIONCONFIGURATION>
References
For further information about tool management, please refer to:
Function Manual, SINUMERIK Integrate Access MyTool Ident Connection
(MCIS TDI Ident Connection)

Tool management
12.2.24 Configuring Save to file
<SAVETOOLDATACONFIGURATION> tag
The entries used for configuring the functions "Save tools to file" or "Create tools from file" are
located in the <SAVETOOLDATACONFIGURATION> tag:
The following functions in the tool list are available:
1. Creating tools from file:
Figure 12-2 Tool from file
The data of the tool are read from a file and displayed in the "New Tool" window. Click OK
to create the tool in the NC and to initialize it with the data from the file.
2. Unloading tools into a file:
The tool is unloaded and the data of the tool are written to a file. The tool can also be deleted
using a setting (see below).
3. Deleting the tool in a file:
The tool is unloaded and the data of the tool are written to a file. The tool is then deleted
from the NC. The softkey "In File" can be hidden while the tool is deleted by means of a
setting (see below).

Tool management
12.3 Creating OEM texts
The following settings can be made:
Entries Meaning
Enabled true - Tool from/in file is offered.
false - Tool from/in file is not offered.
UnloadWithDelete true - The tool is deleted when unloaded to a file. The "In File" function
is not offered for "Delete tool."
false - Default setting, on Unload to file the tool is only unloaded and is
kept in the NC memory.
CreateNewToolWithDialog true - Default setting, before the tool is created from a file, the tool data
is displayed in the "New Tool" window.
false - The tool is created directly in the tool list.
ForceSisterToolNumber true - The sister tool number specified by the code carrier data is kept
when the tool is created.
false - Default setting, the sister tool number is freely assigned.
UseDefaultData true - The new tool is initialized with the configured default data before
the data are taken over from the file (see tag <NEWTOOLDEFAULTVA‐
LUECONFIGURATION> Section "Configuring default values for new
tools (Page 174)").
false - Default setting, the new tool is not initialized with the configured
default data.
Overview
This section describes how you create OEM texts in a particular language.
The texts are created in the "sltmlistdialog_xxx.ts" file.
A dedicated file must be created for each language. The file names differ by the language code
(Supported languages (Page 612)). For "xxx", set the appropriate language code.

Tool management
Creating texts
All OEM texts from the previous sections, such as the tooltip, can be made language-
dependent by using the OEM text as text identifier under the "source" tag. The translation of
the text in the particular language is entered under the "translation" tag.
Entries Meaning
source Text identifier
See 1st example: Single-line text with new text identifier "MY_NEW_TEXT".
See 2nd example: Double-line text with new text identifier
"MY_NEW_TEXT_2_LINES".
translation Text, which is displayed on the user interface.
You can enter single and multi-line texts. "%n" is used to indicate a line break.
See 1st example: Single-line text "My new text" is displayed.
See 2nd example: Double-line text "My new - text" is displayed.
chars Text length
See 1st example: Text length of 30 characters is specified.
See 2nd example: Text length of 10 characters per line is specified.
lines Number of lines
See 2nd example: The number of rows is 2.
remark Own comments - are not displayed.
Procedure
1. You can copy the sample file "oem_sltmlistdialog_eng.ts" from the following directory: /
2. Save the file in the /oem/sinumerik/hmi/lng or /user/sinumerik/hmi/lng directory.
3. Change the file name to "sltmlistdialog_eng.ts".
If you wish to create texts for additional languages, then a separate file must be created
for each language. Save the file with the appropriate language code in the file name.
4. Open the file and define the texts in the <message> and </message> areas.
5. Restart the system.
The file must still be converted into a binary format in order that the texts are displayed
12.3.1 Identifiers of the standard texts
Identifiers of the standard texts

With the help of the identifiers, you can change the standard texts of OEM parameters, coolants
and tool-specific functions. This applies to the column header in the tool lists, the tooltip and,
if available, also the designation in the detail displays.
A list of the text identifiers is provided below:

Tool management
OEM tool parameters

"ToolUser_1" to "ToolUser_10"
"ToolAppl_1" to "ToolAppl_10"
Text identifier of the column heading Text identifier of the tooltip

TM_HL_TOOL_USER_1 to ...10 TM_TT_TOOL_USER_1 to ...10
TM_HL_TOOL_APPL_1 to ...10 TM_TT_TOOL_APPL_1 to ...10
Text identifiers in tool details Text identifiers in tool details - all parameters
TM_HL_TOOL_USER_1_DETAILS to ...10_DETAILS TM_HL_TOOL_USER_1_LONG to ...10_LONG
TM_HL_TOOL_APPL_1_DETAILS to ...10_DETAILS TM_HL_TOOL_APPL_1_LONG to ...10_LONG
OEM cutting edge parameters

"EdgeUser_1" to "EdgeUser_10"
"EdgeAppl_1" to "EdgeAppl_10"

TM_HL_EDGE_USER_1 to ...10 TM_TT_EDGE_USER_1 to ...10
TM_HL_EDGE_APPL_1 to ...10 TM_TT_EDGE_APPL_1 to ...10
TM_HL_EDGE_USER_1_DETAILS to ...10_DETAILS TM_HL_EDGE_USER_1_LONG to ...10_LONG
TM_HL_EDGE_APPL_1_DETAILS to ...10_DETAILS TM_HL_EDGE_APPL_1_LONG to ...10_LONG
OEM monitoring parameters

"EdgeSupUser_1" to "EdgeSupUser_10"
"EdgeSupAppl_1" to "EdgeSupAppl_10"

TM_HL_EDGE_SUPUSER_1 to ...10 TM_TT_EDGE_SUPUSER_1 to ...10
TM_HL_EDGE_SUPAPPL_1 to ...10 TM_TT_EDGE_SUPAPPL_1 to ...10
TM_HL_EDGE_SUPUSER_1_DETAILS to ...10_DETAILS TM_HL_EDGE_SUPUSER_1_LONG to ...10_LONG
TM_HL_EDGE_SUPAPPL_1_DETAILS to ...10_DETAILS TM_HL_EDGE_SUPAPPL_1_LONG to ...10_LONG
OEM multitool parameters

"MultiToolUser_1" to "MultiToolUser_10"

Tool management
"MultiToolAppl_1" to "MultiToolAppl_10"

TM_HL_MULTITOOL_USER_1 to ...10 TM_TT_MULTITOOL_USER_1 to ...10
TM_HL_MULTITOOL_APPL_1 to ...10 TM_TT_MULTITOOL_APPL_1 to ...10
TM_HL_MULTITOOL_USER_1_DETAILS to ... TM_HL_MULTITOOL_USER_1_LONG to ...10_LONG
10_DETAILS
TM_HL_MULTITOOL_APPL_1_DETAILS to ... TM_HL_MULTITOOL_APPL_1_LONG to ...10_LONG
10_DETAILS
OEM magazine location parameters

"MagPlaceUser_1" to "MagPlaceUser_10"
"MagPlaceAppl_1" to "MagPlaceAppl_10"

TM_HL_MAGPLACE_USER_1 to ...10 TM_TT_MAGPLACE_USER_1 to ...10
TM_HL_MAGPLACE_APPL_1 to ...10 TM_TT_MAGPLACE_APPL_1 to ...10
OEM multitool location parameters

"MultiToolPlaceUser_1" to "MultiToolPlaceUser_10"
"MultiToolPlaceAppl_1" to "MultiToolPlaceAppl_10"

TM_HL_MTPLACE_USER_1 to ...10 TM_TT_MTPLACE_USER_1 to ...10
TM_HL_MTPLACE_APPL_1 to ...10 TM_TT_MTPLACE_APPL_1 to ...10
Coolant and tool-specific functions

"Coolant1" and "Coolant2"
"MFunction1" to "MFunction4"

No column TM_TT_STATE_COOL_1 and ...2
TM_HL_MFCT1 to ...4 TM_TT_MFCT1 to ...4

Tool management
12.3.2 Examples of OEM texts
Example 1 with a single-line and double-line text

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE TS><TS>


<context>
<name>SlTmListForm</name>














</context>
</TS>
Example 2
A new parameter is configured in the following example from Section Configuring list
parameters (Page 161):
<EdgeUser_1_Bit0>
<Base value="EdgeUser_1" type="QString" />

Tool management

<DisplayMode value="AnyMode" type="QString" />
<HeadLine value="TM_HL_EDGE_USER_1_Bit0" type="QString" />
<ToolTip value="TM_TT_EDGE_USER_1_Bit0" type="QString" />
</EdgeUser_1_Bit0>
The two texts under HeadLine and ToolTip should be output depending on the language. To
do this, the two text identifiers must be included in the sltmlistdialog_xxx.ts file:

<!DOCTYPE TS><TS>


<context>






<message>
<source>TM_HL_EDGE_USER_1_Bit0</source>
<translation>heavy %n tool</translation>
<chars>10</chars>
<lines>2</lines>
</message>



<message>
<source>TM_TT_EDGE_USER_1_Bit0</source>
<translation>heavy tool</translation>
<chars>20</chars>
</message>



</context>
</TS>

Tool management
12.4 Examples
12.4 Examples
12.4.1 Example: Configuring an OEM tool list
12.4.1.1 Adapting the configuration file

The following excerpt shows the contents of the configuration file:
● Milling technology: sltmlistconfig.xml
● Turning technology: sltmturninglistconfig.xml
The file in this example is stored in the "user/sinumerik/hmi/cfg" directory.
This example describes a configuration of the OEM tool list.
● OEM tool parameter 1 is displayed in column 6.
● A new "Coolant 3" parameter is inserted in column 7 that displays bit 0 from OEM tool
parameter 2.
● OEM cutting edge parameter 1 is displayed in column 8.
Example
"sltmlistconfig.xml" or "sltmturninglistconfig.xml" file:

<CONFIGURATION>

<LISTCONFIGURATION>

<SlTmTooloemForm>



<COLUMN6>
<TOOLTYPE_ALL>

<Item value="ToolUser_1" type="QString" />
</TOOLTYPE_ALL>
</COLUMN6>

<COLUMN7>
<TOOLTYPE_ALL>

Tool management
12.4 Examples



<Item value="PriorTool" type="QString" />
</TOOLTYPE_ALL>
</COLUMN7>

<COLUMN8>
<TOOLTYPE_ALL>

<Item value="EdgeUser_1" type="QString" />
</TOOLTYPE_ALL>
</COLUMN8>
</SlTmTooloemForm>


<ToolUser_1>


<DisplayMode value="UnsignedIntegerMode" type="QString" />
</ToolUser_1>


<PriorTool>

<Base value="ToolUser_2" type="QString" />


<HeadLine value="TMO_HL_PRIOR_TOOL" type="QString" />

<ToolTip value="TMO_TT_PRIOR_TOOL" type="QString" />




</PriorTool>
</CONFIGURATION>

Tool management
12.4 Examples
12.4.1.2 Adaptation of the customer text file

The following excerpt shows the contents of the "sltmlistdialog_eng.ts" customer text file.
The file in this example is stored in the "user/sinumerik/hmi/lng" directory.
Example
"sltmlistdialog_eng.ts" file:

<!DOCTYPE TS><TS>




<context>







<message>

<source>TM_HL_TOOL_USER_1</source>

<translation>%nweight</translation>

<remark>priority tool</remark>


<chars>7</chars>

<lines>2</lines>
</message>


<message>
<source>TM_TT_TOOL_USER_1</source>
<translation>weight of the tool</translation>
<chars>35</chars>
<lines>2</lines>

Tool management
12.4 Examples
</message>


<message>
<source>TMO_HL_PRIOR_TOOL</source>
<translation>V</translation>
<remark>priority tool</remark>
<chars>1</chars>
<lines>2</lines>
</message>


<message>
<source>TMO_TT_PRIOR_TOOL</source>
<translation>priority tool, %nuse tool preferably< /translation>
<chars>35</chars>
<lines>3</lines>
</message>


<message>
<source>TM_HL_EDGE_USER_1</source>
<translation>maximum%nwidth</translation>
<chars>8</chars>
<lines>2</lines>
</message>


<message>
<source>TM_TT_EDGE_USER_1</source>
<translation>maximum width%nof the tool%noverall</translation>
<chars>35</chars>
<lines>2</lines>
</message>




</context>
</TS>

Tool management
12.4 Examples
12.4.2 Example: Configuring magazine location types with names
12.4.2.1 Adapting the configuration file

The following excerpt shows the contents of the configuration file:
● Milling technology: sltmlistconfig.xml
● Turning technology: sltmturninglistconfig.xml
The file in this example is stored in the "user/sinumerik/hmi/cfg" directory.
This example describes a configuration of the location types in the magazine list.
In this example, the magazine location type and the tool location type are to be displayed as
a toggle field with plain texts.
The assignment of the parameters to the columns of the list is made in the
"LISTCONFIGURATION" area. The magazine location type is displayed in column 10. The
tool location type is displayed in column 11.
The texts to the location types are assigned in the "PLACETYPECONFIGURATION" area.
The number of the location type is the number at the end of the "PLACETYPE" identifier.
A text identifier for a toggle box entry and a text identifier for a tooltip can be stored for each
location type.
Example
"sltmlistconfig.xml" or "sltmturninglistconfig.xml" file:

<CONFIGURATION>

<LISTCONFIGURATION>


<COLUMN10>
<TOOLTYPE_ALL>
<Item value="MagPlaceTypeIdent" type="QString" />
</TOOLTYPE_ALL>
</COLUMN10>

<COLUMN11>
<TOOLTYPE_ALL>
<Item value="ToolPlaceSpecIdent" type="QString" />
</TOOLTYPE_ALL>

Tool management
12.4 Examples

<TOOLTYPE_9997>
<Item value="MultiToolPlaceSpecIdent" type="QString" />
</TOOLTYPE_9997>
</COLUMN11>

<PLACETYPECONFIGURATION>

<PLACETYPE1>

<Text value="TMMP_ITEM_NORMAL_TOOL" type="QString" />

<Tooltip value="TMMP_TT_NORMAL_TOOL" type="QString" />
</PLACETYPE1>
<PLACETYPE2>
<Text value="TMMP_ITEM_HEAVY_TOOL" type="QString" />
<Tooltip value="TMMP_TT_HEAVY_TOOL" type="QString" />
</PLACETYPE2>
<PLACETYPE3>
<Text value="TMMP_ITEM_BIG_TOOL" type="QString" />
<Tooltip value="TMMP_TT_BIG_TOOL" type="QString" />
</PLACETYPE3>
<PLACETYPE4>
<Text value="TMMP_ITEM_SENSITIVE_TOOL" type="QString" />
<Tooltip value="TMMP_TT_SENSITIVE_TOOL" type="QString" />
</PLACETYPE4>
</PLACETYPECONFIGURATION>
</CONFIGURATION>
12.4.2.2 Adaptation of the customer text file

The following excerpt shows the contents of the "sltmlistdialog_eng.ts" customer text file.
The file in this example is stored in the "user/sinumerik/hmi/lng" directory.

Tool management
12.4 Examples
Example
"sltmlistdialog_eng.ts" file:

<!DOCTYPE TS><TS>




<context>






<message>

<source>TMMP_ITEM_NORMAL_TOOL</source>

<translation>normal</translation>

<chars>9</chars>
</message>


<message>
<source>TMMP_TT_NORMAL_TOOL</source>
<translation>normal tool,%nno restrictions</translation>
<chars>35</chars>
<lines>2</lines>
</message>

<message>
<source>TMMP_ITEM_HEAVY_TOOL</source>
<translation>heavy</translation>
<chars>9</chars>
</message>

<message>

Tool management
12.4 Examples
<source>TMMP_TT_HEAVY_TOOL</source>
<translation>heavy tool</translation>
<chars>35</chars>
<lines>2</lines>
</message>

<message>
<source>TMMP_TT_BIG_TOOL</source>
<translation>big</translation>
<chars>9</chars>
</message>

<message>
<source>TMMP_TT_BIG_TOOL</source>
<translation>big tool</translation>
<chars>35</chars>
<lines>2</lines>
</message>

<message>
<source>TMMP_ITEM_SENSITIVE_TOOL</source>
<translation>sensitive</translation>
<chars>9</chars>
</message>

<message>
<source>TMMP_TT_SENSITIVE_TOOL</source>
<translation>Notice: Tool can%nbe destroyed easily</translation>
<chars>35</chars>
<lines>2</lines>
</message>




</context>
</TS>

Tool management
12.5 Working with two tool holders

It is possible to work on a single turning machine with two tool holders, both of which are
mounted on an X axis. The tool holders may be revolvers, multifix, or a combination of both.
As both tool adapters are mounted on the same axis it is only possible to machine with one
tool. The workpiece is located between the two tool adapters.
All tools have the same reference point (on tool holder 1) irrespective of which tool holder they
are on. Consequently, the tool lengths of the second tool holder are always longer than the
tool lengths of the first tool holder. The main machining is performed in the negative X axis
direction.
7RROKROGHU
[ :RUNSLHFHFRRUGLQDWH
V\VWHPZKHQ
/
VWWRROKROGHULVXVHG
/
/ 0'a/
]
:RUNSLHFHFRRUGLQDWH
V\VWHPZKHQ
QGWRROKROGHULVXVHG
[
7RROKROGHU
Tool holder definition

The MD52248 REV_2_BORDER_TOOL_LENGTH defines a tool length limit X so that the tools
can be assigned to the two tool holders automatically:
Tool length X < MD52248: Tool belongs to the 1st tool holder
Tool length X ≥ MD52248: Tool belongs to the 2nd tool holder

For the used mirrorings of the X and Y axes and the offsets of the C axis, the following machine
data has to be configured:
MD24006 $MC_CHSFRAME_RESET_MASK Active system frames after RESET

Bit 4 = 1 System frame for workpiece reference remains active after RESET

Tool management
MD24007 $MC_CHSFRAME_RESET_CLEAR_MASK Clear system frames after RESET

Bit 4 = 0 Do not clear system frame workpiece reference after RESET
MD28082 $MC_MM_SYSTEM_FRAME_MASK Setting-up system frames (SRAM)

Bit 4 = 1 Workpiece reference ($P_WPFRAME)
MD28083 $MC_MM_SYSTEM_DATAFRAME_MASK Setting-up data management, system

frames (SRAM)
Due to the coordinate system being mirrored, the following machine/setting data must be set:
MD21202 $MC_LIFTFAST_WITH_MIRROR Lift fast with mirror

=1 For the determination of the lifting direction, it is also mirrored for active mirroring. The
mirroring of the lifting direction only refers to the direction components perpendicular to
the tool direction.
SD42900 $SC_MIRROR_TOOL_LENGTH Sign change, tool length when mirroring

=0 The signs of the tool length components are independent of system frames with mirroring.
SD42910 $SC_MIRROR_TOOL_WEAR Sign change, tool wear when mirroring

=1 Inverting the sign mirrors the wear values of the tool length components whose associated
axes are mirrored.
Settings for ShopTurn programs

In ShopTurn, MD21202, SD42900, and SD42910 are automatically set for the necessary
mirroring.
Settings for G code programs

Additional settings must be made if the functions of the second tool holder with mirroring of
the X axis are also to be active for G code programs and tool calls from the T,S,M screenform:
MD10717 $MN_T_NO_FCT_CYCLE_NAME="F_T_REV2"
MD15710 $MN_TCA_CYCLE_NAME="F_T_REV2"
Note
The settings of MD10717 and MD15710 cannot be used if old G code programs are available
and will be used without modification for the second tool holder without mirroring of the X axis.
If transformation TRANSMIT is set up, the necessary mirroring can also be activated
automatically if programmed. For this, the TRANSMIT command must be replaced by a
subprogram (for example, in the manufacturer directory):

Tool management
12.6 Editor for the tool and magazine management
MD10712 $MN_NC_USER_CODE_CONF_NAME_TAB[0]="TRANSMIT"
MD10712 $MN_NC_USER_CODE_CONF_NAME_TAB[1]="TRANSM"
Subprogram TRANSMIT.SPF:
PROC TRANSMIT(INT_NR)
F_T_REV2
TRANSM(_NR)
F_T_REV2
RET
Note
In the status display, TRANSM is now displayed instead of TRANSMIT.
General conditions
● The taper turning is not enabled for "working with two tool holders."
● The B-axis function (kinematics) is also not enabled for "working with two tool holders."
12.6.1 Overview
The tool management offers the possibility to define all real tool magazines and internal
magazines with the appropriate properties from the operating software and link them channel-
specific with the tool unit. You can configure the relationships between tool magazine, griper
and spindle via a tree view.
General sequence
The following steps are required to create a tool management:
● Create tool unit
● Define buffer locations
● Define loading location
● Create magazine configuration
● Link assignments

Tool management
Note
When you create a new tool unit, a buffer location with a spindle location, a loading magazine
with a loading location and a real magazine with five locations are created by default.
Meaning of the symbols
Symbol Description
Folder for the actively used tool units
Folder with access to templates
Tool spindle / tool holder
Tool gripper 1
Tool gripper 2
Shows the changes in the the "Active data" folder that has not been activated yet
Meaning of the tree view

The following folders are available in the tree view:
● Active data: Configure and activate the magazine management.
● Examples: Copy templates into the "Active data" folder.
● Network/USB: Copy the new magazine managements into the "Active data" folder or use
existing ones for other systems.
12.6.2 Calling the tool management

You open the tool management window as follows:
Procedure
2. Press the "NC" and "Tool management" softkeys.
The "Tool management" window opens.

Tool management
12.6.3 Editing the tool management

For the tree view of the tool management, functions are available with which you can
parameterize magazine data items and link them with each other.
Note
If you position the cursor on an element, only those functions possible for this element are
active. All other functions are inactive which is indicated with grayed-out softkeys.
Procedure
The "Tool management" window is open.
Adding a new tool unit

1. Position the cursor on the "Active data" folder element.
2. Press the "New element" softkey.
A folder element with the standard designation <tool unit> is inserted and
the "TO unit" input window opens.
3. You can make changes in the input window of the folder element.
4. Press the "OK" softkey to insert the folder element with the settings.
Inserting a new magazine

2. Navigate with the <Cursor right> and <Cursor down> keys to the folder
element of the tool unit.

A folder element with the standard designation <magazine> is inserted
and the "Magazine" input window opens.
4. You can make changes in the input window of the folder element.
5. Press the "OK" softkey to insert the folder element with the settings.
Editing an element

Tool management
2. Navigate with the <Cursor right> and <Cursor down> keys to the element
that you want to edit.
3. Press the <Cursor right> or <INPUT> key.

The input window for the element settings opens.
4. Enter the desired changes and press the "OK" softkey to confirm the en‐
tries.
Note
You define the number of buffer and magazine locations in the input window of the higher-level
<Magazine> folder element with the "Locations" parameter.
Activating Data
1. Press the "Activate data" softkey.
All changed parameterizations are transferred to the NC and activated.
All of the error messages are displayed again, and you have the option
of specifically resolving these by modifying the data.
Note
Once you have made changes to the tool management, the data is marked with "*". This data
is not yet in the NC and so does not have any effect.
If you want to create a tool management that is similar to an already existing element, then
you can save time if you copy the existing elements and insert them at a different position.
You have the option, for example of also copying inactive subtrees into the active tree.
Copying/cutting and pasting elements

1. Position the cursor on the desired element.
- OR -
Press the "Cut" softkey.

Tool management
3. Position the cursor at the required position and press the "Paste" softkey.
If the element exists already at the desired location, you receive further
insertion options.
4. Press the "OK" softkey if you wish to attach the element to the tree view
as the next element.
The element is inserted.
Note:
You have the option of changing the name of the element in the associ‐
ated input window.
Deleting elements
1. Place the cursor on the desired element and press the "Delete element"
softkey.
2. Press the "OK" softkey to confirm the deletion.

The selected object is removed.
12.6.4 Parameterizing the tool management
12.6.4.1 Create tool unit

A tool unit is the grouping of tools and magazines to form a unit. A tool unit can be assigned
one or more channels. The tools and magazines must be unique within a tool unit. For a tool
unit, specify the search parameters and the channel in the "TO unit" window.
Directory values
You are currently located under the "Active data" → <tool unit> directory in the "Commissioning"
→ "NC" →"Tool management" operating area.
You can set the following parameters in the "TO unit" window from the tool unit directory:
Parameters Description
Name Designation that is displayed in the tree structure.
Channel number The channel to which the tool unit is assigned.

Tool management
Tool search Search strategy:
● Without search strategy
● Active tool
● Shortest way
Empty location search Search strategy:
● First location forwards
● Current location forwards
● Current location backwards
● Last location backwards
● Symmetric current location
● 1:1 exchange
12.6.4.2 Define buffer locations

Buffer locations are spindles, grippers, loaders and transfer locations. All buffer locations are
managed in an internal buffer magazine with the number 9998. The number of buffer locations
is defined from the "Magazine" window. The buffer location type is defined from the "Location"
window.
Directory values
You are currently located under the "Active data" → <tool unit> → <buffer> directory in the
"Commissioning" → "NC" →"Tool management" operating area.
You can define the following parameters in the "Magazine" window from the buffer directory:
Name Designation of the buffer magazine
The designation is displayed in the tree structure.
Magazine number 9998 (cannot be changed)
Locations Number of the buffer locations
Element values
You can change the buffer location type with the parameters in the "Location" window:
(Selection menu) Select a buffer type
● Tool spindle / tool holder
● Loader
● Gripper
● Transfer location
Index The index counts the locations of a type.

Tool management
12.6.4.3 Define loading location

Loading location are loading points or loading stations. All loading locations are stored in an
internal loading magazine with the number 9999. The number of loading locations is defined
from the "Magazine" window. The loading location type is defined from the "Location" window.
Directory values
You are currently located under the "Active data" → <tool unit> → <loading magazine> directory
in the "Commissioning" → "NC" →"Tool management" operating area.
You can define the following parameters in the "Magazine" window from the loading magazine
directory:
Name Designation of the loading magazine
Magazine number 9999 (cannot be changed)
Locations Number of loading locations
Element values
You can change the loading location type with the parameters in the "Location" window:
(Selection menu) Select a loading location type:
● Load location
Load locations are areas on the machine at which the direct loading
in the magazine is possible. The tool can be inserted directly into
the magazine at this location. The magazine location to be loaded
is moved to the loading point. For example, chain magazines have
loading points.
● Loading station
A loading station is a location outside the magazine onto which the
tool to be loaded is placed. The tool is then transported from that
location to the magazine via a transport mechanism. Loading
stations are generally used for box or chain magazines.
Index The index counts the locations of a type.
Note
Loading point 1 is always set automatically as loading/unloading point for spindle 1 (manual
loading point).
12.6.4.4 Create magazine configuration

You can define several magazines in a tool unit. You define the magazine configuration via
the "Magazine" window. The magazine location type is defined from the "Location" window.

Tool management
Directory values
You are currently located under the "Active data" → <tool unit> → <magazine> directory in the
"Commissioning" → "NC" →"Tool management" operating area.
You can define the following parameters in the "Magazine" window from the magazine
directory:
Magazine type Selection menu:
● Chain magazine
● Box magazine
● Revolver
Name Designation of the magazine.
Magazine number Specifies the number of the magazine
Locations Number of magazine locations
Tool search Search strategy:
● Take from the TOA
● Active tool
● Shortest way
Empty location search Search strategy:
● Take from the TOA
● First location forwards
● Current location forwards
● Current location backwards
● Last location backwards
● Symmetric current location
● 1:1 exchange
Location coding ● Variable
● Fixed-location coded
Location type Identification for the magazine location type
(Changes the value globally for all locations in the magazine)
Consider adjacent location ● Yes
● No
(Changes the value globally for all locations in the magazine)
Note
If one of the Location type or Consider adjacent location parameters is changed individually
and the value is not identical for all locations, the "Variable" definition appears in the display.

Tool management
Element values
You can change the magazine location type with the parameters in the "Location" window:
Location type Identification for the magazine location type
Consider adjacent location ● Yes
● No
12.6.4.5 Link assignments

You can establish the mechanical relationship between the individual components of the tool
unit in the "Assignment" window.
Element values
You are currently located under the "Active data" → <tool unit> directory in the "Commissioning"
→ "NC" →"Tool management" operating area.
You can link the following parameters with each other from the selection list via the
Assignments element:
● Spindle/gripper/loader for magazine
● Gripper/loader for spindle
● Loading point for magazine
Note
The separation as number of locations from the magazine zero point of the affected magazine
to the internal magazine location must be defined for each magazine assignment.
Example
If, for example, tools on a spindle must be replaced from a magazine, the following assignment
can result:
/RDGBVWDWLRQB 7UDQVIHUBORFDWLRQB /RDGBVWDWLRQB Location Type/Index

1 Tool spindle Spindle_1

*ULSSHUB
2 Gripper Gripper_1
3 Gripper Gripper_2
6SLQGOHB *ULSSHUB
4 Transfer location Transfer_location_1
0DJD]LQHB
1 Load station Load_station_1

2 Load station Load_station_2
Magazine Magazine_1

Tool management
Parameters Assignment
Spindle/gripper/loader for ● Tool spindle location 1 for magazine (separation 0)
magazine ● Gripper location 2 for magazine (separation 0)
● Gripper location 3 for magazine (separation 0)
● Transfer location 4 for magazine (separation 0)
Gripper/loader for spindle ● Tool spindle location 1 for gripper 2
● Tool spindle location 1 for gripper 3
Loading point for magazine ● Loading point location 1 for magazine (separation 0)
● Loading point location 2 for magazine (separation 3)

Tool management

Configuring alarms 13
13.1 Creating alarm and message texts via the user interface
From the user interface, you can create and edit your alarm and message texts from the part
program. In turn, the alarm and message texts are saved corresponding to their number in
various text files.
Storage
The text files are created in the directory:
/oem/sinumerik/hmi/lng
Procedure
3. Press the "Alarm texts" softkey.

The "Select File" window opens and offers the user-specific text files.
4. Select the desired file and press the "OK" softkey.
The window, e.g. "Edit Alarm Texts (User PLC Alarm Texts) German"
opens.
5. Enter the desired alarm number in the "Number" column.
Enter the desired alarm text in the "Alarm text" column.
Select the desired font color in the "Color" column.
In the column "PopUp" with "yes" or "no", select whether the alarm text
should be displayed in a window that requires acknowledgment - or
not.
- AND / OR -
Press the "Insert line" softkey.
A new line is inserted above your cursor.
- OR
Press the "Delete line" softkey to delete the selected line.

Configuring alarms
13.1 Creating alarm and message texts via the user interface
6. Press the "Search" softkey.

The "Search" window opens.
Enter the desired alarm text or the alarm number in the "Text" field.
Activate the "Case sensitive" checkbox if a distinction must be made
between upper- and lower-case letters when entering text.
- OR
Press the "Search and replace" softkey.
The "Search and Replace" window opens.
Enter the search term in the "Text" field. Enter the replacing term in the
"Replace with" field.
7. Position the cursor in the "Direction" field. Using the <SELECT> key,
select the search direction (forwards, backwards).
8. Press the "OK" softkey to start search or search and replace.
Press the "Cancel" softkey if you wish to interrupt the action.
9. If you have entered the alarms with the help texts, press the "OK" soft‐
key.
You will receive the message "The alarm texts have been saved and
converted."
Restart SINUMERIK Operate

You must restart SINUMERIK Operate in order that the "color" and "PopUp" attributes take
effect. Modified alarm texts, however, take effect immediately.
Further search options
The cursor jumps to the first entry of the selected alarm text file.
The cursor jumps to the last entry of the selected alarm text file.
Creating search directories

In order that a search can be made for alarm files in subdirectories other than the existing /lng
directory, you have the following option:
1. Copy the "systemconfiguration.ini" configuration file from the following

directory:
/siemens/sinumerik/hmi/cfg
2. Store the file in the following directory:
/oem/sinumerik/hmi/cfg
3. Create any subdirectory under /hmi, e.g. /oem_dir.

Configuring alarms
13.2 Configuring alarm and message texts via alarm text files
4. Create the following section in the configuration file "systemconfigura‐

tion.ini":
[oem_dirs]
OEM_3=oem_dir
5. Restart SINUMERIK Operate.
When searching, the subdirectory is now also taking into account.
Foreign language alarm and message texts

If you create foreign language alarm and message texts, change over into the desired
language. All text files are automatically allocated the language code corresponding to the
user interface language that has been selected. For instance, if you create alarm texts in the
English user interface, then the text file is assigned the "eng" language code.
See also
Range of alarms (Page 244)
You have the option of creating customized alarm and message texts using alarm text files
and adapting these.
The alarm texts are set up in standard format (".ts" format) by SINUMERIK Operate. The ".ts"
format is XML-based.
You can create and edit these files not only with SINUMERIK Operate, but also externally on
a PC.
Note
If you wish to edit alarm text files on a PC, use an editor supporting UTF-8 coding.
Note
Chinese alarm texts should only be implemented with character set GB2312.
Chinese logograms are not supported in Korean.
Creating and editing alarm texts

● Creating your own alarm texts
● Creating texts for indexed alarm parameters
● Creating part program message texts
● Changing alarm attributes

Configuring alarms
● Replacing standard alarm texts

● Converting alarm texts
13.2.1 Creating in-house alarm texts
Creating an alarm text file

1. You can copy a sample file "oem_alarms_eng.ts" from the following directory: /siemens/
sinumerik/hmi/template/lng
2. Save or create the file in the /oem/sinumerik/hmi/lng or
/user/sinumerik/hmi/lng directory. Create a separate file for each country language that is
supported.
3. Assign a unique name to the file, e.g. "my_alarms_eng.ts". You can freely select the file
names with the exception of the language code and the extension.
The file name always ends with the language code of the particular language and always
has the ".ts" extension. For example "my_alarms_deu.ts" for German or
"my_alarms_eng.ts" for English.
Creating alarm texts

1. Open the "my_alarms_eng.ts" file.
2. For each alarm text, you must insert your own area in the file that is marked using the
<message> tag.
3. The <name> tag contains the context names. Normally, you should not change the specified
name "slaeconv".
4. The <source> tag contains the alarm number and the name of the alarm source (source
URL). In the example "700000" is the alarm number and "/PLC/PMC" is the name of the
alarm source. The possible alarm sources can be found in the tables in Section Range of
alarms (Page 244).
5. The <translation> tag contains the alarm text.
Example:
<!DOCTYPE TS>
<TS>
<context>
<name>slaeconv</name>
<message>
<source>700000/PLC/PMC</source>
<translation>First OEM alarm text</translation>
</message>
<message>

Configuring alarms
<translation>Second OEM alarm text</translation>
</message>
</context>
</TS>
Registering the alarm text file

You still have to register your alarm text file so that the system knows your alarm texts during
the program runtime:
1. You can copy a sample configuration file "oem_slaesvcadapconf.xml" from the following
directory: /siemens/sinumerik/hmi/template/cfg
2. Save the file in the directory /oem/sinumerik/hmi/cfg or
/user/sinumerik/hmi/cfg
3. Assign the name "slaesvcadapconf.xml" to the file.
4. Open the file and in the <BaseNames> tag, enter the file name of the alarm text file without
language code and file extension, e.g. "my_alarms", as "value".
The registration of your alarm text file starts, for example, with the name
"OEM_BaseName_01".
Note
The names of the <BaseNames> tag can be freely selected. They must be unique in the
system and must not clash with names used by Siemens.
The "Siemens_BaseName_01" name is reserved for Siemens.
Several alarm text files can also be registered. To do this, use names such as
"OEM_BaseName_02", "OEM_BaseName_03", etc.
Example:


<CONFIGURATION>
<AlarmTexts>
<BaseNames>
<OEM_BaseName_01 type="QString" value="my_alarms"/>
</BaseNames>
</AlarmTexts>
...
</CONFIGURATION>

Configuring alarms

The files must still be converted into a binary format so that the alarm texts can be displayed
To do this, restart SINUMERIK Operate. In the same directory where the .ts files are located,
files with the same name are created with the ".qm" file extension.
The result of the conversion is written to the "alarmtext_conversion.log" or
"oem_text_conversion.log" file. Errors that occur during the conversion, such as syntax errors
in a parameter file, are also written to the file.
This file is located in the "/user/sinumerik/hmi/log" directory.
Note
The conversion is only made if the .ts file is newer than the associated .qm file.
13.2.2 Creating texts for indexed alarm parameters

If a string, the so-called "Index identifier", is specified in the alarm text in pointed brackets after
a space holder (e.g. "%1<OEM>"), the parameter itself is not inserted in the alarm text,
but a text from another alarm text file, a so-called index text file. In this case, the alarm
parameter value serves as index in order to select the text in the index file. The index text can,
in turn, include parameters, also index parameters.
Note
Explanation for the "Index identifier" string
● "<" ≙ opening pointed bracket "<"
● ">" ≙ closing pointed bracket ">"
Creating an index text file

1. You can copy a sample index text file "oem_indexparams_eng.ts" from the following
directory: /siemens/sinumerik/hmi/template/lng
supported.
3. Assign a unique name to the file, e.g. "my_indextexts_eng.ts". You can freely select the file
has the ".ts" extension. For instance, "my_indextexts_deu.ts" for German or
"my_indextexts_eng.ts" for English.

Configuring alarms
Creating index texts

1. Open the "my_indextexts_eng.ts" file.
2. In the <name> tag, enter a name that you have selected, e.g. "my_context".
3. For each index text, a separate area must be inserted between the <message> and </
message> tags.
4. The <source> tag contains the alarm parameter value, e.g. the values "1" and "2".
5. The <translation> tag includes the index text that is displayed if the alarm parameter
involved has the value specified between <source> and </source>.
Example
<!DOCTYPE TS>
<TS>
<context>
<name>my_context</name>
<message>
<source>1</source>
<translation>First OEM parameter text</translation
</message>
<message>
<source>2</source>
<translation>Second OEM parameter text</translation
</message>
</context>
</TS>
Registering an index text file

You still have to register your index text file so that the system knows your index texts during
the program runtime. The registration is made in the "slaesvcadapconf.xml" file.
1. Open the file "slaesvcadapconf.xml" already created for the alarm texts /oem/sinumerik/hmi/
cfg or /user/sinumerik/hmi/cfg directory.
2. Remove the lines "".
3. Enter the so-called identifier, e.g. <Identifier type="QString" value="OEM"/>. The index
identifier is always specified in pointed brackets next to the parameter specification in the
alarm text, e.g. "%1<OEM>".
4. Enter the BaseName of the index text file, e.g.
<BaseName type="QString" value="my_indextexts"/>.

Configuring alarms
5. Enter the context name that you selected, e.g.

<ContextName type="QString" value="my_context"/>.
6. You can also use several different indices. Then, in this case, a dedicated section must be
created for every index between the <IndexTexts> and </IndexTexts> tags. The tags for
these sections are called, e.g.
<OEM_IndexText_01>, <OEM_IndexText_02>, <OEM_IndexText_03>, etc.
The tags <IndexText_01> to <IndexText_99> are reserved for Siemens.
Example

<!- Configuration of the Solutionline Alarm & Event Service Adapter
->
<CONFIGURATION>
...

<IndexTexts>
<OEM_IndexText_01>
<Identifier type="QString" value="OEM"/>
<BaseName type="QString" value="my_indextexts"/>
<ContextName type="QString" value="my_context"/>
<MetaTextID type="QString" value="%ParamValue%"/>
</OEM_IndexText_01>
</IndexTexts>
</CONFIGURATION>

This file is saved in the /user/sinumerik/hmi/log directory.
Note

Configuring alarms
13.2.3 Creating part program message texts
Message texts from the part program

In order to output message texts from the part program, use the MSG instruction in the part
program. The message texts are referenced via the number after the "$ character, e.g.
MSG("$4711"). You can configure channel-specific message texts for each NC channel.
Creating message texts

Procedure:
1. You can copy a sample message text file "oem_pp_messages_eng.ts" from the following
directory: /siemens/sinumerik/hmi/template/lng
supported.
3. Assign a unique name to the file, e.g. "my_msgs_eng.ts". You can freely select the file
has the ".ts" extension. For instance, "my_msgs_deu.ts" for German or "my_msgs_eng.ts"
for English.
4. Open the "oem_msgs_eng.ts" file and in the <name> tag enter the "partprogmsg01"
character string. This is the default for the part program message texts from all channels.
5. For each message text, a separate area must be inserted between the <message> and </
message> tags.
6. The <source> tag contains the number from the MSG command in the part program.
7. The <translation> tag contains the message text.
Example
<!DOCTYPE TS>
<TS>
<context>
<name>partprogmsg01</name>
<message>
<source>4711</source>
<translation>part program message No. 4711</translation
</message>
</context>
</TS>

Configuring alarms
Registering the message text file

You still have to declare your message text file so that the system knows your message texts
during the program runtime.
2. Save or create the file in the /oem/sinumerik/hmi/cfg or
/user/sinumerik/hmi/cfg directory.
3. Change the name to "slaesvcadapconf.xml".
4. Open the file and in the <BaseNames> tag enter the file name of the message text file
without language code and file extension, e.g. "my_msgs", as "value". The registration of
your message text file starts, for example, with the name "OEM_BaseName_01".
Note
Several message text files can also be registered. To do this, use names such as
Example

-->
<CONFIGURATION>
<AlarmTexts>
<BaseNames>
<OEM_BaseName_01 type="QString" value="my_msgs"/>
</BaseNames>
</AlarmTexts>
...
</CONFIGURATION>
Message texts for several channels

It is possible to assign different message texts the same message number, e.g. the number
4711 in different NC channels. This means, different message texts are output depending on
the channel in which the part program is executed.
1. Open the "oem_msgs_eng.ts" file in the editor.
2. Change the text between the two <name> and </name> tags from "partprogmsg01" into
"partprogmsgXY", whereby "XY" should be replaced by the particular channel number, e.g.
"partprogmsg02" for channel 2.

Configuring alarms
3. Now open the "slaesvcconf.xml" configuration file.

4. Enter the respective NC channel in the <Connections> tag. Only use the XML tags from
the following table to specify the NC channel.
NC chan‐ XML tag ContextName

nel
1 PartprogramMessageChannel_01 partprogmsg01
10 PartprogramMessageChannel_10 Partprogmsg10
Example

-->
<CONFIGURATION>
<Connections>
<PartprogramMessageChannel_02>
<ContextName type="QString" value="partprogmsg02"/>
</PartprogramMessageChannel_02>
</Connections>
</CONFIGURATION>


Configuring alarms
This file is saved in the /user/sinumerik/hmi/log directory.
Note
13.2.4 Changing alarm attributes
Color types of the alarms

You can individually change the colors of the alarms and messages displayed in the message
line.
You can change the following for each alarm number and alarm source:
● Font color of the alarm/message text
● Background color of the alarm/message text
● Font color of the alarm number
● Background color of the alarm number
Create alarm attribute file

Procedure:
1. You can copy a sample alarm attribute file "oem_slaedatabase.xml" from the directory: /
siemens/sinumerik/hmi/template/cfg/
2. Save the file in the directory /oem/sinumerik/hmi/cfg/ or
/user/sinumerik/hmi/cfg/
3. Assign a unique name to the file, e.g. " muster_slaedatabase.xml ".
The file name can be freely selected; however, it must only contain lower-case letters.
Defining alarm colors

Procedure:
1. Open the file "muster_slaedatabase.xml" in the editor.
2. First, enter which alarm colors you generally wish to change.
To do this, create a separate section <Attribute> for each alarm color that you wish to
change in the <Attributes> area.

Configuring alarms
3. Enter the attribute name of the alarm color to be changed in the <Attribute AttrName=…>
tag. You can change the following colors:
– Font color of the alarm/message text = TEXTCOLOR
– Background color of the alarm/message text = TEXTBACKGROUNDCOLOR
– Font color of the alarm number = NUMBERCOLOR
– Background color of the alarm number = NUMBERBACKGROUNDCOLOR
4. Alarm sources are defined in the <Sources> area for whose alarms the alarm colors are to
be changed, e.g. the alarm sources "/HMI" and "/PLC/PMC".
Note
If you insert further alarm sources, make sure that the alarm number is always assigned to
the correct alarm source.
The possible values for source ID and URL can be found in the table in Section Range of
alarms (Page 244).
5. In the <Alarms> tag, create a separate sub-area for each alarm or for an alarm number
range.
6. Enter the alarm number in the <Alarm AlarmID= "..." > tag, or enter the alarm number range
in the <Range FromAlarmID="..." ToAlarmID= "..."> tag.
7. Enter the required color values in the following tags:
<TEXTCOLOR>
<TEXTBACKGROUNDCOLOR>
<NUMBERCOLOR>
<NUMBERBACKCOLOR>
The attributes of the color values are defined by specifying an RGB value:
– An RGB value always starts with the "#" character.
– The individual color values R, G and B are represented by double-digit hexadecimal
numbers. Syntax: "#RRGGBB", e.g. "#FF9A00".
Example
Note the order in the XML configuration file for the assignment of the colors to alarm number
ranges:

<!DOCTYPE SlAeAlarmAttributes>
<SlAeAlarmAttributes Version="01.00.00.00">
<Types>
<Type TypeName="Condition" TypeID="32">
<Category Version="1.0" CatID="1">
<CatDescr>Alarms of the SINUMERIK 840D sl.</CatDescr>
<Attributes>
<Attribute AttrName="TEXTCOLOR" AttrID="5003"
AttrDataType="10">

Configuring alarms
<AttrDescr>
Text color of an alarm used when displayed within the
header panel.
</AttrDescr>
</Attribute>
<Attribute AttrName="TEXTBACKGROUNDCOLOR" AttrID="5004"
AttrDataType="10">
<AttrDescr>
Background color of an alarm used when displayed within
the header panel.
</AttrDescr>
</Attribute>
<Attribute AttrName="NUMBERCOLOR" AttrID="5005"
AttrDataType="10">
<AttrDescr>
Text color of an alarm used when displayed within the
header panel.
</AttrDescr>
</Attribute>
<Attribute AttrName=" NUMBERBACKGROUNDCOLOR " AttrID="5006"
AttrDataType="10">
<AttrDescr> Background color of an alarm used when
displayed within the header panel.
</AttrDescr>
</Attribute>
</Attributes>
</Category>
</Type>
</Types>
<Sources>
<Source> CatLink="1" SourceID="10000" SourceURL="/HMI">
<Alarms>
<Alarm AlarmID="130000">
<TEXTCOLOR>#000000</TEXTCOLOR>
<TEXTBACKGROUNDCOLOR>#FFFFFF</TEXTBACKGROUNDCOLOR>
<NUMBERCOLOR>#FFFFFF</NUMBERCOLOR>
<NUMBERBACKGROUNDCOLOR>#000000</NUMBERBACKGROUNDCOLOR
</Alarm>
</Alarms>
</Source>
<Source> CatLink="1" SourceID="51" SourceURL="/PLC/PMC">
<Alarms>
<Range FromAlarmID="700100" ToAlarmID="700199">

Configuring alarms
<NUMBERCOLOR>#00FF00</NUMBERCOLOR>
</Range>
<TEXTBACKGROUNDCOLOR>#FFFFFF</TEXTBACKGROUNDCOLOR>
<NUMBERCOLOR>#FFFFFF</NUMBERCOLOR>
<NUMBERBACKGROUNDCOLOR>#000000</NUMBERBACKGROUNDCOLOR
</Alarm>
</Alarms>
</Source>
</Sources>
</SlAeAlarmAttributes>
Registering the alarm attribute file

The alarm attribute file with the color definitions must be registered in order that the alarm
colors can be assigned to the alarms during the program runtime:
1. You can copy a sample configuration file "oem_slaesvcconf.xml" from the following
3. Name the file "slaesvcconf.xml".
4. Open the file and in the <DataBases> tag enter, for example, the file name of the alarm
attribute file without language code and file extension, e.g. "muster_slaedatabase", as
"value". The registration of your alarm attribute file starts, for example, with the name
"OEM_DataBase_01".
Note
The names of the <DataBases> tag can be freely selected. They must be unique in the
The "Siemens_DataBase_01" name is reserved for Siemens.
If you register additional alarm attribute files, i.e. you wish to include them in the
configuration file, use names such as "OEM_DataBase_02", "OEM_DataBase_03", etc.

The files still have to be converted into a binary format in order that the alarm colors become
effective during the program runtime. This data is only converted during power up.
To do this, restart SINUMERIK Operate. A file with the same name is created with the ".hmi"
file extension, e.g. "sample_slaedatabase.hmi" in the same directory in which the alarm
attribute file is also located.

Configuring alarms
The result of the conversion is written to the file "oem_ae_database_conversion.log". This file
is located in the "/user/sinumerik/hmi/log" directory.
Note
The conversion is only carried out if the XML file is newer than the associated hmi file.
13.2.5 Replacing standard alarm texts

You can replace alarm texts of the standard SINUMERIK Operate with own alarm texts.
Creating an alarm text file

1. You can copy a sample alarm text file "oem_alarms_eng.ts" from the following directory: /
supported.
3. Assign the file a user-specific name, e.g. "my_nck_alarms_eng.ts". You can freely select
the file names with the exception of the language code and the extension.
has the ".ts" extension. For example "my_nck_alarms_deu.ts" for German or
"my_nck_alarms_eng.ts" for English.
Creating alarm texts

1. Open the "my_nck_alarms_eng.ts" file.
2. A separate area must be inserted for each alarm text, marked by the <message> tag.
3. The <name> tag contains the context names. Change the name and ensure that the name
is unique in the system, e.g. "myNckAlarms".
Note
The name for the <name> tag can always be freely selected. However, the name must not
clash with the "slaeconv" name used by Siemens.
4. The <source> tag contains the alarm number of the standard alarm, e.g. 10000.
5. The <translation> tag contains the actual alarm text, e.g. "OEM alarm text example for NCK
alarm 10.000".
Example
<!DOCTYPE TS>
<TS>
<context>

Configuring alarms
<name>myNckAlarms</name>
<message>
<source>10000/NCK</source>
<translation> OEM alarm text example for NCK alarm 10.000</
translation>
</message>
</context>
<TS>
Registering the alarm text file

You still have to register your alarm text file so that the system knows your alarm texts during
the program runtime:
3. Assign the name "slaesvcadapconf.xml" to the file.
4. Open the file and in the <BaseNames> tag enter the file name of your alarm text file without
language code and file extension, e.g. "my_nck_alarms", as "value". The registration of
your alarm text file starts, for example, with the name "Siemens_BaseName_01".
Note
Several alarm text files can also be registered. To do this, use names such as
Example:

-->
<CONFIGURATION>
<AlarmTexts>
<BaseNames>
<OEM_BaseName_01 type="QString" value="my_nck_alarms"/>
</BaseNames>
</AlarmTexts>
</CONFIGURATION>

Configuring alarms
Replacing standard alarm texts

You still have to define which standard alarm texts should be replaced by your alarm texts so
that during the program runtime, the original alarm text is replaced by your alarm text.
1. Create a new alarm attribute file (see Changing alarm attributes (Page 236)) in the /oem/
sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg directory. The file name can be freely
selected, e.g. "my_nck_alarms_db.xml".
2. Open the file.
3. The file always comprises the two areas <Types> and <Sources>.
4. The <sources> tag includes the reference, assigned to an alarm source, e.g. "\NCK", to the
associated alarm text.
5. Link the contents of the <context> <name> tags with the contents of the <message>
<source> tags from your alarm text file.
– <context> <name> = the context name that you assigned
– <message> <source> = the number of the alarm whose text is to be replaced.
E.g. enter the following link in the alarm attribute file: <MSGTEXT>myNckAlarms Ι
10000</MSGTEXT>
Make sure that the context name and the alarm number are separated by the pipe
character "Ι".
6. If you include an additional NCK alarm, copy the range from <Alarms> to </Alarms> and
adapt the alarm number.
7. If you include an additional alarm from another number range (e.g. PLC alarm), copy the
range <Sources> to </Sources> and then adapt the SourceID and SourceURL as well as
the alarm number.
You can take the corresponding SourceID and SourceURL from the table in Section Range
of alarms (Page 244).
Note
A dedicated link must be created for each standard alarm for which the text is to be replaced.
Example

<!DOCTYPE SlAeAlarmAttributes>
<Types>
<Type TypeName="Condition" TypeID="32">
<Category Version="1.0" CatID="1">
<CatDescr>Alarms of the Sinumerik 810/840 D(i).</CatDescr>
<Attributes>
</Attributes>
</Category>

Configuring alarms
</Type>
</Types>
<Sources>
<Source CatLink="1" SourceID="0" SourceURL="/NCK">
<Alarms>
<MSGTEXT>myNckAlarms|10000/NCK</MSGTEXT>
</Alarm>
</Alarms>
</Source>
</Sources>
Registering the alarm attribute file

The alarm attribute file still has to be registered in order that the standard alarm texts are
replaced during the program runtime:
1. You can copy a sample configuration file "oem_slaesvcconf.xml" from the following
3. Change the name to "slaesvcconf.xml".
4. Open the file and in the <DataBases> tag enter the name of the alarm attribute file, e.g.
<OEM_DataBase_01 type="QString" value="my_nck_alarms_db">
Note
The names of the <DataBases> tag can be freely selected. They must be unique in the
The <Siemens_DataBase_01> tag name is reserved for Siemens.
If you register additional alarm attribute files, i.e. you wish to include them in the
configuration file, use the names <OEM_DataBase_02>, <OEM_DataBase_03>, etc.

The files with the alarm texts and the attribute file still have to be converted into a binary format
in order that the alarm texts can be displayed during the program runtime. This data is only
converted during power up.
To do this, restart SINUMERIK Operate. In the same directory where the .ts files or the alarm
attribute file are located, files with the same name are created with the ".qm" and .hmi file
extension.

Configuring alarms
This file is located in the "/user/sinumerik/hmi/log" directory.
Note
13.2.6 Range of alarms
Number ranges of alarms
Numerical range Description SourceID SourceURL

000.000 – 009.999 General alarms 0 (standard /NCK
010.000 – 019.999 Channel alarms NCU) //configuration-
020.000 – 029.999 Axis/spindle alarms 100 (1st NCU) spec. designation>//
... NCK
030.000 – 039.999 Functional alarms General 9999 (99th NCU)
040.000 – 059.999 Reserved
060.000 – 064.999 Siemens cycle alarms
065.000 – 069.999 Cycle alarms user
070.000 – 079.999 Compile cycles
Manufacturer and OEM
080.000 – 084.999 Siemens cycles mes‐
sage texts
085.000 – 089.999 User cycles message
texts
090.000 – 099.999 Reserved
100.000 – 129.999 System 10.000 /HMI
130.000 – 139.999 OEM
140.000 – 199.999 Reserved
200.000 – 299.999 SINAMICS drive 0 /NCK
300.000 – 399.999 Drive and I/O alarms
400.000 – 499.999 General alarms 51 /PLC/PMC
500.000 – 599.999 Channel alarms
600.000 – 699.000 Axis/spindle alarms
700.000 – 799.999 User area
800.000 – 899.999 Sequencers/graphs
810.000 – 810.009 System error messages 50 /PLC/DiagBuffer
150 (1st NCU) //<configuration-spec.
Designation>/PLC/
DiagBuffer
900.001 – 965.999 HMI PRO sl Runtime 0 /NCK
966.000 – 999.999 Reserved 0 /NCK

Configuring alarms
SourceIDs 1 ... 10
The SourceIDs 1 ... 10 have the following relationship:
SourceID SourceURL
1 /NCK/Channel#1/Partprogram
13.2.7 Parameter specifications in alarm texts

Alarm texts can contain alarm parameters (accompanying values) that specify the cause of an
alarm in more detail. These parameters are usually numerical values that are transmitted from
an alarm source when the alarm is signaled along with the other alarm data.
How the parameters are incorporated into the alarm text is specified via place holders
(parameter specifications) in the language-specific alarm texts, e.g. "Channel %1 Axis %2 in
machine data %3 defined for several channels".
When an alarm occurs, the text is replaced by the corresponding parameters, e.g. "Channel
5 Axis A3 in machine data 4711 defined for several channels".
Standard parameter specifications

The following table shows the standard parameter specifications:
Table 13-1 Standard parameter specifications
Parameter Description
specifier
%1 First parameter from the alarm data of the alarm source.
%2 Second parameter from the alarm data of the alarm source.
%3 Third parameter from the alarm data of the alarm source.
%4 Fourth parameter from the alarm data of the alarm source.
%5 Fifth parameter from the alarm data of the alarm source.
Only for NCK alarms:
First part (up to the separator) of the fourth parameter from the alarm data of the alarm
source.

Configuring alarms
specifier
%7 Seventh parameter from the alarm data of the alarm source
Third part (between the 2nd and 3rd separator) of the fourth parameter from the alarm
data of the alarm source.
%8 Eighth parameter from the alarm data of the alarm source
Fourth part (between the 3rd and 4th separator) of the fourth parameter from the alarm
data of the alarm source.
%9 Ninth parameter from the alarm data of the alarm source.
%0 Tenth parameter from the alarm data of the alarm source.
%Z As for %1, in the case of S7-HiGraph alarms the step number of the graph is shown.
%K Specially for PLC alarms:
Second digit of the decimal alarm ID: 123456, corresponds to channel number (0 =
channel 10).
%A Specially for PLC alarms:
Third and fourth digit of the decimal alarm ID: 123456, corresponds to the axis number.
%N Specially for PLC alarms:
Fifth and sixth digit of the decimal alarm ID: 123456, corresponds to the signal number.
13.2.8 Opening error file

The errors that occur during the conversion are written to the "alarmtext_conversion.log" or
"oem_text_conversion.log" file.
File loc.: /user/sinumerik/hmi/log
Opening the error file
3. Open the "System CF card" folder.

4. Open the storage directory and select the required file.
5. To open the error file, press the "Open" softkey.
- OR -
Press the <INPUT> key.

Configuring alarms
13.3 Configuring an alarm log
Default
Per default, the alarm log contains all alarms and messages - with their incoming and outgoing
time stamps - in chronological order since the last boot. The exceptions are messages from
the NC part program (msg command).
Contrary to the "Alarm List" or "Messages" window, all of the alarms or messages that are no
longer active when the log is displayed are also displayed (historical alarm events).
Specify the number of results

The alarm log is organized as a ring buffer: When the maximum size is exceeded, the oldest
entries are overwritten by the new alarm events. Each incoming or outgoing time stamp
represents a separate event.
Persistent storage (permanent storage)

If required, the alarm log can be set up as a persistent log that also contains alarm events from
before the last time it was switched on. This means that the log is then either time controlled
or for each alarm event, is backed-up in an internal binary format in the file system.
Depending on the hardware being used, for the NCU, the alarm log is saved on the
CompactFlash card or for the PC/PCU, on the hard disk.
NOTICE
Shorter CF card service life
If the alarm log is a continuously written to the CompactFlash card, then only a limited number
of write cycles is possible. Therefore, ensure that the storage is only performed when there
is a justifiable need! Undo the setting "at every event" if you no longer require that the alarm
log is saved.
The CompactFlash card has a service life of over 10 years for an average written data volume
of approx. 60 MB/day.
The alarm log is not saved in the default configuration.
Configuring an alarm log

● Via the operator software in the "Diagnostics" operating area
● Via the "slaesvcconf.xml" configuration file

Configuring alarms
13.3.1 Setting alarm logs from the user interface
Procedure
2. Press the "Alarm log" and "Settings" softkeys.
3. Enter a number in the "Number of entries" field to change the maximum

number of administered incoming and outgoing events.
The alarm log is organized as a ring buffer: When the maximum size is
exceeded, the oldest entries are overwritten by the new alarm events.
Each incoming or outgoing time stamp represents a separate event.
You can specify a value between 0 and 32000. Default value is 500.
4. In the "Write mode file" field, under the following entry, select:
● "off", the changes are not logged (default setting)
● "for each event", each alarm event immediately initiates that the alarm
log is backed-up (persistent save).
● "time controlled" if the alarm log is to be backed-up again after a certain
time. An additional input field called "Time interval" appears in which
you can specify a time in seconds.
You receive a warning if you only save to a CompactFlash card.

The made settings take effect only after a restart of the operating software. To do this, restart
SINUMERIK Operate.
13.3.2 Loading alarm log via configuration file
Creating the configuration file

Adjustments are made in file "slaesvcconf.xml". Copy a sample configuration file
"oem_alarmprot_slaesvcconf.xml" from the following directory: /siemens/sinumerik/hmi/
template/cfg
Procedure:
2. Assign the name "slaesvcconf.xml" to the file.

Configuring alarms
3. Open the file and enter the number of events to be output in the tag <Records type .../>.
The preset value is 500. The maximum number depends on the storage medium (hard disk
or CompactFlash card).
4. Enter the backup mode in the <DiskCare type="int" value="-1"/> tag. The following values
are possible:
-1: There is no backup of the alarm log (default setting).
0: Each alarm event triggers an immediate backup of the alarm log (persistency backup).
>0: Rhythm of the log saving in seconds: When there is a change, the log is time-triggered
saved every n > 0 seconds (persistency backup).
5. You adapt the filter for the entry type in the <Filter> tag. Please observe the following:
– An alarm event is only entered in the log when it satisfies the filter criterion.
– If several filters are specified in succession, they are linked by a logical OR.
– Several filters must be combined in series with the keyword AND for an AND operation.
Note
Each incoming or outgoing event of an alarm or message requires a separate entry, even when
they belong to the same alarm or message.
Acknowledgement events are also contained in the alarm log. You require such entries even
when these are presently not recognizable in the alarm log.
Filter properties
A filter consists of the following three elements <identification> <relation> <value>.
Entry <identification> Description

AlarmID Alarm number
SourceID Default values for SourceID and SourceURL can be found in the table in
SourceURL Section Range of alarms (Page 244).
<Attribute name> Arbitrary alarm attribute from the "slaedatabase.xml" file, such as "SEVERI‐
TY" or "CLEARINFO".
Entry <relation> Description

EQUAL Equal to
NOT Not equal to
LOWER Less than
HIGHER Greater than
Entry <value> Description

Numbers -
Character strings -

Configuring alarms
Cancel criteria
Cancel criteri‐ Alarm source Description

on (ClearInfo) (Source)
0 /HMI Alarms that are canceled by the HMI.
1 /NCK Alarms that are canceled by power-on of the NCU.
2 Conditions are canceled by a hardware reset of the NCU.
3 Conditions are deleted by a "CANCEL" command to the NCU.
4 Conditions are canceled by the NCK itself.
5 Conditions are canceled by an "NC Start" command on the NCU.
6 Conditions are canceled by a reset of the mode group (BAG).
7 Conditions are canceled by an "NC Reset" command on the NCU.
8 /PLC PLC messages of the FB15 (basic program).
9 PLC alarms of the FB15 (basic program).
10 Dialog alarms of the HMI that are canceled by the "Recall" key [^].
11 Reserved
12 S7-PDiag, S7-Graph, S7-HiGraph or other Alarm_S(Q) alarms of
the PLC (SFC17/18) with alarm state "not acknowledged"
13 S7-PDiag, S7-Graph, S7-HiGraph or other Alarm_S(Q) alarms of
the PLC (SFC17/18) with alarm state "acknowledged".
14 /NCK Drive alarms via NCK.
15 /NCK Part program messages.
Examples
Log all alarms with a ClearInfo not equal to 15, i.e. no part program messages:
<CONFIGURATION>
<Protocol>
<Filters>
<Siemens_Filter_01 type="QString" value="CLEARINFO NOT 15" />
</Filters>
</Protocol>
</CONFIGURATION>
Log all alarms with the SourceURL "/NCK" or "/HMI":
<CONFIGURATION>
<Protocol>
<Filters>
<Filter_01 type="QString" value="SourceURL EQUAL /NCK" />
<Filter_02 type="QString" value="SourceURL EQUAL /HMI" />
</Filters>
</Protocol>
</CONFIGURATION>

Configuring alarms
In the <FilePath> tag, adapt the path and file name for the file in which the alarm log is stored
persistently:
<CONFIGURATION>
<Protocol>
<Filters>
<FilePath type="QString" value="$(HMI_INSTALL_DIR)user/
sinumerik/hmi/ log/alarm_log/slaepp_" />
</Filters>
</Protocol>
</CONFIGURATION>
● Path
Environment variables can also be incorporated in the path, e.g. for the installation directory:
$(HMI_INSTALL_DIR).
● File name:
A 3-digit number and the file extension "hmi" are automatically added to the specified file
name during operation, e.g. "slaepp_123.xml". The number is automatically increased
when:
– The file has reached the maximum size (DiskCare = 0), or
– The specified period has elapsed (DiskCare > 0).
Older files are deleted.
Example: Switching off existing filters

To switch off the existing Siemens filter - without overwriting the filter - proceed as follows:
1. An "empty" filter switches off all previously set filters.
Knowledge of the filter designation is not required.
2. For the effect of the filters, the order in which they are set is important:
siemens → addon → oem → user
Example of the filtering of alarms 700000 to 700200:
<CONFIGURATION>
<Protocol>
<Filters>
<Filter_00 type="QString" value="" />
<Filter_01 type="QString" value="CLEARINFO NOT 15 AND
AlarmID LOWER 700000"/>
<Filter_02 type="QString" value="CLEARINFO NOT 15 AND
AlarmID HIGHER 700200"/>
</Filters>
</Protocol>
</CONFIGURATION>

Configuring alarms
13.4 PLC alarms with parameters
Result
For the changes to the protocol settings to take effect, restart SINUMERIK Operate.
Introduction
For alarms that are triggered via the PLC blocks SFC17 and SFC18, a parameter can be
transferred each time the block is called. If the "Octet string" data type is selected, up to 12
bytes can be transferred.
With an appropriate configuration of the operating software, a maximum of 12 bytes can be
interpreted, e.g. also as an array of bytes or as a structure with any order of simple data types.
In this way, several parameters can be displayed in the alarm text.
A parameter description must be stored for each alarm in the operating software. Two aspects
must be taken into account with this parameter description:
● How the parameter has to be interpreted correctly (data type and, if necessary, length)
● How the parameter has to be prepared for display (string or number, decimal, hexadecimal,
binary, etc.)
Point 1 is irrespective of the language selected for the display, point 2 can be different
depending on the national language.
The possible parameter descriptions are therefore divided into a language-independent
parameter statement and a language-dependent format statement and stored in the following
directories:
● Parameter statement: /oem/sinumerik/hmi/cfg/ or /user/sinumerik/hmi/cfg/

● Format statement: /oem/sinumerik/hmi/lng or /user/sinumerik/hmi/lng
The names of the files can be freely selected. The parameter statement is added to the
configured data of the relevant alarm in the database in the form of the alarm attribute
"HMIPROPARAMDESCR2". Because of the language dependency, the format statement is
part of the alarm text.
13.4.1 Definition of a parameter of the octet string data type
Parameter statement
The parameter statement describes how one or more parameters can be defined with the
maximum 12-bytes long octet string supplied with the alarm PDU.

Configuring alarms
Syntax
The following syntax applies for the parameter statement:
<Parameter directive ext> ::= [% <Parameter description> ]

<Parameter description ext> ::= <No. of the associated value><Element type><Off‐
set>
<No. of the associated value> ::= Always 1 (reserved for future applications)
<Offset> ::= Data type-dependent offset of the parameter within
the associated value:
● BOOL data type (B):
Bit offset within the associated value
● All except for BOOL data type (Y, W, X, I, D, C,
R):
Byte offset within the associated value
Element type Data type

Y BYTE (8-bit, unsigned)
W WORD (16-bit, unsigned)
X DWORD (32-bit, unsigned)
I INTEGER (16-bit, signed)
D INTEGER (32-bit, signed)
B BOOL (1-bit)
C CHAR (8-bit)
R REAL (32-bit)
Examples
%1W0%1W2 → 1st parameter: 1st associated value, WORD at byte

offset 0
2nd parameter: 1st associated value, WORD at byte
offset 2
%1Y0%1Y1%1W2 → 1st parameter: 1st associated value, BYTE at byte off‐
set 0
2nd parameter: 1st associated value, BYTE at byte off‐
set 1
3rd parameter: 1st associated value, WORD at byte
offset 2
%1B0%1B1%1B2%1B3%1I1 → 1st parameter: 1st associated value, BOOL at bit offset
0
2nd parameter: 1st associated value, BOOL at bit off‐
set 1
3rd parameter: 1st associated value, BOOL at bit offset
2

Configuring alarms
4th parameter: 1st associated value, BOOL at bit offset

3
5th parameter: 1st associated value, INTEGER (16-bit,
signed) at byte offset 1
Example of an alarm attribute file (how to create an alarm attribute file, see Changing alarm
attributes (Page 236)):
<?xml version="1.0" encoding="ISO-8859-1"?>

<Types>
<Type TypeID="32" TypeName="Condition">
<Category CatID="1" Version="1.0">
<CatDescr>Alarms of the SINUMERIK 840D sl.</CatDescr>
<Attributes>
<Attribute AttrName="MSGTEXT" AttrID="-1" AttrDataType="10"/>
<Attribute AttrName="HMIPROPARAMDESCR2" AttrID="5012" AttrDataType="10"/>
</Attributes>
</Category>
</Type>
</Types>
<Sources>
<Source CatLink="1" SourceID="51" SourceURL="/PLC/PMC">
<Alarms>

<MSGTEXT>my_oem_plc_alarms_context|700000/PLC/PMC</MSGTEXT>
<HMIPROPARAMDESCR2>%1Y0%1Y1%1Y2</HMIPROPARAMDESCR2>
</Alarm>

<HMIPROPARAMDESCR2>%1W0%1W2%1W4</HMIPROPARAMDESCR2>
</Alarm>

<HMIPROPARAMDESCR2>%1I0%1I2%1Y4</HMIPROPARAMDESCR2>
</Alarm>

<HMIPROPARAMDESCR2>%1Y0%1W1%1D3%1Y7</HMIPROPARAMDESCR2>
</Alarm>

Configuring alarms
</Alarms>
</Source>
</Sources>
13.4.2 Definition of the language-dependent formatting
Format statement
The format statement is part of the alarm text and is used as a placeholder for a parameters
to be displayed.
Syntax
The following syntax applies for the format statement:
<Format directive> ::= @ <No. of the parameter description><Format specification> @

%[i]x ::= Hexadecimal number with i digits
%[i]u ::= Decimal number without sign with i digits
%[i]d ::= Decimal number with sign with i digits (incl. sign)
%[i]b ::= Binary number with i digits
%[i][.y]f ::= Fixed-point number: Signed value of the form [-]xxx.yyyy, where i
specifies the total number of digits including sign and decimal point
and y specifies the number of digits after the decimal point. Missing
digits both before and after the decimal point are filled with 0. If there
are more places after the decimal point than permitted by y, this is
rounded off.
If the optional digit specification i is not specified, then only the number of digits is used required
to completely display the number. The same applies when the number of digits specified by i
is not sufficient to completely display the number including sign, i.e. i is then ignored.
The number contained in the format statement does not relate to the position of the associated
value in the alarm PDU, but to the position of the parameter description in the parameter
statement. Any number of format statements can be present in an alarm text.

Configuring alarms
13.5 Deactivating a warning
Examples
@1%b@ → Value from the first parameter description to be displayed as a binary num‐
ber, e.g. "1011011"
@2%8X@ → Value from the second parameter description to be displayed as a hexadec‐
imal number with eight digits, missing digits are filled with 0, e.g. "00AF37FE"
@1%7.2f@ → Value from the first parameter description to be displayed as a fixed point
number with seven digits (incl. sign and decimal point) and two digits after
the decimal point, missing digits are filled with 0, e.g. "-012.34"
Example of an alarm text file (how you create alarm texts, see Creating in-house alarm texts
(Page 228)):
<!DOCTYPE TS>
<TS>
<context>
<name>my_oem_plc_alarms_context</name>
<message>
<translation>Text with three BYTE parameters: @1%X@, @2%u@, @3%b@</translation>
</message>
<message>
<translation>Text with three WORD parameters: @1%X@, @2%u@, @3%b@</translation>
</message>
<message>
<translation>Text with three 16-bit INTEGER parameters: @1%X@, @2%u@, @3%b@</translation>
</message>
<message>
<translation>Text with four parameters: @1%X@, @2%u@, @3%r@, @4%b@</translation>
</message>
</context>
</TS>

Generally, alarms/messages are not used without alarm texts. If the alarm text is missing, the
warning "No text available" is output.
To deactivate the warning, add the <ControlFlags> area to your "slaesvcadapconf.xml"
configuration file.

Configuring alarms
You can copy this area from the original file. The "slaesvcadapconf.xml" file is in the following
directory: /siemens/sinumerik/hmi/base
Setting
In the <MissingTextWarning type="bool" value="FALSE"/> tag, deactivate/activate the
warning.
Entry Meaning
TRUE The warning is displayed.
FALSE The warning is deactivated.
Example
<CONFIGURATION>
<ControlFlags>
<MissingTextWarning type="bool" value="FALSE"/>
</ControlFlags>
</CONFIGURATION>

Configuring alarms

Collision avoidance 14
14.1 Overview
With the aid of collision avoidance, you can avoid collisions and therefore major damage during
the machining of a workpiece or when creating programs.
Software option
You require the "Collision avoidance (machine, working area)" software option in
order to use this function.
Machine manufacturer
Please refer to the machine manufacturer's specifications.
Collision avoidance is based on a machine model. The kinematics of the machine are
described as a kinematic chain. For machine parts, which are to be protected, protection areas
are attached to these chains. The geometry of the protection areas is defined using protection
area elements. The control then knows how they move in the machine coordinate system
depending on the position of the machine axes. You then subsequently define the collision
pairs, i.e. two protection areas, which are monitored with respect to one another.
The "Collision avoidance" function regularly calculates the clearance from these protection
areas. When two protection areas approach one another, and a specific safety clearance is
reached, an alarm is displayed and before the corresponding traversing block, the program is
stopped and/or the traversing motion is stopped.
Data of the machine model

The machine model data is entered into the system variables.
Note
Start-up of a machine model
You require access level 1 (manufacturer) for creating and editing a machine model.
Note
The collision monitoring is only valid for single-channel machines.
Note
Referenced axes
The positions of the axes in the machine area must be known so that the protection areas can
be monitored. For this reason, the collision avoidance is only active after the referencing.

Collision avoidance
14.2 General sequence
NOTICE
No complete machine protection
Incomplete models, e.g. machine parts, workpieces that have not been modeled or new
objects in the working area, are not monitored and can therefore cause collisions.
Collision detection
The detection of a risk of collision is controlled via the following criteria:
● Collision tolerance
The collision tolerance defines the accuracy of the tool modeling. You must note that an
increase in the accuracy reduces the performance.
● Safety clearance
The safety clearance sets the minimum clearance that must exist.
For better visualization, you can assign different colors to the various model parts. If there is
a risk of a collision, at least one collision pair is highlighted in color.
During simultaneous recording, the active machine model is shown in addition to the
simultaneous recording graphic.
References
More detailed explanations of collision avoidance can be found in the following reference:
Special Functions Function Manual:
● Section: "Kinematic chain (K7)"
● Section: "Geometric machine modeling (K8)"
● Section: "Collision avoidance (K9)"
● Section: "NC/PLC interface signals (Z3)" > "Collision avoidance (K9)"
14.2 General sequence

The following steps are required to create a machine model:
● Activating the option
● Setting machine data
● Create kinematic structure (with kinematic elements)
● Creating protection areas
● Creating protection area elements
● Define collision pairs

Collision avoidance
14.3 Set collision avoidance
14.3 Set collision avoidance
Enable function
Set the following machine data item in order to enable the function:
MD19830 $ON_COLLISION_MASK Functional scope of the collision avoidance

Bit 0 Collision avoidance (machine, tool)
Parameter assignment
No. Identifier Meaning

MD10619 $MN_COLLISION_TOLERANCE Collision tolerance
MD10622 $MN_COLLISION_SAFETY_DIST Safety clearance
MD18896 $MN_MM_MAXNUM_3D_COLLISION Memory location for the collision avoidance
MD18880 $MM_MAXNUM_KIN_CHAIN_ELEM Maximum number of elements for kinematic chains
MD16800 $MN_ROOT_KIN_ELEM_NAME Name of the first element in the kinematic chain
MD18890 $MN_MM_MAXNUM_3D_PROT_AREAS Maximum number of protection areas
MD18892 $MN_MM_MAXNUM_3D_PROT_AREA_ELEM Maximum number of protection area elements
MD18893 $MN_MM_MAXNUM_3D_T_PROT_ELEM Maximum number of tool protection area elements
MD18897 $MN_MM_MAXNUM_3D_INTERFACE_IN Maximum number of NC/PLC interface signals for
the preactivation of protection areas
MD18895 $MN_MM_MAXNUM_3D_FACETS Maximum number of triangles for protection areas
MD18894 $MN_MM_MAXNUM_3D_FACETS_INTERN Maximum number of triangles for automatic tool pro‐
tection areas
MD18899 $MN_PROT_AREA_TOOL_MASK Creation mode for automatic tool protection areas
MD51160 $MNS_ACCESS_WRITE_CA_MACH_JOG Write protection level, collision monitoring machine
jog
MD51161 $MNS_ACCESS_WRITE_CA_MACH_AUTO Write protection level, collision monitoring machine
automatic
MD51162 $MNS_ACCESS_WRITE_CA_TOOL Write protection level collision monitoring tool
Note
If a specific safety clearance has been set for a collision pair via the system variable
$NP_SAFETY_DIST, this has priority over the NC-specific safety clearance set in the
MD10622 $MN_COLLISION_SAFETY_DIST machine data.
NC/PLC interface signals
Signal Meaning
DB10.DBX58.0 - 7 Collision avoidance: Deactivate protection area group
DB10.DBX234.0 - DBX241.7 Collision avoidance: Activate protection area

Collision avoidance
14.4 Graphic machine model editor
Note
The $NP_BIT_NO protection area can be assigned to an arbitrary bit number of the
DB10.DBX234.0 - DBX241.7 interface signals.
The following setting is a prerequisite: $NP_INIT_STAT == "P" (preactivated or PLC controlled)
A detailed description of the machine data is provided in the following documentation:
References
Machine Data and Parameters List Manual
14.4 Graphic machine model editor

This is how you create the machine model from the user interface in a graphic editor that has
2 areas:
● Tree view
In the "Tree" window, model the machine model based on the kinematic chain and allocated
protection areas.
● Graphic view
You also have the option of activating a graphic view.
In the "Graphic" window, you can view and check the result of the machine modeling in the
various views, and, for example, simultaneously correct in the tree view.
Elements that are selected in the tree are highlighted in color in the graphic view.
Procedure
2. Press the softkeys "NC" and "Machine model".

The "Tree" window opens.
The "Tree" window opens.

The following folders are available in the tree view:
● Active data
● Examples
● Network/USB
3. Press the "Graphic" softkey in order to use the graphic view.

Collision avoidance
14.5 Editing the machine model
The "Graphic" window opens in the right half of the editor.

The machine model created in the tree view is displayed in three dimen‐
sions.
4. By pressing the active softkey "Graphic" or "Tree" again, you display the
graphic view or the tree view.

Functions are available in the tree view of the graphic editor, similar to those in the program
editor; these simplify creating and editing a machine model.
Procedure
Copying/cutting/pasting elements
If you want to create a kinematic or protection area element that is similar to an already existing
element, then you can save time if you copy the element and insert it at a different position.
You have the option, for example of also copying inactive subtrees into the active tree.
Copying/cutting and pasting elements

1. Position the cursor on the desired element.
- OR -
3. Position the cursor at the required position and press the "Paste" softkey.
4. Press the "OK" softkey if you wish to attach the element to the chain as
the next element.
The element is inserted and the name is automatically extended by a long
underscore and incremented.
Note:
You have the option of changing the name of the element in the associ‐
ated input window.
- OR -
Press the "Parallel" softkey if you wish to insert the element parallel to the
selected element.
Note:
The “Parallel” softkey is not available for protection areas.

Collision avoidance
Note
Inserting the same element
If you insert the same element, then this is automatically inserted in front of the selected
element.
Deleting elements
1. Place the cursor on the desired element and press the "Delete element"
softkey.
2. Press the "OK" softkey to confirm the deletion.
The selected object is removed.
All subsequent elements are moved into the "Free elements" folder.
- OR -
If the selected element is linked with additional elements, which are also
to be deleted, then press the "With successors" softkey.
Note
Deleting a machine model
If you select the "Active data" folder in the tree view, and press the "Delete elements" softkey,
and confirm the subsequent prompt with "OK", the machine model is deleted with all elements
and protection areas.
If you do not wish to remove the STL files, then cancel delete with "No" to the prompt "3D files".
Activating the machine model

Each time that an element of the collision model is entered or changed, then the collision model
is automatically activated. If the collision model is incorrect, an error message is output and
the incorrect element has a pink background. The "Activate data" softkeys becomes active,
and you can use this to again initiate possibly acknowledged alarms for the collision model.
1. Press the "Activate data" softkey.

All of the error messages are displayed again, and you have the option
of specifically resolving these by modifying the data.

Collision avoidance
14.6 Changing and adapting the machine model view
14.6.1 Enlarging or reducing the machine graphic
Precondition
● You are in the graphic machine model editor.
● The "Graphic" and "Autozoom" softkeys are active.
Procedure
1. Position the cursor in the graphic.

2. Press the "Zoom +" softkey if you wish to enlarge the size of the section.
- OR -
Press the "Zoom -" softkey if you wish to reduce the size of the section.
- OR -
Press the "Auto zoom" softkeys if you wish to automatically adapt the
segment to the size of the window.
The automatic scaling function takes into account the largest expansion
of the model.
Note
Selected section
The selected sections and size changes are kept as long as the program is selected.
Note
Mouse operation
Using the mouse wheel, you have the option of shifting the model in the graphic view.
14.6.2 Changing the section of the machine graphic

Use the magnifying glass if you would like to move, enlarge or reduce the size of the section
when viewing the machine model, e.g. to view details and to subsequently display the complete
model.
Using the magnifying glass, you can define your own section and then enlarge or reduce its
size.

Collision avoidance
Requirement
Procedure

2. Press the "Magnifying glass" softkey.
A magnifying glass in the shape of a rectangular frame appears.
3. Press the "Magnify +" or <+> softkey to enlarge the frame.
- OR -
Press the "Magnify -" or <-> softkey to reduce the frame.
- OR -
Press one of the cursor keys to move the frame up, down, left or right.
4. Press the "Accept" softkey to accept the selected section.
14.6.3 Rotating and shifting the machine graphics

You have the option of rotating and shifting the position of the machine graphics so that you
can view the model from all sides.
Requirement
Procedure

2. Press the "Rotate view" softkey.

Collision avoidance
3. Press the "Arrow right", "Arrow left", "Arrow up", "Arrow down", "Arrow
clockwise" or "Arrow counter-clockwise" softkey to change the position of
the machine model.
...
...
- OR -
Press the <Cursor right>, <Cursor left>, <Cursor up> or <Cursor down>
key to move the machine model.
- OR -
Keep the <Shift> key pressed and rotate the machine model in the desired
direction using the appropriate cursor keys.
Note
Working with a mouse
Using a mouse, you have the option of rotating and shifting the model in the graphic view.
● Move the model with the left-hand mouse key pressed to shift the model.
● Move the model with the right-hand mouse key pressed to rotate the model.
14.6.4 Various machine model views

For the graphic display of the machine model, you can choose between various views. This
allows you to always optimally view the actual machining situation.
The following views are available:
● From the front
View parallel to the Y axis
● Side view
View parallel to the X axis
● Top view
View parallel to the Z axis
Precondition

Collision avoidance
Procedure
1. Position the cursor in the graphic

2. Press the ">>" and "Views" softkeys.
2. Press the "From front" softkey if you wish to view the machine model from
the front.
- OR -
Press the "Side view" softkey if you wish to view the machine model from
the side.
- OR -
Press the "Top view" softkey if you wish to view the machine model from
the top.
14.6.5 Displaying protection area elements for collision avoidance

In the graphic display, you can select between the following display types:
● Display model
In the graphic display of the machine model, all elements are displayed where the "Display"
or "Display+monitoring" setting was selected for element value "Use".
● Monitoring model
In the graphic display of the machine model, all elements are displayed where the
"Monitoring" or "Display+monitoring" setting was selected for element value "Use".
Both display versions can be simultaneously selected.
Precondition
Procedure
1. Position the cursor in the graphic

The machine model with all display and monitoring elements is displayed
in the graphics window.
3. By deselecting, i.e. by pressing the corresponding softkey again, you can

display and hide the display elements and monitoring elements.

Collision avoidance
14.7 Creating a kinematic structure
Setting the detail level

If, for protection elements, different detail levels are specified, then soft‐
keys are available that you can use to change the detail level.
1. Press the "Detail level +" softkey to display the next higher detail level.
- OR -
Press the "Detail level -" softkey to display the next lower detail level.
Note
One of the two display versions is always active!
14.7.1 Kinematic elements
14.7.1.1 Creating a kinematic chain element

An exact kinematic description of the machine is required in order to be able to detect collisions.
To do this, you describe the kinematic sequence of the linear and rotary axes as well as the
position and direction in relationship to the world coordinate system (ROOT). This informs the
control, for example, whether the Y axis is moved by the X axis or vice versa.
Kinematic elements
The following elements are available to create the kinematic chain:
● Rotation and parallel rotation
● Linear axis and parallel linear axis
● Rotary axis and parallel rotary axis
● Offset and parallel offset
● Switch and parallel switch
World coordinate system

To uniquely describe the kinematic structure of a machine, all elements of the kinematic chain
are referred to the world coordinate system.
You have the option of freely selecting the origin and orientation of the world coordinate system.
However, it is recommended that you orientate the world coordinate system so that the

Collision avoidance
coordinate axes are arranged in the positive traversing direction of the machine linear main
axes.
Requirement
● The option is set.
● The machine data is set.
Procedure
Defining a ROOT element

1. Machine data 16800 $MN_ROOT_KIN_ELEM_NAME contains the name
of the ROOT element. This defines the start of the kinematic chain.
All subsequent, parameterized elements and subchains that are connec‐
ted with this element are part of the currently effective kinematic chain.
2. Switch to the graphic machine model editor.
3. Position the cursor to the "Active data" folder and press the "New element"
and "Kinematic element" softkeys.
The "New kinematic element" selection window opens.
4. For example, select the "Offset" element and press the "OK" softkey.
The "Offset" window opens to define the shift vector.
The first element of the kinematic chain can be an offset, a rotation, a
linear axis or also a rotation axis.
5. Press the "OK" softkey to insert the element.
Attaching additional kinematic elements

Depending on your machine, you can attach any number of elements or
branch off subchains.
See also
Kinematic rotation and parallel kinematic rotation (Page 270)
Linear axis and parallel linear axis (Page 271)
Rotary axis and parallel rotary axis (Page 272)
Offset and parallel offset (Page 272)
Switch and parallel switch (Page 273)
14.7.1.2 Kinematic rotation and parallel kinematic rotation

You can define fixed rotation of a subsequent element in the "Rotation" window.

Collision avoidance
Display in the tree topology
Kinematic rotations are identified by this symbol in the tree topology.
Element values
Parameter Meaning
Name Designation, which is displayed in the tree structure.
Rotary axis (X) X component of the vector, around which the system rotates.
Rotary axis (Y) Y component of the vector, around which the system rotates.
Rotary axis (Z) Z component of the vector, around which the system rotates.
Angle of rotation Angle, around which the system rotates in the direction of the rotation
vector.
See also
Creating a kinematic chain element (Page 269)
14.7.1.3 Linear axis and parallel linear axis

You define the position and orientation of the axes, whose traversing motion describes a
straight line, in the "Linear axis" window.
Dynamic linear axes are identified by this symbol in the tree topology.
Element values
Parameter Meaning
Axis (X) X component of the direction vector
Axis (Y) Y component of the direction vector
Axis (Z) Z component of the direction vector
Axis name Specification of the axis identifier (see MD 10000)
Axis offset Additive offset between the actual position of the axis, and the value
used by the collision monitoring.
See also

Collision avoidance
14.7.1.4 Rotary axis and parallel rotary axis

In the "Rotation axis" window, you define a rotary axis, whose traversing motion describes a
circle or arc. This means that you change the orientation of the subsequent elements.
Dynamic rotation axes are identified by this symbol in the tree topology.
Element values
Parameter Meaning
Rotary axis (X) X component of the vector, around which the system rotates.
Rotary axis (Y) Y component of the vector, around which the system rotates.
Rotary axis (Z) Z component of the vector, around which the system rotates.
Axis name Specification of the axis identifier (see MD 10000)
Axis offset Additive offset between the actual position of the axis, and the value
used by the collision monitoring.
See also
14.7.1.5 Offset and parallel offset

In the "Offset" window you define fixed linear offsets of the subsequent elements, which are
linked with this element.
Static offset vectors are designated by this symbol in the tree topology.
Element values
Parameter Meaning
Offset (X) X component of the direction vector.
Offset (Y) Y component of the direction vector.
Offset (Z) Z component of the direction vector.
See also

Collision avoidance
14.7.1.6 Switch and parallel switch

In the "Switch" window, you specify which of the following elements can be switched on or off
in an active kinematic chain.
Switching elements are identified by this symbol in the tree topology.
Element values
Parameter Meaning
Number Index of the switch in a kinematic chain (default = -1, the switch is
switched on constantly).
Position Value at which the switch is to be switched on.
See also
14.7.2 Protection areas
14.7.2.1 Creating protection areas

● At locations where there are machine components, e.g. table or spindle in the machining
area, machine protection areas are defined.
● At the positions where tools can be in the collision space, tool protection areas
(e.g. for a turning tool of the cutting part, i.e. the cutting edge) are created and defined.
Note
Tool carriers are not modeled
Tool carriers, clamping or cutting edge holders are not emulated in the machine modeling and
are not checked for collision.
Precondition
● The option is set
● Machine data is set
● A kinematic chain has been created

Collision avoidance
Procedure
1. Position the cursor at the kinematic chain element to which you wish to
attach a protection area.
3. Press the "Collision element" softkey.

The "New Collision Element" selection window opens.
4. Select "Machine protection area" if you wish to model a machine part.
- OR -
Select "Tool protection area" if you wish to model a tool part.
5. Press the "OK" softkey to insert the element.
The "Machine Protection Area" or "Tool Protection Area" window opens.
6. Enter the desired values and press the "OK" softkey to confirm your en‐
tries.
Attach additional protection areas
You have the option of attaching as many protection areas as you require,
corresponding to your machine.
See also
Tool protection area (Page 274)
Machine protection area (Page 275)
14.7.2.2 Tool protection area

Parameterize model use in the "Tool Protection Area" window.
You define from where the control retrieves data to generate the machine model.
Further, you define the parameters to monitor and display the element.
For a protection area, the protection area element is automatically taken from the tool
management data. For instance, if you define a tool protection area for a tool in the spindle,
then for a tool change (M6), a new tool protection area element is created with the data of the
new tool.
Note
For the automatic tool protection area, a spindle must exist in the channel.
Note
Attaching a tool protection area
"Frame" type tool protection area elements may be attached to tool protection areas.

Collision avoidance
Tool protection areas are identified by this symbol in the tree topology.
Element values
Parameter Meaning
Color Selection of the color
Detail level Defines from which detail level the protection area or the protection area
elements are displayed on the user interface.
● Lowest detail level: 0
● Highest detail level: 3
PLC bit Only for pre-activation
● -1
Not activated
● 0 - 63
Activation of the collision avoidance is controlled using the bit
entered here.
The maximum number of PLC bits depends on MD18897. It can be
a maximum of 64.
Activation ● Activates the collision avoidance for the protection area.

● Deactivated
Deactivates the collision avoidance for the protection area.
● Preactivated
entered into the "PLC bit".
TO unit Specifies the TO area in which the magazine and tool data are saved.
Magazine When magazine management is active:
Specifies the magazine number in which the tool or magazine location
is located (e.g. for spindle 9998).
Location ● Without magazine management: 1
● For revolvers: Number of the magazine location
See also
Creating protection areas (Page 273)
14.7.2.3 Machine protection area

In the "Machine protection area" window, you model the machine parts, for example, a table.
You define the parameters to monitor and display the element.

Collision avoidance
Machine protection areas are identified by this symbol in the tree topology.
Element values
Parameter Meaning
Color Selection of the color
● Lowest detail level: 0
● Highest detail level: 3
PLC bit Only for pre-activation
● -1
Not activated
● 0 - 63
entered here.
The maximum number of PLC bits depends on MD18897. It can be
a maximum of 64.
Activation ● Activated
Activates the collision avoidance for the protection area.
● Deactivated
Deactivates the collision avoidance for the protection area.
● Preactivated
entered into the "PLC bit".
See also
Creating protection areas (Page 273)
14.7.3 Protection area elements
14.7.3.1 Creating protection area elements

To protect machine parts and tools, model a protection area with the following basic bodies:
● Frame or parallel frame
● Box or parallel box

Collision avoidance
● Sphere or parallel sphere

● Cylinder or parallel cylinder
● File or parallel 3D file
Note
Parallel protection area elements
You have the possibility of creating two protection area elements in parallel in a hierarchic level
of the tree structure. This means that parallel elements have the previous element as the same
origin.
To create two elements in parallel with one another at one level, use a "parallel" element.
If you create an additional protection area element, then this is shifted into the next level.
Preconditions
● A kinematic chain has been created
● The cursor is on a protection area (machine or tool protection area) or at a protection area
element.
Procedure
2. The "New Collision Element" selection window opens.
3. Select the required basic form (e.g. box to model a table) and press the
"OK" softkey.
The corresponding window to enter the element values opens.
4. Define the values and press the "OK" softkey to confirm the entries.
Attaching additional protection area elements

You have the option of attaching as many protection area elements as
you require, corresponding to your machine.
See also
Frame and parallel frame protection area element (Page 278)
Box and parallel box protection area elements (Page 279)
Sphere and parallel sphere protection area elements (Page 281)
File and parallel 3D file protection area element (Page 284)
Cylinder and parallel cylinder protection area element (Page 282)

Collision avoidance
14.7.3.2 Frame and parallel frame protection area element

You define a coordinate system transformation that will take effect for the following protection
area elements in the "Frame" window.
With elements of this type, you define, for example, additional work offsets or rotations between
protection area elements.
Note
A work offset or coordinate rotation affects all the following protection area elements.
Coordinate system transformations are identified by this symbol in the tree top‐
ology.
Element values
Parameter Meaning
Rotary axis (X) X component of the rotation vector.
Rotary axis (Y) Y component of the rotation vector.
Rotary axis (Z) Z component of the rotation vector.
Angle of rotation The value by which the system rotates around the rotation vector.
See also
Creating protection area elements (Page 276)

Collision avoidance
14.7.3.3 Box and parallel box protection area elements

You can specify the values for the display or collision monitoring of a box-shaped protection
area element in the "Box" window.
]
+ \
[
%
/
Y
=
Y
<
;
:HOWNRRUGLQDWHQV\VWHP
V1 Sum of the offset and rotation between this element and the root element.
V2 Offsets and rotation from the parameters of this element.
Box-shaped protection area elements are identified by this symbol in the tree
topology.
Element values
Parameter Meaning
Color
Selection of the color for the protection area element.
● Activate the checkbox "From protection area", if the color of the
associated tool and/or machine protection area should be applied.
Deactivate the checkbox "From protection area" in order to select
any color.
● Select the required color from the selection list.
● Activate the checkbox "From protection area", if the detail level of
the associated tool and/or machine protection area should be
applied.
Deactivate the checkbox "From protection area", if you wish to
define your own detail level for the element.
● Enter the desired level of detail:
– Lowest detail level: 0
– Highest detail level: 3

Collision avoidance
Parameter Meaning
Use ● Display
The protection area element is shown in the graphic view.
The element is only visible if the "Display model" softkey is active.
The element is not monitored for collision.
● Monitoring
The protection area element is used for the collision avoidance.
The element is only visible if the "Monit. model" softkey is active.
● Display and monitoring
The protection area element is used for display in the graphic view
and for collision avoidance.
The element is visible in both display versions.
Length (X) Length of the cube in the X direction.
Width (Y) Width of the cube in the Y direction.
Height (Z) Height of the cube in the
Z direction.
See also

Collision avoidance
14.7.3.4 Sphere and parallel sphere protection area elements

You can specify the dimensions and position as well as values for the display and collision
monitoring of a sphere-shaped protection area element in the "Sphere" window.
<
;
5
Y
=
Y
<
;
Sphere-shaped protection area elements are identified by this symbol in the tree
topology.
Element values
Parameter Meaning
Color Selection of the color for the protection area element.
● Activate the checkbox "from protection area", if the color of the
Deactivate the checkbox "from protection area" in order to select
any color.
● Activate the checkbox "from protection area", if the detail level of
applied.
Deactivate the check box "from protection area", if you wish to define
your own detail level for the element.

Collision avoidance
Parameter Meaning
Use ● Display
● Monitoring
● Display + monitoring
Radius Specification of the radius
See also
File and parallel 3D file protection area element (Page 284)
14.7.3.5 Cylinder and parallel cylinder protection area element

monitoring of a cylindrical protection area element in the "Cylinder" window.

Collision avoidance
<
;
5
Y
=
Y
<
;
Cylinder-shaped protection area elements are identified by this symbol in the

tree topology.
Element values
Parameter Meaning
any color.
applied.

Collision avoidance
Parameter Meaning
Use ● Display
● Monitoring
Height (Z) Height of the cylinder in the
Z direction.
Radius Specification of the radius
See also
14.7.3.6 File and parallel 3D file protection area element

monitoring of a sphere-shaped protection area element in the "Sphere" window.
The file used here contains a grid of triangular areas in the STL format, with which you can
display bodies with complicated shapes.
Note
Coordinate origin
The coordinate origin of the file does not have to match the coordinate system of the machine.
You align the coordinate system using offsets and rotations.

Collision avoidance
;
<
Y
=
Y
<
;
STL files are identified by this symbol in the tree topology.
Element values
Parameter Meaning
any color.
applied.

Collision avoidance
Parameter Meaning
Use ● Display
● Monitoring
File name Name of the file with the description of the protection area element in
STL format.
See also
Sphere and parallel sphere protection area elements (Page 281)
14.7.4 Collision pair
14.7.4.1 Creating a collision pair

Using collision pairs, you define the two protection areas, which should mutually monitor
themselves regarding collision.
Precondition
A kinematic chain has been created and includes valid protection areas.

Collision avoidance
Procedure
1. Position the cursor in the tree view on the "Collision groups" folder.
The "New collision element" selection window opens.
2. Select "Collision pair" and press the "OK" softkey.
3. Enter the values and press the "OK" softkey to confirm the entries.
See also
Collision pair (Page 287)
14.7.4.2 Collision pair

In the "Collision pair" window you define the protection areas, which should mutually monitor
themselves regarding collision. Further, you select a safety clearance here.
Collision pairs are identified by this symbol in the tree topology.
Element values
Parameter Meaning
1. Area Designation of the first protection area that is to be monitored.
2. Area Designation of the second protection area that is to be monitored.
Safety clearance Defining the safety clearance:
● 0
For the safety clearance, the value that has been defined in
MD10622 is taken.
● >0
The value that you entered here is used for the safety clearance.
Note
In order that the defined protection areas are checked for collision, they must be activated and
the collision avoidance activated.
See also
Creating a collision pair (Page 286)

Collision avoidance
14.8 Collision avoidance example
14.7.5 Supplementary condition
Tool changes
If, in a machine model, tools change as a result of being replaced/exchanged or wear without
programming a tool offset selection (D number), then the recalculation of the machine model
must be explicitly requested. You will find more precise information in:
Function Manual Special Functions (FB3); collision avoidance (K9),
Chapter: "Function description" > "Tools"
14.8.1 Fundamentals
General Information
The following example contains the machine model elements of a simple 3-axis milling
machine for a simplified kinematic chain.
Machine model elements
6WDQG

=D[LV
<
7RROKROGHU =

<
; ;
7RRO
0DFKLQH]HUR

7DEOH
5HIHUHQFHSRLQW

Collision avoidance
The following elements are defined for the example of the 3-axis milling machine:
Element Color Direction of movement

Table Green X, Y
Z axis Gray Z
Column Gray None
Tool holder Blue Z
Tool (when used) red Z
Machine zero None None
Geometry
Each machine-model element has a defined geometry and an offset vector to the element
center starting with the machine zero:

9=$

96

9722/

=

97

ෘ <
;

The following offset vectors are defined for the example of the 3-axis milling machine:
Element Offset vector

Tool holder Vtool = (0; 0; 25)
Z axis VZA = (0; 200; 130)
Column VS = (0; 570; 350)
Table VT = (100; 50; -25)

Collision avoidance
Structure of the geometric machine modeling

The kinematic chain begins with the first offset kinematic element that represents the machine
zero. The other kinematic elements form the linear axes X, Y and parallel Z. The protection
area is used to define the basic bodies of the machine and tools. The movable protection areas
are linked with the associated linear axis; the unmovable protection area is linked with the
offset.
*HRPHWULFPDFKLQHPRGHOLQJ
3URWHFWLRQDUHDHOHPHQWV ),/( &</,1'(5 %2;
7 7RROKROGHU
722/ 0$&+,1( =D[LV
3URWHFWLRQDUHDV 0$&+,1(

.LQHPDWLFFKDLQ
=D[LV
$;,6B/,1
2))6(7 ;D[LV <D[LV

$;,6B/,1 $;,6B/,1
6WDQG 7DEOH 3URWHFWLRQDUHDV

0$&+,1( 0$&+,1(
%2; %2; 3URWHFWLRQDUHDHOHPHQWV

Collision avoidance
14.8.2 Create machine model example
14.8.2.1 Creating kinematic elements
Offset
1. Mark the "Active data" folder and press the "New element" softkey.
A selection window with kinematic elements opens.
2. Select the "Offset" kinematic element and press the "OK" softkey.
The appropriate input window for the element values opens in the lower
part of the tree view.
3. Enter the required values:
Name: ROOT
Offset (X): 0
Offset (Y): 0
Offset (Z): 0
4. Press the "OK" softkey to save the values.
- OR -
Press the "Cancel" softkey to close the input window.
Linear axis X under offset
1. Mark the "ROOT" kinematic element and press the "New element" soft‐
key.
2. Select the "Linear axis" kinematic element and press the "OK" softkey.
Name: X axis
Axis (X): 1
Axis (Y): 0
Axis (Z): 0
Axis name: X1
Axis offset: 0
- OR -

Collision avoidance
Linear axis Y under linear axis X
1. Mark the "X axis" kinematic element and press the "New element" softkey.
2. Select the "Linear axis" kinematic element and press the "OK" softkey.
Name: Y axis
Axis (X): 0
Axis (Y): 1
Axis (Z): 0
Axis name: Y1
Axis offset: 0
- OR -
Linear axis Z parallel to linear axis X
1. Mark the "X axis" kinematic element and press the "New element" softkey.
2. Select the "Parallel linear axis" kinematic element and press the "OK"
softkey.
Name: Z axis
Axis (X): 0
Axis (Y): 0
Axis (Z): 1
Axis name: Z1
Axis offset: 0
- OR -

Collision avoidance
14.8.2.2 Creating machine protection areas
Stand under offset
1. Mark the "ROOT" kinematic element and press the "New element" soft‐
key.
3. In the "New collision element" window, select the collision element "Ma‐
chine protection area" and press the "OK" softkey.
4. Enter the following values:
Name: Stand
Color: Gray
Detail level: 0
PLC bit: -1
Activation: Activated
Box element under stand
1. Mark the "Stand" machine protection area and press the "New element"
softkey.
2. Select the "Box" protection area element and press the "OK" softkey.

Name: SBE stands
Color: From protection area
Detail level: From protection area
Application: Display
Length (X): 160
Width (Y): 140
Height (Z): 800
Offset (X): 0
Offset (Y): 570
Offset (Z): 350

Collision avoidance
Table under linear axis Y
1. Mark the "Y axis" kinematic element and press the "New element" softkey.
3. Select the "Machine protection area" collision element and press the "OK"
softkey.
Name: Table
Color: Green
PLC bit: -1
Detail level: 0
Box element under table
1. Mark the "Table" machine protection area and press the "New element"
softkey.

Name: SBE table
Application: Display and monitoring
Length (X): 200
Width (Y): 100
Height (Z): 50
Offset (X): 100
Offset (Y): 50
Offset (Z): -25
Z axis under linear axis Z
1. Mark the "Z axis" kinematic element and press the "New element" softkey.

Collision avoidance
softkey.
Name: Z axis
Color: Gray
Detail level: 0
PLC bit: -1
Box element under Z axis
1. Select the "Z axis" machine protection area and press the "New element"
softkey.

Name: SBE-Z axis
Length (X): 160
Width (Y): 600
Height (Z): 160
Offset (X): 0
Offset (Y): 200
Offset (Z): 130
Tool holder under linear axis Z
softkey.
Name: Tool holder
Color: Blue
Detail level: 0

Collision avoidance
PLC bit: -1
Cylinder element under tool holder
1. Mark the "Tool holder" machine protection area and press the "New ele‐
ment" softkey.
2. Select the "Cylinder" protection area element and press the "OK" softkey.

Name: SBE tool holder
Height (Z): 50
Radius: 60
Offset (X): 0
Offset (Y): 0
Offset (Z): 25
14.8.2.3 Creating a tool protection area
Tool under linear axis Z
3. In the selection box, select "Tool protection area" collision element and
press the "OK" softkey.
Name: T
Color: red
Detail level: 0
PLC bit: -1
TO unit: 1
Magazine: 9998.

Collision avoidance
Location: 1
14.8.2.4 Creating collision pairs
Tool/table collision pair
1. Mark the "Collision groups" folder and press the "New element" softkey.
A selection window for the collision element opens.
2. Select the "Collision pair" collision element and press the "OK" softkey.
1st range: T
2nd range: Table
- OR -
Tool holder / table collision pair
1. Mark the "Collision groups" folder and press the "New element" softkey.
A selection window for the collision element opens.
2. Select the "Collision pair" collision element and press the "OK" softkey.
1st range: Tool holder
2nd range: Table
- OR -

Collision avoidance

Data backup 15
Data backup
The following times are recommended for performing a data backup:
● After a start-up
● After changing machine-specific settings
● After replacing a hardware component
● For a software upgrade
● Before the activation of memory-configuring machine data
Note
A start-up archive is saved as a file of the type ".arc" (archive).
There are various ways of creating and reloading archives via the SINUMERIK Operate user
interface.
● Standard archive: Data can be selected specifically in the data tree and backed up by
pressing the "System data" softkey.
● Start-up archive: The "Start-up archive" softkey offers the following selection:
– Create and read-in a start-up archive
– Create PLC hardware upgrade archive (only SDBs)
– Create and read in archive of original status
Storage locations
Archives can be stored in the following directories:
● CompactFlash card at: System CF-Card/user/sinumerik/data/archive or System CF-Card/
oem/sinumerik/data/archive
● PCU: F:hmisl\user\sinumerik\data\archive or \oem\sinumerik\data\archive
● All configured logical drives (USB, network drives)
Note
USB FlashDrive
USB-flash drives are not suitable as persistent memory media.

Data backup
15.1 Creating a start-up archive
Overview
A start-up archive can be generated, for example, after the control has been commissioned.
To do this, control components can be saved individually or jointly. It is also possible to transfer
the backed-up data to other controls so that they can be updated to the same status.
Note
When generating the start-up archive, programs that have been moved outside the system
(network drive) and any global part program memory that has been set up are not taken into
account. Only the programs from the NC memory and the local drive are archived.
Requirement
You require at least access level 2 (service).
Data of the control components
Control components Data

NC data Machine data
Setting data
Option data
Global (GUD) and local (LUD) user data
Tool and magazine data
Protection zone data
R parameters
Zero offsets
Workpieces, part programs and subprograms
Standard and user cycles
Definitions and macros
With compensation data ● QEC - quadrant error compensation
● CEC - operation/angularity compensation
● EEC - leadscrew pitch / encoder error compensation
It only makes sense to archive machine-specific compensation data
if the start-up file is reloaded into the same control.
With compile cycles Compile cycles (*.elf) are displayed, if compile cycles are available.
PLC data (including CP) OB (organization blocks)
FB (function blocks)
SFB (system function blocks)
FC (functions)
SFC (system functions)
DB (data blocks)
SDB (system data blocks)

Data backup

Drive data Archiving the drive data, either in binary or ASCII format.
HMI data, all
HMI data, selection: If data is available, you must set the check mark to activate the
components.
Texts User texts, alarm texts
Templates Individual templates, workpiece templates
Applications HMI applications, OEM applications
Engineering data Engineering data
Configuration Configurations, incl. display of machine data
Help Help files
Version data Version data
Logs Error logs
Program lists Program lists
Dictionaries Dictionaries
Data backups Files located in the data tree of the "System data" in the "HMI data /
data backups" directory.
Programs on local drive Programs contained in the user memory area of the CompactFlash
card.
Comment Entry field for possible comments regarding the start-up archive.
Created by Entry field for the creator as well as creation date of the start-up
archive.
Procedure
3. Press the "Start-up archive" softkey.

The "Start-up" window opens.
4. Activate "Create a start-up archive" and press the "OK" softkey.
The "Create Start-up Archive" window opens.
5. Select the desired control components.
6. When required, enter a comment as well as your name and the date of
creation.
The "Generate Archive: Select Storage Location" window opens.

Data backup
15.2 Reading-in a start-up archive
8. Position the cursor at the required storage location, press the "Search"
softkey and enter the required search term in the search dialog. Then
press the "OK" softkey if you wish to search for a certain directory or
subdirectory.
Note: The place holders "*" (replaces any character string) and "?" (re‐
places any character) make it easier for you to perform a search.
- OR -
Select the required storage location, press the "New directory" softkey,
enter the required name in the "New Directory" window and press the
"OK" softkey to create a directory.

The "Generate Archive: Name" window opens.
10. Enter the required name and press the "OK" softkey.
An archive file with the ARC format type is stored in the selected directory.
15.2 Reading-in a start-up archive
NOTICE
Loss of additional languages during software upgrade
All the system languages are overwritten during software upgrades. If there are more
languages in the system than in the upgrade archive, these additional languages are lost
when the archive is read in. It is not possible to back up the languages before software
upgrade.
Note
The reading in of a start-up archive with drive configurations results in the overwriting of the
drives in the logdrive.ini file. The system creates a backup copy with the name logdrive_ini.sav
or logdrive.oldstyle. Before the archive is read in, the new drive configurations are activated.
Note
To prevent the NCU from shutting down unintentionally, you must disable all energy saving
profiles before you read in a start-up archive. For more detailed information about the energy
saving profiles topic, see:
Operating Manuals for SINUMERIK Operate, Chapter "Ctrl Energy".
Requirement
You require at least access level 2 (service).

Data backup
15.3 Backing up the hardware configuration
Procedure
Press the menu forward key.
3. Activate "Read-in a start-up archive" and press the "OK" softkey.

The "Select Start-up Archive" window opens.
4. Select a storage location and position the cursor at the required start-up
archive (ARC).
- OR -
Select the required storage location, press the "Search" softkey and enter
the required search term. Then press the "OK" softkey if you wish to
search for a certain directory, subdirectory or start-up archive.

The "Read-in Start-up Archive" window opens.
You obtain an overview with path details, version information, name of
the archive, etc., as well as a list of the archived components.
Remove the tick of a checkbox to exclude a component from the read-in
process.
6. Press the "OK" softkey to download the selected archive file.
The "Read-in Archive" window opens and a progress message box ap‐
pears for the read-in process.
7. Press the "Overwrite all" softkey if you wish to overwrite the existing files.
- OR -
Press the "No overwriting" softkey if you wish to keep existing files.
- OR -
Press the "Skip" softkey if you only wish to overwrite certain files.
You will then obtain a "Read error log for archive" in which the skipped or
overwritten files are listed.
8. Press the "Cancel" softkey to cancel the read-in process.
15.3 Backing up the hardware configuration

The hardware is configured via the system data blocks (SDB) and only these are stored in the
archive.

Data backup
15.4 Creating an archive with original data
Procedure
Press the menu forward key.

3. Activate "Create PLC hardware upgrade archive (SDBs only)" and press
the "OK" softkey.
The "Create PLC hardware upgrade archive (SDBs only): Select Storage
Location" window opens.
4. Select the desired storage location in the displayed data tree.
- OR -
Press the "New directory" softkey to create a separate directory.
The "New Directory" window opens.
5. Enter the required name and press the "OK" softkey.
The directory is created below the created folder.
The "Generate Archive: Name" window opens.
The file type of the archive is ARC and is displayed in the window. Enter
the desired name and press the "OK" softkey.
The archive is generated and stored in the selected directory.

You can select this type of start-up in order to save the original status of the control. The files
are archived in the "original.arc" file.
The file is stored on the CompactFlash card in the Archives/Manufacturer directory.
If there is no "original.arc" file in the directory, it is recommended that an archive be generated
from the data of the original control state as delivered.
As for "Create start-up", control components can be saved individually or jointly.
Requirement
In order to save NC data, you require access level 2 (service).
To back up programs/workpieces, you require access level 6 (keyswitch position 1).

Data backup
Data of the control components

NC data Machine data
Setting data
Option data
Global (GUD) and local (LUD) user data
Tool and magazine data
Protection zone data
R parameters
Zero offsets
Compensation data
Workpieces, part programs and subprograms
Standard and user cycles
Definitions and macros
With compensation data ● QEC - quadrant error compensation
● CEC - operation/angularity compensation
● EEC - leadscrew pitch / encoder error compensation
● It only makes sense to archive machine-specific compensation
data if the series start-up file is reloaded into the same control.
With compile cycles Compile cycles (*.elf) are displayed if compile cycles are available.
PLC data (including CP) OB (organization blocks)
FB (function blocks)
SFB (system function blocks)
FC (functions)
SFC (system functions)
DB (data blocks)
SDB (system data blocks)
HMI data, all
HMI data, selection:
Cycle storage Definitions and cycles
Texts User texts, alarm texts
Templates Individual templates, workpiece templates
Applications HMI applications, OEM applications
Engineering data Engineering data
Configuration Configurations, incl. display machine data
Help Help files
Version data Version data
Logs Error logs
User views Individually compiled tables with selected machine and setting data.
Dictionaries Dictionaries
Programs on local drive Programs contained in the user memory area of the CompactFlash
card.

Data backup
15.5 Reading in an archive with original data
Procedure

4. Activate the "Create archive of original status" checkbox and press the
"OK" softkey.
The "Create Start-up for Original Status" window opens.
5. Select the desired control components.
6. When required, enter a comment into the field as well as your name and
the date of creation - and then press the "OK" softkey.
A warning is output if an "original.arc" archive file already exists.
7. Press the "OK" softkey to overwrite the file.
A new archive file is generated and stored in the Archives/Manufacturer
directory.
- OR -
Press the "Cancel" softkey so that the existing file is not overwritten.
15.5 Reading in an archive with original data

The data of the original controller state is stored in the "original.arc" file. If you want to restore
the controller to the as-delivered state, you can read in the original data archive.
Precondition
You require access level 2 (service).
Procedure


Data backup
15.7 Serial interface (V24 / RS232)
4. Activate the "Read in archive of original status" checkbox and press the
"OK" softkey.
SINUMERIK Operate automatically accesses the "original.arc" file.
A window opens prompting whether you want to perform a start-up.
The read-in process is started and a progress message box is displayed
in the window.
Any errors that occur are then displayed in the "Write Error Log for Ar‐
chive" window.
15.6 Generating the complete archive

You have the option of generating an archive of the complete data of your control on an external
storage medium that you can provide to Technical Support for diagnostic purposes.
Procedure
1. Insert the storage medium in the USB port.
2. Press the key combination <Ctrl> + <Alt> + S.
All data required for diagnostics are compiled in an archive. Operator control is not possible
while the archive is being generated.
3. You will receive a message once archiving has been completed.
The system assigns an archive name and this is: CompletArchiv<Date>_<Time>.arc.
The dialog box is closed and you can re-operate the control.
15.7.1 Reading-in and reading-out archives via a serial interface
Availability of the V24 serial interface

You have the option of reading-out and reading-in archives in the "Program manager"
operating area as well as in the "Startup" operating area via the V24 serial interface.
● SINUMERIK Operate on the NCU:
The softkeys for the V24 interface are available as soon as an option module is connected
and the slot is occupied.
● SINUMERIK Operate on the PCU:
The softkeys for the V24 interface are always available.

Data backup
Reading-out archives
The files to be sent (directories or individual files) are zipped in an archive (*.arc). If you send
an archive (*.arc), this is sent directly without being additionally zipped. If you have selected
an archive (*.arc) together with an additional file (e.g. directory), then these are zipped into a
new archive and are then sent.
Reading-in archives
Only archives can be read-in via the V24 interface. These are transferred and then
subsequently unzipped.
Note
Start-up archive
If you read in a start-up archive via the V24 interface, then this is immediately activated.
Externally processing the punched tape format

If you wish to externally process an archive, then generate this in the punched tape format.
Procedure
1. Select the "Program manager" operating area, and press the "NC"
or "Local drive" softkey.
...
- OR -
Select the "Startup" operating area and press the "System data"
softkey.
Reading-out archives
2. Select the directories or the files that you wish to send via V24.
3. Press the ">>" and "Archive" softkeys.

Data backup
4. Press the "V24 send" softkey.
- OR -
Reading in an archive
Press the "V24 receive" softkey if you wish to read-in files via V24.
15.7.2 Setting interface parameters
Procedure
3. Press the ">>" and "Archive" softkeys.
4. Select the "RS-232-C settings" softkey.

The "Interface: RS-232-C" window is opened and the interface set‐
tings are displayed.
5. Press the "Details" softkey if you wish to view and process addi‐
tional settings for the interface.
RS-232-C settings
Parameter Meaning
Protocol The following protocol is supported for transfer via the RS-232-C:
● RTS/CTS
Transfer It is also possible to use a secure protocol for data transfer (ZMODEM
protocol).
● Normal (default setting)
● Secure
For the selected interface, secure data transfer is set in conjunction
with handshake RTS/CTS.

Data backup
Parameter Meaning
Baud rate Transfer rate: Transfer rates of up to 115 kbaud can be selected. The
baud rate that can be used depends on the connected device, the cable
length and the general electrical conditions.
● 110
● ....
● 19200 (default setting)
● ...
● 115200
Archive format ● Punched tape
● Binary format (PC format)
RS-232-C settings (details)
Interface ● COM1
● COM2 only relevant for SINUMERIK Operate on PC
Parity Parity bits are used for error detection: The parity bits are added to the
coded characters to make the number of positions set to "1" an uneven
number (uneven parity) or to an even number (even parity).
● None (default setting)
● Odd
● Even
Stop bits Number of stop bits for asynchronous data transfer.
● 1 (default setting)
● 2
Data bits Number of data bits for asynchronous data transfer.
● 5 bits
● ...
● 8 bits (default setting))
XON (hex) Only for punched tape format
XOFF (hex) Only for punched tape format
End of data transfer (hex) Only for punched tape format
Stop with end of data transfer character
The default setting for the end of data transfer character is (HEX) 1A.
Time monitoring (sec) Time monitoring
For data transfer problems or at the end of data transfer (without end of
data transfer character) data transfer is interrupted after the specified
number of seconds.
The time monitoring is controlled by a time generator (clock) that is star‐
ted with the first character and is reset with each transferred character.
The time monitoring can be set (seconds).

Data backup
15.9 Network settings
15.8 Backing up setup data
Setting for "Backup setup data"

The "Backup setup data" function should only be used if MD11280 $MN_WPD_INI_MODE is
set to 1 (default setting). Otherwise, when the NC is started for the first time after selecting the
part program, a file with the same name with the ".ini" extension would be automatically
executed.
Machine data:
MD11280 $MN_WPD_INI_MODE
Processing mode of ini files in the workpiece directory
= 1 When the NC is started for the first time, after the workpiece selection, ini files with the name
of the selected part program and the following extensions are executed:
CEC Sag compensation (Cross Error Compensation)
GUD User data (Global User Data)
PRO Protection zones
RPA R parameters
SEA Value assignments (Setting Data Active)
TMA Magazine data (Tool Magazine Active)
TOA Tool offsets (Tool Offset Active)
UFR Work offsets (User Frame)
Activate
By default, the network settings cannot be backed up. The archiving of the network settings
must be enabled:
1. Copy the "slpmconfig.ini" file from the /siemens/sinumerik/hmi/template/cfg directory.
2. Store the file in the /oem/sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg directory.
3. Open the file and enter the following for [SeriesSetup]:
SupportNetworkSettings=true
4. Restart SINUMERIK Operate.
Note
This setting also affects the creation of a complete standard archive using Ctrl+Alt+S or Ctrl
+Alt+C.

Data backup
Restrictions
● The leases files are not saved:
– /system/etc/udhcpd-eth0.leases
– /system/etc/udhcpd-ibn0.leases
● A configuration in the system network must be based on the DNS name rather than IP
addresses.
Basic procedure
● Backup of network settings
After activation, the network settings can also be backed up when a commissioning archive
is created when a check mark is set, see Creating a start-up archive (Page 300).
● Importing network settings
The saved archives can be imported in the same manner as a commissioning archive, see
Reading-in a start-up archive (Page 302).
Note
Importing network settings for replacement components
Disconnect the replacement components from the system network before you import the
saved network settings.
NCU
Only the NCU settings are saved with the HMI on the NCU. The following data is backed up:
● /user/system/etc/basesys.ini
● /user/common/tcu (complete directory)
The network settings of an NCU can be backed up and read only from an HMI on the PC/PG.
This means the NC address in mmc.ini on the PC/PG is always 192.168.215.1.
PCU
PCU and, if applicable, NCU settings saved with the HMI on the PCU. The following data is
backed up:
● PCU
– /user/system/etc/basesys.ini
– mmc.ini for SINUMERIK Operate
● NCU (when present as master)
– /user/system/etc/basesys.ini
– /user/common/tcu (complete directory)
The following archives are created: Archivename_pcu.arc and Archivename_ncu.arc

Data backup
Importing an archive for a configuration with NCU as master (DHCP) and PCU (on_low):
1. Import the archive for Archivename_pcu.arc on a PCU with SINUMERIK Operate.
2. Depending on the replaced parts of the NCU, note the following:
– If the NCU was not replaced, the system restarts.
– The NCU has been replaced, Archivename_ncu.arc must be imported via the X127
interface with a separate HMI.

Data backup

Configuring the network 16
16.1 Displaying the network overview
All the available interfaces and their network settings are listed in the Overview of the Network
Settings window. For example, the IP addresses, subnet masks and MAC addresses for the
company and system network are displayed here. You have the option of editing the settings.
Procedure
2. Press the "Menu forward" key.
3. Press the "Network" softkey.
The "Overview of the Network Settings" window opens.
4. Press the "Change" softkey to edit settings.
See also
Settings of the system network (Page 316)
Settings of the factory network (Page 319)
Saving network settings (Page 321)

Configuring the network
16.2 Settings of the system network

The configuration for the DHCP server, the routing, active protocols, for DNS servers and other
properties of the system network is performed in the Settings of the System Network window.
Setting Description
DHCP activated Activates or deactivates the DHCP mode for the
system network. This automatically assigns IP ad‐
dresses to the nodes in the system network.
DHCP server synchronization mode Activates or deactivates the DHCP server synchro‐
nization mode. If this setting is active, then the
DHCP servers synchronize themselves in the sys‐
tem network (X120) so that only one of them ac‐
tively assigns addresses. This makes it possible
to operate multiple NCUs or PCUs concurrently
without having to adjust the network settings.
The DHCP servers that are not active go into
"standby" mode; in this mode they regularly get the
current address data and TCU data from the active
server so that if the active server fails, a standby
server can take over the active role without data
loss.
● The Master priority setting influences the
synchronization so that the server with the
"Master" setting is always the active server (it
must be active in the network).
Deterministically the same control is then
always the DHCP server and the current
address and TCU data can be found there.
Master priority must only be set for a single
DHCP server in the system network.
● The settings Low priority and High priority can
be used to specify which DHCP server takes
precedence as the active server. A DHCP
server with low priority is then only used as
active server when a server with high priority
cannot be found in the network.
Default: High priority
DHCP address range Specifies the range for DHCP addresses. The
range starts at the address specified at Start and
ends at the address entered at End. The resulting
range of numbers has the following default setting:
Start address = first address in the system network
End address = start address + 10 or + 2 (if less
than 16 addresses are available)

Setting Description
Timeout when waiting for master Specifies a maximum waiting time (in seconds) for
the response of the master server (see DHCP
server synchronization mode). After this time elap‐
ses, the server itself becomes the active server.
This additional pause makes it possible for the in‐
tended DHCP master to become the active DHCP
server without displacement even if it is shortly
switched on thereafter, or takes longer to boot than
other controls.
Default: 120 seconds
Host name Assigns the DHCP server a fixed host name. In
this way, the server can also be addressed via the
host name and not only via the IP address.
Because the host name is also used as DNS
name, it must satisfy the corresponding require‐
ments of the RFC:
● ASCII letters (a-z, A-Z), digits (0-9) and '-'
● maximum 63 characters
DNS domain This is used to specify the Top Level Domain (TLD)
name used in the system network. The DNS server
of the NCU assigns names to the devices in the
system network in this zone. Name requests for all
other zones are forwarded to an external name
server in the company network.
The "local" default setting recommended by the
RFC1035 is used for local networks, to avoid con‐
flicts with globally defined domain names. As a
rule, this default setting is sufficient.
PN station name A separate machine name can be defined here for
PROFINET purposes. This is used at the ERTEC
interface (when available), transferred to the ER‐
TEC system program and also used by DCP at this
network interface.
Station name This string is used for the SINUMERIK-specific
OID mcSinumerikMIB.mcSinumerikMiscStation.
The value is the name of a station to which the
device belongs. Devices with the same station
name can therefore be identified as belonging to‐
gether. This is for information purposes only.
Location This string is used for the standard OID SNMPv2-
MIB::sysLocation. If required, a location can be
specified here which can be called by an SNMP
client. This is for information purposes only.
Contact person This string is used for the standard OID SNMPv2-
MIB::sysContact. If required, a contact address
can be specified here which can be called by an
SNMP client. This is for information purposes only.

Setting Description
Function This string is used for the Siemens Industry-spe‐
cific OID automationSystemIdent.automation‐
FunctionTag. If required, a function designation
can be specified here which can be called by an
SNMP client. This is for information purposes only.
Fixed domain Defines an additional DNS domain name (suffix for
DNS queries). This is of especial interest when the
DHCP server is switched off at the X120 because
this cannot set the "local" domain, but it is required
for some DNS queries (e.g. for machine control
panels).
Fixed DNS servers Specifies up to three DNS servers that are to be
used by the DHCP server. This is of especial in‐
terest when the DHCP server is switched off at the
X120 because this is also a DNS server or deter‐
mines DNS servers in the network.
Routing
● Routing X120/X127 -> X130 Specifies whether the routing of packets from the
system network (X120) and/or service connection
X127 to the company network (X130) is active:
● Enabled: Activates the routing for X120 and
X127
● Disabled: Deactivates the routing for X120 and
X127
● X127: Activates only the routing from X127 to
the company network
● X120: Activates only the routing from the
system network to the company network
● Routing X127 -> X120 Activates or deactivates the NAT routing of pack‐
ets from the service connection X127 to the sys‐
tem network (X120).
● Routing X120 -> X127 Activates or deactivates the routing of packets
from the system network (X120) to the service
connection X127. This is normally prohibited by
the firewall.
Note that there is no NAT and the sender must
ensure that packets to the PG or service PC at
X127 with address 192.168.215.x actually reach
the NCU to which the device is connected.
Active protocols Specifies which protocols are to be used in the
system network. DCP (Discovery and Basic Con‐
figuration Protocol) and LLDP (Link Layer Discov‐
ery Protocol) are available for selection. The ap‐
propriate active protocol is also used for the serv‐
ice connection X127 at the NCU.

16.3 Settings of the factory network
Procedure
1. The network overview is open.
2. Press the "System network" softkey.

The "Settings of the System Network" window opens.
4. Press the "Reset DHCP server" softkey to return the current settings of
the DHCP server to the original settings.
5. Press the "Distribute DHCP data" softkey to synchronize the settings with
all nodes in the system network.
Note
You can only use the "Reset DHCP server" and "Distribute DHCP data" softkeys with a
connection to the active DHCP server.

The configuration for the network interface, active protocols and firewall exceptions of the
company network are performed in the Settings of the Company Network window.
Setting Description
Gateway If this value is not empty, the host specified there
is used as the default gateway, which means that
all IP packets that cannot be directly assigned are
sent there for routing.
DNS server If DNS name servers are specified here (maximum
three), then they must be used to resolve symbolic
host names, i.e. at most of the points where an IP
address is expected, a computer name can also
be used instead.
The name server setting is also sent to its DHCP
clients (TCU, PG) via the DHCP server of the NCU,
so that they can also work with symbolic names.
Time server Here you can specify up to three NTP servers
(UDP/123) that can be used by the NTPD on the
NCU for time synchronization.

Setting Description
Host name Here you can define a name for the local host. This
manually assigned name takes priority over all oth‐
er names.
The host name is determined in the following order:
● This entry (identical to the host name from the
basesys.ini file)
● A name received from the DHCP server
(reverse DNS lookup, i.e. which name belongs
to the received IP address)
● Default name ("NONAME_...")
Because the host name is also used as DNS
name, it must satisfy the corresponding require‐
ments of the RFC:
● ASCII letters (a-z, A-Z), digits (0-9) and '-'
● maximum 63 characters
Active protocols Specifies which protocols are to be used in the
company network. DCP (Discovery and Basic Con‐
figuration Protocol) and LLDP (Link Layer Discov‐
ery Protocol) are available for selection.
Firewall exceptions You can specify ports here that are to be enabled
in the external network interface.
● S7 communication (TCP/102) Port for the S7 communication
● VNC access (TCP/5900) Port for the VNC access
● Additional ports Any further ports can be enabled here. The entry
starts with the protocol name (TCP or UDP), fol‐
lowed by a slash '/' and the port number of the
service to be enabled. Several entries are separa‐
ted by a space.
Example (enabling of the VNC servers): TCP/
5900 TCP/5904 TCP/5905
NOTICE
Security risk
Note that opening the ports in the firewall can represent a security risk. Only enable the ports
that you actually require.
Note that every accessible service can have security gaps.

16.4 Saving network settings
Procedure
1. The network overview is open.
2. Press the "Company network" softkey.

The "Settings of the Company Network" window opens.
16.4 Saving network settings

The settings made in the NCU can be saved as a file.
A target folder in which the network configuration is to be saved, or an existing file that is to
be overwritten with the new settings, can be selected in the Save Network Settings: Select
Archive window.
Procedure
1. The network overview is open and you have made network settings.
2. Press the "Save NCU settings" softkey.

The "Save Network Settings: Select Archive" window opens.
3. Select the folder in which the network configuration is be stored. If a file
is already available, it will be overwritten.
- OR -
Press the "New directory" softkey to create a new directory.
- OR -
Press the "Find" softkey, for example, to find the storage location of the
network configuration file.
4. Press the "Find next" softkey if the file found during the search does not
correspond to the required configuration file.
5. Press the "Cancel" softkey to reject the settings.
- OR -
Press the "OK" softkey to save the network configuration.

16.5 Configuring operator panels
16.5.1 Displaying the available operator panels

A list with all the available operator panels is displayed in the upper part of the Available
Operator Panels ... window. One line corresponds to one operator panel and contains the
following information:
Column Description
Consecutive number to identify the operator panel
Status Status of the operator panel:
: The operator panel is available on the bus.
: The operator panel is not available on the bus.
HW Information on the hardware of the operator panel
Possible values are unknown (no information available), NCU, PCU, PPU, TCU (all TCU
including HT 8, etc.).
Default value: Unknown
Name Name of the operator panel
MCP DIP switch position for the machine control panel
The values can be freely selected from 1 to 254 (0 means that the last active machine
control panel is retained, 255 means that a machine control panel is not being used).
Default value: 192
DCK Availability of direct control keys
Active: The TCU has direct control keys
Inactive: The TCU has no direct control keys
TCU Index for the TCU (Thin Client Unit)
The value is freely configurable from 0 to 255 and is used for identification in the PLC.
EKS DIP switch position for the chip reader for access levels (Electronic Key System)
Possible values range from 1 to 255. The value 0 means that an EKS is not used.
Virtual key‐ Use of a virtual keyboard
board Possible values are "Never", "Always" and "Auto", whereby "Auto" is set as default value.
Note
The information of the operator panels is read-only and cannot be changed in the OPs window.
Update of the overview

When switching to the OPs window, a search for available operator controls is performed
automatically. This is also possible later via the "New display" or "Reload OP data" softkeys.
The latter action results in a completely new scan during which already available operator
controls are deleted from the local cache. New operator controls and data are sought during
a reload.

The active DHCP server that contains the data for the operator panels can be a different NCU,
but also the local NCU itself. Irrespective of this, a copy of the data is stored and used on the
local NCU.
Procedure
2. Press the "OPs" softkey.
The "OPs" window is opened.

All the presently available operating elements are displayed.
3. Press the "New display" softkey to refresh the overview.
A search is performed for new operator controls and data.
4. Press the "Reload OP data" softkey to start a completely new search.
Already available operator controls are deleted from the buffer during this
search.
5. Press the "Distribute TCU data" softkey to synchronize the available con‐
trols with all participants in the system network.
Note
You can only use the "Distribute TCU data" softkey with a connection to the active DHCP
server.
16.5.2 Configuring VNC connections

A list of the available VNC connections is displayed in the lower part of the "Available Operator
Panels ..." window. It contains the following information:
Column Description
Consecutive number to identify the VNC connection
VNC server IP address or name of the NC
Displacement Specifies whether it is possible that the TCU will be displaced by other nodes.
/Priority Displacement priority: Specifies the priority which influences whether the TCU will be
displaced by other nodes.
The possible values lie between 0 and 10. The smaller the value, the faster the TCU
will be displaced. If the displacement is blocked, the priority will be ignored.
Start Specifies whether the TCU is to be started active, i.e. as operator panel.
/Priority Start-up priority: Specifies the priority of the TCU connection to be used.
Any value greater than 0 is permitted. The larger the value, the lower the connection
priority.

Column Description
Display area Specifies which HMI screen is displayed when activating the TCU.
Channel Specifies which channel is displayed when activating the TCU.
Editing the list of VNC connections
1. The "Available Operator Panels ..." window is open.
2. Press the "Change" softkey.

The information on the VNC connections can be edited.
- OR -
3. Press the "Add" softkey to establish a new VNC connection.
- OR -
4. Press the "Remove" softkey to remove a selected VNC connection from
the list.
- OR -
5. Press the "Move up" or "Move down" softkey to move a VNC connection
within the list.
6. Make the required change and press the "OK" softkey.
- OR -
Press the "Cancel" softkey to cancel the changes.
See also
Displaying the available operator panels (Page 322)
16.5.3 T:M:N configuration

By T:M:N configuration we mean a grouping of t operating stations (TCUs with MCP), m HMI
systems and n NCK systems, in which the operating stations can be freely switched to the
various HMI systems in order to operate. In a two-stage process, the switchover targets for
each operating station are individually configured in a channel menu.
From the point of view of the HMI, T:M:N operation is active if a channel menu is configured.
Available switchover targets are defined directly via the address of the HMI and optionally via
an NC channel, which must be assumed on switchover from the HMI. These switchover targets
can be combined into so-called channel groups. Channel groups are displayed on horizontal

16.6 Station-related network diagnostics
softkeys in the channel menu, the switchover targets themselves (HMI, NC channel) are
displayed on the vertical softkeys assigned to a channel group.
Linking of softkeys to channel groups

A list for the linking of the HMI softkeys to configured channel groups is displayed in the lower
part of the window. The channel groups can in turn contain switchover targets that execute
functions of the operator panel, for example. Up to 32 softkeys (SK_1 to SK_32) can be linked
to a specific channel group (e.g. CH_GRP_0).
Procedure
1. The "Available Operator Panels ..." window is open.
2. Select the required operator panel and press the "T:M:N" softkey
A list for the linking of the HMI softkeys to configured channel groups is
displayed in the lower part of the window.
The list can be edited.
4. Make the required change and press the "OK" softkey.
- OR -
See also
Displaying the available operator panels (Page 322)

Using the station-related network diagnostics, you have the possibility of identifying faulty or
incorrectly parameterized components or those components that have not been connected.
You obtain an overview of all of the components belonging to the system network:
● NCU
● PCU
● TCU
● MCP
● EKS
If components are either faulty or absent (or unavailable), they will be marked as such in this
overview.

Error analysis
You have the option of initiating a fault analysis for the components involved. You obtain the
result of a such a diagnostics in the form of a fault message. The possible fault states and
causes are described in this fault message together with how to resolve the fault.
16.6.1 Displaying network adapters

The actual network adapters (system network X120, company network X130 or system
network ETH2 and company network ETH1) and their availability are displayed in a tree-like
structure in the "TCP/IP diagnostics" window.
Displaying the components

The following components are displayed in the window:
● The control is displayed at the topmost level.
● System network (X120 / ETH2) with configured operator stations with IP address
– Operator panels with IP address
– Machine control panels
– EKS
● Company network (X130 / ETH1) with
– Operator panels with IP address
– Machine control panels
– EKS
Components that cannot be accessed
If a component cannot be accessed, then it is marked using this symbol.

Input rights
Operator panels, which have input rights, have a green background.
Detailed view
You have the option to display the following information about a selected component.
TCU
● IP address
● SW version
● MCP index from the configuration
● TCU index from the configuration
● DNS name
● Resolution

MCP
● IP address
● DNS name
● MCP index from the configuration
● MCP index requested from HMI
● MCP index requested from PLC
Procedure
2. Press the menu forward key and the "Bus TCP/IP" softkey.
3. Press the "TCP/IP diagnostics" softkey.

The "TCP/IP Diagnostics" window opens and displays the current avail‐
ability of the network connections.
4. Position the cursor on the component for which you wish to display the
detailed information.
5. Press the "Details" softkey to display all available parameters of the con‐
figured network connections.
6. Press the "Details" softkey to hide the detailed display.
7. Press the "Return" softkey in order to exit the "TCP/IP diagnostics" win‐
dow and return to the "PROFIBUS diagnostics" window.
16.6.2 Error analysis
16.6.2.1 Performing error diagnostics
Precondition
Error analysis only functions for a PCU.

Procedure
1. The "TCP/IP Diagnostics" window opens.

2. Position the cursor on the component that is marked as having an
error (NCU).
3. Press the "Error analysis" softkey.

The corresponding error message is displayed.
16.6.2.2 MCP/EKS as network participant cannot be accessed
Error Possible error causes and remedies

The MCP/EKS cannot be accessed as network participant.
Error cause 1
There is no physical network connection.
Notice: The display only refers to the circumstance that the direct connection from MCP/EKS
to the next connection nodes has not been established, i.e.
● The Ethernet cable is not directly inserted at the MCP/EKS,
● The Ethernet cable is not inserted at the direct connection partner or the partner is not
available (e.g. MCP),
● The Ethernet cable connected to the MCP/EKS is defective.
Remedy
Establish the physical network connection (check the plug-in connections, replace the cable,
check the connection partner).
Error cause 2
The physical network connection does not exist after the next connection node to the system
network. There is no physical connection from the MCP/ECS to the computer with the active
DHCP server. The cables are either defective, have not been inserted or switches have not
been closed. Switches can also be located on the MCP or distribution box.
Remedy
Once the connection has been established, the TCU continues to boot.
The MCP/EKS cannot be accessed as network participant. There is a physical network connection to the system network.
Cause of the error
No active DHCP server is found in the system network. Possible causes:
● Only a single computer has been configured in the system network with active DHCP server
- and this computer is not available. The system network is not operated with synchronizing
DHCP servers.
● No computer has been configured in the system network with active DHCP server. DHCP
operation is disabled on all potential computers (NCU, PCU). This is a configuration error.
● In the system network, there is no NCU or PCU computer available that has DHCP operation
activated on it and could be a server.
Remedy
In the system network, configure a computer that is available as DHCP server.

16.6.2.3 HMI on the PCU cannot establish a network connection to the NC
Error Error cause 1 Remedy

HMI displays alarm 120202 The IP address of the target NCK/PLC From the HMI, correct the target address for
"Wait for connection to NC/ set on the PCU is incorrect. NCK/PLC and restart the PCU.
PLC" and/or no values (only
'#').
Error Error cause 2.1 Remedy

HMI displays alarm 120202 The PCU has an IP address that does not Correctly set the network settings for the sys‐
"Wait for connection to NC/ belong to the network or has an invalid IP ad‐ tem network in the Windows service mode
PLC" and/or no values (only dress. (set the fixed specified IP address and subnet
'#'). The TCU support is deactivated on the PCU mask for the system network, use the address‐
(= DHCP is disabled) and the PCU either op‐ ing mode, fixed IP address).
erates with a permanently set IP address that Execute the following actions using the "Sys‐
does not belong to the network, or with the tem Network Center" program:
standard Windows DHCP client to dynami‐ ● Connect the DHCP service to the interface
cally retrieve addresses. This is a configura‐ for the system network
tion error.
● Set the DHCP mode (TCU support, DHCP
SyncMode, address range of the
addresses that can be assigned)
● Initiate DHCP clear

'#'). The TCU support is activated on the PCU (= mask for the system network, use the address‐
DHCP is enabled) and the PCU is active ing mode, fixed IP address).
DHCP-/DNS server (either as a result of the Execute the following actions using the "Sys‐
DHCP SyncMode ON_MASTER or as a re‐ tem Network Center" program:
sult of the Sync priority - just the same as the ● Connect the DHCP service to the interface
other server candidates and random selec‐ for the system network
tion) - or the PCU is a DHCP client. As a result
of a software error or the actual network con‐ ● Set the DHCP mode (TCU support, DHCP
figuration, the PCU cannot obtain a valid IP SyncMode, address range of the
address (e.g. '0 address'). addresses that can be assigned)
In addition, at the station with DHCP master
(DHCP SyncMode = ON_MASTER) a DHCP
clear should be initiated.


'#'). The TCU support is activated on the PCU (= mask for the system network, use the address‐
DHCP is enabled) and the PCU is active ing mode, fixed IP address).
DHCP-/DNS server (either as a result of the Execute the following actions using the "Sys‐
DHCP SyncMode ON_MASTER or as a re‐ tem Network Center" program:
sult of the Sync priority - just the same as the ● Connect the DHCP service to the interface
other server candidates and random selec‐ for the system network
tion). The PCU is set with an incorrect IP ad‐
dress and an incorrect IP range for the IP ad‐ ● Set the DHCP mode (TCU support, DHCP
dresses that can be dynamically allocated. SyncMode, address range of the
The PCU possibly changed from DHCP addresses that can be assigned)
standby to active server as the computer with ● Initiate DHCP clear
DHCP MASTER has failed or been switched-
off.

'#'). TCU boot support is activated on the PCU (= mask for the system network, use the address‐
DHCP is enabled) and the PCU is the stand‐ ing mode, fixed IP address).
by DHCP/DNS server (i.e. in the role of the Execute the following actions using the "Sys‐
DHCP client). An additional active DHCP tem Network Center" program:
server was switched into the system network ● Connect the DHCP service to the interface
while operational; this active DNCP server al‐ for the system network
so has an incorrect address range. This is a
configuration error. ● Set the DHCP mode (TCU support, DHCP
SyncMode, address range of the
addresses that can be assigned)

Switch the complete system off and on again.

HMI displays alarm 120202 "Wait for connection to NC/PLC" and/or no values (only '#').
Error cause 3.1
The NCU has an IP address that does not match the network or has an invalid IP address.
The NCU does not participate in DHCP operation and runs with a permanently set IP address
that is incorrect and does not match the system network.
Remedy 3.1


Connect the service PG to the NCU via X127. Log into Linux via WinSCP or Putty. Using the
service command 'sc show ip -eth0', display the actual settings - and check these. If the cause
of the error is confirmed, then the NCU must be reparameterized.
Perform the service commands and settings:
● sc enable DHCPSvr –X120 or the equivalent sc enable DHCPSvr –eth0 to activate DHCP
operation
● sc enable DHCPSync –X120 -LOW|HIGH|MASTER or equivalent sc enable DHCPSync
–eth0 -LOW|HIGH|MASTER to set the DHCP synchronization mode of this NCU
Enter the following entries correctly in the /user/system/etc/basesys.ini file
:[InternalInterface]
; With InternalIP and InternalNetMask (both must be set together),
; you can change the address on the internal/TCU/automation/system net.
InternalIP=192.168.214.1
InternalNetMask=255.255.255.0
…
; This is the range of dynamic IPs given out by the DHCP server
; Defaults should be sensible
InternalDynRangeStart=192.168.214.10
InternalDynRangeEnd=192.168.214.239
The values in green should be set corresponding to the overall system.
Then restart the NCU.
Error cause 3.2
The NCU participates in DHCP operation and the NCU is an active DHCP/DNS server (either
as a result of the DHCP SyncMode ON_MASTER or as a result of the Sync priority - just the
same as the other server candidates and random selection). The NCU is set with an incorrect
IP address and an incorrect IP range for the IP addresses that can be dynamically allocated.
The NCU possibly changed from DHCP standby to active server as the computer with DHCP
MASTER has failed/has been switched-off.
Remedy 3.2
The same as for remedy 3.1
Error cause 3.3
The NCU participates in DHCP operation and operates with the incorrect IP address. After
the NCU booted, an additional component that is already operational (NCU or PCU) with
active DHCP server was connected to the network. An additional active DHCP server was
switched into the system network while operational; this active DNCP server has an incorrect
address range. This is a configuration error.
Remedy 3.3
Error cause 4.1
The NCU has a valid IP address in the system network, however, not the required IP address.
The NCU does not participate in DHCP operation and operates with a permanently set target
address that is different from that saved in MMC.INI in the system network - however, this is
a valid address. This is a configuration error.
Remedy 4.1


Connect the service PG to the NCU via X127. Log into Linux via WinSCP or Putty.
If the set NCU mode (no DHCP) is to be kept, the fixed IP address of the NCU must be
changed.
Correctly enter the following entries into the file /user/system/etc/basesys.ini
[InternalInterface]
; you can change the address on the internal/TCU/automation/system net.
InternalIP=192.168.214.1
InternalNetMask=255.255.255.0
Then restart the NCU.
Error cause 4.2
The NCU does not participate in DHCP operation and operates with a permanently set target
address that is different from that saved in MMC.INI in the system network - however, this is
a valid address. This is a configuration error.
Remedy 4.2
Error cause 4.3
The NCU participates in DHCP operation and was not able to obtain the corresponding re‐
quired IP with the target address saved in the MMC.INI; this is the reason that it was dynam‐
ically allocated an address. A reason for this could be that the required IP was configured
twice in the system network, or the required IP is not in the reserved range, but is located in
the dynamic address range. This is a configuration error.
Remedy 4.3
Error cause 4.4
The NCU participates in DHCP operation as DHCP client and has a required IP that has been
set but which does not match the system network. For instance, this situation occurs if a
network address was used in the system network other than the default network address, but
it was forgotten to change over the required IP of the NCU to this address range. The NCU
is allocated an IP address that matches the system network from the dynamically allocated
range, but which is different from its 'old' required IP that was not changed over. Up to and
including SW 2.4.1, in this situation, the NCU cannot be addressed in the system network.
The reason for this is that it has internally established its firewall regarding the required IP
that was entered for it, which does not match the system network - which is why it does not
respond at X120.
Remedy 4.4
Error cause 5.1


There is no physical connection.
Possible error causes include:
● A switch is not closed/has failed; this can also be the switch of an MCP
● The cable connection has become loose (poor contact)
● An incorrect cable was used (crossover/not crossover)
● A cable being used as data link is defective
Remedy 5.1
Establish a physical connection.
16.6.2.4 TCU cannot establish a network connection to the HMI

When booting, TCU signals 'ERROR: Network connection not established'.
Cause of the error
There is no physical connection.
Notice: The display only refers to the situation where the direct connection of the TCU to the
next connection nodes has not been established, i.e.
● The Ethernet cable is not directly inserted at the TCU,
● The Ethernet cable is not inserted at the direct connection partner or the partner is not
available (e.g. MCP),
● The Ethernet cable at the TCU is defective.
Remedy
When the TCU boots, it signals 'connection established – no DHCPServer available'.
Cause of the error
The physical network connection does not exist after the next connection node to the system
network. There is no physical connection from the TCU to the computer with the active DHCP
server. The cables are either defective, have not been inserted or switches have not been
closed. Switches can also be located on the MCP or distribution box.
Remedy
When the TCU boots, it signals 'connection established – no DHCPServer available'. There is a physical network connection
to the system network.
Cause of the error


No active DHCP server is found in the system network.
Possible error causes include:
● Only a single computer has been configured in the system network with active DHCP server
- and this computer is not available. The system network is not operated with synchronizing
DHCP servers.
● No computer has been configured in the system network with active DHCP server. DHCP
operation is disabled on all potential computers (NCU, PCU). This is a configuration error.
● In the system network, there is no NCU or PCU computer available that has DHCP operation
activated on it and could be a server.
Remedy
In the system network, configure a computer that is available as DHCP server.
After it has booted, the TCU displays 'Waiting for HMI'. (The TCU cannot establish its connection to the HMI.)
Error cause 1
The connection to the HMI has not been established - neither the connection configured in
config.ini nor the default connection. An incorrect address for the HMI connection after booting
has been set in the config.ini file.
Remedy
Correct the configuration using the "System Network Center" program. The TCU automatically
reboots.
Error cause 2
config.ini nor the default connection. The computer, to which the TCU should connect after
booting according to the configuration in config.ini, cannot be reached because the computer
is not switched on/is not available.
Remedy
Switch off the computer (NCU or PCU) and switch on again.
Error cause 3
config.ini nor the default connection. The HMI on the computer, to which the TCU should connect
after booting according to the configuration in config.ini, cannot be reached because the HMI is
deactivated.
Remedy
Activate the HMI on the NCU using the service command sc enable HMI.
Error cause 4
config.ini nor the default connection. The HMI on the computer, to which the TCU should connect
after booting according to the configuration in config.ini, cannot be reached because the HMI
has either not start or has crashed due to a software error.
Remedy
Switch off the computer (NCU or PCU) and switch on again.

16.6.2.5 The TCU cannot establish a network connection to the assigned PCU

The PCU does not have the IP address specified in the configuration, but an address from the IP range of the system network
that can be dynamically allocated. In this error case, the TCU cannot reach its configured PCU for display.
Error cause 1
IP address assigned twice
The PCU has a default IP address which is also configured for another NCU/PCU. This means
that an IP address has been assigned twice and therefore there is a system configuration error.
The PCU is not an active DHCP server (otherwise, it would have the required IP), however, it
is operated in the synchronizing DHCP mode. As the address requested from the PCU has
already been assigned, the PCU is allocated an address from the dynamic address range via
DHCP.
Remedy
A decision has to be made which computer should keep the IP address that has been assigned
twice. If it is the PCU, then
● on the PCU, under network settings, this address should be again set as fixed IP address
in the system network,
● at the NCU/PCU which runs in the DHCP synchronization mode ON_MASTER, a 'Clear
DHCP' should be executed (for an NCU sc command sc clear dhcp –X120, for a PCU using
the "System Network Center" program).
● at the computer, which uses the IP address assigned twice as second computer, the IP
address should be re-configured. Notice: If this is a PCU, then it should be linked to this new
address using the "System Network Center" program (this is the first screen in the
program).
If the PCU is to change its address, then on the PCU
● under network settings, the new address should be set as fixed IP address in the system
network,
● linked to this new address using the "System Network Center" program (first screen in the
program)
● at the NCU/PCU, which runs in the DHCP synchronization mode ON_MASTER, a 'Clear
DHCP' should be executed (for an NCU using the sc command, for a PCU, using the "System
Network Center" program).
Restart the system.
Error cause 2
This was preceded by replacing the PCU hardware.
As a result of the hardware replacement, in spite of the same settings of the new PCU, the
requested (set) IP address is still internally reserved for the previous hardware as this is an
inherent feature of the system. The PCU is either active or non-active DHCP server, however,
is operated in the synchronizing DHCP mode. As the address requested from the PCU is still
reserved, the PCU is allocated an address from the dynamic address range via DHCP.
Remedy


Perform the following steps:
● Under network settings, on the PCU, set the required address again as fixed IP address in
the system network.
● At the NCU/PCU, which runs in the DHCP synchronization mode ON_MASTER or is active
DHCP server, execute a 'Clear DHCP' (for an NCU using the sc command sc clear dhcp –
X120, for a PCU, using the "System Network Center" program).
● Restart the system.
Error cause 3
An address that does not belong to the network has been configured for the PCU.
An address has been configured for the PCU, which does not match the network address in the
system network, and is therefore dynamically assigned an IP address from the active server via
DHCP. The PCU is not an active DHCP server, but is operated in the synchronizing DHCP mode.
Remedy
Perform the following steps:
● Under network settings, on the PCU, set the required address again as fixed IP address in
the system network.
● On the PCU, using the "System Network Center" program, link the DHCP service to this new
address (first screen in the "System Network Center" program), if required, adapt the other
DHCP settings (dynamic address range).
● At the NCU/PCU, which runs in the DHCP synchronization mode ON_MASTER or is active
DHCP server, execute a 'Clear DHCP' (for an NCU using the sc command sc clear dhcp –
X120, for a PCU, using the "System Network Center" program).
● Restart the system.
16.6.3 Configuring TCP/IP diagnostics

The configuration of the network adapter is displayed in the "TCP/IP Configuration" window.
System network
On the system network, process data communication and image transmission of the
components are executed with the operating software for the display units (TCUs).
A TCU and NCU are connected to the system network via Ethernet interface X120.
A PCU is connected via the ETH2 Ethernet adapter.
Company network
The company network is used, for example, to access the network drives.
An NCU is connected to the company network via Ethernet interface X130.
A PCU is connected via the ETH1 Ethernet adapter.

Availability of the network connections
Network adapter connection

White Network cable inserted
Red Network cable not inserted
Availability
The availability describes the percentage of faulty packages compared to all the sent and
received packages.
Problems in the company network (e.g. logical drives that cannot be accessed, double IP
address, etc.) as well as settling time during power up can result in fluctuations in availability.
Green Greater than 95%
Yellow 50 - 95%
Red Less than 50%
Details of the network connections
● Computer name
● DNS name
Computer name of the controller as stored at the DNS server (Domain Name Service).
● MAC address
Physical address of the network adapter

● Address type
Information about the configuration of the network adapter in the configuration file
"basesys.ini":
– DHCP: DHCP is active for this network adapter.
The information behind the hyphen "-" specifies the DHCP mode of operation:
off - DHCP is deactivated for this adapter
Client - a DHCP client that receives an IP address and further data from a server, is
running on the interface
Server - the NCU provides a DHCP server on this interface that supplies clients on this
network with IPs
Synced Server - a protocol is active with which several NCUs synchronize with each
other. This ensures that always only one of these NCUs functions as DHCP server and,
for example, no double IP addresses
are assigned.
If a network adapter operates as "Synced Server", the "State of sync. DHCP server" line
displays additional information.
If no changes have been made for the network adapters in the configuration file, then
"Default" is also output.
– Manual
The settings IP address, subnet mask, DNS server 1, DNS server 2 and gateway are
configured in the "basesys.ini".
Note:
In the "Change" mode, either "Manual" or "DHCP" can be selected (only for company
network, X130).
● IP address assigned
Current IP address of the network adapter.
● Subnet mask assigned
● DHCP server
IP address of the network adapter (for address type "DHCP").
● State, DHCP server
State of the synch. DHCP server:
– Active (actual NCU is active in the group of all NCUs in the "Synced Server" mode and
transfers the IP addresses);
– Standby (NCU is not active, if the active server fails, this NCU could take over the task
of the server).
● Mode, DHCP synchron.
Priority of the synch. DHCP server:
Low, High, Master
● DNS server 1, DNS server 2
Domain Name Server
● Gateway
● Note
All information that is not available is marked in the relevant table line with a hyphen "-".

Modifiable parameters
The following parameters of the company network adapter (X130) can be set by selecting the
"Address type":
● Address type
● IP address
● Subnet mask
● DNS server 1 and 2
● Gateway (applies for system and company network)
Address types
● DHCP
The values for the settable parameters IP address, subnet mask, DNS server 1, DNS server
2 and gateway are defined automatically by the DHCP server, in accordance with the entry
in the "basesys.ini".
● Manual
The values for the settable parameters IP address, subnet mask, DNS server 1, DNS server
2 and gateway can be specified manually; these are then stored in the "basesys.ini".
References
For additional information about network configuration, please refer to the following
documentation:
SINUMERIK 840D sl, Operator Components and Networking (IM5)
Procedure
3. Press the "TCP/IP diagnostics" and TCP/IP Config." softkeys.

The "TCP/IP Configuration" window opens.
4. Press the "Modify" softkey to change specific parameters.

The fields that can be edited have a white background.

5. Enter the desired changes and press the "OK" softkey to confirm the
entries.
6. Press the "New display" softkey to refresh the display.
16.6.4 Ethernet network diagnostics
16.6.4.1 Diagnostics of the network and DHCP server

In order to more effectively influence the commissioning, press the "Network diagnostics"
softkey to easily represent the data and availability of each network node on the Ethernet. The
results display of this scan process delivers, among other things, the following information:
● Component identification of the hardware
● TCP/IP address / MAC address
● DHCP server detection
● Status of the nodes
This gives you the option to test whether the current topology matches the reference topology.
Procedure
3. Press the "TCP/IP diagnostics" softkey.

The "TCP/IP Diagnostics" window opens and displays the current avail‐
ability of the network connections.
4. Press the "Network diagnostics" softkey to browse your networks.
The "Network Status" window opens and displays the addresses of the
HMI (X120) system network, the PN (X150) system network and the
(X130) company network.
The corresponding fields in the window remain empty for non-accessible
networks.
5. Press the "New display" softkey to refresh the display.
- OR -

Press the "DHCP server" softkey to fetch information and query the status
of the DHCP server.
The "DHCP Server" window opens.
For each active DHCP server, the status, the role (priority), the MAC
address, the TCU version and the lease version are displayed in tabular
form in the upper part of the window. The required IP with the associated
address area appears in the lower part of the window.
Any differing data is displayed in red.
6. Press the "Address list" softkey to acquire all information about the active
DHCP server.
The "Address list" window is opened.
The IP address, the client ID in the form of the MAC address or the CF
card number, the lease version, the device number, the DNS name and
additional information are displayed for each node in a tabular form.
Inactive nodes are grayed out.
16.6.4.2 Messages
All the system-relevant state and error messages from the "syslog" log file are displayed via
the "Messages" softkey.
Procedure
1. The "Network Status" window opens.
2. Press the "Messages" softkey.

The "Messages" window opens.
3. Press the "Show all", "DHCP", "MCP" or "TCU" softkey to filter the display.
16.6.4.3 Network trace
If network problems occur, you can record the data traffic as a log file for analysis and
evaluation via the "Network Trace" window.

General information
● The function is protected with the standard password NETWORK
Note
Change the standard password to prevent improper use.
● The log is recorded via the tcpdump program (Linux) or the windump program (Windows).
Further information can be found at www.tcpdump.org
Requirement
If you want to change the password, you require access level 1 (manufacturer).
Procedure
1. The "Network Status" window is open.
2. Press the "Network trace" softkey.

The "Set Password" window opens.
3. Enter the password and press the "OK" softkey to confirm the entry.
The "Network Trace" window opens.
4. If you have stored parameters in a file, press the "From file" softkey in
order, for example, to read-in the file from a USB.
The "Select File" window opens.
5. Select the file from a directory and confirm with "OK".
- OR -
4. If required, parameterize the recording conditions in the "Parameters
(tcpdump)" input field.
5. Press the "Start" softkey to record the log.
Note: Recording stops automatically after 20 minutes.
6. Press the "Stop" softkey to complete the recording.
The "Export Trace File" window opens.
7. Select a storage location, assign a file name and confirm with "OK".
The trace file is moved to the storage location. With "Cancel", the log
remains in the following directory:
HMI data/Logs/Network trace/tcpdump.pcap or windump.pcap
8. If the log already exists, press the "Export trace file" softkey to save the
current log file, for example, on a USB.
The "Select Storage Location" window opens.
9. Select a storage location, assign a file name and confirm with "OK".

Change password
1. The "Network Trace" window is open.

2. Press the "Change password" softkey.
The "Change Password" window opens.
Enter a new password and confirm with "OK".
Trace parameters
You can parameterize the conditions for the log recording via the "Parameters (tcpdump)" input
field in the Network Trace window.
Syntax
<switch> <option>
<switch> parameters
Value Meaning
-D Displays a list of all network interfaces. All other <Switch> parameters
are ignored.
-i <interface> Defines which network interface has to be checked.
-n Host names are not resolved.
-c <number> The recording is stopped after a defined number of packets.
-C <file size> Limits the file size. When the file size is reached, a new file with name
and consecutive number, starting with 1, is created. The unit of the file
size corresponds to million bytes.
-e Outputs the Ethernet header.
-q Creates an abbreviated log version.
-vv Creates more detailed packet information.
-S Changes the packet sequence number from absolute to relative.
-A Outputs the contents of a packet as ASCII.
-xx Outputs the contents of a packet as Hex.
-XX Outputs the contents of a packet as Hex and as ASCII.
-s <bytes> Specifies the packet size in bytes that has to be recorded per packet.
The default is 68 bytes.
Note
The value -w is always implicitly contained in the call for the creation of the standard log file:
HMI data/Logs/Network trace/tcpdump.pcap or windump.pcap

Parameter <option>
Option Value Meaning

host IP address or host Only those packets are recorded that have the specified IP
name address or host name as source or as destination.
net Network range Only those packets are recorded that have an IP address or
host name from the specified network range as source or as
destination.
port A number from 0 to Records packets that have the specified port, e.g. 5900, on
65535 the source or on the destination side.
portrange A range between 0 Records packets that have a port in the specified range on the
and 65535 source or on the destination side.
src host, net, port or por‐ Only those packets are recorded that have the specified value
trange as source.
dst host, net, port or por‐ Only those packets are recorded that have the specified value
trange as destination.
proto ether, fddi, tr, wlan, Network protocol in which packets can be recorded.
ip, ip6, arp, rarp, dec‐
net, tcp and udp
You can link several options using the following expressions:

and, or, not
You can limit extended expressions using the following characters:
( ) and '
Reference
Further parameter assignments can be found at www.tcpdump.org
Examples
-n port 22 ; Records whether packets

arrive at port 22 of the local
system.
-i eth0 port 4080 ; Records all data for port
4080 arriving at the eth0
interface.
-i 2 ; Records all data arriving at
the interface with adapter
number 2.
-n host 10.113.20.0 ; Records the network traffic
from system 10.113.20.0,
whereby the IP address is not
changed to the host name.

192.168.214.4 and not net 10.113.20.0 ; Records the entire network

traffic of system
192.168.214.4 which does not
run via system 10.113.20.0.
-i 10.113.20.0 -q '(tcp port 80) or ; Records HTTP and also HTTPS
(tcp port 443)' packets of the network
interface from system
10.113.20.0.
16.6.4.4 Accessible nodes

By actuating the "Accessible nodes" softkey in the network, the list of accessible nodes on
X120 and, if necessary, on X150, is created and displayed. The list content can be compared
as current topology with a reference topology.
Note
Although handheld terminals and EKS identification systems are not determined for the list of
accessible nodes, they can be added as additional nodes to the topology.
Procedure
1. The "Network Status" window opens.
2. Press the "Accessible nodes" softkey.

The "Accessible Nodes" window opens.
The IP address, HW-Id/type, status and location are displayed in tabular
form for each node.
3. Press the "Sort" softkey.
4. Press the "By name", "By IP", "By type" or "By location" softkeys to sort
the display.
- OR -

3. Press the "Topology" softkey if you require an overview of all of the net‐
worked nodes, e.g. to check if there are connection problems.
The "Network Topology" window opens.
The interface, port and the actual connection are displayed for each node
using a tree topology.
Note: The station name must be defined for all nodes so that the topology
is correctly displayed.
4. Press the "Expand all" or "Close all" softkey to maximize or minimize the
tree topology.
5. Press the "Follow connection" softkey to follow nodes in the structure tree
using the marked line.
- OR -
3. If further information is provided for a selected node, press the "Details"
softkey to open the Web user interface.
Note: The installed operating software must be located in the same net‐
work as the device to be displayed. If necessary, this is achieved by the
assignment of a second IP address (alias).
The "Details" window opens.
4. Press the "Zoom +" or "Zoom -" softkey until the desired display size is
reached.
Additional nodes
3. Press the "Additional nodes" softkey to search for nodes that are not listed
under "Accessible nodes".
The "Search for Additional Nodes" window opens. If necessary, change
the address range and confirm with "OK".
The found nodes are appended in the table; the HW-Id/type, Location,
Contact and Description fields can then be edited and, by activating the
checkbox, added to the first column, and, with a subsequent save, added
to the reference topology.
Comparing
3. Press the "Compare" softkey to compare the current list of nodes either
with the previously saved manufacturer topology, a reference topology
or a saved topology in the .xml format.
The "Compare with" window opens. Position the cursor on the desired
option box and confirm with "OK".

Deviations during the comparison are identified by being color-highlighted:

● Red: missing or non-accessible components compared with the reference topology.
● Pink: components that deviate in their attribute values compared with the reference
topology.
● Blue: new components not contained in the reference topology.
Saving
3. Press the "Save" softkey to save the current topology.

The "Save as" window opens.
4. Position the cursor on the desired option box, specify a file name and
possibly a comment, and confirm with "OK".
Note
Manufacturer topology and reference topology can be created with access level 3 (user) or
higher and are always saved on the active DHCP server.
Default storage locations:

● Current topology (.xml or .csv):
The following storage locations are offered depending on the configuration:
– Network topology (storage location: HMI-data / data backups)
– Local drive
– Network drives
– USB
In CSV format, ";" is preset as a separator; it can be changed in sldgconfig.xml
● Reference topology:
/user(_base)/common/tcu/$soll
● Manufacturer topology:
/oem(_base)/common/tcu/$soll


17.1 NC/PLC variables
17.1.1 Displaying and editing PLC and NC variables

Changes can only be made to the NC/PLC variables with the appropriate password.
WARNING
Incorrect parameterization
Changes in the states of NC/PLC variables have a considerable influence on the machine.
Incorrect configuration of the parameters can endanger life and cause damage to the machine.
In the "NC/PLC Variables" window, enter the NC system variables and PLC variables that you
want to monitor or change in the list:
● Variable
Address for NC/PLC variable.
Incorrect variables have a red background and are displayed with a # character in the value
column.
● Comment
Any comment on the variable.
The columns can be displayed and hidden.
● Format
Specify the format in which the variable is to be displayed.
The format can be specified (e.g. floating point).
● Value
Displays the actual value of the NC/PLC variables.
PLC variables
Inputs Input bit (Ex), input byte (EBx), input word (EWx), input double word (EDx)
Outputs Output bit (Ax), output byte (ABx), output word (AWx), output double word
(ADx)
Bit memory Memory bit (Mx), memory byte (MBx), memory word (MWx), memory double
word (MDx)
Times Time (Tx)
Counters Counter (Cx)
Data Data block (DBx): Data bit (DBXx), data byte (DBBx), data word (DBWx),
data double word (DBDx)

Service and diagnostics
Formats
B Binary
H Hexadecimal
D Decimal without sign
+/-D Decimal with sign
F Floating point (for double words)
A ASCII character
Notation examples
Permissible notation for variables:
● PLC variables: EB2, A1.2, DB2.DBW2
● NC variables:
– NC system variables: Notation $AA_IM[1]
– User variables / GUD: Notation GUD/MyVariable[1,3]
– OPI notation: /CHANNEL/PARAMETER/R[u1,2]
Inserting variables
The start value for "Filter/Search" of variables differs. For example, to insert the variable $R[0],
enter the following start value:
● The start value is 0 if you filter according to "System variables".
● The start value is 1 if you filter according to "All (no filter)". In this case, all signals are
displayed and shown in the OPI notation.
The GUD from the machine data is only displayed in the Search window for the variable
selection when the associated definition file has been activated. Otherwise, the sought
variables must be entered manually, e.g. GUD/SYG_RM[1]
The following machine data is representative for all variable types (INT, BOOL, AXIS, CHAR,
STRING): MD18660 $MN_MM_NUM_SYNACT_GUD_REAL
Note
Display of NC/PLC variables
● System variables can be dependent on the channel. When the channel is switched over,
the values from the selected channel are displayed.
● For user variables (GUD), it is not necessary to make a specification according to global
or channel-specific GUD. The first element of a GUD array starts with index 0 as for NC
variables.
● Using the tooltip, you can display the OPI notation for NC system variables (except for
GUD).
Servo variables
Servo variables can only be selected and displayed at "Diagnostics" → "Trace".

Changing and deleting values
2. Press the "NC/PLC variables" softkey.
- OR -
1. Select the "Startup" operating area.
2. Press the "PLC" and "NC/PLC variab." softkeys.
The "NC/PLC Variables" window opens.

3. Position the cursor in the "Variable" column and enter the required vari‐
able.
The operand is displayed with the value.
5. Press the "Details" softkey.
The "NC/PLC Variables: Details" window opens. The information for "Var‐
iable", "Comment" and "Value" is displayed in full length.
6. Position the cursor in the "Format" field and select the required format
with <SELECT>.
7. Press the "Display comments" softkey.

The "Comments" column is displayed. You have the option of creating
comments or editing existing comments.
Press the "Display comments" softkey once again to hide the column.
8. Press the "Change" softkey if you would like to edit the value.
The "Value" column can be edited.
9. Press the "Insert variable" softkey if you wish to select a variable from a
list of all existing variables and insert this.
The "Select Variable" window opens.
10. Press the "Filter/search" softkey to restrict the display of variables (e.g.
to mode group variables) using the "Filter" selection box and/or select the
desired variable using the "Search" input box.
Press the "Delete all" softkey if you would like to delete the entries for the
operands.
11. Press the "OK" softkey to confirm the changes or the deletion.

- OR -
Changing operands
Depending on the type of operand, you can increment or decrement the address by 1 place
at a time using the "Operand +" and "Operand -" softkeys.
Note
Axis names as index
For axis names, the "Operand +" and "Operand -" softkeys do not act as index, e.g. for
$AA_IM[X1].
Examples
DB97.DBX2.5
Result: DB97.DBX2.6
$AA_IM[1]
Result: $AA_IM[2]
MB201
Result: MB200
/Channel/Parameter/R[u1,3]
Result: /Channel/Parameter/R[u1,2]
17.1.2 Saving and loading screen forms

You have the option of saving the configurations of the variables made in the "NC/PLC
variables" window in a screen form that you reload again when required.
Editing screen forms

If you change a screen form that has been loaded, then this is marked using with * after the
screen form name.
The name of a screen form is kept in the display after switching-off.
Procedure
1. You have entered values for the desired variables in the "NC/PLC varia‐
bles" window.

17.2 Displaying the Service overview
3. Press the "Save screen" softkey.

The "Save screen: Select archiving" window opens.
4. Position the cursor on the template folder for variable screen forms in
which your actual screen form should be saved and press the "OK" soft‐
key.
The "Save screen: Name" window opens.
5. Enter the name for the file and press the "OK" softkey.
A message in the status line informs you that the screen form was saved
in the specified folder.
If a file with the same name already exists, they you will receive a prompt.
6. Press the "Load screen" softkey.
The "Load screen" window opens and displays the sample folder for the
variable screen forms.
7. Select the desired file and press the "OK" softkey.
You return to the variable view. The list of all of the predefined NC and
PLC variables is displayed.

The operating state of machine axes and drives is displayed in the "Service Overview" window.
You can configure the display via the "Extended selection >" softkey or directly via the drop-
down list according to the following criteria:
● All NC axes and drives (= default)
● NC axes
● Drives without NC axis assignment
Enable displays
● On/Off1
● Off2
● Off3
● From the drive: Operation enabled
● From the infeed: Enable operation
● Enable pulses
● Speed controller enable NC
● Enable pulses
● Drive ready
● Heat sink temperature
● Power section in i2t limiting

● Motor temperature
● Measuring system 1 active / measuring system 2 active
The states for measuring system 1/2 have the following meaning:
Symbol Meaning
The position measuring system is active.
The position measuring system is parked.

- OR: -
The position measuring system is not configured.
The position measuring system is passive.
Procedure

New horizontal softkeys are displayed.
3. Press the "Axis diagnostics" softkey.
The "Service Overview" window opens.
4. Select an overview in the combo box "Select" combo box.
- OR -
Press the "Go to selection" softkey to search for an overview.
17.2.1 Selecting axes and drives

To display certain enable signals and statuses of machine axes, you can arrange a selection
of all the axes and drives that are available in any sequence you wish.
Note
The following selection configurations have been previously defined, and cannot be changed
or deleted:
● All NC axes and drives
● NC axes
● Drives without NC axis assignment

Selection overview
The following information is provided in the selection overview.
Column Description
Bus No. Bus number for drives without NC assignment.
No entry for NC axes.
Slave address Slave address for drives without NC assignment.
Device No. Device number for drives without NC assignment.
Drive object No. Drive object number for drives without NC assignment.
Name/identifier For NC axes contains the standard machine axis identifier and the
user-defined machine axis names.
For drives without NC assignment, contains the drive object names.
Assignment NC is displayed for an internal object assignment.
PLC is displayed for an external object assignment.
Note
The selection overview differs in the information provided regarding the slave address and
device number between PROFIBUS and PROFINET configuration.
Procedure

3. Press the "Axis diagn." softkey.
4. Press the "Extended selection" softkey.
The window "Extended selection: Axes and drives" opens.
5. Press the "New selection" softkey.
The "New selection" dialog is opened.
6. Enter a display and a file name in the entry fields.
The "Edit selection" window is opened for the newly created selection.
8. Set checkmarks in the check boxes for the axes and drives that you wish
to display.
- OR -
Press one of the following softkeys to obtain a certain selection:

All axes/drives are selected.
No axis/drive is selected.
Only internal drives are selected.
Only external drives are selected.
Those axes are selected that are assigned to a real drive.
All axes are selected, which are defined in a minimum of one channel.
9. Press the "OK" softkey to confirm your selection.
10. Press the "Delete selection" softkey to delete the actual selection.
11. Press the "Edit selection" softkey to edit the actual selection.
The "Edit selection" window opens.
12. If you click the "Back" softkey, you will return to the "Service Overview"
main screen.
17.2.2 Axis diagnostics
Application
The following information is displayed in the "Service Overview" window:
● Check of the setpoint branch (e.g. programmed position setpoint, speed setpoint, spindle
speed setpoint)
● Check of the actual value branch (e.g. actual position value, measuring system 1 or 2,
actual speed value)
● Optimization of the position control loop of the axis (e.g. following error, control deviation,
servo gain factor)
● Check of the entire control loop of the axis (e.g. through position setpoint/actual-value
comparison and speed setpoint/actual-value comparison)
● Check of hardware errors (e.g. by checking the encoder: If the axis is moved mechanically,
the actual position value must change)
● Setting and check of the axis monitoring functions.

Procedure

4. Press the "Service axis" softkey.
The "Service Axis/Spindle" window opens.
5. Press the "Axis +" or "Axis -" softkey to scroll the axes forward or backward.
- OR -
Press the "Axis selection" softkey.
The "Axis Direct Selection" window opens.
Select the required axis directly from those available in the drop-down list
box.
6. Confirm the selection with "OK".
The values of the axis are displayed.
Display data
Display data Meaning

Following error The difference between the position setpoint and the actual position
value of the active measuring system 1 or 2.
Unit: mm, inch or degrees
System deviation The difference between the position setpoint at the position controller
input and the actual position value of the active measuring system 1 or
2.
Contour deviation (axial) The actual contour deviation is displayed with this value (variations of
the following error caused by equalization operations on the speed con‐
troller due to load changes).
The contour deviation results from the difference between an actual
position pre-calculated from the position setpoint and the actual position
value of active measuring system 1 or 2.


Servo gain factor (calculated) The servo gain factor in the display is calculated by the NC according
to the following equation:
6SHHGVHWSRLQW
.YIDFWRU
)ROORZLQJHUURU
>PPLQ@
8QLWIRUGHIDXOWVHWWLQJ
>PP@
Velocity setpoint = setpoint currently being output to the axis/spindle

References:
Basic Functions Function Manual; Velocities, Setpoint / Actual Value
Systems, Closed-Loop Control (G2)
Active measuring system 0: No measuring system active.
1: Measuring system 1 active.
2: Measuring system 2 active.
State of measuring system 1 The state of measuring system 1 or 2 is output here:
State of measuring system 2 Active - Parked - Passive
Actual position value measur‐ The actual position of the axis measured via measuring system 1 or 2.
ing system 1 The position is displayed in the machine coordinate system (no work
Actual position value measur‐ offsets or tool offsets taken into account).
ing system 2 Unit: mm, inch or degrees
Position setpoint Specified position transferred from the interpolator to the position control
Absolute compensation value Display of the absolute compensation value for measuring system 1 or
measuring system 1 2.
Absolute compensation value The compensation value consists of the sum of backlash and leadscrew
measuring system 2 error compensation for the actual axis position.
Compensation, sag + tem‐ Display of the compensation value calculated for the current axis posi‐
perature tion based on the total of the sag and temperature compensations.
Actual speed value, active The pulses supplied by the encoder are evaluated by the NC and dis‐
encoder played.
Unit: %
100% means maximum speed.
Speed setpoint, drive Speed setpoint transferred to the drive (= speed setpoint from position
controller and feedforward control).
Unit: %
100% means maximum speed setpoint.
Programmed spindle speed Speed setpoint programmed by the user.
setpoint Unit: rpm
For example: Input: S1000; display: 1000 rpm
Display applies to spindles only.


Spindle speed setpoint cur‐ Current active speed setpoint with correct sign, including calculated
rent compensation value and any active speed limitation (specified by set‐
ting or machine data)
Unit: rpm
Display applies to spindles only.
Position offset to the The currently valid position offset value is displayed here (relative to the
leading axis / spindle actual actual value) if a position offset (angular offset between the following
value and leading spindle) has been programmed within the synchronous
spindle functionality.
Unit: mm, inches, degrees
References:
Function Manual, Extended Functions; Synchronous Spindle (S3)
Position offset to the The currently valid position offset value is displayed here (relative to the
leading axis / spindle setpoint setpoint) if a position offset (angular offset between the following and
leading spindle) has been programmed within the synchronous spindle
functionality.
Unit: mm, inches, degrees
References:
Function Manual, Extended Functions; Synchronous Spindle (S3)
Override The effective correction factor of the feed or spindle correction switch
is displayed.
Unit: %
Current gear stage Display of the current actual gear stage
With axes, this is only displayed if a spindle is assigned to the axis. The
display corresponds to the NC/PLC interface signal:
DB31, ... DBX16.0-2 (actual gear stage)
References:
Function Manual, Basic Functions; Spindles (S1)
Parameter set (axis) Displays which of the six parameter sets of the position controller is
active.
References:
Basic Functions Function Manual; Velocities, Setpoint / Actual Value
Systems, Closed-Loop Control (G2)
Controller mode Display of the current controller state:
● Position control
● Speed control
● Hold
● Parking
● Follow-up
● Braking
References:
Function Manual, Basic Functions; Various NC/PLC interface signals
and functions (A2)


Feedforward control mode Indicates whether and if so, which mode of the dynamic feedforward
control for the axis is active:
● Inactive
● Velocity
The velocity-dependent speed feedforward control is active.
● Torque
The acceleration-dependent torque feedforward control is active (in
combination with the speed feedforward control)
References:
"Referenced" state Status display for reference point approach (axis):
● Active MS need not be referenced
● Active MS referenced
● Active MS must be referenced
The display depends on the settings in the machine data:

● MD34110 $MA_REFP_CYCLE_NR
● MD20700 $MC_REFP_NC_START_LOCK
The display corresponds to the NC/PLC interface signal:
DB31, ... DBX60.4 and 60.5 (referenced/synchronized 1 or 2)
References:
Function Manual Basic Functions; Reference Point Travel (R1)
QEC state Indicates whether and if so, which method of the quadrant error com‐
pensation (QEC) is active for the axis:
● Inactive
● Neural QEC learning active
● Conventional QEC active
● Conventional QEC w. adapt. comp. value act.
(conventional QEC with adaptation of the compensation value
active)
● Neural QEC active
● Neural QEC w. ad. meas. time val. act.
(neural QEC active with adaptation of the measuring time active)
● Neural QEC w. ad. dec. time comp. val. act.
● (neural QEC with adaptation of decay time of compensation value
active)
● Neural QEC w. ad. meas. time + dec. time comp. val. act.
(neural QEC active with adaptation of measuring time and decay
time of compensation value active)
References:


"Travel to fixed stop" state Indicates whether or not the axis has fulfilled the conditions for "Fixed
stop reached" when the "Travel to fixed stop" function is active (IS
DB31, ... DBX62.5):
● Normal control
("Travel to fixed stop" function not activated)
● Fixed stop reached
● Failed
References:
Function Manual, Basic Functions; Travel to Fixed Stop (F1)
Torque limitation value Indicates the value programmed via FXST[x] or SD43510
$SA_FIXED_STOP_TORQUE or the value defined via MD37010
$MA_FIXED_STOP_TORQUE_DEF for the clamping torque for "Travel
to fixed stop".
Unit: % of maximum torque
References:
Function Manual, Basic Functions; Travel to Fixed Stop (F1)
17.2.3 Service drive
Display drive and motor data

The "Service Drive" window displays important information about the status of the motors and
drive modules, such as motor temperature and DC-link voltage.
Procedure

A switch is made to a new softkey bar.
4. Press the "Service drive" softkey.
The "Service Drive" window opens.
5. Press the "Drive +" or "Drive -" softkey to scroll forward or backward.
- OR -

Press the "Drive selection" softkey.

The "Drive Direct Selection:" window opens.
Select the desired drive directly from the selection list.
6. Confirm the selection with "OK."
The drive data is displayed.
Overview
The individual status displays, warnings, messages, etc. that are displayed in the "Service
Drive" window are explained in the following.
Further information about the interface signals can be found in the following documentation:
Function Manual, Basic Functions:
● Section "Various NC/PLC interface signals and functions (A2)"
● Chapter "NC/PLC interface signals (Z1)"
Further information about the drive parameters can be found in the following documentation:
List Manual, SINAMICS S120/S150 (Drive Object SERVO)
PLC pulse enable

The display, whether the pulse enable from the PLC is available for the drive corresponds to
the interface signal:
DB31, ... DBX21.7 "Pulse enable".
Status Meaning Display

1 Pulse enable for this drive is activated by the PLC. Yes
0 The pulses for the drive module are disabled from the PLC. No
Speed controller enable NC

The display, whether the speed controller enable from the NC is available for the drive
corresponds to the interface signal:
DB31, ... DBX61.6 "Speed controller active".

1 Speed controller enable from the NC present. Yes
0 Speed controller enable from the NC not present. No

Rampup function generator quick stop

The status display for the ramp-function generator quick stop corresponds to the interface
signal:
DB31, ... DBX92.1 "Ramp-function generator disable active".

1 Ramp-up function generator quick stop is active. The drive is stopped without Yes
a ramp function with speed setpoint = 0 and without pulse suppression.
0 Ramp-up function generator quick stop is not active for the drive. No
Pulses enabled
The message whether the pulses have been enabled for the drive corresponds to the interface
signal:
DB31, ... DBX93.7 "Pulses enabled".

1 The drive module pulses are enabled. The axis/spindle can now be traversed. Yes
0 The drive module pulses are suppressed. The axis/spindle can therefore not No
be traversed.
Drive ready
The display of the current status of the selected drive corresponds to the interface signal:
DB31, ... DBX93.5 "Drive ready".

1 The drive is ready. Yes
0 The drive is not ready. No
Ramp-up phase
The display of the current ramp-up phase of the selected drive corresponds to the drive
parameter:
r0002 "Drive operating display".
Number of faulty signs-of-life

Display of communications errors detected in hardware between NC and drive.
Note
If the display shows a value other than "0", please contact your Siemens regional office!

SC1 drive alarm message

Displays (yes/no) whether messages of status class 1 are active. Status class 1 messages
are alarms with the following properties:
● They lead to internal responses (e.g. regenerative braking, immediate pulse suppression)
● They are modal.
This is a group message. For details on the actually pending drive alarms, please refer to the
"Drive System Diagnostics" window, see Section "Displaying drive states (Page 393)."
DC-link voltage, smoothed

The display of the smoothed actual value of the DC-link voltage of the selected drive
corresponds to the drive parameter:
r0026 "DC-link voltage smoothed".
Unit: Volts
Speed setpoint, smoothed

The display of the smoothed speed setpoint - measured according to the setpoint limitation for
the P component of the speed controller - corresponds to the drive parameter:
r1438 "Speed controller speed setpoint".
Unit: rpm
Actual speed value

The display of the smoothed actual value of the motor speed corresponds to the drive
parameter:
r0021 "Actual speed value smoothed".
Unit: rpm
Actual current value, smoothed

The display of the smoothed actual current value corresponds to the drive parameter:
r0078[1] "Actual current value, torque-generating".
Unit: A
Motor temperature
The display of the current temperature in the motor corresponds to the drive parameter:
r0035 "Motor temperature"
Unit: °C

Integrator disabling
The display as to whether the integrator of the speed controller is active, corresponds to the
interface signal:
DB31, ... DBX93.6 "n-controller integrator disabled".

1 The requested shutdown of the speed controller integrator is active in the Yes
drive. The speed controller has been switched over from the PI to P control
response.
0 The integrator of the speed controller is enabled. The speed controller func‐ No
tions as a PI controller.
Parking axis
Displays (yes/no) whether it is a parking axis/spindle.
Note
With parking axes/spindles, all encoder-specific monitoring and evaluation functions are
switched off. This allows the encoder to be withdrawn without initiating an alarm.
Specified drive data set

The display (default: DDS0) of which of the eight drive parameter sets is to be activated by the
PLC corresponds to the interface signal:
DB31, ... DBX21.0 to 21.2 "Drive parameter set selection A, B, C."
More detailed information on working with the drive and motor data sets can be found in:
Commissioning Manual, IBN CNC: NCK, PLC, Drive
Actual drive data set

The display (default: DDS0) of which of the eight drive parameter sets is currently active
DB31, ... DBX93.0 to 93.2 "Active drive parameter set A, B, C."
Specified motor data set

The display (MDS0...3) of which motor data set is to be activated by the PLC corresponds to
the interface signal:
DB31, ... DBX21.3 to 21.4 "Motor selection A, B".
The following assignment applies:
Motor data set Coding

MDS0 0 0
MDS1 0 1
MDS2 1 0
MDS3 1 1

Actual motor data set

The display (MDS0...3) of which motor data set is currently active corresponds to the interface
signal:
DB31, ... DBX93.3 to 93.4 "Active motor A, B".
Operating mode
The display of the control type of a drive corresponds to the drive parameter:
p1300[0…n] "Open-loop/closed-loop control mode".
Depending on "n", the following "values" are displayed:
n Display
20 Speed control (without encoder)
21 Speed control (with encoder)
23 Torque control (with encoder)
Position actual value measuring system 1/2

The actual position of the axis measured via measuring system 1/2. The position is displayed
in the machine coordinate system (no work offsets or tool offsets taken into account).
Unit: mm, inches or degrees
Heat sink temperature

The display of whether the heat sink temperature is OK corresponds to the interface signal:
DB31, ... DBX94.1 "Heat sink temperature prewarning".

1 The drive signals a "Heat sink temperature prewarning" to the PLC. Overtemper‐
ature
0 The drive module heat sink temperature pre-warning has not responded. OK
Motor temperature
The display of whether the motor temperature is OK corresponds to the interface signal:
DB31, ... DBX94.0 "Motor temperature prewarning".

1 The motor temperature has exceeded the warning threshold configured in Overtemper‐
the drive. ature
0 The motor temperature is below the warning threshold. OK

Ramp-up function completed

The status display of the drive as to whether the ramp-up has been completed corresponds
to the interface signal:
DB31, ... DBX94.2 "Ramp-up completed".

1 The actual speed value has reached the speed tolerance band specified via Yes
p2164 after a new speed setpoint specification and has not left the band for
the duration of p2166.
0 The ramp-up procedure is still active after the speed setpoint has been No
changed.
Torque lower than threshold setting

The status display of the drive as to whether the threshold torque has been undershot
DB31, ... DBX94.3 "|Md| < Mdx".

1 The current torque utilization lies below the torque utilization threshold set in Yes
p2194. The drive signals the PLC that the torque setpoint |Md| does not ex‐
ceed the threshold torque Mdx.
0 The torque setpoint |Md| is larger than the threshold torque Mdx. This signal No
can be used to determine whether the motor is overloaded.
Speed lower than minimum setting

The status display of the drive as to whether the minimum speed has been undershot
DB31, ... DBX94.4 "|nact| < nmin".

1 The actual speed value |nact| is less than the threshold minimum speed nmin Yes
set in p2161.
0 The actual speed value is greater than the threshold minimum speed. No
Speed lower than threshold setting

The status display of the drive as to whether the threshold speed has been undershot
DB31, ... DBX94.5 "|nact| < nx".

1 The actual speed value |nact| is less than the threshold speed nx set in p2155. Yes
0 The actual speed value is greater than the set threshold speed. No

17.3 System utilization
Actual speed = set speed

The status display of the drive as to whether the actual speed value matches the speed setpoint
DB31, ... DBX94.6 "|nact| < nset".

1 The speed deviation between the setpoint and actual value is within the tol‐ Yes
erance specified in p2163.
0 The speed deviation between setpoint and actual value is outside the speci‐ No
fied tolerance.
Diagnostics for alarms

This information is also provided as a diagnostic tool for diagnosing the causes of alarms such
as:
● Drive fault:
⇒ SC1 drive alarm message is set.
⇒ Check specified drive data set, specified motor data set, DC-link voltage.
● Alarm 25040 "Standstill monitoring",
Alarm 25050 "Contour monitoring",
Alarm 25060 "Speed setpoint limitation",
Alarm 25080 "Positioning monitoring"
⇒ the drive enable may be missing (PLC pulse enable not present); this results in the display
Pulses enabled = No.
● Motor temperature = exceeded
⇒ check the current motor temperature.
For details on the behavior of the NC control in response to individual alarms, and remedial
action, please refer to:
References
Diagnostics Manual
17.3 System utilization

For the NC areas you can display the system resources (utilization display) currently being
used:
● Runtime for the position controller, interpolator and preprocessing
● Time required for synchronized actions
● Position controller and interpolator NC load
● Interpolator buffer level

17.4 Creating screenshots
Note
The utilization evaluation of the synchronized actions is only displayed when the value in
MD11510 $MN_IPO_MAX_LOAD ≠ 0.
Procedure

3. Press the "System utilization" softkey.
The "System Utilization" window opens.
You can track the dynamic utilization display.
4. Press the "Stop" softkey to stop the display update.
5. Press the "Start" softkey to refresh the values.
17.4 Creating screenshots

You can create screenshots of the current user interface.
Each screenshot is saved as a file and stored in the following folder:
/user/sinumerik/hmi/log/screenshot
Procedure
Ctrl + P Press the <Ctrl+P> key combination.

A screenshot of the current user interface is created in .png format.
The file names assigned by the system are in ascending order from
"SCR_SAVE_0001.png" to "SCR_SAVE_9999.png". You can create up to 9,999
screenshots.

17.5 Machine identity
Copy file
3. Open the folder specified above, and select the required screenshots.
- OR -
5. Open the required archive directory, e.g. on a USB flash drive and press
the "Paste" softkey.
Note
You can also copy the screenshots using "WinSCP" to a Windows PC.
Note
If you wish to view the screenshots, then you can open the files in SINUMERIK Operate. On
a Windows PC, you can open the data using a graphic program, e.g. "Office Picture Manager".

You can store important information about the machine electronically that until now has only
been available on paper for the end user notification administration (EUNA). If service is
required, these entries can be viewed using remote diagnostics, or can be directly transferred
to EUNA via the drives that have been set up.
You can store the following data for each machine:
● Machine type
● Machine number
● Manufacturer information
● Dealer information
● End user information
● Component list of the control technology that has been installed
● Logbook entries for changes to the machine
You save the machine information and address information in the "identSNAPSHOT" window.
You can either manually enter the data or import it from selection files.

Machine information
Entries Meaning
Machine No. The unique machine number (serial number of the CompactFlash card) is dis‐
played in the header. This number serves as information only and cannot be
changed.
Machine name The manufacturer assigns a unique machine number in this field which is stored
in machine data MD17400 $MN_OEM_GLOBAL_INFO.
Note: The machine name is a mandatory field. No data can be stored until this
field is completed.
Machine type Machine type.
Address information
Under Addresses you can enter the following data for the manufacturer/manufacturer's
regional office, dealer and end customer:
● Customer number
● Manufacturer name and, if required, Branch name / Dealer name / End user name
● Street, Postal code/ZIP code, Location, Country (can be selected from a selection list),
Region/State
● Address of contact: Name, Phone, Fax, E-mail, URL
17.5.1 Entering machine-specific information
Preconditions
You must have the following access rights to be able to enter or change machine-specific
information.
Access level 1 (manufacturer)
Access level 2 (service)
Access level 3 (user)

Procedure
2. Press the "Version" softkey.

It takes some time to call the version display. While the version data is
being determined a progress message box and the appropriate text are
displayed in the dialog line.
3. Press the "Logbook" softkey.

The "IdentSNAPSHOT" window opens.
5. Enter the machine name and the machine type.
- or -
Import a selection file: Reading in a selection file (Page 374)
6. Select which address information you wish to enter. To do this, press one
of the following softkeys:
● "Manufacturer"
If you press the "Manufacturer" softkey again, it changes to
"Manufacturer branch".
● "Manufacturer branch"
Pressing the softkey once again changes it back to "Manufacturer".
● "Dealer"
● "End user"
7. Enter the address data in the respective text fields.
- or -
Import a selection file: Reading in a selection file (Page 374)
Press the "OK" softkey to save the changes.
See also
1. Documenting startup (Page 380)
2. Defining start-up (Page 380)
Making a logbook entry (Page 381)
17.5.2 Creating a selection file

Using the selection files, you can prepare the machine information and address information
and transfer it into the controller. This means that it does not have to be manually entered.

As an alternative, you can use the "PridaNet identSNAPSHOT" program to export the machine
and address information from the EUNA database to create a selection file. This ensures that
the information is clear.
Templates
Templates for selection files are available under the directory
/HMI-data/templates/examples/machine identity.
You can find the following templates and selection files on the controller:
● "dealer.xml" for dealer data
● "ma_types.xml" for machine types
● "oem.xml" for manufacturer data
● "oemsubs.xml" for manufacturer data of a regional office
● "user.xml" for end user data
Procedure
3. Copy the files from the folder

/HMI-data/templates/examples/machine identity to a data carrier.
4. Copy the files to your PC to edit them.
5. After processing, copy the data to a data storage medium so that these
can then be transferred to the control system.
6. Insert the copies into the folder
HMI-data/Templates/Manufacturer/Machine identity or use the "Import
data" softkey.
The addresses or machine types are displayed in drop-down list boxes.
When you select a list, the data stored for that address is automatically
entered in the input fields.
Entering dealer data

You can acquire the address data of any number of dealers in file "dealer.xml". If you wish to
enter additional dealers, for each dealer, copy the area <Dealer> to <Dealer>.
<?xml version="1.0" encoding="utf-8" ?>

<Addresses>
<Dealer>

<Customer-Id></Customer-Id>
<Name></Name>
<Street></Street>
<ZIP code></ZIP code>
<Location></Location>
<Country></Country>
<State></State>
<Contact></Contact>
<Phone></Phone>
<Fax></Fax>
<E-mail></E-mail>
<URL></URL>
</Dealer>
</Addresses>
You can list the address data of any number of manufacturers in the "oem.xml" file. If you wish
to enter additional manufacturers (OEMS), for each dealer, copy the area <Manufacturer> to
</Manufacturer>.
You can list the address data of any number of OEM regional offices in the "oemsubs.xml" file.
If you wish to enter additional regional offices, copy the area <Manufacturer-Subsidiary> to </
Manufacturer-Subsidiary>.
You can list the address data of any number of users in the "user.xml" file. If you wish to enter
additional users, copy the area <User> to </User>.
Example of file "ma_types.xml"

You can acquire the available machine types in file "ma_types.xml".
<?xml version="1.0" encoding="utf-8" ?>

<Machinetypes>
<Type>LC 80</Type>
<Type>LC 82</Type>
<Type>LC 120</Type>
<Type>LC 122</Type>
<Type>LC 150</Type
</Machinetypes>
17.5.3 Reading in a selection file

You can directly read-in your selection files into the controller. Depending on the configuration,
files can be selected and imported from a local drive, network drive or USB. The data are then
automatically copied into the following folder: /oem/sinumerik/hmi/template/identity or HMI-
data/Templates/Manufacturer/Machine identity.

Selection files
You can import the data with any name. The data content is evaluated, and the new file name
is derived from this information:
File Information
ma_types.xml Machine types
dealer.xml Dealer's data
oem.xml Manufacturer's data
oemsubs.xml Manufacturer's data of a regional office
user.xml End customer data
Procedure

It takes some time to call the version display. The progress of the data
determination is displayed in the dialog line.
3 Press the "Logbook" and "Change" softkeys.
4. Press the "Import data" softkey.

The "Read-in Selection Files: Select file" window opens.
5. Select the appropriate drive and the required file.
The file is automatically copied to the correct location in the system.
If the selection file only contains one data set, the data is transferred
directly to the entry fields and saved.
7. If the entry fields already contain data, use the "Yes" softkey to confirm
overwriting of this information.
8. If the selection file contains several data sets, select one data set from
the list.
The relevant data is transferred to the entry fields.
9. Press the "OK" softkey to confirm and save the selection and/or manual
changes.
See also
Creating a selection file (Page 372)

17.5.4 Save information

All the machine-specific information of the control is combined in a configuration via the user
interface. You can save machine-specific information on the drives that have been set-up.
Procedure

3. Press the "Save" softkey.
The "Save Version Information: Select Archive" window opens. The fol‐
lowing storage locations are offered depending on the configuration:
● Local drive
● Network drives
● USB
● Version data (archive: Data tree in the "HMI data" directory)
4. Then press the "New directory" softkey if you wish to create your own
directory.
5. Press the "OK" softkey. The directory is created.
6. Press the "OK" softkey again to confirm the storage location.
The "Save Version Information: Name" window opens. The following op‐
tions are available:
● In the "Name:" text field, the file name is pre-assigned with <Machine
name/no.>+<CF-card number>. "_config.xml" or "_version.txt" is
automatically attached to the file names.
● In text field "Comment", you can add a comment that is stored with
the configuration data.
Select the following data via a checkbox:
● Version data (.TXT): Output of pure version data in text format.
● Configuration data (.XML): Output of configuration data in XML format.
The configuration file contains the data you entered under Machine
identity, the license requirements, the version information and the
logbook entries.
7. Press the "OK" softkey to start the data transfer.

17.5.5 Adding hardware components

Most of the hardware components supplied by Siemens are already electronically acquired.
You can add further hardware components.
You can view and supplement the hardware components in the version screen at the user
interface.
All of the hardware components are listed in the version display and in the configuration data.
Precondition
You require access level 2 (service) to add more hardware components.
Entering additional components

If new hardware components are added, they must be assigned to the appropriate categories.
The "Select component" drop-down list box offers the following categories in the "Add HW
Comp." window:
Category
NCU/PLC
Operator Panel
PLC-peripheral devices
Drive/Motor
Cable
Accessories/Miscellaneous
You record the following data in the "Enter Additional Components (Configuration Data)"
window.
Entries Meaning
Name Hardware designation
Version Version of the program
Order No.[MLFB] Order number
Serial number Serial number
Number Number of components

Procedure

3. Select the "Hardware" area and press the "Details" softkey. The "Version
Data / Hardware" window opens.
The "Add HW comp." softkey appears.
4. Press the "Add HW comp." softkey.
The "Select component type" drop-down list box opens.
5. Select a category under which you would like to store the hardware infor‐
mation.
The "Enter Additional Hardware Components" input window opens.
6. Enter additional hardware components via the keyboard.
- OR -
If you are using a CSV file (CSV = Comma Separated Values), for example
a EUNA parts list, you can also read in the data.
Select the storage location where the CSV file is located.
Select the file and press "OK".
The data is transferred from the CSV file into the table. It is read-in ac‐
cording to the CSV format of the EUNA parts list. For each component,
quantity, MLFB, name and serial number are entered. The version is not
saved and is not transferred.
Example:
QUANTITY;MLFB;Z_OPTION;SERIAL
12;6AV7812-0BB11-2AC0;;
1;6FC52030AB110AA2;;T-0815
The data is written to the "versions.xml" configuration file and is therefore
electronically acquired.
All hardware components are displayed in the "Version Data / Hardware"
window.
The manually entered components are assigned a "+", e.g. Cable+.

17.6 Logbook
17.5.6 Configuration data

The machine-specific information is stored in the configuration data. This file saved in the XML
format provides the basis for further processing in EUNA.
● The data can be read by remote diagnostics.
● The data can also be transferred directly to EUNA, e.g. via network or USB FlashDrive.
Configuration data
The configuration data includes:
● Machine-specific data that is stored in the "Machine identity" dialog box
● Hardware/software versions that are stored in the "Versions" dialog box
● Options requiring licenses, which are stored in the "Licensing" dialog box
● Logbook, whose entries are stored in the "Logbook" dialog box
Storage path
Depending on how the drives have been configured, the configuration data can be stored in
the available directories.
See also
Machine identity (Page 370)
Adding hardware components (Page 377)
Licensing (Page 43)
Logbook (Page 379)
17.6 Logbook
The logbook provides an electronic machine history.
The time and date of commissioning is recorded in the logbook, and if the machine is serviced,
this can also be logged electronically. This helps to optimize the service.
Stored entries cannot be changed or deleted.

17.6 Logbook
17.6.1 1. Documenting startup
Precondition
As a minimum, the machine name/No., the customer No. and the country where the
manufacturer is located must be entered into the machine identity.
Procedure
1. The machine-specific information data are entered.
2. Start-up (commission) the machine.

3. Press the "1st startup completed" softkey.
The "1.SETUP" entry is displayed in the "Machine logbook" window to‐
gether with the time and date.
Note
2. Perform commissioning
On completion of first commissioning, you will be prompted to perform the 2nd commissioning.
If the 2nd commissioning is not performed, then you will be prompted at regular intervals to
complete the 2nd commissioning.
See also
Entering machine-specific information (Page 371)
17.6.2 2. Defining start-up
Precondition
As a minimum, the country of the end customer must be entered into the machine identity.
Procedure
The machine-specific information data are entered.
2. Start-up (commission) the machine.

3. Press the "2nd startup completed" softkey.
The "2.SETUP" entry is displayed in the "Machine logbook" window to‐
gether with the time and date.

17.6 Logbook
Note
Registering the machine identity in EUNA
After completion of the 2nd commissioning, you are prompted to send the machine identity to
the EUNA database via the Internet.
See also
Entering machine-specific information (Page 371)
17.6.3 Making a logbook entry

Using the "New logbook entry" window to make a new entry into the logbook.
Enter your name, company and department and a brief description of the measure taken or a
description of the fault.
Note
If you wish to make line breaks in the "fault diagnostics/measure" field, use the key combination
<ALT> + <INPUT>.
The date and entry number are automatically added.
Sorting the entries

The logbook entries are displayed numbered in the "machine logbook" window.
More recent entries are always added at the top in the display.
Procedure
1. The logbook is opened.

2. Press the "New entry" softkey.
The "New logbook entry" window opens.
3. Enter the required data and press the "OK" softkey.
You return to the "Machine logbook" window and the entry is displayed
below the machine identity data.
Note
Deleting logbook entries
Up to the end of the 2nd commissioning, you have the option to delete the logbook entries up
to the time of the first commissioning using the "Clean up" softkey.

17.7 Action log
Searching for a logbook entry

You have the option for searching for specific entries using the search function.
1. The "Machine logbook" window is opened.

2. Press the "Search..." softkey and enter the desired term in the search
form. You can make a search according to date/time, company name/
department or according to fault diagnostics/measure.
term.
3. Press the "Continue search" softkey if the entry found is not the one that
you are looking for.
Press the "Go to Beginning" softkey to start the search at the latest entry.
Press the "Go to End" softkey to start the search at the oldest entry.
17.7 Action log
17.7.1 Setting the action log

In the "Action Log Settings" window you specify whether the operating sequences are to be
logged.
Here, you select which control actions should be logged, so that operator actions and
sequences can be tracked and understood at a later date.
When the action log is active, you can display recorded traces in the system data using the
following files:
● "actual_actionlog.com", actual action log report
● "actual_crashlog.com", crashlog backup
Data that can be logged
Logging on Logging is activated or deactivated.

Alarm status change Incoming and outgoing alarms are logged.
Keyboard actions All actions on the operator panel front and on an external keyboard
are logged.
Channel status change NC/PLC states are logged via the information channel status. If this
information can be obtained in a timely manner, in many cases
these states can be used to verify the operation of the machine
control panel.

17.7 Action log
Window switchover The form and dialog names (assigned by the programmer) are log‐
ged each time a window is opened or closed.
Writing NCK/PLC data The writing of NCK and PLC variables is logged.
File access Copying to the NC is logged.
Function calls in the NCK Some program calls, for example, ASUB, are logged.
(PI service)
Curr. program status Additional information for particular events is activated. For impor‐
tant alarms that require NC stop, NC start, or NC reset, actual val‐
ues and the current block are recorded for example.
The program ascertains which channel and which spindle are used
for the additional information.
Write interval file Settings for updating files:
● "automatic": The action log saves the information to an internal
buffer. If the buffer is full the entries are written to the CF card.
The entries may be lost when the controller is switched off.
● "after every event": All entries are backed up directly, this
prevents data loss due to a power failure or similar.
Notice: As CF cards only permit a limited number of write
accesses, this setting is not recommended for normal operation.
● "time-controlled": New entries are backed-up for a particular
length of time. An additional input field appears in which you can
specify a time in seconds.
Save log as file for alarm(s)The alarm numbers for which a "crash log" is generated are speci‐
fied. The alarms are entered separated by a comma.
Generating a crashlog file

The "actual_crashlog.com" is a backup file of the actual log when a critical event occurs (for
example, emergency stop alarm).
The file is then no longer stored in the ring buffer of the action log and can no longer be
overwritten with new entries.
The entries in the crash log file are only overwritten when yet another critical events occurs.
At the beginning, the file has no entries and is only written to after the following events:
● Interface signal DB19.DBX0.6 "Save teleprinter log" changes from 0 to 1.
● The alarm entered in the "Save log as file for alarm(s)" entry field is output.
Interface signal
DB19 (PLC → HMI)

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
DBB00 Save ac‐
tion log

17.7 Action log
Procedure
2. Press the "HMI", "Diagnostics", and "Action log" softkeys

The "Action Log Settings" window opens.
3. Activate the "Logging on" checkbox to activate the action log.

4. Check the relevant checkbox if you want to acquire particular events in
the action log.
See also
Displaying the log file (Page 384)
17.7.2 Displaying the log file

Loggable data that was logged when the action log function was active is displayed in the
"Action Log File" window.
Log files
The actual data can be displayed using the following files:
● "actual_actionlog.com"
● "actual_crashlog.com"
Procedure

The data tree is displayed.
You will find the saved files in the HMI data folder under /logs/action log.

17.7 Action log
3. Select the desired com file and press the "Open" softkey or double-click
the file.
4. Press the "Display new" softkey to update the display of events in the log
(actual_actionlog.com).
The entries made since the log file was called up are displayed.
17.7.3 Searching in the log files

You can search for specific events in the log.
Precondition
The relevant log file is open.
Procedure
1. Press the "Search" softkey.

A new vertical softkey bar appears. The "Search" window opens at the
same time.
2. Enter the desired search term in the "Text" field.
3. Position the cursor in the "Direction" field and choose the search direction
(forward, backward) with the <SELECT> key.
4. Press the "OK" softkey to start the search.

If the text you are searching for is found, the corresponding line is high‐
lighted.
Press the "Continue search" softkey to continue the search, as necessary.
- OR -
Press the "Cancel" softkey when you want to cancel the search.
1. Press the "Go to End" softkey to scroll to the end of a large log. You get
to the oldest entry of the recording.
2. Press the "Go to Beginning" software to return quickly to the most recent
log entry.
17.7.4 Storing a log

You can store the displayed log in the "HMI data/Logs/Alarm logs" directory. It is stored as a
binary file as well as ASCII file. You can read an ASCII file with any editor.

17.7 Action log
The following logs are generated:

● action.com (binary file)
● action.log (ASCII file)
● crash.com (binary file)
● crash.log (ASCII file)
Requirement
The relevant log file is open.
Procedure
1. Press the "Save log" softkey.

The log is stored in the "HMI data/Logs/Alarm logs" directory.
Note
The "Save log" softkey is only available for files that have not yet been saved.
17.7.5 Structure of a log file
Content of the log file

The following data is recorded for every logged event:
HMI version NC version

System Entry keyword Date/time
Entry text
DETAILS
Entry Description
HMI and NC version output
System:
HMI Keystrokes, window change
NC Write variables, PI services
MSG Alarm entries
USR Entries generated by the machine manufacturer for the user
ERR Action log error, e.g. log file not found
Entry keyword:
HMI_START Entry of an HMI boot
HMI_EXIT Entry of an HMI shutdown

17.7 Action log
Entry Description
PLC_CRASH Entry of a PLC crash
KEY_PRESSED Entry of a keystroke
KEY_HOLD Entry of a key hold
KEY_RELEASED Entry of a key released
ALARM_ON Entry of an incoming alarm event See below
ALARM_OFF Entry of an alarm going event "Alarm display"
ALARM_ACK Entry of an alarm acknowledgement event
OPEN_WINDOW Entry of a window opening
CHN_STATE_CHANGED Entry of a channel status change
OPMODE_CHANGED Entry of an operating mode change
TOOL_CHANGED Entry of a tool change
OVERRIDE_CHANGED Entry of override changes
DOM_CMD Entry of a download to the NC
PI_CMD Entry of a PI service
WRITE_VAR Entry of a write to NCK/PLC variable
AREA_CHANGED Entry of an area changeover
NC_CONNECTION Entry of an coming/going NC connection
USER User entry via the OEM interface
ACTIVATED Action log was activated
DEACTIVATED Action log was deactivated
INTERNAL Internal action log entry
Date/time Date and time of the event
For HMI_Start, PLC_Crash or date change since the last entry,
the intermediate period between the entry keyword and date is
designated with an "-".
Entry text Event data is written in plain text.
DETAILS If additional information regarding an entry is known, e.g. a re‐
corded IPO trace.
Example
Note
DB19.DBW24 interface signal
The DB19.DBW24 interface signal used in the example does not apply to the SINUMERIK
840D sl. It is DB1900.DBW4 for the SINUMERIK 828D.
NCK WRITE_VAR 18.02.2009 09:40:12

ncu1.local wrote variable: DB19.DBW24 = 0
HMI KEY_PRESSED 18.02.2009 09:40:12
Key up: "Return" (1000004/ 0)
HMI HMI_START ---------------------------- 18.02.2009 09:34:15
HMI started.

17.7 Action log
Alarm display
MSG ALARM Date/time
No. Deletion criterion Text
DETAILS
Entry Description
MSG
ALARM Type of alarm: ALARM_ON, ALARM_OFF, ALARM_ACK
Date/time Data and time of the event
No. Alarm number
Deletion criterion: Information as to how the alarm was acknowledged
AUTOMATIC Automatic acknowledgement
POWER ON Acknowledgement using PowerOn
RESET Acknowledgement using NCK reset
NC START Acknowledgement using NC start
NC RESET Acknowledgement using NC reset
ALARM CANCEL Acknowledgement using Alarm Cancel key
RECALL Acknowledgement using the Recall key
HMI Acknowledgement using HMI
PLC Acknowledgement using PLC
Text Display of the English alarm text
DETAILS If additional information regarding an entry is known.
Example
MSG ALARM_ON 20.02.2009 14:25:37
8020 POWER ON : Option 'activation of more than 1 channels' not
set
DETAILS:
Mode: JOG Program: canceled Channel: interrupted
Program-Level information:
Level Program running: Invoc Offset
1 /_N_MPF0 0 0
17.7.6 Advanced settings

You define the size of the log file of the action log in the "actlog.ini" configuration file.

17.8 HMI trace
Procedure
1. You can copy a sample configuration file "actlog.ini" from the following directory: /siemens/
sinumerik/hmi/template/cfg.
3. Open the file and after "; ActionLogSize=", enter the file size (in bytes).
"actlog.ini" configuration file

Template for the configuration of Action Log
;
; To activate the settings remove the
; commentary ';' at the beginning of the line
[ActionLogSettings]
;To change the path of the internal action log file use the following
setting
;ActionLogPath=/user/sinumerik/hmi/ac_log/action.com
;To change the size of the internal action log file use the following
setting
;ActionLogSize=5000000
;To change the path of the internal crash log file use the following
setting
;CrashLogPath=/user/sinumerik/hmi/ac_log/crash.com
17.8 HMI trace
Creating an HMI trace

The "HMI trace" function is available for extended diagnostics of the operating software. The
prerequisite is at least access level 3 (user).
Procedure to create an HMI trace file:
1. An expert of the Service & Support Center provides a sltrc_keybitset.ini file. Copy the
sltrc_keybitset.ini file to a USB memory medium and load the file on the controller or
operator panel.
2. In the operating area, select "Start-up" → "HMI" → "Diagnostics >" → "HMI trace".
3. Select the INI file on the USB memory medium with the "Load configuration" softkey.

17.9 PROFIBUS diagnosis
4. Start the trace by activating the checkbox or from any place on the user interface with the
following key combination:
<Alt> + <T> on the operator panel
<Alt> + <Shift> + <T> on an external keyboard
The following icon is displayed at the top right in the header to show that a trace is active:
5. On the user interface, repeat the operating sequence whose cause is to be clarified.
6. Stop the trace by deactivating the checkbox or from any place on the user interface with
the following key combination:
<Ctrl> + <T> on the operator panel
<Ctrl> + <Shift> + <T> on an external keyboard
7. A sltrc.out output file is generated which you can copy to the storage medium with the
"Export data" softkey.
8. Send the sltrc.out file for analysis back to the Service & Support Center.
Note
On completion of the analysis, it is recommended to delete all files under the following path: ../
user/sinumerik/hmi/log/sltrc
Note
"Extended" softkey
The other options in this dialog support suitably qualified service engineers in the analysis of
the system and evaluation of the HMI trace.

Display the PROFIBUS status for diagnostic purposes during the configuration or when errors
occur. This diagnostics window is only intended for information purposes. You cannot modify
them.
PROFIBUS connections
● DP1 X126
● DP2 X136
● DP integrated

Display Meaning/information
Status
Bus status POWER_ON (0): State after the control has been switched on
OFFLINE (1): Basic initialization has been performed
STOP (2): Start in accordance with the hardware configuration (SDB)
CLEAR (3): PROFIBUS slaves have been parameterized and configured
in accordance with the hardware configuration (SDB) and taken into the
cyclic data exchange with zero output data
OPERATE (4): Cyclic data exchange with the PROFIBUS slaves running
ERROR (9): A fatal error had been detected (e.g. invalid or faulty SDB)
(<n>) corresponds to the OPI variable value for the bus state.
Bus configuration
S7 Subnet ID S7 Subnet ID of the PROFIBUS subnet
Baud rate Transmission rate in Mbd
Cycle time Configured bus cycle time in msec; also defines the position controller
cycle at the same time
Sync. Component (TDX) Configured time interval in msec for the cyclic data exchange within a
PROFIBUS DP cycle
PROFIBUS diagnostics/slaves
Slave address Configured number of the DP slave
Assignment Information whether the DP slave is assigned to the NC or to the PLC.
NC: e.g. one or more drives controlled by the NC
PLC: e.g. I/O peripherals or an axis controlled by the PLC
NC/PLC (for DP integrated)
Communication state Information whether the DP slave is identified on the bus via the commu‐
nication state.
Green: DP slave has been detected on the PROFIBUS DP and the data
exchange is working error-free with the assigned component (NC and/or
PLC)
Red: Incorrect response / no communication
Synchr. with NC Information whether the DP slave is running synchronously to NC on the
bus.
Green: DP slave runs synchronously to NC on the PROFIBUS DP, i.e.
there is an isochronous data exchange
Red: Incorrect response / no communication
Gray: DP slave is not assigned to the NC, but to the PLC
Number of slots Number of configured slots within the DP slave
References
Further information about the configuration of the properties of the network interface for
PROFIBUS can be found in the following:
CNC Commissioning Manual: NCK, PLC, Drives, SINUMERIK 840D sl, SINAMICS S120

Procedure
2. Press the "Menu forward" key and the "Bus TCP/IP" softkey.
The "PROFIBUS Diagnostics" window is opened.
3. If several PROFIBUS connections have been configured, press the "Bus

-" or "Bus +" softkey to select the desired configuration.
...
- OR -
Press the "Select bus" softkey and in the list that is displayed, select the
required configuration.
17.9.1 Displaying details for DP slaves

Further information about the slots of a selected DP slave is displayed here.
Slave
Address The DP slave selected in the PROFIBUS diagnostics / slaves pane
Communication state Data regarding the NC and/or PLC assignment of the DP slave
In synchronism with NC Data regarding NC synchronous operation of the DP slave
If a synchronous value is not available for the DP slave, then the display
remains hidden.
Slots
No. Slot number within the DP slave
I/O addr. I/O address in the I/O address space of the PLC, assigned to this slot
For NC axes, the setpoint and the actual value must always be configured
on the same I/O address.
Type Data as to whether the slot is input, output or diagnostic slot
If the slot is assigned to an NC axis, then the output is always denoted as
setpoint value and the input always as actual value.
Length (bytes) Length of the I/O area reserved for the slot in the STEP7 I/O address space

17.10 Drive system
Communication state Actual communication state of the slot
If a value is not available for the NC axes, then the display remains hidden.
Green: Slot used by the NC, communication active
Red: Slot used by the NC, communication currently not active
Gray: No NC axis
Machine axis Display of the name defined in the machine data for this slot
If the slot is not assigned to any NC axis, then the display remains hidden.
Telegr. type (NC) Displays the assigned telegram type
If a telegram type is not assigned in the NC machine data, then the display
remains hidden.
Procedure
2. Press the "Menu forward" key and the "Bus TCP/IP" softkey.
The "PROFIBUS Diagnostics" window is opened.
3. Select the PROFIBUS configuration for which you want to display details.
The "PROFIBUS Diagnostics ... - Details" window is opened.
17.10 Drive system
17.10.1 Displaying drive states
Status display
The "Drive System Diagnostics" window displays the status information about the drive units
and the associated drive objects. The status symbols have the following meaning:
Display icon Meaning

Green The drive object is in (cyclic) operation, without any detected
problems.
Yellow The drive object has detected a less serious problem, i.e. a
warning is pending, for example, or enables are missing.
Red This drive object has detected a serious problem, for example,
an alarm is pending.

17.10 Drive system

Gray The drive status could not be determined for this drive object.
# Special charac‐ Error when reading the data.

ters
Procedure
2. Press the menu forward key and the "Drive system" softkey.
3. The "Drive System Diagnostics" window opens.

The name of the selected drive object is displayed in the window title.
Press the "Drive object +" or "Drive object -" softkey.
The next (+) or previous (-) drive object is selected.
- OR -
Press the "Select drive unit" softkey.
The "Select Drive Unit" window opens.
4. Select the desired drive unit via the drop-down list box and press "OK" to
confirm the selection.
See also
Displaying details of the drive objects (Page 394)
17.10.2 Displaying details of the drive objects
Drive system diagnostics - details

The following information is displayed for the drive objects:
● Status display (r0002)
– The status display (parameter r0002) of the drive object is displayed.
● Missing enable signals (r0046)
– The enable signals are diagnosed except for the drive objects that do not have enable
signals (e.g. Control Unit). Missing enables are shown in a pane below the displays.

17.10 Drive system
● Commissioning parameter filter

– (p0009) – control unit
The value of the "Device commissioning parameter filter" control unit parameter (p0009)
is displayed.
– (p0010) – further drive object
The value of the "Drive object commissioning parameter filter" parameter (p0010) is
displayed.
● Current fault
The alarm number of the actual drive object fault is displayed or "No fault present", when
no drive object fault is pending.
You obtain an overview of the pending faults with the following data in an additional window:
– Alarm number
– Time: Date and time
– Alarm text
● Current warning
The number of the current drive object warning is displayed or "No warning present", when
no drive object warning is pending.
You obtain an overview of the pending alarms with the following data in an additional
window:
– Alarm number
– Time: Date and time
– Alarm text
Meaning of the symbols

Green The relevant value of the drive object signals no problem detected.
Yellow The relevant value of the drive object signals a less serious problem,
i.e. a warning is pending, for example, or enables are missing.
Red The relevant value of the drive object signals a a serious problem,
for example, an alarm is pending.
Gray The drive status could not be determined for this drive object.
# Special characters Error when reading the data.
Procedure
2. Press the menu forward key and the "Drive system" softkey.

17.11 Remote diagnostics
The "Drive System Diagnostics" window opens.
3. Select the drive object for which you want to display further details.
The "Drive System Diagnostics - Details " window opens.
The name of the drive object is displayed in the window header.
Press the "Faults" softkey.
The "Drive Unit Faults" window opens that shows an overview of the faults
that have been output.
Press the "Alarms" softkey.
The "Drive Unit Alarms" window opens that shows an overview of the
alarms that have been output.
You can display the pending SI messages if Safety Integrated is integra‐
ted in your controller.
17.11.1 Adapting remote diagnostics

Depending on the operating mode, the initiative for remote diagnostics comes from the service
provider or from the controller.
If the initiative comes from the controller, the "Request remote diagnostics" softkey is set-up.
The display of the "Request remote diagnostics" softkey is defined in the "tcu.ini" file under
the [PINGSERVICE] section.
● Variable PingServiceMode
0 = disable
1 = enable
In additional variables of this section, the data for the request telegram for service should be
set.
● Variable PingServerIP
IP address of the service provider to which the request telegram should be sent, e.g.
PingServerIP = 128.45.234.19
● Variable PingTransmissionData
A text that should be sent out as data content in the request telegram,
e.g. PingTransmissionData = help at machine 35
● Variable PingTransmissionPeriod
The length in minutes that the telegram should be sent,
e.g. PingTransmissionPeriod = 5

● Variable PingTransmissionInterval
Duration in seconds after which send is repeated,
e.g. PingTransmissionInterval = 15
● Variable PingServerPor
Port number of the Ping service with the manufacturer,
e.g. PingServerPort=6201
17.11.2 Remote diagnostics via Teleservice adapter IE at X127

The following settings must be made for remote diagnostics via modem using a Teleservice
adapters IE (TS Adapter) that is connected at X127:
Settings in the TS Adapter required

● IP address of the adapter: 192.168.215.30, subnet mask 255.255.255.224
● IP address of the caller: 192.168.215.29
These two addresses are also stored as standard in the "tcu.ini" file. If other addresses are
used, the entries "X127ModemIP" and "X127RemoteAccessIP" must be appropriately
changed in the "tcu.ini" file.
● Enable the ports for the services for S7 communication, http, HTTPS, SSH as well as VNC
(port 5900) in the firewall.
Connecting the modem for remote diagnostics
1&8
;
76DGDSWHU 6HUYLFH3&
Figure 17-1 Basic system with SINUMERIK Operate on NCU (and operating station with TCU)
With the previously mentioned settings and the default values, in this configuration, remote
diagnostics via TS Adapter is possible without any additional changes having to be made.

6,180(5,.2SHUDWH
RQVW3&8
;
;
1&8
;
7HOHVHUYLFHDGDSWHU 6HUYLFH3&
Figure 17-2 Basic system with SINUMERIK Operate on PCU
With the previously mentioned settings and the default values, in this configuration, remote
diagnostics via TS Adapter is possible without any additional changes having to be made.
When operating a SINUMERIK Operate on a PCU, the SINUMERIK Operate in the NCU must
be switched off.

; ; ;
VW1&8 QG1&8 QWK1&8
;
76DGDSWHU 6HUYLFH3&
Figure 17-3 System with several NCUs and a fixed modem
The "MC Information System RCS Host" option only has to be set for the NCU to which the
TS Adapter is connected at the X127 interface. Modem access can only be permitted by making
the appropriate entries at the SINUMERIK Operate in this NCU and the "Request remote
control" function executed. If modem access is permitted, then the service PC implicitly has
access to all other NCUs and their operating software. On the other hand, the operating
screens to control the remote access can be used and set at each station
(SINUMERIK Operate in the NCU) individually for the station in conjunction with the relevant
local PLC.

6,180(5,.2SHUDWH
6,180(5,.2SHUDWH
6,180(5,.2SHUDWH

RQVW3&8 RQQG3&8 RQUG3&8
; ; ;
; ; ;

VW1&8 QG1&8 QWK1&8
;

7HOHVHUYLFHDGDSWHU 6HUYLFH3&
Figure 17-4 System with several NCUs, several PCUs and a fixed modem
The "MC Information System RCS Host" option only has to be set for the NCU to which the
TS Adapter is connected at the X127 interface. Modem access can only be permitted by making
the appropriate entries at the SINUMERIK Operate on the PCU that is assigned to this NCU
and the "Request remote control" function executed. If modem access is permitted, then the
service PC implicitly has access via the plant or system network to all other NCUs and PCUs
and their operating software. The operating screens to control the remote access can be
individually used and set at each station (SINUMERIK Operate in the NCU) for the station in
conjunction with the relevant local PLC.
17.11.3 PLC control for remote access

In the PLC user program, you can control external viewers using the following settings.
DB19.DBX1.0 PLCExtViewerReject
Value =0 =1
Meaning Permit remote control No remote control
DB19.DBX1.1 PLCExtViewerMode
Value =0 =1 ignored

17.12 Trace
Meaning Operating rights for remote Only monitoring for re‐ -

control mote control
Result Operating rights for remote Only monitoring for re‐ No remote control
control mote control
17.12 Trace
The trace provides you with an oscilloscope function that allows the following data (signals) to
be graphically displayed:
● General NC data
● PLC data
Trace session
The function serves for troubleshooting and resolving faults as well as to analyze the machine
and process performance. In a session, data (signals) are recorded briefly before and after an
event.
Graphic display
The recorded data is optically displayed in the form of curves, the so-called characteristics
graphs.
You have the option of individually setting the recording type.
Saving and downloading data

You can store the recorded data in an XML file. The saved file can then be re-loaded so that
it can be evaluated at a later time.
Recording fundamentals: Signals (data)

Signals (data) specify what is to be recorded:
● NC variables (axis data, drive data, channel data, etc.)
● PLC data
Cyclic events
Interpolation clock cycle (IPO clock cycle)
PLC cycle OB1
Position control clock cycle (servo clock cycle)
Non-cyclic events
Starting a session
● Recording using a trigger
● Manually starting and stopping a trace

17.12 Trace
Analyzing the result

The following functions are available to analyze the result:
● Scaling characteristic graphs
● Zooming characteristic graphs
● Defining a characteristic range using markers
17.12.1 General procedure

Sequence
● Create a trace session file as follows:
– Select the variable and define its representation type.
– Set the graphics window, and the save mode
– Set the trigger property to define the start and end of recording
● Save the recording and its associated properties that have been set
● Analyze the result by making the settings for the display in order to view additional details
(e.g. zoom in, scroll, select section, etc.)
See also
Variable for trace (Page 405)
Trace settings (Page 411)
Trace options (Page 413)
Saving the trace file (Page 403)
Evaluate a trace (Page 414)

17.12 Trace
17.12.2 Trace session
17.12.2.1 Creating a session file
Procedure
3. Press the "Trace" softkey.
4. Press the "Load trace" and "New" softkeys.

The "New Session" window opens in which the "Session" name is rec‐
ommended. The file format is automatically specified as ".xml".
5. Supplement the file name or enter a new file name.

6. Select a variable type and press the "OK" softkey.
You return to the "Select Variables for Trace: ...." ...." window.
The name of the session that has been newly created is displayed in the
header.
See also
Variables filter/search (Page 405)
17.12.2.2 Saving the trace file

There are two options of saving a trace session:
● Variables and settings: Only the variables and the settings are saved.
● Variables, settings and recorded values: The variables, settings and the recorded values
are saved.
Note
Save option
If you have activated the "Save file in both formats" checkbox at "Trace" → "Options
(Page 413)", the session file is saved as a csv file in addition to xml format.

17.12 Trace
Procedure
1. You have edited an active trace session.
2. Press the "Store trace" softkey.

The "Save Trace: Session ... " window opens and offers the following
storage options.
3. Activate the corresponding checkbox and press the "OK" softkey.
The "Store Trace" window opens and specifies the file name in the "Name
of trace file:" entry field. The file format is automatically specified as ".xml"
and cannot be changed.
4. Press the "OK" softkey to save the session file.
If the session file already exists, then you obtain a corresponding confir‐
mation prompt.
5. Press the "OK" softkey if you wish to overwrite the existing session file.
- OR -
Press the "Save as" softkey if you do not wish to overwrite the existing
session file.
A new name is suggested but you can specify a name yourself.
- OR -
Press the "Change directory" softkey if you wish to store the session file
in a directory other than in the standard "Trace" directory.
The data tree opens and you can select between the configured drives.
Press the "New directory" softkey if you wish to create a new directory.
The "New Directory" window opens in which you can assign a directory
name.
The "Store Trace" window opens in which the names of the target direc‐
tory and the session file are displayed.
You can change the name of the session file.
6. To save the session file, press the "OK" softkey one more time.
- OR -
If the session file with this name already exists, then you obtain a corre‐
sponding confirmation prompt.
17.12.2.3 Load trace session file

You have the option of loading already saved session data, to restart them or to display the
trace that has been recorded.
Settings Meaning
Variables, settings You can restart a trace session that has already been created.
Variables, settings and recorded val‐ You can view the result of a trace session, change the variable
ues and if required, restart.

17.12 Trace
Precondition
A session file of recorded traces is available.
Procedure
1. You have selected the "Trace" function.
2. Press the "Load trace" softkey.

The "Load Session File: Please Select File" window opens.
3. Select the desired session file from the appropriate directory, e.g. "Trace",
and press the "Display trace" softkey.
The "Load trace: session..." is opened.
4. Select the checkbox "Variables, settings", if you wish to immediately start
the trace session.
5. Press the "OK" softkey and the "Start trace" softkey to restart the
trace.
- OR -
Select the checkbox "Variables, settings and recorded values", if you wish
to display the trace session.
The data of the selected session are loaded displayed in the "Trace"
window.
17.12.3 Variable for trace
17.12.3.1 Variables filter/search
Searching for PLC/NC/servo variables

To limit the selection of variables for PLC/NC/servo, set a filter and/or enter a start value for
the search:
Filter: Display of the following variables:

System variable System variables
NC NC variables
Axis Axis variables
Channel Channel variables
Mode groups Variables of the mode groups in OPI notation
Servo Servo trace variables
Global user data GUD such as: SGUD, MGUD, UGUD, GUD4, ...

17.12 Trace
Filter: Display of the following variables:

PLC PLC variables
PLC alarms Manufacturer-specific PLC alarm signals
All (no filter) All variables in alphabetical order
Inserting variables
The start value for the "Filter/Search" of variables differs. For example, to insert the variable
$R[0], enter the following start value:
● The start value is 0 if you filter according to "System variables".
● The start value is 1 if you filter according to "All (no filter)". In this case, all signals are
displayed and shown in the OPI notation.
The GUD from the machine data is only displayed in the Search window for the variable
selection when the associated definition file has been activated. Otherwise, the sought
variables must be entered manually, e.g. GUD/SYG_RM[1]
The following machine data is representative for all variable types (INT, BOOL, AXIS, CHAR,
STRING): MD18660 $MN_MM_NUM_SYNACT_GUD_REAL
Searching for drive variables

The restriction of the search is performed in this case via the selected drive object. In the
Search window, you can restrict the selection by entering alphanumeric values, for example.
Further restrictions of the selection are possible via the "All" or "Recommended"
interconnections.
Procedure
For a trace session, in the "Selected Variables for Trace: Session ... " window, set the variables
whose signals are to be traced.
1. In the "Select variables for trace: Session..." window, a trace session is

displayed.
2. Position the cursor in the "Variable" column in an empty line.
- OR -
Position the cursor in the "Variable" column on a variable that you wish
to replace by another.
3. Press the "Insert variable" softkey.
The "Select Variable" window opens.
Note:
When selecting a "Drive parameter", firstly select the drive object (DO)
and then insert the desired parameter from the list of corresponding pa‐
rameters.
4. Press the "Filter/search" softkey to start a specific search.
In the "Filter" selection box, select a variable area.
- OR -

17.12 Trace
Directly enter the variable into the "Search" entry field.

The cursor jumps to the term that is found.
Press the "Delete search" softkey if you wish to terminate the search.
5. Press the "Add" softkey to enter the required variable into a trace session.
The "Variable Attributes" window opens and you can select the appropri‐
ate value (e.g. channel data, drive bus no.) from a combobox.
- OR -
Press the "Replace" softkey to replace an already selected version by
another one.
6. Press the "OK" softkey to add or replace the variable.
Each variable is automatically allocated a reference number, which is
displayed in the upper section of the window. This number is opened
automatically allocated. If a version is removed, then the following varia‐
bles are re-numbered.
7. Now, select the desired settings for display, such as color, pen, qty.,
event. etc.
Editing variables of a trace session
Key combination Effect

Ctrl + X Press the key combination or open the shortcut menu in order to
or right-click, shortcut menu "Cut" cut out a variable.
Ctrl + C Press the key combination or open the shortcut menu in order to
or right-click, shortcut menu "Copy" copy a variable.
Ctrl + V Press the key combination or open the shortcut menu in order to
or right-click, shortcut menu "Paste" insert a variable.
17.12.3.2 Selecting attributes of a variable
Attributes
For a trace session, select the variables and assign the corresponding attributes:
Column Meaning
Variable Address of the variables
Attributes Meaning
Comment ● Name of the selected variables
● A general description for the variables.
Color Color selection, the representation of the characteristic graphs.
When creating a variable, the next color from the available palette is automati‐
cally used.

17.12 Trace
Attributes Meaning
Pen Line type selection to display the characteristic graphs.
● No line
● Solid line
● Dashed line
● Dash-dot line
● Dash-dot-dot line
● Dotted line
● Stepped line XY
● Stepped line YX
● "* line" (line made up of * symbols)
● + line
● X line
Qty. Defines whether the characteristic of the variables is displayed in the "Trace"
window. If the checkbox is not selected, then no characteristic graphs are dis‐
played.
Events Event selection which triggers that the signal is traced:
● Interpolation clock cycle (IPO clock cycle)
● Interpolation cycle (IPO2)
● Position control clock cycle (servo clock cycle)
● PLC cycle OB1
● Drive trace rate
● Start geometry axis/direction change
● Stop geometry axis
● Machine axis start / direction change
● Machine axis stop
● NC start (program runs)
● NC start (program ran)
● Start of the data recording

17.12 Trace
Attributes Meaning
● Block start, type 1 or block end (all program levels, without intermediate
blocks)
● Block start, type 2 or block end (all program levels, with intermediate blocks)
● Block start, type 3 or block end (all main programs, without intermediate
blocks)
● Block start or block end, block search (all program levels, without
intermediate blocks)
● Geo axis start / direction change (2nd event)
● Geo axis stop (2nd event)
● Block start, type 2 (2nd event: all program levels, without intermediate
blocks)
● Block end, type 2 (2nd event: all program levels, with intermediate blocks)
● Block start, block advance, type 1 (2nd event)
● OEM test event 1 (non-cyclic, block advance)
● OEM test event 2 (non-cyclic, main run)
● Activate/deactivate synchronized action
● Synchronized action initiated (condition fulfilled)
● Signaled alarm
● Cancel softkey pressed
● Program level change
● Block end (Interpreter)
● Trace end (last event!)
● Start trace
● WRTPR part program command
● WRTPR part program command (block search)
● Tool change
● Cutting edge change
● Tool change (block search)
● Cutting edge (block search)
● Start trigger initiated
● Stop trigger initiated
● Block end (block advance)
● Block end (2nd event: Block search)
● WRTPR part program command (block advance)
● Tool change (block advance)
● Cutting edge (block advance)
Event channel This means that the channel can be defined in SINUMERIK in which a specific
event occurs. For events which are not channel-specific, the field remains emp‐
ty.

17.12 Trace
Attributes Meaning
Bit mask In the case of an integer variable, a bit mask can be specified in this field. For
a bit mask, the particular signal value is AND'ed before being displayed. After
the mask has been applied, all of the selected bits are moved to the right so
that it looks as if the bit or the bits all start with bit zero.
This means, if all bits with the exception of bit 7 have been masked, then the
integer number that would have been obtained would either have a value of 0
or 1, however, not 0 or 128.
If all of the bits with the exception of bit 7 and 0 have been masked, the resulting
integer number would either have the value 0, 1, 2 or 3, however, not 0, 1, 128
or 129.
Decimal places This setting is used to define how many places to the right of the decimal point
are displayed at the axis identifiers.
Coord. axis The coordinate axes are displayed to the left or right in the graphic window or
there is no display.
Display Y Value input or 0
Scale factor Defines the scale.
Units Displays the measurement unit, e.g. mm/min. The system specifies this and it
cannot be changed.
17.12.3.3 Displaying details of a variable
Variable: Details
The most important information and settings are displayed at a glance in the detail window:
● Variable address
● Comment with a description of the variables
● Events
● Channel, axis, access level, mode group, etc.
● Smaller graphic display with the event; when this event occurs the characteristic graphs
are recorded as well as their attributes, such as color or line type.
Procedure:
1. You are in the "Select Variables for Trace: ..." window.
2. Position the cursor to the required variable.

A subscreen with the most important information as well as the graphic
display is shown in the lower half of the window.
Press the "Details" softkey again to display the subscreen.

17.12 Trace
17.12.4 Trace settings
17.12.4.1 Trace settings (PLC, NC, servo)

In the "Trace Settings (PLC, NC, Servo)" window, you define the conditions for starting and
stopping the trace session.
Condition for Start trace

With "Start trace" softkey The recording is started immediately after pressing the "Start trace" softkey.
If variable The session is activated by a variable. The desired variable is selected via
the "Insert variable" or "Quick list" softkey.
● Condition and value After the session has been activated, this defines at which value the trace
recording is started.
The following values are offered: = =, ≠, >, >=, <, <=, ascending, descend‐
ing, changed.
Data acquisition [s]
Specifies where the recorded data is saved:
● With "On NCK", the recorded data is saved in the NC work memory until the recording is stopped.
Only then is the session file saved on the CompactFlash card.
● With "CF card" or "On hard disk", the data is saved during the recording on the CompactFlash card
or hard disk (e.g. of the PCU). As a consequence, more signals can be processed.
Condition for Stop trace
With "Stop trace" softkey The recording is stopped after pressing the "Stop trace" softkey.
If the time has expired Defines the period which after expiry, the trace recording is exited.
If the memory is full The trace session is terminated when the specified data volume (KB) is
reached.
If variable The recording is stopped by a variable. The desired variable is selected
via the "Insert variable" or "Quick list" softkey.
● Condition and value After the session has been activated, this defines at which value the trace
recording is exited.
The following values are offered: = =, ≠, >, >=, <, <=, ascending, descend‐
ing, changed.
● Delay time [s] This defines how long the trace still runs after the session has been exited.
● Overwrite at memory Defines from which memory limit the data is overwritten (ring buffer).
limit (KB)
17.12.4.2 Trace settings (drive)

In the "Trace Settings (Drive)" window, you define the conditions for starting and stopping the
trace session:
Condition for Start trace

With "Start trace" softkey The recording is started immediately after pressing the "Start
trace" softkey.

17.12 Trace
If variable The recording is activated after pressing the "Start trace"

softkey when the selected variable clearly satisfies the con‐
dition and the specified value.
The following conditions are offered:
● Positive edge
● Negative edge
● With bit mask
The "Bit mask" softkey is displayed when the "Bit mask" con‐
dition is selected in order to select the desired bits. Irrespec‐
tive of the maximum value (hexadecimal) which is possible
through the bit mask, a "Value" (decimal) can be entered at
which the trace recording starts precisely.
Example:
The trace recording is started when the following bits are set:
Bit 0 = 0; bit 1 = 1; bit 2 = 0; bit 3 = 1
Bit mask = fH Condition Value (decimal)
Variable: CU/ With bit mask 10
r722/3.3.1 ☑ Bit 0
☑ Bit 1
☑ Bit 2
☑ Bit 3
Preprocessing time [s]: The input of a preprocessing time corresponds to the func‐
tional parameter p4722 "Trace trigger delay":
● A positive preprocessing time starts the recording before
the trigger event.
● A negative preprocessing time starts the recording after
the trigger event.
When entering a preprocessing time, the entire duration of
the recording must be taken into account:
● If the preprocessing time is greater than the entire
duration of the recording, the entry is rejected.
● If too large a preprocessing time is entered, the trigger
event may not be recorded.
Data storage on CU
Drive trace rate [μs]: Enter a factor with the "Sampling rates" softkey to set the
effective sampling rate. With a higher sampling rate, the re‐
cording duration is also longer.
Condition for Stop trace
If the time has expired Defines the period which after expiry, the recording is exited.
If the memory is full The recording is terminated when the specified data volume
(KB) is reached.

17.12 Trace
17.12.4.3 Trace options

You define the following properties of a trace session in the "Trace - Options" window.
● Setting the graphic window
– Displaying main grid lines: You define whether a horizontal grid is displayed and in which
color.
– Displaying grid sub-lines: You define whether a vertical grid should be displayed and in
which color.
– Background: You select the background color of the graphic window.
● Defining storage options
– Activate the "Confirm file overwrite" checkbox in order to receive a confirmation prompt
each time a trace session is to be overwritten. If the checkbox is deactivated, the trace
session is overwritten without a confirmation prompt.
– Activate the "Save file in both formats" checkbox in order to also save the data as a csv
file (Page 403) in addition to the xml session file. The file in csv format cannot be
imported again.
Procedure
1. You are in the "Select Variables for Trace: ..." window and a trace ses‐
sion has been selected.
2. Press the "Options" softkey.
The "Trace - Options" window opens.
3. Select the desired settings and press the "OK" softkey in order to accept
the settings.
17.12.4.4 Starting the trace

In the "Trace" window, you obtain the curve with the data of the variables selected for a trace
session.
The diagram comprises two Cartesian coordinates:
● Time axis
The horizontal x axis supplies the time values.
● Value axis
The vertical y axis displays the resolution fineness (amplitude).
Recording the trace session

● Manually starting and stopping a trace
● Starting and stopping recording using a trigger

17.12 Trace
Procedure
1. You have listed the desired variables for a trace section.
2. Press the "Display trace" softkey.

The "Trace" window is opened. The recording is loaded and the proce‐
dure is displayed in progress window.
3. Press the "Start trace" softkey if you wish to immediately start recording.
- OR -
The recording is triggered by the trigger condition.
4. If you wish to manually end the recording, press the "Stop trace" softkey.
- OR -
The recording is stopped by the trigger condition.
17.12.5 Evaluate a trace
17.12.5.1 Setting trace views

In order to permit a precise evaluation of the recorded signals, you have the option to edit the
view as well as the display of the characteristic graphs:
● Selection/legend
– Show legend: In addition to the graphic display, the data of the variable is displayed as
comment, numbered and in color.
– Make a selection: You define which variables are displayed in the graphic window.
● Scale
– Specifying scaling factors for minimum and maximum X and Y value
● Zoom
– Increasing or decreasing the section
● Cursors: The cursor display provides functions that allow one, two or both curves to be
precisely measured.
– Cursor A
– Cursor B
– Both cursors
– Snap to curve: The cursor precisely moves along the curve
– Point mode: Cursor jumps directly to various values.
– High point mode: The cursor jumps from one peak value to the next.
– Low point mode: Cursor jumps to the lowest values.

17.12 Trace
Requirement
The "Trace" graphic window is open and the trace has been recorded.
Editing curves
You jump from one variable to the next using the <TAB> key.
You jump back using the <Ctrl> and <TAB> keys.
With the cursor keys, you set marks, move to individual values and can
define a zoom range.
17.12.5.2 Selecting a variable

You have the option of displaying the selected variables as legend and to make a selection
using a checkbox.
Legend
Numbering the variables
Axis identifier
Comment of the variables
Displaying a legend and selecting a variable
1. A recording is opened in the "Trace" graphics window.
2. Press the "Legend / selection" softkey.

The graphic window is halved. The variables are displayed as comment
and with checkbox in the left-hand section of the window.
3. Activate or deactivate the required variable using the checkbox to display
it as curve.
4. Press the softkey again to hide the legend area again.

17.12 Trace
17.12.5.3 Scaling the display

The scaling allows you to make a precise measurement of selected variables from the X time
axis as well as from the Y value axis. You have the option of saving the larger or smaller display
in a user-defined way
Setting Meaning
X minimum or Highest or lowest value of the X time axis. The values are used for recording
X maximum when the trace is started again.
Fixed scale, X axis Values of the X time axis are kept.
Strip chart recorder mode The values of the X time axis are used while
recording.
Y minimum or Defining the highest or lowest value of the Y value axis (amplitude).
Y maximum
Offset or Defining the rms values (mean values) of the amplitudes.
resolution The scale is changed by a factor of 10.
Scaling the time and value axis
2. Press the "Scale" softkey in order to scale the display.
The "Select X-Y Scaling" input window opens and the values of the X time
axis are displayed.
3. Press the "X time axis" softkey again if you wish to hide the values.
- OR -
Press the "Y selected curves" softkey to display the values of the Y value
axis.
Press the softkey again if you wish to hide the values.
- OR -
You have selected both axes.
4. Press the "Scale +" or "Scale -" softkey until the desired scaling is reached.
- OR -
Enter the scaling values directly into the input window and select the ap‐
propriate property.
5. Press the "Scale" softkey to save the settings.
- OR -

17.12 Trace
Press the "Adapt selected" softkey to display the selected characteristic

graphs in the full graphic window.
Press the "Fit one" softkey to display the selected characteristic graphs in
the full graphic window.
17.12.5.4 Zooming the display

Using the zoom function, you have the option of viewing selected sections of curves in detail.
After you have defined an area or a section, you can increase or decrease the size of it (zoom
in or zoom out).
Procedure
2. Press the "Zoom" softkey if you wish to zoom-in or zoom-out on the char‐
acteristic graphs.
3. The "X time axis" or "Y value axis" softkey is selected.
4. Press the "Adapt individually" or "Adapt all" softkey if you wish to display
all selected characteristic graphs in a separate area positioned one above
the other.
or
- OR -
Press the "Adapt together" softkey if you wish to adapt all of the charac‐
teristic graphs to the graphic window.
As all of the curves fill the complete window area, they are displayed
superimposed on one another.
- OR -
Press the "Individually adapt X" softkey if you wish to normalize the X time
axis only in the graphic window.
- OR -
Press the "Individually adapt Y" or "Adapt all" softkey if you only wish to
scale the Y value axis in the graphic window.
or
- OR -

17.12 Trace
Press the "Adapt Y together" softkey if you wish to adapt the value axis
of all characteristic graphs to the graphic window.
As all curves fill the complete window area, they are displayed superim‐
posed.
5. Press the "Zoom +" or "Zoom -" softkey until the desired display size is
reached.
Zoom in/zoom out area

Press the "Zoom area" softkey to define a specific section.
A frame is displayed.
Press the "Zoom +" or "Zoom -" softkey to change the frame step-by-step.
Press the "OK" softkey to display the zoom area.
17.12.5.5 Position the cursor

Using the cursor, you have the option of determining the precise values from a defined section.
To do this, the cursor is positioned directly on the curve.
Procedure
2. Press the "Cursor A" softkey.

The reference number, color of the variables and the color of the coordi‐
nate crossing point are displayed on the softkey.
3. Position "(A)" at the position on the curve where you wish to start the
measurement.
The coordinates are specified in a tooltip and in the status line.
4. Press the "Cursor B" softkey.

The reference number, color of the variables as well as the color of the
coordinate crossing point are also displayed on this softkey.
Position "(B)" at the position on the curve where you wish to end the
measurement.

17.12 Trace
5. Press the "Both cursors" softkey to display the area between A and B.
The coordinates of A and B as well as the difference "Δ" are displayed in
the status line.
Press the active "Cursor A" and "Cursor B" softkeys again to deselect the
position.
When re-selected, the positions are reset.
Press the "Crop to screen" softkey to display the area, defined by "Cursor
A" and "Cursor B", in the complete graphic window.
Press the "Snap to waveform" softkey to move the cursor along the curve
step-by-step.
17.12.5.6 Acquiring measured values

You have the option of directly determining the following values of a curve:
● Peak-to-peak value
● Peak-to-valley value
Procedure
A recording is opened in the "Trace" graphics window.
Press the "Point Mode" softkey to continuously move the cursor along the
curve.
Press the "Peak Mode" softkey to position the cursor at the highest value.
Press the "Valley Mode" softkey to position the cursor at the lowest value.
If you press the "Peaks" softkey, the cursor only goes to the peak-peak
values.
If you press the "Minimum" softkey, the cursor only goes to the peak-valley
values.

17.13 PROFIBUS/PROFINET and AS-i bus diagnostics
17.13.1 PROFIBUS/PROFINET
With the PROFIBUS/PROFINET diagnostics, you obtain a quick overview from which, when
required, you can call status and detailed information for external DP master systems and
PROFINET IO systems.
Precondition for detailed diagnostics

When using HMI PRO RT, the diagnostics can be extended by additional information (e.g.
module and Order No.). This data involves offline data, which can be extracted from the
associated Step7 project.
● You can create offline data using the HMIPRO CS program.
● You transfer data to the control using the HMIPRO program.
Software option
For faulted modules, in order that in addition to the status information, detailed
information can also be displayed, you now require the following option:
"Operating software SW HMI PRO sl RT".
In order that detailed information can be displayed for PROFINET-IO systems, the PLC block
FB_SL_COM from the HMI PRO block library must be used. Use DB449 as the associated
instance DB.
Note
Detailed information for DP master systems is also available without using FB_SL_COM.
Diagnostics information from the DP master systems

You can configure the following versions:
1. Software option not available and HMIPRO offline data not available
2. Software option available and HMIPRO offline data not available
3. Software option available and HMIPRO offline data available
17.13.2 Displaying PROFIBUS/PROFINET diagnostics
Diagnostics information from the DP master systems

From the user interface, you can display the fieldbus diagnostics known from HMIPRO. The
module state is displayed using diagnostic symbols.

The following diagnostics information is displayed depending on the particular version that you
have configured:
Information for all versions

Status Module has a fault
Module has failed
Module is OK
Module is suppressed (this is only possible with HMI PRO RT)
PROFIBUS address PROFIBUS address data
Additional information for the second version

PROFIBUS/PROFINET module
or channel diagnostics
Device diagnostics For Siemens DP/DP coupler and diagnostics repeater
Additional diagnostic information for the third version

Name Module designation from the HMI offline data
Name Module name from the HMI offline data
Order no. Order number of the module from the HMI offline data
IP address IP address of the module from HMI offline data (only for PROFINET)
Graphic display of the complete hardware configuration in a dedicated window
Procedure
2. Press the "Menu forward" key twice and the "PB/PN diag." softkey.
The "PROFIBUS/PROFINET Diagnostics" window opens.
3. Select the required DP master system.

The complete diagnostics information is displayed.
4. Press the "Available devices" softkey to display the diagnostics data

of the available modules.
- OR -
Press the "Suppressed devices" softkey to display the diagnostics
data of the suppressed modules.
- OR -

Press the "Failed devices" softkey to display the diagnostics data of

the failed modules.
- OR -
Press the "Faulty devices" softkey to display the diagnostics data of
the faulty modules.
17.13.3 Configuring the AS-i bus

You obtain a fast overview of the existing AS-Interface network using the AS-Interface (AS-i)
diagnostics. Permanent monitoring and an error search function provide you with the following
information:
● Status flags acc. to the AS-i specification
● States of the AS-i slaves
Precondition
● For AS-i diagnostics, it is absolutely necessary to use the FB_SL_COM PLC block from the
HMI PRO block library.
● The configuration file "sltlprodiaghmi.ini" must be available.
AS-i components
The following AS-i components are supported:
CP142-2 (Type ID 1)
CP343-2 (Type ID 2)
DP/AS-i link (Type ID 3)
DP/AS-i link 20E (Type ID 4)
DP-AS-i link Advanced (Type ID 6)
Diagnostic information
All of the AS-i components to be diagnosed must be parameterized in the "sltlprodiaghmi.ini"
configuration file.
Entry Description
[SKO]
ComboCount=x Number of entries (x) in the selection list
[SKO_Index0] 1. Entry
DiagType= 6 Type ID of the AS-i component (refer above)
TypeSection=DP-AS-i-Link- Designation of the AS-i component, which should be
Advanced 1 output in the selection list

Entry Description
Logical_Address=43 E address of the AS-i component from the hardware
configuration
RequestDB=449 Instance DB of the function block "FB_SL_COM" be‐
ing used
Example of the "sltlprodiaghmi.ini" with 5 components

[SK0]
ComboCount=5
[SK0_Index0]
DiagType= 1
TypeSection=CP142-2
Logical_Address=43
RequestDB=449
[SK0_Index1]
DiagType= 2
TypeSection=CP343-2
Logical_Address=75
RequestDB=449
[SK0_Index2]
DiagType= 3
TypeSection=DP-AS-i-Link
Logical_Address=75
RequestDB=449
[SK0_Index3]
DiagType= 4
TypeSection=DP-AS-i-Link-20E
Logical_Address=75
RequestDB=449
[SK0_Index4]
DiagType= 6

TypeSection=DP-AS-i-Link-Advanced
Logical_Address=75
RequestDB=449
Procedure
1. Copy the "sltlprodiaghmi.ini" file from the /siemens/sinumerik/hmi/template/cfg directory.
2. Place the file in the directory: /oem/sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg.
If the file is already available in the directory, then just supplement this by the corresponding
entries.
3. Open the file and enter the corresponding data of the AS-i components.
4. Save and close the file.
The diagnostics information is displayed on the user interface.
17.13.4 Displaying AS-i bus diagnostics
Diagnostics information from AS-i components

Using the user interface, you have the option of displaying information about the networking
of binary sensors and actuators (AS-i).
Software option
Additional error counter can be displayed for the component DP-AS-i Link Ad‐
vanced if the option "Operating SW HMI PRO sl RT" is set.
Diagnostic information
Flags acc. to the AS-i specification Description

Offline Offline operating state
Internal Internal operating state
EEPROM o.k. Internal EEPROM okay
Auto-Addr.progr. enabled Automatic address assignment enabled
I/O fault Peripheral fault present
Master Power On - Start Starting after Master Power On
Offline ready Offline phase completed
AS-i cable voltage too low AS-i cable voltage too low
CP in normal operation CP in normal operation
Operating mode Operating mode state
Auto.-Addr.progr. executed Automatic address assignment executed
Auto-Addr.progr. possible Automatic address assignment possible

Flags acc. to the AS-i specification Description

AS-i slave with addr.=0 available Slave with address 0 available
Reference config. = actual config. Target configuration equal to actual configuration
State Marking
Slave OK Green
Slave fault Red
Slave is available, but not configured Yellow
Procedure
2. Press the menu forward key twice and the "AS-i diag." softkey.
The "Diagnostics AS-Interface" window is opened.
3. Select the required DP AS-interface.

The complete diagnostics information is displayed.
The values in italics indicate an error counter > 0.


OEM-specific online help 18
18.1 Overview
In addition to the existing extensive online help, you also have the option of generating a
manufacturer-specific online help and then linking this into SINUMERIK Operate.
This online help is generated in the HTML format, i.e. it comprises HTML documents that are
linked with one another. The subject being searched for is called in a separate window from
a contents or index directory. Similar to a document browser (e.g. Windows Explorer), a list of
possible selections is displayed in the left-hand half of the window and when you click on the
required subject, the explanation is displayed in the right hand half of the window.
Context sensitive selection of online help pages is not possible.
Procedure
1. Generating HTML files
2. Generating a help book
3. Integrating the online help in SINUMERIK Operate
4. Saving help files
Other application cases

Online help for the following OEM-specific expansions can be created and used to supplement
the SINUMERIK Operate online help system:
● Online help for cycles and/or M functions of the machine manufacturer which extend the
programming options for SINUMERIK control systems. This online help is called in just the
same way as the SINUMERIK Operate online help "Programming".
● Online help for OEM-specific variables of the machine manufacturer. This online help is
called from the variable view of SINUMERIK Operate.
Programming online help

You can use the "SINUMERIK HMI programming package sl" for additional options for
configuring the online help. Using this programming package, it is possible to develop high-
level language applications in the C++ programming language for SINUMERIK Operate on
the NCU 7x0.
Note
The "SINUMERIK HMI programming package sl" must be ordered separately as a software
option. The associated documentation is provided together with the programming package.

OEM-specific online help
18.2 Generating HTML files

Generating help files in the HTML format. It is possible to save all information in a single HTML
file or to distribute the information over several HTML files.
You can assign the file names yourself, however, you must observe the following:
● References within HTML files should always be specified with relative paths. Only then can
it be ensured that the references function in precisely the same way on both the
development computer as well as on the target system.
● If jumps are to be made to certain points within an HTML file per link, then so-called anchors
must be defined for this purpose.
Example of an HTML anchor:
<a name="myAnchor">This is an anchor</a>
● The contents of HTML documents must be saved with the UTF-8 coding. Only then is it
guaranteed that the HTML documents are correctly displayed in all of the country languages
supported by SINUMERIK Operate.
● The following sub-sets of the HTML functional scope are supported:
HTML tags
Tag Description Comment

a Anchor or link Supported attributes: href and name
address Address
b Bold
big Larger font
blockquote Indented paragraph
body Document body Supported attributes: bgcolor (#RRGGBB)
br Line break
center Centered paragraph
cite Inline citation Same effect as tag i
code Code Same effect as tag tt
dd Definition data
dfn Definition Same effect as tag i
div Document division The standard block attributes are supported
dl Definition list The standard block attributes are supported
dt Definition term The standard block attributes are supported
em Emphasized Same effect as tag i
font Font size, family, color Supported attributes: size, face, and color (#RRGGBB)
h1 Level 1 heading The standard block attributes are supported
head Document header

Tag Description Comment

hr Horizontal line Supported attributes: width (can be specified as absolute or
relative value)
html HTML document
i Italic
img Image Supported attributes: src, width, height
kbd User-entered text
meta Meta-information
li List item
nobr Non-breakable text
ol Ordered list The standard attributes for lists are supported
p Paragraph The standard block attributes are supported (default setting:
left-aligned)
pre Preformated text
s Strikethrough
samp Sample code Same effect as tag tt
small Small font
span Grouped elements
strong Strong Same effect as tag b
sub Subscript
sup Superscript
table Table Supported attributes: border, bgcolor (#RRGGBB), cellspac‐
ing, cellpadding, width (absolute or relative), height
tbody Table body No effect
td Table data cell The standard attributes for table cells are supported
tfoot Table footer No effect
th Table header cell The standard attributes for table cells are supported
thead Table header This is used to print tables that extend over several pages
title Document title
tr Table row Supported attributes: bgcolor (#RRGGBB)
tt Typewrite font
u Underlined
ul Unordered list The standard attributes for lists are supported
var Variable Same effect as tag tt
Block attributes
The following attributes are supported by the tags div, dl, dt, h1, h2, h3, h4, h5, h6, p:
● align (left, right, center, justify)
● dir (ltr, rtl)

Standard attributes for lists

The following attributes are supported by tags ol and ul:
● type (1, a, A, square, disc, circle)
Standard attributes for tables

The following attributes are supported by tags td and th:
● width (absolute, relative, no-value)
● bgcolor (#RRGGBB)
● colspan
● rowspan
● align (left, right, center, justify)
● valign (top, middle, bottom)
CSS properties
The following table includes the supported CSS functional scope:
Property Values Description

background-color <color> Background color for elements
background-image <uri> Background image for elements
color <color> Foreground color for text
text-indent <length>px Indent the first line of a paragraph in pixels
white-space normal | pre | nowrap | pre- Defines how whitespace characters are handled
wrap in HTML documents
margin-top <length>px Width of the upper edge of the paragraph in pixels
margin-bottom <length>px Width of the lower edge of the paragraph in pixels
margin-left <length>px Length of the left hand edge of the paragraph in
pixels
margin-right <length>px Width of the righthand edge of the paragraph in
pixels
vertical-align baseline | sub | super | mid‐ Vertical alignment for text (in tables, only the val‐
dle | top | bottom ues middle, top and bottom are supported)
border-color <color> Border color for text tables
border-style none | dotted | dashed | dot- Border style for text tables
dash | dot-dot-dash | solid |
double | groove | ridge | inset
| outset
background [ <'background-color'> || Short notation for background property
<'background-image'> ]
page-break-before [ auto | always ] Page break before a paragraph/table
page-break-after [ auto | always ] Page break after a paragraph/table
background-image <uri> Background image for elements

18.3 Generating the help book
Supported CSS selectors

All CSS 2.1 selector classes are supported with the exception of so-called pseudo selector
classes such as :first-child, :visited and :hover.

The help book is an XML file in which the structure of the online help is defined. In this file, you
define:
● HTML documents
● Contents and subject index
Syntax for the help book
Tag Number Meaning

HMI_SL_HELP 1 Root element of the XML document
I-BOOK Identifies a help book. The name can be freely selected under the
I constraint that no name predefined by the system is used (such as
I sinumerik_alarm_plc_pmc).
I In the example, the name of the help book is "hmi_myhelp"
I
Attributes:
I +
I ref Identifies the HTML document that is displayed as the en‐
I try page for the help book.
I title Title of the help book that is displayed in the table of con‐
I tents.
helpdir Directory that contains the online help of the help book.
I-ENTRY Section of the online help
II Attributes:
II
ref Identifies the HTML document that is displayed as entry
II
* page for the section.
II
II title Title of the section that is displayed in the table of contents.
II
II
II-INDEX_ENTRY Subject (keyword) to be displayed
II Attributes:
II
ref Identifies the HTML document that is jumped to for this
II
* subject index entry.
II
II title Title of the subject that is displayed in the subject index.
II
II
The following applies for the "Number" column:

* means 0 or more
+ means 1 or more

Example for a help book

In the following example, the structure of a help book with the "My Help" name is described.
Further, it forms the basis for the table of contents and subject index.

<HMI_SL_HELP language="en-US">
<BOOK ref="index.html" title="My Help" helpdir="hmi_myhelp">
<ENTRY ref="section_1.html" title="Section 1">
<INDEX_ENTRY ref="section_1html#Keyword_1" title="Keyword_1"/>
<INDEX_ENTRY ref="section_1.html#Keyword_2" title="Keyword_2"/>
</ENTRY>
<INDEX_ENTRY ref="section_2.html#Keyword_3" title="Keyword_3"/>
</ENTRY>
INDEX_ENTRY ref="section_31.html#test" title="test;section31"/>
</ENTRY>
INDEX_ENTRY ref="section_32.html#test" title="test;section32"/>
</ENTRY>
</ENTRY>
</BOOK>
</HMI_SL_HELP>
The book comprises three sections, whereby the third section has two subsections. The
various subject words (keywords) are defined within the section.

18.4 Integrating the online help in SINUMERIK Operate
You have the following three options to format the subject index:
1. Single entry:
<INDEX_ENTRY ...title="index"/>
2. Two two-stage entry, whereby each title has a main and a subentry. Separate the entries
from one another using a comma.
<INDEX_ENTRY ...title="mainIndex_1,subIndex_1 with mainIndex_1"/>
3. Two-stage entry, whereby the first title is the main entry and the second title is the subentry.
Separate the entries from one another using a semicolon.
<INDEX_ENTRY ...title="mainIndex_2;subIndex_2 without
mainIndex_1"/>

If you wish to integrate the generated help book into the online help system of
SINUMERIK Operate, then you require the "slhlp.xml" file.
Format description of the "slhlp.xml"
Tag Num‐ Meaning

ber
CONFIGURATION 1 Root element of the XML document. Designates that this in‐
volves a configuration file.
I-OnlineHelpFiles 1 Introduces the section about the online help books.
II-<help_book> * Introduces the section of a help book.
III-EntriesFile File name of the help book with the list of contents and subject
III (keyword) entries.
III Attributes:
1
III value Name of the XML file
III
III type Data type of the value (QString)
III-Technology Specifies the technology that applies to the help book.

III "All" applies to all technologies.
III If the help book applies to several technologies, then the tech‐
III nologies are listed separated by comma.
III 0, 1
Possible values:
III
All, Universal, Milling, Turning, Grinding, Stroking, Punching
III
III Attributes:
III value Technology data
III
type Data type of the value (QString)
IIII

Tag Num‐ Meaning

ber
III -DisableSearch Disable the subject (keyword) search for the help book.
III Attributes:
III
0, 1 value true, false
III
III type type, data type of the value (bool)
III
III-DisableFullTextSearch Disable the full text search for the help book.
III Attributes:
III value true, false
0, 1
III
III-DisableIndex Disable the subject index for the help book.

III Attributes:
III
0, 1 value true, false
III
III-DisableContent Disable the table of contents for the help book.
III 0, 1 Attributes:
III value true, false
III
III-DefaultLanguage Abbreviation for the language that should be displayed if the

III actual country language is available for the help book.
III Attributes:
0, 1
III value chs, deu, eng, esp, fra, ita, ...
III
type Data type of the value (QString)
III
The following applies for the "Number" column:

* means 0 or more
Example of a file "slhlp.xml"

The help book "hmi_myhelp.xml" is made known to SINUMERIK Operate in the following
example.
The subject index has not been activated for the help book.

<!DOCTYPE CONFIGURATION>
<CONFIGURATION>
<OnlineHelpFiles>
<hmi_myHelp>
<EntriesFile value="hmi_myhelp.xml" type="QString"/>
<DisableIndex value="frue" type="bool"/>
</hmi_myHelp>
</OnlineHelpFiles>
</CONFIGURATION>

18.6 Generating online help for user alarms and machine data
18.5 Saving help files
Saving help files in the target system

1. Open the /oem/sinumerik/him/hlp directory and create a new folder for the required
language. For this purpose, use the specified language code.
It is mandatory that the folder names are written in lower-case letters.
For instance, if you are integrating a help function for German and English, then create the
"deu" and "eng" folders.
2. Place the help book, e.g. "hmi_myhelp.xml" in the "deu" and "eng" folders.
3. Copy the help files into the directories, e.g. /oem/sinumerik/him/hlp/deu/hmi_myhelp for
German and /oem/sinumerik/him/hlp/eng/hmi_myhelp for English help files.
4. Place the configuration file "slhlp.xml" into the directory /oem/sinumerik/hmi/cfg.
5. Restart the HMI.
Note
When displaying the list of contents and subject index of a help book, the help files are
saved in the binary format (slhlp_<Hilfe-Buch_*.hmi) under the directory /siemens/
sinumerik/sys_cache/hmi/hlp for faster use. If you change the help book, you must always
delete these files.
See also
You have the option to create a dedicated online help for user-specific PLC alarms. These can
be opened context-sensitive from the alarm list when the alarms occur.
The help texts for the user-specific PLC alarms are realized in the HTML file
"sinumerik_alarm_oem_plc_pmc.html".
Creating an HTML file

1. Create the HTML file in the following directory: /oem/sinumerik/hmi/hlp/<lng>/
sinumerik_alarm_plc_pmc/ or
/user/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_plc_pmc/.
<lng> stands for the language code, e.g. deu, eng, etc. If you create a language directory,
use the language code from the table in Section Supported languages (Page 612)
2. Assign the "sinumerik_alarm_oem_plc_pmc.html" name to the file. If you create help texts
for several languages, then create the corresponding number of HTML files with precisely
these names. This file name must not be changed and is applicable for all languages.

3. Place the files in the corresponding language directories. For instance, place the file for the
German help text in the following directory: /oem/sinumerik/hmi/hlp/deu/
sinumerik_alarm_plc_pmc/sinumerik_alarm_oem_plc_pmc.html
4. Delete the file "slhlp_sinumerik_alarm_plc_pmc_*.hmi" in the /siemens/sinumerik/
sys_cache/hmi//hlp directory and restart the operating software.
"sinumerik_alarm_oem_plc_pmc.html" file
Entry Meaning
<a name="AlarmNr">AlarmNr</a> Hyperlink to the alarm number
<b> .....</b> Help text for the corresponding alarm
<td width="85%">......</td> Text that is displayed after the "Explanation" or "Remedy" field.
Example
The alarm number is used as HTML anchor.
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD

HTML 4.0 Transitional//EN" >
- <html>
<head><title></title></head>
- <body>
- <table>
- <tr>
- <td width="15%">
<b><a name="510000">510000</a></b>
</td>
- <td width="85%">
<b>This is the help for user alarm 510000</b>
</td>
</tr>
- <tr>
- <td valign="top" width="15%">
<b>Explanation</b>
</td>
<td width="85%"> This is the explanation of user alarm 510000.</td>
</tr>
- <tr>
<td valign="top" width="15%"><b>Remedy:</b></td>
<td width="85%">Eliminate reason for alarm. </td>
</tr>
</table>
</body>
</html>

Distribute the online help for user alarms over several HTML files
You have the option of distributing the online help for user alarms over several HTML files.
1. Create an XML file with the name "sinumerik_alarm_plc_pmc.xml" in the following
directory: /oem/sinumerik/hmi/hlp/<lng>/ or /user/sinumerik/hmi/hlp/<lng>/
<lng> stands for the language code, e.g. deu, eng, etc. When you create a language
directory, use the language code from the table in Section Supported languages
(Page 612)
2. Open the XML file and in the tag <NUM_AREAS> enter the number ranges of the alarms
and the corresponding HTML files.
3. Store the HTML files, specified in the XML file, in the following directory:
/oem/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_plc_pmc or
/user/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_plc_pmc file
Example: Creating an XML file
Entry Meaning
<BOOK> Help book
<NUM_AREAS> Number ranges of the alarms and the reference to the particular HTML file
The following example includes the online helps for the

alarms from 500000 to 599999 in the HTML file "sinumerik_alarm_oem_1.html",
the alarms from 600000 to 699999 in the HTML file "sinumerik_alarm_oem_2.html",
the alarms from 700000 to 799999 in the HTML file "sinumerik_alarm_oem_3.html",
the alarms from 800000 to 899999 in the HTML file "sinumerik_alarm_oem_4.html".
<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<!DOCTYPE HMI_SL_HELP>
<HMI_SL_HELP>
<BOOK>
<NUM_AREAS>
<NUM_AREA from="500000" to="599999" ref="sinumerik_alarm_oem_1.html" />
</NUM_AREAS>
</BOOK>
</HMI_SL_HELP>
Replacing the standard online help

You have the option of generating your own online help for the HMI, NC and PLC alarms as
well as machine data. This means that you can replace the standard online help by your own
online help.
You can call your own online help directly at the control using the INFO key. Instead of the
standard online help, your own online help is displayed.

18.7 Example: This is how you create an online help for NC/PLC variables
Directory for HTML files
Area Directory
PLC alarms /oem/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_plc_pmc/ or
/user/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_plc_pmc/
HMI alarms /oem/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_hmi/ or
/user/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_hmi/
NC alarms /oem/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_nck/ or
/user/sinumerik/hmi/hlp/<lng>/sinumerik_alarm_nck/
NC MD /oem/sinumerik/hmi/hlp/<lng>/sinumerik_md_nck/
Channel MD /oem/sinumerik/hmi/hlp/<lng>/sinumerik_md_chan/
Axis MD /oem/sinumerik/hmi/hlp/<lng>/sinumerik_md_axis/
<lng> stands for the language code, e.g. deu, eng, etc. Only use the language codes from the
table in SectionSupported languages (Page 612)
Procedure:
1. Create the corresponding directory, refer to the table "Directory for HTML files".
2. Generate the help file and as file names, use the alarm/machine data number as well as
the extension ".html" for HTML help files and ".pdf" for PDF help files. If you create help
texts for several languages, then create the corresponding number of help files with
precisely these names and then create the file in the corresponding language directory.
Examples:
● Your own German online help for the PLC Alarm 510000:
/oem/sinumerik/hmi/hlp/deu/sinumerik_alarm_plc_pmc/510000.html
/oem/sinumerik/hmi/hlp/deu/sinumerik_alarm_plc_pmc/510000.pdf
● Your own German online help for the NC machine data 14510 $MN_USER_DATA_INT:
/oem/sinumerik/hmi/hlp/deu/sinumerik_md_nck/14510.html
Overview
In order to create context-sensitive online help for NC/PLC variables or system variables as
shown in the following example, the descriptive texts are managed in language-dependent
html files.

Figure 18-1 Example: Online help for user variables
Structure of the online help

The following files are required for the online help:
File Meaning
sldgvarviewhelp.ini Configuration file to manage an html file or several html
files
<lng>/<name>1.html The contents of all html files of the online help are lan‐
<lng>/<name>2.html guage-dependent and are saved in the relevant language
directory <lng>.
. . .
<lng>/<name>n.html
Structure of the configuration file

The file is independent of any language and is structured as follows:
sldgvarviewhelp.ini
[HelpBindings]

sldgvarviewhelp.ini
/BAG/STATE/OPMODE = var1_help.html#var1
$AA_IM[X1] = var1_help.html
$R[1] = var1_help.html#var2
/Channel/Parameter/R[u1,1] = var2_help.html#var2
DB2.DBX180.0 = var2_help.html#var1
GUD/MyVar[2] = var2_help.html
Note
The html files can be generated with any html editor. A definition is provided in the configuration
file as to which html files belong to the online help.
The description can comprise one or several html files: For example, one html file for each
variable or several identical variables in one file.
Procedure:
1. Copy the configuration file to the following directory:
/oem/sinumerik/hmi/cfg/sldgvarviewhelp.ini
2. Copy the html files to one of the following directories:
/oem/sinumerik/hmi/hlp/<lng>/
/user/sinumerik/hmi/hlp/<lng>/
<lng> stands for the language code.
3. Delete all files in the directory:

/siemens/sinumerik/sys_cache/hmi//hlp
The settings become effective only after restarting the system.

18.8 Example: This is how you create a programming online help
Preconditions
Create the following files:
● Configuration file "prog_help.ini"
[milling]
CYCLE1=cycle1_help.html
CYCLE2=cycle2_help.html#TextAnchor1
[turning]
● Configuration file for the help book "slhlp.xml" (optional)

<!DOCTYPE CONFIGURATION>
<CONFIGURATION>
<OnlineHelpFiles>
<hmi_prog_help>
<EntriesFile value="hmi_prog_help.xml" type="QString"/>
<DisableIndex value="true" type="bool"/>
</hmi_prog_help>
</OnlineHelpFiles>
</CONFIGURATION>
● Configuration file for the help book "hmi_prog_help.xml" (optional)

<HMI_SL_HELP language="en-US">

<BOOK ref="index.html" title="OEM_CYCLES" helpdir="hmi_prog_help">

<ENTRY ref="cycle1_help.html" title="Cycle1"></ENTRY>
<ENTRY ref="cycle_help.html" title="OEM_Cycles"></ENTRY>
</BOOK>
</HMI_SL_HELP>
● Language-dependent file "<prog_help_eng>.ts": this filename is permanently specified.

<!DOCTYPE TS>
<TS>
<context>
<name>oem_cycles</name>
<message>
<source>CYCLE1</source>
<translation>short description for cycle 1</translation>
<chars>*</chars>
</message>
<message>
<chars>*</chars>
</message>
<message>
<chars>*</chars>
</message>
</context>
</TS>
Saving help files in the target system

Procedure:
1. Copy the configuration file "prog.ini" to the following directory:
2. Copy the file "slhlp.xml" to the help book in the following directory:

18.9 Help files in PDF format
3. Create a directory for the desired language of the online help under the following path: /
oem/sinumerik/hmi/hlp/<lng> and copy the hmi_prog_help.xml file there
Use the specified language code from the list of language codes for file names. The
directory names must be written in lower case.
4. Copy the language-dependent prog_help_<lng>.ts file for the Product Brief to the
following path: /oem/sinumerik/hmi/<lng>/prog_help_<lng>.ts
5. Copy the html files with the description of the OEM cycles to the following directory:
/oem/sinumerik/him/hlp/<lng>/hmi_prog_help/cycle<n>_help.html
The settings become effective only after restarting the system.

In addition to help files in HTML format, you can also include PDF-format information in the
operating software. Individual PDF helps can be opened with links from the table of contents
or index, or directly from HTML files.
Storing PDF helps

Copy the PDF helps to one of the following directories:
/oem/sinumerik/him/hlp/<lng>/<hmi_myhelp>
/user/sinumerik/him/hlp/<lng>/<hmi_myhelp>
Including PDF helps

Bind in dialog configurations or configurations of table of contents and indexes with the
extension "pdf" in the same manner as for the "html" extension:
<ENTRY ref="myFile.pdf" title="Help 1">
Create a link from HTML files to the PDF help:
<a href="myFile.pdf">My Help File</a>
Note
It is not possible to select context-sensitive jump labels in the PDF help, select jump labels or
make jumps to other HTML or PDF files.
The search function is possible only within a PDF file. A higher-level search over multiple PDF
helps is not supported.


SINUMERIK Integrate - AMB, AMC, AMM 19
Precondition
To start the "SINUMERIK Integrate - AMB, AMC, AMM" software, configure a softkey using a
display machine data. To do this you require, as a minimum, authorization for access level 3
(user).
Configuring a softkey
MD9108 $MM_SINUMERIK_INTEGRATE
=1 The "SINUMERIK integrate" softkey is displayed on the extended user interface bar.
References
Information on the software can be found in the following documentation:
Function Manual SINUMERIK Integrate - AMB, AMC, AMM

SINUMERIK Integrate - AMB, AMC, AMM

Safety Integrated 20
20.1 Displaying machine data and parameters
20.1.1 View of the axes

You can display the Safety Integrated axes in the "Machine Configuration" window.
Copying and confirming Safety Integrated data

You can copy and confirm Safety Integrated data.
Activating and deactivating the start-up of the Safety Integrated drives

You have the possibility of activating and deactivating Safety Integrated drives.
The Safety commissioning mode in the drives is activated.
For more detailed information, refer to
References
Function Manual, SINUMERIK Safety Integrated
Procedure
2. Press the menu forward key and the "Safety" softkey.

The "Machine Configuration Safety Axes" window opens.
All the safety axes are displayed.
3. Press the "All axes" softkey if you wish to display all of the axes.
The "All Axes Machine Configuration" window opens and the "All axes"
softkey changes into "Safety axes".
4. Press the "Safety axes" softkey in order to return to the view of the safety
axes.

Safety Integrated
See also
Copying and confirming Safety Integrated data (Page 451)
Activating/deactivating start-up mode (Page 452)
Displaying the Safety-Integrated settings (Page 453)
20.1.2 General machine data for Safety Integrated

The general machine data is listed in the "Selection of General MD" window and can be edited,
copied and confirmed.
Note
Changes as well as copying and confirming are effective for all axes and the general machine
data.
Screen view
The machine data display is split into two halves:
● In the upper part of the screen view, the machine data that are important for commissioning
are displayed; however, they do not involve Safety Integrated machine data.
● Safety Integrated machine data are displayed in the lower part of the screen view.
Changing the screen view
1. Press the "MD selection" to change into the full screen view.
The selection of general machine data is displayed over the complete
screen.
2. Press the "SI-MD" softkey.
The general safety integrated machine data are displayed over the full
screen.
3. Press the "SI + MD selection" softkey.
You return to the common view split in two of the general machine data
and the Safety Integrated machine data.

Safety Integrated
Searching for machine data
1. Press the "Search" softkey, enter the machine data number being
searched for in the window that opens or a character string that is being
searched for an press the "OK" softkey.
2. Press the "Continue search" softkey if the text position found does not
correspond to the required machine data.
3. Press the "Go to start" or "Go to end" softkey to set the cursor to the
beginning or to the end of the displayed data.
4. Press the "Search" softkey if you wish to change the search term.
20.1.3 Axis-specific machine data in Safety Integrated

The axis machine data is listed in the "Axis MD" window and can be changed.
Copying and confirming Safety Integrated data for certain axes

Select the desired axis using the "Axis +" or "Axis -" softkey for which the Safety Integrated
data is to be copied and confirmed.
Screen view
The machine data display is split into two halves:
● In the upper part of the screen view, the machine data that are important for commissioning
are displayed; however, they do not involve Safety Integrated machine data.
● Safety Integrated machine data are displayed in the lower part of the screen view.
Changing the screen view
1. Press the "MD selection" to change into the full screen view.
The selection of Axis MD is displayed over the complete screen.
2. Press the "SI-MD" softkey.
The Safety Integrated Axis MD are displayed over the complete screen.
3. Press the "SI + MD selection" softkey.
You return to the common view split in two of the general machine data
and the Safety Integrated machine data.

Safety Integrated
20.1.4 Drive machine data in Safety Integrated

The drive machine data is listed in the "Selection of Drive MD" window and can be changed.
Activating or deactivating the startup mode

Use the "Drive +" or "Drive -" softkey to select the drive that you want to switch to startup mode.

Safety Integrated
20.1.5 Copying and confirming Safety Integrated data

All the NC machine data relevant for the SI functions is transferred to the corresponding drive
parameters.
The SI machine data or drive parameters to define the encoder mounting arrangement must
be separately entered for the NCK and drive. These are not copied
Note
Certain NCK machine data is not copied into the drive parameters.
When confirming the data, the actual checksum is saved in the reference checksum.
Note
The data is saved for all safety axes.
Requirement
The "Machine configuration" window is open.
Procedure
Copying Safety Integrated data

1. Press the "Copy SI data" and "OK" softkeys. Safety-oriented NCK ma‐
chine data is copied into the drive parameters.
2. Press the "Axis MD" softkey and select an axis using the "Axis +" or "Axis
-" softkey if you wish to copy axis-specific machine data and safety data.
3 Press the "Reset (po)" and "OK" softkeys.

The control and the drives restart (warm restart).

Safety Integrated
Confirming Safety Integrated data

4. Press the "Confirm SI data" and "OK" softkeys.
The correctness of the values is confirmed and the current checksum
saved.
The drive data is saved automatically
20.1.6 Activating/deactivating start-up mode

For the start-up of the Safety Integrated drives, the drive parameter p0010 is switched to start-
up mode (p0010=95).
Value "0" is entered in drive parameter p0010 to exit the start-up mode. Beforehand, the CRC
in p9798 and p9898 are confirmed. The start-up state can be exited with or without saving.
At the same time, you can set the drive PROFIsafe address.
Procedure
3. Press the "Drive MD" softkey and select the desired drive using the "Drive
+" or "Drive -" softkey.
- OR -
...
Press the "View axes" softkey.
4. Press the "Activate dr. start-up" softkey.

A prompt is displayed.
5. Press the "OK" softkey to continue with the start-up.
A prompt is displayed whether you want to set the PROFISafe address
for the selected drive.
6. Press the "Yes" softkey.
Already existing settings of parameter p9810 are overwritten and the
drive parameter p0010 is switched to the start-up mode.
- OR -

Safety Integrated
Press the "No" softkey.

The existing settings of parameter p9810 are retained and the drive pa‐
rameter p0010 is switched to the start-up mode.
7. Press the "Deactivate dr. start-up" softkey.
20.1.7 Displaying the Safety-Integrated settings

The following configured values can be displayed in the "Safety Integrated Settings" window:
● Safe operating stop and safely limited speed (SBH/SG)
● Safe software end position for software limit switches (SE)
● Safe cams (SN)
You can use the softkeys to scroll between the Safety Integrated axes.
Procedure
2. Press the menu advance key and the "Safety" softkey.
3. Press the "View settings" softkey.

The "Safety Integrated Settings" window opens.
The configured limits for safe operating stop (SBH) and safely limited
speed (SG) are displayed.
4. Press the "Show safe limit pos." softkey if you wish to display the config‐
ured directions and limits of the software limit switches (SE).
5. Press the "Show Safe Cams" softkey if you wish to display the positions
and assignments of the safe cams (SN).
See also
View of the axes (Page 447)

Safety Integrated
20.2 Safety Integrated diagnostics
20.2.1 Status display for NCK Safety Integrated

The status display shows signals or values with NCK and drive information for a selected
axis.
Available signals
● Safe actual position
● Position deviation NCK/drive
● "Safe operating stop" monitoring active
● "Safe velocity" monitoring active
● Active SV step
● Active SV correction factor
● Safe actual velocity limit
● Set velocity limit
● Current velocity difference
● Maximum velocity difference
● Active safe software limit switch
● Active gear ratio (step)
● Active stop
● Currently requested external stop
● Stop F code value
● Pulses enabled
● Traversing inhibit, stop in other axis
Procedure
3. Press the "SI status" softkeys.

The "Safety Integrated Status (NCK)" window appears.

Safety Integrated

The values of the next or the previous axis are displayed.
... - OR -
Press the "Axis selection" softkey and select the desired axis directly from
the displayed list of available axes.
20.2.2 Display SGE/SGA signals

Safety-related inputs and outputs
SGE
Safe input signals, NCK Bit15...0
Safe input signals, drive Bit15...0
Safe input signals, NCK, Bit 16...31
Safe input signals, drive, Bit 16...31
SGA
Safe output signals, NCK Bit15...0
Safe output signals, drive Bit15...0
Safe output signals, NCK, Bit 16...31
Safe output signals, drive, Bit 16...31
Procedure
3. Press the "SGE/SGA" softkey to display the safety-related input and out‐
put signals.
The "Safety Integrated SGE/SGA" window appears.

Safety Integrated

- OR -
20.2.3 Display SPL signals

Safe programmable logic
Variables
$A_INSE (P) $A_INSE (P) - corresponds to simultaneous selection of:
$A_INSE (upper line, origin of the NCK) and
$A_INSEP (lower line, origin of the PLC)
$A_OUTSE (P) comp. $A_INSE (P)
$A_INSI (P) comp. $A_INSE (P)
$A_OUTSI (P) comp. $A_INSE (P)
$A_MARKERSI (P) comp. $A_INSE (P)
$A_PLCSIIN comp. $A_INSE (P)
$A_PLCSIOUT comp. $A_INSE (P)
Bit Selection of an 8-bit area of the selected signal.
Available signals/values
DCC fill level
DCC status
DCC control word
SPL booting state
SPL started up
SPL interfaces have been parameterized
SPL program file SAFE.SPL loaded
NCK and PLC state
Interrupt for PLC start should be assigned
Interrupt has been assigned for PLC start
Interrupt processing for SPL start called
Interrupt processing for SPL start terminated
SPL start implemented using PROG_EVENT mechanism
SPL started via AUTO start
SPL processing completed, end of program reached.

Safety Integrated
NCK data cross-checking (DCC) has been started

PLC data cross-checking has been started
Cyclic SPL checksum test active
All SPL protective mechanisms active
Procedure
3. Press the "SPL" softkey to display the safe programmable logic signals.
The "Safety Integrated SPL" window is opened
20.2.4 Displaying Safety Integrated checksums

You obtain the following information areas in the "SI Configuration" window:
● Overview of the settings of the Safety Integrated option
● Tables indicate the checksum for the actual Safety Integrated configuration.
Safety Integrated options

The overview of the Safety Integrated options includes the number of the Safety Integrated
axes configured as well as an overview of the active Safety Integrated options.
Safety Integrated checksum area

The following checksums are displayed for the overview of the Safety Integrated checksum
area:
● Checksum for the "SAFE.SPF" program
● General checksums
● Checksum for NCK and drive for each axis and the corresponding drive, for which the Safety
Integrated has been enabled.
You receive information about the time of the last change of the checksum in the NCK.

Safety Integrated
Procedure
3. Press the "SI checksum" softkey.

The "SI Configuration" window opens.
...
- OR -
20.2.5 Safety Integrated Basic Functions (Drive)
Supported functions
The following Safety Integrated functions (Safety Integrated Basic Functions) are available:
These functions are available in the standard drive version.
● Safe Torque Off (STO)
STO is a safety function that prevents the drive from restarting unexpectedly in accordance
with EN 60204-1.
● Safe Stop 1 (SS1, time controlled)
The SS1 function is based on the “Safe Torque Off” function. This means that a Category
1 stop in accordance with EN 60204-1 can be implemented.
● Safe Brake Control (SBC)
The SBC function permits the safe control of a holding brake.
Note
Safety Integrated Basic Functions
When a drive object that has Safety Integrated functions released is switched to "Parking"
state, the Safety Integrated software responds by activating STO without generating a
separate message.
For more detailed information about the functions, refer to:

Safety Integrated
References
Function Manual, SINUMERIK Safety Integrated
Procedure
3. Press the "SI status" softkey.

The "SI status" window is opened.
4. Press the "Display drive status" softkey to display the status of safe drives.
5. Press the "Drive +" or "Drive -" softkey.

The parameters are displayed for the next or previous drive object.
...
- OR -
6. Press the "Drive selection" softkey and in the drop-down list that appears,
directly select the desired drive object.
20.2.6 Safety Integrated fail-safe I/O
Fail-safe I/O modules ("fail-safe modules")

The "SI I/O" display provides a summary of the configuration and status of the PROFIsafe I/
O. The following signals are displayed:
● Fail-safe master address
● Parameterized PROFIsafe cycle time
● Maximum occurring PROFIsafe cycle time
● Modular PROFIsafe I/O interface
● Number of active I/O modules
● Number of passive I/O modules

Safety Integrated
Procedure
3. Press the "SI I/O" softkey.

The "SI I/O" window is opened and the status of the signals is displayed.
Press the "Fail-safe modules" softkey to display the status of the fail-safe
modules and their PROFIsafe address.
4. Press the "Details" softkey to display further information on this fail-safe
module.
20.2.7 Displaying cam signals

The signals of the cam SGA are displayed in the "Cam SGA" window.
Cam synchronization is executed between NCK and PLC at the cam SGA.
Procedure
2. Press the "Menu forward" key and then the "Safety" softkey.
3. Press the "Output cam SGA" softkey.

The "Cam SGA" window opens.

Safety Integrated

- OR -
20.2.8 Displaying SI communication data

Signals and values for the following communication data are displayed in the "SI
Communication (General)" window:
● Parameterized CPU-CPU communication clock cycle status
● Actual CPU-CPU communication clock cycle status
● Maximum CPU-CPU communication clock cycle
● Number of active send data connections (F_SENDDP)
● Number of active receive data connections (F_RECVDP)
Procedure
2. Press the "Menu forward" key and then the "Safety" softkey.
3. Press the "SI communication" softkey.
The "SI Communication (General)" window opens.
20.2.9 SI communication send connections

The configuration as well as the status of F_SENDDP are displayed in the SI communication
(send)" window.

Safety Integrated
Displayed signals
The following signals of the selected connection are displayed:
● CPU-CPU communication ID
● Logical base address
● Connection number
● Maximum parameterized communication time
● Actual communication time
● Maximum communication time
● Error reaction
Error reactions that can be set:
– [0] "Alarm 27350 + STOP D/E"
– [1] "Alarm 27350"
– [2] "Alarm 27351 (self clearing)"
– [3] "No reaction"
● Error
● Diagnostics error code
● Substitute values active
● Actual communication data
● Driver state
Status display:
– [0] "Not initialized"
– [1] "Establish communication after booting"
– [2] "Establish communication after error"
– [3] "Wait for checkback signals SN=1"
– [4] "Receiver waits for user acknowledgement"
– [5] "Normal operation"
Procedure
1. The "SI communication (general)" window with the communication data

is opened.
2. Press the "Send connection" softkey.
The "SI communication (send)" window is opened.
3. Press the "Connection +" or "Connection -" softkey to select the connec‐
tion whose data you wish to display.

Safety Integrated
4. Press the "Display SPL connection" softkey in order to display additional

details, e.g. connection data that has been set.
The softkey is only available if send connections have been configured.
5. Press the "Display connection" softkey to return to the window with the
send connections of the selected connection.
20.2.10 SI communication receive connections

The configuration as well as the status of F_ RECVDP are displayed in the SI communication
(receive)" window.
Displayed signals
The following signals of the selected connection are displayed:
● CPU-CPU communication ID
● Logical base address
● Connection number
● Maximum parameterized communication time
● Actual communication time
● Maximum communication time
● Error reaction
Error reactions that can be set:
– [0] "Alarm 27350 + STOP D/E"
– [1] "Alarm 27350"
– [2] "Alarm 27351 (self clearing)"
– [3] "No reaction"
● Error
● Diagnostics error code
● Substitute values active
● Substitute values
● Actual communication data
● Driver state
Status display:
– [0] "Not initialized"
– [1] "Establish communication after booting"
– [2] "Establish communication after error"
– [3] "Wait for checkback signals SN=1"
– [4] "Receiver waits for user acknowledgement"
– [5] "Normal operation"

Safety Integrated
● Request user acknowledgement

● Sender in the deactivated safety mode
Procedure
1. The "SI communication (general)" window with the communication data

is opened.
2. Press the "Receive connection" softkey.
The "SI communication (send)" window is opened.
3. Press the "Connection +" or "Connection -" softkey to select the connec‐
tion whose data you wish to display.
4. Press the "Display SPL connection " softkey to display additional details,
e.g. connection data that has been set.
The softkey is only available if send connections have been configured.
5. Press the "Display connection" softkey to return to the window with the
receive connections of the selected connection.

Configuring cycles 21
21.1 Activating turning/milling/drilling/grinding technologies
The cycles are automatically loaded when the controller boots (Power On).
The configuration is realized using cycle machine data and cycle setting data. In so doing, a
differentiation is made between the following data:
● General cycle machine data
● Channel-specific cycle machine data
● Axis-specific cycle machine data
● General cycle setting data
● Channel-specific cycle setting data
● Axis-specific cycle setting data
Requirement for memory configuration

To ensure that the cycles run correctly, the following standard setting must be checked:
MD28082 $MC_MM_SYSTEM_FRAME_MASK System frames (SRAM)

Bit 5 System frame for cycles
=1 Default setting
MD52201 $MCS_TECHNOLOGY_EXTENSION Technology extension for combined machines

with several technologies
=1 Additional settings for turning
=2 Additional settings for turning,
e.g. turnign machine with milling technology
MD52200 $MCS_TECHNOLOGY = 1
MD52201 $MCS_TECHNOLOGY_EXTENSION = 2
Note
Cylindrical and surface grinding are not supported as a technology extension by SINUMERIK
Operate.

Configuring cycles
Adapting the user interface

The softkey display for the selection of the cycle support in the program editor is set using the
following channel-specific configuration machine data:
MD52200 $MCS_TECHNOLOGY Technology

=1 Setting for turning
=2 Setting for milling
=3 Setting for the cylindrical grinding technology
=4 Setting for the surface grinding technology
References: Loops
For further information about the grinding technology, please refer to:
● Chapter "grinding (Page 515)"
● Operating Manual, Grinding
● Programming Manual, Production Planning; Chapter "Programming cycles externally" >
"Technological cycles":
– CYCLE495 - form-truing
– CYCLE4071 - CYCLE4074: Longitudinal grinding cycles
– CYCLE4075 - CYCLE4079: Surface grinding cycles
● Function Manual, Extended Functions; Compensations (K3),
Section: "Interpolatory compensation" > "Cylinder error compensation"
Configuring the screen display

The screen display can be configured using the following channel-specific machine data:

Bit 0 Dimension system for programs always in the basic system
Bit 1 Front view when turning in the school coordinate system
Bit 2 Hide "T,S,M" softkey in the JOG area
Bit 3 Generate end of program automatically in MDI (with "Delete blocks" softkey)
Bit 4 Display follow-on tool in the T,F,S window
Bit 5 Hide "MCS " softkey
Bit 6 Hide tool radius/diameter in the T,F,S window
Bit 7 Hide tool lengths in the T,F,S window
Bit 8 Hide tool icon in the T,F,S window
Bit 9 Display "Easy" input selection, see Section ""Easy" input in cycle support"
Bit 10 Do not offer channel in job lists
Bit 11 For WCS, activate the display of the logical spindles
Bit 12 Hide mold making view for G code

Configuring cycles
Setting the coordinate system
MD52000 $MCS_DISP_COORDINATE_SYSTEM Position of the coordinate system

=0 Default setting
With this machine data you adapt the position of the coordinate system of the user interface to the
coordinate system of the machine. In the user interface, all help screens, sequence graphics, simula‐
tions, and input fields with circle direction indication change automatically according to the selected
position.
The following settings can be selected for the coordinate system:
= < =
< <
;
; ;
; = < =
= ; = ;
< <
; <
; = < =
; = ;
= =
< <
< =
; < ;
; = ;
=
< < <
< ; = = ;
< ; < =
;
= = ;
=
< ; <
< = <
; ; =
= =
< ; <
;
= <
< = ; ;
;
=
;
< = <
< = <
= ; ;
;
;
< = = <
; < ; =
< <
= =
=
; < ;
; = ;
<
< =
=
= ; < < ;
; =
= < <
;
<
;
< = ; =
; = <
= ; <
<
< ;
= ; =

Configuring cycles
Meaning of the axes

=0 No special meaning
=1 Tool spindle (rotating tool)
=2 Auxiliary spindle (rotating tool)
=3 Main spindle (turning)
=4 Separate C axis of the main spindle (turning)
=5 Counterspindle (turning)
=6 Separate C axis of the counterspindle (turning)
=7 Linear axis of the counterspindle (turning)
=8 Tailstock (turning)
=9 Steady (turning)
= 10 B axis (turning)
= 12 B axis in counterspindle (turning)
= 13 Transverse travel X of the counterspindle (turning)
Defining the direction of rotation

Enter the direction of rotation for the rotary axes that are not configured in a tool holder or a 5-
axis transformation via the following channel-specific machine data.

Bit 0 Rotation around the 1st geometry axis (for rotary axes)
Bit 1 Rotation around the 2nd geometry axis (for rotary axes)
Bit 2 Rotation around the 3rd geometry axis (for rotary axes)
Bit 3 Direction of rotation is counter-clockwise (for rotary axis / C axis).
Bit 4 Displayed direction of rotation of the spindle/C axis for the M function M3 is counter-clockwise
Bit 5 Inverts M3 / M4 (for spindles)
This bit must be set analog to PLC bit DBnn.DBX17.6!
(nn = 31 + Machine axis index)
Bit 6 Display rotary axis as offset target for measurement
Bit 7 List rotary axis in the position pattern
Bit 8 List rotary axis to accept blank (on milling machines)
Bit 9 Spindle is not SPOS-capable
Bit 10 Rotary axis rotates around 1st geometry axis (only for position pattern)
Bit 11 Rotary axis rotates around 2nd geometry axis (only for position pattern)
Bit 12 Rotary axis rotates around 3rd geometry axis (only for position pattern)

Configuring cycles
"Easy" input in cycle support

You can influence the number of visible input parameters via MD52210
$MCS_FUNCTION_MASK_DISP with bit 9:
● All input parameters are displayed with the default setting bit 9 = 0 for "Complete".
● With the setting bit 9 = 1, you can select "Complete" or "Easy" input parameters in the cycle
support.
If you select the "Easy" input screen for input of the parameters, the values from the following
setting data are used for the invisible parameters (can be adapted machine-specifically):
SD55300 $SCS_EASY_SAFETY_CLEARANCE Easy input: Safety clearance

=1 mm
SD55301 $SCS_EASY_DWELL_TIME Easy input: Dwell time

= 0.6 s
SD55305 $SCS_EASY_DRILL_DEEP_FD1 Easy input: Percentage of 1st deep-hole drill‐

ing feedrate
= 90 %
SD55306 $SCS_EASY_DRILL_DEEP_DF Easy input: Percentage of deep-hole drilling

infeed
= 90 %
SD55307 $SCS_EASY_DRILL_DEEP_V1 Easy input: Min. deep-hole drilling depth infeed

= 1.2 mm
SD55308 $SCS_EASY_DRILL_DEEP_V2 Easy input: Deep-hole drilling retraction dis‐

tance
= 1.4 mm
SD55309 $SCS_EASY_THREAD_RETURN_DIST Easy input: Thread turning return distance

=2 mm
Note
The specified default values are valid for the metric system and are converted by the NC
automatically on the machine with the inch setting.

Configuring cycles
21.2 Technology cycles for drilling
Additional settings
MD52005 $MCS_DISP_PLANE_MILL Plane selection G17, G18, G19

=0 Milling: Plane selection in the cycle support when programming under "programGUIDE G
code"
= 17 G17 plane (default value)
= 18 G18 plane
= 19 G19 plane
MD52006 $MCS_DISP_PLANE_TURN Plane selection G17, G18, G19

= 18 G18 plane (permanently set)
MD52212 $MCS_FUNCTION_MASK_TECH Cross-technology function screen

Bit 0 Enable swivel
= 0 Swivel plane, swivel tool not enabled
= 1 Swivel plane, swivel tool enabled
Bit 1 No optimized travel along software limit switches
= 0 No optimized travel along software limit switches
= 1 Optimized travel along software limit switches
Bit 5 Call block search function for SERUPRO.
= 0 CYCLE207 is not called in the block search cycle PROG_EVENT.SPF.
= 1 The cycle for SERUPRO (CYCLE207) is called in the block search cycle
PROG_EVENT.SPF
MD52240 $MCS_NAME_TOOL_CHANGE_PROG Tool change program for G code steps

= Program name The associated program is called for tool change.
See also
Technology cycles for swiveling (Page 517)
Drilling technology
You can set drilling technology using the following channel-specific configuration machine data
and channel-specific cycle setting data.
MD52216 $MCS_FUNCTION_MASK_DRILL Drilling function screen form

Bit 0 Tapping cycle CYCLE84, technology input fields
= 0 Hide input fields
= 1 Display input fields

Configuring cycles
Bit 1 Tapping cycle CYCLE840, technology input fields

= 0 Hide input fields
= 1 Display input fields
SD55216 $SCS_FUNCTION_MASK_DRILL_SET Drilling function screen form

Bit 1 Boring CYCLE86: Take into account the rotation of the tool plane when positioning the
spindle
Note:
Spindle direction of rotation M3/ M4 and direction of rotation of the rotary axes must be set
according to DIN. For SPOS=0, the tool cutting edge points in the + direction of the 1st axis
of the plane (for G17, to X+).
= 0 Do not take into account the rotation of the tool plane when positioning the spindle (SPOS).
= 1 Take into account the rotation of the tool plane when positioning the spindle (SPOS).
Bit 2 Boring CYCLE86: When positioning the spindle, take into account swiveled table kinematics
(tool carrier)
= 0 When positioning the spindle, do not take into account the components of the swiveled table
kinematics (swiveling with CYCLE800, tool carrier).
Note:
Only the rotary axis of the machine kinematics that rotates the workpiece is taken into ac‐
count. In the initial state of the kinematics, this rotary axis must be orientated parallel to the
tool axis.
e.g. rotary axis C rotation around Z (for G17) rotary axis vector of the swivel data set V2xyz
= 0 , 0 , -1.
= 1 When positioning the spindle, take into account the components of the swiveled table kine‐
matics (swiveling with CYCLE800, tool carrier).
Bit 3 Tapping CYCLE84: Monitoring of the machine data MD31050 $MA_DRIVE_AX_RATIO_DE‐
NOM and MD31060 $MA_DRIVE_AX_RATIO_NUMERA of the spindle
Bit 4 Tapping CYCLE84, set monitoring of the machine data MD31050 $MA_DRIVE_AX_RA‐
TIO_DENOM and MD31060 $MA_DRIVE_AX_RATIO_NUMERA of the spindle
= 0 No monitoring
= 1 Monitoring
Bit 6 Boring CYCLE86: Adapt the spindle position to the tool orientation
Tool orientation can be realized using TOOLCARR or TRAORI before the cycle is called.
= 1 Bits 1 and 2 are no longer effective.
Bit 7 Boring CYCLE86: Adapt the direction of retraction travel in the plane to the active mirroring
= 0 Retraction in the plane is realized as programmed.
= 1 When mirroring is active, the direction when retracting in the plane is adapted in the cycle
to the active mirroring.

Configuring cycles
21.3 Manufacturer cycles
Tapping (CYCLE84 and CYCLE840)

If the technology screens are hidden using the channel-specific configuration machine data
MD52216 $MCS_FUNCTION_MASK_DRILL, then the settings in the following channel-
specific cycle setting data are effective:
SD55481 $SCS_DRILL_TAPPING_SET_GG12[0] Setting tapping G group 12:

Block change behavior for exact stop
=0 Exact stop response as before the cycle call (default value).
=1 G601
=2 G602
=3 G603

Acceleration behavior
=0 Acceleration behavior as before the cycle call (default value).
=1 SOFT
=2 BRISK
=3 DRIVE

Precontrol
=0 Precontrol, the same as before the cycle call (default value).
=1 FFWON
=2 FFWOF
Tapping (CYCLE84)
SD55484 $SCS_DRILL_TAPPING_SET_MC[0] Spindle operation for MCALL

=0 For MCALL, reactivate spindle operation (default value).
=1 For MCALL, remain in position controlled spindle operation.
21.3.1 Manufacturer cycles

The following cycles are also available in the cycle package for individual adaptation:
CUST_TECHCYC.SPF Manufacturer cycle for the adaptation of technology cycles.

CUST_800.SPF Manufacturer cycle for the adaptation of the swivel plane and the swivel
tool functions (CYCLE800), see Chapter "Manufacturer cycle
CUST_800.SPF (Page 548)".

Configuring cycles
CUST_832.SPF Manufacturer cycle for the adaptation of the high-speed settings function
(CYCLE832)", see Chapter Manufacturer cycle CUST_832.SPF
(Page 572)".
CUST_MEACYC.SPF Manufacturer cycle for the adaptation of the measuring functions, see
Chapter "Manufacturer and user cycle CUST_MEACYC.SPF
(Page 578)".
CUST_MEAPROT.SPF Manufacturer cycle and user cycle for the adaptation of the log form and
content, see Chapter "Manufacturer and user cycle CUST_MEAP‐
ROT.SPF (Page 606)".
PROG_EVENT.SPF Standard cycle to support the following functions:
● Block search when milling or turning is activated
● Block search and swivel plane
● Block search and align / advance tool
Observe MD52212 $MCS_FUNCTION_MASK_TECH bit 3 and bit 5.
CUST_T Cycle is used to track the T preparation after SERUPRO.
CUST_M6 Cycle is used to track the tool change after SERUPRO.
CUST_MULTICHAN Manufacturer cycle for lathes with several channels
CUST_CLAMP Manufacturer's cycle for clamping elements
Copying manufacturer cycles

Copy the cycle from the NC data/Cycles/Standard cycles directory to the NC data/Cycles/User
cycles directory before making any changes. Changes for the cycle take effect only in this
directory.
3. Open the directory NC data/Cycles/Standard cycles and select the man‐

ufacturer cycles.
4. Press the "Copy" softkey and open the NC data/Cycles/Manufacturer cy‐
cles directory.
5. Press the "Paste" softkey.
The cycles are available for you to individually adapt them.
Note
When upgrading the software, please refer to the upgrade instructions.

Configuring cycles
21.3.2 Prerequisites for the simulation mode
Configuration
If you use feedback signals regarding the machine state, e.g. in CYCPE1MA, for tool change
cycles, measuring cycles or CUST_800, then in the NC program you must link in the following
system variables in order to avoid PLC access. Otherwise, PLC access prevents data
alignment, results in alarms or the simulation being canceled:
System variable Meaning

$P_SIM NCK simulation active
Example
In the following example, the simulation mode in PROG_EVENT or CYCPE1MA.SPF is
stopped by the PLC access:
N100 REPEAT
N110 UNTIL PLC_VAR <> 0
If you use the system variable $P_SIM, then PLC access in the simulation mode is prevented:
N099 IF NOT $P_SIM
N100 REPEAT
N110 UNTIL PLC_VAR <> 0
N111 ENDIF
21.3.3 Extending the PROG_EVENT standard cycle

If you wish to extend the functionality of the PROG_EVENT, then you must not copy this into
the manufacturer cycles directory, but you must create two new manufacturer cycles. Use the
names CYCPE1MA.SPF or CYCPE_MA.SPF names for the manufacturer cycles.
For the manufacturer cycles CYCPE1MA.SPF or CYCPE_MA.SPF, the corresponding
jump markers are prepared at the beginning and at the end of PROG_EVENT.SPF.
If the CYCPE1MA.SPF and CYCPE_MA.SPF manufacturer cycles are created in the NC, the
program correspondingly branches from PROG_EVENT to the manufacturer cycles.
Procedure

Configuring cycles
3. Select the directory /NC data/Cycles/Manufacturer cycles

4. Press the "New" softkey.
The "New G Code Program" window opens.
5. Assign the name CYCPE1MA or CYCPE_MA.
Only use these names.
6 Press the "OK" softkey.
The cycle has been created and you can now adapt it.
21.3.4 Manufacturer cycle for tool change CUST_T and CUST_M6
Function
The two cycles are used to track the T preparation (CUST_T) and the tool change (CUST_M6)
according to SERUPRO. In so doing, depending on the specific tool holder, the following is
output:
● Last programmed change
● Last programmed preparation
Precondition
The cycles can only be used when tool management is active.
Sequence
The two cycles are called in the "SERUPRO-END-ASUB", which also provides the two transfer
parameters.
Parameter Meaning
_THnr Tool holder or master spindle number that was programmed for the change or the
preparation.
_MTHnr Number of the active tool holder or master spindle at the time of programming.
The cycles themselves do not contain and "machine logic". Pure data operations are performed.
The active tool holder or the master spindle is saved.
Using the transfer parameter, the situation at the time of the T or M6 programming is
determined. This situation is established, T and/or M06 output or a branch is made into the
manufacturer cycles. After the output of T and M06 or after returning from the manufacturer
cycles, the tool holder, saved at the beginning, is reactivated.
A change cycle can then only be called without any restriction, if the corresponding queries
such as program test, block search,...exist.

Configuring cycles
T replacement cycle
If a T replacement cycle is being used, then the following note must be observed:
Note
The CUST_T cycle uses the language command TCA (ToolChangeAbsolut) for the T call and
therefore also has the possibility of inserting tools that have been disabled. However, this
language command cannot be substituted.
The following must be observed if working at a machine with T replacement:
● The T preparation cycle must be explicitly called at the specified position.
● If the call is realized using the CUST_T cycle, then the parameter evaluation
($C_TS_PROG, …) is skipped.
Alternatively, the original TCA language command can be reprogrammed.
Further information is available in the following document:
References
Function Manual Basic Functions; Auxiliary function outputs to PLC (H2),
Section: "Behavior during block search" > "ASUB at the end of the SERUPRO"
21.3.5 CUST_TECHCYC.SPF manufacturer cycle
Function
For technological cycles, the CUST_TECHCYC cycle is called from ShopMill and ShopTurn
cycles, if the machine builder must make certain adaptations to a specific machine (e.g.
activate specific M commands). For instance, this may be necessary in order to retract or
extend part catchers when cutting off parts on lathes or to position a spindle for clamping (only
in JobShop).
The CUST_TECHCYC.SPF cycle can be used to program and execute the necessary
sequences.

Configuring cycles
Adapt manufacturer cycle CUST_TECHCYC.SPF

You can execute the following actions with the aid of the _MODE parameter:
Marker Action
_M1 Main spindle: Changeover to C axis mode
_M2 Changeover to spindle mode
_M3 Clamp C axis
_M4 Release C axis clamping
_M5 Rinse chuck
_M6 Close chuck
_M7 Open chuck when spindle is stationary
_M8 Open chuck when spindle is rotating
_M9 Flush chuck
_M11 Tool spindle: Changeover to C axis mode

_M13 Clamp C axis
_M21 Counterspindle: Changeover to C axis mode

_M23 Clamp C axis
_M25 Rinse chuck
_M26 Close chuck
_M27 Open chuck when spindle is stationary
_M28 Open chuck when spindle is rotating
_M29 Rinse chuck off
_M30 4. Position axis after block search (e.g. counterspindle, tailstock, back rest)
_M41 Engage driven tool

_M42 Disengage driven tool
_M61 Changeover to turning

_M62 Changeover to peripheral surface machining C
_M63 Changeover to face machining C
_M64 Changeover to peripheral surface machining Y
_M65 Changeover to face machining Y
_M66 Changeover to face machining B (swivel)
_M67 Deselection of the face machining B (swivel)
_M68 After block search to ST block before swivel

Configuring cycles
Marker Action
_M100 Drawer: Position before cut-off
_M101 Open during cut-off
_M102 Close after cut-off
_M103 Cut-off completed
_M110 Tool change

_M111 After end of tool change cycle (with tool change)
_M112 Before tool change on retraction plane
_M113 Before cutting edge reselection
_M114 After end of tool change cycle (without tool change)
_M115 After tool preselection (ShopTurn)
_M116 At tool change point (ShopTurn)
_M117 Before tool change T command
_M120 Definition: Coupling of counterspindle / main spindle

_M121 After COUPOF switch off position control
_M122 Definition: Coupling, main/counterspindle
_M123 After COUPOF switch off position control
_M125 Changeover to main spindle
_M126 Changeover to counterspindle
_M131 Start of program (ShopTurn program)

_M132 End of program header (ShopTurn program)
_M135 End of program loop (ShopTurn program)
_M136 End of program (ShopTurn program)
_M140 Block search Before tool change

_M141 After tool change
_M142 After tool change (new tool from ShopTurn)
_M150 2-channel stock remov‐ Leading channel before Balance Cutting

_M151 al: Leading channel after Balance Cutting
_M152 Following channel before Balance Cutting
_M153 Following channel after Balance Cutting
_M154 Start machining in the leading channel
_M155 End machining in the leading channel
_M156 Start machining in the following channel
_M157 Start machining in the following channel
_M160 Start multichannel programming

_M170 Start block with spindle
_M171 End block with spindle

Configuring cycles
21.4 Milling
Marker Action
_M231 Start of program (ShopMill program)
_M232 End of program header (ShopMill program)
_M235 End of program loop (ShopMill program)
_M236 End of program (ShopMill program)
_M300 Boring CYCLE86

Adapt the spindle to the tool position (SD55216 $SCS_FUNCTION_MASK_DRILL_SET
bit 6 = 1)
21.3.6 CUST_MULTICHAN user cycle
Function
The CUST_MULTICHAN cycle is used for multi-channel programming at lathes. It is called at
the start of the block when programming with blocks.
In the cycle, e.g. the master spindle is set to the spindle specified at the start of the block. The
return value (= 1) can be used to control whether the complete block is skipped.
CUST_MULTICHAN
Parameter Meaning
_S_NR Spindle number to which the master spindle is set.
_RET Return value
=0 The block is executed corresponding to the run-in mode.
= 1 The entire block is skipped.
21.4 Milling
21.4.1 General
All settings for machine and setting data of the standard cycles are also applicable for milling
under ShopMill and turning under ShopTurn.

Configuring cycles
21.4 Milling
21.4.2 Technology cycles for milling
Milling function screen
SD52214 $SCS_function_MASK_MILL Milling function screen

Bit 0 Enable cylinder surface transformation (ShopMill)
Bit 1 List table to accept blank (on milling machines)
(This bit only has to be set, if the machine has a rotary axis and a fixed table for accepting the
blank.)
Bit 2 reserved
Bit 3 Enable machining inside/outside
Bit 4 Enable spindle clamping (C axis)
Bit 5 Enable spindle control of the tool spindle via user interface
Bit 6 Enable spindle control of the main spindle via user interface
SD55214 $SCS_FUNCTION_MASK_MILL_SET Milling function screen

Bit 0 Basic setting, milling in climbing.
Bit 2 Depth calculation of the milling cycles, with or without safety clearance.
= 0 Depth calculation of the milling cycles is performed between the reference plane + safety
clearance and the depth.
= 1 Depth calculation is performed without including the safety clearance.
Bit 2 is effective in the following milling cycles: CYCLE61, CYCLE71, CYCLE76, CYCLE77,
CYCLE79, CYCLE899, LONGHOLE, SLOT1, SLOT2, POCKET3, POCKET4.
Contour milling (CYCLE63, CYCLE64)
SD55460 $SCS_MILL_CONT_INITIAL_RAD_FIN Finishing approach circle radius

The radius of the approach circle during the
finishing of contour pockets is affected.
=0 The radius is selected so that at the starting point the safety clearance to the finishing allow‐
ance is maintained (default value).
>0 The radius is selected so that at the starting point the value of this channel-specific setting
data to the finishing allowance is maintained.
SD55212 $SCS_FUNCTION_MASK_TECH_SET General function screen for all technologies

=6
Bit 3 Delete programs generated by contour cycles (CYCLE63, CYCLE64, CYCLE952)
= 0 Generated programs are not deleted (compatibility as before)
= 1 Generated programs are deleted as soon as they have been executed by the calling cycle.

Configuring cycles
21.4 Milling
Engraving (CYCLE60)
SD55400 $SCS_MILL_ENGRAVE_POINT_RAD Engraving cycle CYCLE60: Circular arc ra‐

dius for generating the "dot" character
=0
= 0 The "dot" character is produced by a simple linear insertion movement of the tool (default
setting for conventional engraving tools, compatibility).
> 0 The "dot" character is executed as a circle with the radius value from this setting data (setting
for some special tools).
Multiple edge (CYCLE79), circular position pattern (HOLES2), circumferential groove (SLOT2)
SD55230 $SCS_CIRCLE_RAPID_FEED Rapid feed in mm/min for positioning on a circular path

between the circumferential grooves or the contour
elements.
= 10000
21.4.3 Setting-up ShopMill cycles for milling
Load ShopMill cycles for milling

When the control boots, the ShopMill cycles are automatically loaded into the following
directory: ../siemens/sinumerik/cycles/sm/prog

=0
Examples:
=0 for vertical milling machines
=16 for horizontal milling machines, boring mill
A detailed description of the MD52000 is provided in Section:
Activating turning/milling/drilling/grinding technologies (Page 465)
For plane selection when milling, appropriately set the following machine data:
MD52005 $MCS_DISP_PLANE_MILL Plane selection for milling

= 17
=0 In the cycle support
= 17 G17 (default value)
= 18 G18
= 19 G19

Configuring cycles
21.4 Milling

In order that simulation and simultaneous recording are displayed without any errors, set the
machine data as described in the following section:
Setting the technology for simulation (Page 107)

In order that the direction of rotation is correctly displayed in the ShopMill user interface, and
when programming ShopMill functions, the correct direction of rotation is executed, you must
make some settings that are coordinated with one another. You must align these settings to
the actual direction of rotation of the axis at the machine.

Bit 4 Displayed direction of rotation for M3 is counter-clockwise (for spindles)
Bit 5 Direction of rotation M3 corresponds to rotary axis minus (for spindles)
This bit must be set analog to PLC bit DBnn.DBX17.6!
Additional channel-specific machine data
MD52216 $MCS_FUNCTION_MASK_DRILL Drilling function screen form

Bit 2 Tapping also without encoder
The setting depends on whether at the machine the tool spindle is equipped with an encoder.
= 0 Tapping only possible with encoder
= 1 Tapping also possible without encoder
Bit 3 Constant cutting speed referred to the diameter of the centering
= 0 Constant cutting speed referred to the diameter of the tool
= 1 Constant cutting speed referred to the diameter of the centering
MD52229 $MCS_ENABLE_QUICK_M_CODES Enable fast M commands

=0
Bit 0 Coolant OFF (default value)
Bit 1 Coolant 1 ON
Bit 2 Coolant 2 ON
Bit 3 Coolants 1 and 2 ON
MD52230 $MCS_M_CODE_ALL_COOLANTS_OFF M code for all coolants Off

=9 You define the M function to switch off the coolant that is output when the tool is changed.
MD52231 $MCS_M_CODE_COOLANT_1_ON M code for coolant 1 On

=8 You define the M function for coolant 1 that is output when the tool is changed.

Configuring cycles
21.4 Milling
MD52232 $MCS_M_CODE_COOLANT_2_ON M code for coolant 2 On

=7 You define the M function for coolant 2 that is output when the tool is changed.
MD52233 $MCS_M_CODE_COOLANT_1_AND_2_ON M code for both coolants On

= -1 You define the M function for coolant 1 and 2 that is output when the tool is changed.
MD52281 $MCS_TOOL_MCODE_FUNC_ON[ ] M code for tool-specific function ON

= -1 M function is not output.
If both M commands of a function "= -1", the corresponding field is not displayed on the
interface.
[0] M code for tool-specific function 1 ON
MD52282 $MCS_TOOL_MCODE_FUNC_OFF[ ] M code for tool-specific function OFF

= -1 M function is output.
If both M commands of a function "= -1", the corresponding field is displayed on the interface.
[0] M code for tool-specific function 1 OFF
Channel-specific cycle setting data
SD55212 $SCS_FUNCTION_MASK_TECH_SET Cross-technology function screen

=6
Bit 0 Tool preselection active.
The next tool is prepared directly after a tool change.
Note: For a revolver, the setting data must be set to "0".
Bit 1 Automatic calculation of the thread depth for metric threads.
Bit 2 Take the thread diameter and thread depth from the table.
21.4.4 Cylinder surface transformation (TRACYL)
Software option
"Transmit and peripheral surface transformation".

Configuring cycles
21.4 Milling
Precondition
● There must be at least one rotary axis at the machine.
● The milling tool must be radially oriented to the cylinder to be machined.
Function
The following groove machining operations can be performed with the Cylinder surface
transformation functions:
● Longitudinal grooves on cylindrical bodies
● Transverse grooves on cylindrical objects
● Grooves with any path on cylindrical bodies
The path of the grooves is programmed with reference to the unwrapped, level surface of the
cylinder. Programming can be realized using straight line/circle, drilling or milling cycles or
contour milling (free contour programming).
There are two variants of cylinder surface transformation, i.e.
1. with groove side offset (ON)
2. without groove side offset (OFF)
/RQJLWXGLQDOJURRYH 7UDQVYHUVHJURRYH /RQJLWXGLQDOJURRYHZLWKSDUDOOHOOLPLWDWLRQ

:LWKRXWJURRYHVLGHRIIVHW :LWKJURRYHVLGHRIIVHW
Figure 21-1 Grooves with and without groove side offset
21.4.5 Example: Milling machine with the XYZ-AC axis configuration
Example: Milling machine with the XYZ-AC axis configuration

Example of an axis configuration on the following machine:

Configuring cycles
21.4 Milling
Axis configuration
&
=
<
X 1st axis of the machining plane parallel to the rotary axis

Y 2nd axis of the machining plane
Z Infeed axis (tool axis) perpendicular (radial) to the rotary axis
A Rotary axis
C Working spindle
Figure 21-2 Machining slots on a cylinder surface with X-A-Z kinematics
You must configure two data sets with the following machine data for the machine illustrated
above:
MD20070 $MC_AXCONF_MACHAX_USED[4] Machine axis number valid in channel

=5 Number of channel axes
MD20080 $MC_AXCONF_CHANAX_NAME_TAB[ ] Name of channel axis in the channel

[0] = XC Channel axis XC, corresponds to channel axis 1
[1] = YC Channel axis YC, corresponds to channel axis 2
[2] = ZC Channel axis ZC, corresponds to channel axis 3
[3] = A Channel axis A, corresponds to channel axis 4
[4] = C Channel axis C, corresponds to channel axis 5
MD28082 $MC_MM_SYSTEMFRAME_MASK System frames (SRAM)

= 21H Default setting
Bit 0 = 1 System frame for actual value setting and scratching
Bit 5 = 1 System frame for cycles
Bit 6 = 1 System frame for transformations

Configuring cycles
21.4 Milling
General settings for the transformation
MD10602 $MN_FRAME_GEOAX_CHANGE_MODE Frames when switching over geometry

screens
=1 The actual total frame (zero offsets) is recalculated when switching over geometry axes (se‐
lecting - deselecting TRACYL).
Data set for the 1st transformation in the channel
MD24100 $MC_TRAFO_TYPE_1 Definition of transformation 1 in the chan‐

nel.
= 512 Transformer type (512 = cylinder surface transformation without groove side offset)
MD24110 $MC_TRAFO_AXES_IN_1 Axis assignment for the 1st transforma‐

tion in the channel
[0] = 3 Channel axis: Infeed axis (tool axis) perpendicular (radial) to the rotary axis Z
[1] = 4 Channel axis: Rotary axis A
[2] = 1 Channel axis: 1st axis of the machining plane parallel to the rotary axis X
[3] = 2 Channel axis: 2nd axis of the machining plane Y
MD24120 $MC_TRAFO_GEOAX_ASSIGN_TAB_1 Assignment of the geometry axes to chan‐

nel axes for transformation 1.
[0] = 1 Channel axis: 1st geometry axis X
[1] = 4 Channel axis: 2nd geometry axis A
[2] = 3 Channel axis: 3rd geometry axis Z
MD24800 $MC_TRACYL_ROT_AX_OFFSET_1
=0 Offset of rotary axis for the 1st TRACYL transformation.
MD24805 $MC_TRACYL_ROT_AX_FRAME_1
=1 Axial offset of rotary axis for the 1st TRACYL transformation.
MD24810 $MC_TRACYL_ROT_SIGN_IS_PLUS_1
=1 Sign of the rotary axis for the 1st TRACYL transformation.
MD24820 $MC_TRACYL_BASE_TOOL_1[ ]
[0] = 0 Vector of the base tool for the 1st TRANSMIT transformation in XYZ
[1] = 0
[2] = 0

Configuring cycles
21.4 Milling
Data set for the 2nd transformation in the channel
MD24200 $MC_TRAFO_TYPE_2
= 513 Transformer type (513 = cylinder surface transformation with groove side offset)
MD24210 $MC_TRAFO_AXES_IN_2
[0] = 3 Channel axis: Infeed axis perpendicular (radial) to rotary axis Z
[1] = 4 Channel axis: Rotary axis A
[2] = 1 Channel axis: 1st axis of the machining plane parallel to the rotary axis X
[3] = 2 Channel axis: 2nd axis of the machining plane Y
MD24220 $MC_TRAFO_GEOAX_ASSIGN_TAB_2
[0] = 1 Channel axis: 1st geometry axis X
[1] = 4 Channel axis: 2nd geometry axis A
[2] = 3 Channel axis: 3rd geometry axis Z
MD24850 $MC_TRACYL_ROT_AX_OFFSET_2
=0 Offset of the rotary axis for the 2nd TRACYL transformation
MD24855 $MC_TRACYL_ROT_SIGN_IS_FRAME_2
=1 Axial offset for the 2nd TRACYL transformation
MD24860 $MC_TRACYL_ROT_SIGN_IS_PLUS_2
=1 Sign of the rotary axis for the 2nd TRACYL transformation
MD24870 $MC_TRACYL_BASE_TOOL[ ]
[0] = 0 Vector of the base tool for the 2nd TRACYL transformation in XYZ
[1] = 0
[2] = 0
Note
Data sets for transformations
For both data sets, you can use any transformations from all available transformations
(MD24100 $MC_TRAFO_TYPE_1, MD24200 $MC_TRAFO_TYPE_2, etc.). The two data sets
need not be directly next to each other.
However, the 1st data set must always be used for "Cylinder surface transformation without
groove side offset" (= 512) and the 2nd data set for "Cylinder surface transformation with
groove side offset" (=513).

Configuring cycles
21.4 Milling
21.4.6 ShopMill cycles for multiple clamping
Software options
You require the following software option in order to use this function: "ShopMill/
ShopTurn"
Function
The Multiple clamping function provides optimized tool change over several workpiece
clampings. On the one hand, this reduces downtimes and, on the other, eliminates tool change
times because a tool performs as many machining operations as possible in all clampings
before the next tool change is initiated.
You can either execute the same program several times for the clampings or you can select
different programs. If you are using large-area fixture plates on your machine, you do not have
to set up anything else.
In the case of rotating clamping devices, on the other hand, you must adapt a cycle to match
the features of the clamping device so as to ensure that the next workpiece can be turned to
the machining position after machining of the previous one (or for multiple clamping devices
even while the current workpiece is being machined).
Procedure for setting up

1. Change the CLAMP.SPF cycle which is stored in the cycle/sc/prog/templates_deu or cycle/
sc/prog/templates_eng directory.
2. Copy the cycle into the user or manufacturer directory.
Example
A rotating clamping device (reversible clamping device) is used with four clampings. The
respective clampings can be machined by positioning rotary axis A:
Clamping 1: A = 0°
Clamping 2: A = 90°

Configuring cycles
21.4 Milling
<
&ODPSLQJ
&ODPSLQJ &ODPSLQJ
5RWDU\D[LV$
&ODPSLQJ
0DFKLQHWDEOH
Figure 21-3 Rotating clamping device (reversible clamping device)
The cycle CLAMP.SPF must be adapted as follows:

...
DEF INT _NV ; Auxiliary variable
;––––––––––––––––––––––––––––––––––––
;Adaptation
;
IF _ACT==1
G0 A=DC(0)
ENDIF
;
IF _ACT==2
G0 A=DC(90)
ENDIF
;
IF _ACT==3
G0 A=DC(180)
ENDIF
;
IF _ACT==4
G0 A=DC(270)

Configuring cycles
21.5 Turning
ENDIF
;
;––––––––––––––––––––––––––––––––––––
_NV=_NPV+_ACT ; Calculate current zero offset
N10 G[8]=_NV ; There must not be a calculation here
RET
21.5 Turning
21.5.1 General
All settings for machine and setting data of the standard cycles are also applicable for milling
under ShopMill and turning under ShopTurn.
21.5.2 Setting up cycles for turning

=0 Default setting
Examples:
0: Vertical turning machine (carousel-type turning machine)
19: Horizontal turning machine, machining in front of the turning center
34: Horizontal turning machine, machining behind the turning center (inclined bed turning
machine)
A detailed description of MD52000 is given in Section: "Activating turning/milling/drilling/
grinding technologies (Page 465)."
Turning function screen

Enable various functions under the Turning function screen in the following channel-specific
configuration machine data.

Bit 0 Enable zoom under manual for tool measurement
Bit 1 Enable part catcher for cut-off
Bit 2 Enable tailstock
Bit 3 Enable spindle control of main spindle via user interface

Configuring cycles
21.5 Turning
Bit 4 Enable spindle control of the counterspindle control via user interface
Bit 6 Enable balance cutting for two-channel stock removal
Bit 7 Retraction when cutting along the contour with G1
Bit 8 Enter the spindle chuck data in the program
Bit 9 Additional input of the tailstock data in the program
Bit 10 Enable crowned thread
Bit 12 Deactivate thread synchronization
Bit 13 Cutting along the contour with CYCLE95 (828D programGUIDE without Advanced Tech‐
nology
Meaning of the axes

You set the meaning of the axes in machine data MD52206 $MCS_AXIS_USAGE[n].

A detailed description of MD52206 is provided in Chapter "Activating turning/milling/drilling/

grinding technologies (Page 465)
Traversing direction
In order that the user interface and cycles know in which direction the spindles and rotary axes
rotate, the following settings must be made.
You set the direction of rotation of an NC rotary axis via MD32100 $MA_AX_MOTION_DIR.
MD32100 $MA_AX_MOTION_DIR Traversing direction

-1 Direction reversal
0, 1 No direction reversal

In order to ensure that the direction of rotation of the spindle and C axis is correctly displayed
on the user interface and when programming, the correct direction of rotation is executed, you
must make several settings that are coordinated with one another. You must base these
settings on the actual direction of rotation of the spindle/C axis on the machine.
You specify the settings in the following machine data:

Bit 3 Displayed positive direction of rotation is counter-clockwise (for rotary axes)
The view must be from the inside of the machine (operator's view) to the axis of rotation.
This bit can be set from the operator's view or according to DIN 66025.
Bit 5 Direction of rotation for M3 corresponds to minus rotary axis (for spindles)
This bit must be set analogous to PLC bit DBn.DBX17.6!

Configuring cycles
21.5 Turning
As a result, the following setting options are obtained for the main spindle:
Main spindle direction of rotation 52207[n] 52207[n] 52207[n] DB3n.

bit 3 = bit 4 = *) bit 5 = DBX17.6
0 0 0 0
0
&
0 1 1 1
0
&
1 1 0 0
& 0
1 0 1 1
& 0
Note
MD52207[n] bit 4 = *)
Bit 4 can be set from the operator's view (values as specified) or according to DIN ("0" and "1"
are then interchanged).
Dimensions
To define the reference point for moving the counterspindle, you must first communicate the
dimensions of the counterspindle. You can either enter the dimensions in the following axis-
specific cycle machine data or in the menu "Parameter" -> Setting data -> Spindle chuck data".
Changes to the machine data are automatically accepted in the menu and vice versa.
MD53240 $MAS_SPINDLE_PARAMETER[ ] Spindle chuck data

[0] Chuck dimensions

Configuring cycles
21.5 Turning
[1] Stop dimensions

[2] Jaw dimensions
MD53241 $MAS_SPINDLE_CHUCK_TYPE[ ] Spindle jaw type

=0 Clamping, outer
=1 Clamping, inner
Additional settings
The M code, e.g. M34 or M1 = 34 for the spindle chuck is defined in the following machine
data. The manufacturer cycle CUST_TECHCYC.SPF also takes the M functions from the
following machine data:
MD52250 $MCS_M_CODE_CHUCK_OPEN[ ] M code for open chuck with station‐

ary spindle
[0] Main spindle
[1] Counterspindle
MD52251 $MCS_M_CODE_CHUCK_CLOSE_OPEN_ROT[ ] M code for open chuck with spindle

rotating
[0] Main spindle
[1] Counterspindle
MD52252 $MCS_M_CODE_CHUCK_CLOSE[ ] M code for close chuck

[0] Main spindle
[1] Counterspindle
MD52253 $MCS_M_CODE_TAILSTOCK_FORWARD[ ] M code for quill forward

[0] Quill opposite the main spindle
[1]
MD52254 $MCS_M_TAILSTOCK_BACKWARD[ ] M code for quill back

Contour turning (CYCLE952)
SD55212 $SCS_FUNCTION_MASK_TECH_SET General function screen for all technologies

=6
Bit 3 Delete programs generated by contour cycles (CYCLE63, CYCLE64, CYCLE952)
= 0 Generated programs are not deleted (compatibility as before)
= 1 Generated programs are deleted as soon as they have been executed by the calling cycle.

Configuring cycles
21.5 Turning
Rounding the contour
SD55582 $SCS_TURN_CONT_TRACE_ANGLE Contour turning: Minimum angle for

rounding the contour
=5 Specifies the angle between the cutting edge and contour, above which for contour turning,
the contour is rounded in order to remove residual material (default value).
21.5.3 Setting-up ShopTurn cycles for turning

Bit 0 = 1 Dimension system for programs always in the basic system (default setting)
Bit 1 = 1 Face view when turning (default setting)
Bit 4 = 1 Display follow-on tool in the T,F,S window

Bit 2 Approach logic for stepped drill
Bit 3 Block search cycle for ShopMill / ShopTurn
= 0 The E__ASUP or F_S_ASUP cycles are not called in the block search cycle
PROG_EVENT.SPF
= 1 The E__ASUP (under ShopMill) or F_S_ASUP (under ShopTurn) cycles are called in the
block search cycle PROG_EVENT.SPF
Bit 4 Approach logic using the cycle
Bit 5 The cycle for SERUPRO (CYCLE207) is called in the block search cycle
PROG_EVENT.SPF.
Bit 3 has no effect when bit 5 is set.
Bit 6 Work offset value WO cannot be entered
Bit 7 Identification of the end of tool lives in the program (ShopMill / ShopTurn)
Bit 8 Manual machine (ShopMill/ShopTurn)
Bit 9 Selection/deselection of the work offset using softkey
Bit 11 Deactivate position check for drilling and milling tools

Bit 3 "Inner/rear" machining is enabled in the ShopTurn screens which themselves define the
machining plane.
Bit 4 If you have implemented the "Clamp/release spindle" function using the manufacturer
cycle CUST_TECHCYC.SPF, then using this machine data, you can activate the "Clamp/
release spindle" parameter in the drilling and milling screens.
= 0 The "Clamp/release spindle" parameter is not displayed in the drilling and milling screens.
ShopTurn automatically clamps the spindle if it makes sense for the particular machining
operation.
= 1 The "Clamp/release spindle" parameter is displayed in the drilling and milling screens.
You decide for which machining operation the spindle should be clamped.

Configuring cycles
21.5 Turning
MD52216 $MCS_FUNCTION_MASK_DRILL Drilling function screen

Bit 3 Constant cutting speed referred to the diameter of the centering
= 0 Constant cutting speed referred to the diameter of the tool
= 1 Constant cutting speed referred to the diameter of the centering

Bit 2 Enable tailstock
Bit 6 Enable Balance Cutting for two-channel stock removal
MD52229 $MCS_ENABLE_QUICK_M_CODES Enable fast M commands

=0
Bit 0 Coolant OFF
Bit 1 Coolant 1 ON
Bit 2 Coolant 2 ON
Bit 3 Coolants 1 and 2 ON
MD52230 $MCS_M_CODE_ALL_COOLANTS_OFF M code for all coolants off

=9 This machine data is used to define the M function for switching off the coolant; which is
output when the tool is changed.
MD52231 $MCS_M_CODE_COOLANT_1_ON M code for coolant 1 on

=8 This machine data is used to define the M function for coolant 1, which is output when the
tool is changed.
MD52232 $MCS_M_CODE_COOLANT_2_ON M code for coolant 2 on

=7 This machine data is used to define the M function for coolant 2, which is output when the
tool is changed.
MD52233 $MCS_M_CODE_COOLANT_1_AND_2_ON M code for both coolants on

= -1 This machine data is used to define the M function for coolant 1 and 2, which is output when
the tool is changed.
SD55505 $SCS_TURN_ROUGH_O_RELEASE_DIST Retraction distance for stock remov‐

al during external machining
=1 Specifies the distance, by which the tool is retracted from the contour when removing stock
from an outer corner. This does not apply to stock removal at a contour (default value).
= -1 The distance is internally defined.

Configuring cycles
21.5 Turning
SD55506 $SCS_TURN_ROUGH_'I_RELEASE_DIST Retraction distance for stock remov‐

al during internal machining
= 0.5 Specifies the distance, by which the tool is retracted from the contour when removing stock
from an internal corner. This does not apply to stock removal at a contour (default value).
= -1 The distance is internally defined.
21.5.4 Setting up a counterspindle
Software option
You require the following software option in order to use the counterspindle on your
machine:
"Generic coupling 'CP-STATIC'" or higher
Function
If your turning machine has a counterspindle, you can machine workpieces using turning,
drilling and milling functions on the front and rear faces without reclamping the workpiece
manually.
Before machining the rear face, the counterspindle must grip the workpiece, pull it out of the
main spindle, and position it at the new machining position.
Meaning of the axes

A detailed description of MD52006 is provided in Chapter "Activating turning/milling/drilling/

grinding technologies (Page 465)".
Traversing direction
In order that the user interface and cycles know in which direction the spindles and rotary axes
rotate, the following settings must be made.
You set the direction of rotation of an NC rotary axis via MD32100 $MA_AX_MOTION_DIR.
MD32100 $MA_AX_MOTION_DIR Traversing direction (not control direction)

-1 Direction reversal
0, 1 No direction reversal

Configuring cycles
21.5 Turning

You set the directions of rotation for the user interface in the following machine data:
MD52207 $MCS_AXIS_USAGE_ATTRIB[n] Attributes of the axes in the channel

Bit 3 Displayed positive direction of rotation is counter-clockwise (for rotary axes)
The view must be from the inside of the machine (operator's view) to the axis of rotation.
This bit can be set from the operator's view or according to DIN.
Bit 5 Direction of rotation for M3 corresponds to minus rotary axis (for spindles)
This bit must be set analogous to PLC bit DBn.DBX17.6!
As a result, the following setting options are obtained for the counterspindle:
Counterspindle direction of rotation 52207[n] 52207[n] 52207[n] DB3n.

bit 3 = bit 4 = *) bit 5 = DBX17.6
1 1 0 0
0
&
1 0 1 1
0
&
0 0 0 0
0 &
0 1 1 1
0 &

Configuring cycles
21.5 Turning
Note
MD52207[n] bit 4 = *)
Bit 4 can be set from the operator's view (values as specified) or according to DIN ("0" and "1"
are then interchanged).
The display must be the same for the main spindle and the counterspindle ("from operator's
view" or "according to DIN").
Dimensions
To define the reference point for moving the counterspindle, you must first announce the
dimensions of the counterspindle. You can either enter the dimensions in the following axis-
specific cycle machine data or in menu "Parameter" → "Setting data" → "Spindle chuck data."
Changes to the machine data are automatically accepted in the menu and vice versa.
MD53240 $MAS_SPINDLE_PARAMETER[ ] Spindle chuck data

[0] Chuck dimensions
[1] Stop dimensions
[2] Jaw dimensions
MD52241 $MCS_SPINDLE_CHUCK_TYPE Spindle jaw type

=0 Clamping, outer
=1 Clamping, inner
21.5.5 Setting up the counterspindle under ShopTurn
Software option
You require the following software option in order to use the counterspindle on your
machine:
"Generic coupling 'CP-STATIC'" or higher
The position to which the counterspindle travels when the program starts is defined in the
following channel-specific cycle setting data:
SD55232 $SCS_SUB_SPINDLE_REL_POS Retraction position Z for counterspindle
The following channel-specific setting data becomes effective when traveling to the fixed stop:
SD55550 $SCS_TURN_FIXED_STOP_DIST Distance for travel to fixed stop.

SD55551 $SCS_TURN_FIXED_STOP_FEED Feedrate for travel to fixed stop.
SD55552 $SCS_TURN_FIXED_STOP_FORCE Force for travel to fixed stop in %.

Configuring cycles
21.5 Turning
Between traveling to the fixed stop and gripping, the counterspindle can retract a short distance
to counteract compressive stress in the workpiece.
SD55553 $SCS_TURN_FIXED_STOP_RETRACTION Retraction distance before clamping af‐

ter fixed stop.
After gripping you can cut off the workpiece. Before doing so, the counterspindle can retract
a short distance with the workpiece to exert tensile stress on the workpiece. This relieves
pressure on the tool when cutting off.
SD55543 $SCS_TURN_PART_OFF_RETRACTION Retraction distance before cut-off.
After cut-off, you can carry out a cut-off check and for turning, use the "Travel to fixed stop"
function. You can activate/deactivate the cut-off check using the channel-specific cycle setting
data:
SD55540 $SCS_TURN_PART_OFF_CTRL_DIST Distance for cut-off check.

SD55541 $SCS_TURN_PART_OFF_CTRL_FEED Feedrate for cut-off check.
SD55542 $SCS_TURN_PART_OFF_CTRL_FORCE Force for cut-off check in %.
The cut-off is successful when travel to fixed stop fails. The following alarms are output:
Alarm Alarm text

20091 Axis %1 has not reached the fixed stop.
20094 Axis %1 end stop has been aborted.
You can switch off the alarm display using the following machine data:
MD37050 $MA_FIXED_STOP_ALARM_MASK Enabling the fixed stop alarms.

=2 Suppressing alarms 20091 and 20094.
You can set this machine data axis-specifically in the "Machine Data" window in the "Tool zero"
operating area.
If, however, the specified force is reached during the cut-off check (i.e. travel to fixed stop is
successful), alarm 61255 "Error during cut-off: Tool break?" is issued.
Note
The "Travel to fixed stop" function can also be used when gripping the spindle (see above). If
travel to fixed stop does not succeed when gripping, an alarm will of course still be issued.
Instead of alarms 20091 and 20094, the alarm 61254 "Error during travel to fixed stop" will be
issued.
Note
MD37050 can also contain values not equal to 2, e.g. 10 = 2 + 8. Make sure that the value 2
is always contained logically so that the monitoring for travel to fixed stop can be hidden. If
MD37050 does not contain the value 2, the cut-off check is not active.

Configuring cycles
21.5 Turning
Machine manufacturer cycle

If you perform one of the following actions, you must adapt the machine manufacturer cycle
CUST_TECHCYC.SPF.
● Switch between spindle and C axis mode for the main spindle or counterspindle.
● Open, close, flush chuck (main spindle / counterspindle).
● Change default settings for the coupling of the main spindle and counterspindle.
Please refer to the following section for the procedure:
Setting-up ShopTurn cycles for turning (Page 494)
21.5.6 Technology cycles for turning
Thread-cutting (CYCLE99)
To correctly machine the thread, it is necessary to set the machine data MD52207
$MCS_AXIS_USAGE_ATTRIB[n] with bit 3, see Chapter: Setting up a counterspindle
(Page 496).
Contour groovingCYCLE930, contour turning CYCLE950, stock removal at corner CYCLE951, contour
turning CYCLE952
SD55500 $SCS_TURN_FIN_FEED_PERCENT Enter the finishing feedrate for complete ma‐

chining, roughing and finishing. The percent‐
age of the value corresponds to that entered
under parameter F (feedrate).
= 100 100% finishing feedrate
SD55510 $SCS_TURN_GROOVE_DWELL_TIME Dwell time, which is necessary between

grooving and retracting for grooving technol‐
ogy. Tool clearance time during grooving at
the base.
=>0 Dwell time in seconds
=<0 Dwell time in spindle revolutions
SD55580 $SCS_TURN_CONT_RELEASE_ANGLE Angle, through which the tool is lifted from

the contour for contour turning, roughing.
= 45 Retraction angle of 45 degrees

Configuring cycles
21.5 Turning
Angle
SD55581 $SCS_TURN_CONT_RELEASE_DIST Amount, by which the tool is lifted when

roughing a contour taking into account the
retraction angle SD55580
$SCS_TURN_CONT_RELEASE_ANGLE.
This also applies to stock removal, grooving
and plunge turning.
=1 1 mm or 1 inch retraction distance
SD55582 $SCS_TURN_CONT_TRACE_ANGLE The angle between cutting edge and con‐

tour as of which rounding is performed on
the contour during contour turning in order
to remove residual material.
If the angle of the residual material is greater
than that specified in the setting data, the
tool will round the contour.
=5 5 degree angle
&RQWRXU
$QJOH
&XUUHQWFXWWLQJGHSWK'
5HVLGXDOPDWHULDO
SD55583 $SCS_TURN_CONT_VARIABLE_DEPTH Percentage of the changing cutting depth

when turning a contour
You can select changing the cutting depth
for stock removal and for removing residual
material.
= 20 20% variable cutting depth
SD55584 $SCS_TURN_CONT_BLANK_OFFSET Safety clearance when avoiding obstacles,

to avoid collisions during approach or retrac‐
tion from the machining.
and plunge turning.
=1 1 mm or 1 inch blank allowance

Configuring cycles
21.5 Turning
SD55585 $SCS_TURN_CONT_INTERRUPT_TIME Time for the feedrate interruption for contour

turning.
and plunge turning.
=>0 Interruption time in seconds
=<0 Interruption time in revolutions
=0 No interruption
Note
The channel-specific cycle setting data SD55585 is only evaluated if
SD55586 $SCS_TURN_CONT_INTER_RETRACTION = 0.
SD55586 $SCS_TURN_CONT_INTER_RETRACTION Retraction distance for contour turning

for feedrate interruption.
This also applies to stock removal,
grooving and plunge turning.
=>0 Retraction distance at feed interruption
SD55585 $SCS_TURN_CONT_INTERRUPT_TIME has no effect.
=0 No retraction distance
SD55587 $SCS_TURN_CONT_MIN_REST_MAT_AX1 Limit value during contour turning for

removal of residual material in the di‐
rection of axis 1 (for G18 Z).
This also applies to residual machining
– stock removal, grooving and plunge
turning.
50 The roughing step for residual machining is not executed, if the material to be removed is
less than 50% of the finishing allowance. The material is only removed when finishing.
Example: If the SD is set to 50% and the final machining allowance is 0.5 mm, any residual material less
than 0.25 mm is not removed with the residual machining – but is removed during finishing. If during a
machining step, less residual material is present than defined in the SD, the error message "No material
present" is issued. This means that this residual material roughing step can be omitted because no
machining is performed.
SD55588 $SCS_TURN_CONT_MIN_REST_MAT_AX2 Limit value during contour turning for

removal of residual material in the di‐
rection of axis 2 (for G18 X).
This also applies to residual machining
– stock removal, grooving and plunge
turning.
50 The roughing step for residual machining is not executed, if the material to be removed is
less than 50% of the finishing allowance. The material is only removed when finishing.

Configuring cycles
21.5 Turning
As the tool bends during plunge turning, the tool cannot travel right up to the contour during
stock removal. The lateral distance to the last cut by which the next cut is shortened is specified
in the following channel-specific cycle setting data.
SD55595 $SCS_TURN_CONT_TOOL_BEND_RETR Retraction distance because of tool

bending
0.1 0.1 mm or 0.1 inch retraction distance
a a
b
X
a Distance to the last cut, SD55595

b Retraction between plunge-cutting and stock removal, SD55596
As the tool bends during plunge turning, the tool would make an excessively deep cut during
stock removal. The retraction distance of the tool between plunge-cutting and stock removal
is specified in the following channel-specific cycle setting data:
SD55596 $SCS_TURN_CONT_TURN_RETRACTION Retraction depth before turning

= 0.1 0.1 mm or 0.1 inch retraction depth

Configuring cycles
21.5 Turning
21.5.7 Axis configuration of a lathe
General configuration
If driven milling tools are available on a lathe, then the following functions can also be set-up
on this machine:
● Cylinder surface transformation (TRACYL) (Page 505)
● End face machining (TRANSMIT) (Page 508)
Lathe with X and Z axes, main and tool spindle

For example, for a lathe with X and Z axes, main spindle (C1) and tool spindle (WZ), you can
configure the following channel-specific machine data:
MD20080 $MC_AXCONF_CHANAX_NAME_TAB[ ] Channel axis name in the channel

[0] = XC Channel axis XC
[1] = ZC Channel axis ZC
[2] = C1 Main spindle C1
[3] = WZ Tool spindle WZ
Lathe with X and Z axes, main and tool spindle and counterspindle
For example, for a lathe with X and Z axes, main spindle (C1), tool spindle (WZ) and
counterspindle (C2), you can configure the following machine data:

[5] = C2 Counterspindle C2
Lathe with X and Z axes, main and tool spindle and Y axis
For example, for a lathe with X, Z and Y axes, main spindle (C1) and tool spindle (WZ), you
can configure the following machine data:

[5] = YC Channel axis YC

Configuring cycles
21.5 Turning
21.5.8 Cylinder surface transformation (TRACYL)
Software option
"Transmit and peripheral surface transformation"
Function
Using the cylinder surface transformation function (TRACYL), you can machine the peripheral
surface of a turned part.
Setting up
General settings for cylinder transformation
MD10602 $MN_FRAME_GEOAX_CHANGE_MODE Frames when switching over geometry ax‐

es.
=1 The actual total frame (work offsets) and when switching over geometry axes (selecting -
deselecting TRACYL) is recalculated.
MD24040 $MC_FRAME_ADAPT_MODE Adapting the active frames.

Bit 0 = 1 Rotations in active frames that rotate coordinate axes for which there are no geometry axes,
are deleted from the active frames.
Bit 1 = 1 Shearing angles in active frames are made orthogonal.
Bit 2 = 1 Scaling factors of all geometry axes in the active frames are set to 1.
MD28082 $MC_MM_SYSTEM_FRAME_MASK
Bit 6 = 1 Configuration of the transformation frame for the compensation.
When setting up the functions, you can take the following channel-specific machine data into
account:
MD24300 $MC_TRAFO_TYPE_3 Cylinder surface transformation, main spin‐

dle: Transformation 3
= 512 Without groove side offset (without Y axis)
= 513 With groove side offset (with Y axis)
= 514 With or without groove side offset and Y offset
MD24400 $MC_TRAFO_TYPE_4 Cylinder surface transformation, counter‐

spindle: Transformation 4
= 512 Without groove side offset (without Y axis)
= 513 With groove side offset (with Y axis)
= 514 With or without groove side offset and Y offset

Configuring cycles
21.5 Turning
Note
You must also set up other machine data for each of the individual transformations.
Cylinder surface transformation without groove side offset
MD24300 $MC_TRAFO_TYPE_3 Definition of the 3rd transformation in the

channel.
= 512 TRACYL main spindle.
MD24310 $MC_TRAFO_AXES_IN_3[ ] Axis assignment for transformation 3.

[0] = 1 Perpendicular to the rotary axis XC
[1] = 3 Rotary axis (main spindle) C1
[2] = 2 Parallel to the rotary axis ZC
MD24320 $MC_TRAFO_GEOAX_ASSIGN_TAB_3[ ] Assignment of geometry axes to channel

axes for transformation 3.
[0] = 1 1st channel axis X
[1] = 3 2nd channel axis Y
[2] = 2 3rd channel axis Z
MD24800 $MC_TRACYL_ROT_AX_OFFSET_1 Offset of the rotary axis for the 1st TRACYL
transformation.
=0
MD24805 $MC_TRACYL_ROT_AX_FRAME_1 Axial offset of the rotary axis is taken into

account during TRACYL.
=2
MD24810 $MC_TRACYL_ROT_SIGN_IS_PLUS_1 Sign of the rotary axis for the 1st TRACYL
transformation.
=1
MD24820 $MC_TRACYL_BASE_TOOL_1[ ] Vector of the base tool for the 1st TRACYL
transformation.
[0] = 0
[1] = 0
[2] = 0

Configuring cycles
21.5 Turning
Setting up cylinder surface transformation under ShopTurn

In addition, set the following channel-specific configuration machine data:
MD52214 $MCS_FUNCTION_MASK_MILL Milling function screens

Bit 3 Enable "internal / rear" machining in ShopTurn screens that define the machining plane
themselves.
Bit 4 If you have implemented the "Clamp/release spindle" function using the machine manu‐
facturer cycle CUST_TECHCYC.SPF, then using this machine data, you can activate the
"Clamp/release spindle" parameter in the drilling and milling screens.
operation.
= 1 The "Clamp/release spindle" parameter is displayed in the drilling and milling screens.
The operator decides for which machining operation the spindle should be clamped.
Cylinder surface transformation with groove side offset
MD24300 $MC_TRAFO_TYPE_3 Definition of the 3rd transformation in the

channel.
= 513 TRACYL main spindle

[3] = 6 Parallel to the cylinder surface and perpendicular to the rotary axis ZC

MD24800 $MC_TRACYL_ROT_AX_OFFSET_1 Offset of the rotary axis for the 1st TRACYL
transformation.
=0
MD24805 $MC_TRACYL_ROT_AX_FRAME_1 Axial offset of the rotary axis is taken into

account during TRACYL.
=2

Configuring cycles
21.5 Turning
MD24810 $MC_TRACYL_ROT_SIGN_IS_PLUS_1 Sign of the rotary axis for the 1st TRACYL
transformation.
=1
MD24820 $MC_TRACYL_BASE_TOOL_1[ ] Vector of the base tool for the 1st TRACYL
transformation.
[0] = 0
[1] = 0
[2] = 0
21.5.9 End face machining (TRANSMIT)
Software option
"Transmit and peripheral surface transformation"
Function
Using the end face machining function (TRANSMIT), you can machine the end face of a turned
part.
Setting up
For general settings for transformations, please refer to Chapter "Cylinder surface
transformation (TRACYL) (Page 505)".
You can make additional settings in the following channel-specific machine data:
MD24100 $MC_TRAFO_TYPE_1 End face machining, main spindle: Trans‐

formation 1
= 256 Machining without Y axis
= 257 Machining with Y axis
MD24200 $MC_TRAFO_TYPE_2 End face machining, counterspindle:

Transformation 2
= 256 Machining without Y axis
= 257 Machining with Y axis
MD24110 $MC_TRAFO_AXES_IN_1[ ] Axis assignment for the 1st transforma‐

tion in the channel

Configuring cycles
21.5 Turning

MD24120 $MC_TRAFO_GEOAX_ASSIGN_TAB_1[ ] Assignment of the geometry axes to chan‐

nel axes for transformation 1
MD24900 $MC_TRANSMIT_ROT_AX_OFFSET_1
=0 Offset of the rotary axis for the 1st TRANSMIT transformation.
MD24905 $MC_TRANSMIT_ROT_AX_FRAME_1
=2 Axial offset of the rotary axis is taken into account during TRANSMIT 1.
MD24910 $MC_TRANSMIT_ROT_SIGN_IS_PLUS_1
=0 Sign of the rotary axis for the 1st TRANSMIT transformation.
MD24911 $MC_TRANSMIT_POLE_SIDE_FIX_1
=1 Limitation of working range in front of/behind the pole, 1st TRANSMIT.
MD24920 $MC_TRANSMIT_BASE_TOOL_1[ ] Vector of the base tool for the 1st TRANS‐
MIT transformation.
[0] = 0
[1] = 0
[2] = 0
TRANSMIT with real Y axis
= 257 Definition of transformation 1 in the channel: TRANSMIT main spindle.
MD24110 $MC_TRAFO_AXES_IN_1[ ] Axis assignment for the 1st transforma‐

tion in the channel.
[1] = 3 Rotary axis C1

Configuring cycles
21.5 Turning
MD24120 $MC_TRAFO_GEOAX_ASSIGN_TAB_1[ ] Assignment of the geometry axes to chan‐

nel axes for transformation 1.
MD24900 $MC_TRANSMIT_ROT_AX_OFFSET_1
=0 Offset of the rotary axis for the 1st TRANSMIT transformation.
MD24905 $MC_TRANSMIT_ROT_AX_FRAME_1
=2 Axial offset of the rotary axis is taken into account during TRANSMIT 1.
MD24910 $MC_TRANSMIT_ROT_SIGN_IS_PLUS_1
=0 Sign of the rotary axis for the 1st TRANSMIT transformation.
MD24911 $MC_TRANSMIT_POLE_SIDE_FIX_1
=1 Limitation of working range in front of/behind the pole, 1st TRANSMIT.
MD24920 $MC_TRANSMIT_BASE_TOOL_1[ ] Vector of the base tool for the 1st TRANS‐
MIT transformation.
[0] = 0
[1] = 0
[2] = 0
Additional settings for rotary axes

If you want to integrate rotary axes, in addition to the following machine data you also require
MD28082 with bit 6, see Chapter "Cylinder surface transformation (TRACYL) (Page 505)".
MD24906 $MC_TRANSMIT_BASE_TOOL_COMP_1 Compensation of the basic offset in the 1st

transformation frame.
Bit 0 1st geometry axis
Bit 1 2nd geometry axis
Bit 2 3rd geometry axis
MD24956 $MC_TRANSMIT_BASE_TOOL_COMP_2 Compensation of the basic offset in the 2nd

transformation frame.
Bit 0 1st geometry axis
Bit 1 2nd geometry axis
Bit 2 3rd geometry axis
For further information, see also Chapter "Clamping a blank (Page 110)".

Configuring cycles
21.5 Turning
Face machining under ShopTurn

If you wish to use the face machining function under ShopTurn function, set the following
additional channel-specific configuration machine data:
MD52214 $MCS_FUNCTION_MASK_MILL Function screens, ShopTurn.

Bit 3 Enable "internal / rear" machining in ShopTurn screens that define the machining plane
themselves.
Bit 4 If you have implemented the "Clamp/release spindle" function using the machine manufac‐
turer cycle CUST_TECHCYC.SPF, then using this machine data, you can activate the
"Clamp/release spindle" parameter in the drilling and milling screens.
operation.
= 1 The "Clamp/release spindle" parameter is displayed in the drilling and milling screens. The
operator decides for which machining operation the spindle should be clamped.
Note
The face end machining is automatically integrated in the cycles, with the exception of the
straight line and circle.
You can select the functions for these two cycles in the "Program" operating area at "Straight
line" and "Circle".
Additional information on end face machining is provided in:
References
Function Manual Extended Functions; M1: Kinematic transformation,
Section: "TRANSMIT face end transformation"
21.5.10 Inclined Y axis (TRAANG)
Software option
You require the following software option in order to use the inclined Y axis function
on your machine:
"Inclined axis"
Function
If your turning machine has an inclined Y axis (i.e. this axis is not perpendicular to axes X and
Z), you can still completely program machining operations in Cartesian coordinates. The
control uses the inclined axis function (TRAANG) to transform the Cartesian coordinates to
the motion of the inclined axis.

Configuring cycles
21.5 Turning
Setting up
You still have to set up the inclined axis function (TRAANG) via machine data.
Inclined axis under ShopTurn

Please also note the following:
Note
In the user interface, the inclined axis function is automatically integrated in the cycles after
setting up. For machining with inclined axis, in the screen forms of the machining plane, you
can select "Face Y" or "Peripheral surface Y" and enter the Cartesian coordinates.
You will find additional information on the inclined Y axis function in:
References
● Function Manual Extended Functions; M1: Kinematic transformation,
Section: "TRAANG oblique angle transformation"
● Programming Manual, Job Planning, Section "Transformations" > "Kinematic
transformations" > "Inclined axis (TRAANG)"
Example
For example, for a turning machine with X and Z axes and inclined Y axis, main spindle (C)
and tool spindle (WZ), you must configure the following machine data:
MD20050 $MC_AXCONF_GEOAX_ASSIGN_TAB[ ] Assignment of geometry axis to channel

axis.
[0] = 1 1st real geometry axis X axis.
[1] = 0 2nd real geometry axis Y axis not available.
[2] = 2 3rd real geometry axis Z axis.
MD20110 $MC_RESET_MODE_MASK
Bit 0 = 1 TRAANG is retained after ramp-up.
Bit 7 = 0
MD20112 $MC_START_MODE_MASK
Bit 7 = 1 TRAANG is retained after "Cycle start".
MD20118 $MC_GEOAX_CHANGE_RESET
=1 Allow automatic geometry axis change.

Configuring cycles
21.5 Turning
MD20140 $MC_TRAFO_RESET_VALUE
=5 TRAANG always active after reset.
MD20144 $MC_TRAFO_MODE_MASK
Bit 0 = 1 TRAANG runs in the background (persistent) and is not shown on the user interface.
MD20070 $MC_AXCONF_MACHAX_USED[4]
=5 Channel axis YC = 5th machine axis.
MD20080 $MC_AXCONF_CHANAX_NAME_TAB[ ] Name of channel axis in the channel.

[0] = XC 1st channel axis XC
[1] = ZC 2nd channel axis ZC
[2] = C 3rd channel axis C
[3] = WZ 4th channel axis WZ
[4] = YC 5th channel axis YC
Data set for inclined axis:
= 1024 Transformation 5: TRAANG

[0] = 5 1st transformation axis = channel axis, YC
[1] = 1 2nd transformation axis = channel axis, XC
[2] = 2 3rd transformation axis = channel axis, ZC

[0] = 1 1st axis = channel axis XC
[1] = 5 2nd axis = channel axis YC
[2] = 2 3rd axis = channel axis ZC
MD24436 $MC_TRAFO_INCLUDES_TOOL_5
=0 Tool handling with active transformation 5.
MD24700 $MC_TRAANG_ANGLE_1
= 55 Angle between 1st and 2nd transformation axis. Data set for linking (TRACON) of end
face machining on main spindle (TRANSMIT) and inclined axis (TRAANG).

Configuring cycles
21.5 Turning
Data set for linking (TRACON) of end face machining on main spindle (TRANSMIT) and
inclined axis (TRAANG):
= 8192 Type of transformation that is available as sixth in the channel.

MD24995 $MC_TRACON_CHAIN_1[ ] Transformation linking

[0] = 1 Number of the TRANSMIT transformation (main spindle) for linking.
[1] = 5 Number of the TRAANG transformation for linking. Data set for linking (TRACON) of
cylinder surface transformation on main spindle (TRACYL) and inclined axis (TRAANG).
Data set for linking (TRACON) of cylinder surface transformation on main spindle (TRACYL)
and inclined axis (TRAANG):
= 8192 Type of transformation 7 in the TRACON channel.

MD24996 $MC_TRACON_CHAIN_2[ ] Transformation linking

[0] = 3 Number of the TRACYL transformation (main spindle) for linking.
[1] = 5 Number of the TRAANG transformation for linking.
21.5.11 Spindle speed limitation for current program

Speed limits are programmed in the part program. If the part program is applied, the spindle
speed limits are entered in the setting data and saved there after the end of program.
However, if the modified speed limits must not apply after the end of the program, you can
change the property with the following commands in the GUD block of the machine
manufacturer:

Configuring cycles
21.6 grinding
Changing spindle speed limits for the current program only
REDEF $SA_SPIND_MAX_VELO_LIMS PRLOC ; maximum spindle speed limit for V

constant (G96)
REDEF $SA_SPIND_MAX_VELO_G26 PRLOC ; maximum spindle speed limit for rpm
(G26)
21.6 grinding
General
Grinding tools are identified by tool type 400, 410; dressing tools are identified by tool type
490. The "New tool" function offers these types for selection. The tool list shows the "Grinding
disk" and "Dressing tool" tool types listed according to their tool type. To generate the grinding
disk correction, a tool setter creates a dressing program. Depending on the complexity, the
tool setter makes use of external or internal code generators. This program will be assigned
later to a grinding disk.
Base variant
The dressing is performed in the JOG and AUTOMATIC operating modes, where in automatic
operation, the dressing is called from a part program. To parameterize the dressing, a
diagnostic screen form deployed in manual mode and in the program editor is provided.
The base package offers predefined write contours. The dressing is supported with supplied
screen forms and system cycles. These system cycles are available independent of and
separate from the machining cycles package.
Oscillation cycles
These grinding cycles permit the machining of workpieces with grinding machines using two
geometry axes.
The machines type does not exist because the cycles create only an oscillating movement
that can be used as required on every machine.
This requires a SINUMERIK control as well as fast inputs/outputs for the program processing.
The cycles package provides the following cycles:
● CYCLE4071: Longitudinal grinding with infeed at the reversal point
● CYCLE4072: Longitudinal grinding with infeed at the reversal point and measurement
control
● CYCLE4073: Longitudinal grinding with continuous infeed
● CYCLE4074: Longitudinal grinding with continuous infeed and measurement control
● CYCLE4075: Surface grinding with infeed at the reversal point

Configuring cycles
21.6 grinding
● CYCLE4077: Surface grinding, plunge grinding with measurement control

● CYCLE4078: Surface grinding with continuous infeed
● CYCLE4079: Surface grinding with intermittent infeed
References
For further information about oscillating cycles, please refer to:
Programming Manual, Production Planning; Chapter "Programming cycles externally" >
"Technological cycles"
Grinding function screen
MD51840 $MNS_GRIND_FUNCTION_MASK Grinding cycles function screen

Bit 0 Reference point for measuring the dresser/wheel is a work offset
= 0 Deselection of the work offset as reference point
= 1 Selection of the work offset as reference point
MD52840 $MCS_GRIND_FUNCTION_MASK Grinding cycles function screen

Bit 7 Retraction when form-truing with G1
= 0 Retraction when form-truing with rapid traverse (G0)
= 1 Retraction when form-truing with feedrate (G1)
SD54840 $SNS_GRIND_FUNCTION_MASK Grinding cycles function screen

SD55840 $SCS_GRIND_FUNCTION_MASK Grinding cycles function screen
Form-truing (CYCLE495)
SD55880 $SCS_GRIND_CONT_RELEASE_ANGLE Angle of retraction

This setting data is used to specify the angle of retraction from the contour during form-truing.
SD55881 $SCS_GRIND_CONT_RELEASE_DIST Retraction distance

This setting data is used to specify the distance retracted in both axes during form-truing.
SD55884 $SCS_GRIND_CONT_BLANK_OFFSET Blank allowance

This setting data is used to specify the distance to the grinding wheel as of which the switch‐
over is made from G0 to G1 during form-truing.

Configuring cycles
21.7 Swiveling
21.7 Swiveling
21.7.1 Technology cycles for swiveling
Requirement
The commissioning of the kinematic chain of the machine is a mandatory requirement for
correct swiveling functionality (CYCLE800). The kinematic chain is stored in the tool
parameters $TC_CARR1 to $TC_CARR65.
Note
The vectors of the kinematic chain can be determined with the "Measure kinematics"
measuring function (CYCLE996).
To activate the swivel function, there must be at least one tool holder that can be oriented
(swivel data set) in the NCK, and the workpiece, tool and rotary table reference system frames
must be activated:
MD18088 $MN_MM_NUM_TOOL_CARRIER Maximum number of definable tool holders

>0
MD28082 $MC_MM_SYSTEM_FRAME_MASK System frames (SRAM)

= 3DH
Bit 2 = 1 TCARR and PAROT
Bit 3 = 1 TAROT and TOFRAME
Bit 4 = 1 Workpiece reference points
Bit 5 = 1 System frame for cycles
Note
Changing machine data MD18088 and MD28082 causes the buffered memory to be
reorganized.
After changing the machine data, a series start-up file must be generated and downloaded,
otherwise, it can be assumed that data will be lost.
To change machine data, you require the following authorization: Access level 1
(manufacturer).
You will find up-to-date information in the following references:

Configuring cycles
21.7 Swiveling
References
● "siemensd.txt" file in the supplied software (standard cycles)
● Function Manual Basic Functions; W1: Tool offset
Section: "Tool holder with orientation capability" > "Oblique machining with 3 + 2 axes"
● Programming Manual, measuring cycles: CYCLE996
Activating the swivel function

The swivel function is enabled on the user interface via the following channel-machine data:

Bit 0 = 1 Enable swivel
Configuring input screens

You can configure the input screen for swiveling using the following channel-specific cycle
setting data. The setting data is effective for all of the declared swivel data sets.
SD55221 $SCS_FUNKTION_MASK_SWIVEL_SET Function screen, swiveling CYCLE800

Bit 0 Input field "No swiveling"
= 0 Hide
= 1 Display
Bit 1 Select text when retracting "Z, ZY" or "Fixed position 1/2"
= 0 Display text Z = "Z", display text Z, XY = "Z,XY"
= 1 Display text Z = "Fixed point 1", Display text Z, XY = "Fixed point 2".
If you wish to modify the retraction version "Z" or "Z, XY" via the manufacturer cycle
CUST_800.SPF, the neutral text "Fixed point 1" and "Fixed point 2" can be displayed.
Bit 2 Select, permit "deselection" of the swivel data set
= 0 If deselection is not permitted, the "Swivel data set" (TC) selection field is not displayed
in the "Swivel" input screen.
= 1 Deselection permitted
see also swivel data set parameter $TC_CARR37
HUNDRED MILLIONS position
Bit 3 Displays the active swivel plane under swivel in JOG. The setting in the swivel function
screen acts on all swivel data sets.
Bit 4 Positioning in the basic position (pole position) of the kinematics
= 0 Evaluation of the input values in pole position of the machine kinematics
= 1 Compatibility
Bit 5 Tool alignment absolute or via frame calculation
= 0 Tool alignment via frame calculation (TCOFRY for G18)
= 1 Tool alignment absolute (TCOABS)
Bit 6 Do not list swivel mode "direct" under swivel in JOG
Bit 7 Swivel plane: Direction selection in basic position of the kinematic
= 0 With direction selection + or -, both calculated solutions for the rotary axes are approached
= 1 With direction selection + or -, only one of the calculated solutions for the rotary axes is
approached

Configuring cycles
21.7 Swiveling
Bit 8 Traverse the zero offset for the rotary axes of the swivel data set as offset
= 0 Only take the zero offset for the rotary axes of the swivel data set into account in the WCS
(compatibility)
= 1 Traverse the zero offset for the rotary axes of the swivel data set as offset
Bit 8 is set in conjunction with MD21186.
Bit 9 Swivel data set TC permanently assigned to the tool
= 0 Show number of the swivel data set TC
= 1 Do not show number of the swivel data set TC
The swivel data set is assigned to the tool with parameter SGUD_TC_GNO if technology
MD52200 = 3 is set for cylindrical grinding.
Example:
The machine machine manufacturer can write the current tool _TC_GNO = $P_TOOLNO
into parameter _TC_GNO in the tool change program L6. As a result, the tool holder will
be updated when a tool is changed.
Bit 10 Swivel plane: Show input field "Positioning direction"
= 0 Input field "Positioning direction" is not displayed.
= 1 Input field "Positioning direction" is displayed with swivel table and swivel head/table
combinations.
Bit 11 Positioning both solutions of AB kinematics
= 0 Positions only one solution of some swivel angles (compatibility)
= 1 Positions both solutions calculated by the NC
Bit 11 should be set for kinematics = 1 where, in the kinematics basic setting, neither of
the two rotary axes rotates about the tool axis (AB kinematics in tool axis in the Z direction)
Bit 12 Swivel plane, align tool: Reset behavior takes account of rotary axis positions
= 0 Reset condition refers to the final position of the rotary axes of the swivel data set (com‐
patibility)
Linear axis identifiers are written into parameters $TC_CARR21/22. On reset (TCOABS),
the tool holder is initialized with the final positions of the rotary axes ($TC_CARR13/14).
= 1 Reset condition refers to the current position of the rotary axes of the swivel data set
The rotary axis names of the swivel data set are written into parameters $TC_CARR21/22.
On reset (TCOABS), the tool holder is initialized with the actual values of the rotary axes.
Additional settings
For the swivel function, set the following machine data as a minimum to the following - although
this deviates from the default value:
MD10602 $MN_FRAME_GEOAX_CHANGE_MODE
=1 The actual total frame (zero offsets) is recalculated when switching over geometry axes
(selecting/deselecting TRAORI).
MD10760 $MN_G53_TOOLCORR Method of operation with G53, G153 and

SUPA
Bit 0 = 1 If the machine axis/axes are to be retracted before swiveling, see Chapter "Manufacturer
cycle CUST_800.SPF (Page 548)"

Configuring cycles
21.7 Swiveling
MD11450 $MN_SEARCH_RUN_MODE Settings, block search

Bit 1 = 1 Activate PROG_EVENT.SPF after block search. This means that for a block search, the
rotary axes of the active swivel data set are pre-positioned.
Declare swivel data sets

For the swivel function, swivel data sets must be created in the NCK and declared in the
following machine data.
MD18088 $MN_MM_NUM_TOOL_CARRIER Maximum number of definable tool holders

that can be oriented.
Number of swivel data sets
If several channels are declared in the NCU, the number of swivel data sets is split up, taking
MD28085 $MN_MM_LINK_TOA_UNIT into account.
Example 1:
Machine has two channels with different TO units.
Channel 1: MD28085 $MN_MM_LINK_TOA_UNIT= 1
Three swivel data sets (SDS) are required for each TO unit.
MD18088 = (number of TO units) x (number of SDS per TO unit) = 2 x 3 = 6
Example 2:
Machine has three channels with two different TO units.
One swivel data set (SDS) is required for each TO unit.
MD18088 = (number of TO units) x (number of SDS per TO unit) = 2 x 1 = 2
Using angular tools

Angular tools are created and managed in the NC with tool type 130. The tool lengths are
entered in the tool of tool type 130. If an angular tool is also used on a swiveled machining
plane (CYCLE800), the basic tool orientation must be enabled with
MD18114 $MM_ENABLE_TOOL_ORIENT = 2. This enables a direction vector to be
transferred to the tool in the tool parameters $TC_DPV3[n] to $TC_DPV5[n]. The TOROT
(G17), TOROTY (G18), and TOROTX (G19) commands must be programmed for the tool
change so that the basic tool orientation is updated.

Configuring cycles
21.7 Swiveling
n = internal tool number
MD18114 $MM_ENABLE_TOOL_ORIENT Assign orientation to cutting edges.

Basic tool orientation
=0 No basic tool orientation active
=2 Basic tool orientation active
Used for angular tools and swiveling
MD20110 $MC_RESET_MODE_MASK Initial control setting for RESET and end of

part program
Bit 14 = 1 Calculation of the basic and system frames, example: 4041H.
MD20112 $MC_START_MODE_MASK Basic control setting for START and part

program.
400H
MD20126 $MC_TOOL_CARRIER_RESET_VALUE Active tool holder at RESET

=0 No active tool holder at RESET
= > 0 (n) Tool holder with number n active at RESET
MD20126 is written to in CYCLE800
CYCLE800() corresponds to deselect tool holder (MD20126 = 0)
MD20150 $MC_GCODE_RESET_VALUES[ ] Initial setting of G group.

[41] = 1 Initial setting of G group 42 on TCOABS
[51] = 2 Initial setting of G group 52 on PAROT
[52] = 1 Initial setting of G group 53 on TOROTOF
[52] = > 1 Initial setting of G group 53 on TOROT, TOROTY or TOROTX
Used for machine kinematics, types "T" and "M"
See parameter $TC_CARR34
Note
If, after a RESET from the NC, a frame must be calculated in the tool direction, then
MD20150 $MC_GCODE_RESET_VALUES[52] can be set to a value > 1.
Applications:
● Machine kinematics with Hirth joint
● Angular tool with basic tool orientation

Configuring cycles
21.7 Swiveling
Note on kinematics (swivel head / mixed kinematics) with Hirth joint:

Depending on the active plane (G17,G18,G19), the TOROT command (or TOROTX,
TOROTY) is programmed in the NCU (G group 53) to calculate the compensating frame for
the Hirth joint in CYCLE800. If the Hirth joint causes the programmed rotation to deviate from
the possible positions of the rotary axes, a $P_TOOLFRAME compensating frame is created
for swivel head and mixed kinematics (see HMI active ZO / details tool reference).
If the compensating frame must be retained after RESET or end of part program, enter the
following value in the channel-specific machine data:
MD20150 $MC_GCODE_RESET_VALUES[52] Reset behavior of G groups

=2 For G17 (TOROT)
=3 For G18 (TOROTY)
=4 For G19 (TOROTX)
MD20196 $MC_TOCARR_ROTAX_MODE Rotary axis mode for tool holders with ori‐
entation capability
Bit 0 = 1 Swivel data set with a rotary axis
used for a rotary table with C axis
Bit 1 = 1 Swivel data set with two rotary axes
used for standard swiveling
MD20360 $MC_TOOL_PARAMETER_DEF_MASK Tool parameter setting

Bit 10 = 1 The orientation vector remains at T0 or D0 (no tool)
Used for machine kinematics, types "T" and "M"
See parameter $TC_CARR34
Bit 19 = 1 The changed orientation vector remains at T0 or D0 (no tool)
Bit 19 acts only with bit 10 = 1
MD21186 $MC_TOCARR_ROT_OFFSET_FROM_FR Offset of the rotary axes for a tool holder

with orientation capability from the zero
offset of the rotary axis.
=0 In CYCLE800, the WCS is recalculated when there is a value in the zero offset (ZO) of
the rotary axes.
If values are entered in the zero offset of the rotary axes of the active swivel data set,
the basic position of the swivel data set and therefore also the basic position of the
WCS can change.
=1 A value in the ZO of the rotary axes acts as offset of the tool holder that has orientation
capability. The Work remains unchanged.
MD21186 may not be rewritten in a program with call CYCLE800.

The setting MD21186 = 0 is only suitable for a swivel data set in which one of the available
rotary axes rotates exactly around the tool axis. In this way, a useful rotation of the WCS can
be calculated in CYCLE800 when values are entered in the zero offset of the rotary axes. For
example, for a swivel table with rotary axis A around X and rotary axis C around Z for a basic
position of the kinematics in G17.

Configuring cycles
21.7 Swiveling
If several swivel data sets are declared per channel, and if machine functions need to be
activated on changeover between swivel heads or tables, an M command can be issued in
the PLC program on switchover to another swivel data set.
MD22530 $MC_TOCARR_CHANGE_M_CODE M code for swivel data set change

=0 No swivel data set change
<0 M code + number of the swivel data set for the swivel data set change
Example
Number of swivel data sets in channel 1 =2

MD22530 $MC_TOCARR_CHANGE_M_CODE = -800
Programming swivel data set 1 (TCARR=1) = M801
Programming swivel data set 2 (TCARR=2) = M802
With the output of the M commands, the PLC can limit or invert the spindle speed or clamp or
release the rotary axes, for example.
Setting the workpiece, tool and rotary table reference

Using the following machine data, you can set the workpiece, tool and rotary table reference
system frames or you can influence the behavior of the system frames.
Application: System frames can be active after Reset or Power On, in order to retract a drill
from a swiveled position without causing a collision, for example.

Bit 4 System frame workpiece reference
= 0 Not active
= 1 Remains active

= 0 Do not delete
= 1 Delete
When used for measuring or swiveling in JOG, the workpiece reference must be active at
RESET and not cleared (cascaded measuring).

Bit 4 = 1 System frame for workpiece reference remains active after RESET

Bit 4 = 0 Do not clear system frame workpiece reference after RESET

Configuring cycles
21.7 Swiveling
MD24008 $MC_CHSFRAME_POWERON_MASK Reset system frames after Power On.

Bit 2 System frame rotary table reference (PAROT)
= 0 Do not reset
= 1 Reset
Bit 3 System frame tool reference (TOROT,..)
= 0 Do not reset
= 1 Reset
= 0 Do not reset
= 1 Reset
MD24080 $MC_USER_FRAME_POWERON_MASK Settings for settable frames.

Bit 0
= 0 Settable zero offset via Power On not active.
=1 Last active settable zero offset remains active after power on if
MD20152 $MC_GCODE_RESET_MODE[7] = 1
Application: Zero offset G5xx, including all rotations, should remain active after Power On.
MD28082 $MC_MM_SYSTEM_FRAME_MASK Setting-up system frames (SRAM)

Bit 2 = 1 Rotary table reference ($P_PARTFRAME)
Bit 3 = 1 Tool reference ($P_TOOLFRAME)
MD28083 $MC_MM_SYSTEM_DATAFRAME_MASK Setting-up data management, system

frames (SRAM)
Bit 2 = 1 Rotary table reference ($P_PARTFRAME)
Bit 3 = 1 Tool reference ($P_TOOLFRAME)
MD28085 $MC_MM_LINK_TOA_UNIT Assigning a TO unit to a channel (SRAM)

If several channels are set-up, then the following can be set in the machine data:
Assignment of the TO units (tools and orientable tool holders) to the NC channel. One TO unit can be
assigned to several channels.
- OR -
Each NC channel is assigned one TO unit.
Axial machine data for the modulo rotary axes of the swivel data set
MD30455 $MA_MISC_FUNCTION_MASK Axis functions

Bit 0 Modulo rotary axis programming
= 0 No modulo rotary axis programming (e.g. 0 to 359.999 degrees)
= 1 Modulo rotary axis programming (e.g. -180 to 180 degrees)
Bit 2 Positioning, rotary axis

Configuring cycles
21.7 Swiveling
= 0 As programmed
= 1 Along the shortest path
Application: With the setting bit 2=1, the rotary axis C travels along the shortest path for G90
with DC. For further information, refer to Chapter "Manufacturer cycle CUST_800.SPF
(Page 548)".
MD32010 $MA_JOG_VELO_RAPID[AX] Rapid traverse in JOG

AX = axis name Rotary and machine axes that should trav‐
el for swiveling in JOG.
= 10000 Rapid traverse in JOG mode for swivelling in JOG
SD42980 $SC_TOFRAME_MODE Setting, frame definition for TOROT, PA‐

ROT
= 2000 Swivel (default value)
SD42974 $SC_TOCARR_FINE_CORRECTION Fine offset TCARR (swivel data set)

=0 No fine offset of the swivel data set vectors
=1 Fine offset of the swivel data set vectors
The parameters of the swivel data set from $TC_CARR41[n] n…number of the swivel data
set and higher apply
Swiveling in the JOG mode

Cycle alarms 62186 and 62187 can be hidden or displayed using the following cycle machine
data:
MD55410 $MC_MILL_SWIVEL_ALARM_MASK Activate fault evaluation CYCLE800

Bit 0 Activate fault 61186
= 0 Hide fault 61186 "Active zero offset G%4 and base (base reference) contains rotations"
(default setting).
= 1 Display fault 61186
Bit 1 Activate fault 61187
= 0 Hide fault 61187 "Active base and base reference (G500) contain rotations" (default set‐
ting).
= 1 Display fault 61187

Configuring cycles
21.7 Swiveling
21.7.2 CYCLE800 checklist for the identification of the machine kinematics
Note
Identification of the machine kinematics (kinematic chain) according to DIN 66217 or ISO
841-2001
This checklist does not claim to be complete.
● Do the three linear axes of the machine that are active for the transformation form an
orthogonal coordinate system? Geometry axes XYZ
● How many swivel kinematics does the machine have?
Combinations of two (or one) rotary axis and the three linear axes are always formed.
● Which kinematics type is it?
Swivel head, swivel table or mixed kinematics of swivel head and swivel table.
● What are the names of the rotary axes of the kinematics?
Manual rotary axes are permitted and do not have to be declared in the NC.
● What is the 1st or 2nd rotary axis of a swivel data set?
Rule: Rotary axis 2 is based on rotary axis 1. With mixed kinematics, rotary axis 1 is always
the axis for the tool orientation.
● Is the traversing direction of the linear axes and the rotary axes correct? Right-hand rule
Rule: If the linear axis or the rotary axis moves the workpiece, the direction of motion of the
axis and also the sign of the rotary axis vector change.
● What is the initial setting of the kinematics?
This defines the tool orientation and the plane G17, G18, G19.
● Which rotary axis rotates around which axis of the coordinate system or the machine axis
(axes)?
This defines the rotary axis vectors of the kinematics.
Example 1:
Head kinematics. Rotary axis 2 rotates around axis Y → rotary axis vector V2xyz = 0,1,0
Example 2:
Table kinematics. Rotary axis 1 rotates around axis X → rotary axis vector V1xyz = -1,0,0
21.7.3 Commissioning swivel data (kinematics chain)
Defining a swivel data set

You must create a swivel data set for every swivel head, swivel table or each combination of
both.
Swivel data sets can be declared in several channels.
A swivel data set comprises the parameters $TC_CARR1[n] to $TC_CARR65[n]
n = number of the swivel data set.

Configuring cycles
21.7 Swiveling
The parameters of the swivel data set ($TC_CARR1[n] to $TC_CARR65[n]) can be read-in
and read-out in the startup operating area. Programming with appropriate value assignment
is also possible in an NC program (manufacturer cycle). The parameters of the swivel data set
are immediately effective after the program has started.
The following softkeys are assigned to the Swivel function in the "Program" → "Various"
operating area:
Milling technology Turning technology

"Swivel plane" "Swivel plane"
"Advance milling tool" "Swivel tool" → "Align turning tool"
→ "Align milling tool"
→ "Advance milling tool"
The "Align turning tool" and "Align milling tool" softkeys are only displayed if the "B-axis
kinematics" function has been activated via $TC_CARR37[n].
Offset vectors I1 to I4
The vectors always contain three components which represent the reference to the machine
axes (X, Y, Z). The positions in the kinematic chain are measured by the machine
manufacturer; they are always relevant with respect to a swivel head / swivel table (swivel data
set). Offset vectors I1 to I4 refer to the non-swiveled state of the rotary axes (machine
kinematics basic setting).
The machine kinematics used do not need to be fully implemented. However, be aware that
the traversing range in the swivel planes may be restricted. If machine kinematics are to be
implemented with just one rotary axis, this must always be declared as the 1st rotary axis.
$TC_CARR1[n], $TC_CARR2[n], $TC_CARR3[n] Offset vector I1xyz

Rotary axis vectors V1 and V2
$TC_CARR7[n], $TC_CARR8[n], $TC_CARR9[n] Rotary axis vector V1xyz

$TC_CARR10[n], $TC_CARR11[n], $TC_CARR12[n] Rotary axis vector V2xyz

Configuring cycles
21.7 Swiveling
Kinematic types $TC_CARR23[n]
Swivel head (type T) Swivel table (type P) Swivel head +

Swivel table (type M)
Offset vector I1 Offset vector I2 Offset vector I1

Rotary axis vector V1 Rotary axis vector V1 Rotary axis vector V1
Offset vector I2 Offset vector I3 Offset vector I2
Rotary axis vector V2 Rotary axis vector V2 Offset vector I3
Offset vector I3 Offset vector I4 Rotary axis vector V2
Offset vector I4
References
You can find additional information in:
● Function Manual Basic Functions; Tool Offset (W1)
● Function Manual Special Functions; Multiple Transformations (F2)

Configuring cycles
21.7 Swiveling
Name of the swivel data set
Figure 21-4 Dialog to input parameters for the swivel data set
If several swivel data sets are declared in each NC channel, then a name is assigned to each
swivel data set. $TC_CARR34[n]
No name needs to be specified if the swivel-mounted tool carrier is not exchangeable (i.e. one
swivel data set per channel).
The name of the swivel data set may only contain characters that are permissible for NC
programming: A...Z, 0...9 and _ !
If several NC channels have been set up, note the settings in MD28085, Chapter "Technology
cycles for swiveling (Page 517)". If a TO unit is assigned to several NC channels, the channel
display in the dialog corresponds to the TO unit.
Offset vectors I1 to I4 $TC_CARR1[n] ... $TC_CARR20[n]

The vectors always contain three components which represent the reference to the machine
axes (X, Y, Z). The positions in the kinematic chain are measured by the machine
manufacturer; they are always relevant with respect to a swivel head / swivel table (swivel data
set).
Offset vectors I1 to I4 refer to the non-swiveled state of the rotary axes (basic setting: machine
kinematics). However, be aware that the traversing range in the swivel planes may be

Configuring cycles
21.7 Swiveling
restricted. If machine kinematics are to be implemented with just one rotary axis, this must
always be declared as the 1st rotary axis.
Manually adjustable rotary axes (manual mode) are possible with and without measuring
systems and can be used with "simple machines".
Rotary axes that are positioned by an additional mechanical system, can be declared in the
"Semiautomatic" mode.
Example
In a boring mill, the swivel head is positioned by coupling the spindle. In this case, the rotary
axes of the swivel head must be declared as "Semiautomatic". The appropriate machine-
specific cycles are called in CUST_800.SPF.
Swivel head
● I3 distance from the tool adapter to the pivot point/intersection of the 2nd rotary axis
● I2 distance from the pivot point/intersection of the 2nd rotary axis to the pivot point/
intersection of the 1st rotary axis
● I1 closure of the I1=-(I2+I3) vector chain, if the swivel head cannot be changed
Swivel table
● I2 distance from the machine reference point to the pivot point/intersection of the 1st rotary
axis
● I3 distance from the pivot point/intersection of the 1st rotary axis to the pivot point/
intersection of the 2nd rotary axis (or to the reference point of the tool adapter)
● I4 closure of the I4=-(I2+I3) vector chain, if the swivel table cannot be changed
Swivel head/swivel table (mixed kinematics)

● I2 distance from the tool adapter to the pivot point/intersection of the 1st rotary axis
● I1 closure of the I1=-I2 vector chain, if the swivel head cannot be changed
● I3 distance from the machine reference point to the pivot point/intersection of the 2nd rotary
axis (or to the reference point of the tool adapter)
● I4 closure of the I4=-I3 vector chain, if the swivel table cannot be changed
The offset vectors do not have to point to the pivot point of the rotary axes. The important thing
is that they point to a point on the direction of rotation (intersection).
The sign of the offset vectors (I1 to I4) and the rotary axis vectors (V1, V2) result from the
specifications of the axis directions according to ISO 841-2001 or DIN 66217 (right-hand rule).

Configuring cycles
21.7 Swiveling
In the case of machine kinematics that move the workpiece (rotary table), the axis direction is
reversed.
Note
Interrelation of TOOLCARRIER ⇔ 5-axis transformation (transformer type 24, 40, 56):
For 5-axis transformation, transformer type 72 in MD24100: $MC_TRAFO_TYPE_1 can be
used.
In the case of transformer type 72, the vectors of the TOOLCARRIER in MD24582:
$MC_TRAFO5_TCARR_NO_1 are used.
Swivel head (swivel-mounted tool)

$TC_CARR23[1]="T" MD24100: $MC_TRAFO_TYPE_1=24
I1 $TC_CARR1...3[n] MD24500: $MC_TRAFO5_PART_OFFSET_1 [0...2]
I2 $TC_CARR4...6[n] MD24560: $MC_TRAFO5_JOINT_OFFSET_1 [0...2]
I3 $TC_CARR15...17[n] MD24550: $MC_TRAFO5_BASE_TOOL_1 [0...2]
Closure of the I1=-(I2+I3) vector chain; for fixed-mounted machine kinematics
Swivel table (swivel-mounted workpiece)

$TC_CARR23[1]="P" MD24100: $MC_TRAFO_TYPE_1=40
I2 $TC_CARR4...6[n] MD24550: $MC_TRAFO5_BASE_TOOL_1 [0..2]
Closure of the I4=-(I2+I3) vector chain; for fixed-mounted machine kinematics
Swivel head + swivel table (swivel-mounted tool + workpiece)

$TC_CARR23[1]="M" MD24100: $MC_TRAFO_TYPE_1=56
I2 $TC_CARR4...6[n] MD24550: $MC_TRAFO5_BASE_TOOL_1 [0...2]
I3 $TC_CARR15...17[n] MD24558: $MC_TRAFO5_JOINT_OFF‐
SET_PART_1[0...2]
Closure of the I1=-I2 I4=-I3 vector chain; for fixed-mounted machine kinematics
Rotary axis vectors V1, V2

V1 $TC_CARR7..9[n] MD24570: $MC_TRAFO5_AXIS1_1[0..2]
V2 $TC_CARR10..12[n] MD24572: $MC_TRAFO5_AXIS2_1[0..2]
Fine offsets of offset vectors
$TC_CARR41[n] to $TC_CARR60[n]

Configuring cycles
21.7 Swiveling
Assignment of base vectors to the fine offset vectors:
I1 $TC_CARR1..3[n] to $TC_CARR41..43[n]
The fine offsets are activated by the following setting data:
SD42974 $SC_TOCARR_FINE_CORREC‐ Fine offset TCARR on/off

TION = 1
=0 When activating a tool carrier that can be oriented, the fine offset values are not taken into
account.
=1 When activating a tool carrier that can be orientated, the fine offset values are taken into
account.
The fine offsets act in addition to the corresponding base vectors when the Swivel function
CYCLE800 or the NC function TCARR=n is called.
Name of rotary axes
Figure 21-5 Dialog to input parameters for the rotary axis

Configuring cycles
21.7 Swiveling
The following identifiers should be preferably chosen for the names of the rotary axes:
● Rotary axis rotates around machine axis X → A
● Rotary axis rotates around machine axis X → B
● Rotary axis rotates around machine axis Z → C
For automatic rotary axes, the channel names of the corresponding NC rotary axes must be
entered (see $TC_CARR37[n] TENS and HUNDREDS position: Automatic mode). For manual
(manually adjustable) and semiautomatic rotary axes, you can use any axis identifier (up to
six letters or digits).
Manual and semiautomatic rotary axes are not defined in the NC. With manual rotary axes,
the value for the angular range is entered in the dialog box. Semiautomatic rotary axes are
moved mechanically on the machine, e.g. through a coupled spindle. The adaptations for this
can be made in the CUST_800 manufacturer cycle. The value for the angular range must not
be specified, the rotary axis positioning is performed automatically.
$TC_CARR35[n] Name of rotary axis 1

$TC_CARR36[n] Name of rotary axis 2
System variable $TC_CARR37[n]

In order that a value can be displayed in the input/selection boxes of the dialog for swiveling,
the following display versions can be set:
Meaning of the decimal positions
$TC_CARR37[n] Display variants of the input screens for CYCLE800

Decimal place Meaning
ONES Selects the swivel mode
0= Axis-by-axis
1= Axis-by-axis + projection angle
2= Axis-by-axis + projection angle + solid angle
3= Axis-by-axis + direct
4= Axis-by-axis + projection angle + direct
5= Axis-by-axis + projection angle + solid angle + direct
TENS Rotary axis 1
0 = Automatic
1 = Manual
2 = Semiautomatic
HUNDREDS Rotary axis 2
0 = Automatic
1 = Manual
2 = Semiautomatic

Configuring cycles
21.7 Swiveling

THOUSANDS Selection field direction: Direction selection of the rotary axes
0 = No display of the direction reference for kinematics that only have
one solution. Direction selection (_DIR) Minus is generated in the
cycle call CYCLE800.
3 = Direction reference, rotary axis 1, direction selection Minus in the
basic setting of the kinematics.
4 = Direction reference, rotary axis 2, direction selection Minus in the
5 = No display of the direction reference for kinematics that only have
one solution. Direction selection (_DIR) Plus is generated in the
cycle call CYCLE800.
8 = Direction reference, rotary axis 1, direction selection Plus in the
9 = Direction reference, rotary axis 2, direction selection Plus in the
The values 1, 2, 6 and 7 are not permitted.
TEN THOUSANDS Selection field, correction of the tool tip or B axis kinematics
0 = No display of the correction of the tool tip input field.
1 = Correction of tool tip by means of TRAORI.
2 = No correction of tool tip + B axis kinematics turning technology.
3 = Correction of tool tip + B axis kinematics turning technology.
The Correction of tool tip function requires the "5-axis transforma‐
tion (TRAORI)" option.
HUNDRED THOU‐ Basic position of the kinematics 1)
SAND
0 = Corresponding to the working plane G17, G18 or G19 (compati‐
bility)
1 = Tool axis in the Z direction
3 = Tool axis in the X direction
ONE MILLION TEN Selection field, retraction
MILLION
00 = No retraction
01 = Retraction Z
02 = Retraction Z, XY
03 = Retraction Z or Z, XY
04 = Maximum retraction in tool direction
...
08 = Incremental retraction in tool direction
...
15 = Retraction Z or Z, XY or
in maximum tool direction or in incremental tool direction
$TC_CARR38[n] Retraction position X
$TC_CARR39[n] Retraction position Y
$TC_CARR40[n] Retraction position Z

Configuring cycles
21.7 Swiveling

HUNDRED MILLION Swivel data set enabled
Setting swivel data set change
Automatic or manual tool change is only necessary under ShopMill or Shop‐
Turn (→ see also: CUST_800.spf, markers _M2 to _M13).
A swivel data set must be "enabled" in every case (value ≥ 4).
0 = Swivel data set not enabled
4 = Swivel data set enabled
automatic swivel data set and tool change
automatic swivel data set change and manual tool change
manual swivel data set change and automatic tool change
manual swivel data set and tool change
Notes on the setting Basic position of the kinematics 1)

For turning machines (1st technology is turning) with a B axis, you can set whether the tool
is oriented toward "-Z" or toward "-X" in the basic position of the kinematics. This setting is
taken into account for "Align tool" and for "Swivel plane".
Align tool
● For "Align tool", the programming of beta and gamma is machine-independent.
● With the basic position setting "Working plane" or "-Z", beta = 0 also corresponds to this
basic position (compatibility).
● With the basic position setting "-X", the B axis is re-oriented through 90° for beta = 0.
Swivel plane (new swivel plane)

● With the basic position setting "Working plane" or "-Z" and active working plane G17, there
is no new tool orientation for swivel plane to basic position (compatibility).
● With the basic position setting "-X" and active working plane G17, the tool orientation is
rotated 90° around Y for swivel plane to basic position.
Therefore, with the basic position setting "-X", milling is possible in a swiveled plane in different
working planes (G17 or G19).
The following settings and programming is not permitted and results in error messages:
● Swivel plane, basic position -Z and G18 or G19 active
● Swivel plane, basic position -X and G18 active

Configuring cycles
21.7 Swiveling
Retracting the geometry axes before swiveling
Figure 21-6 Dialog to select the type of retraction
Select the retraction variant in the input field: This is defined in the ONE MILLION and TEN
MILLION position of the system variable $TC_CARR37[n]:
● Retract axis Z
● Retract axes Z, XY
● Retract in the tool direction, maximum or incremental
NOTICE
Collision avoidance
Make sure that the tool and the workpiece cannot collide during swivelling when moving the
tool axes.
Retracting axis Z or retracting axes Z, XY is realized as an absolute machine position at the

values of parameters $TC_CARR38[n] to $TC_CARR40[n].
$TC_CARR38[n] Retraction position X

$TC_CARR39[n] Retraction position Y
$TC_CARR40[n] Retraction position Z

Configuring cycles
21.7 Swiveling
The type of retraction is modified in the Manufacturer cycle CUST_800.SPF (Page 548).
Note
Retraction in the tool direction is useful for swivel data sets in which the tool is re-oriented
(swivel head or mixed kinematics). This applies particularly for turning machines with a B axis.
During retraction in "maximum tool direction", traversing is performed until one of the relevant
linear axes reaches the software limit switch.
21.7.4 Examples of machine kinematics for the commissioning of the Swivel function
Example 1: Swivel head 1 "HEAD_1"

The vectors in the drawing refer to the initial setting of the kinematics. The drawing is not true
to scale. The swivel head is exchangeable and manually adjustable.
<
;

,
&
,

$

,
/
/ WRROOHQJWK
C Rotary axis 1 (manual) rotates about Z.

A Rotary axis 2 (manual) rotates about X.
Figure 21-7 Exchangeable swivel head with steep taper to hold the spindle

Configuring cycles
21.7 Swiveling
Kinematics Swivel head HEAD_1

Retract Z
X Y Z
200.000
Offset vector I1 0.000 0.030 -63.000
Rotary axis vector V1 0.000 0.000 1.000
Offset vector I2 0.000 0.000 40.000
Offset vector I3 0.000 -0.030 23.000
Display version
Swivel mode Axis-by-axis
Direction reference Rotary axis 2
Correct tool No
Rotary axes
Rotary axis 1 C Mode Manual
Angular range 0.000 360.000
Rotary axis 2 A Mode Manual
Angular range -15.000 100.000

Configuring cycles
21.7 Swiveling
Example 2: Swivel head 2 "HEAD_2"

The vectors in the drawing refer to the initial setting of the kinematics. If the swivel head is
fixed-mounted, the vector chain is closed. The reference point of the center of rotation of rotary
axes 1 and 2 can be offset on the line of rotation and does not have to coincide with the
mechanical center of rotation.
5RWDU\D[LV
9
9
JUG
,
, 5RWDU\D[LV

, &HQWHURIURWDWLRQRI
URWDU\D[LV =
&HQWHURIURWDWLRQ
RIURWDU\D[LV <
5HIHUHQFHSRLQW ;
RIWRRO
Rotary axis vector V1 Rotary axis 1 rotates about Y.

Rotary axis vector V2 Rotary axis 2 rotates about Y and about Z.
Offset vector I1 Closure of vector chain with fixed-mounted swivel head, I1 = - (I2 + I3).
Offset vector I2 The distance between the center of rotation of rotary axis 1 and center of
rotation of rotary axis 2
Offset vector I3 The distance between the reference point of the tool and the center of rotation
of rotary axis 2.
Figure 21-8 Cardanic swivel head with Hirth joint, manually adjustable

Retract Z Tool direction Max.+inc.
X Y Z
200.000
Offset vector I1 0.000 -172.000 -265.800
Offset vector I2 0.000 172.000 172.000
Rotary axis vector V2 0.000 1.0001) 1.0001)
Offset vector I3 0.000 0.000 93.800
Display version

Configuring cycles
21.7 Swiveling

Rotary axes
Rotary axis 1 B Mode Manual
Kinematics offset 0.000
Hirth joint Yes Angular grid 1.000
Rotary axis 2 C Mode Manual
Kinematics offset 0.000
1) Calculation of rotary axis vector:

V2: 45 degree angle
V2Y = sin(-45) = -0.7071
V2Z = cos(-45) = 0.7071
V2Y and V1Z can be normalized to 1.
Example 3: Cardanic table "TABLE_45"
The vectors in the drawing refer to the initial setting of the kinematics. The spindle (tool adapter)
is positioned on a gage block above the top edge of the table/center of the table (rotary axis
C). A test mandrel in the spindle is used to determine the center of rotation of rotary axis C.

Configuring cycles
21.7 Swiveling
5HIHUHQFHSRLQWRIWKHPDFKLQH
0.6;<=
9 ,
,]
,\
,
¡
,]
,
5RWDU\D[LV& 5RWDU\D[LV%
=
9
<
;
Rotary axis vector V1 Rotary axis B rotates around Y and around Z.

Rotary axis vector V2 Rotary axis C rotates about Z.
Offset vector I2 The distance from the reference point of the machine to the center of rotation/
intersection of rotary axis 1.
Offset vector I3 The distance from the center of rotation/intersection of rotary axis 1 to the
center of rotation/intersection of rotary axis 2.
Offset vector I4 Closure of vector chain, I4 = - (I2 + I3).
Figure 21-9 Side view of the machine
Kinematics Swivel table TABLE_45

X Y Z
Offset vector I2 0.000 -100.000 -20.000
Rotary axis vector V1 0.000 -1.0001) 1.0001)
Offset vector I3 0.000 0.000 -30.000
Rotary axis vector V2 0.000 0.000 -1.000
Offset vector I4 0.000 100.000 50.000
Display version
Correct tool No
Rotary axes
Rotary axis 1 B Mode Auto

Configuring cycles
21.7 Swiveling

Rotary axis 2 C Mode Auto

V1: β = -45 degrees
V1Y= sin(-45)= -0.7071
V1Z= cos(-45)= 0.7071
V1Y and V1Z can be normalized to -1 and 1.
Example 4: Swivel head/rotary table "MIXED_45"
C). A measuring rod in the spindle is used to determine the turning center of rotary axis C.

Configuring cycles
21.7 Swiveling
9
=
5RWDU\D[LV%
<
; O
O]
O O O
O\
5HIHUHQFHSRLQWRI O O 5RWDU\D[LV&

WKHPDFKLQH
0.6;<=
9
Rotary axis vector V1 Rotary axis B rotates around Y and around Z.

Offset vector I2 The distance from the reference point of the tool adapter to the center of
rotation/intersection of rotary axis 1
Offset vector I1 Closure of vector chain, I1 = - I2.
Offset vector I4 Closure of vector chain, I4 = - I3.
Figure 21-10 Side view of the machine
Kinematics Mixed kinematics MIXED_45

X Y Z
Offset vector I1 0.000 0.000 -30.600
Rotary axis vector V1 0.000 1.000 1)
1.0001)
Offset vector I2 0.000 0.000 30.600
Offset vector I3 300.000 150.000 0.000
Offset vector I4 -300.000 -150.000 0.000
Display version
Direction Rotary axis 1
Correct tool Yes
Rotary axes
Rotary axis 1 B Mode Auto

Configuring cycles
21.7 Swiveling
Kinematics Mixed kinematics MIXED_45


V1: β = 45 degrees
V1Y= sin(-45)= -0.7071
V1Z= cos(-45)= 0.7071
V1Y and V1Z can be normalized to 1.
Example 5: Swivel table "TABLE_5"
C). A measuring rod in the spindle is used to determine the turning center of rotary axis C.

Configuring cycles
21.7 Swiveling
9
<
; 5RWDU\D[LV&
O
O
O\
O
O\ 5RWDU\D[LV$
5HIHUHQFHSRLQWRI 9
WKHPDFKLQH
0.6;<=

Offset vector I3 The distance from the center of rotation of rotary axis 1 to the center of rota‐
tion/intersection of rotary axis 2.
Figure 21-11 Side view of the machine from the X direction

Configuring cycles
21.7 Swiveling
9
=
<
;
5RWDU\D[LV&
O O O
O ,,
O]
O
O[ 5RWDU\D[LV$ 9
5HIHUHQFHSRLQWRI
WKHPDFKLQH
0.6;<=
Rotary axis vector V1 The rotary axis A rotates about X.

Offset vector I3 The distance from the center of rotation of rotary axis 1 to the center of rota‐
tion/intersection of rotary axis 2.
Figure 21-12 Front view of the machine from the Y direction

X Y Z
Offset vector I2 260.000 200.000 0.000
Rotary axis vector V1 -1.000 0.000 0.000
Offset vector I3 0.000 0.020 20.400
Offset vector I4 -260.000 -200.020 -20.400
Display version
Direction Rotary axis 1
Correct tool No
Rotary axes
Rotary axis 1 A Mode Auto
Angular range -90.000 90.000

Configuring cycles
21.7 Swiveling

Example 6: Setting up a turning machine with B axis

For turning machines with an additional rotary axis B, the tool can be aligned or swiveled on
the X/Z plane. If your machine has a counterspindle, you can, for example, machine with a
tool alternating between the main spindle and counterspindle.
You require the following swivel data sets to use the "Align tool" and "Swivel plane" functions:
● Swivel data set 1 for aligning and swiveling tools on the main spindle and counterspindle
(turning, face Y/C, surface Y/C).
● Swivel data set 2 for machining inclined surfaces when milling on the main spindle (face
B).
● Swivel data set 3 for machining inclined surfaces when milling on the counterspindle (face
B).
When commissioning the "B-axis kinematics turning technology" in parameter
$TC_CARR37[n], the TEN THOUSANDS position must be set to 2 or 3 in swivel data set 1.
This is the reason why in the program editor "Swivel tool → align turning or milling tool" is listed
for swivel data set 1.
See also Section "Commissioning swivel data (kinematics chain) (Page 526)"
Example 7: Configuring a milling machine with B axis for turning.

You can configure a milling machine with a B axis (rotation around Y) so that turning is possible.
The following example refers to a milling machine with a rotary axis around Y (B), a rotary axis
around Z (C) and a main spindle (SP) in the tool direction Z (G17).
You require the following swivel data sets to use the "Align tool" and "Swivel plane" functions:
● Swivel data set 1 for "Swiveling in the plane" when milling.
Mixed kinematics: Rotary axis 1: B-axis, rotary axis 2: C axis
● Swivel data set 2 for the "Swivel tool - align tool" when turning
Swivel head: Rotary axis 1: B-axis, rotary axis 2: Spindle SP
When milling, the SP spindle is the master spindle. Rotary axis C is declared as the master
spindle in rotational operation, e.g. SETMS(2).
When commissioning the "B-axis kinematics turning technology" in parameter
$TC_CARR37[n], the TEN THOUSANDS position must be set to 2 or 3 in swivel data set 2.
This is the reason why in the program editor "Swivel tool → align turning or milling tool" is listed
for swivel data set 2.
See also Section "Commissioning swivel data (kinematics chain) (Page 526)"

Configuring cycles
21.7 Swiveling
References
Function Manual Basic Functions; W1: Tool offset, parameter CUTMOD:
● The CUTMOD NC function is activated when data set 2 is called in the NC program
(CYCLE800 align turning tool). This means that the cutting edge position or the tool
reference point is updated corresponding to the tool orientation:
● When calling a swivel data set for rotational operation in the NC program (CYCLE800 align
tool), the CUTMOD NC function is activated. The cutting edge position, tool angle, cut
direction and tool reference point are thus calculated in accordance with the current tool
orientation following the "Align tool" function.
21.7.5 Manufacturer cycle CUST_800.SPF
Function
During swiveling, all axis positions are approached using the CUST_800.SPF cycle. The call
is exclusively made from the swivel cycle CYCLE800 or from the cycles
E_TCARR (ShopMill) or F_TCARR (ShopTurn).
In cycle CUST_800.SPF, the function markers (_M2: to _M59) are prepared and documented.
Also refer to the following "Structogram CYCLE800".
There are extensions in the CUST_800.SPF cycle for the "Turning on milling machine" function,
see Chapter "Adaptations for CUST_800 (Page 566)".
Note
If you modify the CUST_800, ensure that the G commands of the G groups used are restored
at the end of the CUST_800 (versions S_G_1 to S_G_5!).
Parameter
CUST_800 (INT _MODE, INT _TC1, REAL _A1, REAL _A2, INT _TC2, REAL _T_POS)
_MODE A jump is made to markers _M2 to _M59

_TC1 Number of the swivel head/table
_A1 Angle of rotary axis 1
_A2 Angle of rotary axis 2
_TC2 Feed evaluation in percent (%) for swiveling in JOG mode and number of the new swivel
head/table when replaced in ShopMill
_T_POS Incremental position during retraction in the incremental tool direction (see marker _M44,
_M45)

Configuring cycles
21.7 Swiveling
Retract prior to swiveling

If the CUST_800.SPF cycle is not modified, the Z axis (marker _M41) or the Z axis followed
by the X, Y axes (marker _M42) are first traversed in the Machine to the positions when
retracting prior to swiveling. The freely available position values are specified in the system
variables $TC_CARR38[n] to $TC_CARR40[n]. When retracting, the active tool cutting edge
is deselected (D0) and is reselected after retraction.
If retraction in the tool direction had been declared, the tool axis is retracted to the software
end position (maximum in tool direction) or by an incremental distance away from the tool in
the tool direction. The tool lengths are taken into account accordingly.
6WUXFWXUHFRDUVHRIVZLYHOF\FOHV

,QSXWVFUHHQIRUPXQGHU6KRS0LOO6KRS7XUQ ,QSXWVFUHHQIRUPIRU&<&/(VWDQGDUGF\FOH
&867B63)
/DEHOB0B0
(B7&$5563)
)B7&$5563)
&<&/(63) /DEHOB0B0
(QGRIF\FOH
Figure 21-13 Structure (coarse) of swivel cycles

Configuring cycles
21.7 Swiveling
CYCLE800 structured chart

Sequence in AUTOMATIC mode
6WUXFWXUH&<&/(63) &867B63)
,QSXWSDUDPHWHUV
QDPHRIVZLYHOGDWDVHW
PRGH
RIIVHWV
URWDWLRQV
UHWUDFWLRQ
&DOFXODWLRQRI ,QLW
YDOLGVZLYHOGDWDVHW /DEHOB0,QLW 5HZULWHYHFWRUV
NLQHPDWLFFKDLQLVSRVVLEOH
IRUH[DPSOHWHPSHUDWXUHFRPSHQVDWLRQ
YHFWRUVRULQFOXVLRQRI
6ZLYHOGDWDVHWLQYDOLG :D[LVLQGULOOLQJWRROV
)DXOWPHVVDJHV
5HWUDFWLRQ $GDSWDWLRQRI
/DEHO
7RROD[LV UHWUDFWLRQVWUDWHJ\
B0=D[LV
B0=D[LV;<
D[LV
B0PD[WRROGLUHFWLRQ
B0WRROGLUHFWLRQLQF
1RUHWUDFWLRQ
7UDYHUVHURWDU\D[HVIRU1&D[HV
/DEHO
FDOFXODWLRQRIWKH B0VZLYHOURWDU\D[HVDXWRPDWLFDOO\
URWDU\D[LVDQJOH B0VZLYHOURWDU\D[LVDXWRPDWLFDOO\
GLVSOD\DQJOHYDOXHVWREHVHW URWDU\D[LVPDQXDOO\RUVHPLDXWRPDWLFDOO\
PDQXDOURWDU\D[HV B0VZLYHOURWDU\D[LVDXWRPDWLFDOO\
GHDFWLYDWHD[LVWUDQV B0VZLYHOURWDU\D[LVPDQXDOO\RUVHPLDXWRPDWLFDOO\
IRUPDWLRQ B0VZLYHOURWDU\D[LVDXWRPDWLFDOO\
URWDU\D[LVPDQXDOO\RUVHPLDXWRPDWLFDOO\
B0VZLYHOURWDU\D[HVPDQXDOO\RU
VHPLDXWRPDWLFDOO\
1RWUDYHUVLQJ B0B0B0VZLYHOLQ-2*ZLWK75$25,
RIURWDU\D[HV
(QGRIF\FOH
Figure 21-14 Structure: CYCLE800.SPF / CUST_800.SPF

Configuring cycles
21.7 Swiveling
6WUXFWXUH(B7&$5563))B7&$5563) &867B63)

7RROQDPH 7KHIROORZLQJVWUXFWXUHUHIHUVWRWKHVZLYHOGDWDEORFNFKDQJHDQGWKH
,QSXWGDWDIRUVZLYHOLQJ DVVRFLDWHGWRROFKDQJHXQGHUPLOOLQJWXUQLQJ
6'6!6ZLYHOGDWDVHW
\HV
2OG6'6
1HZ6'6"
QR 2OG6'6 \HV /DEHOB0&KDQJHPDJD]LQHWRRO

6ZLYHO B0&KDQJHPDQXDOWRRO
KHDG"
QR
$XWRPDWLFDOO\ \HV /DEHOB0$XWRPDWLFDOO\FKDQJH

FKDQJH VZLYHOKHDGWDEOH
6'6ROGQHZ"
QR
$XWRPDWLFDOO\ \HV /DEHOB00DQXDOO\FKDQJH

FKDQJH VZLYHOKHDGWDEOH
6'6ROGQHZ"
QR
$XWRPDWLFDOO\ /DEHOB0$XWRPDWLFDOO\FKDQJH
FKDQJH \HV VZLYHOKHDGWDEOH"
6'6ROG /DEHOB0$XWRPDWLFDOO\FKDQJH
0DQXDOO\FKDQJH VZLYHOKHDGWDEOH"
6'6QHZ"
QR
/DEHOB00DQXDOO\FKDQJH
0DQXDOO\FKDQJH \HV VZLYHOKHDGWDEOH"
6'6ROG"
$XWRPDWLFDOO\FKDQJH /DEHOB0$XWRPDWLFDOO\FKDQJH
6'6 VZLYHOKHDGWDEOH"
QHZ"
QR
\HV /DEHOB0&KDQJHPDJD]LQHWRRO
7RRO
FKDQJH" B0&KDQJHPDQXDOWRRO
QR /DEHOB06ZLYHODIWHUWRROFKDQJH$872
B06ZLYHODIWHUWRROFKDQJH-2*
/DEHOB05HWUDFWLRQDIWHUVZLYHOLQJ
(QGRIF\FOH
Figure 21-15 Structure: E_TCARR.SPF (F_TCARR.SPF) / CUST_800.SPF

Configuring cycles
21.7 Swiveling
Note on markers _M2 to _M13

When the swivel data set or tool is changed, the linear axes are recovered using the last
retraction mode (modal).
If this behavior is not desired in milling/turning, the corresponding calls must be commented
out with a semicolon (;). The E_SWIV_H or F_SWIV_H cycle is called in milling/turning (see
markers _M2 to _M9) in the CUST_800.SPF manufacturer cycle.
Parameter E_SWIV_H (Par1, Par2, Par3)
● Par1: Number of swivel data set (_TC1)
● Par2: Angle 1st rotary axis
● Par3: Angle 2nd rotary axis
Modification examples
If the rotary axes (swivel head/table) are not to be positioned during swivel data change / tool
change, the call of the E_SWIV_H cycle can be commented out at the relevant markers. If the
rotary axes are to move to a certain position, an angle value can be transferred to parameters
Par 2, Par 3.
Note on labels _M14, _M15

Depending on the values of the retraction plane and the programmed swivel plane, it is possible
that the linear axes now also travel the swiveled retraction plane while running up from the
current position to the software limit switches after a block search. To avoid this problem, label
_M14 in the CUST_800.SPF is called after swiveling. The E_SP_RP(30) cycle preset there
runs up to the milling retraction plane, whereby travel may be along the software limit switches.
An appropriate retraction after block search can be set at label _M15.
Note on the label _M16

If for a swivel data set change or when de-selecting the swivel data set, you wish to traverse
the rotary axes to zero, the syntax of the _M16 label can be modified accordingly, e.g. activate
block N8006 E_SWIV_H(_TC1,0,0).
Note on labels _M20 to _M31

Markers _M20 to _M31 are distinguished by machine kinematics with two rotary axes or one
rotary axis. A distinction is also made between automatic rotary axes (known to the NCU) and
manual (semi-automatic) rotary axes. There is only ever one valid label for swiveling with the
active swivel data set.
Note on label _M35

Run through _M35 for block search and a swivel data set with manual rotary axes.

Configuring cycles
21.7 Swiveling
Note on label _M40

This label is called before the calculation and activation of the Tool holder function as user
initialization. This makes it possible for special kinematics, to calculate or rewrite the current
vectors of the active swivel data set.
Boring mill application example: For parallel axes, the vector in the Z direction can be updated
with the actual value of the W axis.
A STOPRE is integrated for this label.
Manufacturers can test as to whether this STOPRE for label M40 in CUST_800.spf complies
with their functional requirements. In this case, one must weigh up between velocity (without
STOPRE) and functionality for interrupt conditions (RESET) for a swivel plane. This also
depends on the type of machine kinematics.

The retraction strategy prior to swiveling the rotary axes can be modified at the labels _M41
to _M45.
The retraction to the MCS positions Z or Z, XY is made considering the tool length components
without tool cutter deselection.
Note on labels _M41 and _M42

When retracting in Z or Z, XY with mixed swivel head kinematics, the NC takes account of the
kinematics reference point. If the head is tilted, positions are approached that might deviate
from the values of the retraction position $TC_CARR38 to $TC_CARR40.
If you do not want this, you can deactivate and then reactivate the current tool holder at the
labels _M41/_M42 and in the calculations of the tool components in cycle CUST_800.SPF.
Example:
IF (_MODE==41)OR(_MODE==42)
TCARR=0 ;deactivate tool holder
IF $P_GG[6]==1
...
ENDIF
TCARR=_TC1 ;reactivate tool holder
ENDIF
_M41: ;axis Z MCS fixed point
...
TCARR=0 ;deactivate tool holder
IF($MN_G53_TOOLCORR .....
...
ENDIF
TCARR=_TC1 ;reactivate tool holder
Note on label _M46

Retraction before swiveling after a block search can be set at label _M46. Variable _E_VER
is 1 if it is a milling technology program.

Configuring cycles
21.7 Swiveling

Labels _M57 to _M59 are used for swiveling in JOG mode and active 5-axis transformation
(TRAORI).
Note on "Correct tool"

"Correct tool" requires that a 5-axis transformation is set up which is equivalent to the
corresponding swivel data set. The programming section for "Correct tool" is integrated in the
markers _M20, _M21, _M22 and _M30. The first 5-axis transformation is called with TRAORI(1).
Note on tool change + swivel

In general, the swivel (CYCLE800) and tool change functions for a machine are independent
of each other. Thus, the swiveled work plane can be retained in a technological sequence with
multiple tools, e.g. centering, drilling, tapping.
If the rotary axes of the active swivel data set are involved in the mechanical sequence of the
tool change or have to be retracted, this must be taken into account in the tool change program.
After the tool change, the rotary axis positions are approached as prior to the tool change. If
linear axes (geometry axes) are also involved in the tool change, the rotations in the NC (swivel
frame) must not be deleted. Rather, the linear axes can be positioned as machine axes using
the G153 or SUPA commands.
Note on swiveling without active tool compensation

If swiveling the rotary axes without active tool cutting edge (D0) is not possible, then you can
adapt this in cycle CUST_800.SPF:
_M40:
IF ((NOT $P_TOOL) AND _TC1)
LOOP
MSG ("No tool cutting edge active")
M0
STOPRE
ENDLOOP
ENDIF
GOTOF_MEND
21.7.6 CYCLE996 measure workpiece kinematics
Function
With the Measure kinematics function, it is possible to calculate the geometric vectors used to
define the 5-axis transformation (TRAORI and TCARR) by measuring the position of the ball
in space.
The measurement is essentially carried out by means of workpiece probes, which scan three
positions of a measuring ball on each rotary axis. The ball positions can be defined in
accordance with user specifications so that they correspond to the geometric ratios on the

Configuring cycles
21.7 Swiveling
machine. The only way of setting the ball positions is to reposition the rotary axis that is to be
measured in each case.
Aside from the basic mechanics of the machine, no specific knowledge is required to use
CYCLE996. No dimension drawings or machine location diagrams are necessary to carry out
measuring.
Application range
The Measure kinematics function (CYCLE996) can be used to determine the data that is
relevant to transformations in the case of kinematic transformations that involve rotary axes
(TRAORI, TCARR).
Options:
● Redetermination of swivel data sets
– Commissioning the machine
– Use of swivel-mounted workholders as TCARR
● Checking swivel data sets
– Service following collisions
– Checking the kinematics during the machining process
Kinematics with manual axes (manually adjustable rotary tables, swivel-mounted workholders)
can be measured in the same way as kinematics with NC-controlled rotary axes.
When CYCLE996 is started, a swivel data set with basic data (for kinematics type) must be
parameterized. The measurement itself must be carried out without an active kinematic
transformation.
If, in the setting data SD55740 $MNS_MEA_FUNCTION_MASK bit 7 is set, then depending
on the setting, the kinematics can be measured based on the calculated or on the rotary axis
vectors saved in the swivel data set.
Requirements
The following requirements must be met in order to use CYCLE996 (Measure kinematics):
● SIEMENS measuring cycles package is installed
● Workpiece probe is calibrated
● Calibration ball is mounted
● Oriented tool carrier is set up (MD18088 MM_NUM_TOOL_CARRIER > 0)
● The basic geometry of the machine (X, Y, Z) is rectangular and referenced
The right angle refers to the workpiece spindle and should be preferably checked using a
test mandrel.
● Defined position of the rotary axes involved in the transformation
● Defined traverse directions in compliance with the standard of all axes involved in the
transformation according to ISO 841-2001 and/or DIN 66217 (righthand rule)
● Defined size of the protocol file (MD11420 $MN_LEN_PROTOCOL_FILE ≥ 20)

Configuring cycles
21.8 Turning on milling machines
The precise procedure when measuring and programming, including examples, is described
in the following manual:
References
Programming Manual, Measuring Cycles: CYCLE996

You can set up the turning technology as an extended technology on milling machines. The
operating software has all the setting options of a milling machine and a turning machine. For
example, the rotary table can be set at a high speed for the turning of the workpiece. The
turning tool is then clamped in the milling spindle and can be used in various positions.
21.8.1 Setting up machine data and setting data
Setting up parameters
Machine data
Set the following machine data to set up the technology:
MD10602 $MN_FRAME_GEOAX_CHANGE_MODE Frames when switching over geometry axes

=1 The current complete frame is calculated again when the geometry axes are switched
over, and the translations, scalings and mirrorings of the new geometry axes are effective.
The rotations of the old geometry axes are retained.
MD18114 $MN_MM_ENABLE_TOOL_ORIENT Assign orientation to cutting edges

=0 The tool orientation function is not active.
- OR -
=3 Each tool cutting edge D = m of tool T = n is assigned to the following system parameters:
$TC_DPV[n, m] and $TC_DPV3 - $TC_DPV5
$TC_DPVN3[n, m], $TC_DPVN4[n, m] and $TC_DPVN5[n, m]
Note
If you use angular tools (type 130) with variable tool orientation, you require the setting
MD18114 = 3.

Configuring cycles
MD51226 $MNS_FUNCTION_MASK_SIM Simulation function screen

Bit 5 = 1 Turning tool in tool spindle rotatable (for simulation)
MD51781 $MNS_MEA_T_PROBE_THICKNESS Tool probe thickness for the automatic approach

of turning tools to the probe on milling/turning ma‐
chines
=0 Default value
MD20100 $MC_DIAMETER_AX_DEF Geometry axis with transverse axis function

=X The machine data defines a geometry axis as transverse axis.
MD20110 $MC_RESET_MODE_MASK Definition of control initial setting after reset / end

of part program
Bit 0 = 1 Default value for system
MD20112 $MC_START_MODE_MASK Definition of the basic control setting after part pro‐
gram start
Bit 7 = 0 The current setting for the active transformation is retained.
MD20124 $MC_TOOL_MANAGEMENT_TOOL‐ Tool holder number

HOLDER
=1 Variable
MD20125 $MC_CUTMOD_ERR Alarm display for CUTMOD errors

= CFFFH Display alarms for CUTMOD errors
MD20150 $MC_GCODE_RESET_VALUES[21] Initial setting of the G groups

=2 Initial setting of G group 22 on CUT2DF
MD20150 $MC_GCODE_RESET_VALUES[55] Initial setting of the G groups

=3 Initial setting of G group 56 TOWWCS
MD20152 $MC_GCODE_RESET_MODE[21] Reset behavior of the G groups

=0 Reset behavior of G group 22
MD20152 $MC_GCODE_RESET_MODE[55] Reset behavior of the G groups

=3 Reset behavior of G group 56 TOWWCS

Configuring cycles
MD20360 $MC_TOOL_PARAMETER_DEF_MASK Definition of the tool parameters

Bit 17 = 0 With CUTMOD for turning and grinding tools, the cutting edge for the calculation of the
compensation values is not configured in the machining plane.
Bit 18 = 1 With CUTMOD for turning and grinding tools, always use the active plane for turning and
grinding tools.
MD24030 $MC_FRAME_ACS_SET SZS coordinate system setting

=1 SZS results from the WCS transformed with the $P_CYCFRAME
MD35040 $MA_SPIND_ACTIVE_AFTER_RESET[ ] Reset behavior of the spindle

[Tool spindle] = 2 Do not stop tool spindle during jog → spindle is listed in the T,S,M screen
[Turning spindle] = 2 Do not stop turning spindle during jog → spindle is listed in the T,S,M
screen
MD52001 $MCS_DISP_COORDINATE_SYSTEM_2 Definition of the displayed directions in the user

interface for turning operations (variable)
=0
MD52200 $MCS_TECHNOLOGY Technology

=2 Milling
MD52201 $MCS_TECHNOLOGY_EXTENSION Extended technology

=1 Turning
MD52206 $MCS_AXIS_USAGE[ ] Meaning of the axes in the channel

[Tool spindle] = 1 Tool spindle
[Turning spindle] = 3 Turning spindle
MD52207 $MCS_AXIS_USAGE_ATTRIB[turning spindle] Attributes of the axes

Bit 8 = 1 Offer rotary axis for blank clamping
MD52212 $MCS_FUNCTION_MASK_TECH General function screen for all technologies

Bit 10 = 1 Align the turning tool via kinematics transformation

Bit 1 = 1 Offer fixed table for blank clamping

Configuring cycles
Note
Only set bit 1 in MD52214 when a fixed table is used in addition to a rotary table.
MD52780 $MCS_J_MEA_T_PROBE_APPR_MO Approach mode for measuring a tool in JOG

DE
=0 Technology-dependent approaching of the tool probe (default value)
Turning technology: Manual approach
Milling technology: Automatic approach
=1 Technology-independent approaching of the tool probe
Manual approaching of the tool probe
=2 Technology-independent approaching of the tool probe
Automatic approaching of the tool probe
MD52242 $MCS_TURN_TOOL_FIXING Tool adapter for turning tools

=0 Turning tools in tool spindle
=1 Turning tools fixed on the tool headstock
=2 Turning tools in the tool spindle or fixed on the tool headstock
Note
Depending on the set mounting alignment in MD52242, different parameters are available in
the "Align Turning Tool" dialog.
Setting data
The following setting data is recommended: Set the setting data to set up the technology:
NOTICE
Risk of collision
Value changes of SD42940, SD42942 and SD42950 during the program execution can cause
collisions. Only set the setting data during the commissioning.
SD42935 $SC_WEAR_TRANSFORM Transformations for tool components

=1 Orientation for milling tools: Standard
G group 56: Observe or set TOWWCS
SD42940 $SC_TOOL_LENGTH_CONST Change of tool length components at change of

plane
= 17 L1 = Z, L2 = Y, L3 = X

Configuring cycles
SD42942 $SC_TOOL_LENGTH_CONST_T Change of tool length components for turning tools

at change of plane
= 19 L1 = Z, L2 = Y, L3 = X
Note
SD42942 is only evaluated after setting SD42950.
SD42950 $SC_TOOL_LENGTH_TYPE Assignment of the tool length offset independent

of tool type
=3 The assignment of the tool length components is performed separately for the turning and
grinding tools (tool types 400 to 599) on the one hand and all other tools (milling tools)
on the other hand.
SD42954 $SC_TOOL_ORI_CONST_M Change of tool orientation components for milling

tools at change of plane
=0 Orientation for milling tools: Standard
SD42956 $SC_TOOL_ORI_CONST_T Change of tool orientation components for turning

tools at change of plane
=0 Orientation for turning tools: Standard
SD42998 $SC_CUTMOD_PLANE_TOL Difference between tool tip plane and machining

plane
=5 Maximum permissible difference for gamma of 0° to 180°
SD42999 $SC_ORISOLH_INCLINE_TOL Difference between tool tip plane and machining

plane for ORISOLH
=1 Maximum permissible inclination of the tool tip compared to the G18 plane for "Align tool
directly"
Additional settings
● Set the current zero point in the center point of the turning tool, e.g. via a settable zero
offset.
● Change the tool before the "Align turning tool" cycle call.
● Program the tool in the part program for the simulation.
Note
No tool is active after the start of the simulation.
● After the "Align turning tool" cycle call, traverse the tool to Y = 0.

Configuring cycles
● Limit the maximum speed of the tool spindle, e.g. with the tool change cycle, in order to
avoid too high a speed of the turning tool.
● The turning tools in the tool management are automatically set up by the system. You can
make your own modifications in file sltmmillturnlistconfig.xml, for example, for the OEM tool
list.
21.8.2 Setting up a kinematics transformation

In order to be able to use the turning on milling machines technology, at least one kinematics
transformation must be set up for turning.
Requirement
A kinematic chain is already available for the machine.
For further information on kinematic chaining, see Chapter "Kinematic elements (Page 269)".
Set the following machine data to set up the kinematics transformation technology:
MD18866 $MN_MM_NUM_KIN_TRAFOS Maximum number of NC transformation objects

≥1 This machine data specifies the maximum number of NC transformations that can be
defined with kinematic chains (variable).
Setting up system variables

Use the following system variables to set up the kinematics transformation:

$NT_NAME[n] Name of the transformation that appears on the user interface
$NT_TRAFO_TYPE[n] Transformation type for turning and milling machines:
TRAORI_STAT
$NT_T_CHAIN_LAST_ELEM[n] Name of the chain element that describes the end of the chain
in the direction of the tool
$NT_P_CHAIN_LAST_ELEM[n] Name of the chain element that describes the end of the chain
in the direction of the workpiece
$NT_GEO_AX_NAME[n, 0 - 2] Name of the chain elements that describe the 1st to 3rd GEO
axis (X, Y, Z)
$NT_ROT_AX_NAME[n, 0 - 2] Name of the chain element that describes the 1st to 3rd rotary
axis (rotary indexing table, swivel axis, tool spindle)
$NT_IDENT[n, 0 - 2] Settings to adapt the screen form
$NT_AUX_POS[n, 0 - 2] Values for retraction in the direction of 1st to 3rd GEO axis (X,
Y, Z) 1)
$NT_CNTRL[n] Settings to adapt to the machine
n: Number of the transformation data set with n = 1, 2, 3, ... (MD18866 $MN_MM_NUM_KIN_TRAFOS)

1)
See manufacturer cycle CUST_800.SPF markers _M47 and _M48

Configuring cycles
Meaning of the decimal places of $NT_IDENT[n, 0 - 2]

You can set the following display variants of the input screens for turning on milling machines:

ONES Selection of the alignment
0= Beta/gamma
1= Beta/gamma + direct alignment (B/SP)
THOUSANDS Selection field: +/- direction reference of the swivel axis
0 = No selection on the user interface, always minus
4 = +/- selection via user interface, default: Minus
5 = No selection on the user interface, always plus
9 = +/- selection via user interface, default: Plus
TEN THOUSANDS Selection box: Correct tool tip when swiveling
2 = Do not list toggle
3 = List toggle
ONE MILLION Selection box: Retraction mode 0X and
TEN MILLION Selection box: Retraction mode X0 (the permissible retraction modes result from the sum of
the individual values: 0 ... 15)
0 = No retraction
1 = Retraction Z 2)
2 = Retraction Z, XY 2)
4 = Maximum retraction in tool direction
8 = Incremental retraction in tool direction
HUNDRED MILLION Enable data set
4 = Kinematics active (fixed value)
2)
See system variables $NT_AUX_POS[n,0] to $NT_AUX_POS[n,2]
Meaning of the bits of $NT_CNTRL[n]

You can make the following settings for the machine adaptation:
Bit 0 = 1 Fixed sequence of axes

For easier handling of the data, the sequence of the axes is fixed:
1. Rotary table
2. Swivel axis
3. Tool spindle
Bit 1 = 1 Rotary table is spindle
Bit 2 = 0 Swivel axis is not a spindle
Bit 3 = 0 Tool spindle is not a spindle (during turning)
Bit 4 = 0 1st rotary axis has no Hirth joint (rotary table) 3)
Bit 5 = 0 2nd rotary axis has no Hirth joint (swivel axis) 3)
Bit 6 = 0 3rd rotary axis has no Hirth joint (tool spindle) 3)
3)
It is not permissible that either the 2nd or the 3rd rotary axis has a Hirth joint.

Configuring cycles
21.8.3 Behavior at reset and power on
Behavior at reset
Make the following settings so that the kinematics transformation is retained after reset and
the turning tool can be used in JOG mode:
MD20110 $MC_RESET_MODE_MASK Definition of the basic control setting after reset /

part program end
Bit 7 = 1 The current setting for active transformation is retained after reset / part program end.
Bit 16 = 1 The current setting of the master spindle is retained.
MD20112 $MC_START_MODE_MASK Definition of the basic control setting after part pro‐
gram start
Bit 7 = 0 Start behavior, "active kinematics transformation"
MD20152 $MC_GCODE_RESET_MODE[ ] Reset behavior of G groups

[5] = 1 The current setting of the 6th G group is also retained after reset / part program end
(G17, ...).
(G94, ...).
(DIAMxxx).
Behavior at power on
In order to retain the kinematics transformation after a power on, you must also make the
following additional settings:
MD20144 $MC_TRAFO_MODE_MASK Selection of the kinematics transformation function

Bit 1 = 1 Reselection of the transformation after power-up
MD24008 $MC_CHSFRAME_POWERON_MASK Reset system frames after power on

Bit 4 = 0 Do not delete workpiece reference points after power on
Note
The CUTMODK function cannot be retained after power on.
21.8.4 Setting the tool clamping angle

If the clamped turning tool is not in the G18 plane at the spindle zero position, the clamping
angle must be set.

Configuring cycles
Procedure
1. Select the "Parameter" operating area.
2. Press the "Tool list" softkey.

The "Tool List" window opens.
3. Select a suitable turning tool in the list.
4. Press the "Additional data" softkey.
The "Additional Data - ..." window opens.
The "Additional data" softkey is only active if a turning tool for which the
"Additional Data" window is configured is selected.
5. Enter the required angle in the "Angle" input field.
Note
The clamping angle is stored in the $TC_DPROT cutting edge parameter.
21.8.5 Setting up the Hirth joint

If the tool spindle or the swivel axis has a Hirth joint with, for example, incrementing of 2.5°
(360°/2.5° = 144 division), you can set up the following:
Settings
MD30505 $MA_HIRTH_IS_ACTIVE Axis is indexing axis with Hirth joint

=0 Tool spindle / swivel axis is not a real Hirth axis
MD30330 $MA MODULO RANGE Size of the modulo range

= 360° Effective for modulo axis
MD30340 $MA_MODULO_RANGE_START Start position of the modulo range.

= 0°
MD30501 $MA_INDEX_AX_NUMERATOR Indexing axis, numerator for equidistant positions

= 360° Effective for non-modulo axis

Configuring cycles
MD30502 $MA_INDEX_AX_DENOMINATOR Indexing axis, denominator for equidistant posi‐

tions
= 144 Defines the value of the denominator for calculation of the distances between two indexing
positions for equidistant positions. For modulo axes, this is therefore the number of in‐
dexing positions.
Swivel axis has Hirth joint
$NT_CNTRL[n]
Bit 5 = 1 Swivel axis has a Hirth joint
[n] transformation name
Tool spindle has Hirth joint
$NT_CNTRL[n]
Bit 6 = 1 Tool spindle has a Hirth joint
[n] transformation name
21.8.6 Different coordinate systems for milling and turning

In boring mills, the rotary table usually rotates around the Y axis (B axis). During turning, the
workpiece must rotate around the Z axis (C axis) in the G18 plane. Therefore, different
coordinate systems must be used on this machine for milling and turning.
Settings
Set the appropriate coordinate system via the following channel-specific machine data (values,
for example, for boring mills):
MD52000 $MCS_DISP_COORDINATE_SYSTEM Position of the coordinate system (variable)

= 16 Y up, Z to the right
MD52001 DISP_COORDINATE_SYSTEM_2 Coordinate system for turning on milling machines

(variable)
=0 Z up, X to the right
Describe the rotation of the coordinate system as follows at the _M70 marker in the
CUST_800.SPF cycle:
_M70: ; Rotation of the coordinate system for turning

N800703 $P_WPFRAME=$P_WPFRAME:CROT(Y,-90):CROT(X,-90)

Configuring cycles
21.8.7 Adaptations for CUST_800

Adapt these markers in the CUST_800.SPF cycle for turning on milling machines:
Function markers
_M40: ; User Init
N800400 SETMS(1) ; Sets tool spindle as main spindle
N800401 DIAMOF ; No transverse axis defined as diameter
programming for milling
GOTOF _MEND
_M47: ; Retract axis Z to MCS fixed position

before tool alignment
GOTOF _MEND
_M48: ; Retract axis Z and then the XY axes to

MCS fixed position before tool alignment
GOTOF _MEND
_M70: ; Alignment tool: Prepare

IF($P_SMODE[1]==1) ; Spindle mode of tool spindle
N800700 SPOS[1]=0 ; Tool spindle as rotary axis C
ENDIF
N800701 SETMS(2) ; Sets table as main spindle
N800702 DIAM90 ; Transverse axis defined as diameter
programming for turning
GOTO _MEND
_M71: ; Alignment tool: Swivel rotary axis

_AX1=$PC_TRAFO_ROT_CHAN_AX_IN[1] ; Rotary axis B
_AX2=$PC_TRAFO_ROT_CHAN_AX_IN[2] ; Tool spindle
IF(_TC_N_WZ==0) ; No tooltip tracking
N800710 TRAFOOF
ENDIF
SBLON
N800711 G0 G40 G60 G90 AX[_AX1]=_A1 AX[_AX2]=_A2
SBLOF
GOTOF _MEND
_M72: ; Alignment tool: End

GOTOF _MEND
_M75: ; Alignment tool: Deselection

N800750 G17 ; Standard plane for milling

Configuring cycles
N800751 SETMS(1) ; Sets tool spindle as main spindle

N800752 DIAMOF ; No transverse axis defined as diameter
programming for milling
GOTOF _MEND

Configuring cycles
Simplified flow diagrams

During tool retraction, the markers _M44 to _M48 are run through before the rotary axis
positioning in accordance with the retraction variant.
$OLJQWXUQLQJWRRO 'HVHOHFWWXUQLQJ
&<&/( &<&/(
&<&/( &<&/(
*75$)22) 75$)22)
GHOHWH GHOHWH
:3)UDPH :3)UDPH
&867B &867B
6(706 6(706
',$021 ',$02)
*
75$)221
5(7
&<&/(
&867B
RU
&867B
RU
&867B
RU
&867B
5HWUDFWLRQ
&DOFXODWLRQRI
75$)221
&867B
7UDYHUVH
D[HV
*
7ZLVW
&8702'.
&867B
5(7

Configuring cycles
21.9 High-speed machining
21.8.8 Rotary axis positioning during block search

After a block search, you must position the rotary axis as follows (refer to swivel plane).
Generally, there are two rotary axes (swivel axis and tool spindle):
Procedure
Read out the position value of the rotary axis via the following system variable:

$AC_RETPOINT[axis] Repositioning point in the ASUB
You position the rotary axis in the CYCPE_MA.SPF user cycle.
Note
So that the old rotary axis position is not swiveled in, start the block search in the G code
program after the block for the turning tool alignment.
For further information on CYCPE_MA.SPF, see Chapter "Extending the PROG_EVENT

standard cycle (Page 474)".
If you have switched off the kinematics transformation, e.g. for a tool change, you can switch
the transformation on again with the following program extension:
DEF STRING[32] U_TRAFO_NAME

U_TRAFO_NAME=$AC_TRAFO_NAME
TRAFOOF
...
TRAFOON(U_TRAFO_NAME)
21.9.1 High speed settings: Configuring CYCLE832
Function
The High Speed Settings function (CYCLE832) is used to preset data for the machining of
sculptured surfaces so that optimum machining is possible. The call of CYCLE832 contains
three parameters:
● Tolerance
● Machining type (technology)
● Input of the orientation tolerance
The 3rd parameter is significant only for machines with multi-axis orientation transformation
(TRAORI). By default, it is assigned the value 1.

Configuring cycles
Software option
To use this function, you need the software option:
"Advanced Surface"
Tolerance / orientation tolerance

The tolerance value for the linear axes (geometry axes) is transferred to the CNC with the NC
command CTOL. CTOL = root(3) * tolerance value.
Tolerance value = 0: Tolerance value (CTOL) is loaded from the following setting data:
SD55446 $SCS_MILL_TOL_VALUE_ROUGH Tolerance value for roughing CYCLE832

SD55447 $SCS_MILL_TOL_VALUE_SEMIFIN Tolerance value for semi-finishing CYCLE832
SD55448 $SCS_MILL_TOL_VALUE_FINISH Tolerance value for finishing CYCLE832
Example: CYCLE832(0,_ROUGH,1) → tolerance value from SD55446 is used.

If rotary axes are involved in the machining (multi-axis transformation), the tolerance value is
transferred to the CNC with the NC command OTOL.
There are 2 options available for this:
1. Direct entry of the orientation tolerance OTOL
Machining types: _ORI_ROUGH, _ORI_SEMIFIN, _ORI_FINISH
To enter the orientation tolerance in the input screen for CYCLE832, bit 1 =1 must be set
in the
setting data SD55220 $SCS_FUNCTION_MASK_MILL_TOL_SET
2. Tolerance is transferred with a factor on the NC command OTOL
Machining types: _ROUGH, _SEMIFIN, _FINISH
This factor can be set in the following channel-specific setting data for each machining type:
SD55441 $SCS_MILL_TOL_FACTOR_ROUGH Factor, tolerance of the rotary axes for rough‐

ing of the G group 59.
SD55442 $SCS_MILL_TOL_FACTOR_SEMIFIN Factor, tolerance of the rotary axes for rough‐
ing-finishing of the G group 59.
SD55443 $SCS_MILL_TOL_FACTOR_FINISH Factor, tolerance of the rotary axes for finish‐
ing of the G group 59.
= 10
For machines for which the orientation tolerance is not significant, the cycle setting data
SD55441 to 55443 can be set to a value of 0. No orientation tolerance is then calculated in
CYCLE832 (OTOL= -1).

Configuring cycles
Machining type and technology G group 59

The machining types of the technology G group 59 are permanently assigned in CYCLE832
or in CUST_832.SPF:
Machining type Plain text Technology G group 59 Field index

Deselection _OFF DYNNORM 0
Roughing _ROUGH DYNROUGH 2
Rough-finishing _SEMIFIN DYNSEMIFIN 3
Finishing _FINISH DYNFINISH 4
Roughing *)
_ORI_ROUGH DYNROUGH 2
Semi-finishing *)
_ORI_SEMIFIN DYNSEMIFIN 3
Finishing *) _ORI_FINISH DYNFINISH 4
*)
With entry of an orientation tolerance
Dynamic parameters can be adapted to the respective machining operation with the
technology G groups. Using the commands of technology G group 59, the value of the following
channel and axis-specific machine data is activated using the corresponding array index:
MD20600 $MC_MAX_PATH_JERK[0..4] Path dependent maximum jerk.

MD20602 $MC_CURV_EFFECT_ON_PATH_ACCEL[0..4] Influence of path curvature on path
dynamic response.
MD20603 $MC_CURV_EFFECT_ON_PATH_JERK[0..4] Influence of path curvature on path
jerk.
MD32300 $MA_MAX_AX_ACCEL[0..4] Maximum axis acceleration.
MD32310 $MA_MAX_ACCEL_OVL_FACTOR[0..4] Overload factor for axial velocity
jumps.
MD32431 $MA_ MAX_AX_JERK[0..4] Maximum axial jerk for path mo‐
tion.
MD32432 $MA_PATH_TRANS_JERK_LIM[0..4] Maximum axial jerk at the block
transition in continuous-path
mode.
Note
During the optimization of the machine axes, the values (note array index) of the specified
machine data must be set correctly.
Machining type, deselection

When CYCLE832 is deselected, the G groups are programmed for the settings during the
program run time; these settings are declared in machine data
MD20150 $MC_GCODE_RESET_VALUES[ ]. This involves the G groups 1, 4, 10, 12, 21, 24,
30, 45, 59, 61.
The contour and orientation tolerance is deactivated (CTOL=-1, OTOL=-1).

Configuring cycles
21.9.2 Manufacturer cycle CUST_832.SPF
Function
In contrast to the settings (G functions) by CYCLE832.SPF, these settings can be modified in
the manufacturer cycle CUST_832.SPF.
The following markers are prepared in CUST_832.SPF:
_M_NORM: For deselection _OFF CYCLE832

_M_FINISH: For finishing _FINISH and _ORI_FINISH
_M_SEMIFINISH: For semi-finishing _SEMIFIN and _ORI_SEMIFIN
_M_ROUGH: For roughing _ROUGH and _ORI_ROUGH
The following G functions are programmed in CUST_832.SPF:
SOFT
COMPCAD
G645
FIFOCTRL
UPATH
;FFWON
Dependent on the machining type:
DYNNORM
DYNFINISH
DYNSEMIFIN
DYNROUGH
The programming of FGREF () is useful when machining with active multi-axis transformation
(e.g. TRAORI). In this case, in CUST_832.SPF, variable _FGREF is pre-assigned a value of
10 mm. This value can also be modified. In CYCLE832.SPF, the value of variable _FGREF is
written to the rotary axes involved in the machining, which are declared as orientation axis of
a 5-axis transformation, using the FGREF(rotary axis) command. When G70/G700 is active,
the value from _FGREF is converted into inches before writing to the command FGREF.
Take into account more than three rotary axes (orientation axes) in CYCLE832
In CYCLE832, a maximum of three rotary axes of the orientation transformation (TRAORI) are
taken into account for FGREF. If more than three rotary axes are declared per channel for the
orientation transformation, you can write the value to FGREF using the following syntax in the
CUST_832:
FGREF[AA]=$AA_FGREF[C]
C = rotary axis 1 (axis is taken into account by CYCLE832)
AA = rotary axis 4
In the manufacturer cycle CUST_832.SPF, parameter _MOTOL is available for the evaluation
of the "Multi-axis programming yes/no".
_MOTOL=0 No multi-axis programming

_MOTOL=1 Multi-axis programming where the orientation tolerance is en‐
tered

Configuring cycles
With the following setting data, additional G functions can be programmed in CUST_832.SPF
for using multi-axis programming:
SD55220 $SCS_FUNCTION_MASK_MILL_TOL_SET Function screen form, high speed settings CY‐

CLE832
Bit 1 Orientation tolerance (OTOL) as a factor of the tolerance (CTOL) or directly entered
Example
Using _MOTOL in CUST_832.SPF for the marker for finishing:
_M_FINISH:
IF _MOTOL==1 ; if multi-axis programming
ORISON
ELSE ; no multi-axis programming
ORISOF
ENDIF
...
21.9.3 Top Surface: CYCLE832 extension
Function
Besides Advanced Surface, the High Speed Settings (CYCLE832) function also offers the
extension Top Surface. You can use Top Surface to improve the quality of free-form surfaces.
If set actively, the continuous-path control is optimized within contour tolerances. The
CYCLE832 call also contains the smoothing parameter.
Software option
To use this function, you need the software option:
"Top Surface"

Configuring cycles
Figure 21-16 Roughing, semi-finishing, or finishing with active smoothing
Tolerance / orientation tolerance

The tolerance value for Top Surface is transferred to the NC as a contour tolerance with
command CTOL and as a multiple axis transformation with command OTOL.
Set the following setting data to set up the the Top Surface extension:
SD55220 $SCS_FUNC‐ Function screen form, high speed settings CY‐

TION_MASK_MILL_TOL_SET CLE832
Bit 2 Mold making function can be selected in High-Speed Settings screen form
= 0 The best available mold making function is automatically used:
● Top Surface not active → Advanced Surface
● Top Surface active → Top Surface
= 1 The mold making function (Advanced Surface or Top Surface) can be selected in the input
screenform.
Extension in manufacturer cycle CUST_832.SPF

The following labels are provided in manufacturing cycle CUST_832.spf for Top Surface:
31 _M_TOP_SURFACE_FINISH: Finishing with COMPSURF

32 _M_TOP_SURFACE_SEMIFINISH: Semi-finishing with COMPSURF
33 _M_TOP_SURFACE_ROUGH: Roughing with COMPSURF
The following G commands are programmed in labels 31 to 33:
SOFT
COMPSURF
G645
FIFOCTRL
UPATH
;FFWON

Configuring cycles
21.10 Measuring cycles and measurement functions
Depending on the machining type used, the following G commands of G group 59 are
programmed:
DYNFINISH
DYNSEMIFIN
DYNROUGH
21.10.1 Measuring cycles and measurement functions, general
Requirement
Two types of electronic probes are used for measuring:
● Probe to measure the workpiece
● Probe to measure the tool
The electronic probe must be connected to the NCU 7x0.
The electronic probe is called probe in the following document
References
NCU Manual: Digital inputs / outputs
Setting the switching behavior

You set the electrical polarity of the connected probe using the following general machine data:
MD13200 $MN_MEAS_PROBE_LOW_ACTIVE Polarity change of the probe

=0 Probe in the non-deflected state, 0 V default value
Probe in the deflected state, 24 V
=1 Probe in the non-deflected state, 24 V
Probe in the deflected state, 0 V
MD13210 $MN_MEAS_TYPE Measuring type for distributed drives

=0 Default value

Configuring cycles
Testing the probe function

You can test the switching function of the probe by manually deflecting it and checking the
following PLC interface signals:
DB 10
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
Probe actuated
DBB107 Probe 2 Probe 1
To test the switching behavior and the measured value transfer, use an NC test program with,
for example, the following NC commands:
MEAS Measurement with deletion of distance-to-go

$AC_MEA[n] Check the switching operation, n = measurement input number
$AA_MW[axis name] Measured value of the axes in workpiece coordinates
$AA_MM[axis name] Measured value of the axes in machine coordinates
Example of a test program

Program code Comment
%_N_PRUEF_MESSTASTER_MPF
$PATH=/_N_MPF_DIR ;Testing program probe connection
N00 DEF INT MTSIGNAL ;Bit memory to check the switching state
N05 G17 G54 T="3D_Taster" D1 ;Select tool geometry for probe
N10 M06 ;Activate tool
N15 G0 G90 X0 F150 ;Starting position and meas. velocity
N20 MEAS=1 G1 X100 ;Measurement at measuring input 1 in the
X axis
N30 MTSIGNAL=$AC_MEA[1] ;Switching operation at the 1st measuring
input completed, ;YES / NO
N35 IF MTSIGNAL == 0 GOTOF _FEHL1 ;Evaluation of the signal
N40 R1=$AA_MM[X] ;Save measured value in machine coordi-
nates at R1
N45 R2=$AA_MW[X] ;Save measured value in workpiece coordi-
nates at R2
N50 M0 ;Check measured value in R1/R2
N55 M30
N60 _FEHL1: MSG ("Probe does not switch!")
N65 M0
N70 M30
General function settings for measuring cycles
MD51740 $MNS_MEA_FUNCTION_MASK Measuring cycles function screen

Bit 0 Activate calibration status monitoring – workpiece measurement for measuring in automatic
Bit 1 Length reference for workpiece probe, milling technology

Configuring cycles
= 0 Tool length L1, referred to the center of the probe sphere

= 1 Tool length L1, referred to the sphere circumference of the probe sphere
Bit 2 Support of tool holders that can be oriented for workpiece measurement with correction in
a tool
Bit 4 Workpiece probe is permanently attached to the machine and cannot be positioned
Bit 5 Correction in coarse ZO if no fine offset has been set up
Bit 6 Measuring blocks (MEAS) are traversed in the measuring cycles with 100% feedrate over‐
ride if the feedrate override is set > 0
Bit 15 Workpiece measurement, traverse measuring block with path behavior G60 with exact stop
at the end of the block
Bit 16 Tool, turning technology, consideration of tool holders
Note
After changing this machine data, the probe must be re-calibrated.
MD52740 $MCS_MEA_FUNCTION_MASK Measuring cycles function screen

Bit 0 Measuring input, workpiece probe
= 0 Workpiece probe at the CNC measuring input 1, active - default
= 1 Workpiece probe at the CNC measuring input 2, active
Bit 1 Workpiece measurement, functional behavior of a third geometry axis (Y axis) when turning,
based on the machining plane G18!
Bit 2 Calculation of the correction angle with/without active orientation transformation
Bit 16 Measuring input, tool probe
= 0 Tool probe at the CNC measuring input 1, active
= 1 Workpiece probe at the CNC measuring input 2, active - default
MD54740 $SNS_MEA_FUNCTION_MASK Measuring cycles function screen

Bit 0 Repetitive measurement: workpiece measurement after exceeding a dimensional difference
(parameter _TDIF) and or confidence range (parameter _TSA)
Bit 1 Repetitive measurements: workpiece measurement with alarm and cycle stop at M0
Bit 2 Workpiece measurement: M0 for tolerance alarms 62304 oversize, 62305 undersize, 62306
permissible dimensional difference exceeded
Bit 3 Accept calibrated workpiece probe radius in the tool data.
Bit 4 For turning-milling technology, the calibration/measuring plane is different.
Bit 16 Repetitive measurement: tool measurement after a dimensional difference has been fallen
below (parameter _TDIF) and or confidence range (parameter _TSA)
Bit 17 Repetitive measurement: tool measurement with alarm and cycle stop at M0
Bit 18 Workpiece measurement: M0, after the permissible dimensional difference has been ex‐
ceeded
Bit 19 Tool measurement, milling tool: Spindle speed reduction at the last probing
MD55740 $SCS_MEA_FUNCTION_MASK Measuring cycles function screen

Bit 0 Collision monitoring using workpiece probe for intermediate positioning

Configuring cycles
Bit 1 Coupling the spindle alignment with coordinate rotation in the active plane, for workpiece
measurement with multiprobe in the automatic mode
Bit 2 Direction of rotation of the spindle positioning for workpiece measurement regarding active
coupling of the spindle alignment with coordinate rotation in the active plane
Bit 3 For workpiece measurement, number of repeat measurements if the probe does not switch
Bit 4 Measuring feedrate for workpiece measurement
Bit 5 Retraction velocity from the measuring point for workpiece measurement
Bit 6 Workpiece measurement: probe activation/deactivation when positioning the spindle
Bit 7 Measure kinematics, scaling basis for the orientation vectors
Bit 8 Measure kinematics, measurement with active TRAORI or TCARR (CYCLE 800)
Bit 9 User-specific scaling of the rotary axis vectors V1xyz and V2xyz
Bit 15 Workpiece measurement: calibration in the bore with known or unknown center point, meas‐
uring in JOG
Bit 16 Collision monitoring for tool measurement
Bit 17 Tool measurement: number of repetitive measurements if the probe does not switch
Bit 19 Retraction velocity from the measuring point for tool measurement
Bit 28 Continuous measuring standard log in JOG (attach)
Bit 29 Table format for measuring standard log in JOG
21.10.2 Manufacturer and user cycle CUST_MEACYC.SPF
Function
The CUST_MEACYC.SPF is part of the measuring cycle functionality. It is called in every
measuring cycle before and after executing the measurement task. The CUST_MEACYC.SPF
acts in the same way when measuring in the JOG mode and measuring in the AUTOMATIC
mode.
You can use the CUST_MEACYC.SPF to program and execute sequences that are necessary
before and/or after a measurement (e.g. activating/deactivating a probe).
Note
Copy the CUST_MEACYC cycle from the NC data/Cycles/Standard cycles directory to the NC
data/Cycles/User cycles directory before making any changes. Changes for CUST_MEACYC
only take effect in this directory.

Configuring cycles
CUST_MEACYC structogram
Sequence in the AUTOMATIC mode, using measure bore as example, CYCLE977 with probe
type 712.
6WUXFWXUH&<&/( &867B0($&<&
,QSXWYDOXHV B02'( JHQHUDWHGE\PHDVXULQJF\FOH
PHDVXULQJYDULDQW -XPSWRODEHO
VSHFLILFVHWWLQJV B0
EHIRUHZRUNSLHFHPHDVXUHPHQW&<&/(
RIIVHWW\SH
XVHUVSHFLILFHQWULHVIRUH[DPSOHFRRODQWRII
RIIVHWWDUJHW *272)B$0B:3B0(6
ಹ
VHWSRLQW
B$0B:3B0(6
PRQLWRULQJSDUDPHWHUV EHIRUHZRUNSLHFHPHDVXUHPHQW
ಹ
0
SUHSDUDWLRQRIPHDVXUHPHQW
FDOFXODWLRQV
SRVLWLRQLQIURQWRIWKHVW
PHDVXULQJSRLQW B02'( JHQHUDWHGE\PHDVXULQJF\FOH
-XPSWRODEHO
B0($&<&B072))21
XVHUVSHFLILF1&FRPPDQGV
WRGHDFWLYDWHWKHSUREH
IRUH[DPSOH0RU+FRPPDQGV
6' \HV ಹ
6&6B0($B)81&7,21B0$6.%LW 6326 SRVLWLRQVSLQGOH
4XHULHGEHIRUHHDFKIXUWKHU ಹGHILQHGE\F\FOH
6326 ಹ ಹ
B0($&<&B0721
XVHUVSHFLILF1&FRPPDQGV
WRDFWLYDWHWKHSUREH
IRUH[DPSOH0RU+FRPPDQGV
QR 5(7
SURFHVVDOORWKHUPHDVXULQJSRLQWV B02'( JHQHUDWHGE\PHDVXULQJF\FOH

FDOFXODWHPHDVXUHPHQWGLIIHUHQFH -XPSWRODEHO
FKHFNUHVXOW B0(
DIWHUZRUNSLHFHPHDVXUHPHQW&<&/(
H[HFXWHRIIVHW
XVHUVSHFLILFHQWULHVIRUH[DPSOHFRRODQWRQ
*272)B%0B:3B0(6
ಹ
B%0B:3B0(6
DIWHUZRUNSLHFHPHDVXUHPHQW
(QGRIF\FOH ಹ
0
Figure 21-17 Structure: CYCLE977 / CUST_MEACYC

Configuring cycles
21.10.3 Measuring in JOG mode
Requirements
You have already made the settings from the previous Chapter "Measuring cycles and
measurement functions, general (Page 575)".
Workpiece measurement
For milling:
● The probe has been inserted in the tool spindle.
● The probe has been selected in the tool list as type 7xx (probe).
● The probe is activated as tool in the current NC channel.
Tool measurement
To measure tools, an appropriate probe must be located in the machine space so that this can
be reliably and safely reached with a tool in the spindle.
The following tool types are supported with measure tool:
● Milling technology: Tool types 1xx and 2xx
● Turning technology: Tool types 5xx, 1xx and 2xx
For the specified tool types, the tool lengths and the tool radii can be measured.
Setting general data
SD54782 $SNS_J_MEA_FUNCTION_MASK_TOOL Settings for the input screen, measuring

in JOG, tool measurement.
Bit 2 = 1 Activates the "Enable automatic tool measuring" function.
Bit 3 = 1 Selects the tool probe calibration data field, enable.
Bit 10 = 1 Selects the individual cutting edge measurement
Bit 11 = 1 Selects the spindle reversal when calibrating in the plane
MD51784 $MNS_J_MEA_T_PROBE_APPR_AX_DIR [i]

Measuring in JOG: Approach direction in the plane to the tool probe
-2 Negative direction, 2nd measuring axis
-1 Negative direction, 1st measuring axis (default setting)
0
1 Positive direction, 1st measuring axis
2 Positive direction, 2nd measuring axis

Configuring cycles
MD52750 $MCS_J_MEA_FIXPOINT Z value for measurement with respect to

a fixed point
MD52751 $MCS_J_MEA_MAGN_GLAS_POS Zoom-in position for tool measurement
[0] Position in the 1st axis
[1] Position in the 2nd axis
Checking and setting the general machine data
MD11450 $MN_SEARCH_RUN_MODE "Search run" programming.

Bit 1 = 1 Automatic ASUB start after output of the action blocks (see also
MD11620 $MN_PROG_EVENT_NAME). Alarm 10208 is not output until the ASUB is
completed.
MD11604 $MN_ASUP_START_PRIO_LEVEL Priorities from which ASUP_START_MASK is

effective.
= 1 - 64 Priorities for ASUP_START_MASK.
Setting channel-specific machine data
MD20050 $MC_AXCONF_GEOAX_ASIGN_TAB[ ] Assignment, geometry axis to channel axis.

[0] For measuring in JOG mode, all of the geometry axes must be available. Preferably XYZ.
[1]
[2]
MD20110 $MC_RESET_MODE_MASK Defines the basic control settings after reset /

TP end,
= 4045H Minimum value
Bit 0 = 1 Basic control setting after power on and reset.
Bit 2 = 1
Bit 6 = 1
Bit 14 = 1
MD20112 $MC_START_MODE_MASK Definition of the basic control setting after part

program start.
Bit 6 = 0 Definition of the basic control setting after NC start.
MD20310 $MC_TOOL_MANAGEMENT_MASK Activates tool manager functions

Bit 1 = 1 Tool manager and monitoring functions active
Bit 14 = 1 Automatic tool change for RESET and Start.

Configuring cycles
MD28082 $MC_SYSTEM_FRAME_MASK System frames (SRAM).

Bit 0 = 0 Do not setup system frames for actual value setting and scratching.
Bit 0 = 1 Setup system frames for actual value setting and scratching.
The following channel-specific machine data is only effective if the system frame actual value
setting and scratching is set up using the above mentioned machine data
MD28082 $MC_SYSTEM_FRAME_MASK, bit 0 = 0.
MD24006 $MC_CHSFRAME_RESET_MASK Active system frames after reset.

Bit 0 = 1 Reset response of the system frames or actual value setting.
MD24007 $MC_CHSFRAME_RESET_CLEAR_MASK Clear system frames at reset.

Bit 0 = 0 Clear response of the system frames on reset.
Note
If you create the conditions described in this section and you have set and checked the machine
setting data, then in JOG mode, you can measure a workpiece using a workpiece probe at a
milling machine!
In JOG mode, you can measure a tool using a tool probe at a milling machine or lathe!
A description is provided in the following chapters as to which settings you can make in order
to adapt measuring to the specific requirements of your particular machine.
21.10.3.1 Measuring workpieces at the milling machines

Measuring in the "Machine" operating area can be appropriately adapted to the specific
requirements using the following channel-specific general machine data and channel-specific
cycle setting data.
General configuration machine data
SD55630 $SCS_MEA_FEED_MEASURE Measuring feedrate for workpiece meas‐

urement in JOG and AUTOMATIC
300 Default value

Configuring cycles
Note
Measuring feedrate for workpiece measuring
All measuring cycles use the value saved in SD54611 as the measuring feedrate value
following calibration of the workpiece probe. A different measuring feedrate can be assigned
for each calibration field [n].
When calibrating the probe, either the measuring feedrate from SD55630
$SCS_MEA_FEED_MEASURE is used, or the measuring feedrate can be overwritten in the
input screen when calibrating. To do this, SD54760 $SNS_MEA_FUNCTION_MASK_PIECE
bit 4 must be set to 1.

Bit 6 Request rotary axis as correction target for measuring.
= 0 Default value
= 1 Rotary axis is displayed as correction target in the "Measuring in JOG" window.
MD51751 $MNS_J_MEA_M_DIST_MANUELL Measuring path in mm, before and after the

measuring point.
= 10 Default value
MD51757 $MNS_J_MEA_COLL_MONIT_FEED Position feedrate in mm/min, in the working

plane for active collision monitoring.
= 1000 Default value
MD51758 $MNS_J_MEA_COLL_MONIT_POS_FEED Position feedrate in mm/min, in the infeed

axis for active collision monitoring.
MD51770 $MNS_J_MEA_CAL_RING_DIAM[n] Pre-assignment of the calibration diameter

in mm specifically for the calibration data
sets.
= -1 Default value
MD51772 $MNS_J_MEA_CAL_HEIGHT_FEEDAX[n] Pre-assignment of the calibration height

in mm, in the infeed axis, specific for the
calibration data sets.
= -99999 Default value

Configuring cycles
General cycle setting data
SD54780 $SNS_J_MEA_FUNCTION_MASK_PIECE Configuration of the input screens for

measuring in the "Machine" operating
area in the JOG operating mode.
= 512 Default value
Bit 2 = 1 Activates measurements with an electronic probe.
Bit 3 = 1 Selects the probe calibration data, enable.
Bit 6 = 1 Selects WO offset in the basis reference (SETFRAME), enable.
Bit 7 = 1 Selects WO offset in the channel-specific basic frame, enable.
Bit 8 = 1 Selects WO offset in the global basic frame, enable.
Bit 9 = 1 Selects WO offset in adjustable frames, enable.
Bit 16 = 1 Selects workpiece measurement with spindle reversal.
Bit 17 = 1 Selects align workpiece probe in the switching direction.
21.10.3.2 Measuring tools at the milling machines
Measuring feedrate for tool measurement in JOG and AUTOMATIC
SD55628 $SCS_MEA_TP_FEED_MEASURE Calibrate measuring feedrate for tool

probe and measure tool with station‐
ary spindle.
= 300 Default value
Note
Measuring feedrate for tool measuring
All measuring cycles use the value saved in SD54636 or SD54651 as the measuring feedrate
after the tool probe has been calibrated. A different measuring feedrate can be assigned for
each calibration field [n].
When calibrating the probe, either the measuring feedrate from
SD55628 SCS_MEA_TP_FEED_MEASURE is used, or the measuring feedrate can be
overwritten in the input screen when calibrating. To do this,
SD54762 $SNS_MEA_FUNCTION_MASK_TOOL bit 4 must be set to 1.
In the following setting data, index [k] stands for the number of the current data field (probe
number -1) of the probe.
SD54633 $SNS_MEA_TP_TYPE[k] Probe type, cube/disk

=0 Cube (default value)
= 101 Disk in XY, working plane G17
= 201 Disk in ZX, working plane G18
= 301 Disk in YZ, working plane G19

Configuring cycles
The following setting data is used to define in which axes and directions it is possible to calibrate
a tool probe.
SD54632 $SNS_MEA_T_PROBE_ALLOW_AX_DIR[k] Axes and directions for "calibration"

= 133 Default value
Decimal place
ONES 1. Axis
=0 axis not possible
=1 only minus direction
=2 only plus direction
=3 both directions
TENS 2. Axis
=3 both directions
HUNDREDS 3. Axis
=3 both directions
Example
If the general setting data SD54632 $SNS_MEA_T_PROBE_ALLOW_AX_DIR[k] has the value
123, the tool probe is calibrated as follows in the G17 plane:
● X in both directions
● Y only in plus direction
● Z only in minus direction
SD54631 $MNS_MEA_T_PROBE_DIAM_LENGTH[k] Effective diameter of the tool probe

for length measurement.
=0 Default value
General cycle machine/setting data for tool probe
MD51780 $MNS_J_MEA_T_PROBE_DIAM_RAD[k] Effective diameter of the tool probe

for radius measurement.
=0 Default value

Configuring cycles
SD54634 $SNS_MEA_TP_CAL_MEASURE_DEPTH[n] Distance between the tool probe up‐

per edge and the milling tool lower
edge.
=2 Default value
MD51752 $MNS_J_MEA_M_DIST_TOOL_LENGTH Measuring path to measure the tool

length.
=2 Default value
MD51753 $MNS_J_MEA_M_DIST_TOOL_RADIUS Measuring path to measure the tool ra‐

dius.
=1 Default value
MD51786 $MNS_J_MEA_T_PROBE_MEASURE_DIST Measuring path to calibrate the probe

or for measurements with stationary
spindle.
= 10 Default value
General cycle setting data when measuring with rotating spindle
SD54670 $SNS_MEA_CM_MAX_PERI_SPEED[0] Maximum permissible peripheral

speed of the tool to be measured.
= 100 Default value
SD54671 $SNS_MEA_CM_MAX_REVOLUTIONS[0] Maximum permissible tool speed of the

tool to be measured. The speed is au‐
tomatically reduced when exceeded.
SD54672 $SNS_MEA_CM_MAX_FEEDRATE[0] Maximum permissible feedrate to

probe the tool to be measured at the
probe.
= 20 Default value
SD54673 SNS_MEA_CM_MIN_FEEDRATE[0] Minimum feedrate for the first probing

of the tool to be measured at the probe.
This avoids excessively small fee‐
drates for large tool radii.
=1 Default value

Configuring cycles
SD54674 $SNS_MEA_CM_SPIND_ROT_DIR[0] Spindle direction of rotation to measure

tools.
=4 Spindle rotation the same as M4 (default value)
Note
If the spindle is already rotating when the measuring cycle is called, this direction of rotation
remains independent of the setting of this data.
SD54675 $SNS_MEA_CM_FEEDFACTOR_1[0] Feedrate factor 1

= 10 Default value
=0 Only single probing with the feedrate calculated by the cycle. However, as a minimum, the
value from SD54673[0] $SNS_MEA_CM_MIN_FEEDRATE.
>= 1 First probing with feedrate. However, as a minimum with the value from
SD54673[0] $SNS_MEA_CM_MIN_FEEDRATE)
SD54675[0] $SNS_MEA_CM_FEEDFACTOR_1

=0 Second probing with the feedrate calculated by the measuring cycle. This is only effective
for SD54673[0] $SNS_MEA_CM_FEEDFACTOR_1 > 0, default value
>= 1 Second probing with the feedrate from SD54673[0] $SNS_MEA_CM_MIN_FEEDRATE fee‐
drate factor 2.
Third probing with the calculated feedrate.
Note
Feedrate factor 2 should be less than feedrate factor 1.
SD54677 $SNS_MEA_CM_MEASURING_ACCURACY[0] Specified measuring accuracy.

The value of this parameter always
refers to the last probing of the tool
at the probe!
= 0.005 Default value
SD54692 $SNS_MEA_T_CIRCULAR_ARC_DIST Arc distance for the single cutting edge

measurement of the radius.
= 0.25 *) Default value

Configuring cycles
SD54693 $SNS_MEA_T_MAX_STEPS Maximum number of probe contacts for

single cutting edge measurement of the
radius.
= 10 *) Default value
*)
If the value = 0, then the "highest point on the longest cutting edge" is not sought, but the measured
value of the contact with the rotating spindle taken.
EQ
E
E

E
r Effective radius of the tool

b Arc distance = SD54692
n Maximum number of probe contacts = SD54693
① 1. Measuring point
Figure 21-18 Single cutting edge measurement
General cycle setting data for correction using the correction tables when forming measurements with
rotating spindle.
SD54691 $SNS_MEA_T_PROBE_OFFSET Activate the measuring result compen‐

sation
=0 No data, default value
=1 Correction in the cycle. This is only effective if SD54689 $SNS_MEA_T_PROBE_MANUFAC‐
TURER>0.
=2 Correction using user-defined correction table
SD54689 $SNS_MEA_T_PROBE_MANUFACTURER Activates pre-configured compensa‐

tion tables for several tool probe mod‐
els (customer-specific)
=1 TT130 (Heidenhain)
=2 TS27R (Renishaw)

Configuring cycles
21.10.3.3 Measuring tools at the turning machines
Measuring feedrate for tool measurement in turning operation
SD55628 $SCS_MEA_TP_FEED_MEASURE Calibrate measuring feedrate for tool

probe and measure tool with station‐
ary spindle.
= 300 Default value
Note
Measuring feedrate for tool measuring
All measuring cycles use the value saved in SD54636 or SD54651 as the measuring feedrate
after the tool probe has been calibrated. A different measuring feedrate can be assigned for
each calibration field [n].
When calibrating the probe, either the measuring feedrate from SD55628 is used, or the
measuring feedrate can be overwritten in the input screen when calibrating. To do this,
SD54762 $SNS_MEA_FUNCTION_MASK_TOOL bit 4 must be set to 1.
General cycle machine/setting data for measuring path/feedrate
SD42950 $SC_TOOL_LENGTH_TYP Assignment of the tool length offset

independent of tool type.
=0 Measuring turning tools, type 5xx (default value)
=2 Measuring turning tools, type 5xx, drilling and milling tools, type 1xx, 2xx
MD51786 $MNS_J_MEA_T_PROBE_MEASURE_DIST Measuring path to calibrate the

probe or for measurements with sta‐
tionary spindle.
= 10 Default value
SD55628 $SCS_MEA_TP_FEED_MEASURE Feedrate for the calibration of a tool

probe with stationary spindle.
= 300 Default value
Calibrating tool probes

Use the following general cycle machine data to set the access level as of which the "Calibrate
probe" softkey is displayed. This requires that the automatic tool measurement is enabled
using the setting data SD54782 (bit 2 = 1).
MD51070 $MNS_ACCESS_CAL_TOOL_PROBE Calibrate tool probe access level.

=7 Access rights: Access level 7 (keyswitch 0)

Configuring cycles
=4 Read access rights: Access level 4 (keyswitch 3), default value

=3 Write access: Access level 3 (user)
21.10.3.4 Measuring without electronic probe in JOG
Measure workpiece
For manual measuring functions in the JOG operating mode, for which a rotating spindle is
required, the following applies:
● The channel state must be reset at the instant in time that the measured value is transferred.
● The spindle can be moved or positioned either using the T,S,M menu or using the bits in
DB3x.DBB30.
● The following preconditions apply when using the DB3x.DBB30 technology functions with
fixed speed:
Setting the machine data

MD10709 $MN_PROG_SD_POWERON_INIT_TAB [0] = 0 Setting data to be initialized
MD35035 $MA_SPIND_FUNCTION_MASK Bit 4 = 0 Spindle functions
Bit 5 = 1
SD43200 $SA_SPIND_S Speed setting value
Note
The entry in SD43200 $SA_SPIND_S is kept at power on.
With these settings, the spindle velocity for manual operation, which is set in SD41200
$SN_JOG_SPIND_SET_VELO, is no longer effective.
21.10.4 Measuring in the AUTOMATIC mode
Requirement
Software option
In order to use the "Measuring in AUTOMATIC" function, you require the software
option: "Measuring cycles"
You have already made the settings from Chapter "Measuring cycles and measurement
functions, general (Page 575)".

Configuring cycles
Sequence in milling technology:
1. The probe has been selected in the tool list as type 7xx (probe).
2. The probe has been inserted in the tool spindle.
3. The probe is activated in the actual NC channel.
Sequence in turning technology:

1. Tool type 580 (3D probe, turning) is selected.
2. Tool is activated in the actual NC channel.
Tool measurement
To measure tools, an appropriate probe must be located in the machine space so that this can
be reliably and safely reached with a tool in the spindle.
The following tool types are supported with tool measurement:
● Milling technology: Tool types 1xx and 2xx
● Turning technology: Tool types 5xx, 1xx and 2xx
For the specified tool types, the tool lengths and the tool radii can be measured.

Using the following channel-specific cycle setting data, you can adapt the workpiece and tool
measuring in the "Program" operating area to specific requirements. As a general rule, no
changes are required.
SD55613 $SCS_MEA_RESULT_DISPLAY Selects the screen display of the measur‐

ing result
=0 No screen display of the measuring result (default value).
=1 Screen display of the measuring result is displayed for 8 seconds.
=3 The measuring cycle stops an internal machine data, the measuring result is statically dis‐
played on the screen!
Continue with NC start, the measuring result screen is deselected.
=4 The measuring result is only displayed on the screen for cycle alarms 61303, 61304, 61305,
61306.
Continue with NC start, the measuring result display on the screen is deselected.
SD55614 $SCS_MEA_RESULT_MRD Setting of the program control of the measurement result dis‐
play MRD
=0 Switch off the measurement result display
=1 Switch on the measurement result display

Configuring cycles
SD55623 $SCS_MEA_EMPIRIC_VALUE[n] Empirical values

=0 Default value
SD55618 $SCS_MEA_SIM_ENABLE Measuring cycle simulation

=0 When calling measuring cycles in conjunction with SINUMERIK Operate, ShopMill or Shop‐
Turn simulation, the measuring cycles are skipped, default value.
=1 Default setting:
When calling measuring cycles in conjunction with SINUMERIK Operate, ShopMill or Shop‐
Turn simulation, the measuring cycles are run through. However, no corrections are performed
and there is no logging. There is no screen display of the measuring result.
For further information on SD55618, please refer to:
References
Programming Manual, Measuring Cycles; Section "Description" > "Behavior on block search,
dry run, program testing, simulation"
Configuring input screens for measuring cycles in the program editor

Using the following setting data, you configure the display screen and the correction options
when making measurements in the AUTOMATIC mode:
● SD54760 $SNS_MEA_FUNCTION_MASK_PIECE measure workpiece: Measuring cycles
in the milling area, see Chapter "Measuring workpieces, general (Page 592)"
● SD54762 $SNS_MEA_FUNCTION_MASK_TOOL measure tool: Measuring cycles in the
milling area, see Chapter "Measuring tools at the milling machines (Page 596)"
Note
If you have created the prerequisites described in this chapter and you have set and checked
the machine/setting data, you can perform measurements at the machine with a workpiece or
tool probe in the AUTOMATIC mode!
If you wish to set up workpiece measurement on a turning machine, then additional settings
are required. Refer to Chapter "Measuring workpieces at the turning machines (Page 602)"
for the settings.
If you wish to set-up tool measurement using a tool probe, then you must also make additional
settings. Please refer to Chapters "Measuring tools at the turning machines (Page 603)" or
"Measuring tools at the milling machines (Page 596)" for the settings.
A description is provided in the following chapters as to which settings you can make in order
to adapt measuring to the specific requirements of your particular machine.
21.10.4.1 Measuring workpieces, general

Using the following general and channel-specific cycle setting data, you can appropriately
adapt workpiece measurement to the specific requirements in the "Program" operating area.

Configuring cycles
Requirement
You have already made the settings from the following section:
See also: Measuring cycles and measurement functions, general (Page 575)
Settings
General cycle setting data
SD54760 $SNS_MEA_FUNCTION_MASK_PIECE Settings for the input screen, measuring

cycles in AUTOMATIC, workpiece meas‐
urement.
Bit 1 Display select softkey 3D measurement
Bit 3 Enable probe calibration field to be selected
Bit 4 Select calibration input measuring feed 1)
Bit 6 Enable ZO to be selected in the basis reference (SETFRAME)
Bit 7 Enable ZO to be selected in the channel-specific basis frame
Bit 8 Enable ZO to be selected in the basis frame
Bit 9 Enable ZO to be selected in the adjustable frame
Bit 10 Enable ZO, coarse and fine, to be selected
Bit 11 Select tool offset, geometry and wear
Bit 12 Select tool offset, not inverted and inverted
Bit 13 Select tool offset L1, R or L1, L2, L3 R
Bit 14 Select tool offset, zero offset (_TZL)
Bit 15 Select tool offset, dimensional difference monitoring (_TDIF)
Bit 16 Select workpiece measurement with spindle reversal
Bit 17 Selects align workpiece probe in the switching direction
Bit 18 Select number of measurements (_NMSP)
Bit 19 Select offset with mean value generation (_TMV) 1)
Bit 20 Select experience values (_EVNUM)
Bit 21 Select total setting-up offset
Bit 22 Select calibration to unknown or to known center point
Bit 24 Select calibration with/without position deviation
Bit 25 Select zero offset when measuring the angulation of the spindle
SD55630 $SCS_MEA_FEED_MEASURE Measuring feedrate [mm/rev]

= 300 Measuring feedrate when calibrating the workpiece probe

Configuring cycles
Note
Measuring feedrate for workpiece measuring
All measuring cycles use the value saved in SD54611 $SNS_MEA_WP_FEED[n] as measuring
feedrate after the tool probe has been calibrated.
A different measuring feedrate can be assigned for each calibration field [n].
When calibrating the probe, either the measuring feedrate from SD55630
$SCS_MEA_FEED__MEASURE is used, or the measuring feedrate can be overwritten in the
input screen when calibrating. To do this, SD54760 MEA_FUNCTION_MASK_PIECE bit 4
must be set to 1.
SD55632 $SCS_MEA_FEED_RAPID_IN_PERCENT Percentage reduction

= 50 Default value of the percentage reduction of the rapid traverse velocity for internal cycle
intermediate positioning without collision monitoring.
The setting of the channel-specific cycle setting data SD55600 SCS_MEA_COLLI‐
SION_MONITORING must be = 0.
SD55634 $SCS_MEA_FEED_PLANE_VALUE Feedrate of the intermediate positioning

in the working plane with active collision
monitoring.
SD55636 $SCS_MEA_FEED_FEEDAX_VALUE Feedrate of the intermediate positioning

in the infeed axis with active collision mon‐
itoring.
SD55638 $SCS_MEA_FEED_FAST_MEASURE Fast measuring feedrate

= 900 Default value
SD55640 $SCS_MEA_FEED_CIRCLE Feedrate with circle programming


Configuring cycles
SD55642 $SCS_MEA_EDGE_SAVE_ANG Safety angle when measuring a corner

(CYCLE961)
=0 Degrees
This angle is added to the angle that the user entered between the workpiece reference edge and the
1st axis of the active coordinate system in a positive direction, and refers to the corner measurement in
the automatic mode (CYCLE961).
The angle that the user enters has the designation "α0" in the parameterizing screen form, corner
measurement. For compatibility programs, the designation is _STA1.
Notice:
For compatibility programs, $SCS_MEA_EDGE_SAVE_ANG should be set = 10.
21.10.4.2 Measuring workpieces at the milling machines

Measuring in the "Program" operating area can be adapted corresponding to the specific
requirements using the channel-specific cycle setting data.
Settings
SD55625 $SCS_MEA_AVERAGE_VALUE[n] Number of mean values.

=0 Default value
The following cycle setting data are written to by the measuring cycles with the "Calibrate
probe" measuring function. User parameterization is not necessary here. However, after the
probe has been calibrated, you can check these values and if required, evaluate the probe
quality, e.g. for position deviations, no values > 0.1 mm should be reached. Otherwise, the
probe must be mechanically readjusted.
The measuring feedrate at the time of calibration is used for all subsequent applications of the
measuring cycles.
Note
Observe the manufacturer's instructions for the probe.
SD54600 $SNS_MEA_WP_BALL_DIAM[n] Effective diameter of the probe ball of the

workpiece probe.
SD54601 $SNS_MEA_WP_TRIG_MINUS_DIR_AX1[n] Trigger point, minus direction,
1st measuring axis in the plane.
SD54602 $SNS_MEA_WP_TRIG_PLUS_DIR_AX1[n] Trigger point, plus direction,
2nd measuring axis in the plane.
3rd measuring axis in the tool direction.

Configuring cycles

3rd measuring axis opposite to the tool
direction. In the default case = 0.
SD54607 $SNS_MEA_WP_POS_DEV_AX1[n] Position deviation,
SD54608 $SNS_MEA_WP_POS_DEV_AX2[n] Position deviation,
SD54609 $SNS_MEA_WP_STATUS_RT Calibration status of the axis positions
SD54610 $SNS_MEA_WP_STATUS_GEN[n] Calibration status
SD54611 $SNS_MEA_WP_FEED[n] Measuring feedrate when calibrating
21.10.4.3 Measuring tools at the milling machines
Settings
SD54762 $SNS_MEA_FUNCTION_MASK_TOOL Setting for the input screen, measuring

cycles in the automatic mode, tool meas‐
urement
Bit 3 Setting for the input screen, measuring cycles in the automatic mode, tool measurement,
enable tool probe calibration data field to be selected
Bit 4 Select calibration input measuring feed (VMS) 1)
Bit 5 Select input feedrate and spindle speeds when probing
Bit 7 Select measurement in MCS and WCS
Bit 8 Select measurement, absolute and incremental
Bit 9 Select tool offset, geometry and wear
Bit 10 Select individual cutting edge measurement
Bit 11 Selects spindle reversal when calibrating in the plane
Bit 12 Select number of measurements (_NMSP)
Bit 13 Select experience values (_EVNUM)
1)
Input, measurement feedrate is valid for AUTOMATIC and JOG
Calibration data of the tool probe, referred to the machine coordinate system
Before calibration is started, the position of the tool probe in the machine coordinate system
(MCS) must be entered into the following general cycle setting data. In this case, the reference
point is the outer diameter or the tool length of the active tool in the spindle. If there is no tool
in the spindle, the reference points are the spindle center point and the tool reference point at
the spindle.

Configuring cycles
Note
Calibrate probe
If you have calibrated the tool probe in JOG mode, then the calibration data has already been
correctly entered in: SD54632 $SNS_MEA_TP_AX_DIR_AUTO_CAL[k]
You do not need to recalibrate the tool probe in the AUTOMATIC mode.
Index [k] stands for the number of the actual data field (probe number -1).
SD54625 $SNS_MEA_TP_TRIG_MINUS_DIR_AX1[k] Trigger point of the 1st measuring axis in

the negative direction.
SD54626 $SNS_MEA_TP_TRIG_PLUS_DIR_AX1[k] Trigger point of the 1st measuring axis in
the positive direction.
SD54627 $SNS_MEA_TP_TRIG_MINUS_DIR_AX2[k] Trigger point of the 2nd measuring axis
in the negative direction.
SD54628 $SNS_MEA_TP_TRIG_PLUS_DIR_AX2[k] Trigger point of the 2nd measuring axis
in the positive direction.
SD54629 $SNS_MEA_TP_TRIG_MINUS_DIR_AX3[k] Trigger point of the 3rd measuring axis in
the negative direction.
SD54630 $SNS_MEA_TP_TRIG_PLUS_DIR_AX3[k] Trigger point of the 3rd measuring axis in
the positive direction.
SD54631 $SNS_MEA_TP_EDGE_DISK_SIZE[k] Tool probe, edge length / disk diameter.
SD54632 $SNS_MEA_TP_AX_DIR_AUTO_CAL[k] Axes and directions for calibrating in AU‐
TOMATIC mode.
SD54634 $SNS_MEA_TP_CAL_MEASURE_DEPTH[k] Distance between the upper edge of the
tool probe and lower edge of the tool (cal‐
ibration depth, measuring depth for mill‐
ing radius).
SD54635 $SNS_MEA_TPW_STATUS_GEN[k] Calibration status
SD54636 $SNS_MEA_TPW_FEED[k] Measuring feedrate when calibrating
The general cycle setting data SD54632 $SNS_MEA_TP_AX_DIR_AUTO_CAL, is used to

define in which axes and directions it is possible to calibrate the tool probe.
Decimal place
ONES 1st axis
=3 both directions
TENS 2nd axis
=3 both directions

Configuring cycles
Decimal place
HUNDREDS 3rd axis
=3 both directions
Example
If the general cycle machine data SD54632 $SNS_MEA_TP_AX_DIR_AUTO_CAL has the
value 123, the tool probe is calibrated as follows in the G17 plane:
SD54633 $SNS_MEA_TP_TYPE[k] Probe version

=0 Cube, default value.
= 101 Disk in XY, working plane G17.
= 201 Disk in ZX, working plane G18.
= 301 Disk in YZ, working plane G19.
Calibration data of the tool probe referred to the workpiece coordinate system
Before calibration is started, the position of the tool probe in the workpiece coordinate system
(WCS) must be roughly entered into the following general cycle setting data. In this case, the
reference point is the outer diameter or the tool length of the active tool in the spindle. If there
is no tool in the spindle, the reference points are the spindle center point and the tool reference
point at the spindle.
Note
When measuring tools, ensure that the data of the adjustable zero offset or the basic reference
always correspond to the data when calibrating (measuring in WCS!).
Always make measurements and calibrate with the same adjustable zero offset.
SD54640 $SNS_MEA_TPW_TRIG_MINUS_DIR_AX1[k] Trigger point of the 1st measuring axis

SD54641 $SNS_MEA_TPW_TRIG_PLUS_DIR_AX1[k] Trigger point of the 1st measuring axis
SD54642 $SNS_MEA_TPW_TRIG_MINUS_DIR_AX2[k] Trigger point of the 2nd measuring axis
SD54643 $SNS_MEA_TPW_TRIG_PLUS_DIR_AX2[k] Trigger point of the 2nd measuring axis

Configuring cycles
SD54644 $SNS_MEA_TPW_TRIG_MINUS_DIR_AX3[k] Trigger point of the 3rd measuring axis

SD54645 $SNS_MEA_TPW_TRIG_PLUS_DIR_AX3[k] Trigger point of the 3rd measuring axis
SD54646 $SNS_MEA_TPW_EDGE_DISK_SIZE[k] Tool probe, edge length / disk diameter.
SD54647 $SNS_MEA_TPW_AX_DIR_AUTO_CAL[k] Automatic calibration of tool probe, en‐
able axes/directions
SD54648 $SNS_MEA_TPW_TYPE[k] Probe version
=0 Cube (default value)
= 101 Disk in XY, working plane G17.
= 201 Disk in ZX, working plane G18.
= 301 Disk in YZ, working plane G19.
SD54649 $SNS_MEA_TPW_CAL_MEASURE_DEPTH[k] Distance between the upper edge of
the tool probe and lower edge of the
tool (calibration depth, measuring
depth for milling radius).
SD54650 $SNS_MEA_TPW_STATUS_GEN[k] Calibration status
SD54651 $SNS_MEA_TPW_FEED[k] Measuring feedrate when calibrating
The following general cycle setting data SD54647 $SNS_MEA_TPW_AX_DIR_AUTO_CAL is

used to define in which axes and directions it is possible to calibrate a tool probe.
Decimal place
ONES 1. Axis
=3 both directions
TENS 2. Axis
=3 both directions
HUNDREDS 3. Axis
=3 both directions

Configuring cycles
Example
If the general cycle machine data SD54647 $SNS_MEA_TPW_AX_DIR_AUTO_CAL has the
value 123, the tool probe is calibrated as follows in the G17 plane:
Monitoring when measuring with a rotating spindle
SD54670 $SNS_MEA_CM_MAX_PERI_SPEED[0] Maximum permissible peripheral

speed of the tool to be measured.
= 100 Default value
SD54671 $SNS_MEA_CM_MAX_REVOLUTIONS[0] Maximum permissible tool speed of the

tool to be measured. The speed is au‐
tomatically reduced when exceeded.
SD54672 $SNS_MEA_CM_MAX_FEEDRATE[0] Maximum permissible feedrate to

probe the tool to be measured at the
probe.
= 20 Default value
SD54673 $SNS_MEA_CM_MIN_FEEDRATE[0] Minimum feedrate for the first probing

of the tool to be measured at the probe.
This avoids excessively small fee‐
drates for large tool radii.
=1 Default value
SD54674 $SNS_MEA_CM_SPIND_ROT_DIR[0] Spindle direction of rotation to measure

tools.
4 = M4 Default value
Note
If the spindle is already rotating when the measuring cycle is called, this direction of rotation
remains independent of the setting of this data.

= 10 Default value

Configuring cycles
=0 Only single probing with the feedrate calculated by the cycle. However, as a minimum, the
value from SD54673[0] $SNS_MEA_CM_MIN_FEEDRATE.
=≥1 First probing with feedrate. However, as a minimum with the value from
SD54673[0] $SNS_MEA_CM_MIN_FEEDRATE)
SD54675[0] $SNS_MEA_CM_FEEDFACTOR_1

=0 Second probing with the feedrate calculated by the cycle. This is only effective for
SD54673 $SNS_MEA_CM_FEEDFACTOR_1[0] > 0, default value.
=≥1 Second probing with the calculated feedrate from SD54673 $SNS_MEA_CM_MIN_FEE‐
DRATE[0] feedrate factor 2.
Third probing with the calculated feedrate.
Note
Feedrate factor 2 should be less than feedrate factor 1.
SD54677 $SNS_MEA_CM_MEASURING_ACCURACY[0] Specified measuring accuracy.

The value of this parameter always
refers to the last probing of the tool
at the probe.
= 0.005 Default value
Measurement with rotating spindle: Measured value correction using correction tables
SD54691 $SNS_MEA_T_PROBE_OFFSET Activates the measuring result cor‐

rection
=1 Correction in the cycle. This is only effective if SD54690 $SNS_MEA_T_PROBE_MANUFAC‐
TURER>0.
=2 Correction using user-defined correction table
SD54689 $SNS_MEA_T_PROBE_MANUFACTURER Activate pre-configured compensation

tables for several tool probe models
(customer-specific).
=1 TT130 (Heidenhain)
=2 TS27R (Renishaw)

Configuring cycles
Correction values for users

If the general cycle setting data SD54691 $SNS_MEA_T_PROBE_OFFSET= 2, the following
settings apply:
SD54695 to SD54700 Correction values for radius meas‐ See the subsequent general cycle
urement. setting data.
SD54705 to SD54710 Correction values for length meas‐ See the subsequent general cycle
urement. setting data.
SD54695 $SNS_MEA_RESULT_OFFSET_TAB_RAD1[n] Radius measurement

SD54705 $SNS_MEA_RESULT_OFFSET_TAB_LEN1[n] Length measurement
=0 0
=1 1. Radius
=2 2. Radius
=3 3. Radius
=4 4. Radius
21.10.4.4 Measuring workpieces at the turning machines
General settings for turning
MD52740 $MNS_MEA_FUNCTION_MASK Measuring cycles function screen

Bit 1 Workpiece measurement, measuring in the third geometry axis (Y, when turning
= 0 The measuring cycles do not support a third geometry axis (Y axis)!
=1 Setpoint input and parameterization (SETVAL, _TUL, _TLL, SZO) refer to the third geometry
axis (Y axis). The correction of the tool length or zero offset is however realized in the second
geometry axis (X axis, ordinate) active components (i.e. measure in Y and correct in X). The
correction target can be influenced using parameter _KNUM!
Bit 16 Measuring input, tool probe
Calibration data of the tool probe, referred to the machine coordinate system
Before calibration is started, the position of the tool probe in the machine coordinate system
(MCS) must be entered into the following general cycle setting data.
SD54615 $SNS_MEA_CAL_EDGE_BASE_AX1[n] Calibration slot base referred to the 1st

measuring axis.
SD54617 $SNS_MEA_CAL_EDGE_PLUS_DIR_AX1[n] Calibration slot edge in the positive direc‐
tion of the 1st measuring axis.
SD54618 $SNS_MEA_CAL_EDGE_MINUS_DIR_AX1[n] Calibration slot edge in the negative di‐
rection of the 1st measuring axis.
SD54619 $SNS_MEA_CAL_EDGE_BASE_AX2[n] Calibration slot base referred to the 2nd
measuring axis.
SD54620 $SNS_MEA_CAL_EDGE_UPPERE_AX2[n] Upper calibration slot edge referred to the
2nd measuring axis.

Configuring cycles
SD54621 $SNS_MEA_CAL_EDGE_PLUS_DIR_AX2[n] Calibration slot edge in the positive direc‐

tion of the 2nd measuring axis.
SD54622 $SNS_MEA_CAL_EDGE_MINUS_DIR_AX2[n] Calibration slot edge in the negative di‐
rection of the 2nd measuring axis.
Note
For a standard lathe with axes X and Z (G18), axis Z is the 1st measuring axis and axis X is
the 2nd measuring axis.
21.10.4.5 Measuring tools at the turning machines
Calibration data of the tool probe referred to the machine coordinate system
If you wish to calibrate the tool probe in the machine coordinate system, then the position of
the tool probe in the machine coordinate system must be entered into the following general
cycle setting data.
SD54625 $SNS_MEA_TP_TRIG_MINUS_DIR_AX1[k] Trigger point in minus direction of the 1st

measuring axis (for G18 Z)
SD54626 $SNS_MEA_TP_TRIG_PLUS_DIR_AX1[k] Trigger point in plus direction of the 1st
measuring axis (for G18 Z)
SD54627 $SNS_MEA_TP_TRIG_MINUS_DIR_AX2[k] Trigger point in minus direction of the 2nd
measuring axis (for G18 X).
SD54628 $SNS_MEA_TP_TRIG_PLUS_DIR_AX2[k] Trigger point in plus direction of the 2nd
Calibration data of the tool probe referred to the workpiece coordinate system
If you wish to calibrate the tool probe in the workpiece coordinate system, then the position of
the tool probe in the workpiece coordinate system must be entered into the following general
cycle setting data. In this case, the reference point is the outer diameter or the tool length of
the active tool in the spindle.
Index [k] stands for the number of the actual data field (probe number -1).
SD54640 $SNS_MEA_TPW_TRIG_MINUS_DIR_AX1[k] Trigger point minus direction of the 1st

measuring axis (for G18 Z).
SD54641 $SNS_MEA_TPW_TRIG_PLUS_DIR_AX1[k] Trigger point plus direction of the 1st
measuring axis (for G18 Z).
SD54642 $SNS_MEA_TPW_TRIG_MINUS_DIR_AX2[k] Trigger point minus direction of the 2nd
SD54643 $SNS_MEA_TPW_TRIG_PLUS_DIR_AX2[k] Trigger point plus direction of the 2nd

Configuring cycles
Tool measurement using the "Orientable toolholder" or "Swivel tool" function

If the general cycle machine data MD52740 $MNS_MEA_FUNCTION_MASK, bit 16 = 1, then
the following setting applies:
MD51618 $MNS_MEA_CM_ROT_AX_POS_TOL Tolerance parameter for rotary axis set‐

tings
= 0,5 Default value
The real angular position of rotary axes can deviate from that programmed (exact stop fine
window) This deviation depends on the position control properties of the axis. The maximum
deviation that can be expected at a specific axis should be entered into the parameter. When
the tolerance is exceeded, Alarm 61442 is output - "Toolholder not parallel to the geometry
axes".
21.10.5 Logging
21.10.5.1 Logging the measuring, general

General logging can be performed without special settings:
● In the passive file system of the NC
● On the local drive of the CF card
If you want to use a logical drive for the logging, you require the Execution from External
Storage (EES) function, see Chapter "Setting the EES (Page 52)".
General machine data

Logging can be controlled via the following machine data settings:
MD11420 $MN_LEN_PROTOCOL_FILE File size for log files (KB)

≥ 20 recommended value
Increase the value of machine data MD11420 if larger log files have to be stored in the file
system of the NC.
MD11422 $MN_PROTOCOL_FILE_MODE Setting the behavior of the WRITE com‐

mand
Bit 0 Persistence behavior
= 0 time-delayed WRITE command (immediately persistent)
= 1 = fast WRITE command (time-delayed persistent)
Note
Set MD11422 bit 0 = 1 so that the program runtimes are not lengthened significantly.

Configuring cycles
21.10.5.2 Logging while measuring in the JOG mode

You can set the following setting data in the "Settings for Measurement Log" window for the
JOG mode.
References
Operating Manual, Turning/MIlling/Grinding; Chapter "Settings for the measurement result log"
Cycle channel setting data
SD55774 $SCS_J_MEA_PROTOCOL_FILE Name and path for the log file for measuring in JOG
//NC:/WKS.DIR/TEMP.WPD/J_MEAPROT.TXT Default setting
SD55740 $SCS_MEA_FUNCTION_MASK Measuring cycles function screen, workpiece/tool

measurement
Bit 28 Select new log or continuos log for measuring standard log in JOG
= 0 New log (default value)
= 1 Continuous, i.e. always attach to the existing log
Bit 29 Select file format for measuring standard log in JOG
= 0 Text format (default value)
= 1 Tabular format
21.10.5.3 Logging while measuring in the AUTOMATIC mode
Cycle channel setting data
SD55730 $SCS_MEA_PROTOCOL_USER_EXT File extension for user log

TXT Default setting
SD55614 $SCS_MEA_RESULT_MRD Setting of the program control of the measurement

result display MRD
=0 Switch off the measurement result display
=1 Switch on the measurement result display (default value)
Definition file: User GUD block

Data for user logs are generally logged from the S_PROTTXT[10] GUD array (PGUD).
If the data array is not sufficient, you can create a second array with the predefined name
S_USERTXT[n] in a separate GUD block (e.g. MGUD or UGUD):
DEF NCK STRING[200] S_USERTXT[n] ; n = number of field elements

Configuring cycles
Note
The logging operation checks whether the S_USERTXT array is available. If S_USERTXT is
available, the content of the array is logged. If S_USERTXT is not available, the content of the
S_PROTTXT array is logged.
21.10.5.4 Manufacturer and user cycle CUST_MEAPROT.SPF
Function
You can make individual adaptations to the log form and content in the CUST_MEAPROT
cycle.
Procedure
1. Open the CUST_MEAPROT.SPF cycle file.
2. Select the program lines in the _MARK1 block.
3. Copy the contents from the _MARK1 block to the _MARK2 block.
4. Adapt the parameters individually in the _MARK2 block.
5. Save the changed cycle file.
The original default values are retained and can be activated/deactivated at any time
(setting of comment characters).
Parameter
In the CUST_MEAPROT cycle, all the possible parameter changes are described in detail in
the _MARK2_1 block.
You can adapt the following parameters:
Parameter Default value Input area

Characters per line 66 > 66 possible (1
Characters per column 2 to 4 14 Min. 12, max. 14
Workpiece counter "" Identifier
Column space " " Blank string (≥ 2 * blanks)
Identifier for tolerance specifica‐ "#" 1 character
tion
Identifier for tolerance violation "!" 1 character
Log header lines 5 to 7 "" Any text
1)
66 characters per line correspond to the screen width in the default setting. A log line is therefore
displayed completely on the screen. If logging is mainly performed in the file system of the NC, this
setting should be retained because of the better readability. If you perform logging mainly in external
files, you can increase the line width accordingly. In this case, the width of column 1 is increased
automatically (with the same width for columns 2, 3 and 4 and the same column space).

Configuring cycles
21.11 Compare cycles version
21.11.1 Display cycles version

If cycles have version details, you can display them in the version screen.
Precondition
The version details are included in the cycles files in the following form:
;VERSION: <Version> ;DATE: <YYYY-MM-DD>
Example:
;VERSION: 05.05.05.00 ;DATE: 2012-11-30

Configuring cycles
Procedure

3. Select the "OEM applications /manufacturer cycles" areas and press the
"Details" softkey.
The "Manufacturer Cycles" window opens.
The "Planned-actual comparison" softkey is selected by default.
See also
Save information (Page 376)
Logbook (Page 379)

Configuring cycles
21.11.2 Specify cycles version
General
You have the possibility to compare a required cycles version with the existing cycles version
in the version view.
File overview
The following files are required:
Name Path Meaning

versions.xml /siemens/sinumerik/hmi/data/version/oem/cma Version file
versions.xml /oem/ Version path file
Adapting the version file

The cycles version specification requires a manual adaptation of the version file.
1. Copy the "versions.xml" sample file from the following directory:
/siemens/sinumerik/hmi/data/version/oem/cma
2. Save the sample file in its own directory under /oem.
The standard directory for this purpose is /oem/sinumerik/hmi/data/version/oem/cma.
3. Open the file.

Configuring cycles
4. Enter the planned version for the cycles files in the <info> tag with "defaultFileVersion" and
the details for the complete version in the <Version> tag.
5. Close the file to save the changes.
Example:
<info defaultFileType=" *.spf *.cpf" defaultFileVersion="05.05.00.00"

linkname="CMA" linkpath="//NC/CMA.DIR" EffDirOrder="CUS CMA">
<Name>Manufacturer cycles</Name>
<Version>5.5.0.0</Version>
<Link>
<Name>CUS</Name>
<Path>//NC/CUS.DIR</Path>
</Link>
</info>
Adapting the version path file

If the version file is saved in the standard directory, and a current oem\versions.xml is available,
no changes are required. In all other cases, the path data can be manually changed:
1. Open the versions.xml file under /oem
2. Replace the standard path in the <Path> tag for the "Manufacturers Cycles" with your own
path for the version file.
3. Close the file to save the changes.
Standard:
<Component>
<Name>Manufacturer Cycles</Name>
<Path>/siemens/sinumerik/hmi/data/version/oem/cma</Path>
</Component>
Example:
<Component>
<Name>Manufacturer Cycles</Name>
<Path>/oem/sinumerik/hmi/data/version/oem/cma</Path>
</Component>

Additional language 22
22.1 Installing additional languages
Additional languages
In addition to the already existing standard languages, additional user interface languages are
available on a separate DVD.
The integrated online help is either displayed in the relevant language of the country or in
English.
Refer to the following chapter for the languages that are available for the user interface:
Precondition
Software option
"Additional languages"
● After the installation, approx. 256 MB memory must be available on the CompactFlash Card.
● Language extension software "hmi_sl_language_xxx_02.06.00.00.00y.arc".
xxx = language code, y = internal version ID
Is supplied on the language extension DVD.
Installing a language
Install the language the same as for a commissioning archive (ARC). For the procedure, please
refer to the following Chapter: Reading-in a start-up archive (Page 302)
Note
Additional software language of the previous version is compatible to the actual operating
software.

Additional language
22.3 Supported languages
22.2 Uninstalling languages

If you no longer require a language interface, then you can uninstall this.
Note
Standard languages and the currently active language for the operating software cannot be
uninstalled.
Procedure
2. Press the "Change language" softkey.

The "Language selection" window opens. The language most recently set
is highlighted.
3. Switch the cursor to the required language.
4. Press the "Delete language" softkey.
The "Delete language" window opens.
The operating software uninstalls the selected language.
Table 22-1 Supported languages
Language Language code Standard languages

Chinese (simplified) chs X
Chinese (traditional) cht
Danish dan
German deu X
English eng X
Finnish fin
French fra X
Indonesian ind
Italian ita X
Japanese jpn
Korean kor
Malaysian msl
Dutch nld
Polish plk

Additional language
Language Language code Standard languages

Portuguese ptb
Romanian rom
Russian rus
Swedish sve
Slovenian slv
Slovakian sky
Spanish esp X
Thai tha
Czech csy
Turkish trk
Hungarian hun
Vietnamese vit

Additional language

SINUMERIK Operate on PC/PCU 23
23.1 Link OEMFrame application
Integrating an OEM application

The following files should be adapted and created in order to integrate an OEMFrame
application into the operating software:
● Configuration file systemconfiguration.ini
The operating software is started and controlled from the system manager; the system
manager also controls the OEMFrame applications. The system manager is configured
using the "systemconfiguration.ini" configuration file.
● Configuring the start softkey
In order to start an OEMFrame application from the operating software, configure a softkey
on the expansion bar of the operating area.
● Configuration file "slamconfig.ini"
In order to configure the softkey position with text and/or symbol for the OEMFrame
application, generate the "slamconfig.ini" file.
● Save the language-dependent text for a softkey in the file mytext_<Ing>.ts.
"systemconfiguration.ini" file
In order to integrate an OEMFrame application into the operating software, copy the
"systemconfiguration.ini" configuration file and place it in one of the two directories:
<Installation path>/user/sinumerik/hmi/cfg
<Installation path>/oem/sinumerik/hmi/cfg
All of the processes to be managed by the system manager, as well as the applications that
are to be integrated as OEMFrame applications are in the [processes] section.
Value Meaning
process Symbolic name of the OEMFrame application. This is required to configure the
operating areas.
cmdline Command line which is transferred to the "oemframe.exe" process when starting.
oemframe For OEMFrame applications, always set to "true".
windowname Window name of the OEMFrame application - should be determined with "find‐
window.exe" or "spy++.exe".
classname Class name of the OEMFrame application - should be determined with "findwind‐
ow.exe" or "spy++.exe".
deferred true: OEMFrame application is not started when SINUMERIK Operate powers up,
but only when selected for the first time.

SINUMERIK Operate on PC/PCU
Example
In the following example, the two Windows applications "notepad.exe" and "calc.exe" are
configured as OEMFrame applications.
[processes]
PROC600= process:=notepadOEM,cmdline:="notepad.exe mytext1.txt",
oemframe:=true, deferred:=true, windowname:="mytext1.txt - Notepad",
classname:="Notepad"
PROC601= process:=calcOEM, cmdline:="calc.exe" oemframe:=true,
windowname:="calculator"
Section [areas]
The SINUMERIK Operate operating areas are configured in this section.
Value Meaning
name Symbolic name for the operating area.
process Name of the OEMFrame application according to section [processes].
Note
Permissible number range
In the "processes" and "areas" sections, the number range 500-999 is reserved for OEM
customers. If you use numbers less than 500, then it is possible that Siemens basis
components will be overwritten!
Example
[areas]
AREA600= name:=AreaOEM, process:=notepadOEM
AREA601= name:=AreaCalc, process:=calcOEM
Note
Only OEMFrame applications are supported that do not use any of the programming interfaces
of SINUMERIK Operate.
Section [miscellaneous]
You can make various settings in this section. Generally, only the start operating area is
changed.
Key Value
startuparea Name of the start operating area

Example
[miscellaneous]
startuparea = AreaOEM
Configuring the operating area menu

The operating area menu is intended for switching over the operating areas configured in the
"systemconfiguration.ini" configuration file. A softkey for selecting the appropriate operating
area is provided on the horizontal softkey bar for each operating area configured.
The operating area displays the names of the operating areas from the
"systemconfiguration.ini" configuration file as the text on the operating area softkeys. The
system automatically searches for a free softkey on the horizontal softkey bar for each
operating area.
Configuring additional settings

In order to configure the following settings you require the "slamconfig.ini" configuration file:
● Assigning a softkey position to a specific operating area.
● Creating a language-dependent text for the softkey.
● Displaying a symbol for the operating area on the softkey.
Creating the "slamconfig.ini" configuration file

Copy the "slamconfig.ini" and place the file in the same directory in which the
"systemconfiguration.ini" file is located:
<Installation path>/user/sinumerik/hmi/cfg
<Installation path>/oem/sinumerik/hmi/cfg
"slamconfig.ini" file
In the "slamconfig.ini" configuration file, for every operating area, you can create a section that
was configured in the "systemconfiguration.ini" file. The section must bear the configured name
of the appropriate operating area, e.g. AreaOEM.
Value Meaning
TextId Text ID for a foreign-language text which will be displayed as the softkey label.
TextContext Context of the foreign-language text.
TextFile Name of the text file which includes the context and the foreign-language text.
Graphic Name of an image file which will be used as an icon for the softkey.
SoftkeyPosition Fixed softkey position of the area softkey. In this case, softkey positions 1 to 8 are
located on the 1st horizontal bar and softkey positions 9 to 16 on the 2nd horizontal
bar, etc.
AccessLevel Access level from which the softkey will be displayed. If this value is not specified,
the access level 7 (keyswitch position 0) is set.

Example
The softkey for the "AreaOEM" operating area with the following properties is configured in
the following example:
● The softkey displays the text which has been stored in the "mytext_<lng>.ts" text file under
the context "mycontext" with the "MY_AREA" TextID.
● The "mypicture.png" icon is displayed on the softkey.
● The softkey is located at position 7 in the operating area menu.
● The softkey with access level 5 (keyswitch position 2) is displayed.
[AreaOEM]
; Text-ID of a language dependent text
TextId = MY_AREA
; File name of the text file which contains the Text-ID
TextFile = mytext
; Context in the text file to which the Text-ID is assigned to
TextContext = mycontext
; File name of an icon shown on the area softkey
Picture = mypicture.png
; Position of the area softkey on area menu,
; If no position is specified, an empty position is searched
SoftkeyPosition = 7
; Access level of the area softkey
AccessLevel = 5
Note
Operating area position 7 is reserved for OEM customers.
Labeling text for the softkey

Storage path:
<Installation path>/user/sinumerik/hmi/lng
<Installation path>/oem/sinumerik/hmi/lng
The XML identifiers have the following meanings:
Attribute Description
context Context within the text file.
Each file must have at least one context.
name Name of the context.

23.2 Using interactive or silent installation versions
Attribute Description
message Text translation.
There must be at least one message per context.
source Text identifier.
translation Translated text.
remark Text comment (optional).
chars Maximum possible length of the text in characters. If nothing is specified, the
text can have any length (optional).
lines Maximum number of lines available for display. If nothing is specified, the
number of lines is unlimited (optional).
Structure of the language-dependent ts file that contains the labeling text for the softkey:
mytext_<lng>.ts
<!DOCTYPE TS>
<TS>
<context>
<name>mycontext</name>
<message>
<source>MY_AREA</source>
<translation>Text, which is displayed on the softkey</translation>
<remark>Remark (optional)</remark>
<chars>20</chars>
<lines>2</lines>
</message>
</context>
</TS>
<lng> stands for the language code.
General Information
If you install SINUMERIK Operate using PC/PCU, then the execution is realized using an MSI
setup. The following installation versions are available, which you can use in the interactive or
silent mode using the appropriate Windows command line:
● SINUMERIK Operate complete installation
● SINUMERIK Operate base installation with auxiliary files
● SINUMERIK Operate base installation without auxiliary files

Execution
You control setup execution using command line arguments. The interactive mode /v allows
you to transfer parameter strings to setup.exe. If you wish to run setup without user interaction,
then you can extend the parameter string with the silent mode /qn.
Place the parameter string in inverted commas. If you use several parameters in the string,
separate these using spaces.
If you do not specify any arguments when calling setup.exe, then the complete installation is
run in the interactive mode.
Note
Do not put any spaces between /v and the parameter string.
Note
If you want a progress display in the silent mode, then instead of specifying /qn you can also
specify /qb!.
Interactive installation versions
setup.exe Complete installation in the interactive mode

setup.exe /v"BASEONLY=1" Base installation in the interactive mode with help
files
setup.exe /v"BASEONLY=1 HELPFILES=0" Base installation in the interactive mode without
help files
Silent installation versions
setup.exe /v"/qn" Complete installation in the silent mode

setup.exe /s /v"/qn" (/s suppresses all of the setup messages)
setup.exe /v"/qn BASEONLY=1" Base installation in the silent mode with help files
setup.exe /s /v"/qn BASEONLY=1" (/s suppresses all of the setup messages)
setup.exe /v"/ Base installation in the silent mode without help
qn BASEONLY=1 HELPFILES=0" files
setup.exe /s /v"/ (/s suppresses all of the setup messages)
qn BASEONLY=1 HELPFILES=0"
Installation path
If you install the PC version of SINUMERIK Operate, then you can additionally specify the
installation path:
setup.exe /s /v"/qn INSTALLDIR=C:\Programme\testdir"
For spaces in the path:
setup.exe /s /v"/qn INSTALLDIR=\"C:\Program Files\testdir\""

23.3 Setting the IP address of the NCU
Exit code
You can identify a successful installation or errors based on the exit code of the setup.exe call:
Exit code == 0 No error

Exit code <> 0 Error
Log file
During the installation you can generate a log file with /L:
setup.exe /s /v"/qb! /L*vx log.txt"
23.3 Setting the IP address of the NCU

From the user interface of the SINUMERIK Operate, you can set the IP address of the NCU
with which it should connect.
Procedure
2. Press the "HMI" softkey and the ">>" softkey.
Press the vertical softkey "NCU connection".

The "NCU Connection" window opens.
Enter the IP address of the NCU into the input field.
3. Press the "OK" softkey to confirm the data.

23.4 SINUMERIK Operate exiting
23.4 SINUMERIK Operate exiting
Procedure
1. Press the <MENU SELECT> key on the operator panel.

OR:
Activate the <M> symbol on the touch panel.
External keyboard: Press the <F10> key.

External keyboard: Press the <Shift> + <F9> keys.
3. Press the "EXIT" softkey.
External keyboard: Press <F8>
● on the PCU to terminate SINUMERIK Operate and the Windows
system.
● If you started SINUMERIK Operate operating software on the PCU
in the service mode, then only the operating software is exited.
● On the PC itself, only SINUMERIK Operate is exited.

HT 8 24
24.1 Configuring the traversing keys
The traversing keys of the HT 8 are not labeled as their type of action is not predefined. The
labeling of the traversing keys should adapt dynamically to the type of action of the keys. To
recognize the type of action of the traversing keys, they are shown within the display in the
vertical softkey area.
The menu of the traversing keys consists of two vertical rows each with eight keys so that up
to 16 texts can be configured. The top and bottom traversing key row remain empty and can
be assigned other functions.
The following data can be displayed:
● Machine axis name
● Alias name for machine axis
● Any language-dependent text
● Symbol
The following user-specific files are required. You can use the sample files as template:
File Meaning
"sljkconfig.ini" configuration file File in which the traversing keys are configured.
Text file "oem_sljk_xxx.ts" File for labeling traversing keys in a foreign language, xxx =
language code
"sljkconfig.ini" configuration file
Entries Meaning
[State_1] Labeling type - changed via the PLC.
ParamText_x_y Text of the traversing key that is made up of parameters.
Two-line labeling is possible, whereby max. five characters are possible per line.
x: Specifies the position of the key within the row (2 to 7).
y: Specifies the key row (1 or 2).
%m1 The machine axis name of the first axis is referenced and displayed as
text. The current active axis number is read out from data block DB10.
The name from the machine data is determined via this index.
%n Defines the position in the text for the line break.
%a1 The alias axis name of the first axis is referenced and displayed as text.
The current active axis number is read out from data block DB10. The
name from the "oem_sljk_eng.ts" text file is determined via this index.

HT 8
Entries Meaning
TextId_x_y Text of the traversing key that is read from the text file (target language text).
Picture_x_y File name of the icon to be displayed.
The files with the icons must be located in the following directories: /oem/sinumerik/
hmi/ico and
depending on the resolution of the subdirectories:
/ico640
/ico800
/ico1024
/ico1280
Procedure
1. Copy the "sljkconfig.ini" configuration file from the folder
/siemens/sinumerik/hmi/template/cfg
2. Place the copy into the folder /oem/sinumerik/hmi/cfg
or /user/sinumerik/hmi/cfg
3. Open the copy in the Editor and define the traversing key labeling.
Example of a "sljkconfig.ini" configuration file

12 axes are defined in the example, with text for softkey 1 and softkey 2, as well as an image
on softkey 3 and softkey 4.
[Settings]
FileType = INI
; A few examples for further configuration options

; Alias names of machine-axes (%a1, %a2, etc.), from oem_sljk_deu.ts
(example)
[State_1]
TextId_1_1 = OEM_JK_TEXT_1
TextId_1_2 = OEM_JK_TEXT_2
ParamText_2_1 = %a1%n-
ParamText_2_2 = %a1%n+

HT 8
Picture_8_1 = AlarmCancel.png
Picture_8_2 = AlarmNCReset.png
"oem_sljk_eng.ts" text file
Entries Meaning
name Freely selectable name of the text context.
In the text file template, the name of the text context is "SIJkLabels" and stands for the
traversing key labeling (solution line jog key labels). This identifier is already stored in
the configuration file.
source Traversing key identifier of the respective axis. This text ID is referenced in the "sljkcon‐
fig.ini" configuration file with the "TextId_2_1".
The text IDs for the alias names (JK_AXISNAME_2 to JK_AXISNAME_7) must not be
changed.
translation Input of the foreign language text for the axis specified in <source>.
Language code in file names "xxx"
Language Language code

German deu
English eng
French fra
Spanish esp
Italian ita
Chinese chs
Procedure
1. You can copy the sample file " oem_sljk_deu.ts" from the following directory: /siemens/
sinumerik/hmi/template/lng.
2. Store or create the file in the /oem/sinumerik/hmi/lng or
/user/sinumerik/hmi/lng directory.
3. Give the file a name, e.g. for German texts: "sljk_deu.ts".
If you wish to set-up the labeling for additional languages, a separate file must be created
for each language. Save the file with the appropriate language code in the file name. To
do this, use the language codes specified above.

HT 8
4. Open the file and in the <message> and </message> area, define the labeling.
5. Restart the HMI.
In order that the labeling is displayed during the program runtime, the file must be converted
into a binary format. This conversion is only executed when the HMI powers up.
Example of a text file "sljk_deu.ts"

12 axes are defined in the example, with text for softkey 1 (SF1) and softkey 2 (SF2):

<!DOCTYPE TS>
<TS>
<context>
<name>SlJkLabels</name>


<message>
<source>JK_AXISNAME_1</source>
<translation>X</translation>
</message>
<message>
<translation>Y</translation>
</message>
<message>
<translation>Z</translation>
</message>
<message>
<translation>A</translation>
</message>
<message>
<translation>B</translation>
</message>
<message>
<translation>C</translation>
</message>
<message>
<translation>U</translation>
</message>

HT 8
24.2 Configuring user-specific key labeling
<message>
<translation>V</translation>
</message>
<message>
<translation>W</translation>
</message>
<message>
<translation>UV1</translation>
</message>
<message>
</message>
<message>
</message>

<message>
<source>OEM_JK_TEXT_1</source>
<translation>SF1</translation>
</message>
<message>
<source>OEM_JK_TEXT_2</source>
<translation>SF2</translation>
</message>
</TS>
See also
Labeling the keys for the HT 8

The texts of the CPF menu (CPF: Control Panel Function) for the HT 8 can be labeled with
your own texts in the particular language of the country.

HT 8
The texts are created in the "slck_xxx.ts" file.

"xxx" = language code for the corresponding language-specific labeling.
You can create and edit this file using the HMI or also externally on a PC.
Note
If you wish to create or edit the file on a PC, use an editor that supports UTF-8 coding.
Language code in file names "xxx"
Language Language code

German deu
English eng
French fra
Spanish esp
Italian ita
Chinese chs
Creating key labeling
Tag Meaning
source Designation for the user softkey. "SK_USERKEY1" to "SK_USERKEY16" are possi‐
ble, whereby the names may not be changed.
comment User-specific description of the key assignment.
translation Text that should be shown on the key.
● A maximum of 10 characters are possible per line.
● 2-line labeling is possible, whereby the line break is set using "%n".
remark Remark for key assignment.
chars Number of characters. A maximum of 10 characters per line are possible.
lines Number of lines. 2 lines are possible.
Procedure
1. You can copy the sample file " oem_slck_deu.ts" from the following directory: /siemens/
sinumerik/hmi/template/lng.
2. Store or create the file in the /oem/sinumerik/hmi/lng or
/user/sinumerik/hmi/lng directory.
3. Give the file a name, e.g. for German texts: "slck_deu.ts".
If you wish to create the key labeling for additional languages, then a separate file must be
created for each language. Save the file with the appropriate language code in the file name.
To do this, use the language codes specified above.

HT 8
4. Open the file and in the <message> and </message> area, define the key labeling.
5. Restart the HMI.
In order that the key labeling is displayed during the program runtime, the file must be
converted into a binary format. This conversion is only executed when the HMI powers up.
Example of a key label
<!DOCTYPE TS><TS>
<context>
<name>SlCkDialog</name
<message>
<source>SK_USERKEY1</source>
<comment></comment>
<translation>U1</translation>
<remark>User key 1</remark>
<chars>10</chars>
<lines>2</lines>
<languageIndependent>true</languageIndependent>
</message>
<message>
<source>SK_USERKEY2</source>
<comment></comment>
<translation>U2</translation>
<remark>User key 2</remark>
<chars>10</chars>
<lines>2</lines>
<languageIndependent>true</languageIndependent>
</message>
<message>
.....
</message>
</context>
</TS>
See also
Range of alarms (Page 244)

HT 8
24.3 Configuring the function display at user-specific keys (U keys)
Function
Active functions can be displayed at the configurable user keys via the PLC. For instance,
small LEDs can be emulated on the softkeys.
You configure the function in the "slckcpf.ini" file.
Interface signals
The PLC bits are in the output image of the PLC-HT 8 interface and are analog to those in the
input image.
Signals to the MCP1 (or MCP2)

Interface PLC → HT 8
Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
AB n + 1 U4 U3 U2 U1
AB n + 4 U9 U10 U11 U12 U13 U14 U15 U16
AB n + 5 U8 U7 U6 U5
Adapt the display in the "slckcpf.ini" file
Section Description
UserKeyLEDIcon Name of the icon file.
Standard entry: led_green.png
OFF Deactivates the icon display.
PRESSED Displays the active functions by pressing
down the softkey.
UserKeyLEDIconAlignment Specifies the position of the icon.
Standard position: AlignLeft | AlignTop
Horizontal and vertical alignments can be combined. The two
names are separated by the "|" character.
The following alignments are possible:
AlignLeft Left
AlignRight Right
AlignHCenter Horizontal, center
AlignTop Top
AlignBottom Bottom
AlignVCenter Vertical, center
UserKeyLEDMap Specifies the start address of the output image.
Entries can be made in the following form: "DBx.DBBy", "ABx",
"MBx".
Default setting: The start address is determined using
DB7 MCP1Out (or MCP2Out).

HT 8
Section Description
U1LED ... U16LED The status bit address can be defined - different from the output
VarIncLED image - using these entries.
SBLLED Note: The offsets from the HT 8 output image, for one or several
softkeys, are not taken into consideration.
WCSLED
showVarIncLED true When the increment mode is active, the icon is also
displayed on the "[VAR]" softkey.
false The icon is not displayed.
showSBLLED true When the SingleBlock mode is active, then the icon
is also displayed on the "Single Block" softkey.
showWCSLED true When the SingleBlock mode is active, then the icon
is also displayed on the "Single Block" softkey.
1. You can copy the sample file "slckcpf.ini" from the following directory: /siemens/sinumerik/
hmi/template/cfg
2. Store the file in the /oem/sinumerik/hmi/cfg or /user/sinumerik/hmi/cfg directory.
3. If you use your own icon, then locate it together with the corresponding resolution for HT 8
directory: /oem/sinumerik/hmi/ico/ico640 or /user/sinumerik/hmi/ico/ico640.
4. Open the file and make the appropriate settings.
Sample file "slckcpf.ini"

Template for the configuration of the
; HT8 control panel function menu
;
; To activate the settings remove the
; commentary ';' at the beginning of the line
;; Display settings of the user key softkey leds
[UserKeyLED]
; Filename of the LED icon
;UserKeyLEDIcon = led_green.png
; Alignment of the LED icon
;UserKeyLEDIconAlignment= AlignLeft | AlignTop
; Use following led map start address instead of calculating

DB7.MCP1Out
;UserKeyLEDMap = AB0

HT 8
; Use the following settings to use this status bits instead of the
led map for a specific sk
;U1LED=/channel/parameter/R[U1,1]
;....
;U16LED=/channel/parameter/R[U1,16]
;VarIncLED = DB11.DBX8.5
;SBLLED = DB21.DBX0.4
;WCSLED = DB19.DBX0.7
; Show a LED for the var inc sk

;showVarIncLED = true
; Show a LED for the var single block sk
;showSBLLED = true
; Show a LED for the var wcs/mcs sk
;showWCSLED = true

List of abbreviations/acronyms A
Abbreviation Meaning
ASCII American Standard Code for Information Interchange:
American coding standard for the exchange of information
BAG Mode group
OPI Operator Panel Interface
CNC Computerized Numerical Control: Computerized numerical control
CEC Cross Error Compensation: Sag compensation
CP Communication Processor
DCP Discovery and basic Configuration Protocol: ProfiNet protocol
DHCP Dynamic Host Configuration Protocol
DIN Deutsche Industrie Norm
DNS Domain Name System
DIR Directory: Directory
DRAM Dynamic Random Access Memory
DRF Differential Resolver Function: Differential resolver function (handwheel)
EES Execution from External Storage
ERTEC Enhanced Real Time Ethernet Controller
ESR Extended Stop and Retract
ETC ETC key ">"; Softkey bar extension in the same menu
FRAME Data block (FRAME)
FIFO First In - First Out: Method of storing/retrieving data in/from a memory.
GDIR Global Directory: Global part program memory
GUD Global User Data: Global user data
MSD Main Spindle Drive
HSC High Speed Cutting: High-speed machining
INC Increment: Incremental dimension
INI Initializing Data: Initializing data
IP Internet Protocol
IPO Interpolator
ISO International Standard Organization
JOG Jogging: Setup mode
LED Light Emitting Diode: Light emitting diode
LLDP Link Layer Discovery Protocol
LUD Local User Data: Local user data
MAC Media Access Control
MB Megabyte
MD Machine data
MDA Manual Data Automatic: Manual input
MCS Machine Coordinate System

List of abbreviations/acronyms
MLFB Maschinenlesbare Fabrikatbezeichnung
MPF Main Program File: NC part program (main program)
MCP Machine Control Panel: Machine control panel
NC Numerical Control: Numerical control
NCK Numerical Control Kernel: NC kernel with block preparation, traversing range, etc.
NCU Numerical Control Unit: NCK hardware unit
NFS Network File System
NTP Network Time Protocol
ZO Zero offset
OEM Original Equipment Manufacturer
OID Object Identifier: Information identifier
OP Operator Panel
PCU Programmable Control Unit
PI service Program Invocation Services
PG Programming device
PLC Programmable Logic Control
RFC Request for Comments
REF REFerence point approach function
REPOS REPOSition function
ROV Rapid Override: Input correction
RPA R-Parameter Active: Memory area in NCK for R- NCK for R parameter numbers
SBL Single Block: Single block
SD Setting Data
SDB System Data Block
SEA Setting Data Active: Identifier (file type) for setting data
SK Softkey
SMB Server Message Block
SNMP Simple Network Management Protocol
SPF Sub Program File: Subroutines
SRAM Static Random Access Memory: Static RAM (non-volatile)
SSH Secure Shell: Network protocol
SW Software
SYF System Files: System files
TCU Thin Client Unit
TEA Testing Data Active: Identifier for machine data
TMA Tool Magazine Active: Magazine data
TO Tool Offset: Tool offset
TOA Tool Offset Active: Identifier (file type) for tool offsets
UDP User Datagram Protocol: Network protocol
UFR User frame
VNC Virtual Network Computing
FD Feed Drive

WCS Workpiece Coordinate System
TM Tool Management


Index
Deactivating a warning, 257
Registering the file, 229
3 Replacing, 240
Replacing standard alarm texts, 240
3D file
Select font color, 225
Protection area elements, 284
Standard parameter specification, 245
3D simulation, 105, 109
Supported languages, 612
alarmtext_conversion.log, 230, 232, 235, 243, 246
Analog spindle, 116
A Archive
Access levels, 33 Creating, 302
Access right Reading in, 303
Effect, 36 AS-i
Global, 36 Components, 422
individual, 35 Configure diagnostics, 424
Remote access, 36 Diagnostics, 422
Action log Axis diagnostics, 356
actlog.ini, 388 Axis-specific machine data, 65
Log file, 386 Axis-specific setting data, 68
Open log file, 384
Saving log file, 386
Search for events, 385 B
Setting the log size, 388
Backing up setup data, 311
Settings, 382
Box
action.com, 386
Protection area element, 279
action.log, 386
Activate keyboard, 32
actlog.ini, 388
Actual value window
C
Setting font size, 87 Channel menu
actual_actionlog.com, 382 Configuring, 55
actual_crashlog.com, 382 Configuring operator stations, 59
Adapt tool measurement Configuring the total structure, 57
Examples when milling, 598 Defining channel groups, 57
for turning, 603 Channel operational message, 89
when milling, 596 Standard configuration, 90
Adapt workpiece measurement, 592 Channel-specific machine data, 65
Additional language Channel-specific setting data, 68
installing, 611 Checksum, 457
Uninstalling, 612 Circular position pattern, 481
Alarm log Circumferential groove, 481
Filter properties, 249 Clamping
Settings, 248 Setting up function, 111
Alarm number ranges, 244 Collision avoidance, 259
Alarm texts Changing the section, 265
Changing colors, 236 Creating a machine model, 262
Create file, 228 Creating a tool protection area, 296
Creating, 225, 228 Creating collision pairs, 297
Creating foreign-language texts, 227 Creating kinematic elements, 291

Index
Creating machine protection areas, 293 Cutting edge parameters

Enable function, 261 Identifiers, 153
Fundamentals example, 288 OEM identifier, 200
Parameter assignment, 261 Cycle alarms, 525
Collision element CYCLE495, 516
Creating, 273 CYCLE60, 481
Collision pair CYCLE63, 480
Creating, 286 CYCLE64, 480
Comment input CYCLE79, 481
ini file, 25 CYCLE800
XML file, 24 Structogram, 550
Commissioning archive CYCLE832
Creating, 311 Advanced Surface, 569
Commissioning the drive system, 131 Top Surface, 573
config.ini, 59 CYCLE84, 472
Configuring OEM icons, 103 CYCLE840, 472
Configuring OEM texts, 102 CYCLE930, 500
Configuring operator stations, 59 CYCLE950, 500
Configuring the tool change reason, 190 CYCLE951, 500
Contour grooving, 500 CYCLE952, 500
Contour milling, 480 CYCLE99, 500
Contour turning, 500 CYCLE996, 554
Coolant Cycles version
Assigning, 187 Define, 609
Identifier, 201 Displaying, 608
Coordinate system Cylinder
MD52000, 467 Protection area elements, 282
crash.com, 386 Cylinder surface transformation
crash.log, 386 in turning, 505
Creating Milling, examples, 485
Collision pair, 286 under milling, 484
Creating a machine model under ShopTurn, 507
Collision avoidance, 262 with groove side offset, 507
Creating online help without groove side offset, 506
Creating a directory, 438 Cylindrical grinding, 516
HTML_Creating file, 435 Displaying softkeys, 466
Replacing the standard online help, 437
XML_Creating file, 437
CSV file, 378 D
CUST_800.SPF, 472
Data backup, 299
CUST_832.SPF, 473, 572
Date
CUST_CLAMP, 473
Selecting the format, 28
CUST_M6, 473, 475
Setting, 29
CUST_MEACYC
Deactivate keyboard, 32
Structogram, 579
dealer.xml, 373
CUST_MEACYC.SPF, 473
Defining channel groups, 57
CUST_MEAPROT.SPF, 473, 606
DHCP server detection, 340
CUST_MULTICHAN, 473, 479
Diagnostics
CUST_T, 473, 475
AS-i, 424
CUST_TECHCYC.SPF, 472
Ethernet/PROFINET network, 340
Aligning, 477
Fail-safe modules, 459
HMI trace, 389

Index
Direction of rotation
Counterspindle, 497
Main spindle, 491 F
Directory structure, 19
Face machining
Display filter
in turning, 508
Machine data, 72
under ShopTurn, 511
Display groups, 73
Fail-safe I/O modules, 459
Display machine data, 68
fast block search, 96
Search, 76
File
Displaying AS-i, 424
Copy, 22
Drilling, 470
Copying with WinSCP, 25
Drive
Cut, 23
Execution from External Storage, 53
Delete, 23
Global part program memory, 53
Displaying in preview window, 24
Logical drive, 51
External editing, 24
Set EXTCALL, 52
insert, 22
Setting up, 51
Open, 22
Drive parameters
Display/change, 70
Renaming, 23
for machine data, 65
Form-truing, 516
Drive system
Frame
Diagnostics, 393
Diagnostics - details, 394
Drive-specific machine data, 65
G
E G code groups
Configuring the display, 88
Editing an xml file, 24
G group 59, 571
Editing enum values, 75
G-code program, 213
Editing the tool and magazine management, 214
General machine data, 65
Engraving, 481
General setting data, 68
Entering BICO values, 75
Generating a crashlog file, 383
Error analysis, 328
Generating an archive for the Hotline, 307
Error file of the alarms, 246
Grinding parameters
Ethernet/PROFINET
Identifiers, 157
Diagnostics, 340
Displaying messages, 341
Network trace, 342
Trace parameters, 343
H
EUNA, 370 Hardware components
EXIT, 622 Adding, 378
Displaying the softkey, 32 Entering, 377
Expert parameters, 73 HEAD_1, 537
EXTCALL High-Speed Settings, 569
switch off and on again, 52 Hirth joint, 522, 564
Extended reset, 71 HMI PRO RT, 420
HMI restart
Displaying the softkey, 32
HMI trace, 389
HOLES2, 481
HT 8
Activating, deactivating the virtual keyboard, 31

Index
Configuring the traversing keys, 623 Parallel rotary axis, 272

Key labeling, 627 Parallel switch, 273
LED display on user keys, 630 Rotary axis, 272
oem_sljk_deu.ts, 625 Switch, 273
slguiconfig.ini, 31 Kinematic rotation
sljkconfig.ini, 623 Kinematic element, 270
Kinematics
Check list, 526
I Examples, commissioning, 537
measured, 554
Identifier
with Hirth joint, 522
Coolant, 201
Cutting edge parameters, 153
Grinding parameters, 157
Magazine location adapter parameters, 159
L
Magazine location parameters, 158 Language
Monitoring parameters, 156 Defining the selection mode, 27
Multitool location parameter, 160 Language code, 612, 613
Multitool parameters, 159 License key
OEM cutting edge parameter, 200 Backing up from CompactFlash card, 48
OEM magazine location parameters, 201 Entering, 47
OEM monitoring parameters, 200 Reading in, 47
OEM multitool parameters, 200 License requirement
OEM tool parameters, 200 Exporting, 47
Tool parameters, 151 Licenses, 43
Tool-specific functions, 201 Linear axis
identSNAPSHOT, 370 Kinematic elements, 271
Inclined Y axis List parameters
in turning, 511 Changing, 161
under ShopTurn, 512 Creating new, 163
Index text file for alarms Log file
Create file, 230 Action log, 386
Creating texts, 231 Logbook, 379
Registering, 231 Documenting startups, 380
Inserting a run up screen, 33 Entry search, 382
Installation Importing selection files, 375
Interactive, 620 Machine identity, 370
silent, 620 Making an entry, 381
Output, 376
Logging the measurements
K Settings for AUTOMATIC, 605
Logging the measuring
Keyboard
Settings for JOG, 605
Setting, 31
Kinematic chain element
Creating, 269
Kinematic elements
M
Kinematic rotation, 270 ma_types.xml, 374
Linear axis, 271 Machine data
Offset, 272 Axis selection, 67
Parallel kinematic rotation, 270 Configuring plain texts, 84
Parallel linear axis, 271 Display filter, 72
Parallel offset, 272 Displaying, 65

Index
Editing enum values, 75

Editing hexadecimal values, 74
Entering BICO values, 75 N
Information, 66
NC/PLC variables
Overview, 65
Changing, 351
Search, 76
displaying, 349
Machine function, defining texts, 188
NCU connection
Machine identity, 370
setting - under PCU, 621
Machine model, 259
setting - under Windows, 621
Machine operating area, 87
netnames.ini, 58
Machine protection area, 275
Network
Machine-specific information
Configuring, 315
Creating a selection file, 372
Network adapter, 326
Entering, 371
Configuring, 336
Save, 376
Network diagnostics, 325
Machining time recording
Number ranges of alarms, 244
Activating, 104
Magazine location adapter parameters
Identifiers, 159
Magazine location parameters
O
Identifiers, 158 oem.xml, 374
OEM identifier, 201 oem_ae_database_conversion.log, 239
Managing data, 78 oem_alarms_eng.ts, 228
Manual machine oem_indextexts_eng.ts, 230
Activating the function, 98 oem_slaedatabase.xml, 236
Parameter assignment, 98 oem_slaesvcadapconf.xml, 229
Message texts oem_slck_deu.ts, 628
Creating, 233 oem_sljk_deu.ts, 625
creating for several channels, 234 oem_text_conversion.log, 230, 246
Part program, 233 oemsubs.xml, 374
Milling Offset
Cylinder surface transformation, 484 Configuring, 103
Displaying softkeys, 466 Kinematic elements, 272
Examples, setting-up a milling machine, 485 Operating state, 353
Settings under ShopMill, 482 Operator panels
Tool measurement, 584 Configuring, 322
Turning on milling machines, 556 Orientable toolholder, 604
Workpiece measurement, 582, 595
Monitoring parameters
Identifiers, 156 P
OEM identifier, 200
Parallel box
Multiple clamping of different workpieces
(option), 488
Parallel cylinder
Multiple edge, 481
Multitool location parameter
Parallel frame
Identifiers, 160
Multitool parameters
Parallel linear axis
Identifiers, 159
Kinematic elements, 271
OEM identifier, 200
Parallel offset
Kinematic elements, 272
Parallel sphere

Index
Parallel switch Reset

Kinematic elements, 273 Extended, 71
Password Rotary axis
Changing, 34 Kinematic elements, 272
Delete, 35 Rotary axis vectors
Set, 34 V1, 527
Performing a start-up V2, 527
Reading in original status, 306
PLC hardware upgrade archive
Creating, 303 S
Probe
Safety Integrated
Example of a test program, 576
Cam signals, 460
Testing the function, 576
Checksums, 457
to measure the tool, 575
Communication data, 461
to measure the workpiece, 575
Receive connections, 463
PROFIBUS
Safe programmable logic, 456
Connections, 390
Safety-related inputs and outputs, 455
DP slaves, 392
Send connections, 461
PROFIBUS/PROFINET diagnostics, 420
Status display, 454
PROG_EVENT.SPF, 390, 473
SBC Safe Brake Control, 458
Extend, 474
Screen
Program list
darken screen, 32
Configuring a softkey, 41
saver, 32
Creating, 41
Time until the screen is darkened, 32
Program test
Screenshots
activate, 93
Copy, 370
deactivate, 93
Creating, 369
Programming G code programs, 98
Open, 370
Protection area elements
Search
3D file, 284
Display machine data, 76
Box, 279
Machine data, 76
Creating, 276
Setting data, 76
Cylinder, 282
Search mode
File, 284
Configuring, 95
Frame, 278
Searching
Parallel box, 279
Logbook entry, 382
Parallel cylinder, 282
Service drive
Parallel frame, 278
Display, 361
Parallel sphere, 281
Parameter description, 362
Sphere, 281
Service overview, 353
Axes and drives, 355
Setting data
R Axis selection, 70
RCS Commander, 18 Channel selection, 70
Remote diagnostics Displaying, 68
Adapting, 396 Overview, 65
Replacing standard alarm texts Search, 76
Create file, 240 Setting up a counterspindle
Creating texts, 240 ShopTurn, 496
Registering the alarm text file, 241 Setting-up a lathe with milling tools, 504
Replacing the logo, 87 Setting-up measuring in JOG, 580
SGE/SGA signals, 455

Index
ShopMill PCU, 17
Settings for milling, 482 under Windows, 17
Tool-specific functions, 187 Start-up archive
ShopTurn Creating, 300
Cylinder surface transformation, 507 Reading in, 303
Face machining, 511 Station-related network diagnostics, 325
Inclined Y axis, 512 Status display
Setting up a counterspindle, 496 Inserting a logo, 87
Settings for turning, 491 Status display with icons, 100
Simulation STO Safe Torque Off, 458
Cycle application, 474 Stock removal, corner, 500
Deactivate, 108 Surface grinding, 516
General conditions, 105 Displaying softkeys, 466
Grinding technology, 107 Switch
Milling technology, 107 Kinematic elements, 273
Turning technology, 107 Swiveling
Simultaneous recording, 109 activate, 518
Activating the machining time, 110 Configuring input screens, 518
Option, 109 Creating angled tools, 520
slaesvcadapconf.xml, 229, 231, 234, 241, 257 Declare data sets, 520
slaesvcconf.xml, 235, 243 Example HEAD_2, 539
slckcpf.ini, 631 Example MIXED_45, 542
slhlp.xml, 433 Example TABLE_45, 540
slmagcodeconfig.ini, 88 Example TABLE_5, 544
SLOT2, 481 Offset vectors, 529
sltlprodiaghmi.ini, 422, 423 Retraction, 536
Softkey Rotary axes, 533
Access level, 39 Set up kinematic chain, 526
Original setting, 40 System utilization, 368
Source ID, 245
Source URL, 245
Specify the IP address of the NCU, 621 T
Sphere
Tailstock
Option, 109
Spindle analog, 116
Tapping, 472
Spindle control, 115
TEACH IN, 94
Spindle diagnostics, 118
Technology
Additional temperature sensor, 123
Cylindrical grinding, 516
Clamping state, 125
Drilling, 470
Clamping time statistics, 128
Milling, 480
Diagnostic statistics, 127
Surface grinding, 516
Logistics data, 128
Swiveling, 517
Motor temperature sensor, 122
Turning, 500
Speed limitation, 126
Template files, 22
Spindle load, 124
Test license, 46
Temperature, 120
TextPad, 18
Temperature histograms, 123
Thread-cutting, 500
SS1 Safe Stop 1, 458
Time
Standard parameter specifications of alarm
Selecting the format, 29
texts, 245
Setting, 29
Starting SINUMERIK Operate
Time server, 30
NCU, 17
Tool clamping angle, 564

Index
Tool holder, 212 Display peak-to-valley value, 419

Tool list Displaying details of the variables, 410
List views, 147 Drive variables, 406
Tool management Editing a session, 407
Enable functions, 136 Editing the graphic display, 414
Graphical tool/magazine display, 138 Filtering variables, 405
Grinding technology, 140 Insert variable, 406
Manual tool, 139 Load session, 405
MD settings, 133 Overview, 401
MD settings for diameter / cutting edge PLC/NC/servo variables, 405
radius, 136 Replace variable, 407
Milling technology, 140 Save options, 413
PLC,TRANSLINE 2000, 140 Save session, 404
Tool wear, 138 Searching for variables, 405
Turning technology, 140 Selecting a variable, 406, 415
Turning technology on milling machine, 140 Sequence, 402
With magazine management, 134 Session, 406
Without magazine management, 133 Setting grid lines, 413
Tool Management Settings (drive), 411
Assignments, 222 Settings (PLC, NC, servo), 411
Buffer locations, 219 Start recording, 413
Editing the management, 216 Starting a session, 405
Loading locations, 220 Stop recording, 413
Magazine configuration, 221 Variable attributes, 407
Opening a function, 215 Zooming characteristic graphs, 417
Tool unit, 218 TRACON, 514
Tool measurement TRACYL, 514
under milling, 584 in turning, 505
under turning, 589 under ShopTurn, 507
Tool parameters Transformation
Identifiers, 151 Settings for milling, 486
OEM identifier, 200 TRANSMIT
Tool types in turning, 508
Drill, 166 under ShopTurn, 511
Grinding tools, 166 with Y axis, 509
Milling tool, 165 TRANSMIT command, 213
Special tools, 167 Turning
Turning tools, 166 Cylinder surface transformation, 505
Tool-specific functions Displaying softkeys, 466
Identifier, 201 Examples, setting-up a lathe, 504
Topologies, 345 Face machining, 508
TRAANG, 514 Inclined Y axis, 511
in turning, 511 Settings under ShopTurn, 491
under ShopTurn, 512 Speed limitation, 515
Trace Technology cycles, 500
Changing the scale, 416 Tool measurement, 589
Creating a session, 403 Workpiece measurement, 602
Cursor A/B positioning, 418 Turning on milling machines
Data acquisition, 411 Behavior at power on, 563
Data storage on CU, 412 Behavior at reset, 563
Define zoom area, 418 Block search, 569
Display peak-to-peak value, 419 CUST_800, 566

Index
Hirth joint, 564

Kinematics transformation, 561
Setting the coordinate system, 565
Setting up, 556
Tool clamping angle, 564
U
USB FlashDrive, 18
USB keyboard, 18
User view
Creating, 81
Delete, 84
Editing, 82
Importing, 80
user.xml, 374
Using angular tools, 520
V
Variable screen forms, 352
W
WinSCP, 18, 25
under milling, 582, 595
under turning, 602

Index

Introduction 1
Setting up OPC UA
components 2
Testing the connection 3

SINUMERIK
OPC UA Data Access -
functional scope 4
SINUMERIK 840D sl/828D
SINUMERIK Integrate for
Engineering Access MyMachine /
OPC UA
Valid for:
CNC software version 4.7 SP2
10/2015
6FC5397-1DP40-5BA3
Legal information
DANGER
WARNING
CAUTION
NOTICE
damage.
Qualified Personnel
Note the following:
WARNING
Trademarks

Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents
1 Introduction...................................................................................................................................................5
2 Setting up OPC UA components..................................................................................................................7
2.1 Requirement.............................................................................................................................7
2.2 Setup........................................................................................................................................8
3 Testing the connection...............................................................................................................................13
4 OPC UA Data Access - functional scope...................................................................................................21
4.1 User administration................................................................................................................22
4.2 Browsing................................................................................................................................26
4.3 Variable paths........................................................................................................................28
4.3.1 Variable paths for NC access operations...............................................................................28
4.3.2 Variable paths for GUD access operations............................................................................29
4.3.3 Variable paths for PLC access operations.............................................................................29
4.3.4 Variable paths for machine and setting data..........................................................................32
4.3.5 Variable paths for 1:N configuration (only target system PCU)..............................................32
4.4 Supported services................................................................................................................34
4.5 Special features with regard to the OPC UA specification.....................................................35
Index...........................................................................................................................................................37
SINUMERIK Integrate for Engineering Access MyMachine / OPC UA

Table of contents

Introduction 1
OPC Unified Architecture (OPC UA) is a standard communication protocol for the industrial
environment.
Software option
You require the following software option in order to use this function: SINUMERIK
Integrate for Engineering "Access MyMachine / OPC UA".
Characteristics
Important features include:
● Independent of any particular platform
● Security
● Service call timeouts
● Heartbeat
● Buffering
Logs
Today, two protocols are available for transport via the network:
1. Binary protocol
URL: opc.tcp://ServerTCP-Port 4840
Optimized for
– Low overhead
– Low usage of resources
– Interoperability
2. Web service (SOAP)
URL: http://Server
Ports 80 (http) and 443 (https)
Optimized for
– Tool support (used from "Java" or under ".NET")
– Firewall compatibility
Information is provided in what is known as the "address space". This is comprised of "nodes"
and "references". Detailed information on this is provided on the OPC Foundation (https://
opcfoundation.org/) page.
The binary protocol is supported in the SINUMERIK environment. Currently, OPC UA Data
Access is offered as service.

Introduction

Setting up OPC UA components 2
2.1 Requirement
The OPC UA components can be installed on PCU, NCU and PPU target systems.
The following steps are necessary to do this:
1. Setting the license
2. Executing the OPC UA configuration dialog
3. Checking the HMI time
4. Performing a restart

Setting up OPC UA components
2.2 Setup
2.2 Setup
Setting the license

Set the "Access MyMachine / OPC UA" license via the "Startup > Licenses" operating area.
Figure 2-1 Setting the license
Restart the SINUMERIK Operate in order to activate the license.

2.2 Setup
Executing the OPC UA configuration dialog

Start the OPC UA configuration dialog via the operating area "Startup > Network".
Figure 2-2 OPC UA configuration dialog (initial state)
Press the "Change" button.
Table 2-1 Settings of the OPC UA configuration dialog
Setting Description
IP address The IPv4 address of the target system. This is determined automatically.
Check these:
for the NCU and PPU -X130
for the PCU 50 Local Area Connection 2
Port TCP port, communicates via the OPC UA. This is added to the firewall
exceptions for NCU and PPU.
(The standard for the OPC UA communication is the TCP port 4840)
Admin User Name of the administrator; with it you can add or delete other users and
assign or delete user authorizations.
Password Password of the administrator.
Activate OPC UA Place the checkmark to activate OPC UA and remove the checkmark to
deactivate it.

2.2 Setup
Note
If you want to change the administrator password later, you can do this via the OPC UA method
"ChangeMyPassword".
Figure 2-3 OPC UA configuration dialog (with corresponding changes)
Then choose "OK". If you enter a different port from the standard OPC UA TCP port (4840),
you will receive a safety note.

2.2 Setup
Figure 2-4 Security message for opening the TCP port
Checking the HMI time

You must correctly set the HMI time so that the secure OPC UA communication functions.
Note
The certificate needed for secure OPC UA communication (../siemens/sinumerik/hmi/miniweb/
System/Cert/servercerts/MiniWeb_OPCUA.crt) is automatically created during the first run-up.
The start date of the validity period is set to the current date. The validity period is 30 years.
If the time is subsequently changed so that it lies outside the validity period, the secure OPC
UA communication does not function (BadCertificateTimeInvalid).
Performing a restart
Perform a hardware restart on the target systems NCU and PPU. A restart of the
SINUMERIK Operate is necessary on the PCU 50.

2.2 Setup

Testing the connection 3
Requirement
To test the connection, you can use the "Sample Applications" of the OPC Foundation (http://
www.opcf.org/) under "Developer Tools/Developer Kits/Unified Architecture". It is necessary
to register with the OPC Foundation for this.
Note
There are two ways to establish the connection:
● Connection without security
● Connection with the security policy "Basic128Rsa15" and the security mode
"SignAndEncrypt"
Installation
The "Sample Applications" additionally install a service with the name "OPC UA Local
Discovery Server". Should you want to locally test the OPC UA connection, i.e. an installation
directly on the PCU 50, you must deactivate this service.
Note
If the service "OPC UA Local Discovery Server" is active, the SINUMERIK OPC UA server
cannot be started correctly, because it blocks the needed TCP port 4840.
The service has no influence if the "Sample Applications" are installed on a PC in the network.
Deactivation is then not necessary.

Testing the connection
Figure 3-1 Deactivating the "OPC UA Local Discovery Server" service on PCU 50

Procedure
1. Start the OPC UA "Sample client".
Figure 3-2 Sample Client main window
2. Select the "New" entry from the drop-down list.

The "Discover Servers" window opens.

3. Now enter the IPv4 address of the target system and click the "Discover" button.
Figure 3-3 Discover servers
4. The SINUMERIK OPC UA server appears in the list. Select the server and confirm with
"OK".
5. Return to the main window and click the "Connect" button.

6. To establish a simple connection without security, make the following settings. Enter the
administrator user assigned when OPC UA was set up and his password by pressing "..."
for "User Identity". Then confirm the settings with "OK".
Figure 3-4 Server configuration
Figure 3-5 User Identity

7. Make the following settings in the "Open Session" dialog. It is necessary to enter the
administrator user and the assigned password again here. Confirm with "OK".
Figure 3-6 Open session
Confirm the prompt asking if you want to trust the transferred certificate with "Yes".
The connection to the SINUMERIK OPC UA server has now been established and the
available address space is displayed.
Figure 3-7 Address space of the SINUMERIK OPC UA server
8. Now navigate to a nodeID (e.g. R-parameter at Sinumerik > Channel > Parameter > R) and
right-click the corresponding entry. You can now test various functions:

– E.g. read, write, setup monitoring
Figure 3-8 NodeID "Sinumerik > Channel > Parameter > R"
– The attributes of a NodeID can be queried via the entry "View Attributes". One of these
attributes is the "Value", which provides the corresponding value of R1.
Figure 3-9 Viewing node attributes


OPC UA Data Access - functional scope 4
Objective of the section
This section describes the functional scope and the SINUMERIK-specific special features of
the OPC UA Data Access interface.
Note
The communication time is not guaranteed. As a consequence, realtime tasks cannot be
implemented using the OPC UA data access interface.
Detailed information on the OPC UA specification is provided on the OPC Foundation (https://
opcfoundation.org/) page.
Using the OPC UA data access interface, data can be accessed on the NC and PLC. In
particular, variables can be read and written, and you can be notified when a value changes.
You can access individual variables (e.g. /Channel/Parameter/R[u1,1]) and array variables
(e.g. /Channel/Parameter/R[u1,1,10]).
Note
Limited number of simultaneously monitored variables
The number of variables from the "Sinumerik" object that can be monitored simultaneously is
limited:
● SINUMERIK 828D, maximum 100 variables
● SINUMERIK 840D sl, maximum 200 variables
If you attempt to monitor more variables, the "BadNodeIdUnknown" error is returned.

OPC UA Data Access - functional scope
4.1 User administration
User administration
To establish a connection to the OPC UA Data Access interface, an authentication with user
name and password is required.
Note
Anonymous connection
You can also establish an anonymous connection, but none of the functions will be available
(feedback: "BadInternalError").
For an initial connection, you must use the administrator user and password assigned when
OPC UA was set up. Methods with the following functions will then be available under the node
"Sinumerik/Methods":
● Add own users
● Delete own users
● Assign rights
● Remove rights
Note
You can only add/remove users/rights if you are connected as administrator. If you call the
methods with a different user, you will receive the message "BadInvalidArgument".
Table 4-1 Methods for user administration
Method Description
AddUser Creates a new user for accessing OPC UA.
Input Arguments:
UserName User Name
Initially, the password of the new user corresponds to the user name. It should
then be changed using the method "ChangeMyPassword".
DeleteUser Deletes a user who was added previously using the method "AddUser".
Input Arguments:
UserName User Name
The administrator user created when OPC UA was set up cannot be deleted.

Method Description
ChangeMyPassword Changes the password for the connected user.
Input Arguments:
OldPwd Current password
NewPwd1 New password
NewPwd2 New password (security prompt)
Important!
Whereas the methods "AddUser", "DeleteUser", "GiveUserAccess" and "De‐
leteUserAccess" can only be called up if the user is connected as the admin‐
istrator, the user must connect as the corresponding user in order to change
the password.

Method Description
GiveUserAccess Sets the specified access rights for a user. The rights below can be combined
in any combination.
Input Arguments:
User User name which is to given the rights
Realm The access rights to be set as a string.
If a user wants to set several rights,
they must be separated by a semico‐
lon.
Some possible realm strings are:
"StateRead" Status data - NC, channel, axis, read
access
"StateWrite" Status data - NC, channel, axis, write
access
"FrameRead" Zero offsets, read access
"FrameWrite" Zero offsets, write access
"SeaRead" Setting data, read access
"SeaWrite" Setting data, write access
"TeaRead" Machine data, read access
"TeaWrite" Machine data, write access
"ToolRead" Tool and magazine data, read access
"ToolWrite" Tool and magazine data, write access
"DriveRead" Drive data, read access
"DriveWrite" Drive data, write access
"GudRead" User data, read access
"GudWrite" User data, write access
"PlcRead" PLC, read access
"PlcWrite" PLC, write access
"RandomRead" Random (and ReadVar method), read
access
"RandomWrite" Random (and WriteVar method), write
access
"SinuReadAll" All of the read access operations men‐
tioned
"SinuWriteAll" All of the write access operations men‐
tioned
Example:
GiveUserAccess("MyUser", "GudRead; PlcWrite")
Sets the read access for user data for the "MyUser" user and sets the write
access for the PLC.

Method Description
DeleteUserAccess Deletes the specified access rights for a user.
Input Arguments:
User A user whose rights are to be deleted
Realm The access rights to be deleted as a
string.
If a user wants to delete several rights,
they must be separated by a semico‐
lon.
For possible realm strings, see "GiveUserAccess".

4.2 Browsing
4.2 Browsing
If the OPC UA data access interface is browsed, then the available address space is mapped
under "Sinumerik".
Global User Data (GUD) can be found under the "/Sinumerik/GUD" node.
The PLC blocks (inputs, outputs, bit memory, data blocks) can be found under the "/Sinumerik/
Plc" node.
Machine data can be found under the node "/Sinumerik/TEA".
Setting data can be found under the node "/Sinumerik/SEA".
Observe the following during browsing:
● In the address space of the NC, the displayed variables always represent only the first
parameter of the corresponding first OPI unit.
Example:
The R parameters can be found under "Sinumerik > Channel > Parameter > R". The
corresponding identifier is called "/Channel/Parameter/R", which is finally mapped to "/
Channel/Parameter/R[u1, 1]". If you want to access other parameters, then you must
correspondingly extend the identifier; you cannot directly accept the identifiers obtained
when browsing, e.g. "/Channel/Parameter/R[u2, 56]".
● In the address space of the NC, the displayed variables represent the access format that
has to be extended accordingly.
Example:
The variable "/Plc/MB" is in the address space. This variable must be extended by the
appropriate byte number, e.g. "/Plc/MB6". Only then is a value supplied.
● The address space of the NC also contains variables that are not available in a
corresponding machine configuration. These variables return "BadAttributeIdInvalid" as
value.

4.2 Browsing
Figure 4-1 Excerpt from browsing the OPC UA data access interface

4.3 Variable paths
4.3 Variable paths
4.3.1 Variable paths for NC access operations

The variable paths for NC access are stored in the address space of the SINUMERIK Operate
OPC UA server. Pay attention to the correct upper-case and lower-case of the "nodeID". The
respective identifier of the "nodeID" provides information on the correct notation.
You can obtain additional information on this from the List Manuals for 840D sl and 828D sl
"NC variable and interface signals".
Figure 4-2 Identifier for R parameter
The displayed NC variables always represent only the first parameter of the corresponding
NC data area (channel, TO area, mode group).
Example
The R parameters are found under the identifier "/Channel/Parameter/R", which is eventually
mapped to "/Channel/Parameter/R[u1, 1]". If you want to access other parameters, then you
must correspondingly extend the identifier, e.g. "/Channel/Parameter/R[u2, 56]".
Table 4-2 Examples of variable paths (NC access operations)
Variable path Description

/Channel/Parameter/R[u1,10] R parameter 10 in channel 1
/Channel/Parameter/R[u1,1,5] R parameter array
/Channel/Parameter/R[u1,1,#5] R parameters 1 to 5 in channel 1
/Channel/GeometricAxis/name[u2,3] Name of the 3rd axis in channel 2
/Channel/GeometricAxis/actToolBasePos[u1,3] Position of the 3rd axis in channel 1

4.3 Variable paths
4.3.2 Variable paths for GUD access operations

The variable paths for NC access are stored in the address space of the SINUMERIK Operate
OPC UA server under the "/Sinumerik/GUD" node. Pay attention to the correct upper-case
and lower-case of the "nodeID". The respective identifier of the "nodeID" provides information
on the correct notation.
The displayed GUD variables always represent only the first parameter (for GUD arrays) of
the first NC channel (for channel-dependent GUD variables). If you want to access a different
parameter of a GUD array or a different channel, you must extend the identifier accordingly
for the NC access.
GUD arrays are 1-indexed for access, and access is always one-dimensional. This means,
the index must be calculated for multi-dimensional arrays.
Example 1: One-dimensional array, NC-global GUD array

"UGUD.DEF" file
DEF NCK INT ARRAY[2]

M17
Access is performed as follows:
ARRAY[0] → /NC/_N_NC_GD3_ACX/ARRAY[1]
ARRAY[1] → /NC/_N_NC_GD3_ACX/ARRAY[2]
Example 2: Two-dimensional array, channel-dependent GUD array

"UGUD.DEF" file
DEF CHAN INT ABC[3,3]

M17
Access is performed as follows:
ABC[0,0] → /NC/_N_CH_GD3_ACX/ABC[u1, 1]
ABC[0.1] → /NC/_N_CH_GD3_ACX/ABC[u1, 2]
4.3.3 Variable paths for PLC access operations

The variable paths for PLC access are stored in the address space of the SINUMERIK Operate
OPC UA server under the "/Sinumerik/PLC" node. Pay attention to the correct upper-case and
lower-case of the "nodeID". The respective identifier of the "nodeID" provides information on
the correct notation.

4.3 Variable paths
In the address space of the NC, the displayed variables represent the access format that has
to be extended accordingly.
Example
The variable "/Plc/MB" is in the address space. This variable must be extended by the
appropriate byte number, e.g. to "/Plc/MB6". Only then is a value supplied.
Access formats
The various access formats are shown in the following table. When the default data type (bold
format) is used, you must expand it by the prefix "/Plc". For all others, it must be expanded by
the prefix "/Random/Plc".
Note
The data type is converted during access with the OPC UA data access interface. Refer to the
following table for the data type conversions.
Table 4-3 PLC syntax
Area Address (IEC) Permissible data types OPC UA data type

Output image Qx.y BOOL Boolean
Output image QBx BYTE, CHAR, UInt32
STRING String
Output image QWx WORD, CHAR, UInt32
INT, Int32
Output image QDx DWORD, UInt32
DINT, Int32
REAL Double
Data block DBz.DBXx.y BOOL Boolean
Data block DBz.DBBx BYTE, CHAR, UInt32
STRING String
Data block DBz.DBWx WORD, CHAR, UInt32
INT Int32
Data block DBz.DBDx DWORD, UInt32
DINT, Int32
REAL Double
Input image Ix.y BOOL Boolean
Input image IBx BYTE, CHAR, UInt32
STRING String
Input image IWx WORD, CHAR, UInt32
INT Int32
Input image IDx DWORD, UInt32
DINT, Int32
REAL Double
Bit memory Mx.y BOOL Boolean
Bit memory MBx BYTE, CHAR, UInt32
STRING String

4.3 Variable paths
Area Address (IEC) Permissible data types OPC UA data type

Bit memory MWx WORD, CHAR, UInt32
INT Int32
Bit memory MDx DWORD, UInt32
DINT, Int32
REAL Double
Counters Cx - Byte
timers Tx - UInt32
Notes regarding the table:

● In the table, "x" stands for the byte offset in the area; "y" for the bit number in the byte; and
"z" for the data block.
● The bold data type is the default data type in each case and does not have to be specified
when addressing. In addition, the specifications DB2.DBB5.BYTE and DB2.DBB5 are
equivalent, for example.
● Square brackets are used to access arrays, e.g. "/Plc/DB5.DBW2:[10]" (word array of length
10).
Examples of variable paths (PLC access operations)
Table 4-4 Examples of variable paths (PLC access operations)

/Plc/M5.0 Memory bit 0 at byte offset 5
/Plc/DB5.DBW2 Word (16-bit) at byte offset 2 in data block 5
/Random/Plc/ UTF8 string beginning at byte offset 2 in data block 8
DB8.DBB2:STRING
/Plc/DB8.DBW2:[10] Array of 10 words beginning at byte offset 2 in data block 8
/Plc/DB100.DBB1 Byte at byte offset 1 in data block 100
/Random/Plc/ Array of 10 double words (32-bit) beginning at byte offset 0 in data block
DB2.DBD0:REAL[10] 2, which are formatted as a floating-point number

4.3 Variable paths
Note the following:
Note
● Timers can only be read. A timer is active if it contains a value other than 0.
● If the data type CHAR or STRING is used in conjunction with a byte access, UTF8
characters are read, but if either data type is used in conjunction with a word access, UTF16
characters are read.
● Variables of the STRING type contain the maximum length in the first byte and the actual
length in the second byte. When strings are written, the actual length is adapted accordingly.
The maximum length is not changed.
● For the STRING data type in conjunction with a byte access (e.g. "/Plc/
DB99.DBB0:STRING"), the maximum string length is 255 characters. As a result of the
UTF8 formatting, for some characters (e.g. for the "µ"), two bytes are required, so that the
maximum string length is correspondingly reduced.
● Only one-dimensional arrays are supported. With STRING arrays, all elements have the
same maximum length.
4.3.4 Variable paths for machine and setting data

The variable paths for machine and setting data are stored in the address space of the
SINUMERIK Operate OPC UA server under the nodes "/Sinumerik/TEA" und "/Sinumerik/
SEA". Pay attention to the correct upper-case and lower-case of the "nodeID". The respective
identifier of the "nodeID" provides information on the correct notation.
The displayed machine and setting variables always represent only the first parameter of the
corresponding data area (channel, axis).
Table 4-5 Examples of variable paths (machine and setting data)

/NC/_N_CH_TEA_ACX/$MC_CHAN_NAME Channel name of channel 1
/NC/_N_CH_TEA_ACX/$MC_CHAN_NAME[u2] Channel name of channel 2
Machine data arrays are 1-indexed for access.
4.3.5 Variable paths for 1:N configuration (only target system PCU)
By default, data is accessed on the NCU which is being viewed by SINUMERIK Operate.
Switching to a different NCU in the SINUMERIK Operate results in a situation where the
SINUMERIK OPC UA server is also looking at the value of the now active NCU.
If the access is to be to a specific NCU, the NodeId must be expanded with a prefix:
/Random@<NCUName><NodeId>

4.3 Variable paths
Examples of variable paths (1:N constellation)
Table 4-6 Examples of variable paths (1:N constellation)

/Random@NCU_1/Channel/Parameter/R[u1,10] R parameter 10 in channel 1
/Random@NCU_2/Channel/Parameter/R[u1,10] of NCU_1
R parameter 10 in channel 1
of NCU_2
/Random@NCU_1/Plc/DB123.DBB0 Byte at byte offset 0 in data
block 123 of NCU_1
Note
The NCU names are listed in the "MMC.ini" file.
Entry:
[GLOBAL]
NcddeMachineNames=NCU1,NCU2
Figure 4-3 NCU names with 1:N

4.4 Supported services
4.4 Supported services

The following services of the OPC UA data access specification are supported:
● ActivateSessionService
● AddNodesService
● AddReferencesService
● BrowseNextService
● BrowseService
● CallService
● CloseSessionService
● CreateMonitoredItemsService
● CreateSessionService
● CreateSubscriptionService
● DeleteMonitoredItemsService
● DeleteNodesService
● DeleteReferencesService
● DeleteSubscriptionService
● FindServersService
● GetEndpointsService
● ModifyMonitoredItemsService
● PublishService
● ReadService
● RegisterNodesService
● RepublishService
● SetMonitoringModeService
● SetPublishingModeService
● TransferSubscriptionsService
● TranslateBrowsePathsToNodeIdsService
● UnregisterNodesService
● WriteService

4.5 Special features with regard to the OPC UA specification
TranslateBrowsePathsToNodeIdsService
If a non-existing NodeId is specified in TranslateBrowsePathsToNodeIds, then "BadNoMatch"
is returned instead of "BadNodeIdUnknown".
Maximum number of parallel sessions

Five parallel sessions are supported.
ArrayDimensions
The attribute "ArrayDimensions" is not supported and always gives "BadAttributeIdInvalid".
Return values
At places where a "BadNodeIdInvalid" is expected, a "BadAttributeIdInvalid" can also be given.
MaxNotificationsPerPublish
The property "MaxNotificationsPerPublish" is not evaluated.
IndexRange
Reading with "IndexRange" is not supported.
ServerDiagnostics
DiagnosticInfos are not supported.


Index
Variables
monitoring, 21
A read, 21
write, 21
AddUser, 22
Architecture, 5
B
Binary protocol, 5
Browsing, 26
C
ChangeMyPassword, 23
Characteristics, 5
Checking the time, 11
Configuration dialog, 9
D
Data types, 30
DeleteUser, 22
DeleteUserAccess, 25
G
GiveUserAccess, 24
L
License, 8
Logs, 5
O
OPC UA data access interface
Functional scope, 21
OPC UA Local Discovery Server, 13
V
Variable monitoring
Maximum number, 21
Variable paths, 28

Index

Introduction 1
Getting Started 2
Fundamentals 3
SINUMERIK
Dialogs 4
SINUMERIK 840D sl/828D
SINUMERIK Integrate Run 5
Variables
MyScreens (BE2)
Programming commands 6
Programming Manual
Graphic and logic elements 7
"Custom" operating area 8
Dialog selection 9
Reference lists A
Tips and tricks B
Animated elements C
Valid for:
CNC software V4.7 SP2
10/2015
6FC5397-1DP40-5BA3
Legal information
DANGER
WARNING
CAUTION
NOTICE
damage.
Qualified Personnel
Note the following:
WARNING
Trademarks

Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents
1 Introduction...................................................................................................................................................9
2 Getting Started...........................................................................................................................................13
2.1 Introduction............................................................................................................................13
2.2 Example.................................................................................................................................13
2.2.1 Task description.....................................................................................................................13
2.2.2 Creating the configuration file................................................................................................17
2.2.3 Saving the configuration file in the OEM directory.................................................................20
2.2.4 Creating the online help.........................................................................................................21
2.2.5 Saving the online help in the OEM directory..........................................................................23
2.2.6 Copying easyscreen.ini into the OEM directory.....................................................................23
2.2.7 Registering the COM file in easyscreen.ini............................................................................24
2.2.8 Testing the project..................................................................................................................24
3 Fundamentals.............................................................................................................................................25
3.1 Structure of configuration file.................................................................................................25
3.2 Structure of the menu tree.....................................................................................................27
3.3 Definition and functions for start softkeys..............................................................................28
3.3.1 Defining the start softkey........................................................................................................28
3.3.2 Functions for start softkeys....................................................................................................29
3.4 Troubleshooting (log book)....................................................................................................31
3.5 Notes on the easyscreen.ini...................................................................................................32
3.6 Notes for personnel changing over to "Run MyScreens".......................................................34
3.7 Extended configuration syntax...............................................................................................36
3.8 SmartOperation and MultiTouch operation............................................................................37
4 Dialogs........................................................................................................................................................39
4.1 Structure and elements of a dialog........................................................................................39
4.1.1 Defining a dialog....................................................................................................................39
4.1.2 Defining dialog properties......................................................................................................41
4.1.3 Defining dialog elements........................................................................................................47
4.1.4 Defining dialogs with multiple columns..................................................................................48
4.1.5 Password dialogs...................................................................................................................50
4.1.6 Using display images/graphics...............................................................................................52
4.2 Defining softkey menus..........................................................................................................52
4.2.1 Changing softkey properties during runtime..........................................................................55
4.2.2 Language-dependent text......................................................................................................58
4.3 Configuring the online help....................................................................................................61
5 Variables.....................................................................................................................................................63
5.1 Defining variables...................................................................................................................63
SINUMERIK Integrate Run MyScreens (BE2)

Programming Manual, 10/2015, 6FC5397-1DP40-5BA3 3
Table of contents
5.2 Application examples.............................................................................................................64

5.3 Example 1: Assigning the variable type, texts, help display, colors, tooltips..........................65
5.4 Example 2: Assigning the Variable Type, Limits, Attributes, Short Text Position
properties...............................................................................................................................66
5.5 Example 3: Assigning the Variable Type, Default, System or User Variable, Input/Output
Field Position properties.........................................................................................................67
5.6 Example 4: Toggle field and list field......................................................................................67
5.7 Example 5: Image display......................................................................................................68
5.8 Example 6: Progress bar........................................................................................................68
5.9 Example 7: Password input mode (asterisk)..........................................................................71
5.10 Variable parameters...............................................................................................................71
5.11 Details on the variable type....................................................................................................77
5.12 Details on the toggle field.......................................................................................................80
5.13 Details on the default setting..................................................................................................81
5.14 Details on the position of the short text, position of the input/output field..............................82
5.15 Use of strings.........................................................................................................................83
5.16 CURPOS variable..................................................................................................................85
5.17 CURVER variable..................................................................................................................85
5.18 ENTRY variable.....................................................................................................................86
5.19 ERR variable..........................................................................................................................87
5.20 FILE_ERR variable.................................................................................................................87
5.21 FOC variable..........................................................................................................................89
5.22 Variable S_ALEVEL...............................................................................................................90
5.23 S_CHAN variable...................................................................................................................90
5.24 Variable S_CONTROL...........................................................................................................91
5.25 Variable S_LANG...................................................................................................................91
5.26 Variable S_NCCODEREADONLY.........................................................................................92
5.27 Variables S_RESX and S_RESY...........................................................................................92
6 Programming commands...........................................................................................................................95
6.1 Operators...............................................................................................................................95
6.1.1 Mathematical operators..........................................................................................................95
6.1.2 Bit operators...........................................................................................................................98
6.2 Methods.................................................................................................................................99
6.2.1 ACCESSLEVEL...................................................................................................................100
6.2.2 CHANGE..............................................................................................................................100
6.2.3 CHANNEL............................................................................................................................102
6.2.4 CONTROL............................................................................................................................102
6.2.5 FOCUS.................................................................................................................................103

4 Programming Manual, 10/2015, 6FC5397-1DP40-5BA3
Table of contents
6.2.6 LANGUAGE.........................................................................................................................104
6.2.7 LOAD...................................................................................................................................104
6.2.8 UNLOAD..............................................................................................................................105
6.2.9 OUTPUT..............................................................................................................................106
6.2.10 PRESS.................................................................................................................................107
6.2.11 PRESS(ENTER)..................................................................................................................108
6.2.12 PRESS(TOGGLE)................................................................................................................108
6.2.13 RESOLUTION......................................................................................................................109
6.2.14 RESUME..............................................................................................................................109
6.2.15 SUSPEND............................................................................................................................110
6.2.16 Example: Version management with OUTPUT methods.....................................................110
6.3 Functions..............................................................................................................................112
6.3.1 Reading and writing drive parameters: RDOP, WDOP, MRDOP........................................112
6.3.2 Subprogram call (CALL).......................................................................................................114
6.3.3 Define block (//B)..................................................................................................................115
6.3.4 Check Variable (CVAR).......................................................................................................116
6.3.5 CLEAR_BACKGROUND......................................................................................................117
6.3.6 Copy Program file function (CP)..........................................................................................118
6.3.7 Delete Program file function (DP)........................................................................................118
6.3.8 Exist Program file function (EP)...........................................................................................119
6.3.9 Move Program file function (MP)..........................................................................................120
6.3.10 Select Program file function (SP).........................................................................................121
6.3.11 File accesses: RDFILE, WRFILE, RDLINEFILE, WRLINEFILE...........................................122
6.3.12 Dialog line (DLGL)................................................................................................................124
6.3.13 DEBUG................................................................................................................................125
6.3.14 Exit dialog (EXIT).................................................................................................................126
6.3.15 Dynamic manipulation of the lists of toggle fields or list box fields.......................................127
6.3.16 Evaluate (EVAL)...................................................................................................................130
6.3.17 Exit Loading Softkey (EXITLS).............................................................................................131
6.3.18 Function (FCT).....................................................................................................................131
6.3.19 Generate code (GC).............................................................................................................133
6.3.20 Password functions..............................................................................................................136
6.3.21 Load Array (LA)....................................................................................................................137
6.3.22 Load Block (LB)....................................................................................................................138
6.3.23 Load Mask (LM)...................................................................................................................139
6.3.24 Load Softkey (LS)................................................................................................................140
6.3.25 Load Grid (LG).....................................................................................................................141
6.3.26 Multiple selection SWITCH..................................................................................................142
6.3.27 Multiple Read NC PLC (MRNP)...........................................................................................143
6.3.28 PI services............................................................................................................................145
6.3.29 Reading (RNP) and writing (WNP) system or user variables...............................................146
6.3.30 RESIZE_VAR_IO and RESIZE_VAR_TXT...........................................................................147
6.3.31 Register (REG).....................................................................................................................148
6.3.32 RETURN..............................................................................................................................149
6.3.33 Recompile............................................................................................................................150
6.3.34 Recompile without user comment........................................................................................151
6.3.35 Search Forward, Search Backward (SF, SB).......................................................................154
6.3.36 STRING functions................................................................................................................155
6.3.37 WHILE/UNTIL loops.............................................................................................................161
6.3.38 Cyclic execution of scripts: START_TIMER, STOP_TIMER................................................164

Table of contents
7 Graphic and logic elements......................................................................................................................167

7.1 Line, dividing line, rectangle, circle and ellipse....................................................................167
7.2 Defining an array..................................................................................................................169
7.2.1 Accessing the value of an array element.............................................................................170
7.2.2 Example Access to an array element...................................................................................172
7.2.3 Scanning the status of an array element..............................................................................174
7.3 Table description (grid)........................................................................................................174
7.3.1 Defining a table (grid)...........................................................................................................176
7.3.2 Defining columns..................................................................................................................176
7.3.3 Focus control in the table (cell)............................................................................................178
7.4 Custom widgets....................................................................................................................179
7.4.1 Defining custom widgets......................................................................................................179
7.4.2 Structure of the custom widget library..................................................................................179
7.4.3 Structure of the custom widget interface..............................................................................180
7.4.4 Interaction between custom widget and dialog box - Automatic data exchange..................182
7.4.5 Interaction between custom widget and dialog box - Manual data exchange......................183
7.4.5.1 Reading and writing properties............................................................................................183
7.4.5.2 Executing a method of the custom widget...........................................................................185
7.4.5.3 Response to a custom widget signal....................................................................................187
7.5 SIEsGraphCustomWidget....................................................................................................189
7.5.1 SIEsGraphCustomWidget....................................................................................................189
7.5.2 Notes regarding performance..............................................................................................192
7.5.3 Reading and writing properties ...........................................................................................192
7.5.4 Properties.............................................................................................................................193
7.5.5 Functions..............................................................................................................................204
7.5.6 Signals.................................................................................................................................219
8 "Custom" operating area..........................................................................................................................221
8.1 How to activate the "Custom" operating area .....................................................................221
8.2 How to configure the "Custom" softkey................................................................................221
8.3 How to configure the "Custom" operating area....................................................................222
8.4 Programming example for the "Custom" area......................................................................224
9 Dialog selection........................................................................................................................................229
9.1 Dialog selection using PLC softkeys....................................................................................229
9.2 Dialog selection using PLC hard keys..................................................................................230
9.3 Dialog selection via NC........................................................................................................233
A Reference lists..........................................................................................................................................235
A.1 Lists of start softkeys............................................................................................................235
A.1.1 List of start softkeys for turning............................................................................................235
A.1.2 List of start softkeys for milling.............................................................................................236
A.2 List of access levels.............................................................................................................238
A.3 List of colors.........................................................................................................................238
A.4 List of language codes used in file names...........................................................................239

Table of contents
A.5 List of accessible system variables......................................................................................240

A.6 Behavior when opening the dialog (attribute CB).................................................................240
B Tips and tricks..........................................................................................................................................243
B.1 General tips..........................................................................................................................243
B.2 Tips for debugging...............................................................................................................244
B.3 Tips for the CHANGE method..............................................................................................244
B.4 Tips for DO LOOP loops......................................................................................................245
C Animated elements...................................................................................................................................247
C.1 Introduction..........................................................................................................................247
C.2 Modeling...............................................................................................................................248
C.2.1 Requirements.......................................................................................................................248
C.2.2 Rules for modeling...............................................................................................................248
C.2.3 Importing graphics (models).................................................................................................251
C.2.4 Modeling templates..............................................................................................................253
C.3 XML commands...................................................................................................................254
C.3.1 Overview..............................................................................................................................254
C.3.2 Structure of the scene description file..................................................................................255
C.3.3 Mirroring and rotations.........................................................................................................258
C.3.4 View type..............................................................................................................................258
C.4 Conversion to hmi file...........................................................................................................259
C.5 Display in Create MyHMI /3GL.............................................................................................259
C.5.1 X3D Viewer..........................................................................................................................259
C.5.2 Class SlX3dViewerWidget...................................................................................................259
C.5.3 Public methods.....................................................................................................................260
C.5.4 Public slots...........................................................................................................................260
C.5.5 Libraries...............................................................................................................................261
C.5.6 Implementation example......................................................................................................261
C.5.7 Machine data........................................................................................................................261
C.5.8 Notes about use...................................................................................................................262
C.6 Display in Run MyScreens...................................................................................................262
Glossary...................................................................................................................................................265
Index.........................................................................................................................................................269

Table of contents

Introduction 1
Overview
"Run MyScreens" can be used to create user interfaces that display functional expansions
designed by the machine manufacturer or user, or to implement your own layout.
Cycle calls can also be generated with user interfaces that you have created. Dialogs can be
created directly on the control system.
"Run MyScreens" is implemented with an Interpreter and configuration files that describe the
user interfaces.
"Run MyScreens" is configured using ASCII files: These configuration files contain the
description of the user interface. The syntax that must be applied in creating these files is
described in the following chapters.
Basic configuration
The "Run MyScreens" function enables machine manufacturers to configure their own dialogs.
Even with the basic configuration, it is possible to configure five dialogs in the operator menu
tree or for customer-specific cycle dialogs.
Software option
To expand the number of dialogs, you require one of the following software options:
● SINUMERIK 828D/840D sl, SINUMERIK Integrate Run MyScreens
(6FC5800-0AP64-0YB0)
● SINUMERIK 840D sl, SINUMERIK Integrate Run MyScreens + Run MyHMI
(6FC5800-0AP65-0YB0)
● SINUMERIK 840D sl, SINUMERIK Integrate Run MyHMI / 3GL
(6FC5800-0AP60-0YB0)
● SINUMERIK 840D sl, SINUMERIK Integrate Run MyHMI / WinCC
(6FC5800-0AP61-0YB0)
The following conditions must be met:
● It is only possible to switch between dialogs within a single operating area.
● User variables may not have the same names as system or PLC variables (also see List
Manual System Variables /PGAsl/).
● The dialogs activated by the PLC form a separate operating area (similar to measuring
cycle screens).

Introduction
Tools
● UTF8-capable editor (e.g. the integrated editor of the user interface or Notepad)
● A graphics program is needed to create graphics/display images.
File names and coding
Note
When using HMI Operate in the NCU, note that all file names are written in lower case letters
(com, png, txt) on the CF card. This is required because of Linux.
File names are not case-sensitive on the PCU. However, it is recommended that you also use
lower case letters here, in case of a possible subsequent transfer to Linux.
Note
When saving configuration and language files, ensure that the coding is set to UTF-8 for the
editor you are using.
Storage paths
Note the following convention when storing the configuration files, language files, etc.
[System Siemens directory]

Linux: /card/siemens/sinumerik/hmi
Windows 7: C:\ProgramData\Siemens\MotionControl\siemens
[System oem directory]
Linux: /card/oem/sinumerik/hmi
Windows 7: C:\ProgramData\Siemens\MotionControl\oem
[System user directory]
Linux: /card/user/sinumerik/hmi
Windows 7: C:\ProgramData\Siemens\MotionControl\user
[System add_on directory]
Linux: /card/addon/sinumerik/hmi
Windows 7: C:\ProgramData\Siemens\MotionControl\addon
Storage locations
"Run MyScreens" configuration: [System oem directory]/proj
Configuration file: [System oem directory]/cfg
Language files: [System oem directory]/lng

Introduction
Image files: [System oem directory]/Ico/ico[Resolution]

Example:
[System oem directory]/Ico/ico640
Online Help: [System oem directory]/hlp/[Language]
Example:
[System oem directory]/hlp/eng
Application
You can implement the following functions:
Display dialogs containing the fol‐ ● Softkeys

lowing elements: ● Variables
● Texts and Help texts
● Graphics and Help displays
Open dialogs by: ● Pressing the (start) softkeys
● Selection from the PLC/NC
Restructure dialogs dynamically: ● Edit and delete softkeys
● Define and design variable fields
● Insert, exchange and delete display texts (language-
dependent or independent)
● Insert, exchange and delete graphics
Initiate operations in response to ● Displaying dialogs
the following actions:
● Input values (variables)
● Select a softkey
● Exiting dialogs
● Value change of a system or user variable
Data exchange between dialogs:
Variables: ● Read (NC, PLC and user variables)
● Write (NC, PLC and user variables)
● Combine with mathematical, comparison or logic operators
Execute functions: ● Subprograms
● File functions
● PI services
Apply protection levels according to
user classes

Introduction

Getting Started 2
2.1 Introduction
Using the following example, you get to know the steps necessary to insert your own dialogs
into the SINUMERIK Operate user interface using Run MySreens. You also learn how to create
your own dialogs, insert context-sensitive help screens and help calls, define softkeys and how
you can navigate between the dialogs.
2.2 Example
2.2.1 Task description

You will create the following dialogs in the example.
Dialog 1
R parameters that can be written to (0 and 1) and geometry axis names are displayed in the
first dialog (input fields). The corresponding help screens are linked in for the two R parameters.
A context-sensitive help is linked in for the geometry axes. Further, the dialog includes
examples for separating lines (horizontal and vertical), toggle fields, input/output fields with
integrated unit selection and progress bars (with and without color change).
Figure 2-1 R parameters with help displays

Getting Started
2.2 Example
Figure 2-2 Geometry axes with context sensitive help
Figure 2-3 Toggle fields: List and box

Getting Started
2.2 Example
Figure 2-4 I/O field with integrated unit selection
Dialog 2
MCS and WCS values are displayed in the second dialog. The dialog also contains examples
of progress bars with and without color change.
Figure 2-5 Progress bars with (right) and without (left) color change

Getting Started
2.2 Example
Navigation
The first dialog is called using the "START" softkey in the diagnostics operating area. The
horizontal SK7 softkey is used.
Figure 2-6 Start softkey „START“ in the machine operating area, AUTO mode
You can call the second dialog from the first dialog with the "Next Mask" softkey. You can
return to the root screen of the operating area by pressing the "EXIT" softkey (see the screen
above).
Using the "EXIT" softkey, you can also return to the root screen of the operating area from the
second dialog (see the screen above). You can return to the first dialog via the "Back to Mask"
softkey.
Procedure
The necessary steps are described in the following chapters:
1. Creating the configuration file (COM file)
2. Saving the configuration file in the OEM directory
3. Creating the online help
4. Saving the online help in the OEM directory
5. Copying easyscreen.ini into the OEM directory
6. Registering the COM file in easyscreen.ini
7. Testing the project

Getting Started
2.2 Example
2.2.2 Creating the configuration file
Content of the configuration file

Using a UTF8-capable editor, create the configuration file diag.com for the two dialogs.
; Start identifier of start softkey

//S(START)
; Start softkey only text
HS7=("START")
; Start softkey with language-dependent text and png
;HS7=([$80792,"\\sk_ok.png"])
; Press method
PRESS(HS7)
; LM or LS function
LM("MASK1")
; LM, specifying a com file
LM("MASK1","TEST.COM")
END_PRESS
; End identifier of start softkey
//END
; Definition of dialog 1 with header and screen

//M(MASK1/"Display R parameter and Channel MD"/"mz961_01.png")
; Definition of the variables
DEF VAR1 = (R2///,"R parameter 0"///"$R[0]"/200,50,150/400,50,100,)
; With help screen
DEF VAR2 = (R2///,"R parameter 1"//"mz961_02.png"/"$R[1]"/200,70,150/400,70,100)
; With online help
DEF ACHS_NAM1 = (S///"Press i for Help","Geometry axis[0]"////200,100,150/400,100,100//"sinumer-
ik_md_1.html","20060[0]")
; With online help
DEF ACHS_NAM2 = (S///"Press i for Help","Geometry axis[1]"////200,120,150/400,120,100//"sinumer-
ik_md_1.html","20060[1]")
DEF ACHS_NAM3 = (S///,"Geometry axis[2]"////200,140,150/400,140,100)
; Definition of toggle fields and unit toggle
DEF VAR_TGL = (S/* "Hello", "Run", "MyScreens"/"Run"/,"Toggle box"////10,230,100/120,230,100/,,6)
DEF VAR_TGB = (S/* "Hello", "Run", "MyScreens"/"Run"/,"List box"/

dt4///250,230,100/370,230,100,60/,,"#0602ee")
; BC, FC, BC_ST, FC_ST, BC_GT, FC_GT, BC_UT, FC_UT, SC1, SC2
DEF VarEdit = (R///,"Unit Toggle",,,"Feedrate"///"$R[11]"/5,300,100/120,300,100///"VarTgl"),
VarTgl = (S/*0="mm",1="inch"/0//WR2////220,300,40)

Getting Started
2.2 Example
; Softkey definition in the dialog

HS1=("")
HS2=("")
HS3=("")
HS4=("")
HS5=("")
HS6=("")
HS7=("")
HS8=("")
VS1=("")
VS2=("")
VS3=("")
VS4=("")
VS5=("")
VS6=("")
VS7=("Next Mask")
VS8=("EXIT")
; Definition LOAD block

LOAD
; Read value with RNP
ACHS_NAM1 = RNP("$MC_AXCONF_GEOAX_NAME_TAB[0]")
; Output of a dialog line
DLGL("Value R2: = " << RNP("$R[2]"))
; Write WNP to a value
WNP("$R[3]",VAR0)
; Vertical dividing line

V_SEPARATOR(360,1,6,1)
; Horizontal dividing line
H_SEPARATOR(220,1,7,1)
END_LOAD
; Press method
PRESS(VS7)
; Load an additional dialog
LM("MASK2")
; End identifier press method
END_PRESS
; Press method
PRESS(VS8)

Getting Started
2.2 Example
; Exit the dialog

EXIT
END_PRESS
; End identifier dialog 1
//END
; Definition of dialog 2 with header and screen

//M(MASK2/"Position WCS MCS"/"mz961_01.png")
DEF TEXT1 = (I///,"WCS"/WR0,fs2///230,30,120/,,1)
DEF VAR1 = (R3///,"1. Axis $AA_IW[AX1]"/WR1//"$AA_IW[AX1]"/230,70,150/400,70,100)
DEF VAR2 = (R3///,"2. Axis $AA_IW[AX2]"/WR1//"$AA_IW[AX2]"/230,90,150/400,90,100)
DEF TEXT2 = (I///,"MCS"/WR0,fs2///230,120,120/,,1)

DEF VAR3 = (R2///,"1. Axis $AA_IM[AX1]"/WR1//"$AA_IM[AX1]"/230,160,150/400,160,100)
DEF VAR4 = (R2///,"2. Axis $AA_IM[AX2]"/WR1//"$AA_IM[AX2]"/230,180,150/400,180,100)
DEF VAR5 = (R3///,"$P_UIFR G54 AX1"///"$P_UIFR[1,AX1,TR]"/230,200,150/400,200,100)
; Definition of the progress bar

DEF PROGGY0 = (R/0,150//,"Progress bar Operate style"/DT2,DO0//"$R[10]"/5,240,190/5,260,150/6,10)
DEF PROGGY4 = (R/0,150,50,100/120/,"Progress bar with color change"/DT1,DO0//"$R[10]"/
260,240,190/260,260,150/3,4,,,9,7)

DEF PROGVAL = (R/0,150//,"Value to change Progress bar 0 - 150"///"$R[10]"/5,300,230/260,300,100)
; Softkey definition in the dialog

HS1=("")
HS2=("")
HS3=("")
HS4=("")
HS5=("")
HS6=("")
HS7=("")
HS8=("")
VS1=("")
VS2=("")
VS3=("")
VS4=("")
VS5=("")
VS6=("")
VS7=("Back to Mask")
VS8=("EXIT")

Getting Started
2.2 Example
; Load method
LOAD
H_SEPARATOR(230,1,7,1)
END_LOAD
; Change method
CHANGE(VAR5)
; Function PI_START
PI_START("/NC,201,_N_SETUFR")
; End identifier change method
END_CHANGE
; Press method
PRESS(RECALL)
; Return to the calling mask
LM("MASK1")
END_PRESS
; Press method
PRESS(VS7)
; Return to the calling mask
LM("MASK1")
END_PRESS
; Press method
PRESS(VS8)
; Exit the dialog to the standard application
EXIT
END_PRESS
; Dialog end identifier
//END
2.2.3 Saving the configuration file in the OEM directory
Storage path
Save the configuration file diag.com under the following path:
[System oem directory]/proj

Getting Started
2.2 Example
2.2.4 Creating the online help
Content of the online help

Create the HTML file sinumerik_md_1.html. The section below shows the context-sensitive
help call via name="20060[0]" and name="20060[1]". The help file is not commented, as this
manual does not discuss creating online help. Notes regarding the integration of online help
are provided in Section Configuring the online help (Page 61).

Getting Started
2.2 Example
<html><head><meta http-equiv="Content-Type" content="text/html; charset="UTF-8"/><title></

title></head>
<body>
<table border="1" cellspacing="0" cellpadding="2" width="100%">
<tr>
<td><a name="20060[0]"><b>20060[0]</b></a></td>
<td colspan="3">AXCONF_GEOAX_NAME_TAB</td>
<center>
<img src="../picture/bitmap3.png">
</center>
<td>-</td>
<td>-</td>
</tr>
<tr>
<td>-</td>
<td colspan="3">Geometry axis name in channel</td>
<td>DWORD</td>
<td>POWER ON</td>
</tr>
<tr>
<td colspan="6">This MD is used to enter the names of the geometry axes
separately for each channel.<br />
<tr>
<td>-</td>
<td colspan="5"> </td>
</tr>
<tr>
<td width="16*">System</td><td width="16*">Dimension</td><td width="16*">Default
value</td>
<td width="16*">Minimum value</td><td width="16*">Maximum value</td>
<td width="16*">Protection</td>
</tr>
<tr>
<td>-</td>
<td>-</td>
<td>60</td>
<td>0</td>
<td>180</td>
<td>7/3</td>
</tr>
</table>
<p></p>
<table border="1" cellspacing="0" cellpadding="2" width="100%">
<tr>
<td><a name="20060[1]"><b>20060[1]</b></a></td>
<td colspan="3">AXCONF_GEOAX_NAME_TAB</td>
<td>-</td>
<td>-</td>
</tr>
<tr>
<td>-</td>
<td colspan="3">Geometry axis name in channel</td><td>BYTE</td>
<td>POWER ON</td>
</tr>
<tr>

Getting Started
2.2 Example
<td colspan="6">This MD is used to enter the names of the geometry axes

separately for each channel.<br />
<tr>
<td>-</td>
<td colspan="5"> </td>
</tr>
<tr>
<td width="16*">System</td>
<td width="16*">Dimension</td>
<td width="16*">Default value</td>
<td width="16*">Minimum value</td>
<td width="16*">Maximum value</td>
<td width="16*">Protection</td>
</tr>
<tr>
<td>-</td>
<td>-</td>
<td>0</td>
<td>0</td>
<td>2</td>
<td>7/3</td>
</tr>
</table>
<p></p>
</body>
</html>
2.2.5 Saving the online help in the OEM directory
Storage path
Save the HTML file sinumerik_md_1.html for the English help under the following path:
You must create a folder for additional languages (e.g. chs, deu, esp, fra, ita …).
A list of language codes is provided in the Appendix.
2.2.6 Copying easyscreen.ini into the OEM directory
Storage path
Copy the file easyscreen.ini from the directory
[System SIEMENS directory]/cfg
to the directory
[System oem directory]/cfg

Getting Started
2.2 Example
2.2.7 Registering the COM file in easyscreen.ini
Adaptation in easyscreen.ini
Make the following change in the easyscreen.ini in the OEM directory. You have thus registered
the diag.com configuration file.
;########################
;# AREA Diagnosis #
;########################
;<===============================================================>
;< OEM Softkey on first horizontal Main Menu >
;< SOFTKEY position="7" >
;<===============================================================>
StartFile28 = area := AreaDiagnosis, dialog:= SlDgDialog, menu := DgGlobalHu, startfile := diag.com
2.2.8 Testing the project
Testing the dialog call

Switch to the diagnostics operating area. Click the "START" horizontal softkey.
If "Run MyScreens" detects errors when interpreting the configuration files, these errors are
stored in the easyscreen_log.txt text file (see Chapter Troubleshooting (log book) (Page 31)).
Testing context sensitive help screens and online help

Test the context sensitive help screens and the online help. If errors occur, then check the
paths where files have been saved.

Fundamentals 3
3.1 Structure of configuration file
Introduction
The description of new user interfaces is stored in configuration files. These files are
automatically interpreted and the result displayed on the screen. Configuration files are not
stored in the software supplied and must be set up by the user.
A UTF-8-capable editor (e.g. the integrated editor of the user interface or Notepad) is used to
create the configuration files and language files. The description can also be explained using
comments. A ";" is inserted as comment character before every explanation.
Note
When saving configuration and language files, ensure that the coding is set to UTF-8 for the
editor you are using.
However, keywords - also in an UTF-8-coded COM file - may only comprise characters that
are contained in the ASCII character set. Otherwise the interpretation and therefore the display
of the screen forms/dialogs cannot be guaranteed.
Configuration
Each HMI operating area has permanent start softkeys which can be used to access newly
generated dialogs.
In the event of a "Load a screen form" (LM) or a "Load softkey menu" (LS) call in a configuration
file, a new file name containing the object called can be specified. This makes it possible to
structure the configuration, e.g. all functions in one operating level in a separate configuration
file.
Structure of the configuration file

A configuration file consists of the following elements:
1. Description of the start softkeys
2. Definition of the dialogs
3. Definition of the variables
4. Description of the methods
5. Definition of the softkey menus

Fundamentals
3.1 Structure of configuration file
Note
Sequence
The specified sequence in the configuration file must be maintained.
Example:
//S (START) ; Definition of the start softkey (optional)

....
//END
//M (.....) ; Definition of the dialog
DEF ..... ; Definition of the variables
LOAD ; Description of the blocks
...
END_LOAD
UNLOAD
...
END_UNLOAD
...
//END
//S (...) ; Definition of a softkey menu
//END
Storage location for configuration files

The configuration files are located in the [System user directory]/proj directory and also
correspondingly stored in the [System add_on directory] and [System oem directory]
directories.
Converting texts from other HMI applications

Procedure to convert a text file with code page coding to text-coding UTF-8:
1. Open the text file on a PG/PC in a text editor.
2. When saving, set the UTF-8 coding.
The read-in mechanism via code page code is still supported.

Fundamentals
3.2 Structure of the menu tree
3.2 Structure of the menu tree
Menu tree principle

Several interlinked dialogs create a menu tree. A link exists if you can switch from one dialog
to another. You can use the newly defined horizontal/vertical softkeys in this dialog to call the
preceding or any other dialog.
A menu tree can be created behind each start softkey:
6WDUWVRIWNH\
Figure 3-1 Menu tree
Start softkeys
One or more softkeys (start softkeys), which are used to initiate your own operating sequences,
are defined in the configuration files specified in easyscreen.ini.
The loading of a dedicated dialog is associated with a softkey definition or another softkey
menu. These are then used to perform the subsequent actions.
Pressing the start softkey loads the assigned dialog. This will also activate the softkeys
associated with the dialog. Variables will be output to the standard positions unless specific
positions have been configured.
Reverting to the standard application

You can exit the newly created dialog and return to the standard operating area.

Fundamentals
3.3 Definition and functions for start softkeys
You can use the <RECALL> key to close new user interfaces if you have not configured this
key for any other task.
Note
Calling dialogs in the PLC user program
Dialogs can be selected from the PLC as well as via softkeys: An interface signal is available
in DB19.DBB10 for signal exchange between the PLC → HMI.
3.3.1 Defining the start softkey
Dialog-independent softkey
Start softkeys are dialog-independent softkeys which are not called from a dialog, but which
have been configured before the first new dialog. In order to access the start dialog or a start
softkey menu, the start softkey must be defined.
Programming
The definition block for a start softkey is structured as follows:
//S(Start) ; Start identifier of start softkey

HS1=(...) ; Define the start softkey: Horizontal SK 1
PRESS(HS1) ; Method
LM... ; LM or LS function
END_PRESS ; End of method
//END ; End identifier of start softkey
Permissible positions for start softkeys

The following positions for "Run MyScreens" start softkeys are permissible in the operating
areas:
Operating area Position

Machine HSK6
Parameter HSK7
Program HSK6 and HSK15
Measuring cycles: HSK13 and HSK14
Program manager HSK2-8 and HSK12-16, if not assigned to drives.

Fundamentals
Operating area Position

Diagnostics HSK7
Startup HSK7
Start softkeys are configured in special files. The names of these files are stated in the
easyscreen.ini file. They usually have a name which is specific to an operating area (e.g.
startup.com for the startup area). The machine operating area represents an exception. There
are several mode-specific files in the machine operating area (ma_jog.com, ma_auto.com).
The softkey menu with the start softkeys is called "Start". Existing configurations for start
softkeys can still be used. The function whereby start softkeys are merged with the softkeys
for the respective HMI application (operating area) in the start softkey menu is not supported.
This means that until the first dialog call is made - in other words, the time at which full
functionality becomes available (e.g. execution of PRESS blocks) - menus or softkey menus
can only be replaced by others in their entirety.
Template for configuration of the start softkey

A detailed description of all permissible positions for start softkeys and their configuration is
located in the easyscreen.ini file in the following directory:
[System SIEMENS directory]/cfg
This file is used as a template for your own configuration of the start softkey.
See also
Lists of start softkeys (Page 235)
3.3.2 Functions for start softkeys
Functions for dialog-independent softkeys

Only certain functions can be initiated with start softkeys.
The following functions are permitted:
● The LM function can be used to load another dialog: LM("Identifier"[,"File"])
● The LS function can be used to display another softkey menu: LS("Identifier"[, "File"][,
Merge])
● You can use the "EXIT" function to exit newly configured user interfaces and return to the
standard application.
● You can use the "EXITLS" function to exit the current user interface and load a defined
softkey menu.

Fundamentals
PRESS method
The softkey is defined within the definition block and the "LM" or "LS" function is assigned in
the PRESS method.
If the start softkey definition is designated as a comment (semicolon (;) at beginning of line)
or the configuration file removed, the start softkey will not function.
//S(Start) ; Start identifier

HS6=("1st screen form") ; Horizontal SK 6 labeled "1st screen form"
PRESS(HS6) ; PRESS method for horizontal SK 6
LM("Screen form1") ; Load screen form1 function, where screen form 1
must be defined within the same file.
END_PRESS ; End of PRESS method
HS7=("2nd screen form") ; Horizontal SK 7 labeled "2nd screen form"
PRESS(HS7) ; PRESS method for horizontal SK 7
LM("Screen form2") ; Load screen form2 function, where screen form2
must be defined within the same file.
END_PRESS ; End of PRESS method
//END ; End identifier of entry block
Example
HS1 = ("new softkey menu")

HS2=("no function")
PRESS(HS1)
LS("Menu1") ;Load new softkey bar
END_PRESS
PRESS (HS2) ; Empty PRESS method
END_PRESS
Various configurations of the start softkeys

Various configurations of the start softkeys are merged. In this case, initially the name of the
file to be interpreted is read-out of easyscreen.ini. A search is made for files with the .com
extension in the following directories:
● [System user directory]/proj
● [System oem directory]/proj
● [System add_on directory]/proj
● [System Siemens directory]/proj
The configurations included for the start softkeys are now merged to form a configuration, i.e.
the individual softkeys are compared. If there are two or more configurations for a softkey, the
higher order configuration is always transferred into the merge version.

Fundamentals
3.4 Troubleshooting (log book)
Softkey menus or dialogs that are possibly included are ignored. If a softkey has a command
without file information, e.g. LM ("test"), as the required softkey menu or dialog is contained in
the same file, then the corresponding file name is supplemented in the internal merge version
so that in this case, no changes are required. The merge configuration contained is then
subsequently displayed.
3.4 Troubleshooting (log book)
Overview
If "Run MyScreens" detects errors when interpreting the configuration files, these errors will
be written to the easyscreen_log.txt text file. Only errors of the currently selected dialog are
entered. Error entries from previously selected dialogs are deleted.
The file indicates:
● The action during which an error occurred
● The line and column number of the first faulty character
● The entire faulty line of the configuration file
● The entries made by the DEBUG function
Note
Each entry has a prefix with the current time stamp in square brackets. This can be helpful,
for example, when analyzing time-critical configurations.
Saving easyscreen-log.txt
The file easyscreen_log.txt is saved in the following directory:
[System user directory]/log
Syntax
The system does not start to interpret the syntax until the start softkey has been defined and
a dialog with start and end identifiers as well as a definition line has been configured.
//S(Start)
HS6=("1st screen")
PRESS(HS6)
LM("Maske1")
END_PRESS
//END
//M(Maske1)

Fundamentals
3.5 Notes on the easyscreen.ini
DEF Var1=(R)
DEF VAR2 = (R)
LOAD
VAR1 = VAR2 + 1 ; Error message in log book, as VAR2 has no value
...
//END
; The right entry would be,

for example:
//M(Maske1)
DEF Var1=(R)
DEF VAR2 = (R)
LOAD
VAR2 = 7
VAR1 = VAR2 + 1 ;
...

As of SINUMERIK Operate V4.7, the easyscreen.ini has been extended by the entries
described in this section. The easyscreen.ini can be found in the [System Siemens directory]/
cfg directory.
Help screen start position

Entry in easyscreen.ini:
[GENERAL]
HlpPicFixPos=true
Note:
The start position of help displays is positioned at the configured pixel position independent of
the resolution (default=true).
Elongation behavior, default line height and line spacing

[GENERAL]
SymmetricalAspectRatio=false
DefaultLineHeight=18

Fundamentals
DefaultLineSpacing=3
Notes:
● The "SymmetricalAspectRatio" entry determines whether the same aspect ratio is used in
the X and Y direction when adapting a configuration to a specific screen resolution.
– "false" (default): Fields and graphics are shortened in widescreen resolution in the Y
direction (asymmetrical elongation in relation to 640x480). For example, a square
configured in 640x480 is shortened vertically for a widescreen panel and becomes a
rectangle.
– "true": The same aspect ratio is used in the X and Y direction and fields and graphics
retain their originally configured proportions in relation to 640x480. For example, a
square configured in 640x480 remains a square in a widescreen panel.
● The entries "DefaultLineHeight" and "DefaultLineSpacing" can be used to specify the
default line height (default: 18 pixels) and the default line spacing (default: 3 pixels) in
relation to 640x480. They only take effect when no Y position or height is specified in the
configuration for the position of the short text or the input/output field.
Resolution-dependent screen position: Form panels

[640x480]
MyPanel = x:=0, y:=220, width:=340, height:=174
[800x480]
MyPanel = x:=0, y:=220, width:=420, height:=174
...
Notes:

Fundamentals
3.6 Notes for personnel changing over to "Run MyScreens"
The screen position can be defined as follows:

● The screen position can be specified in "Pixels in relation to 640x480".
Example:
//M(MyMask/"MyCaption"/"\\myhelp.png"/0,219,335,174)
● The screen position can be coupled to the resolution-dependent position of a form panel
from an Operate standard screen layout, e.g. "Form panel4" ("auxiliary functions") from the
screen layout "slmastandardscreenlayout.SlMaStandardScreenLayout" of the "Machine"
area
//M(MyMask/"MyCaption"/"\
\myhelp.png"/"slmastandardscreenlayout.SlMaStandardScreenLayout.FormPanel4")
It is therefore easy to superimpose standard forms from Operate or position Easyscreen

screens precisely at their position.
Example:
//M(Mask/"Mask"//"slstandardscreenlayout.SlStandardScreenLayout.LowerForm")
Any other screen layout can also be used.
● The screen position can be coupled to a self-defined, resolution-dependent definition of
form panels in the easyscreen.ini file.
Example:
//M(MyMask/"MyCaption"/"\\myhelp.png"/"MyPanel")
Note
When using HMI Operate in the NCU, note that all file names are saved in lower case letters
on the CF card (com, png, txt).
Note
Make sure that the coding is set to UTF-8 in the editor that you are using when saving the
configuration and language files.
Image files
Image files must be saved in the PNG format (xxx.png).
The data must be saved, e.g. for OEM modifications, under
[System oem directory]/ico/[Resolution]
For further information, see also Chapter Using display images/graphics (Page 52).

Fundamentals
Adapting the configuration file

Check your configuration files regarding the following points:
● Compare the start softkeys with the currently permissible softkeys (see list of start softkeys
in the appendix), and if required, appropriately adapt.
● Rename the integrated image files corresponding to the "Image files" point above.
The data is stored, e.g. for OEM modifications, in the following directory:
[System oem directory]/proj
[System user directory]/proj
[System add_on directory]/proj
Adapting the help files

All help files must be saved in UTF-8. Check your existing files, and resave them accordingly
with a suitable editor.
The HTML files are saved in the following directory, e.g. for English:
[System user directory]/hlp/eng
[System add_on directory]/hlp/eng
You must create the directories for additional languages corresponding to the language codes
(see appendix).
Checking the "Run MyScreens" license

Check whether the number of dialogs that you have entered exceeds the basic scope of a
maximum of five dialogs.
To expand the number of dialogs, you require one of the following software options:
● SINUMERIK 828D/840D sl, SINUMERIK Integrate Run MyScreens
(6FC5800-0AP64-0YB0)
● SINUMERIK 840D sl, SINUMERIK Integrate Run MyScreens + Run MyHMI
(6FC5800-0AP65-0YB0)
● SINUMERIK 840D sl, SINUMERIK Integrate Run MyHMI / 3GL
(6FC5800-0AP60-0YB0)
● SINUMERIK 840D sl, SINUMERIK Integrate Run MyHMI / WinCC
(6FC5800-0AP61-0YB0)

Fundamentals
3.7 Extended configuration syntax
3.7 Extended configuration syntax

As of SINUMERIK Operate V4.7, a simplified syntax is available for the definition of screens,
variables, softkeys and for table columns. Reading and servicing are improved with this
alternative syntax. The properties and attributes can be specified in any order, empty entries
are omitted. Instead of with round brackets "(" and ")" as in the previous syntax, the listing of
the properties and attributes is now enclosed in curly brackets "{" and "}".
The properties and attributes are specified as follows:
{<Name> = <Value>, <Name> = <Value>, …}
The previous syntax remains compatible.
Extended syntax for the definition of screens

//M {<Mask name> [,HD=<Title>] [,HLP=<Graphic>] [,X=<X position>] [,Y=<Y position>]
[,W=<Width>] [,H=<Height>] [,VAR=<> System or user variable] [,HLP_X=<X position help
screen] [,HLP_Y=<Y position help screen>] [,CM=<Column alignment>] [,CB= Response
when opening the dialog] [,XG=<Interpret help screen as X3d graphic>] [,PANEL=<Name of
the linked FormPanels>][,MC=<Mask background color:>][,HD_AL=<Alignment of the mask
header>] [,LANGFILELIST=<List of the mask-specific language files>]}
Example:
//M{VariantTest, HD="My Mask"}
Extended syntax for the definition of variables

DEF <Variable name> = {[TYP=<Typ>] [,MIN=<Minimum value>] [,MAX=<Maximum value>]
[,TGL=<Toggle values>] [,VAL=<Preassignment>] [,LT=<Long text>] [,ST=<Short text>]
[,GT=<Graphic text>] [,UT=<Unit text>] [,TT=<ToolTip text>] [,TG=<Toggle option>]
[,WR=<Input mode>] [,AC=<Access level>] [,AL=<Text alignment>] [,FS=<Font size>]
[,LI=<Limit value handling>] [,UR=<Refresh rate>] [,CB=<Text align when opening the dialog>]
[,HLP=<Help screen>] [,VAR=<System or user variable>] >] [,TXT_X=<X position short text>]
[,TXT_Y=<Y position short text>] [,TXT_W=<Width short text>] [,TXT_H=<Height short text>]
[,X=<X position input/output field>] [,Y=<Y position input/output field>] [,W=<Width input output
field>] [,H=<Height input/output field>] [,UT_DX=<Distance between input field and unit field>]
[,UT_W=<Width unit field>] [,BC=<Background color input/output field>] [,FC=<Foreground
color input/output field>] [,BC_ST=<Background color short text>] [,FC_ST=<Foreground color
short text>] [,BC_GT=<Background color graphic text>] [,FC_GT=<Foreground color graphic
text>] [,BC_UT=<Background color unit text>] [,FC_UT=<Foreground color unit text>]
[,SC1=<Signal color 1 for progress bar>] [,SC2=<Signal color 2 for progress bar>]
[,SVAL1=<Threshold value 1 for progress bar>] [,SVAL2=<Threshold value 2 for progress
bar>] [,DT=<Display type>] [,DO=<Display alignment>] [,OHLP=<Online help>]
[,LINK_TGL=<Name of the linked toggle v]}
Examples:
DEF MyVar5={TYP="R2", ST="MyVar5", VAL=123.4567, OHLP="myhelp.html", MIN=100.1,

MAX=200.9}
DEF MyVar2={TYP="I", TGL="*1,2,3", VAL=1}
DEF MyVar3={TYP="R2", TGL="*0=""Off"", 1=$80000", VAL=1}

Fundamentals
3.8 SmartOperation and MultiTouch operation
DEF MyVar4={TYP="R2", TGL="*MyArray",VAL=1}

DEF MyVar1={TYP="R2", TGL="%grid99", X = 0, W=300, H=200}
DEF MyVar6={TYP="R2", TGL="+$80000", VAR="$R[10]", ST="Text offset"}
Extended syntax for the definition of softkeys

SK = {[ST=<Label>] [,AC=<Access level>] [,SE=<Status>]}
Examples:
HS1={ST="""MySk""", AC=6, SE=1}

HS3={ST="SOFTKEY_CANCEL"}
HS5={ST="[$81251,""\\sk_ok.png""]"}
HS8={ST="[""Test"",""\\sk_ok.png""]"}
Extended syntax for the definition of table columns

{[TYP=<Type>] [,MIN=<Minimum value>] [,MAX=<Maximum value>] [,LT=<Long text>]
[,ST=<Short text>] [,WR=<Input mode>] [,AC=<Access level>] [,AL=<Text alignment>]
[,FS=<Font size>] [,LI=<Limit value handling>] [,UR=<Refresh rate>] [,HLP=<Help screen>]
[,VAR=<System or user variable>] >] [,W=<Column width>] [,OF1=<Offset1>]
[,OF2=<Offset2>] [,OF3=<Offset3>]}
Example:
DEF MyGridVar={TYP="R", TGL="%MyGrid1", X=10, W=550, H=100}

//G(MyGrid1/0/5)
{TYP="I", ST="Index", WR=1, VAR="1", W=80, OF1=1}
{TYP="S", LT="LongText2", ST="Text", WR=1, VAR="$80000", AL=2, W=330, OF1=1}
{TYP="R3", LT="LongText1", ST="R9,R11,R13,R15", WR=2, VAR="$R[1]", W=110, OF1=2}
//END

You have the following setting options for specific adjustment to SmartOperation and for
MultiTouch operation:
● Automatic adjustment of the field height and field width to the so-called minimum usable
field size and the line spacing (mask attribute MA).
● Optimized and pixel-precise stretching of the fields for higher resolutions (mask attribute
PA).
● Setting of the field height and line spacing proportional to the font (mask attribute FA).
● Allows free scrolling so that the input field is not covered by the virtual keyboard (mask
attribute KM).

Fundamentals
Further details can be found in Chapter Defining dialog properties (Page 41), Section
"Programming".

Dialogs 4
4.1 Structure and elements of a dialog
4.1.1 Defining a dialog
Definition
A dialog is part of a user interface consisting of a display line, dialog elements and/or graphics,
an output line for messages and 8 horizontal and 8 vertical softkeys.
Dialog elements are:
● Variables
– Limits/toggle field
– Default setting of variables
● Help display
● Texts
● Attributes
● System or user variable
● Position of short text
● Position of input/output field
● Colors
Dialog properties:
● Header
● Graphic
● Dimension
● System or user variable

Dialogs
● Graphic position
● Attributes

① Machine status display ("header")

② Dialog element
③ 8 vertical softkeys
④ 8 horizontal softkeys
⑤ Output of diagnostic messages
⑥ Graphic
⑦ Dialog
⑧ Header line of the dialog with header and long text
Figure 4-1 Structure of the dialog
Overview
The definition of a dialog (definition block) is basically structured as follows:
Definition block Comment Chapter reference

//M... ;Dialog start identifier
DEF Var1=... ;Variables See chapter "Variables"
...
HS1=(...) ;Softkeys See chapter "Softkey menus"
...
PRESS(HS1) ;Method start identifier
LM... ;Actions See chapter "Methods"
END_PRESS ;Method end identifier
//END ;Dialog end identifier

Dialogs
Within the dialog definition block, various variables that appear as dialog elements in the dialog,
as well as horizontal and vertical softkeys, are defined first. Different types of actions are then
configured in methods.
4.1.2 Defining dialog properties
Description
The properties of the dialog are defined in the start identifier line of the dialog.

① Machine status display ("header")

② Graphic
③ Dialog
④ Header line of the dialog with header and long text
Figure 4-2 Dialog properties
Programming
Syntax: //M(Identifier/[Title]/[Graphic]/[Dimension]/[System or user variable]/[Position graphic]/[Attribute]/List of the

mask-specific language files)
See also Chapter Extended configuration syntax (Page 36).
Description: Defines a dialog

Dialogs
Parameter: Identifier Name of the dialog

Header Dialog header as text or call for text (e.g. $85011) from a language-specific
text file.
Graphic Graphics file with path in double quotation marks.
Dimension Position and size of the dialog in pixels (distance from left-hand side, dis‐
tance from top, width, height), in relation to the upper left-hand corner of the
screen. The entries are separated by a comma.
System or user variable System or user variable to which the current cursor position is assigned.
The NC or PLC can be provided with the cursor position via the system or
user variable. The first variable has index 1. The order corresponds to the
configuration order of the variables.
Graphic position Position of the graphic in pixels (distance from left-hand side, distance from
top), in relation to the upper left-hand corner of the dialog. The entries are
separated by a comma.
Attributes The specifications of the attributes are separated by a comma.
Possible attributes are:
CM Column mode: Column alignment
CM0 Default setting: The column distribution is carried out separately for each
line.
CM1 The column distribution of the line with the most columns applies to all lines.
CB CHANGE block: Response when dialog is opened: cb attributes specified
for a variable in a variables definition take priority over the default setting in
the dialog definition.
See also Behavior when opening the dialog (attribute CB) (Page 240).
CB0 Default setting: All CHANGE blocks associated with the dialog are pro‐
cessed when it is opened.
CB1 CHANGE blocks are then only processed if the relevant value changes.
XG Integration of an X3D animation as help display (only in the machining step
programming).
Example:
//M(Meas/
$85605/"myx3dhelpfile.hmi,,Z_Animation,,G17"///30,10/
XG1)
XG0 Default setting = 0
XG1 The mask attribute XG must already be set to 1 in the mask definition, a
change during runtime is not possible.
Note:
The specification in the mask property HLP must also be set accordingly.
AL The alignment of the mask header can be influenced with the mask attribute
AL.
Example:
Central setting of the "Set password" window header:
//M(MY_PWD_SET/”Set password”//"EasyPwdModalLayout"//
AL2)
AL0 Left-justified, default
AL1 Right-justified
AL2 Centered

Dialogs
KM Freely scrolling in the mask (SlGfwScrollArea), if the virtual keyboard is to

be displayed for MultiTouch, can be influenced as follows:
● In the mask definition line with mask attribute "KM" (KeyboardMode)
Example:
//M(MyMTMask/"MultiTouch Mask"/////KM1)
● As global setting for all Run MyScreens masks in the easyscreen.ini
Example:
[GENERAL]
DefaultVirtualKeyboardMode=1
Note:
If, when configuring the masks, the mask attribute KM is explicitly set, then
this has a higher priority than the global setting in easyscreen.ini.
(See also Chapter SmartOperation and MultiTouch operation (Page 37))

KM1 Free scrolling active (default)
KM0 Free scrolling inactive
PG Alignment and appearance of the window title in conjunction with PNG im‐
ages (only effective in the editor!)
Example:
//M(MyPg1SampleMask/"My PG1 Sample Mask"/////PG1)
PG0 (Default)
PG1 Alignment and appearance of the window title in conjunction with PNG im‐
ages
Path specification (on the far left), mask name (on the right)
The display of the long text is no longer possible in this mode. Alternatively,
you can work with tooltips.
MA Automatic adjustment of the field height for MultiTouch operation (Mutli‐
Touch Adjustment)
If required, the adjusment for a MultiTouch operator panel includes the nec‐
essary enlargement to the so-called minimum usable size (width, height) of
the fields (exceptions: progress bar, animated GIF, CustomWidget) and the
line spacing.
The MultiTouch adjustment can be made
● Globally for all Run MyScreens masks in the easyscreen.ini, e.g.
[GENERAL]
DefaultMultiTouchAdjustmentLevel=1
● Or mask-specifically in the mask definition line with the mask property
"MA" in order to overwrite the global setting in easyscreen.ini, e.g.
//M(MyMTMask/"MultiTouch Mask"/////MA1)
If the mask attribute MA is set explicitly in the mask configuration, then this
has a higher priority than the global setting in easyscreen.ini.
MA0 There is no adjustment
MA1 Only those fields are adjusted for which no spacing from the top and/or field
height/width has been configured – i.e. the fields that use default positions
and therefore for which Run MyScreens calculates the spacing from the top
and/or field height/width. (Default)

Dialogs
MA2 All fields are adjusted irrespective of the configured field sizes.
PA Optimized and pixel-precise stretching of the fields for higher resolutions
(Pixel Fine Adjustment)
Previously all field positions were calculated in relation to 640x480 and then
zoomed with the appropriate horizontal and vertical stretch factors. This
process has the disadvantage that rounding errors can occur with "unfav‐
orable stretch factors". For example, the field height or line spacing can
"jump" by a pixel from line-to-line. The "Pixel Fine Adjustment" mode can
be used to prevent this as the field positions are determined directly in the
current resolution.
//M(MyMask/"My Mask"/////PA1)
This setting can also be made globally for all Run MyScreens masks in the
easyscreen.ini, e.g.
[GENERAL]
DefaultPixelFineAdjustment=1
If the mask attribute PA is set explicitly in the mask configuration, it has a
higher priority than the global setting in the easyscreen.ini.
If a mask is displayed with Font Adjustment = FA1, then the Pixel Fine
Adjustment mode is also automatically active for this mask.
PA0 Stretching as previously, i.e. the positions are calculated in relation to
640x480 and then stretched.
(For compatibility reasons: Default)
PA1 Optimized and pixel-precise stretching of the fields for higher resolutions
FA Field height and line spacing proportional to the font (Font Adjustment)
This setting can also be made globally for all Run MyScreens masks in the
easyscreen.ini, e.g.
[GENERAL]
DefaultFontAdjustment=1
If the mask attribute FA is set explicitly in the mask configuration, then this
has a higher priority than the global setting in easyscreen.ini.
The settings for the DefaultLineHeight and DefaultLineSpacing have no
significance when Font Adjustment mode is active.
FA0 Field height and line spacing are stretched as previously. (For compatibility
reasons: Default)
FA1 Field height and line spacing are set proportional to the font (automatically
sets mask attribute PA=1)
FA2 Same as FA1, but the X coordinate and the field width are also stretched
proportionally to the font
(Automatically sets mask attribute PA=1)
(Only possible in conjunction with attribute XG=1!)
MC Mask background color (mask color)
Example:
Set mask background color blue (= 6)
//M(MyMask/"MyMask"//////6)
or
PRESS(HS1)
MC=6

Dialogs
END_PRESS
List of the mask-specific lan‐ separated by a comma
guage files
Accessing the dialog properties

Read and write access to the following dialog properties is permitted within methods (e.g.
PRESS block).
● HD = Header
● HLP = Help display
● VAR = System or user variable
● MC = Mask background color
● CM = Column alignment (read-only)
● CB = Behavior when opening (read-only)
● XG = Integration of X3d (read-only)
● AL = Mask header alignment (read-only)
Example
Figure 4-3 "Example 2: showing graphic"

Dialogs
//S(Start)
HS7=("Example", se1, ac7)
PRESS(HS7)
LM("Mask2")
END_PRESS
//END
//M(Mask2/"Example 2 : showing graphic"/"example.png")
HS1=("new%nHeader")
HS2=("")
HS3=("")
HS4=("")
HS5=("")
HS6=("")
HS7=("")
HS8=("")
VS1=("")
VS2=("")
VS3=("")
VS4=("")
VS5=("")
VS6=("")
VS7=("")
VS8=("")
PRESS(HS1)
Hd= "new Header"
END_PRESS
...
//END
See also
Programming example for the "Custom" area (Page 224)

Dialogs
4.1.3 Defining dialog elements
Dialog element
The term "dialog element" refers to the visible part of a variable, i.e. short text, graphics text,
input/output field, unit text and tooltip. Dialog elements fill lines in the main body of the dialog.
One or more dialog elements can be defined for each line.
Variable properties
All variables are valid in the active dialog only. Properties are assigned to a variable when it
is defined. The values of dialog properties can be accessed within methods (e.g. a PRESS
method).

① Header line of the dialog with header and long text

② Dialog element
③ Short text
④ Input/output field
⑤ Graphic text
⑥ Text for units
⑦ Main body of the dialog
Figure 4-4 Elements of a dialog
Programming - Overview
The single parameters to be separated by commas are enclosed in round brackets:
DEF Identifier = Identifier = Name of variable

Variable type

Dialogs
/[Limit values or toggle field]

/[Default]
/[Texts (Long text, Short text|Image, Graphic text, Units text)]
/[Attributes]
/[Help display]
/[System or user variable]
/[Position of short text]
/[Position of I/O field(Left, Top, Width, Height)]
/[Colors]
/[online help] (Page 61)
See also
Variable parameters (Page 71)
4.1.4 Defining dialogs with multiple columns
Overview
Multiple variables can also be represented in a dialog on one line. In this case, the variables
are all defined in the configuration file on a single definition line.
DEF VAR11 = (S///"Var11"), VAR12 = (I///"Var12")
To make individual variables in the configuration file more legible, the definition lines can be
wrapped after every variables definition and following comma.
The key word "DEF" always indicates the beginning of a new line:
DEF Tnr1=(I//1/"","T ",""/wr1///,,10/20,,50),

TOP1=(I///,"Type="/WR2//"$TC_DP1[1,1]"/80,,30/120,,50),
TOP2=(R3///,"L1="/WR2//"$TC_DP3[1,1]"/170,,30/210,,70),
TOP3=(R3///,"L2="/WR2//"$TC_DP4[1,1]"/280,,30/320,,70),
TOP4=(R3///,"L3="/WR2//"$TC_DP5[1,1]"/390,,30/420,,70)
DEF Tnr2=(I//2/"","T ",""/wr1///,,10/20,,50),
TOP21=(I///,"Typ="/WR2//"$TC_DP1[2,1]"/80,,30/120,,50),
TOP22=(R3///,"L1="/WR2//"$TC_DP3[2,1]"/170,,30/210,,70),
TOP23=(R3///,"L2="/WR2//"$TC_DP4[2,1]"/280,,30/320,,70),
TOP24=(R3///,"L3="/WR2//"$TC_DP5[2,1]"/390,,30/420,,70)

Dialogs
Note
When configuring multi-column dialogs, please observe that a large number of columns might
slow down the system!

Dialogs
4.1.5 Password dialogs
Using the standard password dialogs

You can integrate the following predefined password dialogs in the screen configuration:
● Set password
Figure 4-5 Set password dialog
● Change password
Figure 4-6 Change password dialog
● Delete password

Dialogs
Figure 4-7 Delete password dialog
Note
Password functionality is provided with these dialogs. The dialogs do not correspond to the
dialogs of SINUMERIK Operate.
The dialogs can be called either via the Load softkey (LS) function or the Load mask (LM)
function:
1. Call via the Load softkey (LS) function:
LS("Passwd","slespasswd.com",1)
Extension of the vertical softkeys:
– Softkey 1: Set password
– Softkey 2: Change password
– Softkey 3: Delete password
2. Alternatively, the three masks can be directly jumped to by calling the (LM) function:
– Set password: LM("PWD_SET", "slespasswd.com",1)
– Change password: LM("PWD_CHG", "slespasswd.com",1)
– Delete password: LM("PWD_CLEAR", "slespasswd.com",1)

Dialogs
4.2 Defining softkey menus
4.1.6 Using display images/graphics
Use of graphics
A distinction is made between:
● Display images / graphics in the graphic area.
● Help displays illustrating, for example, individual variables, which are superimposed in the
graphic area.
● More Help displays can be configured instead of short text or an input/output field, which
you position where you like.
Storage locations
The image matching the resolution of the connected monitor is searched for in the associated
resolution directories in the following sequence:
[System user directory]/ico/ico<Resolution>

[System oem directory]/ico/ico<Resolution>
[System add_on directory]/ico/ico<Resolution>
If the image is not displayed or not found, copy it into one of the following directories for a
resolution of 640 x 480 pixels:
[System user directory]/ico/ico640

[System oem directory]/ico/ico640
[System add_on directory]/ico/ico640
Note
With the different panel resolutions, the images are positioned proportionally.
Definition
The term softkey menu is used to refer to all the horizontal and vertical softkeys displayed on
a screen form. In addition to the existing softkey menus, it is possible to define other menus,
which partially or completely overwrite the existing menus.
The names of the softkeys are predefined. Not all softkeys need to be assigned.
HSx x 1 - 8, Horizontal softkeys 1 to 8
VSy y 1 - 8, Vertical softkeys 1 to 8

Dialogs
The definition of a softkey menu (softkey menu definition block) is basically structured as
follows:
Definition block Comment Section reference

//S... ;Start identifier of softkey menu
HSx=... ;Define softkeys
PRESS(HSx) ;Method start identifier See Section "Methods"
LM... ;Actions
//END ;End identifier of softkey menu
Description
Properties are assigned to softkeys during definition of the softkey menu.
Programming
Syntax: //S(Identifier) ;Start identifier of softkey menu

...
//END ;End identifier of softkey menu
See also Section Extended configuration syntax (Page 36).
Description: Defines the softkey menu
Parameter: Identifier Name of the softkey menu
Text or image file name
Syntax: SK = (Text[, access level][, Status][, Alignment of the softkey image][, text align‐
ment referred to the softkey image])
Description: Define softkey
Parameter: SK Softkey, e.g. HS1 to HS8, VS1 to VS8

Dialogs
Text Enter text

Image file name "\\my_pic.png"
or via separate text file $85199, e.g. with the following
text in the (language-specific) text file: 85100 0 0 "\
\my_pic.png".
The image size which can be displayed on a softkey
depends on the OP used:
OP 08: 640 x 480 mm → 25 x 25 pixels
OP 010: 640 x 480 mm → 25 x 25 pixels
OP 012: 800 X 600 mm → 30 x 30 pixels
OP 015: 1024 X 768 mm → 40 x 40 pixels
OP 019: 1280 x 1024 mm → 72 x 72 pixels
Access level ac0 to ac7 (ac7: default)
Status se1: visible (default)
se2: disabled (gray text)
se3: displayed (last softkey used)
Alignment of the soft‐ PA (PictureAlignment)
key image Valid values:
0: Left
1: Right
2: Centered
3: Top (default)
4: Bottom
Text alignment in re‐ TP (TextAlignedToPicture)
lation to the softkey Valid values:
image
0: Text is not aligned to the image
1: Text is aligned to the image (default)
Note
Enter %n in the softkey text to create a line break.
A maximum of 2 lines with 9 characters each are available.
Assigning access level

Operators can only access information on this access level and lower access levels (see also
List of access levels (Page 238)).
Example
//S(Menu1) ; Start identifier of softkey menu

HS1=("NEW", ac6, se2) ; Define softkey HS1, assign the label "NEW", protec-
tion level 6, and the status "disabled"

Dialogs
HS2=("\\image1.png") ; Assign a softkey to the graphic

HS3=("Exit")
HS4=(["Confirm","\\sk_ok.png"],PA0,TP1) ; Softkey with text and graphic, Text="Confirm", Im-
age="sk_ok.png", Alignment of the softkey image: Left,
text is aligned to the image
VS1=("sub screen form")

VS2=($85011, ac7, se2) ; Define softkey VS2, assign the text from the lan-
guage file, protection level 1, and the status "disa-
bled"
VS3=("Cancel", ac1, se3) ; Define softkey VS3, assign the label "Cancel", pro-
tection level 1 and the status "highlighted"
VS4=("OK", ac6, se1) ; Define softkey VS4, assign the label "OK", protec-
tion level 6 and the status "visible"
VS5=(SOFTKEY_CANCEL,,se1) ; Define cancel standard softkey VS5 and assign the
status "visible"
VS6=(SOFTKEY_OK,,se1) ; Define OK standard softkey VS6 and assign the status
"visible"
VS7=(["\\image1.png","OEM text"],,se1) ; Define softkey VS7, assign an image, assign the la-
bel "OEM Text" and the status "visible"
VS8=(["\\image1.png",$83533],,se1) ; Define softkey VS8, assign an image, assign text
from language file and the status "visible"
PRESS(HS1) ; Method start identifier

HS1.st=" Calculate" ; Assign a label text to the softkey
...
END_PRESS ; Method end identifier
PRESS(RECALL) ; Method start identifier

LM("Maske21") ; Load dialog
END_PRESS ; Method end identifier
//END ; End identifier of softkey menu
4.2.1 Changing softkey properties during runtime
Description
The softkey properties Text, Access Level and Status can be changed in the methods during
runtime.

Dialogs
Programming
Syntax: SK.st = "Text" ;Softkey with label

SK.ac = Access level ;Softkey with protection level
SK.se = Status ; Softkey with status
SK.pa = "Alignment of the softkey image" ;Softkey with image
SK.tp = "Text alignment in relation to the soft‐ ;Softkey with image and label
key image"
Description: Assign properties
Parameter: Text Label text in inverted commas
Access level Range of values: 0 ... 7
Status 1: Visible and operator-controllable
2: Disabled (gray text)
3: Highlighted (last softkey used)
Alignment of the 0: Left
softkey image 1: Right
2: Centered
3: Top (default)
4: Bottom
Text alignment in 0: Text is not aligned to the image
relation to the 1: Text is aligned to the image (default)
softkey image

Dialogs
Example
Figure 4-8 Example 3: Graphics and softkeys
//S(Start)
HS7=("Example", ac7, se1)
PRESS(HS7)
LM("Maske3")
END_PRESS
//END
//M(Maske3/"Example 2: showing graphic"/"example.png")

HS1=("")
HS2=("")
HS3=("")
HS4=("")
HS5=("")
HS6=("")
HS7=("")
HS8=("")

Dialogs
VS1=("")
VS2=("")
VS3=("")
VS4=("\\sp_ok.png",,SE1)
VS5=(["\\sp_ok_small.png","OEM Text"],,SE1)
VS6=("")
VS7=(SOFTKEY_OK,,SE1)
VS8=(SOFTKEY_CANCEL,,SE1)
PRESS(VS4)
EXIT
END_PRESS
PRESS(VS5)
EXIT
END_PRESS
PRESS(VS7)
EXIT
END_PRESS
PRESS(VS8)
EXIT
END_PRESS
//END
4.2.2 Language-dependent text
Overview
Language-dependent texts are used for:
● Softkey labels
● Headings
● Help texts
● Any other texts
The language-dependent texts for dialogs are stored in text files.
The text files are stored in the following directories:
● [System user directory]/lng
● [System oem directory]/lng
● [System add_on directory]/lng

Dialogs
Note
The text files must be saved in the same way as the project files.
For example:
[System user directory]/lng/[Text file]
[System user directory]/proj/[Configuration file]
alsc.txt Language-dependent texts for the Siemens standard cycles

almc.txt Language-dependent texts for the Siemens measuring cycles
The text files used during program runtime are specified in the easyscreen.ini file:
[LANGUAGEFILES]
LngFile03 = user.txt ;->user<_xxx>.txt (e.g.: user_eng.txt)
In this instance, the user.txt file has been chosen as an example of a text file. The name can
always be freely selected. Depending on the language of the texts within the file, the relevant
language code must be added using the following syntax. An underscore followed by the
relevant language identifier is added after the name e.g. user_eng.txt.
Note
You must not use LngFile01 and LngFile02 for user texts because they are already assigned
in the standard easyscreen.ini.
See also
List of language codes used in file names (Page 239)
Mask-specific language files

In order to avoid overlaps for the number ranges used in the language files, only certain
language files can be used in a specific mask.
This is the reason that the language files to be used are listed in the mask definition line,
separated by a comma. The file listed at the last location has the highest priority (analogous
to the logic in easyscreen.ini).
All of the language-dependent texts used in the mask are predominantly searched for in these
language files. If the text is not found in these, then a search is made in text files configured
in easyscreen.ini.

Dialogs
If no language files have been defined in the mask, then a search is only made in the language
files specified in easyscreen.ini.
Note
The English language file is used (default) if a language file is not available in the currently
selected language.
Examples:
//M(MyMask/$85597///// //"mytexts.txt, general.txt, mask.txt")

DEF ….
You can also use this procedure for the start softkeys:
//S(Start, "mytexts.txt, general.txt, mask.txt")

VS1=($85597)
PRESS(VS1)
LM("MyMask","masks.com")
END_PRESS
Format of text files

The text files must be saved in UTF-8 format.
Note
Make sure that the coding is set to UTF-8 in the editor that you are using when saving the
configuration and language files.
Format of a text entry
Syntax: 8xxxx 0 0 "Text"

Description: Assignment between text number and text in the file
Parameter: xxxx 85,000 to 89,999 Text identification number range reserved for
users. You must assign unique numbers.
"Text" Text that appears in the dialog
%n Control characters in the text for creating a line
break
Parameters 2 and 3 are separated by blanks and act as control characters for alarm text output.
To ensure that the text format is identical to that of the alarm texts, you must set zero.

Dialogs
4.3 Configuring the online help
Examples of language-dependent texts:

85000 0 0 "Retraction plane"
85001 0 0 "Drilling depth"
85002 0 0 "Pitch"
85003 0 0 "Pocket radius"
Online help
An online help for the configured dialogs and elements can be created in the HTML format.
The syntax and procedure for the online help is essentially the same as for SINUMERIK
Operate.
If an online help is configured for an input field, then the standard screens of the online help
are used to display the user-specific online help:
DEF RFP=(R//1/,"RFP","RFP"///////"sinumerik_md_1.html","9006")
Note
As a result of LINUX, the HTML file must be written in lower case letters!
The HTML file is saved in the following directory, e.g. for English.
[System user directory]/hlp/eng
[System add_on directory]/hlp/eng
You must create the directories for additional languages corresponding to the language codes
(see appendix).
References
Commissioning Manual "Base software and operating software" (IM9), Chapter "OEM-specific
online help"

Dialogs

Variables 5
5.1 Defining variables
Variable value
The major property of a variable is its value.
The value of variables can be assigned by means of:
● Default settings when defining variables
● Assignment to a system or user variable
● A method
Programming
Syntax: Identifier.val = Variable value

Identifier = Variable value
Description: Variable value val (value)
Parameter: Identifier: Name of the variable
Variable value: Value of the variable
Example: VAR3 = VAR4 + SIN(VAR5)
VAR3.VAL = VAR4 + SIN(VAR5)
Variable status
The "Variable status" property scans a variable for valid content during runtime. This property
can be read and written with the value FALSE = 0.
Programming
Syntax: Identifier.vld
Description: Variable status vld (validation)
Parameter: Identifier: Name of the variable
The result of the scan can be:
FALSE = invalid value
TRUE = valid value
Example: IF VAR1.VLD == FALSE
VAR1 = 84
ENDIF

Variables
5.2 Application examples
5.2 Application examples
Help variables
Help variables are internal arithmetic variables. Arithmetic variables are defined like other
variables, but have no other properties apart from variable value and status, i.e. Help variables
are not visible in the dialog. Help variables are of the VARIANT type.
Programming
Syntax: DEF Identifier

Description: Internal arithmetic variables of the VARIANT type
Parameter: Identifier: Name of the Help variable
Example: DEF OTTO ;Definition of a Help variable
Syntax: Identifier.val = Help variable value

Identifier = Help variable value
Description: A value is assigned to a Help variable in a method.
Parameter: Identifier: Name of the Help variable
Help variable value: Content of the Help variables
Example:
LOAD
OTTO = "Test" ; The value "Test" is assigned to help variable Otto.
END_LOAD
LOAD
OTTO = REG[9].VAL ; The value of the register is assigned to help variable
END_LOAD Otto
Calculation with variables

Variables are calculated every time you exit an IO field (by pressing the ENTER or TOGGLE
key). The calculation is configured in a CHANGE method that is processed every time the
value changes.
You can scan the variable status to ascertain the validity of the value of the variable, e.g.
IF VAR1.VLD == FALSE
VAR1 = 84
ENDIF

Variables
5.3 Example 1: Assigning the variable type, texts, help display, colors, tooltips
Addressing system variables indirectly

A system variable can also be addressed indirectly, i.e. as a function of another variable:
PRESS(HS1)
ACHSE=ACHSE+1
WEG.VAR="$AA_DTBW["<<ACHSE<<"]" ;Address axis address via variable
END_PRESS
Changing softkey labels

Example:
HS3.st = "New text" ;Change softkey label
5.3 Example 1: Assigning the variable type, texts, help display, colors,
tooltips
Example 1a
The following example defines a variable for which the properties variable type, texts, help
display and colors are set.
DEF Var1 = (R///,"Actual value",,"mm"//"Var1.png"////8,2)

Variable type: REAL
Texts:
Short text: Actual value
Unit text: mm
Help screen: Var1.png
Colors:
Foreground color: 8 (brown)
Background color: 2 (orange)

Variables
5.4 Example 2: Assigning the Variable Type, Limits, Attributes, Short Text Position properties
Example 1b
The following example defines a variable for which the properties variable type, default setting,
texts, tooltip, input mode and position of short text are set.
DEF Var2 = (I//5/"","Value","",""," Tooltip text"/wr2///20,250,50)

Variable type: INTEGER
Default setting: 5
Texts:
Short text: Value (possible language text ID)
Tooltip: ToolTipText
Attributes:
Input mode: Reading and writing
Position of short text:
Distance from left: 20
Distance from top: 250
Width: 50
See also
5.4 Example 2: Assigning the Variable Type, Limits, Attributes, Short Text
Position properties
Example 2
The following example defines a variable for which the properties variable type, limits, input
mode, alignment and position are set.
DEF Var2 = (I/0,10///wr1,al1///,,300)

Variable type: INTEGER
Limits or toggle field entries: MIN: 0
MAX: 10
Attributes:
Input mode: Read-only
Alignment of short text: Right-justified
Position of short text:
Width: 300
See also

Variables
5.6 Example 4: Toggle field and list field
5.5 Example 3: Assigning the Variable Type, Default, System or User

Variable, Input/Output Field Position properties
Example 3
The following example defines a variable for which the properties variable type, default setting,
system or user variable and position are set.
DEF Var3 = (R//10////"$R[1]"//300,10,200//)

Variable type: REAL
Default setting: 10
System or user variable: $R[1] (R-Parameter 1)
Position of short text: Default position in relation to input/output field
Position of input/output field:
Distance from top: 10
Width: 200
See also
5.6 Example 4: Toggle field and list field
Example 4a
Various entries in the toggle field:
DEF Var1 = (I/* 0,1,2,3) ;Simple toggle field to toggle numeric values
DEF Var2 = (S/* "On", "Off") ;Simple toggle field to toggle strings
DEF Var3 = (B/* 1="On", 0="Off") ;Extended toggle field to toggle numeric values whereby a
display text is assigned to each numeric value
DEF Var4 = (R/* ARR1) ;Toggle field which obtains its values to be toggled from an
array

Variables
5.8 Example 6: Progress bar
Example 4b
The list field corresponds to the configuration of a toggle field, but the display type for the list
field (variable attribute DT = 4) must also be set.
DEF VAR_LISTBOX_Text = (S/*$80000,$80001,$80002,$80003,$80004/$80001//DT4////200,,340,60)

Variable type: STRING
Limits / toggle field: *$80000,$80001,$80002,$80003,$80004
(List of the language-dependent texts to be dis‐
played)
Default setting: $80001
Attributes:
Display type: 4 (list field)
Width: 340
Height: 60
Colors:
Foreground color: 6 (blue)
Background color: 10 (white)
5.7 Example 5: Image display
Example 5
Displaying an image instead of a short text: The size and position of the image is defined under
"Position of input/output field (left, top, width, height)".
DEF VAR6= (V///,"\\image1.png" ////160,40,50,50)

Variable type: VARIANT
Texts:
Short text: image1.png
Distance from the top: 40
Width: 50
Height: 50

The progress bar is a special display type of the input/output field and is designed for display
without input.

Variables
Basically there are two progress bar types:

1. Progress bars with up to two color changes, e.g. for temperature or utilization display (see
example 6a)
2. Progress bars to display progress (no color change) in the Operate style (see example 6b)
Example 6a
Progress bar with two color changes:
Figure 5-1 Progress bar with two color changes
DEF PROGGY0 = (R/0,150,50,100///DT1,DO0//"$R[10]"//,,150/3,4,,,,,,,9,7)

Variable type: REAL
Limits / toggle field:
MIN: 0
MAX: 150
Signal value SVAL1: 50
Signal value SVAL2: 100
Attributes:
Display mode DT: 1 (progress bar)
Display option DO: 0 (from left to right (default))
System or user variable: $R[10]
Width: 150
Colors:
Foreground color: 3 (dark green)
Background color: 4 (light gray)
Signal color SC1: 9 (yellow)
Signal color SC2: 7 (red)
To use a progress bar with color change, the display mode DT (DisplayType) must be set to
1.
The orientation of the progress bar is determined via the attribute display option DO
(DisplayOption):
0: From left to right (default)
1: From right to left
2: From bottom to top
3: From top to bottom
A MIN and a MAX value must be specified for the display of the progress bar (in the example
MIN: 0, MAX: 150).

Variables
Depending on the current value of the variable PROGGY0, this setting already displays a
progress bar with the foreground color 3 (= dark green) and the background color 4 (= light
gray).
Optionally, one or two signal values SVAL1 and SVAL2 (limit parameters) can be defined (in
the example SVAL1: 50 and SVAL2: 100). With these signal values, the foreground color of
the progress bar changes. The appropriate signal colors are specified via parameters SC1
and SC2 (in the above example SC1: 9 (= yellow) and SC2: 7 (=red)).
The following rule applies when specifying limit values for the progress display:
MIN < SVAL1 < SVAL2 < MAX.
Example 6b
Progress bar without color change:
Figure 5-2 Progress bar
DEF PROGGY0 = (R/0,150///DT2,DO0//"$R[10]"//,,150/6,10)

Variable type: REAL
Limits / toggle field:
MIN: 0
MAX: 150
Attributes:
Display type DT: 2 (progress bar)
Display option DO: 0 (from left to right (default))
System or user variable: $R[10]
Width: 150
Colors:
Foreground color: 6 (blue)
Background color: 10 (white)
To use a progress bar without color change, the display mode DT (DisplayType) must be set
to 2.
The orientation of the progress bar is determined via the attribute display option DO
(DisplayOption) (see description for example 6a).
A MIN and a MAX value must be specified for the display of the progress bar (in the example
MIN: 0, MAX: 150).
Depending on the current value of the variable PROGGY0, this setting displays a progress
bar with the foreground color 6 (= blue) and the background color 10 (= white).

Variables
5.10 Variable parameters
5.9 Example 7: Password input mode (asterisk)
Example 7
To implement a field with hidden input, e.g. to enter a password, then display mode DT must
be set to 5. Asterisks are then displayed instead of the entered characters.
Figure 5-3 Password input mode (asterisk)
DEF VAR_SET_PWD=(S//""//DT5)
Variable type: STRING
Default setting: Empty string
Attributes:
Display mode DT: 5 (password input mode)
Parameter overview
The following overview provides a brief explanation of the variable parameters. Subsequent
chapters contain a more detailed description.
Variable type (Page 77) The variable type must be specified.
R[x]: REAL (+ digit for the decimal place)
I: INTEGER
S[x]: STRING (+ digit for string length)
C: CHARACTER (individual character)
B: BOOL
V: VARIANT

Variables
Limits (Page 66) Limit value MIN, limit value MAX
Default setting: Empty
The limit values are separated by a comma. Limits can be specified for types I, C and R
in decimal formats or as characters in the form "A", "F".
Optionally, two signal colors SC1 and SC2 can be configured for the display of a progress
bar with color change (variable attribute DT = 1) which are displayed as the respective
foreground color of the bar when the signal value SVAL1 or SVAL2 is exceeded. The
signal values are specified as integer values.
See application example for Progress bar (Page 68).
Default setting (Page 81) If no default setting has been configured and no system or user variable has been assigned
to the variable, the first element of the toggle field is assigned. If no toggle field has been
defined, there is no default setting, which means the status of the variable is "not calcu‐
lated".
Default setting: No default
Toggle field (Page 80) List with predetermined entries in the IO field: The list is initiated by a *; the entries are
separated by a comma. The entries can be assigned a value.
For the toggle field, the entry for the limit is interpreted as a list. If only one * is entered,
a variable toggle field is created.
Default setting: None
Texts (Page 65) The sequence is specified. Instead of a short text, an image can also be displayed.
Long text: Text in the display line
Short text: Name of the dialog element
Graphic text: Text refers to the terms in the graphics
Unit text: Unit of the dialog element
Tooltip Serves as brief information in a screen form configuration for
the display and toggle fields. The information is configured via
plain text and language text ID.

Variables
Attributes (Page 66) The attributes influence the following properties:
● Display mode
● Display option
● Update rate
● Toggle symbol
● Tooltip
● Input mode
● Access level
● Alignment of short text
● Font size
● Limits
The attributes are separated by commas and appear in any order. A definition can be
made for each component.
Display mode dt0: Standard (input/output field or toggle field) (default)
dt1: Progress bar with color change
dt2: Progress bar without color change in the Operate style
dt4: List field
dt5: Password input mode (asterisk)
Display option Particularly, e.g. for the display modes dt1 and dt2 (progress bars), a
display option may also have to be configured in combination.
do0: From left to right (default)
do1: From right to left
do2: From bottom to top
do3: From top to bottom
Update rate The attribute UR (update rate) controls the update of the display and
therefore the processing of the associated, configured CHANGE block
of variables or grid columns. Depending on the configuration, the CPU
load can be drastically reduced and therefore shorter response times
achieved on the user interface.
ur0: SlCap::standardUpdateRate() (currently = 200 ms, default value)
ur1: 50 ms
ur2: 100 ms
ur3: 200 ms
ur4: 500 ms
ur5: 1000 ms
ur6: 2000 ms
ur7: 5000 ms
ur8: 10000 ms
Toggle symbol tg0: Toggle symbol off (default)
tg1: Toggle symbol on
If the attribute TG is set to 1, the toggle symbol also appears in the
tooltip of the input field.
Example:
DEF OFFS = (R//123.456/,,,,"My ToolTip"/TG1)

Variables
Tooltip The tooltip text can also be changed during runtime via the variable
property "TT".
Example:
PRESS(VS1)
MyVar.TT = "My new ToolTip"
END_PRESS
or
DEF MyVar=(R///,,,,"My ToolTip-text")
Input mode wr0: IO field invisible, short text visible
wr1: Read (no focus possible for input)
wr2: Read and write (line appears in white)
wr3: wr1 with focus
wr4: All variable elements invisible, no focus possible
wr5: The value entered is saved immediately on every keystroke (in
contrast to wr2, where it is only saved when the field is exited or RE‐
TURN is pressed).
Default setting: wr2
Access level Empty: Can always be written
(Page 238) ac0...ac7: Protection levels
If the access level is not adequate, then the first line is displayed in
gray, default setting: ac7
Alignment of al0: Left-justified
short text al1: Right-justified
al2: Centered
Default setting: al0
Font size fs1: Default font size (8 pt.)
fs2: Double font size
Default setting: fs1
The clearances between the lines is defined. With the default font size,
16 lines will fit into the dialog. Graphics and unit text can only be con‐
figured in the default font size.
Limits Consequently, it is possible to check whether the values of the variable
are within the MIN and MAX limits specified.
Default setting: Determined by specified limits
li0: No check
li1: Check with respect to min.
li2: Check with respect to max.
li3: Check with respect to min. and max.
Behavior when cb attributes specified for a variable in a variables definition take pri‐
opening ority over the cb default setting in the dialog definition. Multiple attrib‐
utes are separated by commas (see also Behavior when opening the
dialog (attribute CB) (Page 240)).
CB0: The CHANGE method is triggered when the screen is displayed if the
variable has a valid value at this time (e.g. through default setting or
CB1: NC/PLC variable).

Variables
The CHANGE method is not explicitly triggered when the screen is
displayed. If the variable has a configured NC/PLC variable, then the
CHANGE method is of course still called.
Help display (Page 65) Help display file: Name of the png file
The name of the Help display file appears in double quotation marks. The display appears
automatically (instead of the previous graphic) if the cursor is positioned on this variable.
System or user variable System or user data from the NC/PLC can be assigned to the variable. The system or
(Page 67) user variable appears in double quotation marks.
Reference: List Manual System Variables, /PGAsl/
Position of short text (Page 82) Position of short text (distance from left, distance from top, width)
The positions are entered in pixels and relate to the upper left-hand corner of the main
body of the dialog. The entries are separated by commas.
Position of input/output field Position of input/output field (distance from left, distance from top, width, height)
(Page 82) The positions are entered in pixels and relate to the upper left-hand corner of the main
body of the dialog. The entries are separated by commas. If this position changes, the
positions of the short text, graphic text and unit text also change.
Colors (Page 65) Foreground and background colors for input/output fields, short texts, graphic texts, unit
texts and signal colors for progress bars:
The colors are separated by a comma.
For specification of the color, see Chapter List of colors (Page 238).
Default setting for input/output field: Foreground color: Black, background color: White
The default colors of the input/output field depend on the "wr" write mode:
Default setting for short text, graphic text, unit text: Foreground color: Black, background
color: Transparent.
Optionally, two signal colors SC1 and SC2 can be configured for the display of a progress
bar with color change (variable attribute DT = 1) which are displayed as the respective
foreground color of the bar when the signal value SVAL1 or SVAL2 is exceeded.
See application example for Progress bar (Page 68).
The colors are expected in the following order in the variables definition:
1. Foreground color of the input/output field: FC
2. Background color of the input/output field: BC
3. Foreground color of the short text: FC_ST
4. Background color of the short text: BC_ST
5. Foreground color of the graphic text: FC_GT
6. Background color of the graphic text: BC_GT
7. Foreground color of the unit text: FC_UT
8. Background color of the unit text: BC_UT
9. Signal color 1
10. Signal color 2

Variables
Online help file (Page 61) The name of the online help file appears in double quotation marks.
I/O field with integrated unit se‐ You can use the input/output fields with integrated unit selection to toggle between differ‐
lection ent units. If the cursor is moved to the input field, the integrated unit selection is highlighted
(focus does not have to be explicitly placed on it). A tooltip with a toggle symbol is also
displayed with the appropriate reference to this functionality.
Examples:
DEF VarEdit=(R////////200,,100///"VarTgl")
VarTgl=(S/*0="mm",1="inch"/0//WR2////302,,40)
or
DEF VarEdit_2={TYP="R", VAL=1.234, X=200, W=100,
LINK_TGL="vartgl_2"},
VARTgl_2={TYP="S", TGL="* 0=""mm"", 1=""inch""",WR=2, X=302,
W=40}
Variable: Changing properties

The variables are assigned a new value in the notation Identifier.Property = Value when a
change is made. The expression to the right of the equality sign is evaluated and assigned to
the variable or variable property.
Identifier.ac = Access level (ac: access level)

Identifier.al = Text alignment (al: alignment)
Identifier.bc = Background color of the input/output field (bc: back color)
Identifier.bc_gt = Background color of the graphic text (bc: back color)
(gt: graphic text)
Identifier.bc_st = Background color of the short text (bc: back color)
(st: short text)
Identifier.bc_ut = Background color of the unit text (bc: back color)
(ut: unit text)
Identifier.do = Display option (do: display option)
Identifier.dt = Display mode (dt: display type)
Identifier.fc = Foreground color of the input/output field (fc: front color)
Identifier.fc_gt = Foreground color of the graphic text (fc: front color)
(gt: graphic text)
Identifier.fc_st = Foreground color of the short text (fc: front color)
(st: short text)
Identifier.fc_ut = Foreground color of the unit text (fc: front color)
(ut: unit text)
Identifier.fs = Font size (fs: font size)
Identifier.gt = Graphic text (gt: graphic text)
Identifier.hlp = Help display (hlp: help)
Identifier.li = Limit (li: limit)
Identifier.lt = Long text (lt: long text)
Identifier.max = MAX limits (max: maximum)
Identifier.min = MIN limits (min: minimum)

Variables
5.11 Details on the variable type
Identifier.sc = Signal color (sc: signal color)

Identifier.st = Short text (st: short text)
Identifier.tg = Toggle symbol (tg: toggle)
Identifier.tt = Tooltip (tt: tooltip
Identifier .typ = Variable type (typ: type)
Identifier.ur = Update rate (ur: update rate)
Identifier.ut = Unit text (ut: unit text)
Identifier.val = Variable value (val: value)
Identifier.var = System or user variable (var: variable)
Identifier.vld = Variable status (vld: validation)
Identifier.wr = Input mode (wr: write)
See also
Extended configuration syntax (Page 36)
Variable type INTEGER

The following extensions for determining the display in the input/output field and the memory
utilization are possible for the "INTEGER" type:
2nd character in the extension data type
Display format
B Binary
D Decimal signed
H Hexadecimal
No data Decimal signed
3rd and/or 4th character in the extension data type
Memory utilization
B Byte
W Word
D Double word
BU Byte, Unsigned
WU Word, Unsigned
DU Double word, Unsigned

Variables
Sequence of characters in the INTEGER data type

1. "I" Basic INTEGER designation
2. Display format
3. Memory utilization
4. "U" Unsigned
Valid INTEGER type specifications:

IB Integer variable 32 bits in binary notation
IBD Integer variable 32 bits in binary notation
IBW Integer variable 16 bits in binary notation
IBB Integer variable 8 bits in binary notation
I Integer variable 32 bits in decimal notation signed
IDD Integer variable 32 bits in decimal notation signed
IDW Integer variable 16 bits in decimal notation signed
IDB Integer variable 8 bits in decimal notation signed
IDDU Integer variable 32 bits in decimal notation unsigned
IDWU Integer variable 16 bits in decimal notation unsigned
IDBU Integer variable 8 bits in decimal notation unsigned
IH Integer variable 32 bits in hexadecimal notation
IHDU Integer variable 32 bits in hexadecimal notation
IHWU Integer variable 16 bits in hexadecimal notation
IHBU Integer variable 8 bits in hexadecimal notation
VARIANT variable type

The VARIANT variable type is determined by the data type of the last value assignment. If the
assigned or entered value starts with '-', '+', '.' or a number ('0'-'9'), then the value is interpreted
as numeric. In all other cases as a string.
It can be scanned using the ISNUM or ISSTR functions. The VARIANT type is mainly suited
to the purpose of writing either variable names or numerical values to the NC code.
Programming
The data type of variables can be checked:
Syntax: ISNUM (VAR)

Parameter: VAR Name of the variable whose data type is to be checked.
FALSE = not a numerical variable (data type = STRING)
TRUE = numerical variable (data type = REAL)

Variables
Syntax: ISSTR (VAR)

Parameter: VAR Name of the variable whose data type is to be
checked.
FALSE = numerical variable (data type = REAL)
TRUE = not a numerical variable (data type = STRING)
Example:
IF ISNUM(VAR1) == TRUE
IF ISSTR(REG[4]+2) == TRUE
The display mode of variables can be changed:

● For INTEGER, the display type can be changed.
B Binary
D Decimal signed
H Hexadecimal
unsigned
With the addition of U for Unsigned
● For REAL data types, only the number of places after the decimal point can be changed.
Changing the type is illegal and generates an error message in the easyscreen_log.txt. file.
Example:
Var1.typ = "IBW"
Var2.typ = "R3"
Numerical formats
Numbers can be represented in either binary, decimal, hexadecimal or exponential notation:
Binary B01110110
Decimal 123.45
Hexadecimal HF1A9
exponential -1.23EX-3
Examples:
VAR1 = HF1A9
REG[0]= B01110110
DEF VAR7 = (R//-1.23EX-3)
Note
When codes are generated with the "GC" function, only numerical values in decimal or
exponential notation are evaluated, but not those in binary or hexadecimal notation.
See also

Variables
5.12 Details on the toggle field
5.12 Details on the toggle field
Description
The toggle field extension function displays texts (entries in toggle field) as a function of NC/
PLC variables. A variable, which makes use of a toggle field extension, is read-only. The list
of the toggle field is opened by pressing the ENTER key.
Programming
Syntax: DEF VAR1=(IB/+ $85000/15////"DB90.DBB5") or

DEF VAR_TGL = (S/* "Hello", "Run", "MyScreens"/"Run")
Description: When the dialog is opened, the content of text number $85015 is displayed in the
IO field. Default value 15 is entered in system variable DB90.DBB5. If the value
saved in system variable DB90.DBB5 changes, the displayed text number $(85000
+ <DB90.DBB5>) is recalculated in response to every change.
Parameter: Variable type Type of variables specified in the system or user variable.
Text number Number (basis) of the language-specific text valid as the
basis number.
System or user varia‐ System or user variable (offset) via which the final text
ble number (basis + offset) is displayed.
Toggle-field-dependent displays
The toggle field is overlaid with graphics, which change depending on the value of the memory
byte. If the value of the memory byte is 1, "image1.png" will appear. If it is 2, "image2.png" will
appear.
DEF VAR1=(IDB/*1="\\image1.png", 2="\\image2.png"//,$85000/wr1//"MB[130]"//160,40,50,50)
The size and position of the image is defined under "Position of IO field (left, top, width, height)".
Virtual toggle key

There is no list for toggle fields without configured list, e.g. DEF NoTglList=(R/*). The next
element is not generated until the toggle key is actuated or the associated CHANGE() method
of the corresponding variable run through.
For this case, a small virtual keyboard (comprising only a toggle key) is displayed on the right
next to the variable toggle field for operation with a touch panel.
The display of the virtual toggle key can also be forced via the following entry in the
configuration file slguiconfig.ini irrespective of a touch panel.
[VirtualKeyboard]

Variables
5.13 Details on the default setting
; Forces easyscreen virtual toggle keyboard function

ForceEasyscreenVirtualToggleKey = true
See also
5.13 Details on the default setting
Overview
A variable can assume various states depending on whether a default value, or a system or
user variable, or both, is assigned to the variable field (input/output field or toggle field), (not
calculated: toggling is only possible if a valid value has been assigned to the variable).
Scope of the default settings
Condition Reaction of field type

Field type Default setting System or user variable
I/O field Yes Yes Write default value to system or user variable
No Yes Use system or user variable as default value
Fault Yes Not calculated, system or user variable is not written/
used.
Yes No Default setting
No No Not calculated
Fault No Not calculated
Yes Fault Not calculated
No Fault Not calculated
Fault Fault Not calculated
Toggle Yes Yes Write default value to system or user variable
No Yes Use system or user variable as default value
Fault Yes Not calculated,
system or user variable not written/used
Yes No Default setting
No No Default = first toggle field element
Fault No Not calculated
Yes Fault Not calculated
No Fault Not calculated
Fault Fault Not calculated

Variables
5.14 Details on the position of the short text, position of the input/output field
See also
5.14 Details on the position of the short text, position of the input/output
field
Overview
The short text and graphic text, as well as the input/output field and unit text, are each treated
like a unit, i.e., position settings for short text apply to the graphic text and data for the input/
output field and to unit text.
Programming
The configured position entry overwrites the default value, i.e., only one value can be changed.
If no position settings have been configured for subsequent screen form elements, then the
position settings for the preceding screen form element are applied.
The default setting is used if positions are not specified for any of the dialog elements. The
column width for the short text and input-output field is calculated as standard for each line
from the number of columns and maximum line width, i.e. column width = maximum line width/
number of columns.
The width of the graphics and unit text is predefined and optimized to suit the requirements of
programming support. If graphics or unit text has been configured, the width of the short text
or I/O field is reduced accordingly.
The order of short text and I/O field can be reversed by position settings.
Distance between the input/output field and unit field and width of the unit field
You can configure the distance between an input/output field and a unit field as well as the
width of the unit field.
In the definition line, in the section for the input/output position, enter the distance from the
input/output field to the unit field, separated by a comma (e.g. 7 pixels) and/or the width of the
unit field (e.g. 60 pixels):
DEF VarDT=(R3//0.000/,"DT",,"s"////0,,24/39,,71,,7,60)
Or:
DEF VarDT={TYP="R3", VAL="0.000", ST="DT", UT="s", TXT_X=0,
TXT_W=24, X=39, W=71, UT_DX=7, UT_W=60}

Variables
5.15 Use of strings
In this case, the distance between the input/output field/unit field and/or the width of the unit
field have/has been configured and the following points should be taken into account:
● The configured width of the input/output field does not include the fixed width of the unit
field (this is fixed at 50 pixels). This means that you directly configure the width of the input/
output field.
● A 50 pixel width applies as default if a width is not configured for the unit field.
● 0 pixels applies as default if a distance is not configured between the input/output field /
unit field.
Special feature regarding the associated toggle field

Requirements:
● An associated toggle field is configured for a variable,
● For the variable, a distance is configured between the input/output field and unit field and/
or a width for the unit field, and
● The variable has no unit text.
In this particular case, the associated toggle field is positioned at the configured position of the
unit field of the variable.
A position possibly configured for the input/output component of the associated toggle field is
ignored.
Example
In the following example, the associated toggle field F_Unit is automatically set with a distance
of 7 pixels to the input/output field of variable VarF , and with a width of 59 pixels .
DEF VarF=(R//0.0/,"F",,,////0,,24/39,,85,,7,59///"F_Unit"), F_Unit =
(I/*3="mm/min", 1="mm/U"/3// ////181,,155)
See also
5.15 Use of strings
Strings
Strings can be used as part of the configuration. These allow text to be displayed dynamically
or different texts to be chained for the purpose of code generation.

Variables
5.15 Use of strings
Rules
The following rules must be observed with regard to string variables:
● Logic operations are processed from left to right.
● Nested expressions are solved from the inside outwards.
● No distinction is made between uppercase and lowercase type.
● String variables are generally displayed left justified.
Strings can be deleted simply by assigning a blank string.
Strings can be appended after the equality sign using the operator "<<". Quotation marks (")
in the string are represented by two successive quotation mark symbols. Strings can be
checked for equality in IF instructions.
Example
Default settings for the following examples:
VAR1.VAL = "This is an"
VAR8.VAL = 4
VAR14.VAL = 15
VAR2.VAL = "Error"
$85001 = "This is an"
$85002 = "Alarm text"
Editing strings:
● Chaining of strings:
VAR12.VAL = VAR1 << " Error." ;Result: "This is an error"
● Deleting a variable:
VAR10.VAL = "" ;Result: Blank string
● Setting a variable with a text variable:
VAR11.VAL = VAR1.VAL ;Result: "This is an"
● Data type matching:
VAR13.VAL ="This is the " << (VAR14 - VAR8) << ". error"
;Result: "This is the 11th error"
● Treatment of numerical values:
VAR13.VAL = "Error" << VAR14.VAL << ": " << $85001 << $85002
;Result: "Error 15: "This is an alarm text"
IF VAR15 == "Error" ;Strings in IF statement
VAR16 = 18.1234
;Result: VAR16 equals 18.1234,
;if VAR15 equals "Error".
ENDIF

Variables
5.17 CURVER variable
● Quotation marks within a string:

VAR2="Hello, this is a " Test""
;Result: Hello, this is a " Test"
● System or user-variable strings dependent on variable content:
VAR2.Var = "$R[" << VAR8 << "]" ;Result: $R[4]
See also
STRING functions (Page 155)
5.16 CURPOS variable
Description
The CURPOS variable calls or manipulates the position of the cursor in the active input field
of the current dialog. The variable shows how many characters are in front of the cursor. If the
cursor is located at the start of the input field, then CURPOS assumes the value of 0. If the
value of CURPOS is changed, then the cursor is positioned at the appropriate location in the
input field.
In order to be able to respond to changes in the variable value, it is possible to monitor for
changes using a CHANGE method. If the value of CURPOS changes, then a jump is made to
the CHANGE method and the instructions contained there are executed.
5.17 CURVER variable
Description
The CURVER (CURrent VERsion) property allows the programming to be adapted in order to
handle different versions. The CURVER variable is read-only.
Note
Even if previously recompiled with an older version, the code is automatically generated with
the most recent version. The "GC" command always generates the most recent version. An
additional identifier indicating the generated version is inserted in the user comment of the
generated code in versions > 0.
Rules
The most recent dialog with all its variables is always displayed.
● Variables used previously may not be changed.
● New variables are inserted in the existing (cycle) programming in arbitrary order.

Variables
5.18 ENTRY variable
● It is not permissible to delete variables from a dialog from one version to the next.
● The dialog must contain all variables of all versions.
Example
(IF CURVER==1 ...) ; When the code is recompiled, CURVER is automat-

ically assigned the version of the recompiled
code.
5.18 ENTRY variable
Description
The ENTRY variable can be used to check by what method a dialog has been called.
Programming
Syntax: ENTRY
Description: The ENTRY variable is a read only variable.
Return Value: The result of the scan can be:
0= No programming support
1= Start of a screen via softkey; no code has been generated yet (default
as configured)
2 = Start of a screen via softkey; code has been generated
(default from the code generated last by this screen)
3 = Recompilation with user comment (# lines)
4 = Code_type = 0: NC code with user comment (# lines)
5 = Code_type = 1: NC code without user comment (# lines)
Example
IF ENTRY == 0
DLGL ("The dialog was not called under programming")
ELSE
DLGL ("The dialog was called under programming")
ENDIF

Variables
5.20 FILE_ERR variable
5.19 ERR variable
Description
Variable ERR checks whether the preceding line has been executed correctly.
Programming
Syntax: ERR
Description: The ERR variable is read-only.
Return value: The result of the scan can be:
FALSE = previous line was executed error-free
TRUE = previous line was not executed error-free
Example
VAR4 = Thread[VAR1,"CDM",3] ; Output value from array

IF ERR == TRUE ; Query whether the value has been found in
the array
VAR5 = "Error accessing array"
; If the value has not been found in the ar-
ray, the value "Error accessing array" is as-
signed to the variables.
ELSE
VAR5 = "All OK" ; If the value has been found in the array,
the value "All OK" is assigned to the varia-
bles.
ENDIF
Description
Variable FILE_ERR can be used to check whether the preceding GC or CP command has
been executed correctly.
Programming
Syntax: FILE_ERR
Description: The FILE_ERR variable is read-only.

Variables
Return value: Possible results are:

0= Operation okay
1= Drive/path not available
2 = Path/file access error
3 = Drive not ready
4 = Incorrect file name
5 = File is already open
6 = Access denied
7 = Target path not available or not permitted
8 = Copy source same as target
10 = Internal error: FILE_ERR = 10 means that the error cannot be classified
in the other categories.
Example
CP("D:\source.mpf","E:\target.mpf")
; Copy from source.mpf to E:\tar-
get.mpf
IF FILE_ERR > 0 ; Query whether error has occurred
IF FILE_ERR == 1 ; Query specific error numbers and
output associated error text
VAR5 = "Drive/path not available"
ELSE
IF FILE_ERR == 2
VAR5 = "Path/file access error"
ELSE
IF FILE_ERR == 3
VAR5 = "incorrect file name"
ENDIF
ENDIF
ENDIF
ELSE
VAR5 = "All OK" ; If no errors have occurred in CP
(or GC), "All OK" is output
ENDIF

Variables
5.21 FOC variable
5.21 FOC variable
Description
With the variable FOC, the input focus (current active input/output field) is controlled in a dialog.
The reaction of the cursor left, right, up, down as well as PGUP, PGDN are predefined.
Note
The FOC function must not be initiated as a result of a navigation event. The cursor position
may only be changed in softkey PRESS methods, CHANGE methods, etc.
The FOC function cannot be applied to variables with input mode wr = 0 and wr = 4 or to Help
variables.
Programming
Syntax: FOC
Description: The variable can be read and written.
Return value: Read The result is the name of the variable to which the FOC func‐
tion has been applied.
Write It is possible to assign either a string or a numerical value. A
string is interpreted as a variable name and a numerical value
as a variable index.
Example
IF FOC == "Var1" ; Read focus

REG[1] = Var1
ELSE
REG[1] = Var2
ENDIF
FOC = "Var1" ; The input focus is assigned to variable 1.

FOC = 3 ; The input focus is assigned to the 3rd dialog ele-
ment with WR ≥ 2.
See also
FOCUS (Page 103)

Variables
5.23 S_CHAN variable
5.22 Variable S_ALEVEL
Description
The current access level can be queried in the configuration with the screen property
S_ALEVEL.
Programming
Syntax: S_ALEVEL
Description: Query of the current access level
Return value: 0: System
1: Manufacturer
2: Service
3: User
4: Key switch 3
5: Key switch 2
6: Key switch 1
7: Key switch 0
Example
REG[0] = S_ALEVEL
See also
ACCESSLEVEL (Page 100)
5.23 S_CHAN variable
Description
The S_CHAN variable determines the number of the current channel for display or evaluation
purposes.
Programming
Syntax: S_CHAN
Description: Query of the current channel number
Return value: Channel number

Variables
5.25 Variable S_LANG
Example
REG[0] = S_CHAN
See also
CHANNEL (Page 102)
5.24 Variable S_CONTROL
Description
The current control name can be queried in the configuration with the screen property
S_CONTROL.
Programming
Syntax: S_CONTROL
Description: Query of the current control name
Return value: The control name is the section name in the mmc.ini
Example
REG[0] = S_CONTROL
See also
CONTROL (Page 102)
5.25 Variable S_LANG
Description
The current language can be queried in the configuration with the screen property S_LANG.

Variables
5.27 Variables S_RESX and S_RESY
Programming
Syntax: S_LANG
Description: Query of the current language
Return value: Language code from resources.xml, e.g. "deu", "eng", etc.
Example
REG[0] = S_LANG
See also
LANGUAGE (Page 104)
5.26 Variable S_NCCODEREADONLY
Description
The screen property S_NCCODEREADONLY is only relevant when a cycle is recompiled in
the editor with a "Run MyScreens" dialog. S_NCCODEREADONLY determines whether a
recompiled NC code from the editor can be changed or not.
The following applies for the return value:
● TRUE: The recompiled NC code from the editor can be changed
● FALSE: The recompiled NC code from the editor cannot be changed (read-only), because,
for example, it is already in the preprocessing (= TRUE).
Description
The current resolution or its X and Y component can be queried in the configuration with the
screen properties S_RESX and S_RESY.
Example
REG[0] = S_RESY

Variables
See also
RESOLUTION (Page 109)

Variables

Programming commands 6
6.1 Operators
Overview
The following operators can be used when programming:
● Mathematical operators
● Relational operators
● Logic (Boolean) operators
● Bit operators
● Trigonometric functions
6.1.1 Mathematical operators
Overview
Mathematical operators Identifier

+ Addition
- Subtraction
* Multiplication
/ Division
MOD Modulo operation
() Parentheses
AND AND operator
OR OR operator
NOT NOT operator
ROUND Round off numbers with decimal places
Example: VAR1.VAL = 45 * (4 + 3)
ROUND
The ROUND operator is used to round off numbers with up to 12 decimal places during
execution of a dialog configuration. The variable fields cannot accept the decimal places in the
display.

Programming commands
6.1 Operators
Use
ROUND is controlled by the user with two parameters:
VAR1 = 5.2328543
VAR2 = ROUND( VAR1, 4 )
Result: VAR2 = 5.2339
VAR1 contains the number to be rounded. The parameter “4” indicates the number of decimal
places in the result, which is placed in VAR2.
Trigonometric functions
Trigonometric functions Identifier

SIN(x) Sine of x
COS(x) Cosine of x
TAN(x) Tangent of x
ATAN(x, y) Arc tangent of x/y
SQRT(x) Square root of x
ABS(x) Absolute value of x
SDEG(x) Conversion to degrees
SRAD(x) Conversion to radian
CALC_ASIN(x) Arc sine of x
CALC_ACOS(x) Arc cosine of x
Note
The functions operate with radian measure. The functions SDEG() and SRAD() can be used
for conversion.
Example: VAR1.VAL = SQRT(2)
Mathematical functions
Mathematical functions Identifier

CALC_CEIL(x) Determines the next highest integer of x (round up)
CALC_FLOOR(x) Determines the next lowest integer of x (round down)
CALC_LOG(x) Determines the (natural) logarithm for the base e of
x
CALC_LOG10(x) Determines the logarithm for the base 10 of x
CALC_POW(x, y) Determines x to the power of y
CALC_MIN(x, y) Determines the lower number of x and y
CALC_MAX(x, y) Determines the higher number of x and y

6.1 Operators
Random function: Random number
Syntax: RANDOM (lower limit value, upper limit value)

Description: The RANDOM function returns a pseudo random number in a specified range.
Parameters: Lower limit value Lower limit value >= -32767,
Lower limit value < upper limit value
Upper limit value Upper limit value <= 32767
Example
REG[0] = RANDOM(-10,10) ; Possible result = -3
Constants
Constants
PI 3.14159265358979323846
FALSE 0
TRUE 1
Example: VAR1.VAL = PI
Comparison operators
Comparison operators
== Equal to
<> Not equal to
> Greater than
< Less than
>= Greater than or equal to
<= Less than or equal to
Example:
IF VAR1.VAL == 1
VAR2.VAL = TRUE
ENDIF

6.1 Operators
Conditions
The nesting depth is unlimited.
Condition with one command: IF

...
ENDIF
Condition with two commands: IF
...
ELSE
...
ENDIF
6.1.2 Bit operators
Overview
Bit operators Identifier

BOR Bit-serial OR
BXOR Bit-serial XOR
BAND Bit-serial AND
BNOT Bit-serial NOT
SHL Shift bits to left
SHR Shift bits to right
SHL operator
Bits are shifted to the left using the SHL (SHIFT LEFT) operator. You can specify both the
value to be shifted and the number of shift increments directly or via a variable. If the limit of
the data format is reached, the bits are shifted beyond the limit without displaying an error
message.
Use
Syntax: variable = value SHLincrement

Description: Shift Left
Parameters: value value to be shifted
increment number of shift increments
Example
PRESS(VS1)

6.2 Methods
VAR01 = 16 SHL 2 ; Result = 64

VAR02 = VAR02 SHL VAR04 ; Convert content of VAR02 to 32-bit unsigned
, and shift content to left by number of bits specified
in VAR04. Then convert 32-bit value back to format of
variable VAR02.
END_PRESS
SHR operator
Bits are shifted to the RIGHT using the SHR (SHIFT RIGHT) function. You can specify both
the value to be shifted and the number of shift increments directly or via a variable. If the limit
of the data format is reached, the bits are shifted beyond the limit without displaying an error
message.
Use
Syntax: variable = value SHRincrement

Description: Shift Right
Parameters: value value to be shifted
increment number of shift increments
Example
PRESS(VS1)
VAR01 = 16 SHR 2 ; Result = 4
VAR02 = VAR02 SHR VAR04 ; Convert content of VAR02 to 32-bit unsigned
, and shift content to right by number of bits
specified in VAR04. Then convert 32-bit value back
to format of variable VAR02.
END_PRESS
6.2 Methods
Overview
Various types of event (exit input field, actuate softkey) can initiate specific actions in dialogs
and dialog-dependent softkey menus (softkey menus that are called from a newly configured
dialog). These actions are configured in methods.

6.2 Methods
The following table shows the basic principle used to program a method:
Definition block Comment Chapter reference

PRESS(HS1) ;Method start identifier
LM... ;Functions See chapter "Functions"
LS...
Var1.st = ... ;Changing properties see chapter "Softkey menu"
and chapter "Dialog elements"
Var2 = Var3 + Var4 ;Calculation with variables See chapter "Defining variables"
...
EXIT
6.2.1 ACCESSLEVEL
Description
The ACCESSLEVEL method is run through when the current access level has changed for
an opened screen.
Programming
Syntax: ACCESSLEVEL
<instructions>
END_ACCESSLEVEL
Description: Access level
Parameters: - None -
See also
Variable S_ALEVEL (Page 90)
6.2.2 CHANGE
Description
CHANGE methods are executed if a variable value changes, i.e., variable calculations that
are performed as soon as a variable value changes are configured within a CHANGE method.

6.2 Methods
There are two types of CHANGE method, i.e., element-specific and global:
● The element-specific CHANGE method is executed if the value of a specified variable
changes. If a system or user variable is assigned to a variable, cyclic updating of the variable
value can be configured in a CHANGE method.
● The global CHANGE method is executed if the value of any variable changes and no
element-specific CHANGE method has been configured.
"Element-specific" programming
Syntax: CHANGE(Identifier)
...
END_CHANGE
Description: Changes the value of a specific variable
Parameters: Identifier Name of the variable
Example
DEF VAR1=(I//////"DB20.DBB1") ; A system variable is assigned to Var1

CHANGE(VAR1)
IF VAR1.Val <> 1
VAR1.st="Tool OK!" ; If the value of the system variable ≠ 1, the
short text of the variable states: Tool OK!
otto=1
ELSE
VAR1.st="Attention: Error!" ; If the value of the system variable = 1, the
short text of the variable states: Attention:
Error!
otto=2
ENDIF
VAR2.Var=2
END_CHANGE
"Global" programming
Syntax: CHANGE()
...
END_CHANGE
Description: Changes any variable value

6.2 Methods
Example
CHANGE()
EXIT ; If any of the variable values change, the di-
alog will be terminated.
END_CHANGE
See also
Behavior when opening the dialog (attribute CB) (Page 240)
6.2.3 CHANNEL
Description
The CHANNEL method is run through when the current channel has changed for an opened
screen, i.e. a channel switchover has been performed.
Programming
Syntax: CHANNEL
<instructions>
END_CHANNEL
Description: Channel switchover
See also
S_CHAN variable (Page 90)
6.2.4 CONTROL
Description
The CONTROL method is run through when the current control has changed for an opened
screen, i.e. typically at a 1:n switchover.

6.2 Methods
Programming
Syntax: CONTROL
<instructions>
END_CONTROL
Description: Control switchover
See also
Variable S_CONTROL (Page 91)
6.2.5 FOCUS
Description
The FOCUS method is executed if the focus (cursor) is positioned on another field in the dialog.
The FOCUS method must not be initiated as a result of a navigation event. The cursor position
may only be changed in softkey PRESS methods, CHANGE methods, etc. The response of
cursor movements is predefined.
Note
Within the FOCUS method, it is not possible to select a different variable, nor can a new dialog
be loaded.
Programming
Syntax: FOCUS
...
END_FOCUS
Description: Positions the cursor
Example
FOCUS
DLGL("The focus has been placed on variable << FOC << ".)
END_FOCUS

6.2 Methods
See also
FOC variable (Page 89)
6.2.6 LANGUAGE
Description
The LANGUAGE method is run through when the current language has changed for an opened
screen.
Programming
Syntax: LANGUAGE
<instructions>
END_LANGUAGE
Description: Language
See also
Variable S_LANG (Page 91)
6.2.7 LOAD
Description
The LOAD method is executed after the variable and softkey definitions (DEF Var1= ...,
HS1= ...) have been interpreted. At this time, the dialog is not yet displayed.
Programming
Syntax: LOAD
...
END_LOAD
Description: Download
Example
LOAD ; Start identifier

6.2 Methods
Screen form1.Hd = $85111 ; Assign text for dialog header from language file
VAR1.Min = 0 ; Assign MIN variable limit
VAR1.Max = 1000 ; Assign MAX variable limit
END_LOAD ; End code
See also
Line, dividing line, rectangle, circle and ellipse (Page 167)
6.2.8 UNLOAD
Description
The UNLOAD method is executed before a dialog is unloaded.
Programming
Syntax: UNLOAD
...
END_UNLOAD
Description: Unload
Example
UNLOAD
REG[1] = VAR1 ; Save variable in register
END_UNLOAD

6.2 Methods
6.2.9 OUTPUT
Description
The OUTPUT method is executed if the "GC" function is called. Variables and Help variables
are configured as an NC code in an OUTPUT method. The individual elements in a code line
are linked by means of blanks.
Note
The NC code can be generated in an extra file by means of file functions and transferred to
the NC.
Programming
Syntax: OUTPUT (Identifier)

...
END_OUTPUT
Description: Outputs variables in the NC program.
Parameters: Identifier Name of OUTPUT method
Block numbers and skip identifiers

The OUTPUT method must not contain line numbers or skip identifiers if you wish to keep the
line numbers and skip identifiers directly set with active program support in the parts program
in case of recompilations.
Editor changes in the parts program produce the following response:
Condition Response
Number of blocks remains unchanged. Block numbers are retained.
Number of blocks is reduced. The highest block numbers are canceled.
Number of blocks is increased. New blocks are not numbered.
Example
OUTPUT(CODE1)
"CYCLE82(" Var1.val "," Var2.val "," Var3.val ","Var4.val "," Var5.val ","
Var6.val ")"
END_OUTPUT

6.2 Methods
6.2.10 PRESS
Description
The PRESS method is executed when the corresponding softkey is pressed.
Programming
Syntax: PRESS(softkey)
...
END_PRESS
Designation: Pressing a softkey
Parameter: Softkey Name of softkey: HS1 - HS8 and VS1 - VS8
RECALL <RECALL> key
ENTER For the <ENTER> key, see PRESS(ENTER) (Page 108)
TOGGLE For the <TOGGLE> key, see PRESS(TOGGLE) (Page 108)
PU Page Up Screen up
PD Page Down Screen down
SL Scroll left Cursor left
SR Scroll right Cursor right
SU Scroll up Cursor up
SD Scroll down Cursor down
Example
HS1 = ("another softkey menu")

HS2=("no function")
PRESS(HS1)
LS("Menu1") ; Load another softkey menu
Var2 = Var3 + Var1
END_PRESS
PRESS (HS2)
END_PRESS
PRESS(PU)
INDEX = INDEX -7
CALL("UP1")
END_PRESS

6.2 Methods
6.2.11 PRESS(ENTER)
Description
The PRESS(ENTER) method is always called when the Enter key is pressed for a variable
with input/output field with input mode WR3 or WR5:
● WR3: Navigation to field and pressing of the Enter key
● WR5: In the input mode, transfer of the value with the Enter key
Programming
Syntax: PRESS(ENTER)
<instructions>
END_PRESS
Description: Enter key pressed
6.2.12 PRESS(TOGGLE)
Description
The PRESS(TOGGLE) method is always called when the toggle key is pressed irrespective
of the currently focused variable.
When required, the FOC screen property can be used to determine which variable is currently
in focus.
Programming
Syntax: PRESS(TOGGLE)
<instructions>
END_PRESS
Description: Toggle key pressed
Parameter: - None -
Example
PRESS(TOGGLE)
DLGL("Toggle key pressed at variable " << FOC) ; The FOC screen property determines which
variable is currently in focus
END_PRESS

6.2 Methods
6.2.13 RESOLUTION
Description
The RESOLUTION method is run through when the current resolution has changed for an
opened screen, i.e. typically at a TCU switchover.
Programming
Syntax: RESOLUTION
<instructions>
END_RESOLUTION
Description: Resolution
See also
Variables S_RESX and S_RESY (Page 92)
6.2.14 RESUME
Description
The RESUME method is called when the screen was interrupted, e.g. for an area change, and
is now shown again. The value changes are processed again, if required, the timers started
and the RESUME block executed.
Programming
Syntax: RESUME
<instruction>
END_RESUME
Description: Screen active again

6.2 Methods
6.2.15 SUSPEND
Description
The SUSPEND method is called when the screen is interrupted and not unloaded. This is the
case, for example, when the screen is exited by a simple area change, but not explicitly
unloaded. The screen is retained in the background, but no value change or timers are
processed. The screen is paused.
Programming
Syntax: SUSPEND
<instruction>
END_SUSPEND
Description: Interruption of the screen
Example
SUSPEND
MyVar1 = MyVar1 + 1
END_SUSPEND
6.2.16 Example: Version management with OUTPUT methods
Overview
Additional variables can be added to existing dialogs when expanding the user interface. A
version identifier in parentheses is appended to the additional variables in the definition
following the variable name: (0 = Original, is not written), 1 = Version 1, 2 = Version 2, etc.
Example:
DEF var100=(R//1) ; Original, corresponds to Version 0

DEF var101(1)=(S//"Hello") ; Extension as of Version 1
When writing the OUTPUT method, you can specify which variables are written, with reference
to a particular version identifier.
Example:
OUTPUT(NC1) ; Only the variables of the original are offered in

the OUTPUT method.

6.2 Methods
OUTPUT(NC1,1) ; The variables of the original and the extensions

with version identifier 1 are offered in the OUTPUT
method.
The OUTPUT method for the original does not need a version identifier, however you can
specify it with 0. OUTPUT(NC1) is equivalent to OUTPUT(NC1,0). Version identifier n in the
OUTPUT method includes all variables of the originals 0, 1, 2, ... up to and including n.
Programming with version identifier
//M(XXX) Version 0 (default)

DEF var100=(R//1)
DEF var101=(S//"Hello")
DEF TMP
VS8=("GC")
PRESS(VS8)
GC("NC1")
END_PRESS
OUTPUT(NC1)
var100",,"var101
END_OUTPUT
; ************ Version 1, extended definition ***************

//M(XXX)
DEF var100=(R//1)
DEF var101=(S//"Hello")
DEF var102(1)=(V//"HUGO")
DEF TMP
VS8=("GC")
PRESS(VS8)
GC("NC1")
END_PRESS
...
OUTPUT(NC1) Original and the new version in addition

var100","var101
END_OUTPUT
...
OUTPUT(NC1,1) Version 1
var100","var101"," var102
END_OUTPUT

6.3 Functions
6.3 Functions
Overview
A variety of functions are available in dialogs and dialog-dependent softkey menus. These can
be activated by specific events (exit input field, actuate softkey) and configured in methods.
Subprograms
Repeatedly used configuring instructions or others, which define the process for a particular
operation can be configured in subprograms. Subprograms can be loaded into the main
program or other subprograms at any time and executed as often as necessary, i.e. the
instructions they contain do not need to be configured repeatedly. The definition blocks of the
dialogs/softkey menu constitute a main program.
External functions
Additional, user-specific functions can be integrated by means of external functions. The
external functions are stored in a DLL file and identified by an entry in the definition lines of
the configuration file.
PI services
The PI_START function starts PI Services (Program Invocation Services) from the PLC in the
NC area.
See also
Function (FCT) (Page 131)
PI services (Page 145)
6.3.1 Reading and writing drive parameters: RDOP, WDOP, MRDOP
Description
You can read and write drive parameters using RDOP, WDOP and MRDOP functions.
Note
Do not read drive parameters faster than in a 1 second cycle, slower is better.
Reason: The communication with the drives can otherwise be extremely disturbed or even
cause failures.

6.3 Functions
Note
If errors occur when reading and writing drive parameters, the screen property ERR is set
appropriately.
Programming
Syntax: RDOP("Identifier of the drive object", "Parameter number")

Description: Reading a drive parameter (Drive Object Parameter)
Parameter: Identifier of the drive object The identifier of the drive object
can be found in the "DO name"
column in "Drive system diag‐
nostics" in the diagnostics oper‐
ating area ( > ETC > HSK 8: drive
system) (see diagram below).
Parameter number
Figure 6-1 Identifier of the drive object
Syntax: MRDOP("Identifier of the drive object", "Parameter number1"*"Pa‐

rameter number"[*…], Register index)
Description: Multi-read of drive parameters.
The MRDOP command transfers several drive parameters or drive
objects in a single register access. This access method is signifi‐
cantly faster than reading via individual access attempts.

6.3 Functions
can be taken, for example, from
the root screen of the "Setup" op‐
erating area.
Parameter number1 ... n In the variable names, "*" is the
separator. The values are trans‐
ferred to register REG[Register
index] in the order that the varia‐
ble names appear
in the command.
Register index The value of the first variable is
located in REG[Register index].
The value of the second variable
is located in REG[Register index
+ 1]
Syntax: WDOP("Identifier of the drive object", "Parameter number", Value)

Description: Writing a drive parameter (Drive Object Parameter)
can be taken, for example, from
the root screen of the "Setup" op‐
erating area.
Parameter number Parameter number
Value Value to be written
Examples
Read motor temperature r0035 of drive object "SERVO_3.3:2":
MyVar=RDOP("SERVO_3.3:2","35") ;
Read motor temperature r0035 and actual torque value r0080 of drive object "SERVO_3.3:2"
and store the respective results as of register index 10:
MRDOP("SERVO_3.3:2","35*80",10)
6.3.2 Subprogram call (CALL)
Description
The CALL function calls a loaded subprogram from any point in a method. Subprogram nesting
is supported, i.e. you can call a subprogram from another subprogram.

6.3 Functions
Programming
Syntax: CALL("Identifier")
Description: Subprogram call
Parameter: Identifier Name of subprogram
Example
//M(SCREEN FORM1)
DEF VAR1 = ...
DEF VAR2 = ...
CHANGE(VAR1)
...
CALL("MY_UP1") ; Call subprogram and execute
...
END_CHANGE
CHANGE(VAR2)
...
CALL("MY_UP1") ; Call subprogram and execute
...
END_CHANGE
SUB(MY_UP1)
;Do something
END_SUB
//END
6.3.3 Define block (//B)
Description
In the program file, subprograms are identified by the block identifier //B and terminated with //
END. Several subprograms can be defined under each block identifier.
Note
The variables used in the subprogram must be defined in the dialog in which the subprogram
is called.

6.3 Functions
Programming
A block is structured in the following way:
Syntax: //B(Block name)

SUB(Identifier)
END_SUB
[SUB(Identifier)
...
END_SUB]
...
//END
Description: Defines a subprogram
Parameters: Block name Name of block identifier
Identifier Name of subprogram
Example
//B(PROG1) ; Block start

SUB(UP1) ; Start of subprogram
...
REG[0] = 5 ; Assign value 5 to register 0
...
END_SUB ; End of subprogram
IF VAR1.val=="Otto"
VAR1.val="Hans"
RETURN
ENDIF
VAR1.val="Otto"
//END ; Block end
6.3.4 Check Variable (CVAR)
Description
You can use the CVAR (CheckVariable) function to run a scan to ascertain whether all or only
certain variables or Help variables in a screen form are error-free.
It may be useful to check if variables contain a valid value before an NC code with the GC
function.
A variable is error-free if the state of the variable Identifier.vld = 1.

6.3 Functions
Programming
Syntax: CVAR(VarN)
Description: Checks variables for valid content
Parameters: VarN List of variables to be checked.
Up to 29 variables, each separated by a comma, can be
checked. A character length of 500 must not be exceeded.
1 = TRUE (all variables have valid content)
0 = FALSE (at least one variable has invalid content)
Example
IF CVAR == TRUE ; Check all variables

VS8.SE = 1 ; If all variables are error-free, soft-
key VS8 is visible
ELSE
VS8.SE = 2 ; If a variable has an invalid value,
softkey VS8 is disabled
ENDIF
IF CVAR(”VAR1”, ”VAR2”) == TRUE

; Check variables VAR1 and VAR2
DLGL ("VAR1 and VAR2 are OK")
; If the values of VAR1 and VAR2 are er-
ror-free, "VAR1 and VAR2 are OK" appears
in the dialog line
ELSE
DLGL ("VAR1 and VAR2 are not OK")
; If the values of VAR1 and VAR2 are in-
valid, "VAR1 and VAR2 are not OK" appears
in the dialog line
ENDIF
6.3.5 CLEAR_BACKGROUND
Description
The CLEAR_BACKGROUND function deletes the LINE, RECT, ELLIPSE, V_SEPARATOR
and H_SEPARATOR graphic elements.
See also
Line, dividing line, rectangle, circle and ellipse (Page 167)

6.3 Functions
6.3.6 Copy Program file function (CP)
Description
The CP (Copy Program) function copies files within the HMI file system or within the NC file
system.
Programming
Syntax: CP("Source file", "Target file")

Description: Copies a file
Parameter: Source file Complete path to the source file
Target file Complete path data of the target file
The return value (VAR1 defined as help variable) queries whether the function was successful:
CP("//NC/MPF.DIR/HOHO.MPF","//NC/MPF.DIR/ASLAN.MPF",VAR1)
Example
Application with return value:
CP("//NC/MPF.DIR/HOHO.MPF","//NC/MPF.DIR/ASLAN.MPF",VAR1)
CP("CF_CARD:/wks.dir/MESS_BILD.WPD/MESS_BILD.MPF","//NC/WKS.DIR/AAA.WPD/HOHO2.MPF",VAR1)
CP("//NC/MPF.DIR/HOHO.MPF","//NC/MPF.DIR/ASLAN.MPF") ; WPD must exist
Application without return value:
CP("//NC/MPF.DIR/HOHO.MPF","//NC/MPF.DIR/ASLAN.MPF")
CP("CF_CARD:/mpf.dir/MYPROG.MPF","//NC/MPF.DIR/HOHO.MPF")
CP("//NC/MPF.DIR/HOHO.MPF","CF_CARD:/XYZ/MYPROG.MPF") ; XYZ must exist
See also
Support of FILE_ERR: FILE_ERR variable (Page 87)
6.3.7 Delete Program file function (DP)
Description
The DP (Delete Program) function deletes a file from the passive HMI or active NC file system.

6.3 Functions
Programming
Syntax: DP("File")
Description: Delete file
Parameter: File Complete path name of file to be deleted
Example
The following data management syntax is used for this function:
● With return value

DP("//NC/MPF.DIR/MYPROG.MPF",VAR1)
DP("//NC/WKS.DIR/TEST.WPD/MYPROG.MPF",VAR1)
DP("//NC/CMA.DIR/MYPROG.SPF",VAR1)
VAR1 = 0 File was deleted.
VAR1 = 1 File was not deleted.
● Without return value:
DP("//NC/MPF.DIR/MYPROG.MPF")
DP("//NC/WKS.DIR/TEST.WPD/MYPROG.MPF")
DP("//NC/CMA.DIR/MYPROG.SPF")
6.3.8 Exist Program file function (EP)
Description
The EP (Exist Program) function checks whether a particular NC program is stored on the
specified path in the NC or HMI file system.
Programming
Syntax: EP("File")
Description: Checks the existence of the NC program
Parameter: File Complete path to the file in the NC or HMI file system
Return value: Name of a variable to which the result of the scan should be assigned
The EP function can handle the new syntax and the old logic (with adapted syntax).
The file is directly addressed using a qualifying name:
//NC/MPF.DIR/XYZ.MPF
or
CF_CARD: /MPF.DIR/XYZ.MPF (points to /user/sinumerik/data/prog)
or
LOC: (corresponds to CF_CARD)

6.3 Functions
Examples of new syntax:
EP("//NC/WKS.DIR/TEST.WPD/XYZ.MPF",VAR1)
EP("CF_CARD:/mpf.dir/XYZ.MPF",VAR1)
EP("LOC:/mpf.dir/XYZ.MPF",VAR1)
; With return value:
; VAR1 = 0 File exists.
; VAR1 = 1 File does not exist.
Example of old syntax:
EP("/MPF.DIR/CFI.MPF", VAR1)
; VAR1 = M File is located in the HMI file system.
; VAR1 = N File is located in the NC file system.
; VAR1 = B File is located in the HMI and the NC file system.
Example
EP("/MPF.DIR/GROB.MPF",VAR1) ; Old - path now with / instead of \
IF VAR1 == "M"
DLGL("File is located in the HMI file system")
ELSE
IF VAR1 == "N"
DLGL("File is located in the NC file directory")
ELSE
DLGL("File is located neither in the HMI nor in the NC
file system")
ENDIF
ENDIF
6.3.9 Move Program file function (MP)
Description
The MP (Move Program) function copies files within the HMI file system or within the NC file
system.

6.3 Functions
Programming
Syntax: MP("source", "target")

MP("CF_CARD:/MPF.DIR/MYPROG.MPF","//NC/MPF.DIR")
Description: Move file
Parameter: Source file Complete path data
Target file Complete path data
Return value Result of the query
Examples
With return value:
MP("//NC/MPF.DIR/123.MPF","//NC/MPF.DIR/ASLAN.MPF",VAR1) ;Within NC
MP("//NC/MPF.DIR/123.MPF",VAR0,VAR1) ;Target via variable
MP(VAR4,VAR0,VAR1) ;Source and target via variable
MP("CF_CARD:/mpf.dir/myprog.mpf","//NC/MPF.DIR/123.MPF",VAR1) ;From CF card to NC
MP("//NC/MPF.DIR/HOHO.MPF","CF_CARD:/XYZ/123.mpf",VAR1) ;From NC to CF card

; VAR1 = 0 Executed
; VAR1 = 1 Not executed
6.3.10 Select Program file function (SP)
Description
The SP (Select Program) function selects a file in the active NC file system for execution, i.e.
the file must be loaded into the NC beforehand.
Programming
Syntax: SP("File")
Designation: Select program
Parameter: "File" Complete path name of NC file
Example
The following data management syntax is used for this function:
● With return value

SP("//NC/MPF.DIR/MYPROG.MPF", VAR1)
VAR1 = 0 File was loaded.

6.3 Functions
VAR1 = 1 File was not loaded without return value.

● Without return value:
SP("//NC/MPF.DIR/MYPROG.MPF")
6.3.11 File accesses: RDFILE, WRFILE, RDLINEFILE, WRLINEFILE
Description
The RDFILE and WRFILE functions are available for read and write access to files with INI
syntax.
The RDLINEFILE and WRLINEFILE functions are available for read and write access to
individual lines of a file.
Programming
Syntax: RDFILE("File name + path", "Section", "Key")

Description: Reading from a file
Parameter: File name + path Path and file name
Section Section in the INI file
Key Key in the INI file
Syntax: WRFILE(Value, "File name + path", "Section", "Key")

Description: Writing to a file
Parameter: Value Value to be written
File name + path Path and file name
Section Section in the INI file
Key Key in the INI file
Syntax: RDLINEFILE("File name + path", Line number)

Description: Reading a line from a file
Parameter: File name + path Path and file name
Line number Line number
Numbering begins at 0 for the
first line.
Syntax: WRLINEFILE(Value, "File name + path")

Description: Writing of a line at the end of a file

6.3 Functions
Parameter: Value Value to be written

File name + path Path and file name
Note
● The files must not be in the file system of the NC (data management).
● If the file does not exist, or the end of the file is reached or other errors occur, the variables
FILE_ERR and ERR are set accordingly. You can check whether a file exists first with the
Exist Program (EP) file function.
● The processed file is generated in "UTF-8" coding (without BOM (Byte Order Mask). When
reading a file, it is expected in "UTF-8" coding.
● You can delete the file explicitly when required with the Delete Program (DP) file function.
Examples
Reading from an INI file:

Requirement/assumption:
Content of file C:/tmp/myfile.ini:
<…>
[MyData]
MyName=Daniel
<…>
MyVar = RDFILE("C:/tmp/myfile.ini", "MyData", "MyName")
Result:
MyVar now contains the value "Daniel".
Writing to an INI file:

VARS=12
WRFILE(VARS, "C:/tmp/myfile.ini", "MySession", "NrOfSessions")
Result:
Content of file C:/tmp/myfile.ini:
<…>
[MySession]
NrOfSessions=12
<…>

6.3 Functions
Reading the 4th line of a file:

Content of c:/tmp/myfile.mpf:
R[0]=0
F3500 G1
MYLOOPIDX1: X0 y-50 Z0
X150 Y50 Z10
R[0]=R[0]+1
GOTOB MYLOOPIDX1
M30
MyVar = RDLINEFILE("C:/tmp/myfile.mpf", 4)
Result:
MyVar now contains the value " R[0]=R[0]+1"
Writing at the end of a file:

VARX=123
VARY=456
WRLINEFILE("F100 X" << VARX << " Y" << VARY, "C:/tmp/mypp.mpf")
Result:
Content of c:/tmp/mypp.mpf:
<…>
F100 X123 Y456
6.3.12 Dialog line (DLGL)
Description
It is possible to configure short texts (messages or input tips) for output in the dialog line of the
dialog in response to certain situations.
Possible number of characters in the default font size: approx. 50

6.3 Functions
Programming
Syntax: DLGL("String")
Description: Outputs text in the dialog line
Parameter: String Text, which is displayed in the dialog line
Example
IF Var1 > Var2

; The text "Value too large!" appears in the dialog
line if variable1 > variable2.
DLGL("Value too large!")
ENDIF
6.3.13 DEBUG
Description
The DEBUG function provides an analysis help during the draft phase of Run MyScreen user
screens. An expression in brackets transferred with the DEBUG function is evaluated during
runtime. The result is attached to the "easyscreen_log.txt" logbook as a separate entry.
Each entry has the current time stamp in square brackets as prefix (see example below).
It is recommended that the DEBUG outputs are removed in time-critical parts when possible.
Particularly after completing the draft phase, it is recommended that you comment out the
DEBUG outputs. The write access to the constantly expanding "easyscreen_log.txt" logbook
may slow down the processing.
Programming
Syntax: DEBUG(expression))
Description: Makes an entry in the "easyscreen_log.txt" logbook
Parameter: Expression to be evaluated from which an entry is generated in the logbook
Example
IF Var1 > Var2

DEBUG("Value of ""Var1"": " << Var1)
; Entry in the "easyscreen_log_txt:
[10:22:40.445] DEBUG: Value of "Var1":
123.456
ENDIF

6.3 Functions
6.3.14 Exit dialog (EXIT)
Description
The EXIT function is used to exit a dialog and return to the master dialog. If no master dialog
is found, you will exit the newly configured user interfaces and return to the standard application.
Programming (without parameters)
Syntax: EXIT
Description: Exits a dialog
Example
PRESS(HS1)
EXIT
END_PRESS
Description
If the current dialog has been called with a transfer variable, the value of the variables can be
changed and transferred to the output dialog.
The variable values are each assigned to the variables transferred from the output dialog to
the subsequent dialog using the "LM" function. Up to 20 variable values, each separated by a
comma, can be transferred.
Note
The sequence of variables or variable values must be the same as the sequence of transfer
values programmed for the LM function to preclude assignment errors. Any unspecified
variable values will not be changed when the transfer is made. The modified transfer variables
are immediately valid in the output dialog on execution of the LM function.
Programming with a transfer variable
Syntax: EXIT[(VARx)]
Description: Exits the dialog and transfers one or more variables
Parameters: VARx Label variables

6.3 Functions
Example
//M(Screen form1)
...
PRESS(HS1)
LM("SCREEN FORM2","CFI.COM",1, POSX,
POSY, DIAMETER)
; Interrupt screen form1 and open screen
form2. In doing this, transfer variables
POSX, POSY and DIAMETER.
DLGL("Screen form2 ended") ; After returning from screen form2, the
following text appears in the dialog line
of screen form1: Screen form2 ended.
END_PRESS
...
//END
//M(Screen form2)
...
PRESS(HS1)
EXIT(5, , CALCULATED_DIAMETER)
; Exit screen form2 and return to screen
form1 in the line after LM. In doing
this, assign the value 5 to the variable
POSX and the value of the CALCULATED_DI-
AMETER variable to the DIAMETER variable.
The variable POSY retains its current val-
ue.
END_PRESS
...
//END
6.3.15 Dynamic manipulation of the lists of toggle fields or list box fields
Description
The LISTADDITEM, LISTINSERTITEM, LISTDELETEITEM and LISTCLEAR functions are
used for the dynamic manipulation of the lists of toggle fields or list box fields.
These functions only have an effect on variables that have their own list, such as:
● "Simple" list
DEF VAR_AC1 = (I/* 0,1,2,3,4,5,6,7,8) or
● "Extended" list
DEF VAR_AC2 = (I/* 0="AC0", 1="AC1", 2="AC2", 3="AC3", 4="AC4",
5="AC5", 6="AC6", 7="AC7", 8="AC8").

6.3 Functions
If the variable points to an array, e.g. DEF VAR_AC3 = (I/* MYARRAY), these functions
are not available as otherwise the global array would be changed.
At least one value must be defined for the variable in the DEF line. This specifies the "Simple"
or "Extended" list type.
However, the list can then be completely deleted and, if required, completely rebuilt. The
"Simple" or "Extended" type must be retained however, it cannot be changed dynamically.
Programming
Syntax: LISTINSERTITEM(Variable name, Position, ItemValue[, ItemDisp‐

Value])
Description: Inserts an element at a specific position; reading from a file
Parameter: Variable name
Position Position at which an element is
to be inserted in the list
ItemValue Value of the list entry
ItemDispValue Value as it is to be displayed in
the list
Syntax: LISTADDITEM(Variable name, ItemValue[, ItemDispValue])

Description: Adds an element to the end of the list
ItemValue Value of the list entry
ItemDispValue Value as it is to be displayed in
the list
Syntax: LISTDELETEITEM(Variable name, Position)

Description: Deletes a specific element
Position Position of the element to be de‐
leted in the list
Syntax: LISTCOUNT(Variable name)

Description: Returns the current number of elements in the list
Syntax: LISTCLEAR(Variable name)

Description: Deletes the complete list

6.3 Functions
Examples
Note
The following examples build upon each other. The sequence of the examples is relevant in
order to understand the respective results.
DEF VAR_AC = (I/* 0="Off",1="On"/1/,"Switch"/WR2)
Adding an element -1="Undefined" to the end of the list:

LISTADDITEM("VAR_AC", -1, """Undefined""")
Result: 0="Off", 1="On", -1="Undefined"
Inserting an element 99="Maybe" at position 2:

LISTINSERTITEM("VAR_AC", 2, 99, """Maybe""")
Result: 0="Off", 1="On", 99="Maybe", -1="Undefined"
Determining the current number of list elements:

REG[10]=LISTCOUNT("VAR_AC")
Result: REG[10] = 4
Deleting the element at position 1:

LISTDELETEITEM("VAR_AC", 1)
Result: 0="Off", 99="Maybe", -1="Undefined"
Deletion of the complete list:

LISTCLEAR("VAR_AC")
Result: List is empty

6.3 Functions
6.3.16 Evaluate (EVAL)
Description
The EVAL function evaluates a transferred expression and then executes it. With this function,
expressions can be programmed during runtime. This can be useful, for example, for indexed
access operations to variables.
Programming
Syntax: EVAL(exp)
Description: Evaluates an expression
Parameters: exp Logic expression
Example
VAR1=(S)
VAR2=(S)
VAR3=(S)
VAR4=(S)
CHANGE()
REG[7] = EVAL("VAR"<<REG[5]) ; The expression in parentheses produces VAR3 if the
value of REG[5] is equal to 3. The value of VAR3 is,
therefore, assigned to REG[7].
IF REG[5] == 1
REG[7] = VAR1
ELSE
IF REG[5] == 2
REG[7] = VAR2
ELSE
IF REG[5] == 3
REG[7] = VAR3
ELSE
IF REG[5] == 4
REG[7] = VAR4
ENDIF
ENDIF
ENDIF
ENDIF
END_CHANGE

6.3 Functions
6.3.17 Exit Loading Softkey (EXITLS)
Description
You can use the EXITLS function to exit the current user interface and load a defined softkey
menu.
Programming
Syntax: EXITLS("Softkey menu"[, "Path"])

Description: Exits dialog and loads a softkey menu
Parameters: Softkey menu Name of the softkey menu to be loaded
Path name Directory path of the softkey menu to be loaded
Example
PRESS(HS1)
EXITLS( "Menu1", "AEDITOR.COM" )
END_PRESS
6.3.18 Function (FCT)
Description
The external functions are stored in a DLL file and identified by an entry in the definition lines
of the configuration file.
Note
The external function must have at least one return parameter.
Programming
Syntax: FCTFunction name = ("File"/Type of return/Types of permanent parameters/

Types of variable parameters)
FCT InitConnection = ("c:\tmp\xyz.dll"/I/R,I,S/I,S)
Description: An external function can, for example, be called from the LOAD method or exe‐
cuted in the PRESS method.

6.3 Functions
Parameters: Function name Name of external function

File Complete path to DLL file
Type of return Data type of the return value
Type of fixed parame‐ Value parameter
ter
Type of variable pa‐ Reference parameter
rameter
The data types are separated by commas.
The external function can, for example, be called from the LOAD method or executed in the
PRESS method.
Example:
press(vs4)
RET = InitConnection(VAR1,13,"Servus",VAR2,VAR17)
end_press
Structure of the external function

The external function must take into account a certain, specific signature:
Syntax: extern "C" dllexport void InitConnection (ExtFctStructPtr FctRet, ExtFctStructPtr

FctPar, char cNrFctPar)
Description: DLL export, only when implemented in Windows
Specifiers and transfer parameters are strictly defined. The actual call parameters
are transferred using the transferred structures.
Parameters: cNrFctPar Number of call parameters = number of structure ele‐
ments in FctPar
FctPar Pointer to a field of structure elements, which contain
the particular call parameter with data type.
FctRet Pointer to a structure for the function value return with
data type.
Definition of the transfer structure
union CFI_VARIANT
(
char b;
short int i;
double r;
char* s;
)
typedef struct ExtFctStructTag
(

6.3 Functions
char cTyp;
union CFI_VARIANT value;
)ExtFctStruct;
typedef struct ExtFct* ExtFctStructPtr;
If the external function is to be developed independently of the platform (Windows, Linux), then
it is not permissible to use the keyword __declspec(dllexport). This keyword is only required
under Windows. For instance, the following macro can be used under Qt:
#ifdef Q_WS_WIN
#define MY_EXPORT __declspec(dllexport)
#else
#define MY_EXPORT
#endif
The function is declared as follows:

extern "C" MY_EXPORT void InitConnection
(ExtFctStructPtr FctRet, ExtFctStructPtr FctPar,char cNrFctPar)
If the screens, configured with "Run MyScreens", are used on the NCU and PCU/PC, then the
extension of the binary file must be omitted:
FCT InitConnection = ("xyz"/I/R,I,S/I,S)
When the absolute path information is omitted, "Run MyScreens" first searches for the binary
file in the configured directory.
6.3.19 Generate code (GC)
Description
The GC (Generate Code) function generates NC code from the OUTPUT method.
Programming
Syntax: GC("Identifier"[,"Target file"][,Opt],[Append])

Description: Generates NC code

6.3 Functions
Parameter: Identifier Name of the OUTPUT method from which code is generated
Target file Path name of target file for HMI or NC file system
If the target file is not specified (only possible within Program‐
ming Support), the code will be written to the location of the
cursor within the file that is currently open.
Opt Option for generating comments.
0: (Default setting) Generate code with comment for the purpose
of recompilability (see also Recompile (Page 150)).
1: Do not create comments in the generated code.
Note: This code cannot be recompiled (see also Auto-Hot‐
spot).
Append This parameter is only relevant if a target file is specified.
0: (Default setting) If the file already exists, the old content is
deleted.
1: If the file already exists, the new code is written at the start of
the file.
2: If the file already exists, the new code is written at the end of
the file.
Example
//M(TestGC/"Code generation:")
DEF VAR1 = (R//1)
DEF VAR2 = (R//2)
DEF D_NAME
LOAD
VAR1 = 123
VAR2 = -6
END_LOAD
OUTPUT(CODE1)
"Cycle123(" VAR1 "," VAR2 ")"
"M30"
END_OUTPUT
PRESS(VS1)
D_NAME = "\MPF.DIR\MESSEN.MPF"
GC("CODE1",D_NAME) ; Write NC code from the OUTPUT method to file
\MPF.DIR\MESSEN.MPF:
Cycle123(123, -6)
M30
END_PRESS

6.3 Functions
Recompile
● No entry for target file:
The GC function can only be used in the Programming Support and writes the NC code to
the file currently open in the editor. Recompilation of the NC code is possible. If the GC
function is configured without a target file being specified under "Run MyScreens", an error
message is output when it is executed.
● Entry for target file:
The code generated from the OUTPUT method is entered in the target file. If the target file
does not already exist, it is set up in the NC file system. If the target file is stored in the HMI
file system, it is stored on the hard disk. User comment lines (information required to
recompile code) are not set up, i.e. the code cannot be recompiled.
Special considerations for target file specification

In principle, there are two different ways of specifying a target file:
● NC notation: /_N_MPF_DIR/_N_MY_FILE_MPF
The file is created in the MPF directory on the NC.
● DOS notation: d:\abc\my_file.txt or \\RemoteRechner\files\my_file.txt
The file is written to the specified directory on the hard disk or on the specified PC, provided
that the directory is available on the hard disk or on a remote PC.
Note
Invalid variables generate an empty string in generated NC code and an error message in
the log book when they are read.
Special features of recompilation

The GC function cannot be called in sub-dialogs because variables originating from master
dialogs can be used in sub-dialogs. These variables would not, however, be available in
response to a direct call.
When generated code is processed manually with the editor, the number of characters for
values created by the code generation program must not be changed. Changing these values
would make it impossible to recompile the code.
Remedy:
1. Recompile
2. Make change using the configured dialog (e.g. 99 → 101)
3. GC

6.3 Functions
6.3.20 Password functions
Overview
The following password functions are available:
● Set password
● Delete password
● Change password
HMI_LOGIN function: Set new password
Syntax: HMI_LOGIN(Passwd)
Description: A password which sets the current access level is sent to the NCK with the
HMI_LOGIN() function.
Parameters: Passwd Password
Example
REG[0] = HMI_LOGIN("CUSTOMER") ; Result = TRUE if the password has been set

successfully, otherwise FALSE
HMI_LOGOFF function: Delete password
Syntax: HMI_LOGOFF
Description: The actual access level can be reset using the HMI_LOGOFF function.
Example
REG[0] = HMI_LOGOFF ; Result = TRUE if the password has been de-

leted successfully, otherwise FALSE
HMI_SETPASSWD function: Change password
Syntax: HMI_SETPASSWD(AC, Passwd)

Description: The password of the current level or a lower level can be changed with the
HMI_SETPASSWD function.
Parameters: AC Access level
Passwd Password

6.3 Functions
Example
REG[0] = HMI_SETPASSWD(4,"MYPWD") ; Result = TRUE if the password has been

changed successfully, otherwise FALSE
6.3.21 Load Array (LA)
Description
The LA (Load Array) function can be used to load an array from another file.
Programming
Syntax: LA(Identifier [, File])

Description: Loads an array from a file
Parameters: Identifier Name of array to be loaded
File File in which the array is defined
Note
If an array in the current configuration file must be replaced by an array from another
configuration file, then both arrays must have the same name.
Example
; Extract from file maske.com

DEF VAR2 = (S/*ARR5/"Out"/,"Toggle field")
PRESS(HS5)
LA("ARR5","arrayext.com") ; Load array ARR5 from file arrayext.com
VAR2 = ARR5[0] ; "Above"/"Below"/"Right"/"Left" appears
in the VAR2 toggle field
instead of "Out/In"
END_PRESS
//A(ARR5)
("Out"/"In")
//END
; Extract from file arrayext.com
//A(ARR5)
("Above"/"Below"/"Right"/"Left")
//END

6.3 Functions
Note
Please note that a valid value must be assigned to a variable after the LA function has been
used to assign another array to the toggle field of the variable.
6.3.22 Load Block (LB)
Description
The LB (Load Block) function can be used to load blocks containing subprograms during
runtime. LB should be configured in a LOAD method so that the loaded subprograms can be
called at any time.
Note
Subprograms can also be defined directly in a dialog so that they do not have to be loaded.
Programming
Syntax: LB("Block name"[,"File"])

Description: Loads subprogram during runtime
Parameters: Block name Name of block identifier
File Path name of configuration file
Default setting = Current configuration file
Example
LOAD
LB("PROG1") ; Block "PROG1" is searched for in the current configura-
tion file and then loaded.
LB("PROG2","XY.COM") ; Block "PROG2" is searched for in the configuration file
XY.COM and then loaded.
END_LOAD

6.3 Functions
6.3.23 Load Mask (LM)
Description
The LM function loads a new dialog. Depending on the mode of the dialog change (see table
below), a message dialog can also be implemented with this function.
Master dialog / sub-dialog

A dialog, which calls another dialog, but is not ended itself, is referred to as a master dialog.
A dialog that is called by a master dialog is referred to as a sub-dialog.
Programming
Syntax: LM("Identifier"[,"File"] [,MSx [, VARx] ] )

Description: Loads a dialog
Parameter: Identifier Name of the dialog to be loaded
File Path name (HMI file system or NC file system) of the configura‐
tion file; default setting: Current configuration file
MSx Mode of dialog change
0: (Default setting) The current dialog is rejected, the new dialog
is loaded and displayed. EXIT will send you back to the standard
application. You can use the MSx parameter to determine
whether or not the current dialog should be terminated when
changing dialogs. If the current dialog is retained, variables can
be transferred to the new dialog.
The advantage of the MSx parameter is that the dialogs do not
always need to be reinitialized when they are changed. Instead,
the data and layout of the current dialog are retained and data
transfer is made easier.
1: The current master dialog is interrupted when the LM function
is initiated. The new sub-dialog is loaded and displayed (e.g. for
the implementation of a message dialog). EXIT will end the sub-
dialog and return to the point at which the master dialog was
interrupted.
In the master dialog, the UNLOAD block is not processed during
the interruption.
VARx Precondition: MS1
List of variables which can be transferred from the master dialog
to the sub-dialog. Up to 20 variables, each separated by a com‐
ma, can be transferred.
Note
Parameter VARx transfers only the value of the variable in each case, i.e. variables can be
read and written in the sub-dialog, but are not visible in it. Variables can be returned from the
sub-dialog to the master dialog by means of the EXIT function.

6.3 Functions
Example
SCREEN FORM1 (master dialog): Jump to the sub-dialog SCREEN FORM2 with variable
transfer
PRESS(HS1)
LM("SCREEN FORM2","CFI.COM",1, POSX, POSY, DIAMETER)

; Interrupt screen form1 and open screen form2:
In doing this, variables POSX, POSY and DIAME-
TER are transferred.
DLGL("Screen form2 ended") ; After returning from screen form2, the fol-
lowing text appears in the dialog line of
screen form1: Screen form2 ended.
END_PRESS
SCREEN FORM2 (sub-dialog): Return to master dialog SCREEN FORM1 with transfer of the
variable contents
PRESS(VS8)
EXIT(POSX, POSY, DIAMETER)

; Hide screen form2 and continue screen form1:
In doing this, the changed variables POSX, POSY
and DIAMETER are transferred.
END_PRESS
6.3.24 Load Softkey (LS)
Description
The LS function can be used to display another softkey menu.
Programming
Syntax: LS("Identifier"[, "File"][, Merge])

Description: Displays the softkey menu

6.3 Functions
Parameters: Identifier Name of the softkey menu

File Path (HMI file system or NC file system) to the configuration
file
Default setting: Current configuration file
Merge
0: All existing softkeys are deleted; the newly configured soft‐
keys are entered.
1: Default setting
Only the newly configured softkeys overwrite the available
softkeys. The other softkeys (= softkeys of the HMI applica‐
tion) are kept with their functionality and text.
Example
PRESS(HS4)
LS("Menu2",,0) ; Menu2 overwrites the existing softkey menu, the softkeys
that are displayed are deleted.
END_PRESS
Note
As long as the Interpreter has not displayed a dialog, i.e. no LM function has yet been
processed, only one LS or one LM command, but no other action, can be configured in the
PRESS method of the definition block for the start softkey and the softkey menu.
The LS and LM functions may only be called within a softkey PRESS method and will not react
if navigation keys are pressed (PU, PD, SL, SR, SU, SD).
6.3.25 Load Grid (LG)
Description
The table description (grid) can be dynamically provided within methods (e.g. LOAD) using
the LG method.
In order to assign a table using the LG method, the variable must have already been defined
as a grid variable and cross-referenced to an existing, valid table.
Programming
Syntax: LG (Grid name, Variable name [,File name])

Description: Loads a table

6.3 Functions
Parameters: Grid name Name of the table (grid) in inverted commas

Variable name Name of the variable to which the table is to be assigned,
in inverted commas
File name Name of the file in which the table (grid) is defined, in in‐
verted commas. Only needs to be specified if the table is
not defined within the file that also contains the definition
of the variable.
Example
//M(MyGridSample/"My Grid Sample")

DEF MyGridVar=(R/% MyGrid1///WR2////100,,351,100)
LOAD
LG("MyGrid1","MyGridVar","mygrids.com")
END_LOAD
Content of mygrids.com:
//G(MyGrid1/0/5)
(I///,"MyGrid1"/wr1//"1"/80/1)
(R3///"LongText1","R1-R4"/wr2//"$R[1]"/80/1)
(IBB///"LongText2","M2.2-M2.5"/wr2//"M2.2"/80/,1)
(R3///"LongText3","R9,R11,R13,R15"/wr2//"$R[9]"/110/2)
//END
6.3.26 Multiple selection SWITCH
Description
You can check a variable for different values with a SWITCH command.
The expression configured in the SWITCH statement is compared in succession to all the
values configured in the following CASE statements.
If not the same, a comparison is made with the following CASE statement. If a DEFAULT
statement follows and up to now no CASE statement was the same as the expression
configured in the SWITCH statement, the statements following the DEFAULT statement are
executed.
If the same, the following statements are executed until a CASE, DEFAULT or END_SWITCH
statement occurs.

6.3 Functions
Example
FOCUS
SWITCH (FOC)
CASE "VarF"
DLGL("Variable ""VarF"" has the input focus.")
CASE "VarZ"
DLGL("Variable ""VarZ"" has the input focus.")
DEFAULT
DLGL("Any other variable has the input focus.")
END_SWITCH
END_FOCUS
6.3.27 Multiple Read NC PLC (MRNP)
Description
This MRNP command transfers several NC/PLC variables in a single register access. This
access method is significantly faster than reading via individual access attempts. The NC/PLC
variables must be included within an MRNP command of the same area.
The areas of the NC/PLC variables are organized as follows:
● General NC data ($MN..., $SN.., /nck/...)
● Channel-specific NC data ($MC..., $SC.., /channel/...)
● PLC data (DB..., MB.., /plc/...)
● Axis-specific NC data on the same axis ($MA..., $SA..)
Programming
Syntax: MRNP(Variable name 1*Variable name 2[* ...], Register index)

Description: Reads several variables
Parameter: In the variable names, "*" is the separator. The values are transferred to register
REG[Register index] and those following in the order that the variable names
appear in the command.
The following therefore applies:
The value of the first variable is located in REG[Register index].
The value of the second variable is located in REG[Register index + 1], etc.

6.3 Functions
Note
It should be noted that the number of registers is restricted and the list of variables cannot
exceed 500 characters.
Example
MRNP("$R[0]*$R[1]*$R[2]*$R[3]",1) ;The values of variables $R[0] to $R[3] are

written to REG[1] to REG[4].
NC variable
All machine data, setting data and R parameters are available, but only certain system
variables (see also: List of accessible system variables (Page 240)).
All global and channel-specific user variables (GUDs) can be accessed. However, local and
program-global user variables cannot be processed.
Machine data
Global machine data $MN_...
Axis-specific machine data $MA_...
Channel-specific machine data $MC_...
Setting data
Global setting data $SN_...
Axis-specific setting data $SA_...
Channel-specific setting data $SC_...
System variables
R parameter 1 $R[1]
PLC variable
All PLC data are available.
PLC data
Byte y bit z of data block x DBx.DBXy.z
Byte y of data block x DBx.DBBy
Word y of data block x DBx.DBWy
Double word y v. of data block x DBx.DBDy
Real y of data block x DBx.DBRy
Flag byte x bit y Mx.y

6.3 Functions
PLC data
Flag byte x MBx
Flag word x MWx
Flag double word x MDx
Input byte x bit y Ix.y or Ex.y
Input byte x IBx or EBx
Input word x IWx or EWx
Input double word x IDx or EDx
Output byte x bit y Qx.y or Ax.y
Output byte x QBx or ABx
Output word x QWx or AWx
Output double word x QDx or ADx
String y with length z from data block x DBx.DBSy.z
6.3.28 PI services
Description
The PI_START function starts PI Services (Program Invocation Services) from the PLC in the
NC area.
Note
A list of the available PI services can be found in the Basic Functions Function Manual.
Programming
Syntax: PI_START("Transfer string")

Description: Executes the PI service
Parameter: "Transfer string" Unlike the OEM documentation, the transfer string should
be entered in inverted commas.
Example
PI_START("/NC,001,_N_LOGOUT")
Note
Channel-dependent PI Services always refer to the current channel.
PI services of the tool functions (TO area) always refer to the TO area that is assigned to the
current channel.

6.3 Functions
6.3.29 Reading (RNP) and writing (WNP) system or user variables
Description
The RNP (Read NC PLC) command can be used to read NC or PLC variables or machine
data.
Programming
Syntax: RNP ("System or user variable", value)

Description: Reads NC or PLC variable or machine data
Parameters: System or user varia‐ Name of NC or PLC variable
ble
Value Value that is to be written to the system or user variable.
If the value is a String type, it must be written in double
quotation marks.
Example
VAR2=RNP("$AA_IN[2]") ; Read NC variable
Description
The WNP (Write NC PLC) command can be used to write NC or PLC variables or machine
data.
NC/PLC variables are accessed anew every time the WNP function is executed, i.e., NC/PLC
access is always executed in a CHANGE method. It is advisable to use this option in cases
where a system or user variable changes value frequently. If an NC/PLC variable is to be
accessed only once, then it must be configured in a LOAD or UNLOAD method.
Programming
Syntax: WNP("System or user variable", value)

Description: Writes NC or PLC variable or machine data
Parameters: System or user variable Name of NC or PLC variable
Value Value that is to be written to the system or user var‐
iable.
If the value is a String type, it must be written in dou‐
ble quotation marks.
Example
WNP("DB20.DBB1",1) ; Write PLC variable

6.3 Functions
6.3.30 RESIZE_VAR_IO and RESIZE_VAR_TXT
Description
The RESIZE_VAR_IO() and RESIZE_VAR_TXT() commands changes the geometry of
the input/output component or text component of a variable.
After setting the new geometry, all fields of the screen are positioned as if the screen had been
configured with these positions from the start. In this way, all fields are correctly aligned,
depending on the configuration.
Programming
Syntax: RESIZE_VAR_IO(Variable name, [X], [Y], [Width], [Height])

RESIZE_VAR_TXT(Variable name, [X], [Y], [Width], [Height])
Description: Changes the geometry of the input/output component or text component of a
variable.
Parameter: Variable name Name of the variable whose geometry of the input/out‐
put component or text component of a variable is to be
changed.
X X-coordinate, top left
Y Y-coordinate, top left
Width Width
Height Height
Note
The previous value is retained for each value of X, Y, Width or Height that is not specified. If
-1 is specified for one of these values, "Run MyScreens" sets the specified component of the
default position.
Example
RESIZE_VAR_IO("MyVar1", 200, , 100) ; The I/O component of the "MyVar1" variable

is moved to the X position 200 pixels, the
width is set to 100 pixels. The Y position and
the height of the previous value are kept.

6.3 Functions
6.3.31 Register (REG)
Register description
Registers are needed in order to exchange data between different dialogs. Registers are
assigned to each dialog. These are created when the first dialog is loaded and assigned the
value 0 or an empty string.
Note
Registers must not be used directly in an OUTPUT method for generating NC code.
Programming
Syntax: REG[x]
Description: Defines a register
Parameters: x Register index with x = 0...19;
Type: REAL or STRING = VARIANT
Registers with x ≥ 20 have already been assigned by Siemens.
Description of register value

The assignment of values to registers is configured in a method.
Note
If a new dialog is generated from an existing dialog by means of the LM function, register
content is automatically transferred to the new dialog at the same time and is available for
further calculations in the second dialog.
Programming
Syntax: Identifier.val = Register value

or
Identifier = Register value
Description:
Parameters: Identifier Name of the register
Register value Value of register
Example
UNLOAD
REG[0] = VAR1 ; Assign value of variable 1 to register 0

6.3 Functions
END_UNLOAD
UNLOAD
REG[9].VAL = 84 ; Assign value 84 to register 9
END_UNLOAD
; These registers can then be assigned to local variables
again in a method in the next dialog.
LOAD
VAR2 = REG[0]
END_LOAD
Description of register status

The Status property can be used to scan a register for valid content.
One possible use for the register scan function is to ensure that a value is written to a register
only if the relevant dialog is a "master dialog".
Programming
Syntax: Identifier.vld
Description: The property is read-only property.
Parameters: Identifier Name of the register
Return value: The result of the scan can be:
FALSE = invalid value
TRUE = valid value
Example
IF REG[15].VLD == FALSE ; Scan validity of register value

REG[15] = 84
ENDIF
VAR1 = REG[9].VLD ; Assign the value of the REG[9] status request to Var1.
6.3.32 RETURN
Description
The RETURN function can be used to prematurely terminate execution of the current
subprogram and to return to the branch point of the last CALL command.
If no RETURN command is configured in the subprogram, the subprogram will run to the end
before returning to the branch point.

6.3 Functions
Programming
Syntax: RETURN
Description: Returns to the branch point
Example
//B(PROG1) ; Block start

IF VAR1.val=="Otto"
VAR1.val="Hans"
RETURN ; If the variable value = Otto, the value "Hans" is as-
signed to the variable, and the subprogram ends at this
point.
ENDIF
VAR1.val="Otto" ; If the variable value ≠ Otto, the value "Otto" is as-
signed to the variable.
//END ; Block end
6.3.33 Recompile
Description
In the programming support system, it is possible to recompile NC code that has been
generated with the GC function and to display the variable values in the input/output field of
the associated entry dialog again.
Programming
Variables from the NC code are transferred to the dialog. At the same time, the variable values
from the NC code are compared with the calculated variable values from the configuration file.
If the values do not coincide, an error message is written to the log book because values have
been changed during NC code generation.
If the NC code contains the same variable several times, it is evaluated at the point where it
last occurs during recompilation. A warning is also written to the log book.

6.3 Functions
Variables not utilized in NC code during code generation are stored as user comment. The
term "user comment" refers to all information required to recompile codes. User comment must
not be altered.
Note
The block consisting of NC code and user comment can be recompiled only if it starts at the
beginning of a line.
Examples:
The programm contains the following NC code:
DEF VAR1=(I//101)
OUTPUT(CODE1)
"X" VAR1 " Y200"
"X" VAR1 " Y0"
END_OUTPUT
The following code is then stored in the parts program:
;NCG#TestGC#\cus.dir\aeditor.com#CODE1#1#3#
X101 Y200
X101 Y0
;#END#
The Editor reads the following during recompilation:
X101 Y200
X222 Y0 ; The value for X has been changed in the part program (X101 → X222)
The following value is displayed for VAR1 in the input dialog: VAR1 = 222
See also
Generate code (GC) (Page 133)
6.3.34 Recompile without user comment
Description
In the Programming Support, it is possible to recompile without user comments the NC code
that has been generated with the GC function and to display the variable values in the input/
output field of the associated entry dialog again.

6.3 Functions
Programming
The GC command can be executed in the following way in order to suppress comment lines
that are generated for standard code generation:
GC("CODE1",D_NAME,1)
Normally, the resulting code cannot be recompiled. The following steps are required in order
to be able to recompile the cycle calls generated in this way:
● Expanding the easyscreen.ini
Section [RECOMPILE_INFO_FILES] will be introduced into the easyscreen.ini file. In this
section, all ini files are listed that contain descriptions for cycles recompiled without user
comment:
[RECOMPILE_INFO_FILES]
IniFile01 = cycles1.ini
IniFile02 = cycles2.ini
Several ini files can be specified, whose names can be freely selected.
● Creating an ini file for a cycle description
Save the ini file with the cycle descriptions under the following path:
[System user directory]/cfg
[System oem directory]/cfg
[System add_on directory]/cfg
A separate section is required for each cycle. The section name corresponds to the name
of the cycle:
[Cycle123]
Mname = TestGC
Dname = testgc.com
OUTPUT = Code1
Anzp = 3
Version = 0
Code_type = 1
Icon = cycle123.png
Desc_Text = This is describing text
Mname Screen form name

Dname Name of the file in which the screen is defined
OUTPUT Name of the relevant OUTPUT method
Anzp Number of parameters of the screen to be recompiled (all with DEF-
created variables, also help variables)
Version (optional) version specification for cycle

6.3 Functions
Icon (optional) icon for display in the machining step program, format
*.png
Screen size for corresponding resolution:
640 X 480 mm → 16 x 16 pixels
800 X 600 mm → 20 x 20 pixels
1024 X 768 mm → 26 x 26 pixels
1280 X 1024 mm → 26 x 26 pixels
1280 X 768 mm → 26 x 26 pixels
Archive: [system user directory]/ico/ico<resolution>
Note: For resolutions of 1280, the folder for 1024 x 768 mm is used
(only suitable for machining step programs).
Desc_Text (optional) Explanation text for display in the machining step pro‐
gram, max. length of string is 17 characters (only suitable for ma‐
chining step programs).
Example
//M(TestGC/"Code generation:")
DEF VAR1 = (R//1)
DEF VAR2 = (R//2)
DEF D_NAME
LOAD
VAR1 = 123
VAR2 = -6
END_LOAD
OUTPUT(CODE1)
"Cycle123(" VAR1 "," VAR2 ")"
"M30"
END_OUTPUT
PRESS(VS1)
D_NAME = "\MPF.DIR\MESSEN.MPF"
GC("CODE1",D_NAME) ;Write NC code from the OUTPUT method to
file \MPF.DIR\MESSEN.MPF:
Cycle123(123, -6)
M30
END_PRESS

6.3 Functions
● The "Recompile without user comment" functionality does not have the full range of
functions as "Recompile with user comment".
Typical cycle calls, such as MYCYCLE(PAR1, PAR2, PAR3, …), are supported during
"Recompile without user comment". However, there must not be a user comment in the
line of the function call. Optional parameters that are not transferred during the function call
are of the S type string; however, they must be at least specified using empty quotation
marks, e.g. "". Otherwise, "Run MyScreens" attempts to fill these parameters using commas
so that the "filled cycle call" can then be recompiled.
● Parameters of the string type must not have any commas or semicolons in the string to be
transferred.
● During "Recompile without user comment", all variables contained in the OUTPUT method
must always be within the brackets so that the "Fill in missing cycle parameters with
commas" functionality can take effect.
Example:
Permitted:
OUTPUT
"MYCYCLE(" MYPAR1 "," MYPAR2 "," MYPAR3 ")"
END_OUTPUT
Not permitted (variable MYCOMMENT is positioned after the closing bracket.):
OUTPUT
"MYCYCLE(" MYPAR1 "," MYPAR2 "," MYPAR3 ")" MYCOMMENT
END_OUTPUT
6.3.35 Search Forward, Search Backward (SF, SB)
Description
The SF, SB (Search Forward, Search Backward) function is used to search for a string from
the current cursor position in the NC program currently selected in the Editor and to output its
value.
Programming
Syntax: SF("String")
Identifiers: Search Forward: Search forward from the current cursor position
Syntax: SB("String")
Identifiers: Search Backward: Search backward from the current cursor position
Parameters: String Text to be found

6.3 Functions
Rules governing text search

● A blank must be inserted before and after the search concept unit, consisting of search
string and its value, in the currently selected NC program.
● The system does not search for concepts within comment text or other strings.
● The value to be output must be a numerical expression. Expressions in the form of "X1=4+5"
are not recognized.
● The system recognizes hexadecimal constants in the form of X1='HFFFF', binary constants
in the form of X1='B10010' and exponential components in the form of X1='-.5EX-4'.
● The value of a string can be output if it contains the following between string and value:
– Nothing
– Blanks
– Equality sign
Example
The following notations are possible:
X100 Y200 ; The variable Abc is assigned the value 200

Abc = SB("Y")
X100 Y 200 ; The variable Abc is assigned the value 200
Abc = SB("Y")
X100 Y=200 ; The variable Abc is assigned the value 200
Abc = SB("Y")
6.3.36 STRING functions
Overview
The following functions enable strings to be processed:
● Determine length of string
● Find a character in a string
● Extract substring from left
● Extract substring from right
● Extract substring from mid-string
● Replace substring
● Compare strings
● Insert a string in another string
● Remove a string from a string

6.3 Functions
● Remove spaces (from left or from the right)

● Insert values or strings with formatting identifiers
LEN function: Length of a string
Syntax: LEN(string | varname)

Description: Determines the number of characters in a string
Parameters: string Every valid string expression. NULL is output if string is
empty.
varname Any valid declared variable name
Only one of the two parameters is allowed.
Example
DEF VAR01
DEF VAR02
LOAD
VAR01="HALLO"
VAR02=LEN(VAR01) ; Result = 5
END_LOAD
INSTR function: Search for character in string
Syntax: INSTR(Start, String1, String2 [,Direction])

Description: Searches for characters
Parameters: Start Starting position for searching for string1 in string2. En‐
ter 0 to start searching at the beginning of string2.
String1 Character that is being searched for.
String2 Character string in which the search is being made.
Direction (optional) Direction in which the search is being made.
0: From left to right (default setting)
1: From right to left
0 is returned if string1 does not occur in string2.
Example
DEF VAR01
DEF VAR02
LOAD

6.3 Functions
VAR01="HALLO/WELT"
VAR02=INST(1,"/",VAR01) ; Result = 6
END_LOAD
LEFT Function: String from left
Syntax: LEFT(string, length)

Description: LEFT returns a string containing the specified number of characters starting from
the left-hand side of a string.
Parameters: string Character string or variable with the character string to be
processed
length Number of characters that are to be read out
Example
DEF VAR01
DEF VAR02
LOAD
VAR01="HALLO/WELT"
VAR02=LEFT(VAR01,5) ; Result = "HELLO"
END_LOAD
RIGHT function: String from right
Syntax: RIGHT(string, length)

Description: RIGHT returns a string containing the specified number of characters starting
from the right-hand side of a string.
processed
Example
DEF VAR01
DEF VAR02
LOAD
VAR01="HALLO/WELT"
VAR02=LEFT(VAR01,4) ; Result = "WORLD"
END_LOAD

6.3 Functions
MIDS function: String from mid-string
Syntax: MIDS(string, start [, length])

Description: MIDS returns a string containing the specified number of characters starting at
the specified position in the string.
processed
start Start from where characters are to be read in the string
Example
DEF VAR01
DEF VAR02
LOAD
VAR01="HALLO/WELT"
VAR02=LEFT(VAR01,4,4) ; Result = "LO/W"
END_LOAD
REPLACE Function: Replacing characters
Syntax: REPLACE( string, FindString, ReplaceString [, start [, count ] ] )

Description: REPLACE replaces a character/string in a string with another character/string.
Parameters: string String in which FindString is to be replaced with Replace‐
String.
FindString String to be replaced
ReplaceString Replacement string (is used instead of the FindString)
start Starting position for search and replace operations
count Number of characters that are to be searched from the start‐
ing position after FindString
Return value:
string = Empty string Copy of string
FindString = Empty string Copy of string
ReplaceString = Empty string Copy of string, in which all occurrences of Find‐
String are deleted
start > Len(String) Empty string
count = 0 Copy of string
STRCMP function: Compare strings
Syntax: STRCMP(string1, string2 [, CaseInsensitive])

Description: STRCMP compares a character string with another character string.

6.3 Functions
Parameters: string1 Character string that is to be compared with a second

character string
string2 Character string that is to be compared with the first
character string
CaseInsensitive Comparison with/without consideration of upper/lower
case:
Not specified or FALSE = upper/lower case is considered
TRUE = upper/lower case is not considered
Example
REG[0]=STRCMP("Hugo", "HUGO") ; Result = 32

; (<> 0, strings are not identical)
REG[0]=STRCMP("Hugo", "HUGO", TRUE) ; Result = 0

; (== 0, stings are identical)
STRINSERT function: Insert string
Syntax: STRINSERT(string1, string2 , insert position)

Description: STRINSERT inserts a character string at a specific position in a character string.
Parameters: string1 Character string in which a character string is to be in‐
serted
string2 Character string that is to be inserted
insert position Position at which the character string is to be inserted
Example
REG[0]=STRINSERT("Hello!", " world", 5) ; Result = "Hello world!")
STRREMOVE function: Remove string
Syntax: STRREMOVE(string1, remove positon , count)

Description: STRREMOVE removes a specific number of characters at a specific position
within a character string.
Parameters: string1 Character string from which characters are to be re‐
moved
remove position Position at which characters are to be removed from the
character string
count Number of characters to be removed

6.3 Functions
Example
REG[0]=STRREMOVE("Hello world!", 5, 6) ; Result = "Hello!")
TRIMLEFT function: Remove blanks from the left of the string
Syntax: TRIMLEFT(string1)
Description: TRIMLEFT removes blanks on the left from a character string.
Parameters: string1 Character string from which blanks are to be removed
from the left of the character string
Example
REG[0]=TRIMLEFT(" Hello!") ; Result = "Hello!")
TRIMRIGHT function: Remove blanks from the right of the string
Syntax: TRIMRIGHT(string1)
Description: TRIMLEFT removes blanks on the right from a character string.
Parameters: string1 Character string from which blanks are to be removed
from the right of the character string
Example
REG[0]=TRIMRIGHT("Hello! ") ; Result = "Hello!")
FORMAT function: Insert values or string with formatting identifier
Syntax: FORMAT(Text with formatting identifier [, Value1] ... [, Value28] )

Description: Through the use of formatting identifiers, the FORMAT function enables up to
28 values or strings to be inserted at specified positions in a specific text.

6.3 Functions
Formatting identifi‐ Syntax %[Flags] [Width] [.decimal places] type

ers: Flags Optional character for defining output formatting:
● Right-justified or left-justified ("-") for left-justified
● Add leading zeros ("0")
● default: Fill in with blanks if the value to be output has
fewer positions than specified with [Width].
Width The argument defines the minimum output width for a non-
negative number. If the value has fewer positions than
specified by the argument, the missing spaces are filled with
blanks.
Decimal places With floating-point numbers, the optional parameter defines
the number of decimal places.
Type The type character defines which data formats are transfer‐
red to the print statement.
These characters need to be specified.
● d: Integer value
● f: Floating-point number
● s: String
● o: Octal
● x: Hexadecimal
● b: Binary
Example
DEF VAR1
DEF VAR2
LOAD
VAR1 = 123
VAR2 = FORMAT("Hello %08b %.2f %s!", VAR1 + 1, 987.654321, "world")
; Result = "Hello 01111100 987.65 world!"
END_LOAD
See also
Use of strings (Page 83)
6.3.37 WHILE/UNTIL loops
Description
A loop can be implemented with the DO LOOP commands. Depending on the configuration,
it is run through as long as a condition is satisfied (WHILE) or until a condition occurs (UNTIL).

6.3 Functions
As loops can impair the system performance, depending on the configuration, they should be
used carefully and without time-intensive actions in the loops.
It is recommended that a register (REG[]) be used as run variable, because normal display
variables (particularly those with system or user variables connection) also impair the system
performance due to the frequent updates or write operations.
The runtime of "Run MyScreens" methods can be determined with the DEBUG function (see
Section DEBUG (Page 125)). Problems caused by loops (high CPU load, reduced response
capability) may be identified in this way.
Note
As each FOR loop can be replaced by a WHILE loop, the syntax to formulate a FOR loop is
not supported in EasyScreen.
Programming
DO
<instructions>
LOOP_WHILE <Condition to continue the loop>
DO
<instructions>
LOOP_UNTIL <Condition to terminate the loop>
DO_WHILE <Condition to continue the loop>

<instructions>
LOOP
DO_UNTIL <Condition to terminate the loop>

<instructions>
LOOP
Example
REG[0] = 5
DO
DEBUG("OUTER: " << REG[0])
REG[0] = REG[0] + 1
REG[1] = -5
DO
DEBUG("INNER: " << REG[1])

6.3 Functions
REG[1] = REG[1] + 1
LOOP_WHILE REG[1] < 0
LOOP_WHILE REG[0] < 10
REG[0] = 5
DO
REG[0] = REG[0] + 1
REG[1] = -5
DO
REG[1] = REG[1] + 1
LOOP_UNTIL 0 <= REG[1]
LOOP_WHILE 10 > REG[0]
REG[0] = 5
DO_WHILE 10 > REG[0]
REG[0] = REG[0] + 1
REG[1] = -5
DO_UNTIL 0 <= REG[1]

REG[1] = REG[1] + 1
LOOP
LOOP
REG[0] = 5
DO_WHILE 10 > REG[0]
REG[0] = REG[0] + 1
REG[1] = -5
DO

6.3 Functions
REG[1] = REG[1] + 1
LOOP_UNTIL 0 <= REG[1]
LOOP
6.3.38 Cyclic execution of scripts: START_TIMER, STOP_TIMER
Description
SUB methods can be called cyclically with the aid of timers. The START_TIMER() and
STOP_TIMER() functions are available for this purpose.
Note
Only one timer can be configured for each SUB method.
Programming
Syntax: START_TIMER("SUB name", Interval)

Description: Starts cyclic processing of a SUB method
Parameters: SUB name: Name of the SUB method to be called cyclically
Interval: Interval in milliseconds
Syntax: STOP_TIMER("SUB name", Interval)

Description: Stops cyclic processing of a SUB method
Parameters: SUB name: Name of the SUB method whose timer is to be stop‐
ped.
Example
//M(TimerSample/"My timer")
DEF MyVariable=(I//0/,"Number of cyclic calls:"/WR1)
VS1=("Start%ntimer")
VS2=("Stop%ntimer")
SUB(MyTimerSub)
MyVariable = MyVariable + 1
END_SUB

6.3 Functions
//M(TimerSample/"My timer")
PRESS(VS1)
;Calls SUB "MyTimerSub" every 1000 milliseconds
START_TIMER("MyTimerSub", 1000)
END_PRESS
PRESS(VS2)
STOP_TIMER("MyTimerSub")
END_PRESS
If START_TIMER is called again for a timer already assigned to a SUB method, then the new
interval is taken over if it is different. Otherwise, the second call is ignored.
The smallest interval for the system is100 milliseconds.
If STOP_TIMER is called for a SUB method for which no timer is currently running, the call is
ignored.

6.3 Functions

Graphic and logic elements 7
7.1 Line, dividing line, rectangle, circle and ellipse
Description
Lines, dividing lines, rectangles and ellipses/circles are configured in the LOAD method:
● Transparent rectangles are created by setting the fill color to the system background color.
● With the ELLIPSE element, a circle is created by setting the height and the width to the
same value.
● Horizontal and vertical dividing lines always have the exact window width or window height.
No scrollbars are produced by dividing lines.
If you previously used the RECT element to display dividing lines, e.g.
RECT(305,0,1,370,0,0,1), this is detected by the Programming Support and automatically
converted to V_SEPARATOR(305,1,"#87a5cd", 1). This applies to both vertical and
horizontal dividing lines.
LINE element
Programming:
Syntax: LINE (x1,y1,x2,y2,f,s)

Description: Defines a line
Parameter: x1 Start point x-coordinate
y1 Start point y-coordinate
x2 End point x-coordinate
y2 End point y-coordinate
f Color of the line
s Line style:
1 = solid
2 = dashed
3 = dotted
4 = dashed and dotted
RECT element
Programming:
Syntax: RECT (x,y,w,h,f1,f2,s)

Description: Defines a rectangle

Graphic and logic elements
7.1 Line, dividing line, rectangle, circle and ellipse
Parameter: x x-coordinate, top left

y y-coordinate, top left
w Width
h Height
f1 Color of the border
f2 Fill color
s Border style:
1 = solid
2 = dashed
3 = dotted
ELLIPSE element
Programming:
Syntax: ELLIPSE(x,y,w,h,f1,f2,s)
Description: Defines an ellipse or circle
Parameter: x x-coordinate, top left
y y-coordinate, top left
w Width
h Height
f1 Color of the border
f2 Fill color
s Border style:
1 = solid
2 = dashed
3 = dotted
A circle is created when the values for height and width are the same.
V_SEPARATOR element
Programming:
Syntax: V_SEPARATOR (x,w,color,pen)

Description: Defines a vertical dividing line
Parameter: x x position
w Line weight
color Color
pen Line style:
1 = solid
2 = dashed
3 = dotted

7.2 Defining an array
H_SEPARATOR element
Programming:
Syntax: H_SEPARATOR (y,h,color,pen)

Description: Defines a horizontal dividing line
Parameter: y y position
h Line weight
color Color
pen Line style:
1 = solid
2 = dashed
3 = dotted
See also
LOAD (Page 104)
See also
CLEAR_BACKGROUND (Page 117)
Definition
An array can be used to organize data of the same data type stored in the memory in such a
way that it is possible to access the data via an index.
Description
Arrays can be one- or two-dimensional. A one-dimensional array is treated like a two-
dimensional array with just one line or column.
Arrays have start identifier //A and end identifier //END. The number of lines and columns is
optional. An array is structured in the following way:

Programming
Syntax: //A(Identifier)
(a/b...)
(c/d...)
...
//END
Description: Defines array
Parameters: Identifier Name of array
a, b, c, d Values of array
Values of the STRING type must be enclosed in double quo‐
tation marks.
Example
//A(Thread) ; Size/lead/core diameter

(0.3 / 0.075 / 0.202)
(0.4 / 0.1 / 0.270)
(0.5 / 0.125 / 0.338)
(0.6 / 0.15 / 0.406)
(0.8 / 0.2 / 0.540)
(1.0 / 0.25 / 0.676)
(1.2 / 0.25 / 0.676)
(1.4 / 0.3 / 1.010)
(1.7 / 0.35 / 1.246)
//END
7.2.1 Accessing the value of an array element
Description
The value of an array access operation can be transferred with property Value (identifier.val).
The line index (line number of the array) and the column index (column number of the array)
each begin at 0. If a line index or column index is outside the array, the value 0 or a blank
string is output and the ERR variable is set to TRUE. Variable ERR is also set to TRUE if a
search concept cannot be found.
Programming
Syntax: Identifier [Z,[M[,C]]].val or

Identifier [Z,[M[,C]]]
Description: Access to one-dimensional array with only one column

Syntax: Identifier [S,[M[,C]]].val] or

Identifier [S,[M[,C]]] or
Description: Access to one-dimensional array with only one line
Syntax: Identifier [Z,S,[M[,C]]].val or
Identifier [Z,S,[M[,C]]]
Description: Access to two-dimensional array
Parameters: Identifier: Name of array
Z: Line value (line index or search concept)
S: Column value (column index or search concept)
M: Access mode
0 Direct
1 Searches the line, column directly
2 Searches the column, line directly
3 Searches
4 Searches line index
5 Searches column index
C: Compare mode
0 Search concept must be located in the range of values
of the line or column.
1 Search concept must be located exactly.
Example:
VAR1 = MET_G[REG[3],1,0].VAL ;Assign Var1 a value from
array MET_G
Access mode
● "Direct" access mode
With "Direct" access mode (M = 0), the array is accessed with the line index in Z and the
column index in S. Compare mode C is not evaluated.
● "Search" access mode
In the case of access mode M = 1, 2 or 3, the search always commences in line 0 or column
0.
Mode M Line value Z Column value S Output value

0 Line index Column index Value from line Z and column
S
1 Search concept: Column index of column Value from line found and
Search in column 0 from which value is read column S
2 Line index of line from Search concept: Value from line Z and column
which return value is read Search in line 0 found
3 Search concept: Search concept: Value from line and column
Search in column 0 Search in line 0 found

Mode M Line value Z Column value S Output value

4 Search concept: Column index of search col‐ Line index
Search in column S umn
5 Line index of search line. Search concept: Column index
Search in line Z
Compare mode
When compare mode C = 0 is used, the content of the search line or search column must be
sorted in ascending order. If the search concept is smaller than the first element or greater
than the last, the value 0 or a blank string is output and the error variable ERR is set to TRUE.
When compare mode C = 1 is used, the search concept must be present in the search line or
search column. If the search concept cannot be found, the value 0 or a blank string is output
and the error variable ERR is set to TRUE.
7.2.2 Example Access to an array element
Prerequisite
Two arrays are defined below. These are the basis for the following examples:
//A(Thread)
(0.3 / 0.075 / 0.202)
(0.4 / 0.1 / 0.270)
(0.5 / 0.125 / 0.338)
(0.6 / 0.15 / 0.406)
(0.8 / 0.2 / 0.540)
(1.0 / 0.25 / 0.676)
(1.2 / 0.25 / 0.676)
(1.4 / 0.3 / 1.010)
(1.7 / 0.35 / 1.246)
//END
//A(Array2)
("DES" / "PTCH" / "CDM" )
(0.3 / 0.075 / 0.202 )
(0.4 / 0.1 / 0.270 )
(0.5 / 0.125 / 0.338 )
(0.6 / 0.15 / 0.406 )
(0.8 / 0.2 / 0.540 )
(1.0 / 0.25 / 0.676 )
(1.2 / 0.25 / 0.676 )

(1.4 / 0.3 / 1.010 )

(1.7 / 0.35 / 1.246 )
//END
Examples
● Access mode example 1:
The search concept is in Z. This key is always sought in column 0. The value from column
S is output with the line index of the concept found.
VAR1 = Thread[0.5,1,1] ;VAR1 has the value 0.125
Explanation:
Search for value 0.5 in column 0 of "Thread" array and output the value found in column 1
of the same line.
The search concept is in S. This concept is always searched for in line 0. The value from
line Z is output with the column index of the concept found:
VAR1 = ARRAY2[3,"PTCH",2] ;VAR1 has the value 0.125
Explanation:
Search for column containing "PTCH" in line 0 of array "Array2". Output the value from the
column found and the line with index 3.
A search concept is in each of Z and S. The line index is searched for in column 0 with the
concept in Z and the column index in line 0 with the concept in S. The value from the array
is output with the line index and column index found:
VAR1 = ARRAY2[0.6,"PTCH",3] ;VAR1 has the value 0.15
Explanation:
Search for the line with the content 0.6 in column 0 of array "Array2", search for the column
with the content "STG" in line 0 of Array2. Transfer the value from the line and column found
to VAR1.
The search concept is in Z. S contains the column index of the column in which concept is
being searched for. The line index of the concept found is output:
VAR1 = Thread[0.125,1,4] ;VAR1 has the value 2
Explanation:
Search for value 0.125 in column 1 of array "Thread" and transfer the line index of the value
found to VAR1.
Z contains the line index of line in which concept is being searched for. The search concept
is in S. The column index of the concept found is output:
VAR1 = Thread[4,0.2,5,1] ;VAR1 has the value 1
Explanation:
Search in line 4 of the "Thread" array for the value 0.2 and transfer the column index of the
value found to VAR1. Comparison mode 1 was selected because the values of line 4 are
not sorted in ascending order.

7.3 Table description (grid)
7.2.3 Scanning the status of an array element
Description
The Status property can be used to run a scan to find out whether an array access operation
is supplying a valid value.
Programming
Syntax: Identifier [Z, S, [M[,C]]].vld

Description: Status is a read-only property.
Parameters: Identifier Name of array
Return Value: FALSE =invalid value
TRUE = valid value
Example
DEF MPIT = (R///"MPIT",,"MPIT",""/wr3)

DEF PIT = (R///"PIT",,"PIT",""/wr3)
PRESS(VS1)
MPIT = 0.6
IF MET_G[MPIT,0,4,1].VLD == TRUE
PIT = MET_G[MPIT,1,0].VAL
REG[4] = PIT
REG[1] = "OK"
ELSE
REG[1] = "ERROR"
ENDIF
END_PRESS
Definition
In contrast to the array, the values of a table (grid) are continually updated. It is a tabular display
of values that can come from the NC or PLC. The table is organized in columns and always
has variables of the same type in one column.

Assignment
The reference to a table description is performed in the variables definition:
● The variables definition determines the values to be displayed, and the definition of table
elements determines the appearance and arrangement on the screen window. The
properties of the input/output fields from the definition line of the variables are taken over
in the table.
● The visible area of the table is determined by the width and height of the input/output field.
Any lines or columns than cannot be seen can be displayed by scrolling horizontally and
vertically.
Table identifiers
Identifiers of a table containing NCK or PLC values of the same type, which can be addressed
via a channel block. The table identifier is differentiated from limits or toggle fields by the
addition of a % sign in front of it. The file containing the table description can be specified by
adding a comma after the identifier and then inserting the name of the file.
Identifier of a table for values of the same type, e.g. from the NCK or PLC. The table identifier
is specified at the position at which the limit values or the toggle field are configured. The table
identifier starts with a leading % character. This can be followed by a file name with a comma
as separator. It specifies the file in which the table description is defined. Per default, the table
is sought in the configuration file in which the screen is configured.
A table definition can also be loaded dynamically, e.g. in the LOAD method via the Load Grid
(LG) function.
System or user variable

This parameter remains empty for tables because the column definition lines contain detailed
information about the variables to be displayed. The table description can be provided
dynamically.
Example
Definition of a MyGridVar variable which displays a "MyGrid1" grid in its input/output field
(distance from left: 100, distance from top: Standard, width: 350, height: 100).
DEF MyGridVar=(V/% MyGrid1///////100,,350,100)
See also
Parameters of variables (Page 71)
Load Grid (LG) (Page 141)

7.3.1 Defining a table (grid)
Description
The table block comprises:
● Header
● 1 to n column descriptions
Programming
Syntax: //G(Table identifier/Table type/Number of lines/

[Fixed line attribute],[Fixed column attribute])
Description: Defines a table (grid)
Parameters: Table identifier The table identifier is used without a leading % sign. It can
only be used once in a dialog.
Table type 0 (default) Table for PLC or user data (NCK-
and channel-specific data)
1 and others, reserved
Number of lines Number of lines including header
The fixed line or fixed column is not scrolled. The number
of columns is the number of columns configured.
Display of column -1: The column header line is not displayed
header line 0: The column header line is displayed (default)
Number of fixed col‐ 0: No fixed column
umns 1 ... n: Number of columns that are to be permanently
visible, i.e. not scrolled horizontally
Examples
//G(grid1/0/5/-1,2) Column header line is hidden and two fixed

columns
//G(grid1/0/5/,1) Column header line is displayed and one fixed
column
//G(grid1/0/5) Column header line is displayed and no fixed
columns
7.3.2 Defining columns
Description
For tables (grids), it is advisable to use variables with an index. For PLC or NC variables, the
index number with one or more indices is of significance.

The values displayed in a table can be modified directly within the restrictions of the rights
granted by the attributes and within any defined limits.
Programming
Syntax: (Type/Limits/Empty/Long text,column header/Attributes/Help display/

System or user variable/Column width/Offset1, Offset2, Offset3)
See also Extended configuration syntax (Page 36).
Description: Defines columns
Parameters: Similar to variables
Type Data type
Limits Limit value MIN, limit value MAX
Long text, column
header
Attributes
Help display
System or user varia‐ As variable, PLC or NC variables should be entered in
ble double quotation marks.
Column width Entry in pixels.
Offset The increment sizes to increment each index in order
to fill the column are specified in the assigned offset
parameter:
● Offset1: Step width for the 1st index
● Offset2: Step width for the 2nd index
● Offset3: Step width for the 3rd index
Column header from text file

The column header can be entered as text or text number ($8xxxx) and is not scrolled.
Modifying column properties

The column properties which can be modified dynamically (written) are:
● Limits (min,max),
● Column header (st),
● Attributes (wr, ac and li),
● Help display (hlp) and
● OPI-Variable (var).
Column properties are modified via the variable identifier in the definition line and the column
index (starting at 1).
Example: VAR1[1].st="Column 1"
The wr, ac and li attributes can be specified for column definitions.

See also
Load Grid (LG) (Page 141)
7.3.3 Focus control in the table (cell)
Description
The Row and Col properties can be used to set and calculate the focus within a table:
● Identifier.Row
● Identifier.Col
Programming
Each cell in a table has the Val and Vld properties.
In order to read and write cell properties, a line and column index must be specified in addition
to the variable identifiers from the definition list.
Syntax: Identifier[Line index, column index].val or

Identifier[Line index, column index]
Description: Val properties
Syntax: Identifier[Line index, column index].vld
Description: Vld properties
Example
Var1[2,3].val=1.203
If the line and column indices are not specified, the indices of the focused cell apply. This
corresponds to:
Var1.Row =2
Var1.Col=3
Var1.val=1.203

7.4 Custom widgets
7.4 Custom widgets
7.4.1 Defining custom widgets
Description
User-specific display elements are configured in the dialog using a custom widget.
Software option
In order to use custom widgets in dialog boxes, you require the following additional
software option:
"SINUMERIK Integrate Run MyHMI /3GL" (6FC5800-0AP60-0YB0)
Programming
Definition: DEF (name)

Syntax: (W///"","(library name).(class name)"/////a,b,c,d);
Description: W Defining custom widgets
Parameters: Name Custom widget name, freely selectable
Library name Can be freely selected, name of the dll (Windows) or
(Linux) library file
Class name Freely selectable, name of the class function from the
previously named library
a, b, c, d Position and size of the configuration
Example
A custom widget is defined in the dialog configuration in the following way:
DEF Cus = (W///"","slestestcustomwidget.SlEsTestCustomWidget"/////
20,20,250,100);
7.4.2 Structure of the custom widget library
Description
Essentially, the custom widget library contains a defined class. The name of this class must
be specified in the dialog configuration in addition to the library names. Starting from library
names, "Run MyScreens" accesses a dll file with the same name, e.g.:
slestestcustomwidget.dll

7.4 Custom widgets
Programming
The class definition of the dll file should look like this:
#define SLESTESTCUSTOMWIDGET_EXPORT Q_DECL_EXPORT
class SLESTESTCUSTOMWIDGET_EXPORT SlEsTestCustomWidget : public QWidget

{
Q_OBJECT
....
public slots:
bool serialize(const QString& szFilePath, bool bIsStoring);
....
}
7.4.3 Structure of the custom widget interface
Description
The library is supplemented by an interface in order to display the custom widget in the dialog.
This contains macro definitions with which "Run MyScreens" initiates the custom widget. The
interface is available in the form of a cpp file. The file name can be freely selected, e.g.:
sleswidgetfactory.cpp
Programming
The interface is defined as follows:
#include "slestestcustomwidget.h" ; The header file for the relevant custom widg-
ets is inserted at the beginning of the file
....
//Makros ; Macro definitions are not changed
....
WIDGET_CLASS_EXPORT(SlEsTestCustom- ; The relevant custom widget is declared at
Widget) the end of the file
Example
Content of the file sleswidgetfactory.cpp for a custom widget with the class name
SlEsTestCustomWidget":
#include <Qt/qglobal.h>
#include "slestestcustomwidget.h"

7.4 Custom widgets
///////////////////////////////////////////////////////////////////////////
// MAKROS FOR PLUGIN DLL-EXPORT - DO NOT CHANGE
///////////////////////////////////////////////////////////////////////////
#ifndef Q_EXTERN_C
#ifdef __cplusplus
#define Q_EXTERN_C extern "C"
#else
#define Q_EXTERN_C extern
#endif
#endif
#define SL_ES_FCT_NAME(PLUGIN) sl_es_create_ ##PLUGIN

#define SL_ES_CUSTOM_WIDGET_PLUGIN_INSTANTIATE( IMPLEMENTATION , PARAM) \
{ \
IMPLEMENTATION *i = new PARAM; \
return i; \
}
#ifdef Q_WS_WIN
# ifdef Q_CC_BOR
# define EXPORT_SL_ES_CUSTOM_WIDGET_PLUGIN(PLUGIN,PARAM) \
Q_EXTERN_C __declspec(dllexport) void* \
__stdcall SL_ES_FCT_NAME(PLUGIN) (QWidget* pParent) \
SL_ES_CUSTOM_WIDGET_PLUGIN_INSTANTIATE( PLUGIN,PARAM )
# else
Q_EXTERN_C __declspec(dllexport) void* SL_ES_FCT_NAME(PLUGIN) \
(QWidget* pParent) \
# endif
#else
Q_EXTERN_C void* SL_ES_FCT_NAME(PLUGIN) (QWidget* pParent) \
#endif
#define WIDGET_CLASS_EXPORT(CLASSNAME) \
EXPORT_SL_ES_CUSTOM_WIDGET_PLUGIN(CLASSNAME,CLASSNAME(pParent))
///////////////////////////////////////////////////////////////////////////
// FOR OEM USER - please declare here your widget classes for export
///////////////////////////////////////////////////////////////////////////

7.4 Custom widgets
WIDGET_CLASS_EXPORT(SlEsTestCustomWidget)
7.4.4 Interaction between custom widget and dialog box - Automatic data exchange
Custom widgets interact with dialog boxes and can display values or manipulate them.
Conditions
Automatic data exchange takes place under the following conditions:
Condition Direction
When starting or recompiling a dialog Dialog → custom widget
When executing the GC command for generating cycle calls Custom widget → Dialog
Programming
The following definitions are necessary for the interaction:
Expansion of the dialog configuration
Definition: DEF (variable)

Syntax: ((type)//5/"","(variable)",""/wr2/)
Variable type: Type Standard input field (no grid or toggle) with any data type
(no W)
Parameters: Variable Any designation of a variable for data exchange
Input mode: wr2 Reading and writing
Example
DEF CUSVAR1 = (R//5/"","CUSVAR1",""/wr2/)
Expansion of the class definition

In the class definition of the custom widgets, a QProperty must be created whose name is
identical to the selected variable of the dialog configuration, e.g.:
Q_PROPERTY(double CUSVAR1 READ cusVar1 WRITE setCusVar1);
Example
The class definition of the dll file should look like this:
#define SLESTESTCUSTOMWIDGET_EXPORT Q_DECL_EXPORT

7.4 Custom widgets
{
Q_OBJECT
Q_PROPERTY(double CUSVAR1 READ cusVar1 WRITE setCusVar1);
....
....
}
7.4.5 Interaction between custom widget and dialog box - Manual data exchange
Besides automatic data exchange, manual data exchange is also possible. Data exchange is
dynamic, i.e. takes place while the dialog box is running. The following actions are possible:
● Properties of the custom widget can be read and written.
● Methods of the custom widget can be called from the Run MyScreens configuration.
● A response to a particular signal of the custom widget can be implemented in order to call
subprograms (SUB) in the Run MyScreens configuration.
7.4.5.1 Reading and writing properties
Description
The functions ReadCWProperties and WriteCWProperties are provided in the Run MyScreens
configuration for reading and writing properties of the custom widgets.
Programming
Syntax:
ReadCWProperty("Variablename", "Propertyname")
Description: Reading a property of a custom widget

Parameters: Variablename Name of a dialog box variable to which a custom widget
is assigned
Propertyname Name of the custom widget property to be read
Return value: Current value of the custom widget property
Syntax:
WriteCWProperty("Variablename", "Propertyname", "Value")
Description: Writing the property of a custom widget

7.4 Custom widgets
Parameters: Variable name Name of a dialog box variable to which a custom widget
is assigned
Propertyname Name of the custom widget property to be written
Value Value to be written to the property of the custom widget
Examples
Example 1:
Read property "MyStringVar" of the custom widget that is linked to dialog box variable
"MyCWVar1" and assign the value to register 7.
Custom widget class declaration:

{
Q_OBJECT
Q_PROPERTY(QString MyStringVar
READ myStringVar
WRITE setMyStringVar);
...
Dialog box configuration:
DEF MyCWVar1 = (W///,"slestestcustomwidget.SlEsTestCustomWidget")

PRESS(VS1)
REG[7]=ReadCWProperty("MyCWVar1", "MyStringVar")
END_PRESS
Example 2:
Write the result of the calculation "3 + sin(123.456)" into property "MyRealVar" of the custom
widget that is linked to dialog box variable "MyCWVar1."

{
Q_OBJECT
Q_PROPERTY(double MyRealVar
READ myRealVar
WRITE setMyRealVar);
...

PRESS(VS1)
WriteCWProperty("MyCWVar1", "MyRealVar", 3 + sin(123.456))

7.4 Custom widgets

END_PRESS
7.4.5.2 Executing a method of the custom widget
Description
The function CallCWMethod is available in the Run MyScreens configuration for executing
methods of the custom widget.
The custom widget method to be called must have no more than 10 transfer parameters.
The following transfer parameter data formats are supported:
● bool
● uint
● int
● double
● QString
● QByteArray
Programming
Syntax: CallCWMethod("Variablename", "Methodname[, Argument 0][, Argument 1 …

[,Argument 9]")
Description: Calling a custom widget method
is assigned
Method name Name of the custom widget name to be called
Argument 0 - 9 Transfer parameter for the custom widget method
Supported data formats: see above
Note: The transfer parameters are always transferred
with "ByVal," i.e. only the value is transferred and not,
for example, the reference to a variable.
Return value: Return value of the custom widget method
● void
● bool
● uint
● int
● double
● QString
● QByteArray
Note: Even if the data format of the return value of the custom widget method
is "void," it must be formally assigned to a variable, for example.

7.4 Custom widgets
Example

{
Q_OBJECT
public slots:
void myFunc1(int nValue, const QString& szString, double dValue);
...

DEF MyStringVar1 = (S)
DEF MyRealVar = (R)
PRESS(VS3)
REG[9] = CallCWMethod("MyCWVar1", "myFunc1", 1+7, MyStringVar1, sin(MyRealVar) –
8)
END_PRESS
Note
The custom widget must implement the "serialize" method. Here, you have the option of writing
the internal data of a custom widget
to a specified file, or restoring it again. This is especially necessary, if, with the "Run
MyScreens" screen open, you change to another operating area and then return again.
Otherwise, internal data are lost when redisplaying.
Syntax: public slots:

bool serialize(const QString& szFilePath, bool bIsStoring);
Description: Reading and writing internal data and states to and from a file
Parameter: szFilePath Name of the file with complete path data, in which the
internal data and states of the custom widget are written
to – or from which they are to be read.
If necessary, the file must create the custom widget itself.
bIsStoring TRUE = write
FALSE = read
Example
bool SlEsTestCustomWidget::serialize(const QString& szFilePath, bool bIsStoring)

{
QFileInfo fi(szFilePath);
bool bReturn = false;
QDir dir;
if (dir.mkpath(fi.canonicalPath()))
{

7.4 Custom widgets
bool SlEsTestCustomWidget::serialize(const QString& szFilePath, bool bIsStoring)

QFile fileData(szFilePath);
QIODevice::OpenMode mode;
if (bIsStoring)
{
mode = QIODevice::WriteOnly;
}
else
{
mode = QIODevice::ReadOnly;
}
if (fileData.open(mode))
{
QDataStream streamData;
streamData.setDevice(&fileData);
if (bIsStoring)
{
streamData << m_nDataCount << m_dValueX;
}
else
{
streamData >> m_nDataCount >> m_dValueX;
}
streamData.setDevice(0);
fileData.flush();
fileData.close();
bReturn = true;
}
}
return bReturn;
}
7.4.5.3 Response to a custom widget signal
Description
In Run MyScreens it is possible to respond to a particular signal (invokeSub()) of the custom
widget and call up a subprogram (SUB).
10 global variables, the so-called SIGARG, are available for passing values (custom widget
signal -> SUB), which are comparable to registers (REG) in configuration. This is where the
values transferred with the custom widget signal are stored.

7.4 Custom widgets

● bool
● uint
● int
● double
● QString
● QByteArray
Programming
Calling the subroutine:
Syntax: void invokeSub(const QString& rszSignalName, const

QVariantList& rvntList);
Description: Custom widget signal with which a Run MyScreens subprogram is called.
Parameters: rszSignalName Name of the Run MyScreens subprogram to be called
rvntList QVariantList array for transferring parameters that are
stored in the global parameter SIGARG and which are
available in the configuration.
Maximum size: 10 elements
Data formats supported: see above
Note: The transfer parameters are always passed "By‐
Val," i.e. only the value and not, for example, the refer‐
ence to a variable is passed.
Subroutine to be called:
Syntax: SUB(on_<Variablename>_<Signalname>)
…
END_SUB
Description: Response to a custom widget signal
is assigned.
Signal name Name of the custom widget signal
SIGARG 0 - 9 Transfer parameters for the custom widget method.
Supported data formats: See above
Note: The transfer parameters are always passed "By‐
Val," i.e. only the value and not, for example, the refer‐
ence to a variable is passed.
Example
Topic, "Formatting error", Page 210, Chapter "Response to a Custom Widget signal", Section
"Example"
In this case, formatting/indentation is not correct. Correct would be:

7.5 SIEsGraphCustomWidget
Customer widget class declaration:
Customer widget class declaration:

{
Q_OBJECT
signals:
void invokeSub(const QString& szSubName, const QVariantList& vntList);
…
}
Custom widget class:
QVariantList vntList;
vntList << 123.456;
emit invokeSub("MySub", vntList);

SUB(on_MyCWVar1_MySub)
DEBUG("SUB(on_MyCWVar1_MySub) was called with parameter: """ << SIGARG[0] <<
"""")
END_SUB
Result easyscreen_log.txt:
[10:22:40.445] DEBUG: SUB(on_MyCWVar1_MySub) was called with parameter: "123.456"
7.5.1 SIEsGraphCustomWidget
General
Using SlEsGraphCustomWidget, you can display geometrical objects (point, line, square,
square with rounded corners, ellipse, arc, text) and curves from interpolation points (e.g.
measured values, characteristic).
The objects are organized in one or several contours. These can then be displayed, either
individually or combined; they can also be entered, selected and deleted.
Using functions, the objects are added to the currently selected contour, and these are then
drawn in this particular sequence. If you wish to draw the object in a specific color, then you

must set the appropriate pen color before adding. All objects subsequently added will be drawn
in this pen color. In addition to the pen color, you can also influence the pen width and pen
style. For closed objects such as square, square with rounded edges and ellipse, before adding
the objects you can set a fill color.
Every contour can be brought into various modes:
● Standard display of all object types.
● Points can be connected to create a polyline, and can therefore be displayed as curve/graph.
● The area between points, lines or arcs up to the X axis can be filled in with the currently
selected fill color. For instance, you can use this option to visualize residual material when
turning.
If, in this mode, points are displayed in addition as polyline, then the complete area below
the curve up to the X axis is filled. The points, lines and arcs can be located in all four
quadrants.
You can move along one or several contours using a special cursor mode. To do this, the
cursor is set to the first or last point object of a contour or, starting from the actual cursor position
is moved either forward or backward within the contour of a point object.
When required, a second Y axis (right) can be displayed with its own scaling. This is coupled
to the first Y axis (left) through an offset and a factor.
Based on a specified X coordinate, using a search function, a point previously added to the
contour can be found, and if required, the cursor can be set to this point.
You can also configure contours as ring buffer with an adjustable size.
As a result of the serialization, the actual state of the SlEsGraphCustomWidget can be saved
in a file in binary form - and also restored.
The SlEsGraphCustomWidget can be operated using the "Pan" gesture (where the view is
shifted) and the "Pinch"/"Spread" gestures (zooming in and out of the view).
Using the mouse, you can shift the view (left mouse button + Move), and you can zoom in and
out (mouse wheel).
For performance reasons, the display is not automatically refreshed. Depending on the
particular application, you can initiate the refresh by calling the appropriate function.

Example
Figure 7-1 SlEsGraphCustomWidget example
//M(MyGraphSampleMask/"SlEsGraphCustomWidget Sample")
DEF MyGraphVar = (W///,"slesgraphcustomwidget.SlEsGraphCustomWidget"/////10,10,340,340/0,0,0,0)
VS1=("Add objects",,se1)
LOAD
WRITECWPROPERTY("MyGraphVar", "AxisNameX", "X")
WRITECWPROPERTY("MyGraphVar", "AxisNameY", "Y")
WRITECWPROPERTY("MyGraphVar", "ScaleTextOrientationYAxis", 2)
WRITECWPROPERTY("MyGraphVar", "KeepAspectRatio", TRUE)
REG[0]= CALLCWMETHOD("MyGraphVar", "addContour", "MyContour", TRUE)

REG[0]= CALLCWMETHOD("MyGraphVar", "showContour", "MyContour")
REG[0]= CALLCWMETHOD("MyGraphVar", "setView", -35, -35, 150, 150)
END_LOAD
PRESS(VS1)
REG[0]= CALLCWMETHOD("MyGraphVar", "addLine", 10, 20, 40, 20)
REG[0]= CALLCWMETHOD("MyGraphVar", "addRect", 25, 100, 50, 75)
REG[0]= CALLCWMETHOD("MyGraphVar", "setPenColor", "#ff0000");red
REG[0]= CALLCWMETHOD("MyGraphVar", "setFillColor", "#ffff00");yellow
REG[0]= CALLCWMETHOD("MyGraphVar", "addCircle", -12.5, 62.5, 12.5)
REG[0]= CALLCWMETHOD("MyGraphVar", "setFillColor");off/default
REG[0]= CALLCWMETHOD("MyGraphVar", "setPenColor");off/default

//M(MyGraphSampleMask/"SlEsGraphCustomWidget Sample")
REG[0]= CALLCWMETHOD("MyGraphVar", "addArc", 100, 37.5, 125, 62.5, 0, 180)
REG[0]= CALLCWMETHOD("MyGraphVar", "update")
END_PRESS
7.5.2 Notes regarding performance

Depending on the hardware used and the basic utilization of the system, when using
SlEsGraphCustomWidgets you must observe the following guide values. In addition to the
hardware being used and the basic utilization, the values vary depending on the
SIEsGraphCustomWidgets configuration.
Observe these guide values so that the response and stability of the overall system are not
diminished.
● Number of SlEsGraphCustomWidgets configured simultaneously (e.g. a maximum of 1)
● Number of configured contours (e.g. a maximum of 6)
● Number of configured graphic objects per contour (e.g. maximum of 1000)
● Frequency of the requested refresh operations (e.g. max. 500 ms)
Note
The display is not real-time capable.
7.5.3 Reading and writing properties
Description
The properties listed in the following section can be read with ReadCWProperty() and written
with WriteCWProperty().
Examples
Reading the "CursorX" property of the SlEsGraphCustomWidget linked using display variable
"MyGraphVar". The result is written to register 0.
REG[0] = ReadCWProperty("MyGraphVar", "CursorX")
Writes value "MyFirstContour" to the "SelectedContour" property of the

SlEsGraphCustomWidget linked using display variable "MyGraphVar".
WriteCWProperty("MyGraphVar ", "SelectedContour", "MyFirstContour")

7.5.4 Properties
Overview
Property Description
AxisNameX Axis identifiers, X axis
AxisNameY Axis identifiers, Y axis
AxisNameY2 Axis identifiers, second Y axis (right)
AxisY2Visible Display/hide second Y axis (right)
AxisY2Offset Offset second Y axis (right)
AxisY2Factor Factor second Y axis (right)
ScaleTextEmbedded Position of the scaling texts
ScaleTextOrientationYAxis Alignment of the scaling texts of the Y axis
KeepAspectRatio Keep aspect ratios
SelectedContour Name of the currently selected contour
BackColor Background color
ChartBackColor Background color of the drawing area
ForeColor Foreground color for text and default pen color
ForeColorY2 Foreground color for the texts of the second Y axis (right)
GridColor Color of the grid lines
GridColorY2 Color of the horizontal grid lines of the second Y axis (right)
CursorColor Color of the cursor crosshairs
ShowCursor Display/hide cursor
CursorX Cursor X position
CursorY Cursor Y position
CursorY2 Cursor Y position referred to the second Y axis (right)
CursorStyle Cursor display type
ViewMoveZoomMode Response when zooming and shifting using gestures
AxisNameX – axis identifiers, X axis
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "AxisNameX")

WriteCWProperty(GraphVarName, "AxisNameX", Value)
Description: Reads or sets the identifier of the X axis. If an identifier is not specified, then
the space available for the drawing area is fully utilized.
Parameter: GraphVarName Name of the display variable which contains a SlEs‐
GraphCustomWidget
Return Value Read value of the property (QString)
Value Value to be set (QString)

AxisNameX – axis identifiers, Y axis
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "AxisNameY")

WriteCWProperty(GraphVarName, "AxisNameY", Value)
Description: Reads or sets the identifier of the Y axis. If an identifier is not specified, then
the space available for the drawing area is fully utilized.
GraphCustomWidget
AxisY2Visible – display/hide second Y axis (right)
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "AxisY2Visible")

WriteCWProperty(GraphVarName, "AxisY2Visible", Value)
Description: Displays/hides second Y axis (right)
GraphCustomWidget
Return Value Read value of the property (bool)
Value Value to be set (bool): TRUE or FALSE
AxisY2Offset – offset second Y axis (right)
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "AxisY2Offset")

WriteCWProperty(GraphVarName, "AxisY2Offset", Value)
Description: Offset of the second Y axis (right) referred to the first Y axis (left).
See example for AxisY2Factor property.
GraphCustomWidget
Return Value Read value of the property (double)
Value Value to be set (double).
AxisY2Factor – factor second Y axis (right)
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "AxisY2Factor") Write‐

CWProperty(GraphVarName, "AxisY2Factor", Value)
Description: Factor of the second Y axis (right) referred to the first Y axis (left).
Parameters: GraphVarName Name of the display variable which contains a SlEs‐
GraphCustomWidget
Together with the "AxisY2Offset" property, it is possible to display a second Y axis (right) with
its own scaling. The scale is coupled coupled to the first Y axis (left) through an offset and a
factor.
Formula for converting Y2 to Y:

Y = Y2 / factor - offset
Formula for converting Y to Y2:
Y2 = (Y + offset) * factor
Figure 7-2 Example with second Y axis with own scaling
Example
Y: 0 to 200 should correspond to Y2: -25 to 25.
● Offset: -100
● Factor: 0.25
Calculation example:
Y2 = -30
Y = -30 / 0.25 – (-100) = -20
Calculation example:
Y=0
Y2 = (0 + (-100)) * 0.25 = -25
The X axis is the same for both coordinate systems.

You can set the colors using setForeColorY2() and setGridColorY2() (see colors).
The axes are labeled with setAxisNameY2() (see axis identifiers).

ScaleTextEmbedded - position of the scaling texts
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "ScaleTextEmbedded")

WriteCWProperty(GraphVarName, "ScaleTextEmbedded", Value)
Description: Using this property you define whether the scaling is positioned inside or outside
the drawing area.
GraphCustomWidget
Example
Scaling text outside the drawing area:
ScaleTextEmbedded = FALSE
Figure 7-3 Scaling text outside the drawing area
Scaling text within the drawing area:

ScaleTextEmbedded = TRUE
Figure 7-4 Scaling text within the drawing area:

ScaleTextOrientationYAxis - alignment of the scaling texts of the Y axis
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "ScaleTextOrientationYAx‐

is")
WriteCWProperty(GraphVarName, "ScaleTextOrientationYAxis", Value)
Description: Using this function, the scaling texts of the Y axis are aligned vertically.
GraphCustomWidget
Return Value Read value of the property (int)
Value Value to be set (int): 1 (= horizontal) or 2 (= vertical)
Example
Scaling text within the drawing area:
● ScaleTextEmbedded = TRUE
Horizontal text alignment:
● ScaleTextOrientationYAxis = 1
Figure 7-5 Scaling text within the drawing area, horizontal text alignment
Vertical text alignment:

Figure 7-6 Scaling text within the drawing area, vertical text alignment

Scaling text outside the drawing area:

● ScaleTextEmbedded = FALSE
Horizontal text alignment:
Figure 7-7 Scaling text outside the drawing area, horizontal text alignment
Vertical text alignment:

Figure 7-8 Scaling text outside the drawing area, vertical text alignment
KeepAspectRatio – keep aspect ratio
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "KeepAspectRatio")

WriteCWProperty(GraphVarName, "KeepAspectRatio", Value)
Description: With this property, you define as to whether the view defined using setView()
should be automatically aligned, adapted or extended, so that the aspect ratio
from X to Y axis always remains the same. This property is especially relevant
when displaying geometrical figures. For example, a circle or square is displayed
as such, and does not become an ellipse or rectangle.


GraphCustomWidget
Return Value Value to be set (bool): TRUE or FALSE
Example
setView(-15, -15, 15, 15)
setFillColor("#A0A0A4")
addCircle(0, 0, 5)
KeepAspectRatio = TRUE
Figure 7-9 Aspect ratio from X to Y axis remain the same
KeepAspectRatio = TRUE
Figure 7-10 Aspect ratio from X to Y axis distorted
SelectedContour – name of the currently selected contour
Syntax: ReturnValue = ReadCWProperty(GraphVarName, " SelectedContour")

WriteCWProperty(GraphVarName, " SelectedContour", Value)
Description: Reads or sets the selection of the actual contour.


GraphCustomWidget
Note
In order to be able to execute operations on a contour, e.g. to add a graphic object, you must
first select this.
BackColor – background color
Syntax: ReturnValue = ReadCWProperty(GraphVarName, " BackColor")

WriteCWProperty(GraphVarName, " BackColor", Value)
Description: The background color for labeling axes depends on the ScaleTextInsideChar‐
tArea property - also the scaling texts.
GraphCustomWidget
Value Value to be set (QString) as RGB value in the form
"#RRGGBB", for example, "#04B7FB"
ChartBackColor – background color of the drawing area
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "ChartBackColor")

WriteCWProperty(GraphVarName, "ChartBackColor", Value)
Description: Background color for the drawing area.
GraphCustomWidget
ForeColor - foreground color for labeling and default pen color
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "ForeColor")

WriteCWProperty(GraphVarName, "ForeColor", Value)
Description: Foreground color for text and default pen color
GraphCustomWidget

ForeColorY2 - foreground color for labeling the second Y axis (right)
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "ForeColorY2")

WriteCWProperty(GraphVarName, "ForeColorY2", Value)
Description: Foreground color for the texts of the second Y axis (right)
GraphCustomWidget
GridColor - color of the grid lines
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "GridColor")

WriteCWProperty(GraphVarName, "GridColor", Value)
Description: Color of the grid lines.
GraphCustomWidget
GridColorY2 - color of the horizontal grid lines of the second Y axis (right)
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "GridColorY2")

WriteCWProperty(GraphVarName, "GridColorY2", Value)
Description: Color of the horizontal grid lines of the second Y axis (right).
GraphCustomWidget
CursorColor - color of the cursor
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "CursorColor")

WriteCWProperty(GraphVarName, "CursorColor", Value)
Description: Color of the cursor.
GraphCustomWidget

ShowCursor - Display/hide cursor
Syntax: ReturnValue = ReadCWProperty(GraphVarName, " ShowCursor")

WriteCWProperty(GraphVarName, " ShowCursor", Value)
Description: Displays/hides cursor.
GraphCustomWidget
Note
This function automatically refreshes the display.
CursorX – cursor X position
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "CursorX")

WriteCWProperty(GraphVarName, "CursorX", Value)
Description: X position of the cursor.
GraphCustomWidget
Note
CursorY – cursor Y position
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "CursorY")

WriteCWProperty(GraphVarName, "CursorY", Value)
Description: Y position of the cursor.
GraphCustomWidget
Note

CursorY2 - cursor Y position referred to the second Y axis (right)
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "CursorY2")

WriteCWProperty(GraphVarName, "CursorY2", Value)
Description: Y position of the cursor referred to the second Y axis (right).
GraphCustomWidget
Note
CursorStyle – cursor display type
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "CursorStyle")

WriteCWProperty(GraphVarName, "CursorStyle", Value)
Description: Cursor display type.
GraphCustomWidget
Value Value to be set (int):
0 (= cross)
1 (= crosshairs)
2 (= vertical line)
3 (= horizontal line)
4 (= horizontal and vertical line))
ViewMoveZoomMode – response when zooming and shifting using gestures
Syntax: ReturnValue = ReadCWProperty(GraphVarName, "ViewMoveZoomMode")

WriteCWProperty(GraphVarName, "ViewMoveZoomMode", Value)
Description: The displayed view of the SlEsGraphCustomWidgets can be changed using
gestures. This property allows you to define which type should be permitted. For
example, in certain applications it may make sense that the view is only horizon‐
tally shifted and zoomed, e.g. when displaying measured value characteristics.
GraphCustomWidget
Value Value to be set (int):
0 (= off)
1 (= only horizontal)
2 (= only vertical)
3 (= horizontal and vertical)

7.5.5 Functions
You can call the subsequently listed functions using the CallCWMethod() function.
Example
Setting the view of the SlEsGraphCustomWidget link using display variable "MyGraphVar".
The result is written to register 0.
REG[0] = CallCWMethod("MyGraphVar", "setView", -8, -5, 11- 20)
Overview
Function Description
setView Sets coordinate system
setMaxContourObjects Sets maximum number of objects for a contour (ring buffer)
addContour Adds a contour
showContour Shows a contour
hideContour Hides a contour
hideAllContours Hides all contours
removeContour Removes a contour
clearContour Deletes graphic object of a contour
fitViewToContours Automatic adaptation of the view
fitViewToContour Automatic adaptation of the view
findX Searches in a contour
setPolylineMode Displays points of a contour as polyline/curve
setIntegralFillMode Displays points of a contour as polyline/curve
repaint, update Refreshes view
addPoint Adds a point to a contour
addLine Adds a line to a contour
addRect Adds a rectangle to a contour
addRoundedRect Adds a rectangle with rounded corners to a contour
addEllipse Adds an ellipse to a contour
addCircle Adds a circle to a contour
addArc Adds an arc to a contour
addText Adds text to a contour
setPenWidth Sets the pen width
setPenStyle Sets the pen style
setPenColor Sets the pen color
setFillColor Sets fill color
setCursorPosition Positions the cursor
setCursorPositionY2 Positions the cursor referred to the second Y axis (right)
setCursorOnContour Positions the cursor on contour
moveCursorOnContourBegin Positions the cursor to the first graphic object of a contour
moveCursorOnContourEnd Positions the cursor to the last graphic object of a contour

moveCursorOnContourNext Positions the cursor to the next graphic object of a contour
serialize Saves/restores the actual state
setView – sets the coordinate system
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setView", x1, y1, x2, y2)

Description: Using this function, you define the size of the coordinate system that should be
displayed within the SlEsGraphCustomWidget. See also KeepAspectRatio prop‐
erty.
GraphCustomWidget
Return Value Error code (bool): TRUE = successful
x1 left-hand edge (double)
y1 upper edge (double)
x2 right-hand edge (double)
y2 lower edge (double)
Note
Example
setView(-8, -5, 11, 20)

AxisNameX = "X"
AxisNameY = "Y"
ScaleTextOrientationYAxis = 1
ScaleTextEmbedded = false
KeepAspectRatio = false
update

Figure 7-11 Example - setView
setMaxContourObjects – sets the maximum number of objects of a contour (ring buffer)
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setMaxContourObjects", Val‐

ue)
ReturnValue = CallCWMethod(GraphVarName, "setMaxContourObjects", Val‐
ue, ContourName)
Description: Using this function, you can define the size of a contour ring buffer. If the number
of objects added to the contour exceeds this limit, then the oldest object is de‐
leted.
GraphCustomWidget
Value Maximum number of graphic objects (uint)
ContourName Name of the contour (QString).
If a contour is not specified, then the call automatically
refers to the currently selected contour.
Note
addContour – add contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addContour", ContourName)

ReturnValue = CallCWMethod(GraphVarName, "addContour", ContourName,
Selected)
ReturnValue = CallCWMethod(GraphVarName, "addContour", ContourName,
Selected, AssignedY2)
Description: Using this function, you can define a new contour.
Optionally, you can assign the contour to the coordinate system of the second
Y axis (right).


GraphCustomWidget
Selected Contour should be selected (bool): TRUE or FALSE
AssignedY2 Contour should be assigned to the second Y axis (right)
(bool): TRUE or FALSE
showContour – shows a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "showContour")

ReturnValue = CallCWMethod(GraphVarName, "showContour", ContourName)
Description: This function makes a contour visible.
GraphCustomWidget
hideContour – hide contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "hideContour")

ReturnValue = CallCWMethod(GraphVarName, "hideContour", ContourName)
Description: This function hides a contour.
GraphCustomWidget
showAllContours – shows all contours
Syntax: ReturnValue = CallCWMethod(GraphVarName, "showAllContours")

Description: This function makes all contours visible.
GraphCustomWidget

hideAllContours – hide all contours
Syntax: ReturnValue = CallCWMethod(GraphVarName, "hideAllContours")

Description: This function hides all contours.
GraphCustomWidget
removeContour – hides a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "removeContour")

ReturnValue = CallCWMethod(GraphVarName, "removeContour", Contour‐
Name)
Description: Removes a contour.
GraphCustomWidget
clearContour – delete graphic object of a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "clearContour")

ReturnValue = CallCWMethod(GraphVarName, "clearContour", ContourName)
Description: Deletes all graphic objects on a contour.
GraphCustomWidget
fitViewToContours – automatic adaptation of the view
Syntax: ReturnValue = CallCWMethod(GraphVarName, "fitViewToContours")

ReturnValue = CallCWMethod(GraphVarName, "fitViewToContours", OnlyVisi‐
ble)
Description: Using this function, the view is automatically adapted to the contours. Depending
on the transfer parameter, you define whether only all visible contours can be
seen or all contours can be seen.
GraphCustomWidget
OnlyVisible Value to be set (bool): TRUE or FALSE

fitViewToContour – automatic adaptation of the view
Syntax: ReturnValue = CallCWMethod(GraphVarName, "fitViewToContour", Contour‐

Name)
Description: Using this function, the view is automatically adapted so that only a specific
contours visible.
GraphCustomWidget
ContourName Name of the contour (QString)
findX – search in a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "findX", x)

ReturnValue = CallCWMethod(GraphVarName, "findX", x, ContourName)
ReturnValue = CallCWMethod(GraphVarName, "findX", x, ContourName, Set‐
Cursor)
Description: Using this function, you can search for a previously defined point with a specific
X coordinate in a contour. You obtain the Y coordinate as result. Optionally, you
can also simultaneously position the cursor to this point.
GraphCustomWidget
Return Value Error code (QString): If successful, the associated Y val‐
ue is supplied
x X value to be searched for (double)
refers to the currently selected contour
SetCursor Set cursor (bool): TRUE or FALSE
Note
The display is automatically updated if you set the cursor using this function.
setPolylineMode – displays points on the contour as polyline/curve
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setPolylineMode", SetPoly)

Description: All of the points of the actual contour added after this function call are connected
to create a polyline/curve. This function is contour-specific, and can be activated
and deactivated on a segment-for-segment basis.
GraphCustomWidget
SetPoly PolylineMode (bool): TRUE = on

Example
Figure 7-12 Example - PolylineMode: Off
Figure 7-13 Example - PolylineMode: To
setIntegralFillMode – fills the areas between points, lines and arcs and the X axis
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setIntegralFillMode", SetIntFill)

Description: Areas between points, lines and arcs of the X axis are filled with the current fill
color (independent of whether the points are +Y or –Y).
This function is contour-specific, and can be activated and deactivated on a seg‐
ment-for-segment basis.
GraphCustomWidget
SetIntFill IntegralFillMode (bool): TRUE = on
Example
Figure 7-14 Example - setIntegralFillMode: on

Figure 7-15 Example - setIntegralFillMode: Off
repaint, update – update view
Syntax: ReturnValue = CallCWMethod(GraphVarName, "repaint")

ReturnValue = CallCWMethod(GraphVarName, "update")
Description: Using this function, you can manually refresh the display.
GraphCustomWidget
● update()
The function refreshes the view, assuming that the Widget refresh is not deactivated, and
the Widget is not hidden. The function is optimized so that the application performance is
maintained, and the view does not flicker as a result of excessively high refresh rates.
● repaint()
The function refreshes the view directly after the function call. Therefore, you should only
use the repaint function if an immediate refresh is absolutely necessary, e.g. for animation
purposes
It is recommended that you always work with the update() function. Internally, the
SlEsGraphCustomWidget always works with the function update() e.g. for setView().
addPoint – add point to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addPoint", x, y)

ReturnValue = CallCWMethod(GraphVarName, "addPoint", x, y, DummyPoint)
Description: Adds a point to the currently selected contour Further, you can set a dummy
point; although it does not show up in the drawing, it can be positioned with the
cursor.
GraphCustomWidget
x x coordinate (double)
y y coordinate (double)
DummyPoint Point is treated as invisible (bool): TRUE = yes

addLine – add line to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addLine", x1, y1, x2, y2)

Description: Adds a line to the currently selected contour
GraphCustomWidget
x1 x coordinate of the starting point (double)
y1 y coordinate of the starting point (double)
x2 x coordinate of the end point (double)
y2 y coordinate of the end point (double)
addRect – add rectangle to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addRect", x1, y1, x2, y2)

Description: Adds a rectangle to the currently selected contour.
GraphCustomWidget
y1 left-hand edge (double)
addRoundedRect – add rectangle with rounded corners to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addRoundedRect", x1, y1, x2,

y2, r)
Description: Adds a rectangle with rounded off corners to the currently selected contour.
GraphCustomWidget
x2 upper edge (double)
r Radius (double)
addElipse – add ellipse to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addEllipse", x1, y1, x2, y2, ra‐

dius)
Description: Adds an ellipse to the currently selected contour.


GraphCustomWidget
Radius Radius (double)
addCircle – add circle to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addCircle", x, y, radius)

Description: Adds a circle to the currently selected contour
GraphCustomWidget
x left-hand edge (double)
y upper edge (double)
Radius Radius (double)
addArc – add arc to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addArc", x1, y1, x2, y2, Star‐

tAngle, SpanAngle
Description: Adds an arc to the currently selected contour
GraphCustomWidget
StartAngle Starting angle in degrees (double)
SpanAngle Opening angle in degrees (double)
addText – add text to a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "addText", x, y, Text)

Description: Adds a text to the currently selected contour


GraphCustomWidget
x left-hand edge (double)
y upper edge (double)
Text Text (QString)
setPenWidth – sets the pen width
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setPenWidth") ReturnValue =

CallCWMethod(GraphVarName, "setPenWidth", width)
Description: Defines the pen width from the instant that the function was called for the follow‐
ing objects that were added to the actual contour.
GraphCustomWidget
width Pen width (double).
If a pen width is not specified, then the default pen width
is set.
setPenStyle – sets the pen style
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setPenStyle")

ReturnValue = CallCWMethod(GraphVarName, "setPenStyle", style)
Description: Defines pen style from the instant that the function is called for the following
objects that are added to the actual contour.
GraphCustomWidget
style 1 : Solid line (___)
2 : Interrupted line (_ _)
3 : Dotted line (...)
4 : Line-point-line (_._)
5 : Line-point-point (_..)
setPenColor – sets the pen color
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setPenColor")

ReturnValue = CallCWMethod(GraphVarName, "setPenColor", Color)
Description: Defines the pen color from the instant that the function was called for the following
objects that were added to the actual contour.


GraphCustomWidget
Color Value to be set (QString) as RGB value in the form
setFillColor – set fill color
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setFillColor")

ReturnValue = CallCWMethod(GraphVarName, "setFillColor", Color)
Description: Defines the fill color from the instant that the function was called for the following
objects that were added to the actual contour.
GraphCustomWidget
Color Value to be set (QString) as RGB value in the form
setCursorPosition – position cursor
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setCursorPosition", x, y)

Description: Sets the cursor to the specified position.
GraphCustomWidget
y y coordinate (double)
Note
setCursorPositionY2Cursor – position cursor referred to the second Y axis (right)
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setCursorPositionY2", x, y2)

Description: Sets the cursor to the specified position referred to the second Y axis (right)
GraphCustomWidget
y2 Y coordinate referred to the second Y axis (right) (double)

Note
setCursorOnContour – position cursor on contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "setCursorOnContour")

ReturnValue = CallCWMethod(GraphVarName, "setCursorOnContour", Con‐
tourName)
Description: Sets the cursor to the last cursor position within a contour.
GraphCustomWidget
Note
Example
Figure 7-16 Example - setCursorOnContour

moveCursorOnContourBegin – position the cursor to the first graphic object of a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourBe‐

gin")
ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourBegin",
ContourName)
Description: Starting from the actual cursor position within a contour, using this function you
can navigate the cursor to the first point object of a contour.
GraphCustomWidget
Note
moveCursorOnContourEnd – position the cursor to the last graphic object of a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourEnd")

ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourEnd",
ContourName)
can navigate the cursor to the last point object of a contour.
GraphCustomWidget
Note
moveCursorOnContourNext – position the cursor to the next graphic object of a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourNext")

ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourNext",
ContourName)
can navigate the cursor to the next point object of a contour.


GraphCustomWidget
Note
moveCursorOnContourBack – position the cursor to the previous graphic object of a contour
Syntax: ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourBack")

ReturnValue = CallCWMethod(GraphVarName, "moveCursorOnContourBack",
ContourName)
can navigate the cursor to the previous point object of a contour.
GraphCustomWidget
Note
serialize – save/restore the actual state
Syntax: ReturnValue = CallCWMethod(GraphVarName, "serialize", FilePath, IsStoring)

Description: Using this function, when required, you can write the actual state and content of
the SlEsGraphWidget in binary form to a file or datastream and also restore it.
GraphCustomWidget
FilePath Complete path mit file name (QString)
IsStoring Save/restore (bool): TRUE = save
Note

7.5.6 Signals
You can capture the subsequently described ViewChanged signal in the configuration and
respond appropriately.
Overview
ViewChanged Changing the view
ViewChanged – changing the view
Syntax: SUB(on_<GraphVarName>_ViewChanged)
…
END_SUB
Description: The "ViewChanged“ signal is sent if the view changes. You can respond to this
in the configuration in a specific SUB method. The SIGARG parameters are
appropriately set.
GraphCustomWidget
SIGARG[0] left-hand edge (double)
SIGARG[1] upper edge (double)
SIGARG[2] right-hand edge (double)
SIGARG[3] lower edge (double)
Example
DEF MyGraphVar = (W///,"slesgraphcustomwidget.SlEsGraphCustomWidget"/////
10,10,340,340/0,0,0,0)
SUB(on_MyGraphVar_ViewChanged
DLGL("Current view: " << SIGARG[0] << ", " << SIGARG[1] << ", " << SIGARG[2]
<< ", " << SIGARG[3]
END_SUB


"Custom" operating area 8
8.1 How to activate the "Custom" operating area
Activating the "Custom" operating area

The "Custom" operating area is not activated on delivery.
1. First copy the slamconfig.ini. file from the [System Siemens directory]/cfg directory to the
[System oem directory]/cfg directory
or correspondingly to the [System add_on directory]/cfg directory or [System user
directory]/cfg directory.
2. To activate the "Custom" operating area, the following must be entered:
[Custom]
Visible=True
Result
After activation is complete, the softkey for the "Custom" operating area can be found in the
main menu (F10) on the menu continuation bar on the HSK4 (= default).
The "Custom" operating area displays an empty window covering the entire operating area,
with a configurable header. All horizontal and vertical softkeys can be configured.
8.2 How to configure the "Custom" softkey
Configuring the softkey for the "Custom" operating area

The labeling and position of the softkey for the "Custom" operating area are configured in the
slamconfig.ini file.

"Custom" operating area
8.3 How to configure the "Custom" operating area
The following options are available for configuring the start softkey:
1. To replace a softkey label with a language-dependent text, the following must be entered
in the [Custom] section:
TextId=MY_TEXT_ID
TextFile=mytextfile
TextContext=mycontext
In this example, the softkey shows the language-dependent text which was saved with the
text ID "MY_TEXT_ID" in text file mytextfile_xxx.qm under "MyContext" (xxx stands for
language code).
2. To replace a softkey label with a language-neutral text, the following must be entered in
the [Custom] section:
TextId=HELLO
TextFile=<empty>
TextContext=<empty>
In this example, the softkey for the "Custom" operating area displays the text "HELLO" for
every language.
3. An icon can also be displayed on the softkey in addition to the text.
To do this, the following must be entered in the [Custom] section:
Picture=mypicture.png
The softkey then displays the icon from the file mypicture.png. Graphics and bitmaps are
stored at the following path: [System oem directory]/ico/ico<Resolution>. The directory that
corresponds to the display resolution must be used.
4. The position of the softkey can also be set. The following entry in the [Custom] section
makes this setting:
SoftkeyPosition=12
The default is position 12. This corresponds to the HSK4 on the menu continuation bar of
the operating area's menu. Positions 1 - 8 correspond to HSK1 to HSK8 on the menu bar,
positions 9 - 16 to HSK1 to HSK8 on the menu continuation bar.
Configuring the softkey for the "Custom" operating area

You need the easyscreen.ini and custom.ini files to configure the operating area. Templates
for both these files are available in the [System Siemens directory]/templates/cfg directory.
1. First copy the files to the [System oem directory]/cfg directory and make your changes from
there.
2. File easyscreen.ini already contains a definition line for the "Custom" operating area:
;StartFile02 = area := Custom, dialog := SlEsCustomDialog,
startfile := custom.com
The ";" at the start of the line represents the comment character. This means the line is
commented out and, as such, not active. To change this, the ";" must be deleted.
The "startfile" attribute in this line defines that the entry will refer to the custom.com project
file when the "Custom" operating area is selected.

3. You create the custom.com project file in the [System oem directory]/proj directory. This
contains the relevant configuration which is created in the same way as the aeditor.com
file of the "Program" operating area. The configured start softkeys are then displayed in the
"Custom" operating area.
4. You configure the language-neutral text for the title bar of the dialog in the custom.ini file.
The following entry is available in the template for this purpose:
[Header]
Text=Custom
You can replace this text with a customized one.
5. The template contains the following entry for configuring a start screen for the "Custom"
operating area:
[Picture]
Picture=logo.png
Logo.png is the name of the start screen which appears on the "Custom" operating area's
start dialog. Here you can display a company logo, for example, or another image. The file
should be saved in the directory for the corresponding resolution under: [System oem
directory]/ico/ …
6. In order to display a specific "Run MyScreens" screen when the "Custom" operating area
is shown the first time, the following entry is available in the template:
; Mask shown with startup of area "custom"
[Startup]
;Startup = Mask:=MyCustomStartupMask, File:=mycustommasks.com
Typically, SINUMERIK Operate is started directly with a specific "Run MyScreens" screen.
The "startuparea" key must be set as follows in the "[miscellaneous]" section of the
systemconfiguration.ini file:
[miscellaneous]
;name of the area to be shown at system startup
startuparea = Custom

8.4 Programming example for the "Custom" area
Example
Figure 8-1 Example with "Start example" softkey

Figure 8-2 Example with bitmap and text fields
File overview
The following files are required:
● custom.com
● easyscreen.ini
Programming
Content of the custom.com file:
Note
The graphic file mcp.png integrated in the example is also only a sample file. If you wish to
use this programming example in your application, you must replace the graphic by one of
your own graphics.
//S(Start)
HS7=("Start example", se1, ac7)
PRESS(HS7)
LM("Maske4")

END_PRESS
//END
//M(Maske4/"Example: MCP"/"mcp.png")
DEF byte=(I/0/0/"Input byte=0 (default)","Byte number:",""/wr1,li1///380,40,100/480,40,50)
DEF Feed=(IBB//0/"","Feed override",""/wr1//"EB3"/20,180,100/130,180,100), Axistop=(B//0/"","Feed
stop",""/wr1//"E2.2"/280,180,100/380,180,50/100)
DEF Spin=(IBB//0/"","Spindle override",""/wr1//"EB0"/20,210,100/130,210,100), spinstop=(B//
0/"","Spindle stop",""/wr1//"E2.4"/280,210,100/380,210,50/100)
DEF custom1=(IBB//0/""," User keys 1",""/wr1//"EB7.7"/20,240,100/130,240,100)
DEF custom2=(IBB//0/"","User keys 2",""/wr1//"EB7.5"/20,270,100/130,270,100)
DEF By1
DEF By2
DEF By3
DEF By6
DEF By7
HS1=("Input byte", SE1, AC4)

HS2=("")
HS3=("")
HS4=("")
HS5=("")
HS6=("")
HS7=("")
HS8=("")
VS1=("")
VS2=("")
VS3=("")
VS4=("")
VS5=("")
VS6=("")
VS7=("Cancel", SE1, AC7)
VS8=("OK", SE1, AC7)
PRESS(VS7)
EXIT
END_PRESS
PRESS(VS8)
EXIT
END_PRESS
LOAD
By1=1
By2=2
By3=3

By6=6
By7=7
END_LOAD
PRESS(HS1)
Byte.wr=2
END_PRESS
CHANGE(Byte)
By1=byte+1
By2=byte+2
By3=byte+3
By6=byte+6
By7=byte+7
Feed.VAR="EB"<<By3
Spin.VAR="EB"<<Byte
Custom1.VAR="EB"<<By6
Custom2.VAR="EB"<<By7
Axisstop.VAR="E"<<By2<<".2"
Spinstop.VAR="E"<<By2<<".4"
Byte.wr=1
END_CHANGE
CHANGE(Axis stop)
IF Axistop==0
Axistop.BC=9
ELSE
Axistop.BC=11
ENDIF
END_CHANGE
CHANGE(Spin stop)
IF Spinstop==0
Spinstop.BC=9
ELSE
Spinstop.BC=11
ENDIF
END_CHANGE
//END


Dialog selection 9
9.1 Dialog selection using PLC softkeys
Configuration
Description of the procedure:
● The systemconfiguration.ini contains a section [keyconfiguration]. The entry specifies an
action for a special PLC softkey.
● A number is given as an action. A "Run MyScreens" call is involved if the number is greater
than or equal to 100.
● A section for defining the action to be performed must be created in the easyscreen.ini file.
The name of the section is based on the name of the operating area and the dialog name
(see entry under [keyconfiguration] → Area:=..., Dialog:=...) → [<Area>_<Dialog>]
→ e.g. [AreaParameter_SlPaDialog].
● The action numbers (which were given in the systemconfiguration.ini → see Action:=...) are
defined in this section. There are two commands involved:
1. LS("Softkey menu1","param.com") ... Loading a softkey menu
2. LM("Screen form1","param.com") ... Loading a screen form
Selecting softkey menus via PLC softkeys

"Run MyScreens" makes it possible to select "Run MyScreens" softkey menus and
"Run MyScreens" dialogs via PLC softkeys. This can only be done if the "action" attribute to
be specified when configuring the relevant PLC softkeys has a value greater than or equal to
100.
PLC softkeys are configured in the file systemconfiguration.ini in the section
[keyconfiguration]:
[keyconfiguration]
KEY75.1 = Area:=area, Dialog:=dialog, Screen:=screen, Action:= 100,

Dialog selection
9.2 Dialog selection using PLC hard keys
The LM and LS commands to be executed upon activation of the relevant PLC softkeys are
configured in the easyscreen.ini file. The names of the sections that are used for the purpose
of configuration are structured as follows:
[areaname_dialogname] The first part of the name "areaname" refers to the operating
area and the second part "dialogname" designates the dialog
to which the commands configured in this section apply.
The names given in the systemconfiguration.ini file for the op‐
erating area and dialog should be used. The dialog does not
have to be specified.
This is particularly true for operating areas which are only im‐
[AreaParameter_SlPaDialog] plemented by means of a single dialog. Please refer to the ex‐
100.screen1 = LS("Softkey1","param.com") ample on the left.
101.screen3 = LM("Screen
form1","param.com") If "screen1" is displayed in the AreaParameter operating area
implemented by the SlPaDialog dialog, the "LS("Softkey1","par‐
am.com")" command will be executed when the "action" with
the value 100 occurs.
action.screen=Command Both the "action" and "screen" attributes clearly indicate when
the specified command will be executed.
The "screen" information is optional.
The following commands are permissible:
LM (LoadMask)
LS (LoadSoftkeys)
Field of application
The following functions can be initiated in the operating software by the PLC:
● Select an operating area
● Select certain scenarios within operating areas
● Execute functions configured at softkeys
Hardkeys
All keys - also the PLC keys - are subsequently referred to as hardkeys. A maximum of 254
hardkeys can be defined. The following allocation applies:
Key number Application

Key 1 – key 9 Keys on the operator panel front
Key 10 – key 49 Reserved
Key 50 – key 254 PLC keys:
Key 50 – key 81 Reserved for OEMs
Key 255 Pre-assigned by control information.

Dialog selection
Hardkeys 1 - 9 are pre-assigned as follows:
Key designation Action / effect

HK1 Machine Selects "Machine" operating area, last dialog
HK2 Program Selects "Program" operating area, last dialog or last program
HK3 Offset Selects "Parameter" operating area, last dialog
HK4 Program Manager Selects "Program" operating area, "Program Manager" basic screen
HK5 Alarm Selects "Diagnostics" operating area, "Alarm list" dialog
HK6 Custom Selects "Custom" operating area
HK7 1)
Menu Select Selects "Main menu"
HK8 1) Menu Function Selects "Function menu"
HK9 1) Menu User Selects "User menu"
1) For 828D only
Configuration
The configuring is realized in the systemconfiguration.ini configuration file in the section
[keyconfiguration]. Each line defines what is known as a hardkey event. A hardkey event is
the n-th actuation of a specific hardkey. For example, the second and third actuation of a
specific hardkey can result in different responses.
The entries in the systemconfiguration.ini configuration file can be overwritten with user-
specific settings. The directories [System user directory]/cfg and [System oem directory]/cfg
are available for this purpose.
The lines for configuring the hardkey events have the following structure:
KEYx.n = area:=area, dialog:=dialog, screen:=screen, forms:=form,

menus:=menu,
action:=menu.action, cmdline:=cmdline
KEYx.n = area:=area, dialog:=dialog, cmdline:=cmdline, action:=
action
x: Number of the hardkey, range of values: 1 – 254
n: Event number – corresponds to the nth actuation of the hardkey, range of values: 0 – 9
Requirement
The PLC user program must fulfill the following requirement:
Only one hardkey is processed. As a consequence, a new request can only be set if the
operating software has acknowledged the previous request. If the PLC user program derives
the hardkey from an MCP key, it must provide sufficient buffer storage of the key(s) to ensure
that no fast keystrokes are lost.
PLC interface
An area to select a hardkey is provided in the PLC interface. The area is in DB19.DBB10.
Here, the PLC can directly specify a key value of between 50 and 254.

Dialog selection
Acknowledgment by the operating software takes place in two steps. This procedure is
necessary so that the operating software can correctly identify two separate events if the same
key code is entered twice consecutively. In the first step, control information 255 is written to
byte DB19.DBB10. This defined virtual key stroke enables the HMI to identify every PLC key
sequence uniquely. The control information is of no significance to the PLC user program and
must not be changed. In the second step, the actual acknowledgment takes place with respect
to the PLC by clearing DB19.DBB10. From this point in time, the PLC user program can specify
a new hardkey. In parallel, the actual hardkey request is processed in the operating software.
Example
Configuration file:
; PLC hardkeys (KEY50-KEY254)
[keyconfiguration]
KEY50.0 = name := AreaMachine, dialog := SlMachine
KEY51.0 = name := AreaParameter, dialog := SlParameter
KEY52.0 = name := AreaProgramEdit, dialog := SlProgramEdit
KEY53.0 = name := AreaProgramManager, dialog := SlPmDialog
KEY54.0 = name := AreaDiagnosis, dialog := SlDgDialog
KEY55.0 = name := AreaStartup, dialog := SlSuDialog
KEY56.0 = name := Custom, dialog := SlEsCustomDialog
The area and dialog identifiers can be found in the systemconfiguration.ini from [System
Siemens directory]/cfg.

Dialog selection
9.3 Dialog selection via NC
MMC command in HMI Operate

You can use MMC commands as described in the following:
1. Definition of MMC commands
The following combinations are available in the standard systemconfiguration.ini
file:
address:=MCYCLES --> command:=LM
address:=CYCLES --> command:=PICTURE_ON
This distinction is necessary, in order to make a differentiation between measuring cycles
and other cycles. This means that:
– LM is always applicable for measuring cycles, PICTURE_ON always for non-measuring
cycles
– It is not permissible that newly defined MMC commands are designated PICTURE_ON
and LM
2. "Run MyScreens" license
All of the dialogs opened by "Run MyScreen" – with the exception of the measuring cycles
– fall under the "Run MyScreens" license, and therefore without license, only a limited
number of dialogs can be used.
Example call with test.com (Run MyScreens):
g0 f50
MMC("CYCLES,PICTURE_ON,test.com,screen form1","A")
m0
MMC("CYCLES,PICTURE_OFF","N")
M30

Dialog selection

Reference lists A
A.1 Lists of start softkeys
A.1.1 List of start softkeys for turning
Program operating area for turning
HSK1 HSK2 HSK3 HSK4 HSK5 HSK6 HSK7 HSK8

Edit Drilling Turning Contour turn‐ Milling Miscellane‐ Simulation NC select
ing ous
-- Straight-line -- -- Measure Measure tool OEM --
circle workpiece
(only for
ShopTurn)
Turning
The following tables list the possible start softkeys for turning technology. Assignments of
individual start softkeys can differ depending on the particular system. The specified OEM
softkeys are permitted for "Run MyScreens".
programGUIDE (G-Code) start softkeys:
Drilling Turning Contour turning Milling Miscellaneous

HSK2 HSK3 HSK4 HSK5 HSK6
VSK1 Centering Stock remov‐ Contour -- Face mill‐ Contour Settings High
al ing speed
settings
VSK2 Drilling ream‐ Groove Stock removal -- Pocket Path Swivel plane Parallel
ing axes
VSK3 Deep-hole drill‐ Undercut Stock remov‐ -- Multi-edge Predrilling Swivel tool --
ing al residual ma‐ spigot
terial
VSK4 Boring Thread Grooving -- Groove Pocket -- --
VSK5 Thread Parting Grooving re‐ -- Thread Pocket -- --
sidual material milling res. mat.
VSK6 OEM -- Plunge-turn‐ -- Engraving Spigot Subprogram --
ing

Reference lists
VSK7 Positions OEM Plunge turn‐ OEM OEM Spigot res. -- OEM
ing residual mat.
material
VSK8 Repeat posi‐ -- >> << Contour << >> <<
tion. milling
ShopTurn start softkeys:
Drilling Turning Contour turning Milling Miscellaneous

HSK2 HSK3 HSK4 HSK5 HSK6 HSK10
VSK1 Drilling Stock re‐ New contour -- Face mill‐ New con‐ Settings High Tool
centered moval ing tour speed set‐
tings
VSK2 Centering Groove Stock removal -- Pocket Path Swivel Parallel Straight line
plane axes
VSK3 Drilling Undercut Stock remov‐ -- Multi-edge Predrilling Swivel tool Repeat Circle center
reaming al residual spigot progr. point
material
VSK4 Deep- Thread Grooving -- Groove Pocket Counter‐ -- Circle radius
hole drill‐ spindle
ing
VSK5 Thread Parting Grooving re‐ -- Thread mill‐ Pocket Transfor‐ -- Polar
sidual materi‐ ing res. mat. mations
al
VSK6 OEM -- Plunge-turn‐ -- Engraving Spigot Subpro‐ -- Approach/re‐
ing gram tract
VSK7 Positions OEM Plunge turn‐ OEM OEM Spigot -- OEM --
ing residual res. mat.
material
VSK8 Repeat -- >> << Contour << >> << --
position. milling
See also
Defining the start softkey (Page 28)
A.1.2 List of start softkeys for milling
Program operating area when milling

Edit Drilling Milling Contour mill‐ Turning Miscellane‐ Simulation NC select
ing (only for G ous
code)

Reference lists

-- Straight-line -- -- Measure Measure tool OEM --
circle workpiece
(only for
ShopMill)
Milling
The following tables list the possible start softkeys for milling technology. Assignments of
individual start softkeys can differ depending on the particular system. The specified OEM
softkeys are permitted for "Run MyScreens".
programGUIDE (G-Code) start softkeys:
Drilling Milling Contour milling Turning Miscellaneous

VSK1 Centering Face milling Contour -- Stock re‐ Contour Settings --
moval
VSK2 Drilling ream‐ Pocket Path -- Groove Stock re‐ Swivel plane Parallel
ing moval axes
VSK3 Deep-hole drill‐ Multi-edge Predrilling -- Undercut Stock re‐ Swivel tool --
ing spigot moval re‐
sidual ma‐
terial
VSK4 Boring Groove Pocket -- Thread Grooving High speed set‐ --
tings
VSK5 Thread Thread mill‐ Pocket res. -- Parting Grooving -- --
ing mat. residual
material
VSK6 OEM Engraving Spigot -- -- Plunge- Subprogram --
turning
VSK7 Positions OEM Spigot res. OEM OEM Plunge -- OEM
mat. turning re‐
sidual ma‐
terial
VSK8 Repeat posi‐ -- >> << Contour << >> <<
tion. turning
ShopMill start softkeys:
Drilling Milling Contour milling Miscellaneous Straight line circle

VSK1 Centering Face milling New contour -- Settings -- Tool
VSK2 Drilling ream‐ Pocket Path -- Swivel plane Parallel axes Straight line
ing
VSK3 Deep-hole Multi-edge Predrilling -- Swivel tool Repeat progr. Circle center point
drilling spigot
VSK4 Boring Groove Pocket -- High speed set‐ -- Circle radius
tings
VSK5 Thread Thread mill‐ Pocket res. mat. -- Transforma‐ -- Helix
ing tions

Reference lists
A.3 List of colors
VSK6 OEM Engraving Spigot -- Subprogram -- Polar

VSK7 Positions OEM Spigot res. mat. OEM -- OEM --
VSK8 Repeat posi‐ -- >> << >> << --
tion.
A.2 List of access levels

The meanings of the different access levels are as follows:
Protection level Locked by Area

ac0 Reserved for Siemens
ac1 Password Machine manufacturer
ac2 Password Service
ac3 Password User
ac4 Keyswitch position 3 Programmer, machine setter
ac5 Keyswitch position 2 Qualified operator
ac6 Keyswitch position 1 Trained operator
ac7 Keyswitch position 0 Semi-skilled operator
A.3 List of colors
System colors
A uniform color table is available for configuring dialogs (subset of the respective standard
colors). The color of an element (text, input field, background, etc.) can be selected from the
following options (between 0 and 133).
As an alternative to the predefined colors, you can also specify colors as RGB values
("#RRGGBB").
Index Pictogram Color Color description

1 Black
2 Orange
3 Dark green
4 Light gray
5 Dark gray
6 Blue
7 Red

Reference lists
A.4 List of language codes used in file names
Index Pictogram Color Color description

8 Brown
9 Yellow
10 White
126 Black Font color of an input/output field that is currently in

focus
127 Light orange Background color of an input/output field that is cur‐
rently in focus
128 Orange System color focus
129 Light gray Background color
130 Blue Header color (active)
131 Black Header font color (active)
132 Turquoise Background color of a toggle field
133 Light blue Background color of a list box
A.4 List of language codes used in file names
Supported languages
Standard languages:
Language Abbreviation in file name

Chinese simplified chs
German deu
English eng
French fra
Italian ita
Spanish esp
Other languages:

Chinese traditional cht
Danish dan
Finnish fin

Reference lists
A.6 Behavior when opening the dialog (attribute CB)

Indonesian ind
Japanese jpn
Korean kor
Malay msl
Dutch nld
Polish plk
Portuguese (Brazil) ptb
Romanian rom
Russian rus
Swedish sve
Slovakian sky
Slovenian slv
Thai tha
Czech csy
Turkish trk
Hungarian hun
Vietnamese vit
A.5 List of accessible system variables
References
List Manual System Variables/PGAsl/

The following table provides an overview of the conditions when the CHANGE method is called.
The following applies to attribute CB:
CB0
The CHANGE method is triggered when the screen is displayed if the variable has a valid
value at this time (e.g. through default setting or NC/PLC variable).

Reference lists
CB1 (default)
The CHANGE method is not explicitly triggered when the screen is displayed. If the variable
has a configured NC/PLC variable, then the CHANGE method is of course still called.
Condition Response
Type System or user variable Default setting Execute the CHANGE
method
I/O field Yes Yes Yes Due to the configured NC/PLC var‐
No iable, there is always at least one
automatic call of the CHANGE
No Yes method with the current value of
No the NC/PLC variable. The pre-as‐
signment of CB does not have an
effect.
No Yes Yes The CHANGE method is called
with the pre-assigned value.
No The CHANGE method is not called.
No Yes No call because there is no valid
No value present to call the CHANGE
method.
Toggle Yes Yes Yes Due to the configured NC/PLC var‐
No iable, there is always at least one
automatic call of the CHANGE
No Yes method with the current value of
No the NC/PLC variable. The pre-as‐
signment of CB does not have an
effect.
No Yes Yes The CHANGE method is called
with the pre-assigned value.
No The CHANGE method is not called.
No Yes The CHANGE method is called
(per default the with the first pre-assigned value of
first value from the the toggle list.
toggle is assigned) No The CHANGE method is not called.
See also
CHANGE (Page 100)

Reference lists

Tips and tricks B
B.1 General tips
● If possible, use the OPI version for system variables ($ variables).
Reason:
Avoids complex name resolution.
Example:
Instead of "$R[10]", it is better to use "/Channel/Parameter/R[u1,10]".
● Avoids cyclic (similar) setting, e.g. of the screen and variable HLP property. Compare the
value to be set with the current value first, and only set it when it is different.
Reason:
Avoid a time-consuming search of the resolution-dependent help screens.
Example:
DEF MyVar=(R3///,"X1",,"mm"/WR1//"$AA_IM[0]")
CHANGE(MyVar)
IF MyVar.VAL < 100
HLP="mypic1.png"
ELSE
HLP="mypic2.png"
ENDIF
END_CHANGE
Recommendation:
CHANGE(MyVar)
IF MyVar.VAL < 100
IF HLP <> "mypic1.png"
HLP="mypic1.png"
ENDIF
ELSE
IF HLP <> "smypic2.png"
HLP="mypic2.png"
ENDIF
ENDIF
END_CHANGE

Tips and tricks
B.3 Tips for the CHANGE method
● Replace several RNP() functions in succession with one MRNP() function.

Replace several RDOP() functions in succession with one MRDOP() function.
Reason:
Reduces the communication load and increases the performance.
● Do not read drive parameters faster than in a 1 second cycle, slower is better.
Reason: The communication with the drives can otherwise be extremely disturbed or even
cause failures.
● Avoid successive arithmetic operations with system or user variable-connected dialog
variables. Use, for example, register (REG[x]) or (invisible) help variables for this.
Reason: Each assignment of a value results in a write operation in the connected system
or user variable.
● Similar code used in different blocks should be combined in a SUB block for reasons of
transparency, serviceability and performance (when displaying the screen). It can then be
called at the appropriate positions with the CALL() function.
● By monitoring the CPU load in the dialog line (setting in slguiconfig.xml), it is possible to
investigate the effects of changes in the screen on the performance.
B.2 Tips for debugging

● Use the DEBUG() function for diagnostic purposes. When the DEBUG() function is called,
the transferred string is written to the easyscreen_log.txt file. The output of information in
the dialog line by the DLGL() function can also be helpful.
However, after completion of the screen development, this function should be removed
again for performance reasons or commented out.
● The easyscreen_log.txt file should have no entries after the development of a screen is
completed.
B.3 Tips for the CHANGE method

● Always keep CHANGE methods very short and small, particularly for those whose variables
are connected to a system or user variable and change very frequently.
Reason:
Increases the screen performance.
● If possible, do not configure any RNP() functions in CHANGE methods. Instead, it is better
to configure an invisible variable parallel to the system or user variable to be read and then
use this.
Reason:
An RNP() function would be issued with each call. Otherwise, the current value which is
already available would be simply accessed.

Tips and tricks
B.4 Tips for DO LOOP loops
Example:
A name resolution is performed via RNP() for each change of the axis motion in order to
read channel-specific machine data:
DEF AXIS_POSITION_X = (R///,""///"$AA_IM[X]")
CHANGE(AXIS_POSITION_X)
DLGL("Axis """ << RNP("$MC_AXCONF_GEOAX_NAME_TAB[0]") << """
has moved: "
<< AXIS_POSITION_X)
END_CHANGE
Keep the channel-specific machine data up-to-date with the aid of an invisible variable, copy
each value change to a temporary variable, e.g. register.
This temporary variable can then be used in the CHANGE method of the value change for
the axis position without making a name resolution of the machine data each time and the
subsequent read access:
DEF AXIS_POSITION_X = (R///,""///"$AA_IM[X]")

DEF AXIS_NAME_X = (S///,""/WR0//"$MC_AXCONF_GEOAX_NAME_TAB[0]")
CHANGE(AXIS_NAME_X)
REG[0] = AXIS_NAME_X
END_CHANGE
CHANGE(AXIS_POSITION_X1)
DLGL("Axis """ << REG[0] << """ has moved " << AXIS_POSITION_X)
END_CHANGE
● The update rate and therefore the execution of the associated CHANGE method of
variables that are connected to system or user variables with very frequent value changes,
can be reduced by using the UR variable property, e.g. variable that is coupled to the actual
axis values.
Reason:
In this way, the associated CHANGE method is executed in a fixed specified grid for a value
change.

As loops can impair the performance of SINUMERIK Operate, depending on the configuration,
they should be used carefully and if possible without time-intensive actions.
A register (REG[]) should also be used as run variable, because normal display variables
(particularly those with OPI connection) also impair the system performance due to the frequent
updates or write operations.

Tips and tricks
Note that the number of script lines executed "in one operation", is currently limited to 10,000.
When this number is reached, the script execution is aborted with an appropriate entry in the
easyscreen_log.txt file.
Reason:
● Prevention of endless loops
● "Run MyScreens" must remain operable

Animated elements C
C.1 Introduction
Introduction
The manual describes working with the X3D Viewer with which you can integrate animated
and non-animated graphical scenes (animated elements) – called help screens in the following
– into the graphical user interface of SINUMERIK Operate as of Version V4.7 SP1 .
You can show motion sequences and parameters in context-sensitive help screens. This helps
you to improve the operation of applications and make the user interface more appealing.
Implementation of your initial idea to the final help screen is described in the steps below:
● Creation of graphical elements and 3D models for the help screens that will eventually
appear in the X3D Viewer (see Chapter Modeling (Page 248)).
● Creation of the scene description file in which the model data of the graphics file will be
assigned to the scenes and animations to be displayed at particular points (see Chapter
Structure of the scene description file (Page 255)).
● Conversion of the X3D files and XML files into HMI files (see Chapter Conversion to hmi
file (Page 259)).
● C++ integration of the X3D Viewer into your own application (see Chapter Implementation
example (Page 261)).
● Application in Run MyScreens (see Chapter Display in Run MyScreens (Page 262)).
Overview of the file formats
Figure C-1 File formats

Animated elements
C.2 Modeling
File format Description

.fxw Flux Studio (3D) graphics file
.x3d Model file in exchange format
.xml Definition file for animations and scenes
.hmi Output file for the X3D Viewer
C.2 Modeling
C.2.1 Requirements
The aim of the modeling is to create a file with the generated 3D models in .x3d file format, an
official standard for 3D contents.
Modeling is performed in the Flux Studio Web3D authoring tool . The Flux Studio Web3D
authoring tool is a freely available 3D modeling tool with versatile export and import options.
Requirements
● You have installed the Flux Studio Web3D authoring tool, Version 2.1.
● You are familiar with modeling and use of Flux Studio.
● File format .x3d is not described in any detail in this document, adequate knowledge of the
subject is assumed.
Note
You can download the Flux Studio Web3D authoring tool from the Internet via the following
link:
http://mediamachines.wordpress.com/flux-player-and-flux-studio (http://
mediamachines.wordpress.com/flux-player-and-flux-studio)
C.2.2 Rules for modeling

Observe the following rules when modeling. You will only be able to process your help screen
file if you have followed these rules correctly.
Rules for modeling

1. The time sensor must have the name "Animation".
2. All related elements must be assigned to a group.

Animated elements
C.2 Modeling
3. All groups must be set to the following position:

x = 0, y = 0, z = 0
4. To make the groups invisible, the translation values are set as follows:
x = 1000000, y = 1000000 and z = 1000000
5. The following elements must have the same name both in the Flux Studio graphic models
and in the XML scene definitions (cf. Chapter Overview (Page 254)):
– Tool
– Cameras
6. Before you can create a .x3d file you must make the following settings in dialog box "Export
Options":
Figure C-2 Settings in the Export Options dialog box

Animated elements
C.2 Modeling
7. We recommend the following settings for texts (see also the following dialog box):
– Texts must always be centered.
– The size of the text should be 0.2. This size allows you to position the text easily. The
text output by the X3D Viewer is in the font size of the user interface, irrespective of this
value.
Figure C-3 Settings for text

Animated elements
C.2 Modeling
8. To create hatching, use file schnitt.png as the texture. The lines always go from the bottom
left to the top right at an angle of 45°. You should set the scaling to 3 in both dimensions.
The rotation depends on the construction type and must be adapted manually.
Figure C-4 Settings for hatching
9. We recommend the following sizes/dimensions for the blanks:

– Cylinder for turning operation:
Length = 5.5 ; Radius = 1.4 (cf. template turning_blank.fxw)
– Cube for milling operation
x = 4.75 ; y = 3 ; z = 3 (cf. template milling_blank.fxw)
See also
XML commands (Page 254)
C.2.3 Importing graphics (models)

In Flux Studio, you can import external graphics (models). You can store frequently used
models, such as tools, as .x3d or .hmi files centrally for further use as finished elements in
other help screens. You will find a list of supplied modeling templates in Chapter Modeling
templates (Page 253).
Complex objects can also be created with other modeling tools, such as Cinema4D, and then
imported.
A description of how you can reuse these models is given below.
Import as inline
Flux Studio uses the object "Inline" for importing .x3d files. It allows you to link in external
elements without multiplying the 3D data of these models.

Animated elements
C.2 Modeling
Insert the object with menu item Create -> Create Inline. Then enter a file name in the object
properties.
Figure C-5 Importing with object "Inline"

Animated elements
C.2 Modeling
Importing 3D model data

Proceed as follows to import model data from a file.
1. Open dialog box "Flux Studio Accutrans3D Translation Utility" via menu item File -> Import
Other Format .
2. Select a format from the "File Types" list box. For example, to import a Cinema4D file, select
file type "3D Studio."
3. Then select a file with Select Files and start import.
Figure C-6 Importing 3D model data
The model data from the Cinema4D file is inserted as a complete group. All cameras and any
other information that is additionally imported should be deleted. Only the graphics elements
of the Cinema4D file are required.
C.2.4 Modeling templates

In this chapter, you will find a list of graphics elements on which you can base your design,
colors, and sizes. To maintain a uniform "look and feel" in the user interface, we recommend
using the style of the templates or the templates themselves for creating your own graphics.
General
Template Description
intersection_texture.png Texture for an sectioned area
rapid_traverse_line_hori.fxw Horizontal line to illustrate the tool traversing path
during rapid traverse
rapid_traverse_line_vert.fxw Vertical line to illustrate the tool traversing path
during rapid traverse

Animated elements
C.3 XML commands
feed_traverse_line_hori.fxw Horizontal line to illustrate the tool path during feed
feed_traverse_line_vert.fxw Vertical line to illustrate the tool path during feed
dimensioning_lines_hori.fxw Horizontal projection lines
dimensioning_lines_vert.fxw Vertical projection lines
z1_inc.fxw Horizontal dimension line with the identifier Z1
x1_inc.fxw Vertical dimension line with the identifier X1
3d_coordinate_origin.fxw 3D coordinate origin
3d_zero_point.fxw 3D zero point
Turning
turning_blank.fxw The blank for turning technology: A simple cylinder
turning_centerline.fxw Center line
turning_centerpoint.fxw Coordinate origin to display the zero point in the
WCS
turning_refpoint.fxw Reference point, for example, for a machining op‐
eration
turning_machining_area.fxw Boundary lines for the machining area
Milling
milling_blank.fxw The blank for milling technology: A simple cube
milling_centerline.fxw Center line
milling_refpoint.fxw Reference point, for example, for a machining op‐
eration
C.3 XML commands
C.3.1 Overview
The scene description file (extension .xml) is required so that the X3D Viewer can access the
graphics. In the scene description file, you assign the scene names that are called from the
configuration to the times in the .x3d file (time sensor) at which the graphics are positioned.

Animated elements
C.3 XML commands
C.3.2 Structure of the scene description file

The structure of the scene description file is shown below together with an explanation of the
relevant XML commands:
Design and description


<TextPlane plane="G18_ZXY" />
Description
<TextPlane plane="G18_ZXY" /> Treatment of the plane-dependent texts (axis

names) specifically for turning. If, for example,
a text with the identifier "Z" is used (for G18 first
geometry axis), the corresponding geometry
axis identifier of the control will be shown in the
help screen (for example, "Z").


<TextPosition center='true' />
Description
<TextPosition center='true' /> Marking that the texts are centered. This is rel‐
evant to the display of the texts in rotated
screens. We recommend using this setting.


<ToolSpeedFactors planeSpeedFactor="0.4" rapidSpeedFactor="0.7"
reducedSpeedFac¬tor="1.0"/>
Description
<ToolSpeedFactors This entry can be added if the tool speeds are

to be modified.
planeSpeedFactor="0.4" Factor for the feedrate ( 0.4 = 40% )
rapidSpeedFactor="0.7" Factor for rapid traverse ( 0.7 = 70% )
reducedSpeedFactor="0.1" /> Factor for a third speed ( 0.1 = 10% )

Animated elements
C.3 XML commands

<SceneKey name='BoringAnimation' masterRotationSpeed="-64.0"
maxRotAngle="45.0" begin-Time='0.110 endTime='0.118 view='camiso'
speedMaster='boringtool' Type="VIEW_3D_TURN_CYL">
Description
<SceneKey name='BoringAnimation' Name of the animation

masterRotationSpeed="-64.0" Direction of rotation and rotation speed of the
tool.
The setting is optional.
maxRotAngle="45.0" To avoid aliasing effects (tool seems to be turn‐
ing in the wrong direction). The value is usually
a fourth of the symmetry of the tool.
The setting is optional.
beginTime='0.110 Start time of the animation on the time sensor
endTime='0.118' End time of the animation on the time sensor
view='camiso' Camera to be used for the animation
speedMaster='boringtool' Name of the tool for the animation
type="VIEW_3D_TURN_CYL"> View type defines the view (see Section View
type (Page 258))


<Element name='1' time='0.110' feed='rapid' dwell=’2’/>
<Element name='2' time='0.112' feed='rapid'/>
<Element name='3' time='0.114' feed='rapid'/>
<Element name='4' time='0.116' feed='plane'/>
<Element name='5' time='0.118' feed='plane'/>
Description
<Element name='1' Specifies that it is the first element of the ani‐

mation.
time='0.110' Time of the first element on the time sensor
feed='rapid' Traversing speed of the element
plane = machining feedrate
rapid = rapid traverse
reduced = reduced speed, slower than "plane"
dwell=’2’/> Pause in the traversing motion of the anima‐
tion. A rotating tool continues to rotate.

Animated elements
C.3 XML commands


</SceneKey>
Description
</SceneKey> End of the animation definition


<SceneKey source=''BoringAnimation' name=''BoringAnimationRear' mirror='
MirrorScreenX ' />
Description
<SceneKey source=''BoringAnimation' Name of an animation that is to use another

animation as its source.
name=''BoringAnimationRear' Name of the new animation based on the
source
mirror=' MirrorScreenX ' /> Mirroring in the direction of the X axis, output
is in the new animation.


<SceneKey name='Default' time='0.026' view='camiso'
type="VIEW_3D_DRILL_CUT"/>
<SceneKey name='Cut' time='0.046' view='camside' type="VIEW_SIDE"/>
<SceneKey name='Z1ink' time='0.056' view='camside' type="VIEW_SIDE"
highLightedGroup='dad_Z1ink'/>
<SceneKey name='Z1abs' time='0.066' view='camside' type="VIEW_SIDE"
highLightedGroup='dad_Z1abs'/>
Description
<SceneKeyname=’Z1abs' Screen name

time='0.066' Time of the screen on the time sensor
view='camside' Camera to be used for the screen
type="VIEW_SIDE" View type defines the view (see Section View
type (Page 258))
highLightedGroup='dad_Z1abs'/> Name of the group to be highlighted. The group
has been called "Z1abs" in Flux Studio. The
prefix "dad_" is automatically added by Flux.
<!-- End of xml file –!>

Animated elements
C.3 XML commands
C.3.3 Mirroring and rotations

Mirroring or rotation of the image or model is defined with the mirror command.
Description
mirror="RotateScreenX" The screen is rotated around the X axis

mirror="RotateScreenY" The screen is rotated around the Y axis
mirror="RotateScreenZ" The screen is rotated around the Z axis
mirror="MirrorScreenX” The screen is mirrored along the X axis
mirror="MirrorScreenY" The screen is mirrored along the Y axis
mirror="MirrorScreenZ" The screen is mirrored along the Z axis
mirror="RotatePieceX” The model is rotated around the X axis
mirror="RotatePieceY" The model is rotated around the Y axis
mirror="RotatePieceZ" The model is rotated around the Z axis
mirror="MirrorPieceX" The model is mirrored along the X axis
mirror="MirrorPieceY" The model is mirrored along the Y axis
mirror="MirrorPieceZ" The model is mirrored along the Z axis
All rotate and mirror options can be combined. A rotation angle must be defined for rotation.
Examples
mirror="RotatePieceZ=180"
mirror="RotatePieceZ=-90 MirrorScreenX"
mirror="RotateScreenY=90"
mirror="MirrorPieceX MirrorPieceY"
mirror="MirrorPieceZ RotatePieceX=-90"
C.3.4 View type

You define the views with the view type. The views are based on empirical values and rules
that produce a sensible representation of the objects.
This ensures that the representation of the objects matches the coordinate system settings
made in the user interface (MD 52000 $MCS_DISP_COORDINATE_SYSTEM or MD 52001
$MCS_DISP_COORDINATE_SYSTEM_2).
Description
"VIEW_STATIC" Direct view without conversion

"VIEW_3D_TURN_CYL" 3D view for turning operations (cylinder)
"VIEW_3D_MILL_CUBE" 3D view for milling operations (cube)
"VIEW_3D_DRILL_CUT" 3D view for drilling operations (sectional view)

Animated elements
C.5 Display in Create MyHMI /3GL
"VIEW_SIDE" 2D view for drilling operations (sectional view)

"VIEW_TOP_GEO_AX_1" 2D view from the direction of the 1st geometry
axis
"VIEW_TOP_GEO_AX_2" 2D view from the direction of the 2nd geometry
axis
"VIEW_TOP_GEO_AX_3" 2D view from the direction of the 3rd geometry
axis
C.4 Conversion to hmi file
Note
The X3D files and their associated XML files are converted to HMI files when the HMI is
powered up.
For each X3D file, a corresponding XML file of the same name must be created. To do this,
you store the X3D files and XML files in directory search path of HMI\ico\x3d
\turning or milling. You proceed in the same way with the .ts files.
C.5.1 X3D Viewer

If you want to display particular help screens in a separate OA application you must integrate
the X3D Viewer widget into its own OA application.
The X3D Viewer widget provides interfaces, which enable X3D contents to be presented in
the HMI.
Class SlX3dViewerWidget is provided for displaying graphical scenes. The definition of the
class can be found in the corresponding slx3dviewerwidget.h header file in the global GUI
include directory \hmi_prog\gui\include.
C.5.2 Class SlX3dViewerWidget

The class provides a flexible widget that autonomously displays the contents of a model file
specified during runtime and, if required, runs the animation.
The interface of the class comprises the Constructor, Destructor, and two methods for
controlling the graphical output.
As a direct derivative of the Qt class QWidget, a much more expansive interface is available,
which will not be described in any further detail here, (for example, show(), hide() and
resize(...). For more information, please refer to the Qt documentation).

Animated elements
C.5.3 Public methods
SlX3dViewerWidget ( QWidget* pParent = 0 )

Constructor of the X3D Viewer widget.
Parameters Meaning
pParent The parameter is passed on to the constructor of
the Qwidget.
~SlX3dViewerWidget ( )
Destructor of the X3D Viewer widget.
Parameters Meaning
- -
C.5.4 Public slots
void viewSceneSlot ( const QString& rsFileName, const QString& rsScene, const QString&
rsAnimationScene, int nChannel, int nPlane, SlStepTechnology nTechnology )
With the viewSceneSlot method, the X3D Viewer is instructed to load the rsScene static scene
and the rsAnimationSzene animated scene from the rsFileName file and display them
alternately.
The static scene and then the animated scene are repeatedly alternately displayed for a fixed
time.
If no static scene is specified, the animation will be shown immediately; an animated scene
may also not have been specified.
Channel number, plane and technology are used to rotate the scenes to the correct position
(depending on the set machine coordinate system).
Parameters Meaning
rsFileName Name of the file that contains the scenes to be
displayed
rsScene Name of the static scene.
rsAnimationScene Name of the animated scene.
nChannel Channel number

Animated elements
Parameters Meaning
nPlane Plane
nTechnology Technology
The following constants are defined for the SlStep‐
Technology enumeration type:
● SL_STEP_NO_TECHNOLOGY
● SL_STEP_MILLING
● SL_STEP_TURNING
● SL_STEP_SURFACE_GRINDING
● SL_STEP_CIRCULAR_GRINDING
void viewSceneSlot ( const QString& rsFileName, const QString& rsScene, const QString&
rsAnimationScene )
A simplified form of the viewSceneSlot method with which the X3D Viewer can be instructed
to load and display the rsScene static scene and/or the rsAnimationSzene animated scene
from the rsFileName file.
Parameters Meaning
rsFileName Name of the file that contains the scenes to be
displayed.
rsScene Name of the static scene.
rsAnimationScene Name of the animated scene.
C.5.5 Libraries
In order to be able to apply the X3D Viewer in your own projects, the list of library dependencies
must be extended by the 'slx3dviewer.lib' entry.
C.5.6 Implementation example

You will find an implementation example in the package Create MyHMI/3GL under \examples
\GUIFrameWork\SlExGuiX3D.
C.5.7 Machine data

Display MD 9104 $MM_ANIMATION_TIME_DELAY
Time delay in seconds until the animation is started for help screens. The setting does not
apply to help screens that are only animated.
The setting applies globally to all animations of SINUMERIK Operate.

Animated elements
C.6 Display in Run MyScreens
C.5.8 Notes about use

● The animation is interrupted if the X3D Viewer widget is hidden. If this happens, there is
no need to choose a scene selection without animation.
● You should avoid frequent or multiple instantiation of the X3D Viewer widget as this reduces
performance and memory capacity. The use (implementation) of an X3D Viewer Singleton
is recommended in such application scenarios.
● The X3D Viewer can also be used in signal slot concepts.
● If an error occurs (for example, a file not found or unknown scene name), the X3D Viewer
widget opens a message area. This area is automatically hidden again when another help
screen is activated.

This section is intended for experienced "Run MyScreens" developers. Necessary background
knowledge is provided in the associated documentation.
In addition to using screens in .bmp or .png format, animated help screens can also be
displayed with the X3D Viewer.
To integrate help screens, use the Run MyScreens interface in the usual way.
To output images in .bmp or .png format, XG0 is entered in the definition of a dialog box in the
Attributes section or the parameter is left empty. To integrate X3D help screens in a dialog,
you must enter XG1 in the attributes.
//M(MASK_F_DR_O1_MAIN/$85407////52,80/XG1)
The following parameters are required to activate the individual help screens; their meaning
is described in Section 5.3 Public slots:
1. File name
2. StaticScene (optional)
3. AnimationScene (optional)
4. Technology (optional)
5. Plane (optional)
The parameters are combined into a character string in this order, separated by a comma.
Hlp = "File name,StaticScene,AnimationScene,Technology,Plane"

Animated elements
Examples
● The default help screen can be set with the specified variable Hlp.
In the following example, the "MyAnimation" animation is output from the "MyDlgHelp.hmi"
file. No StaticScene is specified, i.e. no static scene is output. No specifications are made
for the Technology and Plane, i. e. default values are used.
Hlp = "MyDlgHelp.hmi,,MyAnimation"
● The hlp property can be set on a specific help screen for the individual parameters of the
input screen.
In the following example, the static "MyParam" scene and the "MyAnimation" animation are
output from the "MyDlgHelp.hmi" file in the G17 plane. No specification is made for the
Technology, i.e. a default value is used.
VarMyParam.hlp = "MyDlgHelp.hmi,MyParam,MyAnimation,,G17"

Animated elements

Glossary
Access level
Graduated system of authorization, which makes the accessibility and utilization of functions
on the operator interface dependent on the authorization rights of the user.
Array
An array can be used to organize data of a standard data type stored in the memory in such
a way that it is possible to access the data via an index.
Attribute
Characteristic that assigns specific → Properties to an object (→ Dialog or → Variable).
Column index
Column number of an array
Configuration file
File, which contains definitions and instructions that determine the appearance of → Dialogs
and their → Functions.
Definition lines
Program section in which → Variables and softkeys are defined
Dialog
Display of the → User interface
● Dialog-dependent softkey menu
Softkey menu, which is called from a newly configured dialog.
● Dialog-independent softkeys
Softkeys, which are not called from a dialog, i.e., start softkey and softkey menus, which
the user configures before the first, new dialog.
Editor
ASCII Editor with which characters can be entered in a file and edited.

Glossary
Event
Any action, which initiates execution of a → Method: Input of characters, actuation of softkeys,
etc.
Group
Reload unit for → Configuration file
Help variable
Internal arithmetic variable to which no → Properties can be assigned and is not, therefore,
visible in the → Dialog.
Hotkeys
6 keys on OP 010, OP 010C and SINUMERIK keyboards with hotkey blocks. Pressing the
keys selects an operating area directly. As an option, 2 additional keys can be configured as
hotkeys.
Input/output field
Also I/O field: for inputting or outputting variable values.
Interpreter
The interpreter automatically converts the defined code from the → Configuration file into a
→ Dialog and controls its use.
Line index
Row number of an array
Menu tree
A group of interlinked → Dialogs
Method
Programmed sequence of operations executed when a corresponding → Event occurs.
Parameter
Parameters are variable elements of the programming syntax and are replaced by other words/
symbols in the → Configuration file.

Glossary
PI service
Function which, on an NC, executes a clearly defined operation. PI services can be called from
the PLC and the HMI system.
PLC hard key

PLC hard keys are provided via the PLC interface of the HMI software, just like hotkeys. The
functions, which can be triggered via the user interface, can be configured.
They take the form of MCP keys or evaluations of PLC signal logic operations in the PLC user
program. For this reason, they are referred to as "virtual keys".
Programming support
Provision of → Dialogs to assist programmers in writing → Parts programs with "higher-level"
components
Properties
Characteristics of an object (e.g of a → Variable)
Recompile
NC code sections can be generated in a → Part program from input fields in → Dialogs in the
→ Programming support system. Recompilation is the reverse operation. The input fields used
to generate a selected section of NC code are retrieved from the NC code and displayed in
the original dialog.
Selecting
A program formulated in the NC language, which specifies motion sequences for axes and
various special actions.
Simulation
Simulation of a → Parts program run without movement of the actual machine axes.
Softkey labels
Text/image on the screen, which is assigned to a softkey.
Softkey menu
All horizontal or all vertical softkeys
Start softkey
Softkey with which the first newly created → Dialog is started.

Glossary
Toggle field
A list of values in the → Input/output field; check with toggle field: The value input in a field must
be the same as one of the listed values.
User variable
Variables defined by the user in the → Parts program or data block.
Variable
Designation of a memory location, which can be displayed in a → Dialog by assigning
→ Properties and in which input data and the results of arithmetic operations can be entered.

Index
Dialog
Definition, 39
A Definition block, 40
Multiple columns, 48
Access level, 54
Properties, 41
Alarms
Dialog change mode, 139
Language code, 239
Dialog element, 47
Array
Display mode, 73
Access mode, 171
Display option, 73
Column index, 171
DLL file, 131
Compare mode, 171
Definition, 169
Element, 170
Line index, 171
E
Status, 174 ELLIPSE (define circle), 168
Attributes, 73 ELLIPSE (define ellipse), 168
B F
Background color, 75 File
Copy, 118
Delete, 118
C Moving, 120
File formats
Colors, 75
fxw, 247
Comparison operators, 97
hmi, 247
Conditions, 98
x3d, 247
Configuration file, 25
xml, 247
Configuration syntax"; "Extended syntax, 36
Flux Studio Web3D authoring tool, 248
Configuration syntax"; "Screens, 36
Focus control, 178
Configuration syntax"; "Softkey, 37
Foreground color, 75
Configuration syntax"; "Table columns, 37
Function
Configuration syntax"; "Variables, 36
CALL (Subprogram call), 114
Configuring PLC softkeys, 229
CLEAR_BACKGROUND), 117
Constants, 97
CP (Copy Program), 118
Custom widget
CVAR (Check Variable), 116
Automatic data exchange, 182
Cyclic execution of scripts, 164
Definition, 179
DEBUG, 125
Executing a method, 185
DLGL (Dialog line), 124
Interface, 180
DO LOOP), 162
Library, 179
DP (Delete Program), 118
Manual data exchange, 183
EP (Exist Program), 119
Reading and writing properties, 183
EVAL (Evaluate), 130
Responding to a custom widget signal, 187
EXIT, 126
EXITLS (EXIT Loading Softkey), 131
FCT, 131
D File access, 122
Default setting, 72 FORMAT (string), 160
Defines the softkey menu, 53 GC (Generate Code), 133

Index
HMI_LOGIN, 136
HMI_LOGOFF, 136
HMI_SETPASSWD, 136 G
INSTR (String), 156
Generates NC code, 133
LA (Load Array), 137
Graphic text, 72
LB (Load Block), 138
Grid → Table, 174
LEFT (string), 157
LEN (string), 156
LISTADDITEM), 128
LISTCLEAR), 128
H
LISTCOUNT), 128 H_SEPARATOR (define horizontal dividing
LISTDELETEITEM, 128 line), 169
LISTINSERTITEM, 128 Help display, 75
LM (Load Mask), 139 Help file, 76
LS (Load Softkey), 140 Help variable, 64
MIDS (string), 158
MP (Move Program), 120
MRDOP), 113 I
MRNP (Multiple Read NC PLC), 143
I/O field with integrated unit selection, 76
Overview, 112
Image as short text, 68
PI_START, 145
Import
RDFILE), 122
Graphics (models), 251
RDLINEFILE), 122
Input mode, 74
RDOP), 113
Reading and writing drive parameters, 113
Recompile NC code, 150
Recompile without comment, 152
L
REPLACE (string), 158 Language code, 239
RESIZE_VAR_IO, 147 Limits, 72
RESIZE_VAR_TXT, 147 LINE (define line), 167
RETURN (Back), 149 List field, 68
RIGHT (string), 157 Long text, 72
RNP (Read NC PLC Variable), 146
SB (Search Backward), 154
SF (Search Forward), 154 M
SP (Select Program), 121
Machine data, 261
START_TIMER), 164
Machining step support, 152
STOP_TIMER, 164
Master dialog, 139
STRCMP (string), 158
Mathematical functions, 96
STRINSERT (string), 159
Menu tree, 27
STRREMOVE (string), 159
Method
SWITCH), 143
ACCESSLEVEL, 100
TRIMLEFT (string), 160
CHANGE, 100
TRIMRIGHT (string), 160
CHANNEL, 102
UNTIL, 162
CONTROL, 102
WDOP, 113
LANGUAGE, 104
WHILE, 162
LOAD, 104
WNP (Write NC PLC Variable), 146
LOAD GRID, 141
WRFILE, 122
OUTPUT, 106
WRLINEFILE), 122
Overview, 100
PRESS, 107
PRESS(ENTER), 108

Index
PRESS(TOGGLE), 108 SIEsGraphCustomWidgets

RESOLUTION, 109 addArc, 213
RESUME, 109 addCircle, 213
SUSPEND, 110 addContour, 206
UNLOAD, 105 addEllipse, 212
addLine, 212
addPoint, 211
N addRect, 212
addRoundedRect, 212
NC variable
addText, 213
Read, 146
AxisNameX, 193
Write, 146
AxisNameY, 194
Numerical format, 79
AxisY2Factor, 194
AxisY2Offset, 194
AxisY2Visible, 194
O BackColor, 200
Online help, 61 ChartBackColor, 200
Operator clearContour, 208
Bit, 98 CursorColor, 201
Mathematical, 95 CursorStyle, 203
CursorX, 202
CursorY, 202
P CursorY2, 203
findX, 209
Password dialogs, 50
fitViewToContour, 209
Password input mode (asterisk), 71
fitViewToContours, 208
PI services, 112
ForeColor, 200
PLC variable
ForeColorY2, 201
Read, 146
GridColor, 201
Write, 146
GridColorY2, 201
Position
hideAllContours, 208
Input/output field, 75, 82
hideContour, 207
Short text, 75, 82
KeepAspectRatio, 198
Progress bar with two color changes, 69
moveCursorOnContourBack, 218
Progress bar without color change, 70
moveCursorOnContourBegin, 217
Protection levels, 238
moveCursorOnContourEnd, 217
Public slots, 260
moveCursorOnContourNext, 217
Overview of functions, 204
Overview of properties, 193
R Overview of signals, 219
RECT (defining a rectangle), 167 removeContour, 208
Registers repaint, update, 211
Exchanging data, 148 ScaleTextEmbedded, 196
Status, 149 ScaleTextOrientationYAxis, 197
Value, 148 SelectedContour, 199
serialize, 218
setCursorOnContour, 216
S setCursorPosition, 215
setCursorPositionY2Cursor, 215
Short text, 72
setFillColor, 215
SIEsGraphCustomWidget
setIntegralFillMode, 210
Reading and writing properties, 192
setMaxContourObjects, 206

Index
setPenColor, 214 Check, 116

setPenStyle, 214 CURPOS, 85
setPenWidth, 214 CURVER, 85
setPolylineMode, 209 End, 126
setView, 205 ENTRY, 86
showAllContours, 207 ERR, 87
showContour, 207 FILE_ERR, 87
ShowCursor, 202 FOC, 89
ViewChanged, 219 Parameter, 71
ViewMoveZoomMode, 203 S_ALEVEL, 90
Signal color"; "progress bar, 75 S_CHAN, 90
Signal values"; "progress bar, 72 S_CONTROL, 91
SlX3dViewerWidget, 259 S_LANG, 91
Softkey S_NCCODEREADONLY, 92
Assign properties, 53 S_RESX, 92
Properties, 55 S_RESY, 92
Start softkey, 27, 28 Variable status, 63
Strings, 83 Variable type, 71
Sub-dialog, 139 INTEGER, 77
Subprogram, 112 VARIANT, 78
Block identifier, 115 Variable value, 63
Call, 114
cancel, 149
Variable, 115 W
System colors, 238
Write mode, 75
System variable, 65, 75
T
Table
Defining columns, 177
Definition, 174
Programming, 176
Text, 72
Toggle field, 67, 72, 80
Toggle symbol, 73
Tooltip, 72, 74
Trigonometric functions, 96
U
Unit text, 72
Update rate, 73
User variable, 75
V
V_SEPARATOR (define vertical dividing line), 168
Variable
calculating, 64
Change property, 76

System settings 1
Configuring the system 2

SINUMERIK
Appendix A
SINUMERIK 840D sl
NCU operating system (IM7)
Valid for:
CNC software for 840D sl / 840DE sl version 4.7 SP2
10/2015
6FC5397-1DP40-5BA3
Legal information
DANGER
WARNING
CAUTION
NOTICE
damage.
Qualified Personnel
Note the following:
WARNING
Trademarks

Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents
1 System settings............................................................................................................................................5
1.1 Delivery condition of the system..............................................................................................5
1.2 Meaning of switch positions.....................................................................................................7
1.3 System booting........................................................................................................................8
1.4 Displays during system booting...............................................................................................9
2 Configuring the system...............................................................................................................................13
2.1 Ethernet interfaces of the NCU..............................................................................................13
2.2 How to determine the IP address of the NCU........................................................................14
2.3 Configuration file "basesys.ini"...............................................................................................15
2.3.1 Section [ExternalInterface].....................................................................................................15
2.3.2 Section [InternalInterface]......................................................................................................18
2.3.3 Section [IBNInterface]............................................................................................................21
2.3.4 Section [SNMP]......................................................................................................................22
2.3.5 Section [DCP].........................................................................................................................24
2.3.6 Section [LLDP]......................................................................................................................24
2.3.7 Section [LinuxBase]...............................................................................................................25
2.3.8 Example: Configuration file 'basesys.ini'................................................................................28
2.4 Service Commands................................................................................................................35
2.4.1 Using service commands.......................................................................................................35
2.4.2 Syntax for the Actions............................................................................................................36
2.4.3 Generic elements...................................................................................................................37
2.5 Description of the actions.......................................................................................................39
2.5.1 Help........................................................................................................................................39
2.5.2 Check-cf.................................................................................................................................40
2.5.3 Clear.......................................................................................................................................40
2.5.4 Closeport................................................................................................................................40
2.5.5 Connect..................................................................................................................................41
2.5.6 Disable...................................................................................................................................43
2.5.7 Disconnect.............................................................................................................................44
2.5.8 Distribute................................................................................................................................44
2.5.9 Enable....................................................................................................................................45
2.5.10 Openport................................................................................................................................47
2.5.11 Port status..............................................................................................................................48
2.5.12 Restart....................................................................................................................................48
2.5.13 Restore...................................................................................................................................49
2.5.14 Save.......................................................................................................................................50
2.5.15 Show......................................................................................................................................51
2.5.16 Start, Stop..............................................................................................................................55
3 Service and diagnostics..............................................................................................................................57
3.1 Creating a service system......................................................................................................57

Table of contents
3.1.1 How do you create a service system for the NCU?...............................................................57

3.1.2 This is how you operate the service system..........................................................................59
3.1.3 Diagnostics functions.............................................................................................................60
3.1.4 This is how you connect to a network drive...........................................................................61
3.2 Backup license.......................................................................................................................63
3.2.1 This is how you backup the license key.................................................................................64
3.3 Backup data via the service menu.........................................................................................66
3.3.1 This is how you backup user data..........................................................................................66
3.3.2 This is how you restore user data..........................................................................................69
3.3.3 This is how you create a complete backup of the CompactFlash Card.................................70
3.3.4 This is how you install a complete system backup.................................................................72
3.4 Backing up data via the service shell.....................................................................................74
3.4.1 This is how you save data on a service system.....................................................................74
3.4.2 This is how you restore data from the service system...........................................................75
3.4.3 This is how you save data on a network drive.......................................................................75
3.4.4 This is how you restore data from the network drive..............................................................76
3.5 Updating the software............................................................................................................78
3.5.1 This is how you update the firmware......................................................................................78
3.5.2 This is how you update the software......................................................................................80
3.6 System diagnostics................................................................................................................82
3.6.1 Performing system diagnostics..............................................................................................82
3.6.2 This is how you change the system settings..........................................................................84
3.6.3 This is how you check the CompactFlash Card.....................................................................85
3.6.4 Calling the VNC Viewer..........................................................................................................87
3.6.5 WinSCP and PuTTY..............................................................................................................89
A Appendix.....................................................................................................................................................91
A.1 Abbreviations.........................................................................................................................91
Index...........................................................................................................................................................93

System settings 1
1.1 Delivery condition of the system
Scope of validity
This document is valid for all systems that are supplied with Linux as operating system on the
CompactFlash Card, such as all NCUs of the type NCU 7x0.3
Directories on the CompactFlash Card

A Linux partition as well as a FAT partition are available on the CompactFlash Card. The
memory space of the CompactFlash Card is occupied mainly by the Linux-EXT3 partition
containing the system software and the user data. A 2 MB large FAT partition still exists but
only for internal administration purposes.
When the system is in operation, the following directories (this is a selection and not a complete
list) are available in the EXT3 partition on the CompactFlash Card:
Directory Use
/siemens Reserved for Siemens system software
/addon Reserved for Siemens add-on software
/oem Additional software and configurations of the machine manufacturer
/user ● Storage of user data
● Configuring the HMI application
● Data that is created when commissioning the system using the HMI
application.
/system Linux operating system
/user/system/etc File basesys.ini (modifications possible)
/user/common/tcu TCU configuration files
/var/log/messages System log file (same as event.log under Windows)
Note
Files in the directory under /user always have priority over files with the same name in the
directory /oem → /addon → /siemens.

System settings
Partitioning of the memory

The memory of the CompactFlash Card is purely logically partitioned, i.e. the user can in
principle assign the memory up to the end of the physical limit. An alarm under LINUX is
triggered if less than 4 MB free memory is available.
Directory 1 GB card 8 GB card

/oem 100 MB 1 GB
/addon
/user 256 MB 2 GB
Preset users
The following users have already been set up:
Users Access level Target group

Operator Key switch position 0 Operators, users
Operator1 Key switch position 1 Operators, users
user Password:CUSTOMER Operators, users
service Password: EVENING Service personnel
manufact Password:SUNRISE Machine manufacturer

System settings
1.2 Meaning of switch positions
1.2 Meaning of switch positions
Overview
The NCU has two twist buttons in the lower section of the front panel.
NCK commissioning switch

PLC mode switch 69&
1&.
3/&
Rotary switch SVC/NCK

The switch positions have the following significance:
Switch position Operating mode of the NCK

0 Normal boot-up NCK
1 NCK boot-up with default values (= memory reset)
2 The NCK (and PLC) starts up with the data that was saved at the last shutdown.
7 Debug mode (NCK is not started.)
8 IP address of the NCU is displayed on the seven-segment display.
All others Not relevant
PLC twist button

The switch positions have the same significance as for a SIMATIC S7-CPU:
Switch position Operating mode of the PLC

0 RUN
1 RUN (protected mode)
2 STOP
3 Memory reset (MRES)
All others Not relevant

System settings
1.3 System booting
1.3 System booting
Sequence
To ensure unproblematic booting of the NCU, the CompactFlash Card must be inserted.
When the NCU is booting up, visual information on the current operating system is provided
using the following displays:
● The RDY-LED flashes slowly orange when the CF card is accessed.
● During booting, the 7-segment display outputs different codes that indicate, for example,
when the BIOS is started, when the CompactFlash Card is accessed, etc.
When the booting has been completed successfully, the following is displayed:
● The PLC LED lights up green.
● The 7-segment display shows "6." with a flashing dot.
● The RDY-LED lights up green. All other LEDs are not illuminated.
Performing a reset operation

The reset button is located behind the blanking plate of the NCU.
A reset operation resets the entire system and requires a system restart. This is comparable
to a "Power On reset" except that the 24 V power supply does not have to be switched off.
Booting for servicing purposes

For service or diagnosis purposes, the NCU can be booted from a service system, the
Emergency Boot System.
See also
How do you create a service system for the NCU? (Page 57)

System settings
1.4 Displays during system booting
Behavior of the LEDs when booting

Of the LEDs on the front panel of the NCU, only the RDY LED and its status is important when
booting up the NCU.
LED: LED designations: State/phase 7-segment display

RDY RUN STOP SU/PF
SF DP1 DP2 OPT
Orange Orange BIOS boot Post codes, see table: Load
BIOS
Slowly flashing or‐ Set by PLC/option module Booting up the kernel 1
ange (0.5 Hz) Phase 2: Initialization of the
driver
Slowly flashing or‐ Set by PLC/option module Booting the basic system See table: Load operating
ange/green Phase 3: Initialization of the ba‐ system
(0.5 Hz) sic system
OFF Set by PLC/option module NRK/NCK outputs See table: NRK/NCK outputs
green/red flashing Set by PLC/option module Basic system shutdown OFF
0.5 Hz)
red Set by PLC/option module Kernel shutdown OFF
red (5 Hz) Set by PLC/option module SINAMICS fault ---
SINAMICS faults and alarms, also see: SINAMICS S120/S150 List Manual (LH1)
Load BIOS
7-segment dis‐ Meaning

play
00 Before loading the Master Boot Record (MBR) from the CompactFlash Card
01 Before starting the Master Boot Record (MBR) codes
02 Master Boot Record (MBR) code started
03 Second stage of the boot loader started, before reading the configuration file
04 Before loading the kernel
05 Before starting the kernel
Booting the basic system
7-segment display Meaning

1 (begin) Basis initializations
2 (prepfs) Cleaning up and preparing the file system
3 (hostname, loopback) The name is set and the loopback interface configured.
4 (syslog) Starting the system logging
Starting the CFS class 1, provide the network interfaces.
5 (network) Initializing the network interfaces and the firewall

System settings
7-segment display Meaning

6 (NCU:rtai, TCU:tcuconfig) Starting the time server (ntpd)
7 (lsh) Starting the SSH server (if required, generate a host key if still not avail‐
able).
8 (NCU:ftpd, TCU:mtouch) Starting the FTP server
9 (NCU:tcuservices, Starting the TCU services (TFTP, VNC)
TCU:usbexport)
NRK/NCK outputs

play
1 Not applicable.
2 Not applicable.
3 Debugger was initialized.
4 NRK operating system was successfully activated.
5 NRK operating system has booted, init task is being processed (→ the application
boots).
6 Initialization was successfully performed; the control is in cyclic operation.
6. with flashing point: The control is in cyclic operation and the cycles are active.
F Internal error: Can only be read via additional diagnostics.
1 or 2 CompactFlash Card and SRAM data do not match. To resolve this problem, a gen‐
eral reset is required by booting with switch position 1 or 2.
Lxx=yyy Internal error when starting NCK, "xx" is the line number in the mcsystem.ini, "yyy"
is a unique error code for the code position.
System error
LED: LED designations: Meaning 7-segment dis‐

RDY RUN STOP SU/PF play
SF DP1 DP2 OPT
Rapidly flashing Set by PLC/option module Permanent error:
red (2Hz) The system is stopped. see the following
Rapidly flashing Set by PLC/option module Temporary error: table
red/orange (2 Hz) The system may continue to run with re‐
stricted functions.

play
Permanent error:
C "crash": The operating system crashes (this approximately corresponds to a Blue
Screen for Windows); details can be found in the system log file.
P "partition": Error when repartitioning

System settings

play
Temporary error:
E "error": A read or write error has occurred on the CompactFlash Card (an additional
point is displayed for a write error). It is possible that the CompactFlash Card is
defective and should be replaced.
F "full": The CompactFlash Card is too full, so it is probable that not all of the services
will be able to be successfully started.
When booting, this error is displayed for 1 minute; the system then continues to boot,
however, it can be assumed that problems will occur.

System settings

2.1 Ethernet interfaces of the NCU
For the operation of an NCU:
● No more than one NCU may be operated as a DHCP server on the system network.
● An external mouse is recommended when using the System Network Center.
Configuration of the interfaces

The following connections can be established via the Ethernet interfaces:
Interface Labeling Inter‐ Terminal settings

nal
name
Ethernet IE1/OP X120 (Eth 2) Connection to the system network with preset IP address
192.168.214.1 with subnet screen form 255.255.255.0
and active DHCP server for SINUMERIK
Ethernet IE2/NET X130 (Eth 1) Connection to company network as standard DHCP client
Ethernet X127 (Ibn 0) Service terminal with fixed IP address 192.168.215.1 and
fixed subnet screen form 255.255.255.224 with active
DHCP server
Network interface
The network interface is an interface that enables network communication. These are the
Ethernet interfaces on the NCU.
VNC (Virtual Network Computing)

Virtual Network Computing is a software that displays the screen contents of a remote
computer, with a running VNC server, on a local computer, with a running VNC viewer, and in
return sends keyboard and mouse movements of the local computer to the remote computer.

Configuring the system
2.2 How to determine the IP address of the NCU
2.2 How to determine the IP address of the NCU
NCU in the system network (X120)

On the X120, the NCU is pre-selected as required: No settings are necessary.
NCU in the company network (X130)

On the X130, the NCU is set to the address reference via DHCP. If the company network has
a DHCP server no further settings are required.
Example: Determining the IP address

There are several possibilities for determining the address that the NCU obtained in the
company network:
● If the NCU boots in switch position 8, it shows the IP address on the X130 on the 7-segment
display.
● Once the NCU has booted successfully, open a service shell on the TCU and execute the
following command (Page 51) to obtain the desired information:
SC SHOW IP
If the company network has no available DHCP server or if this cannot be used, you are given
the option to set a fixed address for the NCU on the X130 (in accordance with the addresses
already used in the company network).
The following command displays the IP address on the X130:
SC SHOW IP -X130
Note
The IP addresses can also be set directly from the SINUMERIK Operate user interface in the
"Commissioning" → "Network" operating area.

2.3 Configuration file "basesys.ini"
Storage path
For a Linux basic system the original file can be found on the CompactFlash Card under the
path /system/usr/etc. OEM versions are stored under /oem/system/etc, as well as user
versions under /user/system/etc.
Use
Settings are made in the basesys.ini file that specify the behavior of the system in the network.
To edit the basesys.ini file:
● Comments are introduced by ';' or '#' at the beginning of the line, and span the width of the
line. Empty lines are also handled as comments.
● The sections that start with a "[NAME]" line are ignored by the basic system itself, but are
sometimes used by the HMI.
● Variable definitions are written in the form "NAME=VALUE". Blanks are permitted around
the '=' character. The value may also be enclosed in double quotation marks, but this is
optional.
Note
Suitable editors for Linux
In most Linux system files, lines may only be ended with LF, and not with CRLF as in
Windows. Please take note of this when selecting an editor. The HMI application editor
under "Commissioning” is suitable.
In the Linux operating system, the UNIX editor vi is available.
Please take note that the Linux operating system is case-sensitive.
Reference
To make settings in the basesys.ini file, dialogs are provided in the "Commissioning" operating
area in SINUMERIK Operate in order to display or modify the values of the individual variables:
Commissioning Manual "SINUMERIK Operate" (IM9)
2.3.1 Section [ExternalInterface]
Description
In this section, the parameters and settings for the external Ethernet interface are defined. For
an NCU7x0, this is X130 (Eth1). If the external interface is in DHCP mode, i.e. the value of
ExternalIP is empty or not defined, then all parameters listed here, with the exception of
"DHCPClientID", are accepted by the DHCP server as long as the server provides a value for
the parameter.

DisableCompanyNet
If this variable is set to 1, the X130 interface to the company network is not initialized and is
thus not available.
Value: Empty, 0 or 1
Default: Empty
ExternalIP
If ExternalIP is not empty, the fixed IP address specified there is used in the company network
interface. The ExternalNetMask then also needs to be set, as well as the gateway, name
servers, host name, and domain if required.
If ExternalIP is not set or is empty, a DHCP client is started on the interface.
Value: IP address
Default: Empty
ExternalNetMask
ExternalNetMask must be set together with ExternalIP, in order to define the size of the network.
Value: Subnet mask

Default: Empty
Gateway
If the value of gateway is not empty, the host specified there is used as the default gateway,
which means that all IP packets that cannot be directly assigned are sent there for routing.
If no gateway is specified, only the networks that are directly connected are accessible.
Value: IP address
Default: Empty
Nameservers
If DNS name servers are specified here, then these must be used to resolve symbolic host
names, i.e. at most of the points where an IP address is expected, a computer name can also
be used instead.
The name server setting is also sent to your DHCP client (TCU, PG) via the DHCP server of
the NCU, so that this can also work with symbolic names.
Value: List of IP addresses (separated by blanks)

Default: Empty

Timeservers
Here you can specify a list of NTP servers (Network Time Protocol) that can be used by the
NTPD on the NCU for time synchronization. The status of NTPD is output in the system log
file /var/log/messages
Value: List of IP addresses (separated by blanks)

Default: Empty
Note
Setting the time zone and the time server
"Commissioning" → "Date time >" softkey operating area.
Hostname
Here you can define a name for the local host. This manually assigned name takes priority
over all other names.
The host name is determined in the following order:
● Host name from the basesys.ini file, if set.
● A name received from the DHCP server (if DHCP client mode and a name have been
supplied), the result of a reverse DNS lookup, i.e. which name belongs to the IP received
(if name servers are defined).
● Default name ("NONAME_...")
Because the host name is also used as DNS name it must satisfy the corresponding
requirements of the RFC:
● ASCII letters (a-z, A-Z), numbers (0-9) and '-'
● max. 63 characters
Value: Name
Default: Empty
Domain
These variables can be used to configure the DNS domain. The effect is that names in this
domain can be resolved without qualification (e.g. if the domain is "test.local", you can also
specify the name "computer1.test.local" as "computer1").
Value: Name
Default: Empty

DHCPClientID
With these variables, you can influence which ClientID the DHCP client presents to its server.
This ID can be used by the server to assign certain parameters to the client, for example a
static IP address.
Usually, the MAC address of the Ethernet interface is used for this purpose. This is also the
default setting. Alternatively, you can also use the host name ("@NAME"), which must then
be defined in the basesys.ini, in order to be recognized before the DHCP request. It is also
possible to use an arbitrary string for ClientID.
Value: @MAC, @CFID, @NAME or any string

Default: @MAC
2.3.2 Section [InternalInterface]
Description
In the section [InternalInterface] the data is specified for synchronization of the DHCP server
in the system network.
DisableSysNet
If this variable is set to 1, the X120 interface to the system network is not initialized and is thus
not available.
Default: Empty
InternalIP
Use this variable to set the fixed IP address in the system network. InternalIP should always
be used together with InternalNetMask.
Value: IP address
Default: 192.168.214.1
InternalNetMask
Specifies the subnet mask for InternallP and should always be used together with it.
Value: Subnet mask

Default: 255.255.255.0

InternalIP_Alias
Use this variable to define an additional alias IP address for the interface of the system network
(X120); this is practical in certain application cases.
Value: IP address
Default: Empty
InternalIP_Alias should always be used together with InternalNetMask_Alias.
InternalNetMask_Alias
This variable specifies the subnet mask for InternallP_Alias and should always be used
together with it.
Value: Subnet mask

Default: Empty
EnableDHCPD_SysNet
If this variable is set to zero, then the start of the DHCP server in the system network X120 is
prevented.
Default: Empty
SyncModeDHCPD_SysNet
If this variable is not set to "OFF", the DHCP servers synchronize themselves in the system
network (X120) so that only one of them actively assigns addresses. This makes it possible
to operate multiple NCUs or PCUs concurrently without having to adjust the network settings.
Value: ON_MASTER, ON_HIGH (= ON), ON_LOW, or OFF

Default: ON_HIGH

The DHCP servers that are not active go into "standby" mode; in this mode they regularly get
the current address data and TCU data from the active server so that if the active server fails
a standby server can take over the active role without data loss.
● With the ON_MASTER setting instead of ON_HIGH you can influence the synchronization
in such a manner that the server with the "Master" setting is always the active server (for
this it must be active in the network). This means that in the normal situation
deterministically the same control is always the DHCP server and you can find the actual
address data (/var/etc/udhcp-eth0.leases) and the TCU data (/user/common/tcu/...) there.
ON_MASTER should only be set for a single DHCP server in the system network; there
should not be multiple masters.
● The ON_LOW setting assigns the DHCP server a lower priority than normal. It then
becomes the active server if no server with ON_HIGH or ON_MASTER is found in the
network.
Note
Compatibility with earlier versions
The priority level "ON_LOW" is used automatically if the DHCP server is switched off.
Although such an NCU does have a (standby) DHCP server and keeps a backup of the
lease data, normally, however, it does not become an active server.
InternalDynRangeStart
With the two variables InternalDynRangeStart and InternalDynRangeEnd, you can explicitly
specify the range of IP addresses assigned by the DHCP server. The number range of the
presetting should normally suffice.
Value: IP address
Default: First address in the system network + 10 or +2 (if ≤ 16 addresses)
InternalDynRangeEnd
Value: IP address
Default: Last address in the system network - 15 or -1 (if ≤ 16 addresses)
DHCPDNoMasterWait
If a synchronizing DHCP server has once "detected" a master server in the past, then it waits
for synchronization until the time specified here elapses before it becomes the active server.
This additional pause makes it possible for the intended DHCP master to become the active
DHCP server without displacement even if it is shortly switched on thereafter, or takes longer
to boot than other controls.
Value: Time in seconds

Default: 120

InternalDNSDomain
This is used to specify the Top Level Domain (TLD) name that is used in the system network.
The DNS server of the NCU assigns names to the devices in the system network in this zone.
Name requests for all other zones are forwarded to an external name server in the company
network.
As presetting the "local" recommended by the RFC1035 is used for local networks, to avoid
conflicts with globally defined domain names.
Recommendation: The default setting should be maintained.
Value: Domain name (letters, digits, '-', '_', max. 63 characters)

Default: local
DisableNATRouting
The default setting permits that a machine can access a company network from the system
network via the control using the NAT routing (= "Network Address Translation"). In this case,
the NCU converts the source address of the packets to its own address, and handles the
response packets in the inverse way.
If this variable is set to zero, the NAT routing of the NCU from the internal interfaces eth0
=X120 and ibn0 =X127 to the external network on eth1 =X130 is prevented. In order that the
NAT routing is not simultaneously shut down for both internal networks, using the values
"X120" or "X127", the system network or the commissioning network is selectively shut down.
Value: empty, 0, 1, X120 or X127

Default: Empty
2.3.3 Section [IBNInterface]
Description
The settings in this section affect interface X127.
EnableDHCP_IBNNet
If this variable is set to 1 then this prevents the start of the DHCP server at the commissioning
interface X127.
Default: Empty

DisableIBNNet
If this variable is set to 0, then the commissioning interface X127 is not initialized and is thus
not available.
Default: Empty
EnableSysNetToIBNForwarding
If this variable is set to 1, it is possible to transfer packets from the system network (X120) to
X127. A firewall usually prevents this.
It is important to remember that there is no NAT involved, and the sender is responsible for
ensuring (with a suitable routing entry, for example) that packets sent to the PG or service PC
on X127 with the address 192.168.215.x only reach the NCU to which the device is connected.
Default: Empty
NOTICE
Security risk
Note that opening the firewall can represent a security risk. Permit feed-through only for the
period for which it is actually required. Note that every accessible service can have security
gaps.
DisableIBNForwarding
If this variable is set to 1, the NAT transfer of packets from the service connection X127 to the
system network (X120) is deactivated.
Default: Empty
2.3.4 Section [SNMP]
Description
Character strings delivered via SNMP (Simple Network Management Protocol) are entered
here. This is a way of giving out information.

SNMPLocation
This string is used for the standard OID SNMPv2-MIB::sysLocation. It is possible to specify a
location here, which can be subsequently called with an SNMP client.
Value: Any character string

Default: Empty
SNMPContact
This string is used for the standard OID SNMPv2-MIB::sysContact. It is possible to specify a
contact address here, which can be subsequently called with an SNMP client.

Default: Empty
SNMPAutLocation
This string is used for the Siemens-specific OID
automationSystemIdent.automationLocationTag. It is possible to specify an additional location
here, which can be subsequently called with an SNMP client. This is similar to SNMPLocation
in terms of the MIB description, although it is intended for entries relating to automation.

Default: Empty
SNMPFunction
This string is used for the Siemens-specific OID
automationSystemIdent.automationFunctionTag. It is possible to specify a function
designation here, which can be subsequently called with an SNMP client.

Default: Empty
SNMPStation
This string is used for the SINUMERIK-specific OID
mcSinumerikMIB.mcSinumerikMiscStation. The value is the name of a station to which the
device belongs. Devices with the same station name are therefore identified as being
contiguous.

Default: Empty

2.3.5 Section [DCP]
Description
The parameters in this section define the properties of the DCP protocol (Discovery and Basic
Configuration Protocol), e.g. that are used in the menu item "Accessible nodes" of STEP 7.
InternalDcpEnabled
This can be used to switch-on and switch-off the DCP in the system network (X120); for the
NCU, the value is also used for X127.
Value: 0 or 1
Default: 1
ExternalDcpEnabled
This can be used to switch-on and switch-off the DCP in the company network (X130).
Value: 0 or 1
Default: 0
2.3.6 Section [LLDP]
Description
The parameters in this section define the properties of the LLDP protocol (Link Layer Discovery
Protocol), which is used by several applications for network diagnostics.
InternalLldpEnabled
This can be used to switch-on and switch-off the LLDP in the system network (X120); for the
NCU, the value is also used for X127.
Value: 0 or 1
Default: 1
ExternalLldpEnabled
This can be used to switch-on and switch-off the LLDP in the company network (X130).
Value: 0 or 1
Default: 0

InternalLldpTLVsTxEnabled
Using this parameter, additional information in the LLDP packets are enabled at X120/X127,
which are normally not included.
Value: Numerical value from 0 ... 15

Default: 0
The value is a bit field, i.e. the total value is obtained as a sum (total) of the specified numbers,
if the corresponding information is to be sent:
1: port description
2: system name
4: system description
8: capabilities
ExternalLldpTLVsTxEnabled
Using this parameter, additional information in the LLDP packets is enabled on the X130, which
are normally not included.
Value: Numerical value from 0 ... 15

Default: 0
The value corresponds to parameter InternalLldpTLVsTxEnabled.
2.3.7 Section [LinuxBase]
Description
Additional setting possibilities of the Linux system are combined in this section.
Synchronizing the time

There are two different cases:
● If there is an external NTP server to act as a time server (entered in the basesys.ini file or
via DHCP), then the PLC clock is synchronized via the Linux clock.
● If there is no external time server, the PLC clock will be the master for the Linux clock:
Note
With "memory reset" the time of the PLC clock remains intact and is not reset.
If the PLC is switched on in switch position 3 "MRES" then the time will be reset. In this
case the valid time is taken over from the Linux system and does not need to be reset.

Timezone
The time zone set here is used by the system to convert UTC time (Universal Time
Coordinated) to local time. The time zone is sent to all applications via the environment variable
"TZ", and is taken into account by the libc function localtime().
The time zone influences all time entries in the basic system, particularly for the command
"date", for "ls -l", and in the system log file /var/log/messages.
Value: Time zone description (see syntax and examples)

Default: UTC
Examples:
If the control is to synchronize with one of the listed time zones, the examples in the table can
simply be copied.
Zones with daylight saving time/standard time:

Europe: WET0WEST,M3.5.0,M10.5.0
CET-1CEST,M3.5.0,M10.5.0
EET-2EEST,M3.5.0,M10.5.0
USA: EST5EDT,M4.1.0,M10.5.0
CST6CDT,M4.1.0,M10.5.0
MST7MDT,M4.1.0,M10.5.0
PST8PDT,M4.1.0,M10.5.0
Zones without daylight saving time/standard time:
China: CST-8
Japan: JST-9
Note
Setting the time zone and the time server
"Commissioning" → "Date time >" softkey operating area.
Syntax for the time zone description

In order to synchronize with a different time zone, the following syntax applies:
tz offset dst,Mmwd,Mmwd
Syntax (obligatory):
tz offset Time zone and difference from UTC:
West of the zero meridian, the difference must be added; east of the zero
meridian, the difference must be subtracted.
Syntax (optional, only if there is daylight saving time):
dst,Mmwd,Mmwd Daylight saving time zone with beginning and end
m (1 ≤ m ≤ 12) m: Month

w (1 ≤ w ≤ 5) w: Week of the month, i.e. w = 5 is the last week of the month

d (0 ≤ d ≤ 6) d: Day of the week (from 0 = Sunday to 6 = Saturday)
LogFileLimit
The size of the system log file /var/log/messages can be restricted with this variable. By
entering "Zero", the log file has no size limitations.
The specified limit is no hard limit for reasons of efficiency but rather a sort of target value. If
the log file reaches the target value times factor 1.5, then it is reduced to around 75% of the
target value. A check is carried out every two minutes maximum to see if the file has become
too large.
Value: Size in KB
Default: 100 KB
FirewallOpenPorts
Here you can specify a list of the ports which is to be enabled in the firewall of the external
network interface. The protocol is "TCP" or "UDP", the port is the (numerical) port number of
the service to be enabled. Several entries are separated by blanks.
Value: List of protocol/port pairs

Default: Empty
NOTICE
Security risk
DisableSubsystems
Using this variable, you can suppress mounting and starting of certain subsystems (CFS
systems). Several subsystem names can also be specified - separated by blanks.
Value: List of CFS names (separated by blanks)

Default: Empty
The names can either be simple CFS basic names (e.g. "nck"), whereby all CFS systems with
this name are ignored. Alternatively you can specify an absolute path (e.g. /siemens/
sinumerik/nck) referring specifically to this CFS system.
It is also possible to set "DisableSubsystems=all" whereby not a single CFS system can be
mounted or started any more.

DisableNTPTimeSync
If this variable is set to 1, then the NTPD server (Network Time Protocol Daemon) for the time
synchronization is not started and the time of day is not synchronized.
Value: 0 or 1
Default: 0
DisablePLCTimeSync
If this variable is set to 1, synchronization of the system time with the PLC time (in both
directions) will not be executed.
Value: 0 or 1
Default: 0
EnableCoreDumps
If this variable is set to 1, a log file for processes is created and stored under /var/tmp. The
log file contains a memory dump of the process that has crashed or that has terminated.
Default: 0
CheckTCUforUpdatePackage
If this variable is set to 1, when booting, the USB interface at the front of the TCU is checked
to identify any storage medium. If, when checking the update packages, type *.usz files created
with Create MyConfig are found, then the installation of these update packages is started.
With the default setting zero, this check is skipped in order to save time.
Value: 0 or 1
Default: 0
2.3.8 Example: Configuration file 'basesys.ini'
Configuration file basesys.ini

The following defaults are applied to the template_basesys.ini file which is supplied in the /
siemens/system/etc directory:
; ------------------------------------------------------------------
; Default Linux basesystem configuration
; ------------------------------------------------------------------
;

; section ID is for Windows compatibility and is ignored ;)

[ExternalInterface]
; If DisableCompanyNet is set to 1, the whole interface will

; be disabled.
;DisableCompanyNet=1
; If ExternalIP is set, you can force the external Ethernet

; interface to use a fixed IP address etc. instead of using DHCP
; if a Hostname is set, it even overrides one received by DHCP
;ExternalIP=210.210.210.210
;ExternalNetMask=255.255.255.0
;Gateway=210.210.210.1
;Nameservers=210.210.210.1 210.210.210.2
;Timeservers=210.210.210.3
;Hostname=somename
;Domain=example.com
; if ExternalIP is empty (default), DHCP is used with the following
; ClientID the default is "@MAC" to use the MAC address,
; alternatives are "@NAME" to use the hostname (Hostname above),
; "@CFID" to use the ID of the CF card if one is available
; (like on X120), or any other arbitrary string
;DHCPClientID=@MAC
[InternalInterface]
; If DisableSysNet is set to 1, the whole interface will

; be disabled
;DisableSysNet=1

you
; can change the address on the internal/TCU/automation/system net.
;InternalIP=192.168.214.1
;InternalNetMask=255.255.255.0
; These two can define an alias IP for X120.

;InternalIP_Alias=192.168.216.1
;InternalNetMask_Alias=255.255.255.0
; This defines a "name of station" for ProfiNet (ERTEC interface)
; for use with DCP, default is the normal hostname.
; Please be careful if a PN-Name can also be set by other means,
; for example by NCU-Link. Usually it is not needed to define
; a name here.
;PN_StationName="PN_IO"
; Setting EnableDHCPD_SysNet to 0 suppresses that a DHCP server is

started on
; that interface
;EnableDHCPD_SysNet=0
; Set synchronization of all DHCP servers in the

; system/TCU network (X120). Possible values are:
; OFF,
; or ON_LOW (low priority),
; or ON or ON_HIGH (normal priority),
; or ON_MASTER (highest priority),
; or ON_CLIENT_SYNC (starts DHCP client only, synchronization
active),
; or ON_CLIENT_NO_SYNC (starts DHCP client only, synchronization
; inactive),
; ON_MASTER is used to make this machine deterministically the
; DHCP master server, but should be used only for one server
; in the network.
;SyncModeDHCPD_SysNet=ON
; This is the range of dynamic IPs given out by the DHCP server
; Defaults should be sensible
InternalDynRangeStart=192.168.214.10InternalDynRangeEnd=192.168.214.
239
; If once a DHCP master was seen, the DHCP server waits this many
seconds
; for the master to show up before trying to become the active server

;DHCPDNoMasterWait=120
; DNS domain name used for names in system/TCU network

; (default is "local" to conform with RFC)
InternalDNSDomain=local
; FixedDomain and FixedNameservers can be used to define a DNS domain

and
; nameservers, if the DHCP/DNS server on system network is disabled
;FixedDomain=local
;FixedNameservers=192.168.214.1
; If DisableNATRouting is set to 1, the NCU won't forward

; from TCU or IBN net
; (X120 anad X127, resp.) to external net (X130).
; If set to "X120" or "X127", forwarding will only be
; disabled from that interface.
;DisableNATRouting=1
[IBNInterface]
; If DisableIBNNet is set to 1, the whole interface will be disabled

;DisableIBNNet=1
; Setting EnableDHCPD_IBNNet to 0 suppresses that a DHCP server is

started on
; that interface
;EnableDHCPD_IBNNet=0
; If DisableIBNForwarding is set to 1, the NCU won't do NAT routing

; from IBN network (X127) to system network (X120).
;DisableIBNForwarding=1
; If EnableSysNetToIBNForwarding is set to 1, the NCU forwards

packets from

; X120 to X127. (Please note that the sending host must be able to
route
; the packets to the NCU by its own means, the NCU just accepts and
forwards
; packets to 192.168.215.x with this setting.)
;EnableSysNetToIBNForwarding=1
[SNMP]
; The following variables define strings which are delivered on
; certain SNMP requests.
; SNMPLocation and SNMPContact are reported for the standard OIDs
; SNMPv2-MIB::sysLocation and SNMPv2-MIB::sysContact, resp.
; SNMPAutLocation and SNMPFunction are used in the Siemens A&D
specific
; AUTOMATION-SYSTEM-MIB as
automationSystemIdent.automationLocationTag
; and automationSystemIdent.automationFunctionTag, resp.
SNMPLocation="not specified"
SNMPContact="not specified"
SNMPAutLocation="not specified"
SNMPFunction="not specified"
SNMPStation=""
[DCP]
; These variables en/disable the DCP protocol on X120/X127
; and X130, resp.
;InternalDcpEnabled=0
;ExternalDcpEnabled=1
[LLDP]
; These variables en/disable the LLDP protocol on X120/X127
; and X130, resp.
;InternalLldpEnabled=0
;ExternalLldpEnabled=1
[LinuxBase]

; Keep size of /var/log/messages around this value

; (not followed exactly for performance reasons)
LogfileLimit=102400
; Protocol/Port pairs to open in the firewall

; (e.g., TCP/5900, UDP/514, ...)
;FirewallOpenPorts="TCP/5900 TCP/102"
; If there is only one Ethernet interface, it's used by
; default as an external (company) network. Alternatively,
; usage as automation net (TCU boot support etc.) is possible
; by setting NetworkModel to "automation". (NCU only, Service
; and PCU20A variants!)
;NetworkModel=automation
; DisableSubsystems can be used to skip certain CFSes (= subsystems)

; a list of multiple names (separated by spaces) is possible
; a simple name means all CFSes with this name, an absolute path
; (e.g.,/siemens/sinumerik/nck) exactly this one CFS with
; the special value "ALL", all subsystems can be disabled
;DisableSubsystems=nck
; Directory for OEM netboot files (served by tftp to diskless clients)

NetbootDirectory=/oem/common/netboot
; Properties of local time zone: names, offset, start and end day
; Some examples:
; Europe: WET0WEST,M3.5.0,M10.5.0
; CET-1CEST,M3.5.0,M10.5.0
; EET-2EEST,M3.5.0,M10.5.0
; USA: EST5EDT,M4.1.0,M10.5.0
; CST6CDT,M4.1.0,M10.5.0
; MST7MDT,M4.1.0,M10.5.0
; PST8PDT,M4.1.0,M10.5.0
; China: CST-8
; Japan: JST-9

Timezone=UTC
; If DisablePLCTimeSync is set, no time synchronization with

; PLC will happen
;DisablePLCTimeSync=1
; Set to 1 to enable coredumps in /var/tmp

EnableCoreDumps=0

2.4 Service Commands
2.4.1 Using service commands
Overview
The service command 'sc' is a tool used for performing a range of service tasks on a
SINUMERIK NCU. The required action is written in the command line after the 'sc', e.g.: sc
help
This action produces a list of all actions with a short description. After the action, further
parameters or options can follow.
'sc' is available in both the NCU basic system and the service system (mostly in the form of a
USB memory.) However, some actions are only useful in one of the two systems (NCU/
Service). This is noted for each action.
See also
The most important terms and abbreviations are explained in the glossary.
Privilege levels
The 'sc' command can execute its actions using more privileges than are normally granted to
the calling user. For example, starting or stopping subsystems requires root privileges, but 'sc'
allows every user who belongs to the ‘service’ group to do this.
Each action of 'sc' is assigned a “privilege level”. This is a user group to which the user must
belong in order to execute the action. As the groups are hierarchically nested, members of
“higher” groups can also use the action in question. For example, the group 'manufact' is above
'service', which means that members of the group 'manufact' can call all actions that require
the privilege level 'service'.
The privilege level that the caller requires is noted for each individual action. The possible
levels are (in ascending order):
● none
● operator
● user
● service
● manufact
Example:
An action with the privilege level 'user' can also always be executed by members of the groups
'service' and 'manufact'. Actions with privilege level ‘none’ can be called by all users.
If a user does not have the required privileges, the following error message is output:
Action 'ACTION' needs at least GROUP privilege level.

2.4.2 Syntax for the Actions
Description
'sc' in the command line is essentially not case-sensitive.
The following entries are therefore interpreted as identical:
sc help show
SC help SHOW
sc HeLp sHoW
In some cases, however, upper/lower case can make a difference, for example in file or user
names. This is avoided wherever possible.
The conventions used are as follows:
● Names completely in upper case represent objects to be used depending on the situation.
Example: sc help ACTION
In this case, ACTION is to be replaced by the action for which you want a description. If
written in lower case, however, the entry should be entered as specified.
● Square brackets indicate optional entries.
Example: sc help [ACTION]
In this case the specification of an action is optional, which means that you can enter an
action, but do not have to. Square brackets may also be nested:
... [USERNAME[/DOMAIN]] ...
In this case, USERNAME and DOMAIN are both optional, but you can only enter a DOMAIN
if you have also entered the USERNAME.
● Alternatives are separated with '|'.
Example: sc start all|system|SUBSYSTEM
This means that any of the following commands applies:
sc start all
sc start system
sc start SUBSYSTEM
In the latter case, SUBSYSTEM in upper case can be replaced by a concrete subsystem
name.
● As a shortened form, alternatives can also be written in square brackets:
sc save [-full|-user] ...
Here you can use the option "-full" or "-user", or none at all.
● Options that begin with '-' can always be entered in any order.
For example, the notation could be interpreted to mean that "-force" must come after "-full"
or "-user", but this is not necessarily the case:
sc save [-full|-user] [-force] FILENAME

2.4.3 Generic elements
Overview
This sections describes the syntax elements that are used by several actions.
Permitted interface designations

The names of network interfaces are used by "sc show ip" and "sc enable DHCPSvr", for
example.
As the input of an interface is optional, it is always introduced by a '−' character. The '−' is
followed by the actual name. In most cases, multiple names are possible for the same interface.
Accepted names are:
System network port: "X120", "eth2", "tcu", "internal"

Company network port: "X130", "eth1", "factory", "extern
IBN port: "X127", "ibn0", "pg"
Permitted subsystem designations

Subsystem names are entered when using "sc enable" and "sc start", for example. In most
cases, the name of the subsystem is simply the name of the corresponding CFS, without the
path and without the extension ".cfs". For example, for the CFS /siemens/sinumerik/nck.cfs,
the relevant subsystem name is simply "nck".
It is also possible to use absolute paths (beginning with /) in a subsystem name. In the example
above, you could also use "/siemens/sinumerik/nck" as a subsystem name. The difference
between names with and without a specified path is that without the path, all CFS with this
name are included, but if the path is specified, only this exact CFS is meant.
Subsystem
A subsystem is a CFS that not only contains a collection of files, but also executes a program,
for example, at runtime. To do this, the CFS contains a script that is used to control the starting
and stopping of this program.
For this reason, only administrators are permitted to set up NFS file systems, and NFS is
usually only implemented in uniformly administrated environments. Exported file systems on
the server are addressed directly on the server via their path.
CFS (Compressed File System)

A CFS (file extension ".cfs") is a compressed file system, similar to a zip file. It contains files
and subdirectories that look like normal files on the controller at runtime. Files and directories
contained in a CFS cannot be changed. They are decompressed at runtime as required.

NFS (Network File System)

NFS is the most common protocol for remote file systems in the world of Unix, and is also
available for Windows. NFS is closely based on the Unix privilege model – each time a file is
accessed, a UID and GID are supplied which the server then uses to decide whether the
operation is permitted. The server relies on the client to provide the correct IDs.
Remote File System

A file system that is contacted over the network. The files are physically located on another
computer in the network (the "server"), but appear locally the same as all other files. Operations
performed on these files are sent via the network to the server, instead of being executed
directly on a local storage medium (such as a hard drive or CompactFlash Card).
As a server usually exports more than one file system, a name for the required file system
must also be entered in addition to the name of the server.
SMB (Server Message Block)

SMB is the underlying protocol of MS Windows file systems (also known as drives, releases,
shares, etc.). SMB connections are always active in the context of a specific user, who must
be known to the server. Exported file systems have a name (release name), by which they can
be addressed. The client does not need to know the concrete path on the server.

2.5 Description of the actions
2.5.1 Help
Description
Syntax: sc help [Action]

Alternative names: -h, - -help
Authorization level: None
Calling "sc help" without any additional action outputs a list of all possible actions with a brief
description. If you enter an additional action, you receive a more detailed description for this
action.
Examples:
sc help
All actions:
help [ACTION]
Print help about a specific or list all actions
restart
Reboot the machine
enable hmi|nck|SUBSYSTEM...
enable DHCPSvr -INTERFACE
Enable HMI, NCK, or any other subsystem
[...]
sc help enable
enable hmi|nck|SUBSYSTEM...
DHCPSvr -INTERFACE
Enable subsystem(s), like 'hmi', 'nck', and so on. A subsystem name

is the name of the CFS containing it, without the '.cfs' extension.
This enables all CFSes with that name, but you can also use a full
path (e.g., /siemens/sinumerik/nck) to enable just a specific CFS.
Another form is to enable the DHCP server on a network interface,
for example 'enable DHCPSvr -X120'.

2.5.2 Check-cf
Description
Syntax: sc check-df
Alternative names: checkcf
Authorization level: user
With this action, the CompactFlash Card is read to check whether it contains defective sectors.
If errors occur, this is noted in the /var/log/messages file.
2.5.3 Clear
Description
Various actions can be performed with the "sc clear" command; only the "clear dhcp" command
is relevant here.
clear dhcp
Syntax: sc clear dhcp [-INTERFACE]

Alternative names: ---
Authorization level: service
This command clears any state of the DHCP server at the specified interface (default setting
is the system network) and resets it to its initial state. This means that the Lease data is deleted:
All IP addresses are re-assigned in the network and the server "forgets" having ever detected
a master server.
This action is only appropriate on a machine on which the active DHCP server runs.
Note
The clearing of the Lease data does not delete the entire file, but only the data contained
therein. This action also increments the version number, so that available standby DHCP
servers can also perform the deletion.
2.5.4 Closeport
Description
Syntax: sc closeport ID

Principle of operation
This command closes a port in the firewall opened previously with the "sc openport" command.
This is only necessary when the port is to be closed manually before the time set with "sc
openport" expires. Otherwise the port is closed automatically when the port service life expires.
One parameter is the ID number of the firewall rule output by "sc openport".
2.5.5 Connect
Description
Syntax: sc connect [-ro] SERVER:/PATH [MOUNTPOINT]

sc connect [-ro] [-public] //[USERNAME[/DOMAIN]
[%PASSWORD]@]SERVER/SHARE [MOUNTPOINT]
Alternative names: mount
Authorization level: none
This action makes a remote file system on a server available on the control. This is enabled
by linking the remote file system to a local directory, known as the "MOUNTPOINT". The files
offered by the server are then visible under this directory.
NOTICE
Password protection
Note that when entering this command, the password appears on the screen in plain text
according to the specified syntax.
For path names, use the slash “/” and not the backslash “\”.

Supported file systems

Two types of remote file system are supported: Windows SMB and Unix NFS. These two
systems have completely different characteristics, particularly in terms of user administration:
● In Windows SMB, you connect to the server as a particular user that the server must
recognize. Via this connection, you then access the files as this user, independently of
which local user triggers the action.
This feature means that in SMB systems, you already have to enter a user name, if
necessary its domain, and a password when the connection is established.
● For NFS, the connection itself does not require a particular user to be entered. Instead, for
each file operation, the user who wants to carry out the operation must log on to the server.
The server then decides whether or not to permit this. Users are entered using a user ID
and group ID, not using names. The server must therefore recognize the corresponding
IDs (or permit access for all users).
Another type of remote file system that is supported are USB storage media exported from
TCUs (USB Flash Drive). Since these are integrated using NFS, the entries for server and
path are similar to those for NFS. However, the TCU names are administrated differently,
and the USB storage media have specific paths that do not physically exist.
Notation of the remote file system

For SMB and NFS/TCU, the file system is entered using different notations:
SMB: //[USERNAME[/DOMAIN][%PASSWORD]@]SERVER/SHARE
The fixed share is: //SERVER/SHARE
The server name can of course also be a numeric IP address. SHARE is the name of the
release on the server. Note that the character '$', which often occurs in this type of name, must
be preceded by a backslash ('\') in the command line. Otherwise, the system tries to expand
a variable.
A user name can also be entered in front of the server name, separated with a '@' character.
If necessary, the user name can also be extended by adding '/' followed by the Windows domain
to which it belongs. The password belonging to this user is normally queried interactively, so
that it is not visible on the screen.
For some applications, however, it may be necessary to write the password in the command
line. (For example, programs started from WinSCP cannot read from the keyboard.) In this
case, you can append an additional '%' character, followed by the password. If this contains
any special characters that are interpreted by the shell (<, >, &, ;, ", ', $, (, ), |), you should
shield these by preceding them with a backslash. Commas in SMB passwords cannot be
interpreted.
NFS: SERVER:/PATH
In NFS, entering the user is not required, which just leaves the two components SERVER and
PATH. As before, SERVER is the name of the file server. In contrast to SMB, PATH is a path
name that exists on the server, and not an arbitrarily assigned name.
The command "sc show drives SERVER" shows the file systems offered by a particular server
in the correct notation. For SMB, if required, the user name, etc. still need to be added.
After the entry of the remote file system, you can also specify the required directory
('MOUNTPOINT') in which the remote files will become visible locally. This should be an empty

directory to which you have write access. If MOUNTPOINT is omitted, 'sc' itself generates a
suitable directory. The name is /tmp/drvNN (numbered consecutively), and is displayed when
the connection is successful.
The "-ro" option connects the remote file system in read-only mode, this means that you can
only read and do not have write access. This can be useful if you want to exclude changes
that originate from the control, or if the server only allows read-only connections.
As explained above, an SMB file system is connected as the specified user. To prevent a third
user from executing file operations on the control in the name of the connected user, the local
directory can normally only be accessed by the latter (and all members of the same group).
However, if you do want to make the remote directory available to further local users, you can
use the "-public" option to make the MOUNTPOINT belong to the "operator" group, and this
access is therefore guaranteed.
2.5.6 Disable
Description
Syntax: sc disable hmi|nck|SUBSYSTEM ...

sc disable DHCPSvr -INTERFACE
sc disable DHCPSync [-X120]
sc disable IPAlias [-X120]
sc disable usb [-MINUTES] all | HOSTS
The "sc disable" command switches the specified subsystems off. These subsystems are then
not loaded again at the next cold restart. You can also switch several subsystems off with a
single "disable" command. "hmi", "nck" or any other subsystem names can be used for the
subsystems.
Note
The "sc disable" command acts on the parameters in the basesys.ini file located in the card/
user/system/etc/basesys.ini directory.
"sc disable IPAlias" deactivates the second alias IP address for the X120 network interface.
See also
"InternalIP_Alias" and "InternalNetMask_Alias" parameters in the "basesys.ini" file.

Special subsystems
The "DHCPSvr" name is a special case. This does not switch a normal subsystem on or off,
but specifies whether or not a DHCP server should be started on a network interface. The
interface is entered in the standard form.
The synchronization of the DHCP server is switched on and off with "DHCPSync". The
synchronization is only possible in the system network.
The "sc enable" and "sc disable" commands function by changing certain variables in the /user/
system/etc/basesys.ini file. The associated variable is "DisableSubsystems" or
"DisableDHCPD<INTERFACE>" for subsystems and DHCPSvr, respectively.
"sc disable usb" locks USB storage devices: Specifically, the devices of USB class "storage"
are involved, i.e. input devices can still be operated at the USB interface.
● Without a time specification [-MINUTES] , a permanent disable is set. When a time is
specified, the inhibit is specified in minutes.
● The inhibit can refer to all network participants of the system network or a list with host
names or IP addresses can be specified, for which the inhibit is valid.
2.5.7 Disconnect
Description
Syntax: sc disconnect MOUNTPOINT

sc disconnect all
Alternative names: umount, unmount
The "sc disconnect" command terminates the connection to a remote file system previously
connected using "sc connect". If the MOUNTPOINT was created automatically by 'sc', the
associated directory is also deleted again.
The "sc disconnect -all" variant can be used to remove all existing SMB and NFS file systems.
2.5.8 Distribute
Description
Syntax: sc distribute [parameter]

Alternative names: dist
This command distributes TCU data to other machines in the system network. Only the
"tcudata" parameter is relevant here.

distribute tcudata
Syntax: sc distribute tcudata

This command informs the active DHCP server that TCU data in /user/common/tcu has been
manually changed. The server can then distribute this data to the standby servers.
It is recommended that the version file in /user/common/tcu be changed manually as this is
only read-in once by the DHCP server at the start. An incrementing of the version would then
only take effect at a cold restart.
Note
This command can be performed on any machine in the system network, not only on the active
server. A message is always sent to the active server.
2.5.9 Enable
Description
Syntax: sc enable hmi|nck|SUBSYSTEM ...

sc enable DHCPSvr -INTERFACE
sc enable DHCPSync [-X120] [-PRIORITY]
sc enable IPAlias [-X120] IPADDR[/NETMASK]
sc enable usb [-MINUTES] all | HOSTS
The "sc enable" command switches on the specified subsystems such that these are also
activated when a subsystem is started. You can also switch several subsystems on with a
single "enable" command. "hmi", "nck" or any other subsystem names can be used for the
subsystems.
Note
The "sc enable" command acts on the parameters in the basesys.ini file located in the card/
user/system/etc/basesys.ini directory.
"sc enable IPAlias" defines a second alias IP address for a network interface. This is only
supported for X120. The IP address itself has the usual notation with four numbers separated
by decimal points. If not specified, the subnet mask can be determined from the class (A/B/C)
of the IP or determined explicitly. The CIDR notation (number of bits of the network section)
is also possible.

See also
"InternalIP_Alias" and "InternalNetMask_Alias" parameters in the "basesys.ini" file.
Special subsystems
The "DHCPSvr" name is a special case. This does not switch a normal subsystem on or off,
but specifies whether or not a DHCP server should be started on a network interface. The
interface is entered in the standard form.
The "sc enable" and "sc disable" commands function by changing certain variables in the /user/
system/etc/basesys.ini file. The associated variable is "DisableSubsystems" or
"DisableDHCPD<INTERFACE>" for subsystems and DHCPSvr, respectively.
With "sc enable usb" USB storage devices on permanently disabled USB interfaces or on
certain host names or IP addresses are enabled again.
DHCP synchronization
The synchronization of the DHCP server is switched on and off with "DHCPSync". The
synchronization is only possible in the system network (X120). A priority can also be specified:
-LOW, -HIGH or -MASTER.
The priorities have the following effect for the synchronization of the DHCP server:
● MASTER: The computer node becomes an active DHCP server. If several servers have
been configured in the system network, this computer has the highest priority.
● HIGH: The computer node belongs to the server candidates with high priority, i.e. if no
server with "MASTER" priority becomes active, then a computer with "HIGH" priority can
be the active server.
● LOW: The computer node belongs to the server candidates with low priority, i.e. if no server
with "MASTER" priority or "HIGH" priority becomes active, then a computer with "LOW"
priority can be the active server.
Note
Recommended settings are:
● DHCP operation and DHCP synchronization are switched on in the system network.
● Exactly one NCU is set as DHCP server.
● A maximum of two computers are candidates with "HIGH" priority.
● All other components are set as DHCP clients or candidates with "LOW" priority.
See also
"SyncModeDHCPD_SysNet" parameter in the "basesys.ini" file.

2.5.10 Openport
Description
Syntax: sc openport [-MINUTES] PROTO/PORT SOURCE ...

This command opens a port in the firewall to the company network (X130) for a certain time.
The default time is 15 minutes, but this can be changed with the -MINUTES option. The
maximum possible time is 60 minutes.
The port to be opened is specified in the form "PROTO/PORTNR". The protocol can be either
"tcp" or "udp". This is followed by the specification of the hosts from which the port should be
accessible. Several forms are possible here:
● A single IP address: "128.128.12.12"
● A host name (if this can be resolved via DNS), e.g. "server"
● An IP area with net mask specification, e.g. "128.128.12.0/255.255.255.0"
● An IP area with specification of the valid bits, e.g. "128.128.12.0/24"
If the specification of the source host is completely missing, this is normally acknowledged with
an error message. However, an exception is when the "sc openport" command is entered in
a shell opened via SSH. The permitted host is taken from the $SSH_CLIENT environment
variable that contains the IP of the SSH client.
If the opening was successful, an ID number is output in a status message:
sc: Port tcp/25 is open, rule ID is 6620
This ID can be used with "sc closeport" to manually close the port earlier.
NOTICE
Security risk
See also
"FirewallOpenPorts" parameter in the "basesys.ini" file.

2.5.11 Port status
Description
Syntax: sc portstatus [-x127] PORTSPEC SOURCE

The "sc portstatus" command queries whether a specific port in the firewall is open. The "-
x127" option must be specified if X127 rather than the X130 firewall is concerned. The port
specification is identical to "sc openport", e.g. "tcp/102". However, no names are permitted
here and the specified source IP must be unique.
The following status is output:
● "Port not open" with exit status 1.
● "Port is open (rule ID is <N>)." and exit status 0.
Whereby, the ID required for "sc closeport" must also be specified.
2.5.12 Restart
Description
Syntax: sc restart all|system|network| [!]SUBSYSTEM

Alternative names: reboot
The "sc restart" action initially stops the specified subsystems and then restarts them with the
following restriction: Dependent subsystems are also started for a restart.
Syntax
'hmi', 'nck' or any other subsystem names can be used as subsystems. Multiple subsystems
can also be specified successively; they (including all required dependencies) are then started
and stopped in this order. It is also possible to start and stop all subsystems, other than the
named ones. To do this, prefix an exclamation mark "!" to the list.
"all", "system" and "network" are special values for the subsystem:
● "all" stops and starts all available subsystems.
● In contrast, "sc restart system" initiates a cold restart of the system (reboot).
● "network" may be specified only together with "restart". "sc restart network" reinitializes the
network, e.g. after settings have been changed in basesys.ini.

Examples
# Stop all subsystems:
$ sc stop all
# Stop only HMI:
$ sc stop hmi
# Start HMI and NCK:
$ sc start hmi nck
# Start all subsystems other than NCK:
$ sc start ! nck
2.5.13 Restore
Description
Syntax: sc restore [-full|-addon|-addon+|-oem|-oem+|-user]

[-force] [-nodelete] [-update] [-restart] FILENAME
A backup created with "sc save" can be restored to the control with "sc restore".
As for "sc save", a restore is possible only from the service system or when the subsystems
are stopped. If "sc restore" reports an error, for example that the restore will cause running
subsystems to crash, you can use the "sc save" option to force the operation, as for "-force".
Normally, "sc restore" deletes the complete target area before the backup is restored (complete
CompactFlash Card for full backup, /user in user data backups). This means that no files are
subsequently available that were not included in the backup.
Archive and backup files larger than 4 GB

If a backup consisting of several archive files is to be restored with "sc restore", only the first
file of the backup must be specified in the FILENAME parameter. Once the end of the file has
been reached, other parts will be searched automatically.
Decisive when determining the continuation files is the format of the file name that was
transferred during calling, i.e. when calling "sc restore /tmp/backup.01of02.tgz", and after
reaching the end of "/tmp/backup.01of02.tgz", a search is next made for the "/tmp/backup.
02of02.tgz" file. When calling "sc restore /tmp/backup.1of2.tgz", the "/tmp/backup.2of2.tgz file
is expected correspondingly as a second part of the backup.

Options
If no further options are specified, the archive should represent a full backup and this should
be restored in full. The status of all files is therefore the same after the "restore" as it was at
the time of the backup.
● The -full option additionally forces the partition and the file system to be recreated on the
CompactFlash Card. This is, however, possible only from a service system. -full is
necessary if the partition table and/or file system is missing or damaged.
● However, if you want to restore the backup files without losing any files that have been
created in the meantime, you can use the "-nodelete" option to prevent them from being
deleted. "-nodelete" is not executed together with "-full", because all data is always deleted
when the file system is recreated.
● The -addon, -oem, -user, -addon+ and -oem+ options also allow only parts of an archive
to be unpacked.
● The -update option is used to load software updates supplied by Siemens. The -update
option can also be useful with -restart. If user-defined system files are changed when
loading the archive to the control, a cold restart or reinitialization is necessary. In such
cases, "sc restore" outputs an appropriate message at the end of the operation. The -restart
option causes the required action to be performed automatically.
2.5.14 Save
Description
Syntax: sc save [-full|-addon|-addon+|-oem|-oem+|-user]

[-force] [-update] FILENAME
Alternative names: backup
Calling "sc help" without any additional action outputs a list of all possible actions with a brief
description. If you enter an additional action, you receive a more detailed description for this
action.
The "save" or "backup" action creates a backup of the CompactFlash Card in FILENAME. If
the action is used from a service system, the backup receives the files of the associated control,
not of the service system itself.
Archive and backup files larger than 4 GB

If the backup is written to an FAT32 target file system, which does not permit any file size
greater than 4 GB, the backup is divided into several files, each of which is smaller than this
threshold value.
In the target file name that is specified when "sc save" is called, in this case, details of which
part of a backup is involved and the total number of associated files are provided: Calling "sc
save /tmp/backup.tgz" thus generates, for example, the "/tmp/backup.01of02.tgz" and "/tmp/
backup.02of02.tgz" files.

Options
The following options are used for selecting which directories of the file system are to be written
to the archive:
-full: complete backup (default): all files of the control, incl. Boot Loader
-addon: only /addon directory
-oem: only /oem directory
-user: only /user directory (user data)
-addon+: /addon, /oem and /user
-oem+: /oem and /user
If "sc save" is used directly on the control, and the subsystems are running, this could lead to
inconsistencies between saved files because they could still change during the backup
process. Therefore, in this case "sc save" normally ends in an error message to inform that
subsystems are still running.
● If you want to create a backup anyway, you can use the -force option. Although "sc save"
still issues a warning, the process continues. If "sc save" is started from the service system,
assuredly no subsystems of the control are running and "-force" is not necessary.
● The -update option writes an Img-D control file to the archive. This makes it possible to use
the archive later via "sc restore -update".
Example:
sc save -user /tmp/drv01/backup.tgz
2.5.15 Show
Description
Syntax: sc show ip [-INTERFACE]

Alternative names: ----
In the "sc show" command, various displays that show the system status are grouped together.
show ip
Syntax: sc show ip [-INTERFACE]

This command displays the IP address data of network interfaces. You have the option to enter
a specific interface. If no particular interface is specified, the data for all existing interfaces is
displayed, as well as the Default Gateway.
Example:
sc show ip
X120 (system network, eth0):

configured: (default)
current : IP=192.168.214.1 Netmask=255.255.255.0
MAC=08:00:06:73:55:fd
DNS Name : ncu1.local
Nameserver: 127.0.0.1
DNS Suffix: local
DHCP : synced server, prio=high, active
Statistics: RX=0.0MB (0.00% errors), TX=0.2MB (0.00% errors)
X130 (company network, eth1):
configured: DHCP
MAC=08:00:06:73:55:fe
DNS Name : name.test.siemens.de
Nameserver: 111.222.333.12 111.222.333.13 111.222.333.14
DNS Suffix: test.siemens.de
DHCP : client (server: 111.222.333.221)
X127 (engineering network, ibn0):
MAC=08:00:06:73:55:ff
DNS Name : ncu-ibn
DHCP : server
Default gateway: 111.222.333.1 (via eth1)
Used nameserver: 127.0.0.1
Used DNS suffix: test.siemens.de local
The following data is displayed for each interface:

● Name: The name of the connection socket (X1_ _) together with the name used by the
operating system in brackets (ethN or ibnN).
● "configured": The IP address configured in the basesys.ini (variables ExternalIP/
ExternalNetMask for the X130, InternalIP/Internal-NetMask for the X120), or "(default)" if
nothing is configured in the basesys.ini, or "DHCP" if the address was sourced via DHCP.
● "current": The currently set IP address together with the network screen form and MAC
address of the interface.
● "DNS name": The result of a DNS reverse lookup for the current IP address.
● "Name server": The DNS servers associated with this interface (e.g. receive DHCP via this
interface) is output in this list.
● "DNS suffix": The DNS search suffix associated with this interface.
● "DHCP": A flag that indicates whether a DHCP client or server is running for this interface.
In the case of a client, the server where the IP address comes from is also displayed. A
DHCP server on X120 can additionally be synchronized in the system network. Then the
information is displayed whether the server is the active server or is in standby mode.
● "Statistics": The total data volume received or sent via this interface, and the percentage
of faulty packets.

When all interfaces are displayed, the default gateway is also output, i.e. the address of a
router to which all packets are sent that cannot reach their destination directly via a local
interface.
The default gateway is therefore a piece of data that applies to all interfaces and of which there
is only one instance. However, there is one interface via which it must be possible to address
the default gateway. This is displayed in brackets after the address.
show drives
Syntax: sc show drives SERVER

"sc show drives" shows the remote file systems available for a particular server. The server
name SERVER can be an NFS server or a "TCU" that represents any USB media connected
to a TCU. For details of possible server names and how to enter a user name (often required
for SMB), see the description of the "sc connect" command.
Examples
Notation:
sc show drives someuser/somedomain@somepc # Windows-Server
Password: *******
//somepc/C$
//somepc/D$
//somepc/images
sc show drives someserver # NFS-Server
someserver:/export/home1
someserver:/export/home2
sc show drives TCU # TCU USB-Medien
TCU1:/dev0-0
TCU2:/dev0-0
All the available remote file systems of the relevant server are listed in the notation that is also
expected by "sc connect".
● In NFS file systems, the server name is always first, followed by a colon and then the export
path.
● A USB storage medium on a TCU is a special form of NFS, and therefore also has the
same notation as an NFS file system. The specified path exists - but not physically - on the
TCU, but is converted there to USB by the NFS server.

show net
Syntax: sc show net [-xml] [-hw|-tco|-sw|-swfull|-loc|-panel|

-dhcp|-switch|-all] [HOSTS...]
The "sc show net" command displays the devices in the system network and shows additional
information about these devices.
Because both these functions rely on SNMP (Simple Network Management Protocol), only
SNMP-capable devices will be found. SNMP as of version 2.6 is available for Linux-based
devices, for all other devices (e.g. MCP) this depends on the associated software version. If
a simple call is made without any additional options, a list of the devices found will appear
showing the relevant IP address, DNS name (if known), and a short description (module name).
Options
The various switches, which can also be combined, allow additional information to be output
on the devices found:
● Unless additional options are involved, the output format for "sc show net" is designed to
be displayed on the screen. The alternative XML format is preferable, however, if further
machine-based processing is required. This can be selected via the -xml option (this option
must be the first one!).
● If the command line contains nothing after the switches, "sc show net" will search the
complete system network via broadcast for devices able to use SNMP. This search takes
time, however, and in the case of larger systems, the volume of information output can be
considerable. In view of this, a list of IP addresses or (DNS) names can be specified to
ensure a better overview. This will limit the search process and only the named devices will
be included.
-hw Information on hardware, such as the MLFB, serial number, hardware ID,
hardware version, SRM version, manufacturer, and the serial number of the
CompactFlash Card. Some devices have two of these hardware blocks (the
second one being intended for an integrated device).
The PLC in the NCU and the TACO in the OP on an TCU are two such ex‐
amples.
-tco Operating state data: Switching counter, operating hours counter, quantity of
data written to the CompactFlash Card, number of times maximum tempera‐
ture exceeded.
-loc Location data: Location, function, and contact details for the device (if config‐
ured there).
-sw Displays brief details of the software installed, only the version of the overall
status (or of the basic system if only this is installed).
-swfull Displays all the installed software components. They are represented hier‐
archically in the form of a tree. The following is provided for each component:
Information about the version, internal version (if different), target version (if
different), version details, and the installation path.
-panel: Displays panel-specific data: Size and color depth of the display, MCP/TCU/
DCK/EKS index, and the VNC server currently represented

-dhcp Data about a synchronizing DHCP server: Operating state (off/standby/ac‐

tive), priority, versions of the lease file and TCU data, and the range for dy‐
namically assigned IP addresses
-switch Displays the settings of rotary switches on the device, e.g. the NC and PLC
switches of an NCU or the DIPFIX of an HT 8.
-all Equivalent to all the above switches.
Note
The data and information read out here are automatically written to the EUNA file (End User
Notification Administration), and saved on the associated device.
2.5.16 Start, Stop
Description
Syntax: sc start all|system|SUBSYSTEM...

sc stop all|system|SUBSYSTEM...
These two actions start or stop individual or all subsystems. Since these actions have a direct
influence on the runtime behavior, they are available only directly on the control, but not in the
service system (exception: "sc stop system"). The subsystems of the associated control do
not run here, and can therefore not be controlled.
Note
Only "all" and "system" function, but not arbitrary subsystems. Both of these actions have been
implemented only to a limited extent.
Subsystem names
"hmi", "nck" or any other names can be used for the subsystems. Multiple subsystems can
also be specified successively; they are then started and stopped in this order.
"all" and "system" are special values for the subsystem:
● "all" starts or stops all available subsystems.
● "sc stop system" also stops all subsystems and the basic system with the control.
● "sc start system" is identical to "sc start all" and exists mainly for reasons of symmetry.


3.1 Creating a service system
Overview
To backup user data or the complete CompactFlash Card, proceed as follows:
● Creating a service system.
● Backing up the license
● Backup: Data backup on USB storage medium or on a network drive.
● System diagnostics
– Output network settings
– Changing the network settings
– Starting the VNC Viewer
To restore the user data or the complete CompactFlash Card, proceed as follows:
● Restore/Recover: Restore the data from USB storage medium or from network drive.
● Carry out software update.
● Carry out firmware update.
3.1.1 How do you create a service system for the NCU?
Purpose
In case service is needed, create a portable "Emergency Boot System" (EBS) on a USB
memory. Thus you can start the booting of the NCU from the service system in order to carry
out various service tasks, such as data backup or updates, in a service shell.
Two partitions are created on the service system:
● A Linux partition that is not displayed under Windows.
● An FAT partition, to backup files or save software updates.
The FAT partition can be read and written to under Linux as well as from a Windows system.
The FAT partition can be addressed under the path/data in a command shell under Linux.

Scope of delivery
To create a service system on a USB storage medium, the following files are included on CD:
● an executable file installdisk.exe
● an image file for USB-FlashDrive
● a file with the latest information siemensd.txt / siemense.txt
Recommendation:
It is better to use SIMATIC PC USB-FlashDrive.
Note
To create the service system, you need administrator rights.
All data already on the USB storage medium will be deleted.
The transfer is optimized for USB 2.0; therefore, the transmission to the USB storage medium
takes longer when using USB 1.1 than USB 2.0
Proceed as follows
To create a service system on a USB storage medium:
1. Copy the service system onto a local hard disk of your PG/PC.
2. Connect the USB storage medium to the USB interface of the PG/PC.
3. Determine in Windows Explorer which drive letter the USB storage medium was assigned,
e.g. H:
4. Open a DOS shell and change to the directory in which the files for the service system are
stored.
5. In the DOS shell, enter the following command:
installdisk ––verbose ––blocksize 1m linuxbase.img h:
Result: The image is transferred to the USB storage medium.

3.1.2 This is how you operate the service system
Connecting the service system

Procedure:
1. Connect the USB storage medium to the USB interface X125 or X135 of the NCU.
2. Switch-off the system and then switch on again.
OR
3. Press the "Reset" button.
The service system is unzipped from the USB storage medium when the NCU boots for
the first time: Only then can the USB storage medium be used as service system and the
complete storage capacity is available.
Operating the service system

Keys and softkeys to navigate in the service system:
Softkey Key on the OP External key‐ Description

board
HSK1 <F1> Moves the cursor down a row
HSK2 <F2> Moves the cursor up a row
Page HSK3 <F3> Moves the cursor down a page
Page HSK4 <F4> Moves the cursor up a page
Char HSK5 <F5> Inserts text or digits
Char HSK6 <F6> Inserts text or digits
Cancel VSK7 <Shift> + <F7> Cancel / Return
Ok VSK8 <Shift> + <F8> OK / Confirm
--- Pos1 Moves the cursor to the top row
--- End Moves the cursor to the bottom row
Note
Operation with touch panels
The service system does not support any touch operation.
● SINUMERIK OP 019: An external keyboard is required for text input (connection via USB).
● SIMATIC Thin Client: You activate the integrated keyboard here.

3.1.3 Diagnostics functions
Functions of the service menu

The following functions for service and diagnostics are available on the service system:
Figure 3-1 Service menu
Overview of the main menu:
Main menu Description Reference to chapter/manual

Firmware Update Update BIOS: This is how you update the firmware
● PLC BIOS (Page 78)
● FPGA
● CBE30 Bootloader
VNC Viewer Start a VNC Viewer Calling the VNC Viewer (Page 87)
Diagnosis Starting a diagnostic function to display net‐ Performing system diagnostics
work-connection data and data on the sys‐ (Page 82)
tem CompactFlash Card.
Backup NCU Software and Data Backup system and user data on the USB Backup data via the service menu
FlashDrive or network drive. (Page 66)
Update NCU Software and Data Upgrade the system from the USB Flash‐ This is how you update the software
Drive or network drive. (Page 80)

Main menu Description Reference to chapter/manual

Restore NCU Software and Data Restore system and user data from the USB Backup data via the service menu
storage medium or network drive. (Page 66)
Modify NCU Settings ● Change network settings This is how you change the system set‐
tings (Page 84)
● Activate/deactivate HMI
● Restore delivery condition of the
following components:
– HMI
– NCK
– PLC
– Drive
Service Shell A Service Shell is opened in order to input Backing up data via the service shell
service commands. (Page 74)
Service Commands (Page 35)
3.1.4 This is how you connect to a network drive
Connecting network drives

1. Select "Connect to network drive".
2. Enter the complete path name of the network drive.

3. Register yourself with a user name with access authorization to this drive.
Note the syntax of the examples specified:
Figure 3-2 Connecting network drives
4. Confirm with "Ok". You are then prompted to enter a password.

3.2 Backup license
3.2 Backup license
Validity of the license key

The license key corresponds to the serial number of the CompactFlash Card. If the
CompactFlash Card is replaced for a SINUMERIK 840D sl, the license key loses its validity
and the system is no longer ready for operation.
This situation can occur for a defective hardware of the system CompactFlash Card.
Application
For the following cases, backup the license key of the CompactFlash Card on a USB storage
medium or on a network drive:
● Software update without license key
● System software error without defective hardware
Note
Replacement CompactFlash Card
The following data are required in order to obtain a valid license key after replacing the system
CompactFlash Card: The serial number of the defective and the new CompactFlash Card.

3.2 Backup license
3.2.1 This is how you backup the license key
Backing up the license key on a USB storage medium

Procedure:
1. In the main menu, select the menu item "Backup NCU Software and Data".
The following menu is displayed:
Figure 3-3 Backing up licenses
2. Select the menu item "Backup license key to USB memory stick".

3.2 Backup license
Figure 3-4 Save license key
The license key is backed up in the specified directory together with the serial number of the
CompactFlash Card.
See also
The procedure is essentially the same as for "Backup license key to network drive". In addition,
you connect to a network drive:
This is how you connect to a network drive (Page 61)

3.3 Backup data via the service menu
3.3.1 This is how you backup user data
Backing up and restoring user data

Procedure:
2. Select "Backup user data to USB memory stick" and confirm with "Ok".

3. Enter a complete file name - as shown in the example:
Figure 3-5 Entering a file name
4. Confirm with "Ok". The following message is output after the operation has been
successfully completed:

Figure 3-6 Operation completed
Note
Backup file ≥ 4GB
For a backup file ≥ 4GB, the space on the FAT partition of the service system (with 8GB)
is no longer sufficient. For this reason, backup files of this size are partitioned (see also: sc
save/sc restore) or they can be saved on a network drive.
See also
The procedure for "Backup user data to network drive" is analog. In addition, you connect to
a network drive:

3.3.2 This is how you restore user data
Restoring user data

Procedure:
1. In the main menu, select the menu item "Restore NCU Software and Data".
Figure 3-7 Restoring user data
2. Select "Restore user data from USB memory stick" and confirm with "Ok".
The list of the tgz files available on the USB storage medium are displayed.
3. Select the appropriate tgz file and confirm with "Ok".
A message is output after the operation has been successfully completed.
See also
The procedure for "Restore user data from network drive" is essentially the same. In addition,
you connect to a network drive:

3.3.3 This is how you create a complete backup of the CompactFlash Card
Creating a complete backup

Procedure:
Figure 3-8 Backup up
2. Select "Backup complete CF card to USB memory stick" and confirm with "OK".

3. Enter a complete file name - as specified in the example.

4. Confirm with "OK". This can take several minutes.
The operation is displayed:
Figure 3-9 Backing up ...
See also
The procedure for "Backup complete CF card to network drive" is essentially the same. In
addition, you connect to a network drive:

3.3.4 This is how you install a complete system backup
Installing the complete backup

With this menu item, a complete backup of the data from the service system or from a network
drive is installed on the CompactFlash Card, i.e. this backup includes both the system software
as well as also the user data.
NOTICE
Formatting
This procedure corresponds to formatting the CompactFlash Card and all of the existing data
are overwritten.

Installing the complete backup

Procedure:
1. In the main menu, select the menu item "Restore NCU Software and Data".
Figure 3-10 Restore system
2. Select the menu item "Recover system from USB memory stick (reformat CF card)" and
confirm with "Ok".
Completion
The system must be restarted in order that the new data become effective.
See also
The procedure for "Recover system from network drive (reformat CF card)" is essentially the
same. In addition, you connect to a network drive:

3.4 Backing up data via the service shell
Backing up and restoring using a service shell

To call a service shell, depending on the configuration, the following possibilities are available:
(I) Configuration of NCU with TCU: the service shell is called under Linux.
(II) Configuring the NCU with PCU 50 or programming device (PG).
A service shell can be called under:
● on the NCU under Linux
● on the PCU/PG using the VNC Viewer (system network or company network)
● on the PCU/PG using WinSCP (system network or company network)
3.4.1 This is how you save data on a service system
Proceed as follows
To back up the complete system:
1. Connect the service system to a USB interface (X125 or X135) of the NCU and press the
reset button.
Alternatively, you can switch the NCU off, connect the service system, and switch the NCU
on again.
Result: The NCU boots from the service system.
2. In the main menu, select the menu item "Service Shell".
3. Log on as a service technician using the user name "manufact" and password "SUNRISE".
4. Using the command "sc backup" you can create the backup file "backup01.tgz".
The directory /data on the service system is provided for backup files. The complete path
should be specified.
5. Choose –full, to backup all data on the CompactFlash Card, or –user, if you only want to
backup user data.
Example: sc backup –full /data/backup01.tgz
Result:
A backup file of the complete CompactFlash Card is created under /data on the service
system on the USB storage medium.

3.4.2 This is how you restore data from the service system
Proceed as follows
To restore the complete system:
1. Connect the service system to a USB interface (X125 or X135) of the NCU and press the
reset button.
Alternatively, you can switch the NCU off, connect the service system, and switch the NCU
on again.
Result: The NCU boots from the service system and the main menu is displayed.
4. With the command "sc restore" you can write the backup file "backup01" from the service
system back to the CompactFlash Card in the NCU. The complete path should be specified.
Example: sc restore /data/backup01.tgz
Result:
The system state stored in the file "backup01" is restored on the NCU.
Note
If access to the system data on the CompactFlash Card is not possible because the
CompactFlash Card is defective or empty, you can only log in as user "admin" with the
password "SUNRISE" and no longer as the user "manufact".
3.4.3 This is how you save data on a network drive
Sequence
Proceed as follows:
● Connect the service system.
● "Service Shell" open.
● Establish a connection to a network drive.
● Create a backup file.
Scenario I: Start Command Shell under Linux

Procedure:
1. Connect the service system to the USB interface X125 or X135 of the NCU.

4. Use the command "sc connect" to connect the network drive:

sc connect //username%password@server/share /tmp/backup
Please enter here the user name and the password for the network drive that is to be
connected to.
5. Using the command "sc save", create the backup file "backup01".
Choose –full, to backup all data on the CompactFlash Card, or –user, if you only want to
backup user data in the directory /user.
Example: sc save –full /tmp/backup/backup01
Result:
A backup file of the complete CompactFlash Card is created under the specified path on
the network drive.
Scenario II: Start the command shell with WinSCP on the programming device:
Procedure:
1. Start WinSCP and enter the following data in the log-on window:
– IP address of the NCU (or, if required, host name)
– User name "manufact" with password "SUNRISE".
2. Select in the menu "Commands" → "Open Terminal".
3. Execute the data backup using the commands described in steps 4 to 6 from scenario I.
Scenario II: Start the command shell using the VNC Viewer on the programming device
Procedure:
1. Start the VNC Viewer and connect to the NCU using the IP address (or where relevant,
using the host name)
2. Log on under the "manufact" user name with the password "SUNRISE".
3. To restore the data, enter the corresponding commands as described under steps 3 to 5
in scenario I.
3.4.4 This is how you restore data from the network drive
Sequence
Proceed as follows:
● Connect the service system.
● "Service Shell" open.
● Establish a connection to a network drive.
● Restore the data.

Scenario I: Start command shell under Linux

1. Connect the service system to the USB interface X125 or X135 of the NCU.
4. Use the command "sc connect" to connect the network drive:
sc connect //username%password@server/share /tmp/backup
5. Please enter here the user name and the password for the network drive that is to be
connected to.
To completely restore the system (system data and user data), enter the following: sc
restore –full backup01
Result: The whole system is overwritten by the backup data.
6. To restore user data only, enter the following command:
sc restore –user backup01
Result: The user data are written back again.
All subsystems are then restarted: sc start all
Result:
The system state stored in the file "backup01.tgz" is restored on the NCU.
Scenario II: Start the command shell with WinSCP on the programming device:
Procedure:
1. Start WinSCP and enter the following data in the log-on window:
– IP address of the NCU (or, if required, host name)
– User name "manufact" with password "SUNRISE".
2. Select in the menu "Commands" → "Open Terminal".
in scenario I.
Scenario II: Start the command shell using the VNC Viewer on the programming device
Procedure:
1. Start the VNC Viewer and connect to the NCU using the IP address (or where relevant,
using the host name)
2. Log on under the "manufact" user name with the password "SUNRISE".
in scenario I.

3.5 Updating the software
3.5.1 This is how you update the firmware
Firmware Update
When service is required, it may be necessary for a service technician to install a BIOS update.
Siemens provides the corresponding update file. Possible formats include: *.img or *.rom or
*.bin. Or, the update file is already supplied on the service system, then step 1 is eliminated.
Procedure:
1. Copy the update file to the FAT partition of the service system.
2. Connect the service system to interface X125 or X135 of the NCU.
3. Switch on the system.
4. In the main menu, select the menu item "Firmware Update".
Figure 3-11 Firmware update

5. Select "BIOS Update" and follow the next instructions.

The BIOS version installed on the NCU and the update files available in the service system
are output:
Figure 3-12 Select the updates
6. Select the update file and confirm with "OK".

A "Restart" is then required.
Note
Fall back strategy
Before the BIOS update is installed, a backup of the installed BIOS version is saved on the
service system.
For safety reasons, only files can be selected that are suitable and are appropriate for this
NCU.
Update other components

The following rules must be observed for the additional updates:
● The procedure to update the PLC-BIOS Update is essentially the same as the procedure
for BIOS Update.
● FPGA Update: for NCU7x0.3
● CBE30 Bootloader Update: for CBE30 and CBE30-2 (option module)

3.5.2 This is how you update the software
Update / Recover
The following options are available:
● Update the software from the service system or from the network drive.
● Completely restore the CompactFlash Card with the system software from the service
system or from the network drive (Recover system ...).
Updating the software

Procedure:
1. In the main menu, select the menu item "Update NCU Software and Data".
Figure 3-13 Software update
2. Select the menu item "Update system software from USB memory stick".

3. In order to check which software version contains the tgz file, first select the tgz file, then
press "Show version".
The following information is output:
Figure 3-14 Version information

A message is output after the update has been successfully completed.
Completion
The system must be restarted in order that the new data become effective.
See also
The procedure for "Update system software from network drive" is essentially the same. In
addition, you connect to a network drive: This is how you connect to a network drive
(Page 61)
For a complete backup of the system: This is how you install a complete system backup
(Page 72)

3.6 System diagnostics
3.6.1 Performing system diagnostics
Overview of diagnostic functions

The following diagnostic functions to display network settings are included in this menu:
Figure 3-15 Diagnostics functions
System diagnosis Description

Show all network settings Connection data of all Ethernet interfaces is displayed.
Show network settings X120 The connection data of interface X120 is displayed.
(system network)
(engineering network)
(factory network)

System diagnosis Description

Show card identification The following data of the system CompactFlash Card is output:
● Serial number
● System software version
● Hardware version (NCU)
Check card integrity Checking the CompactFlash Card system
Example: Connection data of all Ethernet interfaces of the NCU:
Figure 3-16 NCU: Interfaces
See also
This is how you check the CompactFlash Card (Page 85)

3.6.2 This is how you change the system settings
Modify NCU Settings

You can change the following system settings in this menu:
Figure 3-17 Changing system settings
Menu item Description

Change network settings Changing network settings of the NCU.
Disable internal HMI (currently enabled) Activating/deactivating an HMI task
Reset HMI data to factory defaults Restoring the delivery condition of HMI data.
Reset NC data to factory defaults Restoring the delivery condition of NC data.
Reset PLC data to factory defaults Restoring the delivery condition of PLC data.
Reset DRIVE data to factory defaults Restoring the delivery condition of drive data.
NOTICE
Reset ... data to factory defaults
The selected data are reset to the state when delivered, therefore overwriting all of the
previous specific commissioning settings that have been made.

3.6.3 This is how you check the CompactFlash Card
Displaying identification data

Procedure:
1. In the main menu, select the menu item "Diagnosis".
Figure 3-18 System diagnostics
2. Select the menu item "Show card identification".

The following data for identification are output:

Figure 3-19 Identification
3. Select the menu item "Check card integritiy".

The CompactFlash Card is checked for errors:

Figure 3-20 Check
Note
This procedure can take several minutes.
3.6.4 Calling the VNC Viewer
Application
The VNC Viewer is used to connect directly with a VNC Server and, for example, to operate
an HMI application.
Furthermore, it enables you to call up a list of all the network devices, thereby obtaining an
overview of the system network.

Starting the VNC Viewer

Procedure:
1. Select the "VNC Viewer" menu item in the main menu.
Figure 3-21 VNC Viewer
2. To start the VNC Viewer, enter the following connection data:

– Server name, e.g. IP address or DNS.
– The password is optional and can also be left empty.
– The following assignment applies to the "Session number":
Number Meaning
Session 0 HMI-Applikation
Session 4 Command Shell
Session 5 System logfile
Session 6 System Network Center (SNC)

3.6.5 WinSCP and PuTTY
Use
The programs WinSCP and PuTTY are freely-available open source programs for Windows.
WinSCP is intended especially for transferring files from and to Linux systems, PuTTY for the
remote operation of a command shell.
● WinSCP can be downloaded via the following link: http://winscp.net/eng/download.php
(http://winscp.net/eng/download.php) (Installation Package).
WinSCP also offers a "command shell" that is limited so that commands can be issued, but
no callbacks can be answered.
● PuTTY, by contrast, offers a complete command shell.
PuTTY web page: http://www.chiark.greenend.org.uk/~sgtatham/putty (http://
www.chiark.greenend.org.uk/~sgtatham/putty)
With both programs, a service technician can log onto the NCU and carry out service tasks.
The username ‘manufact’ with the password ‘SUNRISE’ is available for the Siemens service
technician.
Starting WinSCP
WinSCP is started from Windows after the service technician has logged onto the NCU with
which he is connected using the corresponding authorization (e.g. as user "manufact" with
password "SUNRISE").
From the "Commands“ menu, select ”Open terminal” to open a command shell. There you can
carry out the service commands in the usual way.


Appendix A
A.1 Abbreviations
CF CompactFlash card: Memory card

CFS Cluster File System
DCK Direct Control Keys: Direct control keys
DCP Discovery and Basic Configuration Protocol
DHCP Dynamic Host Configuration Protocol: Dynamic assignment of an IP address and other configuration pa‐
rameters on a computer in a network
DNS Domain Name System: Conversion of domain names into IP addresses
EBS Emergency Boot System
EKS Electronic Key System: System to check the identity of a user (authentication system)
EUNA End User Notification Administration
HMI Human Machine Interface: Operator interface
IRT Isochronous Realtime (Ethernet)
LLDP Link Layer Discovery Protocol: multi-vendor Layer 2 Protocol defined in accordance with the IEEE-802.1AB
standard, allows information to be exchanged between devices.
MAC Media Access Control: The MAC address is a 48-bit Ethernet ID.
MPI Multi-Point Interface: Multiple interface
MUI Multilanguage User Interface
NAT Network Address Translation
NCK Numerical Control Kernel: NC kernel with block preparation, travel range, etc.
NRT Non-Realtime (Ethernet)
NTFS New Technology File System
NTP Network Time Protocol: Standard for synchronizing clocks in the entire network
NTPD NTP Daemon:
Utility that runs in the background and does not have to be started by the user.
PCU PC Unit: Computer unit
PDEV Physical device
PLC Programmable Logic Control: Programmable logic controller
RAM Random Access Memory: Program memory which can be read and written into
RDY Ready: The system is ready to operate.
RFC Remote Function Call
SNMP Simple Network Management Protocol (network protocol for monitoring and controlling network elements
such as routers, servers, switches, and printers from a central station).
SSD Solid State Drive
SSH Secure Shell: Protocol for an encrypted network connection with a remote device

Appendix
A.1 Abbreviations
TFTP Trivial File Transfer Protocol: Very simple data transmission protocol
UDP User Datagram Protocol: NTP is mostly processed via UDP.
USB Universal Serial Bus
UPS Uninterruptible power supply
UTC Universal Time, Coordinated: Coordinated Universal Time (previously: Greenwich Mean Time)

Index
SNMPAutLocation, 23
SNMPContact, 23
7 SNMPFunction, 23
SNMPLocation, 23
7-segment display, 9
SNMPStation, 23
SyncModeDHCPD_SysNet, 19
Time zone, 26
A Timeservers, 17
Applications, 57
C
B CFS (Compressed File System), 37
basesys.ini, 15 Coding switches, 7
CheckTCUforUpdatePackage, 28 Command
DHCPClientID, 18 Backup, 50
DHCPDNoMasterWait, 20 Check-cf, 40
DisableCompanyNet, 16 Closeport, 40
DisableIBNForwarding, 22 Connect, 41
DisableIBNNet, 22 Disable, 43
DisableNATRouting, 21 Disconnect, 44
DisableNTPTimeSync, 28 Enable, 45
DisablePLCTimeSync, 28 Help, 39
DisableSubsystems, 27 Openport, 47
DisableSysNet, 18 Port status, 48
Domain, 17 Reboot, 48
EnableCoreDumps, 28 Restart, 48
EnableDHCP_IBNNet, 21 Restore, 49
EnableDHCPD_SysNet, 19 Save, 50
EnableSysNetToIBNForwarding, 22 Show, 51
ExternalDcpEnabled, 24 Start, 55
ExternalIP, 16 Stop, 55
ExternalLldpEnabled, 24 CompactFlash Card
ExternalLldpTLVsTxEnabled, 25 Memory partitioning, 6
ExternalNetMask, 16 Partitions, 5
FirewallOpenPort, 27
Gateway, 16
Hostname, 17 D
InternalDcpEnabled, 24
data
InternalDNSDomain, 21
Restoring, 76
InternalDynRangeEnd, 20
DHCP synchronization, 46
InternalDynRangeStart, 20
InternalIP, 18
InternalIP_Alias, 19
InternalLldpEnabled, 24
E
InternalLldpTLVsTxEnabled, 25 Emergency Boot System, 57
InternalNetMask, 18 Ethernet interfaces, 13
InternalNetMask_Alias, 19
LogFileLimit, 27
Name servers, 16

Index
Service system
Backing up data, 74
I Creating for the NCU, 58
Restoring data, 75
Interfaces
Service Tool WinSCP, 89
Ethernet, 37
SMB (Server Message Block), 38
NCU, 13
Subnet mask, 14
IP address
Subsystem, 37
Display, 14
Designation, 37
Synchronization
DHCP, 46
L System
Load operating system, 9 Diagnostics, 9
Log file, 5, 28
System error, 10
N
NCK commissioning switch, 7
NCU booting, 8
T
Network drive, 61 Time zone, 26
Network interface, 13
NFS (Network File System), 38
U
Update
P BIOS, 78
PLC mode switch, 7 Firmware, 78
Privilege, 35 User group, 35
Users (default setting), 6
R
Remote File System, 38
V
Replacement part, 63 VNC (Virtual Network Computing), 13
Reset
Button, 8
Execute, 8 W
WinSCP, 89
S
Section
[DCP], 24
[ExternalInterface], 15
[IBNInterface], 21
[InternalInterface], 18
[LinuxBase], 25
[LLDP], 24
[SNMP], 22
Service command
Application, 35
Rights, 35
Syntax, 36
Service menu, 60

PCU-Basesoftware (IM8) ___________________
Commissioning the system 1
___________________
___________________
Install software and updates 3
SINUMERIK Backing up and restoring
___________________
data 4
SINUMERIK 840D sl
PCU-Basesoftware (IM8) ___________________
___________________
List of Abbreviations A
Valid for:
SINUMERIK PCU 50.5

with PCU base software V5XP1.4
SINUMERIK PCU 50.3

with PCU base software V8.6 SP3
02/2014
6FC5397-1DP40-4BA0
Legal information
DANGER
WARNING
CAUTION
NOTICE
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
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.
Note the following:
WARNING
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
Trademarks
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.

Industry Sector Ⓟ 01/2014 Technical data subject to change All rights reserved
Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents
1 Commissioning the system ..................................................................................................................... 5

1.1 Delivery condition of the system .................................................................................................... 5
1.1.1 Hard disk partitions ........................................................................................................................ 7
1.1.2 System features ............................................................................................................................. 9
1.2 User administration ......................................................................................................................11
1.2.1 Which users are set up? ..............................................................................................................11
1.2.2 User settings ................................................................................................................................13
1.2.3 This is how you create a new user...............................................................................................21
1.2.4 This is how you administer users .................................................................................................22
1.3 Boot up behavior of the PCU .......................................................................................................23
1.3.1 Dialogs when booting ...................................................................................................................23
1.3.2 Boot up of the PCU: no HMI program installed............................................................................26
1.3.3 Boot up of the PCU: HMI program already installed ....................................................................28
1.3.4 Setting the screen resolution .......................................................................................................30
1.4 BIOS settings for PCU 50.3 .........................................................................................................33
1.5 BIOS settings for PCU 50.5 .........................................................................................................38
2 Configuring the system ......................................................................................................................... 43
2.1 System settings ............................................................................................................................43
2.1.1 Configuring the communication via MPI ......................................................................................43
2.1.2 How to change the name of the PCU ..........................................................................................44
2.1.3 This is how you set the IP address of the PCU ...........................................................................45
2.1.4 How to add the PCU to a domain ................................................................................................47
2.1.5 How to connect an external monitor ............................................................................................48
2.1.6 This is how you switch off the USB interfaces. ............................................................................49
2.2 Configuring a customized operator interface ...............................................................................50
2.2.1 How to select the language for the Windows system ..................................................................50
2.2.2 Displaying the boot screen ...........................................................................................................53
2.2.3 Changing the background of the service desktop........................................................................54
2.3 Customized settings during boot up.............................................................................................55
2.3.1 Configuring key filters for an HMI program ..................................................................................55
2.3.2 Saving service des⁫ktop settings ...................................................................................................58
2.3.3 Starting programs during boot up ................................................................................................59
2.3.4 Starting OEM programs ...............................................................................................................60
2.3.5 Starting applications in service mode ..........................................................................................61
2.4 Configuring the SITOP UPS module for use with the PCU Base Software .................................62
2.4.1 SITOP modules for the PCU 50.5 ................................................................................................62
2.4.2 Configuring SITOP software for PCU Base Software ..................................................................64
2.4.3 Parameterizing a delay time for quitting the HMI software ..........................................................67
2.4.4 Hardware configuration of the SITOP UPS module.....................................................................69
2.5 Configuration of the Service Center .............................................................................................73
2.5.1 Overview ......................................................................................................................................73
PCU-Basesoftware (IM8)
Table of contents
2.5.2 Configuration of the network adapter .......................................................................................... 74

2.5.3 Configuration of the host ............................................................................................................. 76
3 Install software and updates .................................................................................................................. 77
3.1 Installing SINUMERIK products .................................................................................................. 77
3.2 Installation via service desktop ................................................................................................... 78
3.3 How to install and authorize SIMATIC STEP 7 ........................................................................... 82
3.4 How to install additional languages under Windows XP (DVD) .................................................. 84
4 Backing up and restoring data ............................................................................................................... 87
4.1 Overview ..................................................................................................................................... 87
4.2 Starting the Service Center ......................................................................................................... 87
4.3 Functions of the Service Center .................................................................................................. 88
4.4 Network settings in the Service Center ....................................................................................... 90
4.5 Create a disk image of the SSD .................................................................................................. 93
4.6 Restore a disk image of the SSD ................................................................................................ 95
4.7 Create a disk image of a partition ............................................................................................... 97
4.8 Restore a disk image of a partition ............................................................................................. 99
4.9 Network settings in the Service Center ..................................................................................... 102
4.10 Starting Symantec Ghost directly .............................................................................................. 104
4.11 Bootable USB flash drive .......................................................................................................... 105
4.12 Operating a service PC/PC in the network ............................................................................... 106
4.12.1 Overview ................................................................................................................................... 106
4.12.2 Connection options in the system network ............................................................................... 107
4.12.3 Configuring routing in the network ............................................................................................ 109
4.12.4 Configure the network settings of the PG/PC ........................................................................... 111
4.12.5 Release directory of the PC/PC in the network......................................................................... 114
4.12.6 Release drives C: and D: of the PCU 50.5 in the network for administrator accounts ............. 118
4.12.7 Creating a shortcut to the network drive ................................................................................... 119
4.13 Starting up the replacement SSD ............................................................................................. 120
5 Service and diagnostics .......................................................................................................................121
5.1 PCU Hardware Diagnostics ...................................................................................................... 121
5.2 Evaluation of the 7-segment display ......................................................................................... 122
5.3 Setting of the service switch (PCU 50.5 only) ........................................................................... 125
5.4 Enabling/disabling error log during boot up .............................................................................. 126
5.5 How to search for stations within the system network .............................................................. 127
A List of Abbreviations .............................................................................................................................135
A.1 Abbreviations ............................................................................................................................ 135
Index ...................................................................................................................................................137
Commissioning the system 1
Overview
The PCU has onboard interfaces for communicating via Ethernet, MPI and PROFIBUS DP.
The integrated free slots remain free for other tasks. The PCU is equipped with the
Windows XP ProEmbSys operating system and for data backup tasks with the Symantec
Ghost software.
Interfaces:
● Four USB ports (USB 2.0) offer points where a keyboard, mouse and other peripheral
devices can be connected.
● For CF cards, there is a covered slot.
● Two internal PCI slots are available for specific expansions.
For commissioning:
● Two 7-segment displays and two LEDs are integrated for diagnostic purposes. They
indicate the current operating status and display the BIOS error codes during startup.
● If the PCU is to be operated without an operator panel front, a monitor and an additional
keyboard will also be required:
– For diagnostics during startup of the PCU.
– When installing a replacement hard disk
(alternatively, the hard disk can also be installed externally).
References: Operator Components and Networking Manual
Commissioning the system
Supplied software on the PCU

The software installed on delivery of the PCU includes the components below, among
others:
MS Windows XP Professional SP3

Internet Explorer V 6.0
MPI driver (PCU 50.3 and PCU 50.5-C) V 6.04.01.00
Symantec Ghost (default setting) V 8.2 (incl. Ghost Explorer)
TCU Support V 8.6
(It is already installed and available on the hard disk
under D:\Updates, if it must be re-installed.)
Documentation for all Ghost tools is supplied on the PCU’s hard disk under E:\TOOLS
Note
For the system component versions contained in the PCU base software, see the
C:\BaseVers.txt file.
Note
Acknowledgements
• This product includes cryptographic software written by Eric Young ([email protected])
• This product includes software developed by the OpenSSL Project for use in the
OpenSSL Toolkit. (http://www.openssl.org/)
1.1.1 Hard disk partitions
Memory segmentation
The hard disk of the PCU 50.3 has 40 GB of storage capacity and is segmented into a
primary partition C and an expanded partition with the three logical drives D, E and F which
operate with NTFS file access.
Figure 1-1 Division of the hard disk
The PCU 50.5 is equipped with a solid state drive (SSD) with NTFS file access, which is also
segmented to provide a primary partition C and an expanded partition with the three logical
drives D, E and F. The SSD is available with 32 GB and 40 GB storage capacity.
Figure 1-2 Segmentation of the SSD with 32 GB
Partitioning of the SSD with 40 GB is identical to that for partitioning of the hard disk.
Depending on the order, the operating software can already be installed when the unit is
shipped. It is installed subsequently by the customer the first time the system starts up. For
reasons of data security, the operating software and the Windows XP system software are
distributed over the different hard disk partitions.
Content of the partitions

The individual partitions are intended for the following data or already contain this data:
EMERGENCY (C:) Reserved for service tasks under WinPE 2005.

TMP (D:) Used for storing Ghost images (e.g. of the delivery condition) and local
backup images.
Contains the installation directory where the software to be installed is
first copied to from a remote PG/PC prior to the actual installation
procedure.
SYSTEM (E:) Reserved for the Windows XP software.
The Windows XP software is available on the recovery media CD via
network, for example to install drivers or updates as and when needed
later on.
USER (F:) For installing user programs.
Applications such as HMI system software (incl. data storage and
temporary data), STEP 7, OEM applications for HMI or customer-
specific applications should only be installed here.
Note
Installing software
All of the applications must be exclusively installed on USER (F:) even if these applications
have a different drive set as the default drive in their installation path.
The partition names EMERGENCY, TMP, SYSTEM, USER must not be changed; otherwise
the "ServiceCenter" will no longer function.
See also
Installing SINUMERIK products (Page 77)
1.1.2 System features
Configuration of the operating system

For safety reasons, Windows XP has been preset as follows:
● The Autorun function is deactivated.
● Automatic Windows Update is deactivated.
● Monitoring and alerts for antivirus software and automatic update are deactivated.
● Links used to call up Internet Explorer from the service desktop and the start menu are
removed.
● Remote Procedure Call (RPC) is possible for calls that are not connected.
● The firewall settings are activated on the network card Eth 1 and deactivated on Eth 2.
Changes to Windows services

Other default settings:
Windows services: Start-up type:

Computer Browser Manual (Not started)
Error Reporting Service Disabled
Portable Media Serial Number Manual (Not started)
SSDP Discovery Service Disabled
Universal Plug and Play Host Disabled
Web Client Manual (Not started)
Wireless Zero Configuration Manual (Not started)
Name of the PCU

Upon delivery of the system, a unique computer name is generated which can be read out
under: "Start" → "Settings" → "Control Panel" → "System", "Computer Name" tab.
Pre-configuration of the PCU

The PCU has two Ethernet interfaces with default settings suitable to connect to
SINUMERIK solution line:
Eth 1 is preset as a default DHCP client for connection to a

company network.
Eth 2 is preset as a SINUMERIK DHCP server for connection to a
system network. Eth 2 is preset to the fixed IP address
192.168.214.241.
See also
This is how you set the IP address of the PCU (Page 45)
References: Operator Components and Networking Manual
1.2.1 Which users are set up?
Preset users
Each user is from one user type and belongs to one user group. The user types are
implemented under Windows in user groups with various user rights.
Upon delivery of the system, the following users are defined at the factory:
● The "operator"
In terms of type, the "operator" is classed as an HMI user and belongs to the operators'
user group (operator.group). These operators have limited user rights under Windows.
● The "user"
In terms of type, the "user" is classed as an HMI user and belongs to the operators' user
group (user.group). These operators have extended user rights under Windows.
● The "auduser".
The "auduser" is an HMI service user type of user and belongs to the system
administrators' user group. The system administrators have the user rights of a local
administrator under Windows.
User name Password User type Windows user User Rights User group
group
operator operator HMI (operator.group) operator.group Restricted Operator
user CUSTOMER HMI (user.group) user.group "Power User" Operator
auduser SUNRISE HMI+Service Administrators local System administrators
administrator
siemens ***** --- --- --- System administrators
The individual user types differ in the following areas:
User type Area of activity

HMI (operator.group) • Boot up of the PCU
• Operating the HMI program
• Windows Desktop
HMI (user.group) • Boot up of the PCU
• Windows desktop
HMI+Service • Boot up of the PCU
• Service Desktop
Service Desktop
The service desktop provides the HMI+Service user with a Windows desktop, which is
expanded to include tools and functions for service tasks, such as manage users, install
software, save/restore data, check system integrity, etc.
Windows desktop
The HMI user is able to use a Windows desktop which can be expanded to suit his or her
individual needs.
Starting ServiceCenter Users

Using this link on the service desktop, you can start ServiceCenter Users as an HMI+Service
user. In ServiceCenter Users, the boot behavior of the PCU as well as settings for the HMI
program and desktop are set globally for all users and individually for specific users.
The users are managed in the "ServiceCenter Users", so that the commissioner/service
technician no longer has to make corresponding settings directly in the registry.
1.2.2 User settings
"Global Settings"
In the ServiceCenter Users, as HMI service user, you set parameters under "Global
Settings" for the system behavior:
● When the PCU is booting up
● When the HMI program is starting
● With reference to the desktop
Note
The following diagrams show, as an example, an application with the
SINUMERIK Operate software installed.
Using ServiceCenter Users

Buttons:
● Use "Exit" to quit ServiceCenter Users.
● If you press the "Reboot" button, the system immediately reboots (without prior
prompting).
"Startup (1)" tab
Figure 1-3 Global Settings: Startup (1) tab
Table 1- 1 The default is marked in "bold".
Startup (1) tab Option Effect

Background
Bitmaps folder: F:\hmisl\siemens\sinumerik Directory with boot screens
\hmi\ico\ ...
Default bitmap folder: F:\hmisl\siemens\sinumerik Directory containing default boot screens
\hmi\ico\ico800
Installing
Enable: "yes" Authorization is in place to install user
software during booting.
"no" No installation authorization
Logon dialog: "yes" Display "Installing Logon" dialog.
"no" Do not display "Installing Logon" dialog.
Veto Dialog: "no" For pending installation during the boot up:
No prompting, the installation begins
immediately.

"yes" For pending installation during the boot up:
Prompt asking whether to install.
Authentication: "manual" Authentication of an HMI+Service user in
the "Installing Logon" dialog is undertaken
manually.
"EKS" Authentication of an HMI+Service user in
the "Installing Logon" dialog involves EKS.
The "Installing Logon" dialog appears if
authentication by EKS has failed in the
background.
"manual+EKS" Authentication of an HMI+Service user in
the "Installing Logon" dialog either involves
EKS or is performed manually.
"Startup (2)" tab
Figure 1-4 "Startup (2)" tab

Keys, filtering
Enable "yes" Key filtering is activated.
"no" Key filtering not activated.
Filter file E:\WINDOWS\System.ini Select the file with filter settings
Desktop Logon
Start dialog: "yes" Display "Desktop Access" dialog
"no" Do not display "Desktop Access" dialog
Logon Dialog: "yes" Display "Desktop Logon" dialog.
"no" Do not display "Desktop Logon" dialog.
Default password map: "no" The password must be entered exactly as
specified.
"yes" The password is not case-sensitive.
Authentication: "manual" Authentication with user name and
password (manual)
"EKS" Authentication with EKS
"manual+EKS" Either authentication with user name and
password or with EKS
"HMI" tab
Figure 1-5 "HMI" tab
"HMI" tab Option Effect

Keys Filtering
Filter file E:\WINDOWS\System.ini Select the file with filter settings
Program
Start: "yes" The HMI program is started.
"no" The HMI program is not started.
File: F:\hmisl\siemens\sinumerik\ Select the HMI program
hmi\autostart\run_hmi.exe
Task bar autohide: "no" HMI program: Hide start task bar
"yes" HMI program: Show start task bar
Task bar on top: "no" HMI program: Start task bar in the
background
"yes" HMI program: Start task bar always visible
"Desktop (1)" tab
Figure 1-6 "Desktop (1)" tab
"Desktop (1)" tab Option Effect

Enable: "no" Desktop not displayed
(Default: for HMI user)
"yes" Displaying the desktop
(Default: only for HMI+Service user)
Content
Icons Autoshow Tools: "no" Do not display links on the desktop.
"yes" Display links on the desktop.
Startmenu "no" Do not display programs in the "Start menu"
Autoshow Tools:
"yes" Display programs in the "Start menu".
Background
Bitmaps folder: (none) Directory with background screens for the desktop
Default bitmap folder: (none) Directory with default background screens for the
desktop
Task bar
Autohide: "no" Desktop: Hide start task bar
"yes" Desktop: Show start task bar
On Top: "no" Desktop: Start task bar in the background
"yes" Desktop: Start task bar always visible
"Desktop (2)" tab
Figure 1-7 SCU "Desktop (2)" tab
"Desktop (2)" tab Option Effect

Keys, filtering
Filter file E:\WINDOWS\System2.ini Select the file with filter settings
Principle of passing on
The settings made under "Global Settings" are passed on to individual users. The settings
which are passed on can still be adapted to suit each user.
Example: Specific user settings

The settings under "Global Settings" are inherited by all users:
1. Left-click the user in the "Users" list.
2. After entering the password, you can adapt the settings as required.
The settings that cannot be changed are displayed with a gray background.
Figure 1-8 Specific settings for the "HMI (user.group)" user
1.2.3 This is how you create a new user
Creating new users

Procedure:
1. Click on "New User" button.
2. Enter a user name.
3. Assign a user type, e.g. "HMI", and a user group to the user.
The Windows user group is only active locally on the PCU.
Figure 1-9 ServiceCenter Users: New user
4. Confirm with "Apply".

5. You will then be asked to specify a password.
6. After confirming with "OK", the new user is created and displayed in the list under
"Users".
Adding new users from a domain

If the PCU is a member of a domain, users already existing in this domain can be added as
HMI users or HMI+Service users:
1. Click on the "New User" button.
2. To do this, select the corresponding entry in the "Domain" list and a user from the "Name"
list.
3. Assign a user type and a user group to the user.
The Windows user group is only active locally on the PCU.
See also
How to add the PCU to a domain (Page 47)
1.2.4 This is how you administer users
Overview
As an HMI+Service user, you can execute the following tasks in the Users ServiceCenter:
● Change user names.
● Delete users.
Change the user name

1. Left or right-click the user who you wish to rename in the list.
2. To change the user name, select "Rename" from the pop-up menu.
3. Enter a new name and confirm with OK.
Deleting a user
To delete a user again, follow these steps:
1. Left or right-click the user who you wish to delete in the list.
2. To delete the user, select "Delete" from the short-cut menu using righthand mouse key.
Result: The user is deleted after confirming the confirmation prompt.
1.3 Boot up behavior of the PCU
1.3.1 Dialogs when booting
Selection during startup

The following dialogs are shown during startup:
● "Installing Logon" dialog
This dialog is displayed if an "Install" directory is found on a bootable storage medium
(e.g. USB-FlashDrive) during startup.
Figure 1-10 Installing Logon
● "Desktop Access" dialog

– This dialog is displayed if either no HMI program is installed, the installation has been
skipped or the start of the HMI program has been deactivated during startup.
Displaying this dialog can be suppressed through configuration in the global or user
settings. "Desktop" is then selected as the default.
Figure 1-11 Desktop Access (example without HMI program)
Note
If an HMI program is installed, the "Start HMI" button is also available in the "Desktop
Access" dialog.
● "Desktop Logon" dialog

The "Desktop Logon" dialog enables the user to log on to the Desktop. This dialog also
appears
– If no valid user data has been provided by the authentication system (EKS).
– If authentication on the "Startup(1)" tab is set to "manual".
Figure 1-12 Desktop Logon (with authentication: "manual")
Note
Setting the access level via EKS
If an EKS unit is available, the following behavior applies:
• If an EKS unit is active, i.e. the key is inserted and can be evaluated, then the key
information for the EKS unit alone determines the active access level. The access
level in the HMI program cannot be changed when EKS is active.
• If the key is withdrawn from the active EKS unit, i.e. the EKS unit becomes inactive,
the system adopts the current access level as determined by the key switch.
• If changing the operating right amongst the operating stations, the EKS unit of the
new active operating station is authoritative. If no EKS unit is assigned there, the
effect is the same as for an inactive EKS unit.
• The key information is evaluated by the HMI. Once an access level has been
determined from the key information, HMI adopts this access level and also sets it
in the NCK: The last access level set always applies to the system.
1.3.2 Boot up of the PCU: no HMI program installed
Requirement
No HMI program is installed during the PCU boot up.
Ramp-up phase
Figure 1-13 PCU bootup diagram (without HMI program)
Explanations:
● If installation programs are present in directory D:\Install, you will be prompted during the
first boot up as to whether the installation procedure should be started. After installation is
completed, you need to restart the system.
The installation can also be skipped and carried out later. To do this, use the HMI
Explorer (Installation via service desktop (Page 78)).
● "Desktop", "ServiceCenter Users" or "Shutdown" can be selected in the dialog
"Desktop Access".
– When selecting "Desktop", the "Desktop Logon" dialog is opened.
– When selecting "ServiceCenter Users", the "Installing Logon" dialog is opened.
Note
When booting the PCU for the first time, the user can only log on as 'auduser'.
1.3.3 Boot up of the PCU: HMI program already installed
Requirement
There is already an HMI program installed.
Ramp-up phase
Figure 1-14 PCU bootup diagram (HMI program installed)
Explanations:
● If the HMI program is already installed, the PCU boots up and the HMI program is started
(default).
● During the boot up, there is a time interval for pressing key <3> when the version
information appears on the lower right of the background screen. Then the
"Installing Logon" dialog opens.
● To carry out service tasks, you will have to log on as a service user.
The following input options are available:
– Manual logon to a domain using user name and password.
– Logon using EKS: A key and valid user data for authentication must be provided for
this. If valid user data is not available via the EKS, the "Desktop Logon" dialog is
displayed along with user name and password.
– Both options can be selected.
1.3.4 Setting the screen resolution
Overview
The system behavior during boot up for the screen resolution is set in the file tcu.ini. You will
find the delivery status for tcu.ini in E:\siemens\system\etc.
Modified tcu.ini files are saved in F:\addon_base\..., F:\oem_base\..., F:\user_base\...
Reference: Operator Components Manual, "Networking" chapter
Set the resolution when booting up the PCU

The following options are available in the # RESOLUTION section in the tcu.ini:
0 = SYSTEM
1 = AUTO_OP_1 (default)
2 = AUTO_OP_2
3 = AUTO_MON_1
4 = AUTO_MON_2
5 = 640X480
6 = 800X600
7 = 1024X768
8 = 1280X1024
The meanings of the settings are as follows:
Settings Meaning
SYSTEM The resolution is not specially set; i.e., the resolution last used in the
system is active, e.g., the resolution which had been set manually in the
Control Panel.
AUTO_OP_1 Default:
During boot up, the resolution is automatically set ("PCU panel" has priority)
in accordance with the following scenarios:
Example 1: There is a PCU panel (irrespective of whether there is a PCU monitor and
TCU panels)
[in active TCU mode:
The following additional condition applies: PCU is activated (with dynamic
resolution switching enabled)]:
The resolution is set to the max. resolution of the PCU panel
(max. 1280x1024).
Settings Meaning
Example 2: There is no PCU panel, however there is a PCU monitor (irrespective of
whether there are any TCU panels):
The resolution is not specially set; i.e., the resolution last used in the
Control Panel.
(Different to AUTO_OP_2 !)
AUTO_OP_2 Like AUTO_OP_1, except:
Example 2: There is no PCU panel, however there is a PCU monitor
(irrespective of whether there are any TCU panels):
The resolution is set to the max. resolution of the PCU monitor, reduced to
the next lowest SINUMERIK resolution. The SINUMERIK resolutions are
640x480, 800x600, 1024x768 and 1280x1024.
Example: In the case of a PCU monitor with a max. resolution of 1440x900,
the SINUMERIK resolution setting is 1280x1024.
AUTO_MON_1 During boot up, the resolution is automatically set ("PCU monitor" has
priority) in accordance with the following scenarios:
Example 1: There is a PCU monitor (irrespective of whether there is a PCU panel and
TCU panels)
640x480, 800x600, 1024x768 and 1280x1024.
If there is a PCU panel, the display there is panned if the max. resolution of
the PCU panel is lower than the max. resolution of the PCU monitor.
Example 2: There is no PCU monitor, however there is a PCU panel (irrespective of
The resolution is not specially set; i.e., the resolution last used in the
Control Panel.
(Different to AUTO_MON_2 !)
1.4 BIOS settings for PCU 50.3
Settings Meaning
Example 3: There is no PCU monitor and no PCU panel (= headless operation):
A) in active TCU mode:
a) dynamic resolution switching is enabled (resolution adaptation entry in
TCU.ini) and at least one TCU is already logged on:
The resolution is set to the resolution of the TCU which is currently active.
b) dynamic resolution switching is enabled (resolution adaptation entry in
TCU.ini) and no TCU has logged on yet or dynamic resolution switching is
disabled:
The resolution is set to the max. resolution of the current PCU panel, i.e.,
which logged on during the previous session.
Default: Default TCU resolution in accordance with the registry.
Notice: The first TCU panel to logon (later) becomes activated. The focus
handler then automatically sets the resolution to this TCU panel's resolution
(in the case of dynamic resolution switching).
A) in inactive TCU mode:
The resolution is not specially set - i.e. the resolution used during the
previous session in the system is active, e.g. the resolution set manually in
Control Panel.
AUTO_MON_2 Like AUTO_MON_1, except:
Example 2: There is no PCU monitor, however there is a PCU panel
(irrespective of whether there are any TCU panels):
(max. 1280x1024).
640X480 During boot up, the SINUMERIK resolution is set to 640x480.
Overview
The BIOS of the PCU is preset in such a way that no changes are required. The date and
time can be set under Windows or the user interface.
Note
Changes in the BIOS
Your device configuration is preset for working with the software supplied with the unit.
You should only change the preset values if you have modified your device in any way, or if
a fault occurs when the unit is powered up.
Starting BIOS setup

1. Start the BIOS SETUP as follows:
Reset the device (warm or cold restart).
After the startup test, the following message appears:
Press < F2 > to enter SETUP or <ESC> to show boot menu
2. Press the F2 key as long as the BIOS prompt appears on the screen.
The BIOS main menu opens:
Figure 1-15 BIOS Main Menu (Example)
BIOS setup: Default settings

The following system parameters are saved on delivery:
Menu: Main
System parameters Default settings Own entries

System Time hh:mm:ss
System Date MM/DD/YYYY
IDE Channel 0 Master None
IDE Channel 0 Slave None
SATA Port 0 40008 MB
SATA Port 1 None
SATA Port 2 None
SATA Port 3 None
Memory Cache Write Back
Boot options
Quick boot mode Enabled
SETUP prompt Enabled
POST errors All, but not keyboard
Summary screen Enabled
Diagnostic screen Enabled
Post Code/Status LPC Bus
Keyboard features
Numlock ON
Key click Disabled
Keyboard auto-repeat rate 30 / sec
Keyboard auto-repeat delay ½ sec
Hardware options
PCI MPI/DP Enabled
Onboard Ethernet 1 Enabled
On-board Ethernet 1 Address 08 00 06 90 xx xx
On-board Ethernet 1 Remote Boot Enabled
On-board Ethernet 2 Address 08 00 06 90 xx xx
On-board Ethernet 2 Remote Boot Disabled
SafeCard functions Enabled
Hardware options
Fan control Enabled
CRT/LCD selection Simultan. Auto
Menu: Advanced

Installed O/S Other
Reset configuration data No
Legacy USB support Disabled
USB controller restart Enabled
I/O Device Configuration
Internal COM 1 Enabled
Base I/O address 3F8
Interrupt IRQ 4
PCI Configuration
PCI device slot 1
Option ROM scan Enabled
Enable master Enabled
Latency timer Default
PCI device slot 2
Option ROM scan Enabled
Enable master Enabled
Latency timer Default
SATA/PATA Configuration
PATA Controller: Enabled
SATA Controller mode Enhanced
AHCI Configuration Disabled
RAID support Disabled
Menu: Security

Supervisor password is Disabled
User password is Disabled
Set user password Enter
Set supervisor password Enter

Password on boot Disabled
Fixed disk boot sector Standard
Menu: Boot

Boot priority order:
1: SATA0: Fujitsu MHT2040BHTBD
2: PCI BEV: VIA BootAgent
3:
4:
5:
6:
7:
8:
Excluded from boot order:
Menu: Version
System parameters Default settings

SIMATIC PC SINUMERIK PCU 50.3
BIOS version V05.01.06
BIOS number A5E00370214-ES005
MPI/DP firmware V01
CPU type Celeron ® M processor 1.50 GHz
CPU ID 06D8
Code revision 0020
Menu: Exit
Save Changes & Exit All changes are saved; a system restart is carried out with the
new parameters.
Changing BIOS settings

Once additional components have been installed or attached, it may be the case that the
system has to be informed of this via the BIOS setup:
1. Start the device.
2. When the prompt to activate the BIOS setup appears, press the <F2> key (corresponds
to horizontal softkey 2 on the OP).
3. The BIOS setup menu appears. In the menu, use the cursor keys to navigate to the
desired selection box.
4. Change the setting using the <+> key (press <SHIFT> and <X> at the same time) or the
↔ key on the numeric keypad.
5. Using the left-right cursor keys, you can reach other setup menus.
6. Press <ESC> (<Alarm Cancel> key) to go to the "Exit" menu (or press the right cursor
key again).
7. Press the <Enter> key to exit the setup menu.
Then the system starts.
Note
Changes to the BIOS settings, with the exception of the boot sequence, require an OEM
contract to be concluded.
Overview
The BIOS of the PCU is preset in such a way that no changes are required. The date and
time can be set under Windows or the user interface.
Note
Changes in the BIOS
Your device configuration is preset for working with the software supplied with the unit.
You should only change the preset values if you have modified your device in any way, or if
a fault occurs when the unit is powered up.
Starting BIOS setup

1. Start the BIOS SETUP as follows:
Reset the device (warm or cold restart).
After the startup test, the following message appears:
PRESS < F2 > to enter SETUP or <ESC> to show Bootmenu
2. Press the F2 key as long as the BIOS prompt appears on the screen.
The BIOS main menu opens:
Figure 1-16 BIOS main menu PCU 50.5 (example)
BIOS setup: Default settings

The following system parameters are saved on delivery:
Menu: Main

System Time hh:mm:ss
System Date MM/TT/JJJJ
Menu: Advanced
Peripheral Configuration Default settings Own entries

Internal COM 1 Enabled
PCI - MPI / DP 1) Enabled
1) only for CPB (-C)
SATA Configuration Default settings Own entries

SATA Controller Enabled
SATA Controller mode AHCI
Video Configuration Default settings Own entries

Primary video device PEG
USB Configuration Default settings Own entries

USB Port0 Enabled
USB Port1 Enabled
USB Port2 Enabled
USB Port3 Enabled
USB Port4 Enabled
USB Port5 Enabled
USB Port6 Enabled
USB Port7 Enabled
USB Port8 Enabled
USB Port9 Enabled
USB Port10 Enabled
Chipset Configuration Default settings Own entries

Port 80h Cycles LPC Bus
VT-d Enabled
HPET Enabled
CPU Configuration Default settings Own entries

P-States (IST) Enabled
Turbo Mode Enabled
CMP Support Auto
HT Support Auto
Use XD Capability Disabled
VT Support Enabled
Turbo Mode Disabled
C-States Enabled
Active Management Technology Default settings Own entries

Support
Intel AMT Support Disabled
Intel AMT Setup promt Disabled
AMT CIRA Request Trig Disabled
AMT DIRA Timerout 30
Un-Configure ME Disabled
USB Configure Enabled
Advanced Default settings Own entries

Fan control Enabled
Operating Mode Switch Enabled
Menu: Security

Supervisor Password Not installed
User Password Not installed
Set Supervisor Password Inactive (no password assigned)
Set User Password Inactive (no password assigned)
Menu: Power

Wake on LAN 1 Disabled
Wake on PME/LAN2 Enabled
Wake on Time Disabled
After Power Failure Power On
Menu: Boot

Quick Boot Disabled
Quiet Boot Disabled
POST Errors All without keyboard
NumLock on
USB Boot Enabled
Bootmanager Enabled
PXE Boot to LAN 1 Enabled
PXE Boot to LAN 2 Disabled
Legacy Default settings Own entries

Normal Boot Menu Advanced Placeholder
Menu: Version
System parameters Default settings

Product SINUMERIK PCU 50.5
BIOS Version V15.02.07
BIOS Number A5E02619467-ES001
InsydeH20 Version 03.59.53.1053
Intel ME Version 6.0.3.1203
Video Option ROM 1976
RAID Option ROM 9.5.0.1037
PXE Option ROM 1.3.30
Mode switch 0 Normal
Menu: Exit

Exit Saving Changes All changes are saved; a system restart is carried out with the
new parameters.
Profile Standard
Changing BIOS settings

Once additional components have been installed or attached, it may be the case that the
system has to be informed of this via the BIOS setup:
1. Start the device.
2. When the prompt to activate the BIOS setup appears, press the <F2> key (corresponds
to horizontal softkey 2 on the OP).
3. The BIOS setup menu appears. In the menu, use the cursor keys to navigate to the
desired selection box.
4. Change the setting using the <+> key (press <SHIFT> and <X> at the same time) or the
↔ key on the numeric keypad.
5. Using the left-right cursor keys, you can reach other setup menus.
6. Press <ESC> (<Alarm Cancel> key) to go to the "Exit" menu (or press the right cursor
key again).
7. Press the <Enter> key to exit the setup menu.
Then the system starts.
Note
Changes to the BIOS settings, with the exception of the boot sequence, require an OEM
contract to be concluded.
Boot sequence
BIOS version 05.01.12
In order to ensure correct functioning of the Software Ghost with Backup/Restore, please set
in BIOS under "SATA/PATA Configuration" → "SATA Controller Mode" → "Compatible".
The CompactFlash Card is entered as SATA. The hard disk (or Solid State Drive) is DISK0,
and the CompactFlash Card is DISK2.
2.1 System settings
2.1.1 Configuring the communication via MPI

If you are using a PCU in conjunction with a SINUMERIK 840D powerline and require MPI
communication, you must install the S7DOS 8.4 communication driver. In all other cases,
you do not have to install this driver.
The setup for this communication driver can be found in the following directory:
● D:\updates\
2.1 System settings
2.1.2 How to change the name of the PCU
Default
The PCU is supplied with an automatically generated computer name.
Procedure
To change the name of the PCU:
1. Select "Start" → "Control Panel" → "System".
2. Select the "Computer Name" tab and click on "Change".
The following dialog opens:
Figure 2-1 Changing the name of the PCU
2.1 System settings
2.1.3 This is how you set the IP address of the PCU
Default setting
Note
IP address in the system network
The IP address 192.168.214.241 is set as a factory default for every PCU on the system
network.
You must only perform the steps described below if you wish to change this default.
Procedure
1. Select the following on the PCU on the Service Desktop: "Start" → "Settings" → "Network
Connections".
The "Network Connections" window opens.
2. Double-click the Ethernet 2 interface you want to parameterize which is to be used for
connecting the TCU or system network.
The "Ethernet 2 (System Network) Properties" window opens.
3. Under the "General" tab, select "Internet Protocol (TCP/IP)" and click the "Properties"
button.
The "Internet Protocol (TCP/IP) Properties" window opens:
2.1 System settings
4. Under the "General" tab, select the "Use the following IP address" option and enter the IP
address and the subnet screen form.
Recommended setting for the first PCU:
5. Enter the required new IP address and confirm the settings with "OK".
2.1 System settings
2.1.4 How to add the PCU to a domain
Requirement
Only a user with the corresponding entitlement, e.g. a domain administrator, can add a PCU
to an existing domain.
Domain Controller (DC)

A domain controller (DC) is a server for central authentication and authorization of
computers and users in a network. In a network with a domain controller, several computers
are combined to form one domain.
Proceed as follows
To add the PCU to a domain:
1. Select: "Start" → "Settings" → "Control Panel" → "System", "Computer Name" tab.
Default: The PCU belongs to a "WORKGROUP" and is not assigned to any domain.
2. Click "Change ...".
The following dialog opens:
Figure 2-2 Add PCU to domain
3. Enter the name of the domain to which you want to add the PCU.
4. You will then be asked to log on as a user with the corresponding entitlement to conclude
the process.
2.1 System settings
2.1.5 How to connect an external monitor
Preconditions
To connect an external monitor, the following preconditions apply:
● The external monitor is connected to the DVI interface on the PCU (using an adapter, if
necessary).
● The monitor may not be connected while in use.
Procedure
To connect an external monitor:
1. Right-click the PCU's service desktop and select "Properties" from the pop-up menu.
2. Select the "Settings" tab and then click "Advanced".
3. Select the "Troubleshooting" tab and and set the "Hardware acceleration" to a value other
than zero. The recommended setting is "full".
4. Close the dialog and click OK to confirm all the dialogs.
5. Repeat steps 2 and 3. There is an additional tab for "Intel(R) ... Grafics Controller"
6. Click the "Graphics Properties" button.
– In the case of a PCU 50.3: On the "Devices" tab the external monitor corresponds to
the "Monitor" selection; the OP/TP on the PCU corresponds to the "Notebook"
selection. Select a "Primary Device" and a "Secondary Device".
– In the case of a PCU 50.5: On the "Display" tab, the OP/TP on the PCU corresponds
to the selection "Primary Display"; the external monitor corresponds to the selection
"Secondary Display". Click the button "Multiple Displays" to select the "Clone" or
"Extended" mode.
7. Close the dialog and click OK to confirm all the dialogs: The external monitor is now
ready.
2.1 System settings
2.1.6 This is how you switch off the USB interfaces.
Command sc_usb disable

To prevent harmful software entering via the USB ports to the control or into the system
network, you can switch off the USB interfaces.
This command is called up in the DOS shell:
Default setting: The USB interfaces are not locked.

Syntax: sc_usb disable [-minutes] [all] [HOSTS...]
• Without a time indication [-minutes], a permanent disable is
set. With time indication, the disable takes the time set in
minutes.
• The disable may refer to all network nodes of the system
network, or a list of host names or IP addresses may be
specified to which the disable should apply.
Command sc_usb enable

With "sc_usb enable" USB storage units on permanently disabled USB interfaces or on
certain host names or IP addresses are enabled again.
2.2 Configuring a customized operator interface
2.2.1 How to select the language for the Windows system
Default setting
In the delivery condition, the Windows XP operating system is only installed on the PCU in
English and with a US keyboard layout.
Requirement
In order to be able to switch languages, the desired languages must be installed from the
DVD of the "SINUMERIK Service Pack Recovery Media Win XP ProEmbSys SP2". With the
"Multilingual User Interface" (MUI), you can switch to menus, dialog boxes and keyboard
layouts for the Windows system in different languages:
WARNING
"Regional Options" tab
The settings for the keyboard assignment and the formats for date, time and number
displays on the "Regional Options" tab must not be changed under "Standards and
formats".
These settings are automatically adapted depending on the language selected for the
operating software.
Select a language
After installing a language from the corresponding CD, proceed as follows:
1. Select "Start" → "Control Panel" → "Language and Regional Options", to open the
following dialog box:
2. Select the "Languages" tab, in order to switch the language for the Windows XP user
interface. Under "Language used in menus and dialogs," select the new language and
confirm with OK.
3. On the "Advanced" tab, select the language for programs that do not support Unicode.
Result
To make the language change effective, the PCU must be rebooted. The selectable
languages are displayed using the font set of the respective language.
See also
How to install additional languages under Windows XP (DVD) (Page 84)
2.2.2 Displaying the boot screen
Default setting
The Siemens boot screen is archived in the PCU under the following path:
F:\hmisl\siemens\sinumerik\hmi\ico\ico640\splash.png
Display OEM-specific boot screen

You can choose any name.
The directory is set in ServiceCenter Users under:
● Startup: Bitmaps folder
● Startup: Default bitmap folder
2.2.3 Changing the background of the service desktop

You can configure user-specific background pictures for the Service Desktop in the
ServiceCenter Users.
If you want to set a background pattern instead, make this setting in the registry.
Procedure
Background picture
1. Save the required pictures in the appropriate resolutions in the corresponding subfolders
of F:\Background picture
2. Switch to the appropriate "User Types" in the ServiceCenter Users and specify the
F:\Background picture folder at "Background" in the "Desktop" tab.
Note
An attempt to set the Service Desktop background (as in standard Windows) via the Control
Panel does not affect the Service Desktop background display, but only the startup screen
display.
Background pattern
A background pattern for the Service Desktop is not set via the "Control Panel" (system
control), but in the registry:
Key: HKLM\SOFTWARE\Siemens\SINUMERIK\Basesoftware\
<version>\HMIDesktop
Value: Pattern (STRING)
Date: <bit code>" (e.g. "0 80 114 32 0 5 39 2",  see HKCU\Control Panel\Patterns)
"(None)" (= NO background pattern)
InitDatum: Background pattern previously set via the Control Panel
Default data: "(None)" (if entry is not available/readable)
2.3 Customized settings during boot up
Overview
Regarding the settings and functionality, booting followed by the start of an HMI program
starting differs from booting with subsequent start of the Service Desktop.
2.3.1 Configuring key filters for an HMI program
Filtering keys
During boot up of an HMI program, keystroke sequences and pressed function keys are
simultaneously filtered. The keystroke sequences and functions that were pressed
simultaneously and are to be filtered are configured in file E:\Windows\System.ini.
Filtering keystroke sequences:
Section: MMC103Keyb
Key: SeqAct
Value: <bit mask>
(= keystroke sequences to be filtered, specified in accordance with the comment
in E:\Windows\System.ini)
Init value: 262143
Filtering function keys that were pressed simultaneously:
Section: MMC103Keyb
Key: ConcurrentKeyMask
Value: <bit mask>
(= function keys to be filtered, specified in accordance with the comment in
E:\Windows\System.ini)
Init value: 255
In the ServiceCenter Users, the keys that are to be filtered can be configured for each
specific user:
● while the system boots → "Startup (2)" tab
● while the HMI program runs: → "HMI" tab
● on the Service Desktop or Windows Desktop: → "Desktop (2)" tab
system.ini file
# -------------------------------------------
# SIEMENS KEYBOARD-DRIVER SECTION (START)
# -------------------------------------------
# State of driver after startup
# (0=NORMAL, 1=PERMANENT-SHIFT ACTIVE)
keybStartState=0
# Type of Keyboard to be used

# (0=MMC103, 1=MFII)
keybType=0
# Filtering Key Sequences

# =======================
# Activation of Key-Sequences to be ignored
# SeqAct holds a BIT-Pattern for a max of 20 sequences
# which could be ignored by the keyboard-driver
# if bit-n is set in Seq-Act, the according sequence
# will be ignored
# The following 20 sequences are implemented
# 0 CTRL-ALT-DEL
# 1 ALT-F4
# 2 ALT-TAB
# 3 LEFTSHIFT-ALT-TAB
# 4 RIGHTSHIFT-ALT-TAB
# 5 CTRL-ESC
# 6 ALT-ESC
# 7 ALT-SPACE
# 8 (SHIFT)-CTRL-F1
# 9 (SHIFT)-CTRL-F2
# 10 (SHIFT)-CTRL-F3
# 16 M$_1
# 17 M$_2
# 18 CAPSLOCK
# 19 NUMLOCK
# 20 (reserved)
KeySequencesEnable =1
SeqAct=262143
# Filtering Concurrent Keys

# =========================
# Definition and selection of function keys (buttons) which shall not be
# pushed in parallel or at the same time (function keys F1-F12 and
# additional hardkeys).
# If more of these buttons are pushed at the same time, the system removes the
# code of these buttons except the code of the button which was pushed first.
# This function of the keyboard-driver is activated by ConcurrentKeyEnable.
# ConcurrentKeyMask holds a BIT-Pattern for a max of 17 function keys, which
# must not be pushed simultaneously (concurrently). If bit-n is set in
# ConcurrentKeyMask, the corresponding button is supervised.
# The following 17 function keys are implemented:
# F1
# F2
# F3
# F4
# F5
# F6
# F7
# F8
# F9
# F10
# F11
# F12
# PAGE-UP (NUMLOCK) Alarm Hardkey on Operator Panel
# PAGE-DOWN (NUMLOCK) Tool Management Hardkey on Operator Panel
# HOME (NUMLOCK) Program Manager Hardkey on Operator Panel
# END (NUMLOCK) Program Hardkey on Operator Panel
# CURSOR-DOWN (NUMLOCK) Alarm Hardkey on Operator Panel
Note
Scope of the keys
Only keys, which have already been defined in the system.ini file, can be enabled.
No additional keys can be defined for filtering.
See also
ServiceCenter Users: User settings (Page 13)
2.3.2 Saving service des⁫ktop settings
Starting the service desktop

The Windows platform is freely accessible via the service desktop. When the service
desktop is started, all of the programs that would automatically be started by Windows
(standard version) during log-in are also started.
● Executing an HMI program
The HMI program can also be started from the service desktop.
● Ending an HMI program
When an HMI program started from the service desktop is exited, you are returned to the
service desktop.
Saving the service desktop (default)

The settings on the service desktop (e.g. arrangement of the links on the service desktop)
are not saved when you log off. A service technician should always find the same starting
condition on the service desktop, not the settings from a previous session.
Saving the settings of the service Desktop

This behavior can be changed by making an entry in the registry. The following settings can
be saved via this registry entry:
● Positions of open windows
● Size and position of the task bar
● Moving and deleting links
Key: HKLM\SOFTWARE\Siemens\SINUMERIK\Basic software\ <version>\HMI

Manager
Value: SaveSINDesktopSettings (DWORD)
Date: 1 (the settings are saved) or
0 (the settings are NOT saved)
Init data: - Value is not created by the basic software -
Default data: 0 (if entry is not available/readable)
The key is effective for all service users and other users.
Links on the service desktop are always saved, irrespective of the registry entry.
Note
Application windows that are still open before logging out, must be closed by the setting
"Save settings" before exiting the service desktop. Otherwise, these application windows will
briefly be displayed and then closed again during a restart immediately before the HMI
program starts.
2.3.3 Starting programs during boot up
Starting additional programs

Programs can also be started at the same time as the HMI program and are started
automatically by Windows when the service desktop is opened. This start in parallel to the
HMI program can be configured.
If the programs to be started are located in the Windows directories of E:\Documents and
Settings, the following registry entry must be set:

Manager
Value: StartSINHMIStartupDirsPrograms (DWORD)
Date: 1 (the programs are started) or
0 (the programs are NOT started)
Init data: 0
If the programs to be started are set in the registry entries

'HKCU\Software\Microsoft\Windows\CurrentVersion\Run' and
'HKLM\Software\Microsoft\Windows\CurrentVersion\Run', the following registry entry must
be set:

Manager
Value: StartSINHMIRunPrograms (DWORD)
Date: 1 (the programs are started) or
0 (the programs are NOT started)
Init data: 0
Executing an HMI program

While the HMI program is being executed, Windows Explorer runs in the background and its
settings (disabled browser functionality, taskbar, start menu, ...) prevent the Windows
platform being accessed unintentionally.
The behavior of the taskbar can be user-specifically set in the ServiceCenter Users under
"HMI program" using "Taskbar Autohide" and "Taskbar On Top".
Ending an HMI program

When the HMI program is ended, Windows XP shuts down completely.
2.3.4 Starting OEM programs
Overview
You can start OEM programs directly before starting the HMI system software. This requires
these programs (or their links) to be stored in subdirectories of the directory C:\RunOEM.
Starting sequence
The subdirectories are executed in the order listed. The programs within a subdirectory are
started in the chronological order in which they were placed in the subdirectory.
● Programs in the C:\RunOEM\SeqOnce subdirectory are started once and sequentially,
i.e., a program is not started until the previously started program is completed.
● Programs in the C:\RunOEM\Seq subdirectory are started sequentially whenever the
system is ramped up, i.e., a program is not started until the previously started program is
completed.
● Programs in the C:\RunOEM\ParOnce subdirectory are started once and simultaneously.
They run parallel with the HMI system software.
● Programs in the C:\RunOEM\Par subdirectory are started simultaneously whenever the
system is ramped up. They run parallel with the HMI system software.
Not only program files, but also other types of file can be stored in the subdirectories, which
are then opened in accordance with their file type.
For example, ".txt" files are opened using Notepad, ".htm" files are opened using Internet
Explorer.
2.3.5 Starting applications in service mode
Starting other applications

If other applications are to be started in service mode, enter them with their complete path in
the [OEMRun] section in the file WINBOM.INI:
Example: Starting the "Notepad" program
[OEMRunOnce]
"Start WinVnc", "x:\I386\system32\StartWinVnc.exe"
"Check Password","x:\I386\system32\CheckPEPwd.exe"
[OEMRun]
"Start Backup/Restore", "x:\I386\system32\GhostOrder.exe"
"notepad","e:\windows\notepad.exe"
All other entries must not be changed.
2.4 Configuring the SITOP UPS module for use with the PCU Base Software
2.4 Configuring the SITOP UPS module for use with the PCU Base
Software
Overview
SITOP UPS modules can continue operation of the PCU 50.5 temporarily if a power failure
occurs and/or shut down the system properly.
For example, a SITOP UPS module also protects against data loss when the PCU 50.5
hardware is shut down, because for technical reasons with Windows-based systems, data is
still written to the SSD after shutdown.
● You will find general information about SITOP UPS modules used in combination with the
PCU base software in Section SITOP modules for the PCU 50.5 (Page 62).
● If you want to use a SITOP UPS module in combination with the PCU base software, you
must first adapt the settings of the SITOP software (Page 64).
● Optionally, you can adapt the delay time after which the HMI software will be forced to
shut down (Page 67).
● You must configure the hardware (Page 69) of the SITOP UPS module before using it
with the PCU base software.
2.4.1 SITOP modules for the PCU 50.5
Suitable SITOP UPS modules

SITOP UPS modules can continue operation of the PCU 50.5 temporarily if a power failure
occurs and/or shut down the system properly.
In conjunction with the PCU base software, all specific applications are taken into account
(e.g. HMI software) with the Shutdown.bat component.
Safe shutdown after a power failure of the delivery condition of the PCU 50.5 takes
approximately 20 seconds. For a typical power consumption of approx. 60 W, a capacitor-
buffered UPS with an energy storage device of 2.5 kW is recommended for a PCU 50.5. If
longer buffer times are required, then several expansion modules can be connected in a
cascade connection.
Example of a compatible SITOP UPS module:

SITOP 500S (15 A / 2.5 kWs capacitor)
Article no.: 6EP1933-2EC41
Further information
Information about available SITOP UPS modules is given in the catalog or in the Internet:
● Catalog KT 10.1 Power supply SITOP
● SIEMENS Industry Mall > 24 V DC Uninterruptible Power Supplies
(https://eb.automation.siemens.com/mall/en/US/Catalog/Products/7010117)
Note
Information about the test environment for machine OEMs
The functionality has been tested in the standard configuration with the PCU base software.
When installing add-on or OEM software components, you must check the shutdown
procedure of the entire system and adapt the factory setting (180 seconds).
See: Parameterizing a delay time for quitting the HMI software (Page 67)
2.4.2 Configuring SITOP software for PCU Base Software

If you want to use a SITOP UPS module in combination with the PCU base software, you
must first adapt the settings of the SITOP software.
Requirement
● The SITOP UPS hardware is connected via the USB interface.
● The SITOP software of version 3.x.2.16 or later is installed in directory C:\Program Files
(x86)\SITOP\
● If you want to use SITOP software of version 3.2.1.16 or older, this must be installed as a
normal application, not as a service.
Note
Windows service of the SITOP software version 3.2.1.16 or older is not compatible with
the PCU base software
If you use SITOP software of version 3.2.1.16 or older as a Windows service with the
PCU base software, the correct shutdown procedure cannot be performed!
If you have installed the SITOP software of version 3.2.1.16 as a Windows service, you
must uninstall this and install it again as an application in order to be able to use it in
conjunction with the PCU base software.
As of version 3.2.1.17, the SITOP software can be used as service with the PCU base
software and is recommended.
● The SITOP software was configured during the installation so that it starts automatically
when Windows is run-up (factory setting).
● The Service Desktop is active.
Procedure
Proceed as follows to configure the SITOP software for use with the PCU base software:
1. Call the settings of the SITOP software, for example, by right-clicking the SITOP UPS
icon in the Windows information area and then selecting "Configuration".
The "SITOP DC UPS Configuration" dialog box opens.
2. In the "General" tab, select "UPS" in the drop-down list at "Serial interface".
3. Switch to the "Floating operation" tab and make the following settings:
– Deactivate the "Display monitoring window after" checkbox
Note
Deactivating the monitoring window
Display of the monitoring window can cause malfunctioning of the HMI software.
– Click directly in the text field at "Start application after" and specify the path of the
Shutdown.bat:
C:\Program Files
(x86)\Siemens\MotionControl\siemens\sinumerik\hmi\base\Shutdown.bat
Note
Do not use the "Browse" button
The dialog can crash if you use the "Browse" button to specify the path of the
Shutdown.bat.
Instead, enter the path directly in the text field.
– After you have specified the path of the Shutdown.bat, activate the "Start application
after" checkbox. Optionally, you can specify the wait time after which the Shutdown.bat
is to be executed (e.g. 5 seconds).
4. Confirm the settings with "Save."
2.4.3 Parameterizing a delay time for quitting the HMI software

Before the SITOP monitor closes Windows 7, Shutdown.bat shuts down operation of the HMI
software.
If the HMI software cannot be shut down within 180 seconds (factory setting) due to an error,
HMI software shutdown is forced and Windows 7 is shut down.
If the HMI software of your OEM installation is not shut down within 180 seconds, you can
parameterize this wait time manually.
Note
The "SITOP UPS" function has been tested in the standard configuration with the PCU base
software. When installing add-on or OEM software components, you must check the
shutdown procedure of the entire system and adapt the factory setting.
Requirement
● The SITOP UPS module is configured for use with the base software.
See Configuring SITOP software for PCU Base Software (Page 64).
Procedure
Proceed as follows to change the delay time:
1. Call the settings of the SITOP software, for example, by right-clicking the SITOP UPS
icon in the information area and then selecting "Configuration".
2. In the "SITOP DC UPS Configuration" dialog box, enter the wait time in seconds as a
command line parameter in the "Floating operation" tab:
– Syntax: <Path>\Shutdown.bat -<Time in seconds>
– Example: C:\Program Files
(x86)\Siemens\MotionControl\siemens\sinumerik\hmi\base\Shutdown.bat -180
3. Confirm the setting with "Save".
2.4.4 Hardware configuration of the SITOP UPS module
Buffering parameterization
The UPS module can be used to select whether buffering should be completed after a
predetermined period of time or not until the accumulator’s lowest discharge threshold (=
maximum buffer time) has been reached. Both buffering parameterizations result from this.
"Maximum buffer time" mode

This mode enables the system to be shut down in a time-optimized manner. The UPS
module is synchronized with the shutdown of the operating system. Buffering is maintained
until the operating system has been shut down. The operating system must shut down within
a maximum of five minutes (including all applications). Otherwise, the UPS module buffers
for the maximum buffer time (dependent on the accumulator state).
Required settings on the UPS module (USB interface)
On - Off
1 +2V
Cut-in threshold
2 +1V +22V fixed
3 +0.5V
4 +1V
5 +1V End-of-charge voltage

+ 26.3V fixed
6 +0.5V
7 +0.2V
8 +0.2V
9 +0.1V
10 0.35A / 0.7A Charging current
On - Off
1 Set time/max. time
2 +320 s
3 +160s Buffer time
4 +80s
5 +40s +5 s fixed
6 +20s
7 +10s
8 Disconnection
9 Battery operating state on/off
Legend:
Delivery condition setting
Setting for operation on the PCU
“Fixed buffer time” mode

In this mode, the UPS module always buffers for the pre-selected, fixed period of time. It is
not possible to synchronize the UPS module with the operating system shutdown.
Required settings on the UPS module
On - Off
1 +2V
Cut-in threshold
2 +1V +22V fixed
3 +0.5V
4 +1V ∘
∘
5 +1V End-of-charge voltage
+ 26.3V fixed
6 +0.5V
7 +0.2V
8 +0.2V
9 +0.1V
On - Off
2 +320 s ∘
∘
3 +160s Buffer time
+5 s fixed
4 +80s
5 +40s
6 +20s
7 +10s
8 Disconnection
Legend:
2.5 Configuration of the Service Center
2.5.1 Overview
You can permanently adapt the settings for the backup and restoration of disk images
(Service Center (Page 87) component) in the "Service Center Backup/Restore" dialog box:
● Configuration of the network adapter (Page 74)
● Configuration of the host (Page 76)
Adaptations that you make here are stored in the servicesystem.ini configuration file.
You can also adapt the settings directly in the associated configuration files:
● servicesystem.ini
● Additional settings for the Service System on the USB flash drive: ghost.ini
You can also view the log files of the Service Center or restart the PCU 50.5 in the Service
Center in the "Service Center Backup/Restore" dialog box.
To open the dialog box, click the ServiceCenter Backup-Restore icon on the Desktop.
Figure 2-3 ServiceCenter Backup/Restore
2.5.2 Configuration of the network adapter

You can make the network settings in the "Adapter Settings" tab and permanently save this
configuration, in contrast to the settings in the "Network Settings" dialog box of the Service
Center (Page 90).
Settings that you make in this dialog box are stored in the servicesystem.ini configuration
file.
Overview
You can make the following IP settings in the "Adapter Settings" dialog box:
Figure 2-4 Adapter settings - Ethernet 1 (company network)
Table 2- 1 Settings in the "Adapter Settings" dialog box
Settings Purpose
Adapter Select the Ethernet interface that you want to configure.
All settings in this dialog box refer to the selected Ethernet interface.
Use Windows Settings Select whether the values set in the Control Panel are to be used.
Obtain an IP address automatically Select whether the addresses are to be fetched dynamically from the DHCP server.
(DHCP) If the checkbox is deactivated, you must make the settings manually.
IP Address Set the IP address of the NCU.
You can specify an IP address from the following range:
192.168.214.250 - 254
Subnet Mask Specify a subnet mask, e.g. 255.255.255.0
Settings Purpose
Default Gateway Set the IP address of the standard gateway.
A standard gateway creates a standard route in the IP routing table for all destinations that are
not in the subnet.
Name Server Set the IP address of the name server.
A name server answers questions asked about a domain name zone using a DNS database.
2.5.3 Configuration of the host

You can make the network settings in the "Host Settings" tab and permanently save this
Center.
file.
Overview
You can make the following settings in the "Network Settings" dialog box:
Figure 2-5 Host settings
Table 2- 2 IP settings in the "Host Settings" dialog box
Settings Purpose
Network enabled Activate or deactivate the network interfaces of the PCU 50.5.
Firewall enabled Activate or deactivate the firewall of the PCU 50.5.
DNS Configuration > Computer Name Specify the DNS computer name.
DNS Configuration > Suffix Search List Parameterize a search list for DNS suffix, e.g. "network.com".
The factory setting of the Ethernet interface "Local Area
Connection" is ".local".
Install software and updates 3
3.1 Installing SINUMERIK products
Overview
This chapter describes how to install additional software on the basis of the pre-installed
PCE basic software or how to carry out an update.
The description below is based on the delivery condition of the hardware and software
components.
The service desktop is, for example, used for the following tasks:
● Installing HMI system software
● Setting the running environment of the HMI system software
● Checking the hard disk or version
● Privilege for SIMATIC STEP 7
Install software and updates
3.2 Installation via service desktop
Installing additional software

The service desktop makes it possible to install system software or a software update. This
mostly affects installation/update packages that are to be installed via the Windows network.
Installation can be performed in two ways:
● The installation/update package is stored in directory D:\INSTALL. When booting the
PCU the next time, the installation/update process is automatically started while booting.
Only when the installation or update process is completed does normal boot manager
continue and, if necessary, HMI software started.
● The installation/update process can be started from the service desktop directly by
executing the installation/update package.
Using installation directories

Several installation directories can be set to enable an operator setup to be executed
automatically. Installation directories include the subdirectory D:\Install and the directories
listed in the [SetupDirs] section of the E:\Windows\System32\HMIServe.ini parameters file.
The "D:\Install" installation directory is preset there.
The key names contained within a section of the E:\Windows\System32\HMIServe.ini
parameters file must be unique.
The installation directories are evaluated in the sequence described in the parameters file. If
the parameters file is missing or it does not contain a [SetupDirs] section, the preset
"D:\Install" installation directory is considered instead.
If the [SetupDirs] section contains installation directories, but not "D:\Install", the "D:\Install"
directory is not considered within the context of the set installation directories.
When executing a setup using OpFile.txt, the issue of whether or not the setup requires a
reboot once it has been completed is taken into account and displayed via a corresponding
OpFile.txt entry. If a corresponding entry exists, a reboot is triggered. If there is a chain of
setups to be executed one after the other, the reboot is performed once the final setup is
complete.
Installing with HMI Explorer

The "HMI Explorer" Windows program is available on the service desktop. When this
program is called up, detailed version information relating to the HMI system software
applications installed and to Windows XP is displayed.
Applications can be individually started or uninstalled via the HMI Explorer. Select the menu
"Install" to display and install the available software packages.
Figure 3-1 HMI Explorer (Example)
Description of HMI Explorer

The properties dialogue box gives detailed information on installing the software product:
● Information on the SINUMERIK product:
The "Info" dialogue box provides information on the selected SINUMERIK product:
Current version: Specifies which version of the SINUMERIK product is currently

installed. The version is shown in long form.
Internal version: Shows the current internal version number of this product.
Installation Date/Time: Shows the installation date and time of the current version.
Installation path: Displays the path for the main directory of the SINUMERIK product.
Start application: Gives information on the path to the *.exe file, which launches the
SINUMERIK product.
● Language of the product
The "Language" dialogue box lists the installed languages for the respective SINUMERIK
product and provides information on the name of the installed language. If the language
is not known, an abbreviation of its name is displayed. Known languages of HMI Explorer
are German, English, Spanish, French and Italian. The version of the installed language
is also displayed. Information is also given regarding the installation time and date.
● History of the product
The "History" dialogue box shows information on the history of the SINUMERIK product.
This dialogue box gives information on the release version, any service packs and hot
fixes. The "release" entry is always available. The entries for "service pack" and "hot fix"
only appear if they have been installed. Information on the "version", "internal version"
and "installation date/time" is given for each entry on this list.
● Component information
The "Components" dialogue box shows the information on the components
accompanying a product:
Component: Component name

Version: Internal version of the components
Path: Path of the components
File: *.exe file
Enable : Shows whether or not the component is enabled
Description: Description of components
Type: Type of components
Figure 3-2 "Components" dialogue box (example)
3.3 How to install and authorize SIMATIC STEP 7
Overview
SIMATIC STEP 7 V5.5 SP1 can also be installed on the PCU.
Delivery item: SIMATIC STEP 7 V5.5 SP1

Components: SIMATIC STEP 7 V5.5 SP1 and
AddOn for SINUMERIK 840D sl
Type of delivery: 1 installation DVD
Note
The "MPI driver" package available on the PCU is part of the HMI software and must not be
uninstalled!
A network connection or a connection to a DVD drive is required.
Recommendation: Mouse port
Installation under Windows XP

You must follow the installation sequence described here!
1. Boot up the PCU in the service desktop.
2. Access DVD (via network or external DVD drive) and call up SETUP.EXE in the root
directory there.
3. The installation proceeds with operator prompting. The installation directory for STEP 7
should be changed to F:\... where the directory in F: can be freely selected.
4. The prompt for "Transfer license keys" must be answered with "No, transfer the license
keys later." The licensing is done after the installation of SINUMERIK add-on. Once
installation is complete, the PC will need to be rebooted. During boot up, select the
service desktop again.
5. Switch to the Sinumerik_Add_on directory on the DVD and call SETUP.EXE. The
installation proceeds with operator prompting. Once installation is complete, the PC will
need to be rebooted. During boot up, select the service desktop again.
6. Start the link "STEP7 authorizing" on the service desktop. This authorizes STEP 7 and it
can be started from the operating software (STEP 7 appears as its own operating area on
the expansion bar of the area menu, protected with access level 3).
The following entries are made automatically in F:\Add_on\oemframe.ini:
[s7tgtopx]
; with HMI Advanced: eliminate minimize/maximize buttons
; of the Step7 window
WindowStyle_Off=196608
; with HMI Advanced: switch to previous task when Step7 is terminated
nSwitchToTaskAfterTermination= -2
These entries may also need to be modified in OEM configurations.
3.4 How to install additional languages under Windows XP (DVD)
Use
Use the SINUMERIK service pack recovery media WIN XP ProEmbSys SP3 to:
● Subsequently install Windows components
● Re-establish the delivery condition of the PCU without application software
● To install other languages for Windows XP
Contents of the DVD

There are the following directories on the DVD:
Directory Contents
1_WIN_Components Windows XP ProEmbSys SP3
Windows XP ProEmbSys operating system, incl. SP3 for post-
installation of software components that are no longer located on
the PCU.
2_XP_Base Symantec Ghost image for PCU 50.3 and EBOOT
• Ghost image of the delivery condition of the PCU basic
software Windows XP for PCU 50.3 without application
software.
• Ghost image for creating an "Emergency Boot System"
(identical to the directory D:\EBOOT on the PCU)
3_MUI_1 Chinese (simplified)
Traditional Chinese
Japanese
Korean
Romanian
Slovakian
4_MUI_2 Danish
German
French
Dutch
Italian
Spanish
Swedish
Directory Contents
5_MUI_3 Brazilian Portuguese
Finnish
Polish
Russian
Czech
Turkish
Hungarian
EULA TERMS Contained
Certificate of authenticity Not contained
Installing languages
To install additional languages, proceed as follows:
1. If no DVD drive is directly connected via a USB port, the DVD can be accessed via a
network to a released DVD disk drive via "Explorer" → "Tools" → "Map Network Drive".
The letter G should be selected as the drive letter.
2. Select the directory with the appropriate language, the program "MUISETUP.EXE" starts.
After accepting the licensing conditions, you can start the installation procedure with
"Continue". A list of all of the pre-installed languages and the languages available on the
DVD is displayed.
3. Now the desired languages can be installed/uninstalled by inserting or deleting a check
mark in front of the language.
4. Other settings include:
– Choice of language version for the standard user/new user
– The language for programs without Unicode support must be set to "English (US)".
– The font set must also be set to "English (US)".
5. After confirming with "OK," the installation begins. Many languages (e.g. Chinese) require
system files that are also located on the DVD.
If the installation drive is other than the recommended "G:" the "Windows XP Professional
Service Pack 2 CD" or the "Windows XP Professional CD" may be required. The path
name must then be changed accordingly.
6. After successful installation, a reboot may be requested depending on the language.
Note
• The choice can only be made from among the languages that were previously
installed on the PCU.
• The new language of Windows XP only goes into effect if the user logs in again after
the changeover or the PCU is turned off and then on again.
• The language setting of the operating software is independent of this. It is set
independently of this under "Start-up" → "HMI" → "Change Language".
Backing up and restoring data 4
4.1 Overview
You can perform installation and commissioning work on the PCU in theService Center,
which is based on Microsoft Windows PE.
When the Desktop is active, configuration of the Service Center is possible via the
"ServiceCenter Backup-Restore" (Page 73) icon.
Most of the functions of the Service Center are available in the main menu (Page 88).
In particular, you can create or restore disk images in the Service Center. The following
options are available:
● Create a disk image of the SSD (Page 93)
● Restore a disk image of the SSD (Page 95)
● Create a disk image of a partition (Page 97)
● Restore a disk image of a partition (Page 99)
The Service Center uses the Symantec Ghost (Page 104) software, which you can also call
separately.
4.2 Starting the Service Center

To start the Service Center, proceed in one of the following ways:
● To call up the Service Center on the SSD while the PCU is starting, select the "Booting
Service System" during startup in the Windows boot menu.
● To call up the emergency boot system on a USB flash drive while the PCU is starting, set
the service switch to E or press F12 during startup to show the boot selection.
● To switch to the Service Center while the Service Desktop (Windows 7) is active, click the
"ServiceCenter Backup-Restore" icon on the Desktop and then click "Start
ServiceSystem".
Backing up and restoring data
4.3 Functions of the Service Center
Overview
In the upper section of the Service Center main menu, you can select one of five tasks.
Buttons for additional functions are available in the lower section.
Figure 4-1 Service Center - Main menu
Table 4- 1 Functions in the main menu of the Service Center
Element of the window Purpose

Disk Backup Create a disk image of the local SSD.
With this command, you can create a disk image of the entire SSD (with all partitions).
Disk Restore Restore the local SSD with an existing disk image.
With this command, you can restore the complete SSD (with all partitions) with a previously created disk
image.
Partition Backup Create a disk image of a partition on the local SSD.
With this command, you can create a disk image of an individual partition of the SSD.

Partition Restore Restore a partition on the local SSD with a disk image.
With this command, you can restore an individual partition of the SSD with a previously created disk
image.
Log Files View and save log files.
About Viewing information about the Service Center.
Shell Open the prompt.
With this command, you can enter commands for executing tasks on the PCU without using a graphical
user interface.
Network Making network settings (Page 90).
Any network settings you make in this dialog box are temporary. To change network settings
permanently, switch to the Service Desktop.
Reboot Restart the PCU.
Shutdown Shut down the PCU.
Note
Data backup and restore with CompactFlash cards
If there is a CompactFlash card in the slot of the PCU, you will not be able to back up or
restore data via the Service Center.
Instead, start the "ghost32.exe" program via the prompt of the Service Center.
4.4 Network settings in the Service Center

You can make network settings in the main menu of the Service Center by clicking
"Network":
● IP settings at the enterprise network interface X1 (Local Area Connection 2)
● IP settings at the plant network interface X2 (Local Area Connection)
● Configuration of the host
● Configuration of IP routing
Note
Temporarily storing network settings in the Service Center
Any network settings you make in this dialog box are immediately effective, but temporary.
To change network settings permanently, switch to the Service Desktop.
For further information, see Section Configuration of the Service Center (Page 73).
Overview
IP settings
You can make the following IP settings in the "Network Settings" dialog box:
Figure 4-2 Service Center - IP settings
Table 4- 2 IP settings in the "Network Settings" dialog box
Section Settings Purpose

Adapter configuration Adapter Select the Ethernet interface that you want to configure.
All settings in Section "Adapter configuration" refer to the selected Ethernet interface.
DHCP Enabled Select whether the addresses are to be fetched dynamically from the DHCP server.
If the checkbox is deactivated, you must make the settings manually.
Address Set the IP address of the NCU.
192.168.214.250 - 254
Subnet Specify a subnet mask, e.g. 255.255.255.0
A standard gateway creates a standard route in the IP routing table for all destinations that
are not in the subnet.
Host configuration Suffix Search List Parameterize a search list for DNS suffix, e.g. "network.com".
The factory setting of the Ethernet interface "Local Area Connection" is ".local".
Routing settings
You can make the following routing settings in the "Network Settings" dialog box:
Figure 4-3 Service Center - IP routing
Table 4- 3 Routing settings in the "Network Settings" dialog box
Settings Purpose
Add Route Add a new route.
Remove Route Delete a selected route.
Destination Specify the network destination of the route as an IP address.
Mask Subnet mask of the specified IP addresses.
Next Next hop or forwarding IP address via which the network destination can be accessed.
Interface Select an interface to which the configured IP routing applies:
• Enterprise network interface X1 (Local Area Connection 2)
• Plant network interface X2 (Local Area Connection)
Metric Integer cost metric (1 to 9999). Required if several routes for sending a packet to a network destination are possible in
the routing table.
See also
Release directory of the PC/PC in the network (Page 114)
Creating a shortcut to the network drive (Page 119)
Configuring routing in the network (Page 109)
4.5 Create a disk image of the SSD

You can create a disk image of the entire SSD in the Service Center with the "Disk Backup"
function.
Procedure
To save the SSD as a disk image, proceed as follows:
1. Start the Service Center, e.g. via the Windows boot menu.
See also: Starting the Service Center (Page 87)
2. In the main menu of the Service Center, click "Disk Backup".
The "Service Center - Disk Backup" dialog box opens.
Figure 4-4 Service Center - Disk Backup
4.6 Restore a disk image of the SSD
3. Make the required settings here:

Base Ghost version Select the Symantec Ghost version that is to be used when
parameters creating the disk image:
• Version for Windows 7: "Ghost version 11.5.x"
• Version for Windows XP: "Ghost version 8.2.x"
Source disk Select a data medium of which you want to create a data
image.
Destination file Enter a destination directory and file name.
Disk images can be stored either locally or in the network.
Base Connect share Open the "Connect a Share" dialog box (Page 102).
parameters > You can set up a shared resource (e.g. a directory in the
Destination file network), to which you can store the disk image.
Select Open the "Select Destination File" dialog box.
destination You can navigate through a local directory on the PCU 50.5
and enter a file name.
Optional Split image size Split the disk image and select a split image size.
parameters You can split the disk image into several files of a defined size.
Split the disk image size in the following cases:
• If the file system (e.g. FAT32) can only manage files of a
certain size.
• If the disk image is to be archived onto multiple data
media, for example, when using CDs.
Compatible file Select the compatibility of the name scheme.
naming system This option is required so that a disk image with older versions
of the "PCU base software Windows XP" can be read in by
Windows XP.
It is not possible to use a different operating system on a PCU
50.x than the preinstalled system (e.g. Windows XP on a
PCU 50.5 Windows 7).
Compress Activate Compression or select a compression level.
image Higher compression results in a smaller file size, but increases
the time needed to compress or decompress the data.
4. Confirm your settings with "Backup" to start generation of the disk image.

If your system is no longer functioning stably, you can restore it with a disk image.
Note
Restoring replaces all current files
When you restore the PCU from a disk image, all programs, settings, and files are
completely replaced by the disk image. You cannot restore individual files or exclude
individual files from restoration.
Requirement
A disk image exists
See: Create a disk image of the SSD (Page 93)
Procedure
To restore a disk image, proceed as follows:
2. In the main menu of the Service Center, click "Disk Restore".
The "Disk Restore" dialog box opens.
Figure 4-5 Service Center - Disk Restore

Base Source file Select the disk image from which the SSD is to be restored.
parameters You can use local disk images or disk images stored in the
network.
Destination disk Select the SSD to be restored from the disk image.
parameters > You can manage a shared resource (e.g. a directory in the
Destination network), to use a disk image stored on the network to restore
disk the SSD.
Select source Open the "Select Source File" dialog box.
You can navigate through a local directory on the PCU 50.5
and select a disk image for restoration.
Optional Adjust Select partition scheme to be used on restoration of the data
parameters partitions medium image:
• If the PCU base software Windows 7 is on the disk image,
choose "PCU Base Windows 7 partition scheme".
• If the PCU base software Windows XP is on the disk
image, choose "PCU Base Windows XP partition scheme".
4. To start the restore process and entirely replace the existing data on the SSD with the
disk image, confirm the settings with "Restore".
Result
The restore process is started.
Note
Troubleshooting if reading in of the disk image fails
If data transfer is interrupted during the restore process, the PCU will have no executable
system.
In this case, use a bootable USB flash drive with Service Center to read the disk image in
again.
4.7 Create a disk image of a partition

You can create a disk image of an individual partition of the SSD in the Service Center with
the "Partition Backup" function.
Procedure
To save a partition of the SSD as a disk image, proceed as follows:
2. In the main menu of the Service Center, click "Partition Backup".
The "Service Center - Partition Backup" dialog box opens.
Figure 4-6 Service Center - Partition Backup
4.8 Restore a disk image of a partition

Base Ghost version Select the Symantec Ghost version that is to be used when
parameters creating the disk image:
• Version for Windows 7: "Ghost version 11.5.x"
• Version for Windows XP: "Ghost version 8.2.x"
Source partition Select a data medium of which you want to create a data
image.
parameters > You can set up a shared resource (e.g. a directory in the
Destination file network), to which you can store the disk image.
Select Call the "Select destination file" dialog.
destination You can navigate through a local directory on the PCU 50.5
Optional Split image size Split the disk image and select a split image size.
parameters You can split the disk image into several files of a defined size.
• If the file system (e.g. FAT32) can only manage files of a
certain size.
• If the disk image is to be archived onto multiple data
media, for example, when using CDs.
of the "PCU base software Windows XP" can be read in by
Windows XP.
Compress Activate Compression or select a compression level.
image Higher compression results in a smaller file size, but increases

Note
When you restore a partition from a disk image, all programs, settings, and files are
completely replaced on this partition by the disk image. You cannot restore individual files or
exclude individual files from restoration.
Requirement
A disk image of a partition exists
See: Starting the Service Center (Page 87)
Procedure
To restore a partition from a disk image, proceed as follows:
See also: Create a disk image of a partition (Page 97)
2. In the main menu of the Service Center, click "Partition Restore".
The "Partition Restore" dialog box opens.

Base Source file Select the disk image from which the partition is to be restored.
parameters You can use local disk images or disk images stored in the
network.
Destination Select the partition to be restored from the disk image.
partition
parameters > You can manage a shared resource (e.g. a directory in the
Destination network), to use a disk image stored on the network to restore the
partition SSD.
Select source Call the "Select source file" dialog.
You can navigate through a local directory on the PCU 50.5 and
select a disk image for restoration.
4. To start the restore process and entirely replace the existing data on the partition with the
Result
Note
If data transfer is interrupted during the restore process, the PCU will have no executable
system.
again.

To manage a disk image in the network, you can include a shared network directory on the
PCU 50.5 as a drive.
In the Service Center, you configure network drives in the "Connect a share" dialog box. You
can call this dialog box directly from the relevant dialog boxes to both create (Page 93) and
restore (Page 95) disk images.
Requirement
The network directory is shared with the relevant user accounts in the domain and on the
PCU.
See also: Release directory of the PC/PC in the network (Page 114)
Overview
The setting options in the "Connect a share" dialog box have the following meaning:
Figure 4-8 "Connect a Share" dialog box
Table 4- 4 Settings in the "Connect a Share" dialog box in the Service Center

Connection Local drive To select drive letters under which the network directories are to be accessible on the PCU 50.5.
Remote path Specify the device in the network and share name of the resource.
Syntax: \\Name of the server\share name of the network directory
Example: \\Backup_Server\PCU_Backup
Credentials User name Enter the user account under which the resource in the network can be accessed.
If you have shared the resource on the server for certain users only, you must enter one of these user
accounts here.
Password Enter the password of the user account.
Further information
You will find information about releasing directories in the network and network drives in the
following sections:
● Release directory of the PC/PC in the network (Page 114)
● Creating a shortcut to the network drive (Page 119)
4.10 Starting Symantec Ghost directly

With the "Symantec Ghost" software you can store the entire contents of an SSD as a disk
image. Disk images can be kept on various storage media for subsequent restoration of the
data on the SSD.
Symantec Ghost is supplied from the factory on replacement SSDs for the PCU and on the
SSD of the entire PCU. Symantec Ghost is used by the components of the PCU Base
Software to back up or restore data.
You can also start Symantec Ghost directly from the prompt to execute the data backup
tasks from the user interface of Ghost. This is necessary, for example, when using
CompactFlash cards.
Procedure
To start Symantec Ghost directly, proceed as follows:
1. Call the prompt from the Service Center or the Service Desktop.
2. Enter "ghost.32.exe" and confirm the entry.
Further information
More information is available in the Internet on website Ghost.com (http://www.ghost.com).
4.11 Bootable USB flash drive
Use
You can generate a bootable Service Center (Emergency Boot System) based on Microsoft
Windows PE on a USB flash drive as preventive measure against a defect
The Ghost image is located on the SSD under: D:\Eboot\eboot.gho
Using the same procedure, you can create a Service Center on a PG/PC. For this, Symantec
Ghost must be installed on the PG/PC.
Precondition
● The Windows 7 Service Desktop is active
● You have a USB flash drive (e.g. SIMATIC PC USB flash drive)
Procedure
To create a bootable USD flash drive, proceed as follows:
1. Connect the USB flash drive to a USB interface of the PCU.
2. Start Symantec Ghost, for example, by entering Ghost32.exe in the search bar in the start
menu.
3. In Symantec Ghost, select the "From Image" command from the "Local > Disk" menu.
4. Select D:\Eboot\eboot.gho as the source and the USB flash drive as the destination.
Result
The Emergency Boot System is installed on the USB flash drive and the data medium is
renamed to "EBOOT." The service system on the bootable USB flash drive can now be
used.
4.12 Operating a service PC/PC in the network
4.12.1 Overview
System network
In the following applications, you will need, for example, a connection between the PCU and
a PG/PC in the system network:
● Save the disk image of the PCU-SSD to a PG/PC
● Restore the SSC of a PCU via the DVD drive of a PG/PC
● Start up the replacement SSD
● Install the software on the PCU via the DVD drive of a PG/PC
Company network
If you want to connect the service PG/PC via a company network (Eth 1), contact your
network service center.
4.12.2 Connection options in the system network
Overview
The following figures show the typical connection options in the system network:
● PCU to "Eth 2" with service PG/PC, directly, using a crossover Ethernet cable
● PCU to "Eth 2" with service PG/PC, via a switch, using a 1:1 Ethernet cable
Table 4- 5 Configuration images: Meaning of the connections
Symbol Meaning
Eth 1 as a DHCP client
Eth 2 with a fixed IP address

1:1 Ethernet cable
Crossover Ethernet cable
Configuration with PG/PC directly to PCU
Figure 4-9 Connecting a PG directly to a PCU
Configuration with PG/PC and switch to PCU
Figure 4-10 Connecting a PG via a switch to a PCU
Note
If a PCU is switched off and on again without its own OP/TP including TCU, and if the PCU
boot-up is intended to be performed from the service system (EBS), an external VGA
monitor and keyboard are needed to operate the PCU.
An external VGA monitor and keyboard are not needed if the TCUs are operating and the
PCU is not switched off with the EBS during booting.
Basic procedure
On the PG/PC with Windows 7:
● Connecting a PG/PC to a PCU according to one of the configurations shown above.
● The network protocol used is: TCP/IP.
TCP/IP is already preconfigured on the PCU.
● Setting up IP addresses on the same subnetwork.
● Releasing a directory on the PG/PC for network access.
On the PCU in the Service Center (WinPE):
● On the PCU start the Service Center (WinPE).
● Establish a network connection to the shared directory of the PG/PC.
See: Functions of the Service Center (Page 88)
4.12.3 Configuring routing in the network
Overview
If you have connected a PG/PC at interface X127 of the NCU, configure the network routing
to establish the connection between the PG/PC and the PCU.
Figure 4-11 A networking example using IP routing
Conditions
The following conditions must be met in order to use this function:
● The PG must be connected to interface X127 of an NCU in the system network.
● The NCU and PCU must be connected via the system network.
● On the NCU, the routing is activated in one of the following ways:
– In SINUMERIK Operate 4.5 SP2 or higher, the routing is configured in image "Settings
of the system network".
– In the configuration file basesys.ini, key EnableSysNetToIBNForwarding=1 is set.
● If you wish to access a network directory, it must be shared.
● The user account in question is known to the PG/PC.
● The Service Center is active.
Procedure
To configure the IP routing in the Service Center, proceed as follows:
1. In the main menu of the Service Center, click "Network".
2. In the "Network Settings" dialog box, click the "IP Routing" tab.
3. Configure the necessary routes. See also: Network settings in the Service Center
(Page 90)
Result
The routing has been configured and the PG/PC and PCU are connected via the NCU.
Now, perform the desired steps, for example, a Restore a disk image of the SSD (Page 95).
4.12.4 Configure the network settings of the PG/PC

Once you have connected a PG/PC in the network, make the network settings on the
PG/PC.
The basic procedure for setup under Windows 7 or Windows XP is described below.
Detailed information from Microsoft is provided in Windows under "Help and Support" or in
the Internet: Microsoft Windows support (http://windows.microsoft.com/en-
US/windows/windows-help#windows=windows-7)
Precondition
● The PG/PC is networked with the PCU in one of the following ways:
– The PG/PC is connected to the PCU with an Ethernet cable (either directly or via a
switch)
See: Connection options in the system network (Page 107)
– The PG/PC is networked with the PCU via an interface on the NCU and the routing is
configured.
See: Configuring routing in the network (Page 109)
● A current Microsoft Windows operating system is installed on the PG/PC
● The PG/PC is switched on
Procedure
To configure the network settings of the PG/PC for connecting a PCU in the system network,
proceed as follows:
1. Open the "network connections" window:
– To do this under Windows XP: in the "Start > Control Panel > Network and Internet
Connections" menu, choose "Network Connections."
– To do this under Windows 7: in the Control Panel in category "Network and Internet >
View network status and tasks," choose "Change adapter settings."
2. Right-click on the network adapter you want to configure, then choose "Properties" from
the shortcut menu.
This opens the "Properties of <connection>" dialog box.
Figure 4-13 Properties of <connection>
3. Make the following settings:

– Click "File and Printer Sharing for Microsoft Networks."
– To change the IP address of the PG/PC, double-click "Internet Protocol Version 4
(TCP/IPv4)", then configure the settings as follows:
Section Element Settings

Use the following IP IP address The following IP addresses in the system
address network can be used for the PG/PC:
• 192.168.214.250
• 192.168.214.251
• 192.168.214.252
• 192.168.214.253
• 192.168.214.254
Subnet mask • 255.255.255.0
Result
The network settings of the PG/PC are now configured for use with the PCU 50.5.
4.12.5 Release directory of the PC/PC in the network

If you want to, for example, store disk images on a PG/PC that you have linked to the PCU
via the network, set up a network drive.
As soon as it has been set up, a new drive will appear on the PCU, which is really a directory
on the PG/PC.
The basic procedure for setup under Windows 7 and Windows XP is described below.
the Internet: Microsoft Windows support (http://windows.microsoft.com/en-
US/windows/windows-help#windows=windows-7)
Requirement
● The PG/PC is switched on.
● There is sufficient space on the PG/PC for saving, for example, disk images from the
PCU.
● The user accounts to which you want to grant share rights are known in the domain or on
the PCU.
Procedure
Proceed as follows to share a directory for use in the network:
1. On the PG/PC, in the Control Panel call up Computer Management.
2. Under "System > Shared Folders" select the file "Shares."
3. In the "Action" menu, click the "New File Share..." command.
The "Create A Shared Folder Wizard" opens.
4. Under step "Name, Description, and Settings," make a note of the Share path, which is a
combination of the computer name and the share name. You will have to specify this
name when you create a link to the network drive on the PCU.
Figure 4-14 Create A Shared Folder Wizard - Name, Description, and Settings
5. Under step "Shared Folder Authorizations," select the "Customize authorizations" radio
button, then click "Custom..."
Figure 4-15 Create a Shared Folder Wizard - Shared Folder Authorizations
The "Customize Authorizations" dialog box opens.
Figure 4-16 "Customize Authorizations" dialog box
6. In section "Group or user names," click "Add..."

The "Select Users, Computers, Service Accounts, or Groups" opens.
Figure 4-17 "Select Users, Computers, Service Accounts, or Groups" dialog box
7. In section "Authorizations for <user name>," under column "Allow," click the "Change"
checkbox.
8. Confirm these settings in the "Customize PermiAuthorizations" dialog box with "OK."
9. In the next steps of the wizard, make all the settings you require and confirm the share
with "Finish".
4.12.6 Release drives C: and D: of the PCU 50.5 in the network for administrator
accounts
You can release local drives (C$, D$) of the PCU 50.5 in the network for administrator
accounts
You can then access these PCU 50.5 drives, for example from a PG/PC in the network if you
use an administrator user account that is available on the PCU 50.5.
Procedure
1. Enter "regedit" in the search field of the registry.
The registration editor opens.
2. Navigate to the following folder in the folder structure:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Syst
em
3. Right-click in the working area and select the "New > DWORD (32-bit) Value" command
in the shortcut menu.
4. In the "Name" field, enter the "LocalAccountTokenFilterPolicy" designation.
5. Double-click the key and enter "1" as "Value".
6. Confirm the input, close the registration editor and restart the PCU 50.5.
Result
The registry entry has been added and the drives are available in the network after the
restart.
However, you cannot change the access rights, i.e. access is only possible via an
administrator account that is known on the PCU 50.5.
To undo the release, delete the created key in the registration editor.
4.12.7 Creating a shortcut to the network drive

To be able to access the shared directory on the PG/PC from the PCU, after you have
connected and configured the PG/PC in the network, you must set up the folder shared on
the PG/PC on the PCU as a network drive.
As soon as it has been set up, a new drive will appear on the PCU, which is really a directory
on the PG/PC.
The basic procedure for setup under Windows 7 and Windows XP is described below.
the Internet: Creating a shortcut to a network drive (association)
(http://windows.microsoft.com/en-us/windows7/create-a-shortcut-to-map-a-network-drive)
Precondition
● The PCU is switched on and the Service Desktop is active.
● The folder on the PG/PC is shared for the relevant user accounts on the domain and on
the PCU.
Procedure
Proceed as follows to connect a shared directory as a network drive:
1. Start the Windows Explorer and click the "Map network drive" button.
2. Make the following settings in the "Map network drive" dialog box:
Settings Purpose
Drive To select drive letters under which the network directories are to be
accessible on the PCU 50.5.
Folder Specify the device in the network and share name of the resource.
Reconnect at Select this check box to automatically connect the network drive on booting.
logon
Connect using Select this check box if you have not shared the directory in the network with
different the user for whom you would like to set up the network drive.
credentials In the next dialog box "Enter Network Password," enter the log-on
information of a user with whom the network directory is shared.
3. Confirm your settings with "Finish."
See also
Microsoft Windows support (http://windows.microsoft.com/en-US/windows/windows-
help#windows=windows-7)
4.13 Starting up the replacement SSD

Information about replacing and installing an SSD on the PCU is provided in the Operator
Components and Networking Manual.
Note
If reading in of the data is interrupted, the PCU will have no executable system.
again.
See also
Restore a disk image of the SSD (Page 95)
5.1 PCU Hardware Diagnostics
Intended use
The PCU hardware supports the diagnostics of important system components via an
integrated "safecard", which is designated as a Safecard-On-Motherboard (SOM).
These diagnostic functions are only evaluated by systems with HMI Advanced. The fault
statuses of the hardware are reported in the form of alarms via the operator interface of HMI
Advanced. This allows for visualization of the data in HMI Advanced and external evaluation.
Monitored Parameters
The following physical parameters of the PCU hardware are monitored:
● CPU temperature
● Housing temperature
● I/O chip temperature
● Speed of the two housing fans
● S.M.A.R.T - status of the hard disk
Logging faults
The PCU hardware monitor logs all hardware faults in the Windows event log so that the
faults can be output even without installing an HMI application.
The alarms are output in the log under "Control Panel" → "Administrative Tools" → "Event
Viewer".
See also
● Auto-Hotspot
● Operator Components and Networking Manual: Chapter, spare parts
● Description of the alarms: SINUMERIK 840D sl Diagnostics Manual
5.2 Evaluation of the 7-segment display
Intended use
The 7-segment display is intended for PCU diagnostics in operation without a local OP
(known as "Headless mode"). If an error is detected during booting, a local display is needed
for subsequent error analysis of the connection.
Figure 5-1 7-segment display with LEDs
The two displays have the following function:

● Segment display H1
Segment display H1 and the associated LED are assigned to the PCU basic software.
Status codes are output during system booting, normal operations and shutdown.
Compatibility in relation to the NCU modules is taken into account.
● Segment display H2
Segment display H2 and the associated LED are assigned to the application software.
Meaning of status codes

● During system power-up:
LED H1 LED H2 7-segment Status

display
Orange Orange Output of After switching on the system
BIOS post
codes
Orange Off After cycling the BIOS
Orange Off After starting Windows
1 0 Start Windows Load device drivers needed for
the Windows start
2 0 PCU hardware service The PCU hardware service has
been started.
5 0 Network Wait for network interfaces to
be ready.
8 0 TCU support test step 1 Wait for FTP server to start
9 0 TCU support test step 2 Wait for boot server to start for
TCU network boot and for TCU
hardware service to start
A 0 TCU support test step 3 Wait for VNC server to start
B 0 HMI manager Wait for HMI manager to start
E 0 PCU base software General fault: see Windows
"Event Viewer"
● During operation:

display
Flashing -- 0 0 OK
green
Flashing red -- Error:
1 0 Temperature alarm Housing or CPU temperature;
temperature above limit value
(SOM error)
2 0 Fan alarm Housing or CPU: Low fan
speed or fan failure (SOM
error)
3 0 Hard disk alarm S.M.A.R.T hard disk error
6 0 Failure of VNC server or VNC
server service stopped
● During shutdown

display
Flashing -- 5 0 Shutdown active
red/green
5.3 Setting of the service switch (PCU 50.5 only)
5.3 Setting of the service switch (PCU 50.5 only)
Intended use
The "PCU Hardware Service" component as part of the PCU Base software provides a
function to read-out the switch positions.
Figure 5-2 Rotary coding switch (hexadecimal)
Meaning of switch positions

Only the settings of the service switch that are relevant for the commissioning engineer are
listed:
Switch setting Mode of operation Function

0 --- Normal operation (default setting)
6 Users Reserved for additional software
9 Service Headless operation without OP/TP
A Service Firmware recovery
C Service Checking
D Service Diagnostics
E Service Booting from the emergency boot system
5.4 Enabling/disabling error log during boot up
5.4 Enabling/disabling error log during boot up
Application
Each time the system is booted up, information is written to a block in the file D:\$$Base.log,
which contains the date, time and nature of administrative interventions.
Information about the booting controlled by the HMI Manager, can be displayed on the
screen and written to log file D:\$$Base.log.
Output in log file

The output is controlled by registry values:
● Type of information
The type of information to be output is set via registry value
“HKLM\SOFTWARE\Siemens\SINUMERIK\Basic software\<version>\HMI
Manager\InfoLevel”:
InfoLevel (DWORD)
= 1: Mandatory information is output (default setting)
= 2: Mandatory and supplementary information is output
= 3: Mandatory, supplementary and trace information is output
(InfoLevel <= 0 is treated as InfoLevel == 1;
InfoLevel <= 3 is treated as InfoLevel == 3)
● Outputting information to the screen

Whether the information is also to be displayed on the screen (as well as being output to
the log file) is set via registry value 'HKLM\SOFTWARE\Siemens\SINUMERIK\Basic
software\<version>\HMI Manager\ShowInfo':
ShowInfo (DWORD)
= 0: Displays the mandatory information,
no display of the supplemental and trace information
= 1: Mandatory, supplementary and trace information is displayed (default)
5.5 How to search for stations within the system network
Intended use
The VNC scanner is used within the system network. The scanner is primarily used to
identify devices containing an active VNC server, e.g. NCU or PCU.
The VNC scanner offers the option of connecting directly to the VNC server and, for
example, operating an HMI application. The integrated VNC viewer is used to do this.
Furthermore, it enables you to call up a list of all the network devices, thereby creating an
overview of the system network.
Note
The VNC scanner is available on the Service Desktop of the PCU and on the PCU base
software DVD for installation on a PG/PC.
You require a mouse to use this program.
Operating "VNC scanner"
1. You can launch the "VNC Scanner" program via this link on the Service Desktop of the
PCU .
Figure 5-3 VNC scanner
2. "IP start / IP end": Set the IP-address browsing range.

Eight ranges can be saved. Click on button " >" to switch to the next range.
3. "VNC" option:
– ON: only search for VNC servers.
– OFF: search all the stations in the network.
1. Start the search with the "Start" button.
The following station parameters will be listed:
– IP address
– MAC address
– Name in the network
– VNC port
– Response time of the station in milliseconds
– Device type
Note
local device #
When the devices are listed, an IP address will be identified with "#" to indicate that
this is the local device on which the VNC scanner will be used.
Figure 5-4 VNC scanner: List of stations
2. By right-clicking a network station from the list, you can execute the following actions via
a pop-up menu:
– "VNC": Connecting directly to the VNC server and, if applicable, operating the HMI.
– "VNC → Auto reconnect": Corresponds to the option "Automatic reconnect if the server
closes the connection" in order to restore the connection to the selected network
station.
– Ping: Opens a command shell and executes the "ping" command to the selected
network station.
Note
Operation via a VNC viewer:
A system can only be monitored from another station via an external VNC viewer
(default).
To view the system from another station, this function must be enabled by the system.
You can find the settings for this in the "System Network Center" or directly in tcu.ini in
the [VNCViewer] section.
Should you wish to access a PCU via the company network using the VNC scanner or
VNC viewer, port 5900 must be added to the PCU under "Control Panel" → "Windows
Firewall" → "Exceptions".
Reference: Operator Components and Networking Manual
Additional Options
1. Use this button to start the VNC viewer.
2. Use the "Option" button to set parameters for the search.
Figure 5-5 VNC scanner: Set search parameters
● VNC scanning algorithm:

Default is "Fast", i.e. device feedback within approximately 100 ms
● Devices detection: (corresponds to the "VNC" option, see point 3).
– "VNC server devices": only search for VNC servers.
– "All devices": search all the stations in the network.
● VNC viewer location:
Link to the VNC viewer (open source program: already pre-installed on the PCU; on a
ServicePC this link must be specified).
● Viewer default connection mode:
"Automatic reconnect if the server closes the connection" (default: OFF)
– OFF: One attempt is made to establish a connection.
– ON (loop mode): For situations where access will be via Internet, for example for
service purposes, then the system will wait longer and try again after several
milliseconds to establish a connection to this station.
● "Reset IP range": All IP address ranges are reset.
● Console log: Opening a console to output a protocol, e.g. for error analysis (default:
OFF).
Options for the VNC viewer
NOTICE
Do not change defaults!
To ensure that the VNC viewer works properly, the following options may not be changed.
After starting the VNC viewer, the following dialog opens:
Figure 5-6 Default: UltraVNC
After clicking the "Options ..." button, the following dialog opens:
Figure 5-7 Default: Connection Options ...
List of Abbreviations A
A.1 Abbreviations
CF CompactFlash card: Memory card

CFS Cluster File System
DCK Direct Control Keys: Direct control keys
DCP Discovery and Basic Configuration Protocol
DHCP Dynamic Host Configuration Protocol: Dynamic assignment of an IP address and other configuration
parameters on a computer in a network
DNS Domain Name System: Conversion of domain names into IP addresses
EBS Emergency Boot System
EKS Electronic Key System: System to check the identity of a user (authentication system)
EUNA End User Notification Administration
HMI Human Machine Interface: Operator interface
IRT Isochronous Realtime (Ethernet)
LLDP Link Layer Discovery Protocol: multi-vendor Layer 2 Protocol defined in accordance with the IEEE-
802.1AB standard, allows information to be exchanged between devices.
MAC Media Access Control: The MAC address is a 48-bit Ethernet ID.
MPI Multi-Point Interface: Multiple interface
MUI Multilanguage User Interface
NCK Numerical Control Kernel: NC kernel with block preparation, travel range, etc.
NRT Non-Realtime (Ethernet)
NTFS New Technology File System
NTP Network Time Protocol: Standard for synchronizing clocks in the entire network
NTPD NTP Daemon:
Utility that runs in the background and does not have to be started by the user.
PCU PC Unit: Computer unit
PDEV Physical device
PLC Programmable Logic Control: Programmable logic controller
RAM Random Access Memory: Program memory which can be read and written into
RDY Ready: The system is ready to operate.
SNMP Simple Network Management Protocol (network protocol for monitoring and controlling network elements
such as routers, servers, switches, and printers from a central station).
SSD Solid State Drive
TFTP Trivial File Transfer Protocol: Very simple data transmission protocol
UDP User Datagram Protocol: NTP is mostly processed via UDP.
List of Abbreviations
A.1 Abbreviations
USB Universal Serial Bus

UPS Uninterruptible power supply
UTC Universal Time, Coordinated: Coordinated universal time
Index
7 E
7-segment display, 122 Emergency Boot System, 105
Enabling the log, 126
Error log, 126
A
Activating the firewall, 9
G
Global Settings, 13
B
Backup time, 69
H
BIOS
Changing default setting, 37, 42 Hard disk
Start setup, 33, 38 Replacing, 120
System parameters, 34, 39
Boot screen
OEM-specific, 53 M
Storage location, 53
Mains-fed operation, 78
Boot stick, 105
Multilingual User Interface (MUI), 84
C N
Changing computer name, 44
Network
Communication
Adapting settings, 74, 76
MPI, 43
Network release
S7DOS, 43
Drive of the PCU 50.5, 118
Configuration file
Driven on PG/PC, 114
basesys.ini, 109
NTFS file system, 7
ghost.ini, 73
servicesystem.ini, 73, 76
Configuring the user interface, 50
P
Partitioning the hard disk, 7
D Password
For network drive, 102
Dialog box
PCU
ServiceCenter Backup/Restore, 73, 76
Checking the hard disk, 121
Disk image
Delivery condition, 5
Redo, 95, 99
Name (default setting), 9
Troubleshooting, 96, 101
Operating system, 9
Domain, 47
PCU operating system, 9
Driver
Port 80 display, (See 7-segment display)
S7DOS, 43
powerline, 43
Index
R
Recovery Media, 84
RESOLUTION (tcu.ini), 30
S
Screen resolution, 30
Select language (MUI), 50
Service Desktop
Background, 54
install, 78
Service switch, 125
Service system for PCU, 105
Shutdown, 124
SIMATIC STEP 7
Installing, 82
Software
Components, 6
install, 77
SSD
Replacing, 120
Starting OEM programs, 60
System boot, 123
T
Troubleshooting
Restore failure, 96, 101
U
USB FlashDrive, 105
User
Change the name, 22
Default, 11
Delete, 22
Inheritance, 19
User group, 11
User type, 11
V
Version software components, 6
VNC scanner, 128
W
Windows language (MUI), 50
Delivery condition 1
First commissioning of the
PCU 50.5 2
First commissioning of
SINUMERIK SIMATIC IPC627D or 3
IPC427D
SINUMERIK 840D sl Configuration of the system 4

PCU Base Software (IM10)
Installing and configuring
updates and automation 5
software
Valid for:
Software:
SINUMERIK PCU-Basesoftware 50.5W7/IPC V11
10/2015
6FC5397-1DP40-5BA3
Legal information
DANGER
WARNING
CAUTION
NOTICE
damage.
Qualified Personnel
Note the following:
WARNING
Trademarks

Postfach 48 48
90026 NÜRNBERG
GERMANY
Table of contents
1 Delivery condition.........................................................................................................................................7
1.1 PCU Base Software Windows 7...............................................................................................7
1.1.1 Overview..................................................................................................................................7
1.1.2 Supplied software.....................................................................................................................8
1.2 Hardware configuration of PCU 50.5.......................................................................................9
1.2.1 Network settings.......................................................................................................................9
1.2.2 Partitioning of the SSD.............................................................................................................9
1.3 Hardware configuration of IPC627D and IPC427D................................................................11
1.3.1 Network settings.....................................................................................................................11
1.3.2 Partitioning of the SSD...........................................................................................................11
1.4 Directory structure and file conventions.................................................................................13
2 First commissioning of the PCU 50.5.........................................................................................................15
2.1 Overview................................................................................................................................15
2.2 Backing up and restoring the delivery condition.....................................................................18
2.3 Install the PCU Base Software attended................................................................................19
2.4 Unattended installation of the PCU Base Software................................................................20
2.4.1 Configuring an answer file......................................................................................................20
2.4.2 Installing the PCU Base Software attended...........................................................................23
3 First commissioning of SIMATIC IPC627D or IPC427D.............................................................................25
3.1 Overview................................................................................................................................25
3.2 Installing the PCU-Basesoftware...........................................................................................26
4 Configuration of the system........................................................................................................................27
4.1 Overview................................................................................................................................27
4.2 Managing user accounts........................................................................................................28
4.3 Changing the name of the PC system...................................................................................29
4.4 Setting the IP address and domain........................................................................................30
4.5 Configuring USB interfaces....................................................................................................31
4.6 Configuring the keyboard layout............................................................................................32
4.7 Setting up an external screen................................................................................................33
4.8 Setting the screen resolution..................................................................................................34
4.9 Set the resolution in the tcu.ini...............................................................................................35
4.10 Setting the color depth in the tcu.ini file.................................................................................39
4.11 Activating/deactivating the multitouch operation of TCUs......................................................40
4.12 Calibrating the touch operation of a screen...........................................................................41

Table of contents
4.13 Configuring the SITOP UPS module for use with the PCU Base Software...........................42
4.13.1 Overview of SITOP UPS........................................................................................................42
4.13.2 SITOP modules for the PCU 50.5..........................................................................................43
4.13.3 Configuring SITOP software for PCU Base Software............................................................43
4.13.4 Parameterizing a delay time for quitting the HMI software.....................................................46
4.13.5 Hardware configuration of the SITOP UPS module...............................................................48
4.14 Configuration of the Service Center.......................................................................................51
4.14.1 Overview................................................................................................................................51
4.14.2 Configuration of the network adapter.....................................................................................52
4.14.3 Configuration of the host........................................................................................................53
4.15 Adapting the firewall settings.................................................................................................55
4.15.1 Overview................................................................................................................................55
4.15.2 Factory setting of the Windows Firewall on the Siemens PC system....................................56
4.15.3 General information on the operating principle of the Windows Firewall...............................57
4.15.4 General information on the settings recommended for Windows..........................................58
4.15.5 Configuration by means of a prompt or script/batch file.........................................................58
4.15.6 Enabling SNMP communication.............................................................................................59
4.15.7 Activate the remote access to the PC system........................................................................61
4.15.7.1 Overview................................................................................................................................61
4.15.7.2 Via the Control Panel.............................................................................................................61
4.15.7.3 By prompt, script or batch file.................................................................................................62
4.15.8 Activation/deactivation of the file and printer release.............................................................64
4.15.8.1 Overview................................................................................................................................64
4.15.8.2 General information................................................................................................................65
4.15.8.3 General activation for all network profiles..............................................................................66
4.15.8.4 Activation for a specific network profile..................................................................................69
4.15.8.5 Activation for a specific connection........................................................................................74
4.15.9 Activation of the ping execution (ICMP).................................................................................76
4.15.9.1 Via the Control Panel.............................................................................................................76
4.15.9.2 By prompt, script or batch file.................................................................................................77
4.15.10 Saving and restoring firewall settings.....................................................................................79
4.15.10.1 Overview................................................................................................................................79
4.15.10.2 Backup of firewall settings......................................................................................................79
4.15.10.3 Restoring of firewall settings..................................................................................................81
5 Installing and configuring updates and automation software......................................................................83
5.1 Overview................................................................................................................................83
5.2 Patch management and security updates..............................................................................84
5.3 Setting up SINUMERIK Operate for autologon mode............................................................85
5.4 Modifying the user account for autologon mode....................................................................87
5.5 Configuring a key filter for HMI software................................................................................89
5.6 Installing STEP 7....................................................................................................................93
5.7 Linking the HMI software with STEP 7...................................................................................94
5.8 PCU Installer..........................................................................................................................95
5.8.1 Overview................................................................................................................................95
5.8.2 Activating the PCU Installer...................................................................................................95
5.8.2.1 Overview................................................................................................................................95

Table of contents
5.8.2.2 Activating via a configuration template...................................................................................96

5.8.3 Deactivating the PCU Installer...............................................................................................97
5.8.4 Copying and adapting the configuration file...........................................................................98
5.8.5 Reference to the PCUInst.ini configuration file......................................................................99
5.8.6 Example configuration: Installation behavior as for PCU base software Windows XP.... ....103
5.8.7 Installing software with the PCU Installer.............................................................................103
5.8.8 Procedure example of an installation with the PCU Installer...............................................104
5.8.9 Log files (.log).......................................................................................................................105
5.9 Migration..............................................................................................................................106
6 Backing up and restoring data..................................................................................................................107
6.1 Overview..............................................................................................................................107
6.2 Starting the Service Center..................................................................................................108
6.3 Functions of the Service Center...........................................................................................109
6.4 Network settings in the Service Center................................................................................111
6.5 Create a disk image of the SSD...........................................................................................114
6.6 Restore a disk image of the SSD.........................................................................................116
6.7 Create a disk image of a partition........................................................................................118
6.8 Restore a disk image of a partition.......................................................................................120
6.9 Network settings in the Service Center................................................................................123
6.10 Starting Symantec Ghost directly.........................................................................................125
6.11 Bootable USB flash drive.....................................................................................................126
6.12 Operating a service PC/PC in the network...........................................................................127
6.12.1 Overview..............................................................................................................................127
6.12.2 Connection options in the system network...........................................................................127
6.12.3 Configuring routing in the network.......................................................................................129
6.12.4 Configure the network settings of the PG/PC......................................................................131
6.12.5 Release directory of the PC/PC in the network....................................................................134
6.12.6 Creating a shortcut to the network drive..............................................................................137
6.13 Starting up the replacement SSD.........................................................................................139
7 Service and diagnostics............................................................................................................................141
7.1 PCU Hardware Diagnostics.................................................................................................141
7.2 Evaluation of the diagnostic displays H1/H2........................................................................142
7.3 Setting of the operating mode during run-up........................................................................144
7.3.1 Service switch (PCU 50.5)...................................................................................................144
7.3.2 Possible operating modes....................................................................................................145
7.3.3 Software-side setting (SIMATIC IPC)...................................................................................145
7.4 Switching to the Service Desktop during autostart / autologon operation............................146
7.5 Remote access....................................................................................................................148
7.5.1 Overview..............................................................................................................................148
7.5.2 Searching for devices in the system network.......................................................................148
7.5.3 Display of accessible stations in SINUMERIK Operate.......................................................148
7.5.4 Remote access to the PCU for operation and maintenance................................................149

Table of contents
7.5.5 Setting up and using SSH....................................................................................................151

7.5.6 Encryption via SSH protocol................................................................................................152
Index.........................................................................................................................................................155

Delivery condition 1
1.1 PCU Base Software Windows 7
1.1.1 Overview
The PCU-Basesoftware 50.5W7/IPC provides the basis for operating SINUMERIK software
(e.g. SINUMERIK Operate) on your SIEMENS PC system:
● SINUMERIK PCU 50.5

The PCU-Basesoftware is included in the PCU 50.5 scope of delivery and preinstalled.
However, for security reasons, the final installation and setup of user accounts must be
performed during the first startup.
An example flow diagram for initial startup is provided as an overview in Chapter Over‐
view (Page 15). This overview assumes that the PCU 50.5 is already installed and net‐
worked.
Information about the hardware configuration, installation, and networking of the PCU 50.5
is provided in the SINUMERIK 840D sl Operator Components and Networking Manual,
Chapter Operator panels.
● SIMATIC IPC (only in the following configurations)

The industrial PCs SIMATIC IPC627D and IPC427D are compatible with the PCU-Base‐
software in the following configurations:
● SIMATIC IPC627D configurations with article number 6AG4140-6.H17-0HA0:
– DIN rail mounting: 6AG4140-6BH17-0HA0
– Wall mounting: 6AG4140-6DH17-0HA0
– Vertical mounting: 6AG4140-6EH17-0HA0
● SIMATIC IPC427D configurations with article number 6AG4140-0.C07-0HA0:
– DIN rail mounting: 6AG4140-0BC07-0HA0
– Wall mounting: 6AG4140-0DC07-0HA0
– Vertical mounting: 6AG4140-0EC07-0HA0
For these SIMATIC IPC configurations, you can order the SINUMERIK PCU-Basesoftware/
IPC separately under the following article number:
● 6FC5800-0AP86-0YB0
Other or unnamed SIMATIC IPC configurations or PC systems are not compatible with the
PCU-Basesoftware.
You can find an example sequence for commissioning and configuration under Overview
(Page 25).
You can find all of the information on the hardware in the corresponding documentation:
SIMATIC IPC627D operating instructions or SIMATIC IPC427D operating instructions.

Delivery condition
1.1 PCU Base Software Windows 7
Note
Do not switch off SIEMENS PC systems with Windows 7 on the hardware!
Loss of data may result on Windows-based systems if the system is not shut down properly
before it is disconnected from the power source. For technical reasons, data is still being written
to the SSD shortly after shutdown.
To avoid loss of data, use a SITOP UPS module.
See Configuring the SITOP UPS module for use with the PCU Base Software (Page 42).
1.1.2 Supplied software
Overview
The SINUMERIK PCU-Basesoftware contains the following software and tools:
Software Function
Microsoft Windows 7 Service Desktop
Microsoft Windows PE Service Center
Symantec Ghost Creating and restoring disk images
SIEMENS PCU Installer Installing software and updates
VNC Viewer Remote access to other devices from the PCU
PuTTy Remote access to other devices from the PCU
PuTTy Key Generator Generating an SSH key pair
Various configuration templates and scripts in the directory: Templates for simplifying configuration
C:\ProgramData\Siemens\MotionControl\SIEMENS
Note
Acknowledgements
● This product includes cryptographic software written by Eric Young ([email protected])
● This product includes software developed by the OpenSSL Project for use in the OpenSSL
Toolkit. (http://www.openssl.org/)

Delivery condition
1.2 Hardware configuration of PCU 50.5
1.2.1 Network settings

The PCU 50.5 has two Ethernet interfaces with default settings suitable to connect to
SINUMERIK solution line:
3&8
; ;
Figure 1-1 Ethernet interfaces of the PCU
Hard‐ Designation in Configuration

ware PCU-Base‐
desig‐ software
nations
X1 Local Area Preset as a DHCP client for connection to a company network.
Connection 2 The IP address is dynamically fetched from the DHCP server at X1.
X2 Local Area Preset as a SINUMERIK DHCP server for connection to a system network.
Connection A fixed IP address is preset at X2: If 192.168.214.241 is free in the system
network, it is set.
Otherwise you can view the allocated fixed IP address in the Control Panel.
Further information
● Manual SINUMERIK 840D sl Operator Components and Networking
● Setting the IP address and domain (Page 30)
● Adapting the firewall settings (Page 55)
● Remote access (Page 148)
● Network settings in the Service Center (Page 111)
1.2.2 Partitioning of the SSD

The PCU 50.5 has a SSD with 80 GB storage capacity. The SSD is already partitioned and
pre-assigned by the PCU base software as follows:
Name System (C:) Data (D:)

File system NTFS NTFS
Storage capacity 40 GB Approx. 40 GB
Free capacity 20 GB Approx. 40 GB

Delivery condition
Already occupied by ● Microsoft Windows 7 -

● PCU Base Software incl. various
applications and configuration
templates (see Chapter Supplied
software (Page 8))
Application Installing user programs ● Customer-specific data
● Backup images
● Setup packages

Delivery condition
1.3 Hardware configuration of IPC627D and IPC427D
1.3.1 Network settings

Both the IPC627D and the IPC427D have two Ethernet interfaces, which are set by the PCU-
Basesoftware for the connection with the SINUMERIK solution line.
Table 1-1 SIMATIC IPC427D or IPC627D
Hard‐ Designation in Configuration

ware PCU-Base‐
desig‐ software
nations
X1 Local Area Preset as a DHCP client for connection to a company network.
Connection 2 The IP address is dynamically fetched from the DHCP server at X1.
X2 Local Area Preset as a SINUMERIK DHCP server for connection to a system network.
Connection A fixed IP address is preset at X2: If 192.168.214.241 is free in the system
network, it is set.
Otherwise you can view the allocated fixed IP address in the Control Panel.
Further information
● SIMATIC IPC627 operating instructions
● SIMATIC IPC427 operating instructions
● Setting the IP address and domain (Page 30)
● Adapting the firewall settings (Page 55)
● Remote access (Page 148)
● Network settings in the Service Center (Page 111)
1.3.2 Partitioning of the SSD

The partitioning of the SSD of your SIMATIC IPC627D or IPC427D is not changed by the
installation of the PCU-Basesoftware. Partition C: must have a minimum size of 30 GB to be
able to install the PCU-Basesoftware.
Name of the partition System (C:) Data (D:)

File system NTFS NTFS
Memory used by the system ~ 20 GB ~ 0 GB

Delivery condition
Already occupied by ● Microsoft Windows 7 -

● PCU-Basesoftware incl.
various applications and
configuration templates (see
Chapter Supplied software
(Page 8))
Application Installing user programs ● Customer-specific data
● Backup images
● Setup packages

Delivery condition
1.4 Directory structure and file conventions
Templates for configuration files

To assist you with the parameterization of the system, templates for various configuration files
are provided on the Siemens PC system. The templates are organized into various directories,
which you will find below the following directory:
● C:\ProgramData\Siemens\MotionControl\siemens
These templates are already fully functional when supplied and will be used automatically if
you do not create your own configuration files based on these templates.
Note
Do not modify files in the template directory siemens!
The siemens directory contains only files with the factory settings that can be copied and
used as templates.
Never overwrite these files. Instead copy them into another directory (see Section Your
settings).
Directory hidden in delivery condition

For security reasons, the C:\ProgramData directory is hidden in the delivery condition.
To view the directory, proceed in one of the following ways:
● To switch quickly to a hidden directory, type the address in the Windows Explorer.
● To show all hidden directories by default, change the setting in the Control Panel under
"Appearance and Personalization > Folder Options > View > Advanced Settings".
● To show only one directory by default, first make the setting to show all hidden directories,
then activate the attribute "Hidden" in the properties of the directory and finally again make
the setting to not show all hidden directories.
Your settings
Several directories are available into which you can copy and adapt configuration files in order
to make your own settings. In decreasing order of priority, these are:
● C:\ProgramData\Siemens\MotionControl\user\
● C:\ProgramData\Siemens\MotionControl\oem\
● C:\ProgramData\Siemens\MotionControl\addon\
The settings in a configuration file in a directory with higher priority always replace those from
one of lower priority. Template directory siemens has the lowest priority.
To define your own settings, therefore, copy a setting from the relevant template file into a
directory with higher priority, e.g. below directory user.

Delivery condition

First commissioning of the PCU 50.5 2
2.1 Overview
Once you have installed and networked the PCU 50.5, you must set up a Windows
administrator account before the PCU 50.5 can be accessed from a remote TCU. In headless
mode, therefore make the configuration in a response file (unattend.xml) before switching on
the PCU 50.5 for the first time.
The diagram shows a sample workflow for the first commissioning. Further information is
provided in the accompanying legend tables.
Note
Do not switch off the PCU 50.5 Windows 7 hardware!

First commissioning of the PCU 50.5
2.1 Overview
Example workflow
6HWXS3&8

%DFNXSGHOLYHU\
VWDWH

+HDGOHVV
1R
PRGH
LQWHQGHG"

<HV
&RQILJXUH &RQQHFWVFUHHQ
UHVSRQVHILOH

,QVHUW86%IODVKGULYH
ZLWKUHVSRQVHILOH 1R
$WWHQGHGLQVWDOODWLRQ
SRVVLEOH"

<HV
6ZLWFKRQ3&8 6ZLWFKRQ3&8

&RQQHFW3*3& ,QVWDOO:LQGRZV
DWWHQGHG

Figure 2-1 Example sequence of first commissioning
No. Step Description

1 Set up PCU Information about installation and mounting of the PCU 50.5 is provided in the SINUMER‐
IK 840D sl Operator Components and Networking Manual, Chapter Operator panels.
2 Back up delivery state Before starting the actual first commissioning, you can back up the delivery condition of
the Windows 7 PCU base software as disk image (Page 18).
3 ● Headless mode intended? As soon as you start with the first commissioning of the PCU base software, you must
– Configure response file decide on an installation type:
– Insert USB flash drive with ● Configure a response file and complete installation and user settings unattended
response file (Page 20).
● Attended installation possible? ● Connect screen (Page 33) and complete installation attended (Page 19), at the same
time set up users.
– Connect screen
– Install Windows 7 attended
4 Switch on PCU Do not switch on the PCU without the response file (Page 20) if you want the installation
to be performed unattended.
5 Connect PG/PC To be able to access a directory of a PG/PC in the network, for example, connect the PG/
PC in the network (Page 127).

2.1 Overview
&RQILJXUHQHWZRUN
VHWWLQJVRQ3*3&

6HWXSIXUWKHUXVHU
DFFRXQWV

,QVWDOOVRIWZDUHDQG
XSGDWHV

&RQILJXUHWKHV\VWHP
&UHDWHDGLVNLPDJH
EDFNXS

)LUVWFRPPLVVLRQLQJ
FRPSOHWHG
Figure 2-2 Example sequence of first commissioning (continued)
No. Step Description

6 Configure network settings on PG/PC Once you have networked the PCU, a PG/PC and any other devices with one another,
configure the network settings of your PG/PC (Page 127).
7 Set up further user accounts Before you install software, at least one user account with limited rights must be set up
(Page 28).
8 Install software and updates Install necessary automation software and Windows updates (Page 83).
9 Configure the system Configure the installed software (Page 83), Windows 7 and other system properties
(Page 27) and, if necessary, the SITOP UPS module (Page 42).
10 Create a disk image (backup). Create a disk image of the SSD as a backup (Page 107) to be able to return to this version
in a maintenance situation.

2.2 Backing up and restoring the delivery condition
2.2 Backing up and restoring the delivery condition

Before starting the actual first commissioning, you can backup the delivery condition of the
PCU base software.
Requirement
The first commissioning of the PCU 50.5 (with "unattend.xml" response file or attended) has
not been performed yet.
Procedure
To back up the delivery condition of the PCU base software, proceed as follows:
1. Start the Service Center directly after switching on the PCU 50.5 the first time, e.g. via the
Windows boot menu.
Starting the Service Center (Page 108)
2. Back up the entire C: partition as disk image at another location, e.g. at D:
\DeliveryState_PCU-Basesoftware\
Result
The delivery condition is stored as disk image at the selected location. If required, you can
move this disk image to another location later.
First create a bootable USB flash drive (Page 126) with which you can restore this disk
image (Page 120).
After you have restored the delivery condition of a PCU 50.5 with a disk image, the first
commissioning starts at the initial startup with response file or attended.
Further information
● Backing up and restoring data (Page 107)
● First commissioning of the PCU 50.5 (Page 15)

2.3 Install the PCU Base Software attended
2.3 Install the PCU Base Software attended

If you have connected to the PCU 50.5 directly to the operator panel front or screen, you can
complete installation of the PCU Base Software and Windows 7 attended. For this, user entries
are required during installation in order to set up the Windows administrator account, for
example.
Alternately, you can use unattended installation (Page 20) in which case you define the
necessary user entries in an answer file (unattend.xml) before switching on the PCU 50.5.
Precondition
You can connect an operator panel front or screen and keyboard directly to the PCU 50.5.
Procedure
To perform attended installation of the PCU Base Software, proceed as follows:
1. Switch on the PCU 50.5.
The installation wizard guides you through the necessary steps.
2. During installation, create a Windows administrator account. You can create additional user
accounts in the Control Panel later. See also: Managing user accounts (Page 28).
3. Complete installation.
Result
Installation of the PCU Base Software with Windows 7 is performed. After attended installation,
you must activate the PCU Installer manually (Page 95).

2.4 Unattended installation of the PCU Base Software

You can also install the PCU Base Software unattended.
Use this procedure in the following cases:
● If you are operating a PCU as a headless system (without screen and input devices)
● If you want to start up several PCUs with identical settings
To start unattended installation (Page 23), during initial startup use a USB flash drive with
answer file "unattend.xml" in its root directory. You preliminarily define the settings that you
would normally have to make as user entries during installation in this answer file.
See also
Microsoft TechNet - Methods for performing Windows setup (http://technet.microsoft.com/en-
us/library/dd744269.aspx)
2.4.1 Configuring an answer file
Overview
The PCU-Basesoftware, Windows 7, is pre-installed on your PCU 50.5, but for security
reasons, final installation and the setting up of user accounts must be performed during initial
startup.
Configuration using the unattend.xml response file

A response file (unattend.xml) allows Microsoft Windows to be installed unattended. In this
file, you define the settings in advance, which you must normally enter as user data during
installation. Before you switch on the PCU for the first time, copy your adapted unattend.xml
into the root directory of a USB flash drive and connect this to the PCU 50.5.
Unattended installation is required in the following cases:
● If you are operating a PCU as a headless system (without screen and input devices)
● If you want to start up several PCUs with identical settings
Obligatory settings
You preliminarily define the settings that you would normally have to make as user entries
during installation in unattend.xml. You must enter at least the following information:
● Name of the administrator account
● Password of the administrator account
● Password hint
● Confirmation of the EULA

Execute the command line commands unattended

The unattend.xml response file with the element /FirstLogonCommands/
SynchronousCommand provides you with the option to automatically execute commands
unattended when Windows first runs up. However, to do this, you must also activate the
autologon mode with the administrator account.
You can define as many FirstLogonCommands as required. You define the sequence in which
the commands are executed in the element /FirstLogonCommands/SynchronousCommand/
Order
In the response file used as example, two different command line commands are executed
with FirstLogonCommands/SynchronousCommand:
● Directory D:\Install released for the administrator account
● Activate the PCU Installer using the response file
Sample response file

Because settings are always user-specific, only a sample response file can be provided as an
example:
● Sample answer file for PCU 50.5 Windows 7 in the Service&Support Portal (http://
support.automation.siemens.com/WW/view/en/69154062)
Adapt this file to your requirements.
Table 2-1 Mandatory and recommended settings in response file "unattend.xml"

Path in the Purpose Example
XML data structure
unattend/ Modify the user account for the autologon <AutoLogon>
settings/ mode (optional). <Password>
If you want to automatically execute com‐ <Value>SUNRISE</Value>
component/
mand line commands </Password>
AutoLogon <Enabled>true</Enabled>
(FirstLogonCommands) after the unat‐
tended installation of Windows, activate the <Username>auduser</Username>
autologon mode in the unattend.xml. </AutoLogon>
Enter the password and user name of an

administrator account that you also want to
create with this response file.
FirstLogonCommands are only automat‐
ically executed when the administrator ac‐
count is active.
unattend/ Settings for Windows update <ProtectYourPC>1</ProtectYourPC>
settings/ Set the value 1 to ensure that important
component/ and recommended Windows updates are
automatically installed.
OOBE/
ProtectYourPC
unattend/ Setting the network type and network iden‐ <NetworkLocation>Other</NetworkLocation>
settings/ tifier
component/ Set the value Other.
OOBE/
NetworkLocation

Path in the Purpose Example

XML data structure
unattend/ Confirm EULA (obligatory)
settings/ Set the value to true to automatically con‐ <HideEULAPage>true</HideEULAPage>
component/ firm EULA.
OOBE/
HideEULAPage
unattend/ Create the administrator account (obliga‐
<LocalAccount wcm:action="add">
settings/ tory) <Name>auduser</Name>
Enter a user name in the Name element, <DisplayName>auduser</DisplayName>
component/ <Description>First admin account</
and a secure password in the Password/
UserAccounts/ Description>
Value element.
LocalAccounts/ <Group>Administrators</Group>
Specify the administrator status in the <Password>
LocalAccount Group element. <Value>SUNRISE</Value>
The DisplayName and Description el‐ <PlainText>true</PlainText>
ements are optional. </Password>
</LocalAccount>
In order to create additional user accounts,
insert the complete LocalAccount sec‐
tion a second time and there, change the
values of Name, Password/Value and, if
required, Group.
unattend/ Activate PCU Installer (optional) <SynchronousCommand wcm:action="add">
settings/ In order that the PCU-Basesoftware com‐ <CommandLine>"C:\Program Files (x86)\Siemens
ponent PCU Installer searches for setup \MotionControl\Siemens\System\etc
component/ \write_ini_entry.exe" "C:\ProgramData\Siemens
files directly after logging on, add this com‐
FirstLogonCommands/ mand. \MotionControl\user\System\etc\PCUInst.ini"
SynchronousCommand processing_loginphase StartState activated ENH</
As result, a setting is made in the ini file of CommandLine>
the PCU Installer. <Description>Set PCU Installer to start at user
So that you can store setup files in the D: login</Description>
\Install default installation directory, <Order>1</Order>
you must release this for the administrator </SynchronousCommand>
account in the unattend.xml (see
above).
For further information, see Chapter PCU

Installer (Page 95).
unattend/ Release the default installation directory <SynchronousCommand wcm:action="add">
settings/ (optional) <CommandLine>net share Install=D:\Install /
Use this sample code to release directory GRANT:auduser,FULL /REMARK:Installshare</
component/ CommandLine>
D:\Install for the administrator code.
FirstLogonCommands/ <Description>Share the local built-in
The sample code sets the access rights for installation folder</Description>
SynchronousCommand D:\Install to FULL (read and write ac‐ <Order>2</Order>
cess) for the "auduser" user account. In‐ </SynchronousCommand>
stead of "auduser", enter the name of your
administrator account.
Optionally, you can configure additional settings such as additional user accounts or network
settings.

Further information
You will find information about all options for adapting unattend.xml on the Microsoft website.
● Microsoft TechNet - Methods for performing Windows setup (http://technet.microsoft.com/
en-us/library/dd744269.aspx)
● Microsoft TechNet - Unattended Windows Setup Reference (http://technet.microsoft.com/
en-us/library/ff699026.aspx)
2.4.2 Installing the PCU Base Software attended

If you want to operate a PCU as a headless system or start up several PCUs with identical
settings, use unattended installation.
Requirement
● The PCU is in the delivery condition and switched off.
● In BIOS, the startup of the USB interfaces is deactivated.
In the PCU50.5, it is deactivated via a factory setting.
● A USB flash drive is available (e.g. SIMATIC PC USB-FlashDrive).
The USB flash drive must not use encryption, or it must be deactivated.
● The "unattend.xml" response file has been adjusted to your settings and at least one
administrator account with password is defined.
See: Configuring an answer file (Page 20).
Procedure
Proceed as follows to start unattended installation:
1. Copy your adjusted "unattend.xml" response file directly into the root directory of the USB
flash drive.
2. Connect the USB flash drive to the PCU.
3. Switch on the PCU.
Result
The first startup is performed as an unattended installation, using the settings that you specified
in the response file.


First commissioning of SIMATIC IPC627D or IPC427D 3
3.1 Overview
After you have completed the first commissioning of yoursupported SIMATIC IPC
configuration (Page 7) with the PCU-Basesoftware, you can configure the SIMATIC IPC like
a SINUMERIK PCU.
You can find an example sequence of the first commissioning and configuration in this tabular
overview.
Note
Do not switch off SIEMENS PC systems with Windows 7 on the hardware!
Example workflow
No Step Description
.
1 Set up and commissioning Information on setting up and installing your SIEMENS PC system can be found in the corresponding
of the PC system (according hardware documentation:
to the operating instructions) ● SIMATIC IPC627D operating instructions
● SIMATIC IPC427D operating instructions

2 Installing the PCU-Basesoft‐ Installing the PCU-Basesoftware (Page 26).
ware
3 Connect PG/PC To be able to access a directory of a PG/PC in the network, for example, connect the PG/PC in the
network (Page 127).
4 Configure network settings Once you have networked the PC system, a PG/PC and any other devices with one another, configure
on PG/PC the network settings of your PG/PC (Page 127).
5 Set up further user accounts Before you install software, at least one user account with limited rights must be set up (Page 28).
6 Install software and updates Install necessary automation software and Windows updates (Page 83).
7 Configure the system Configure the installed software (Page 83), Windows 7 and other system characteristics (Page 27) and,
if necessary, the SITOP UPS module (Page 42).
8 Create a disk image (back‐ Create a disk image of the SSD as a backup (Page 107) to be able to return to this version in a mainte‐
up). nance situation.

First commissioning of SIMATIC IPC627D or IPC427D
3.2 Installing the PCU-Basesoftware
3.2 Installing the PCU-Basesoftware

You can install the SINUMERIK PCU-Basesoftware/IPC on the supported SIMATIC IPC
configurations (Page 7) (by means of an installation medium that can be ordered and licensed
individually).
In the Industry Mall you can find the SINUMERIK PCU-Basesoftware/IPC under the following
article number:
● 6FC5800-0AP86-0YB0
Precondition
● You can connect an operator panel front or screen and keyboard directly to the PC system.
● The commissioning of the PC system (IPC627D or IPC427D) is completed and an
administrator account is set up.
● The PC system is switched off.
● The partition C: of the PC system has a minimum size of 30 GB.
● The installation medium is available on the PC system.
Procedure
To install the PCU-Basesoftware on your PC system, proceed as follows:
1. Open Windows Explorer and switch to the installation medium of the PCU-Basesoftware.
2. Double-click the file "setup.exe".
3. Restart the PC system after you have installed the PCU-Basesoftware.
Result
The SINUMERIK PCU-Basesoftware has been installed. During this, the previously existing
settings on the SIEMENS PC system, e.g. user accounts, keyboard layout, date and time
settings, were imported. Set up additional user accounts (Page 28) if necessary and set the
keyboard layout to English (Page 32).
The PCU Installer is at first disabled after the installation. It must be enabled (Page 95) before
software can be automatically installed.

Configuration of the system 4
4.1 Overview
Once you have completed the first commissioning, you can adapt the configuration of the
system:
● For security reasons, set up user accounts (Page 28) with limited rights, e.g. for auto logon
mode.
● You can view or change (Page 29) the name of the PC system.
● The network settings (Page 30) in the delivery condition have been adapted for use with
SINUMERIK solution line and usually do not have to be changed.
● You can deactivate the USB interfaces (Page 31) to prevent malicious software from
entering the system network via this route.
● You can set up an external screen (Page 33) or set the screen resolution (Page 34) and
color depth (Page 39).
● If you use a SITOP UPS module for the uninterruptible power supply or plan to use one,
configure it for use with the PCU base software (Page 42).
Other configuration options (e.g. Desktop background) are available directly from the Service
Desktop and can be implemented by the known Windows 7 methods:
● To call up the Windows help, click "Help and Support" in the Start menu.
● You will find help for Windows 7 in the Internet on the Microsoft website: Microsoft Windows
support (http://windows.microsoft.com/en-US/windows/windows-

Configuration of the system
4.2 Managing user accounts
4.2 Managing user accounts
Overview
During initial commissioning, you must create a local Windows administrator account and
define a password.
You can set up and manage additional Windows user accounts in the Control Panel. To do
that, log on with administrator rights.
Note
Administrator account cannot be recovered
If you have forgotten the password of the administrator account there is no way of recovering
it!
However, after initial commissioning, you can create a file with which you can later assign a
new password. To do that, in the Control Panel under user accounts use the "Create a
password reset disc" command.
See also: Microsoft Windows support - creating a password reset disk (http://
windows.microsoft.com/en-US/windows7/Create-a-password-reset-disk)
Further information about user administration under Windows 7

You will find information about user administration under Windows 7 in the Windows help.

4.3 Changing the name of the PC system
4.3 Changing the name of the PC system

A unique computer name must be set after installation of the PCU base software. You can
view and change it in the Control Panel of the Service Desktop.
You will find the computer name in the Control Panel under Category "System and Security",
Section "Computer name, domain, and workgroup settings",

4.4 Setting the IP address and domain
4.4 Setting the IP address and domain

The network settings in the delivery condition have been adapted for use with SINUMERIK
solution line and usually do not have to be changed.
See also: Network settings (Page 9)
If you want to distinguish your network configuration from the factory settings, you can adapt
them in the Windows Control Panel.
You will find these settings in the following menu:
● "Start > Control Panel > Network and Sharing Center > View network connections"
Further information
You can adapt the network settings for backing up and restoring disk images in the
configuration of the Service Center (Page 51).
You will find information about network settings under Windows 7 in the Windows help.

4.5 Configuring USB interfaces
4.5 Configuring USB interfaces

The USB interfaces are activated in the as-delivered state of the PC system.
To prevent malicious software from entering the control or the system network via the USB
interfaces, you can deactivate the USB interfaces.
You can configure the USB interfaces on the Service Desktop via a command in the "Run"
dialog box or at the prompt.
Procedure
To activate or deactivate the USB interfaces, enter the relevant command on the Service
Desktop in the "Run" dialog box or at the prompt:
Table 4-1 Disabling USB interfaces with the "sc_usb disable" command
Factory setting: The USB interfaces are enabled in the delivery condition.
Syntax: sc_usb disable [-minutes] [all] [HOSTS...]
Description: ● Without a time indication [-minutes], a permanent disable is set.
With time indication, the disable takes the time set in minutes.
● The disable may refer to all network nodes of the system network,
or a list of host names or IP addresses may be specified to which
the disable should apply.
Table 4-2 Activating USB interfaces with the "sc_usb enable" command
Factory setting: The USB interfaces are enabled in the delivery condition.
Syntax: sc_usb enable
Description: With "sc_usb enable" USB storage units on permanently disabled
USB interfaces or on certain host names or IP addresses are ena‐
bled again.
Further information
You can find general information about a prompt on the Microsoft website.
● Prompt: Frequently asked questions (windows.microsoft.com/en-us/windows/command-
prompt-faq)

4.6 Configuring the keyboard layout
4.6 Configuring the keyboard layout

It is assumed that the English keyboard layout is used in SINUMERIK Operate and for the
SINUMERIK operator panel fronts.
If a different keyboard layout is set in Windows, this should therefore be changed before
commissioning the SIEMENS PC system or before using SINUMERIK Operate.
The setting of the keyboard layout as well as the display of the active keyboard layout is shown
in the Windows task bar.
Further information is available at: Microsoft Windows support: Language bar (overview) (http://
windows.microsoft.com/en-us/windows/language-bar-overview#1TC=windows-7)

4.7 Setting up an external screen
4.7 Setting up an external screen

You can connect an external screen to the Siemens PC system. The procedure follows the
usual procedure under Windows 7.
Requirements
● The PC system is switched off.
● The external screen is connected to the DVI interface of the PC system (with an adapter,
if necessary).
Procedure
To use an external screen for the Service Desktop or service system, proceed as follows:
1. Let the PC system boot in the Service desktop.
2. Right-click on the Desktop, then select "Screen Resolution" from the shortcut menu.
3. In the "Screen Resolution" dialog box, select the screen and set the resolution:
– If you are using an LCD or LED screen, you should ideally set the native resolution of
your screen.
– If you are using an older CRT screen, you can select any resolution.
4. Click "OK" to confirm the settings.
Result
The external screen has been connected and can be used.

4.8 Setting the screen resolution
4.8 Setting the screen resolution

You can set the screen resolution directly in Windows 7 or use the PCU base software specific
file tcu.ini
The settings in tcu.ini overwrite the Windows system settings. Compared with Windows, they
offer additional functions for switching over the resolution of the PC system depending on, for
example, the screen connected during run-up.
● Information about the configuration file tcu.ini is provided in the following chapter
(Page 35).
● Information for setting the screen resolution under Windows 7 is provided on the Microsoft
website: Changing the screen resolution (http://windows.microsoft.com/en-us/windows7/
change-your-screen-resolution)

4.9 Set the resolution in the tcu.ini
Overview
The system behavior during run-up for the screen resolution is set in the tcu.ini file in
Section [VNCServer].
You will find a template of the tcu.ini under C:\ProgramData\Siemens\Motion
Control\siemens\System\etc\
Do not overwrite this template, but rather create your own tcu.ini inside one of the user
directories (see Chapter Directory structure and file conventions (Page 13)).
Further information
● Chapter Directory structure and file conventions (Page 13).
● Operator Components Manual, Chapter "Networking"
Setting the resolution during power up of the PC system

The following options are available for selection in the tcu.ini file in the [VNCServer] section
(below the # RESOLUTION comment):
0 = SYSTEM
1 = AUTO_OP_1 (default)
2 = AUTO_OP_2
3 = AUTO_MON_1
4 = AUTO_MON_2
5 = 640x480
6 = 800x600
7 = 1024x768
8 = 1280x1024
9 = 800x480
10 = 1280x800
11 = 1366x768
12 = 1920x1080

The meaning of the settings are as follows:
Table 4-3 Settings in the configuration file tcu.ini
Settings Meaning
SYSTEM The resolution is not specially set during run-up. i.e. the resolution last used
in the system is active, e.g. the resolution which had been set manually in
the Control Panel.
AUTO_OP_1 Default setting:
During run-up, the resolution is automatically set ("PCU panel" has priority)
Example 1: There is a PCU panel (irrespective of whether there is a PCU monitor and
TCU panels):
[In active TCU mode:
(max. 1920x1080).
Example 2: There is no PCU panel, however there is a PCU monitor (irrespective of
The resolution is not specially set; i.e. the resolution last used in the system
is active, e.g. the resolution which had been set manually in the Control Panel.
(Different to AUTO_OP_2 !)
AUTO_OP_2 Like AUTO_OP_1, except:
Example 2: There is no PCU panel, however there is a PCU monitor (irre‐
spective of whether there are any TCU panels):
640x480, 800x600, 1024x768, 1280x1024, 800x480, 1280x800, 1366x768
and 1920x1080.
AUTO_MON_1 During run-up, the resolution is automatically set ("PCU monitor" has priority)

Settings Meaning
Example 1: There is a PCU monitor (irrespective of whether there is a PCU panel and
TCU panels):
640x480, 800x600, 1024x768, 1280x1024, 800x480, 1280x800, 1366x768
and 1920x1080.
If there is a PCU panel, the display there is panned if the max. resolution of
the PCU panel is lower than the max. resolution of the PCU monitor.
Example 2: There is no PCU monitor, however there is a PCU panel (irrespective of
The resolution is not specially set; i.e. the resolution last used in the system
is active, e.g. the resolution which had been set manually in the Control Panel.
(Different to AUTO_MON_2 !)
Example 3: There is no PCU monitor and no PCU panel (headless operation):
A) In active TCU mode:
a) Dynamic resolution switching is enabled (resolution adaptation entry in
TCU.ini) and at least one TCU is already logged on:
The resolution is set to the resolution of the TCU which is currently active.
b) Dynamic resolution switching is enabled (resolution adaptation entry in
tcu.ini) and no TCU has logged on yet or dynamic resolution switching is
disabled:
The resolution is set to the max. resolution of the current PCU panel, i.e.
which logged on during the previous session.
Default setting: Default TCU resolution in accordance with the registry.
Notice: The first TCU panel to log on is activated. The focus handler then
automatically sets the resolution to this TCU panel's resolution (in the case
of dynamic resolution switching).
B) In inactive TCU mode:
The resolution is not specially set - i.e. the resolution used during the previous
session in the system is active, e.g. the resolution set manually in Control
Panel.
AUTO_MON_2 Like AUTO_MON_1, except:
Example 2: There is no PCU monitor, however there is a PCU panel (irre‐
spective of whether there are any TCU panels):
(max. 1920x1080).
640x480 During run-up, the SINUMERIK resolution is set to 640x480.

Settings Meaning

4.10 Setting the color depth in the tcu.ini file
4.10 Setting the color depth in the tcu.ini file

Per default, the color depth of the SIEMENS PC system is set to 16-bit via the tcu.ini
configuration file and is reset to this value at every run-up.
To use a different color depth, you must adapt the setting in the tcu.ini file in the
[VNCServer] section.
Requirement
● Hidden directories are not shown
● A copy of the tcu.ini configuration file is stored in the user directory: C:\ProgramData
\Siemens\MotionControl\user\System\etc\tcu.ini
● The tcu.ini configuration file in the user directory is not write-protected
See: Directory structure and file conventions (Page 13)
Procedure
To adapt the color depth of the PC system, proceed as follows:
1. Open the tcu.ini configuration file in the C:\ProgramData\Siemens\MotionControl
\user\System\etc\ directory.
2. Enter the required value in the [VNCServer] section (below the #COLOR DEPTH comment):
– ColorDepth=0
The color depth is not changed during run-up, but rather the color depth used last is
retained. In this way, you can adapt the color depth in the Windows settings.
– ColorDepth=1 (default value)
The color depth is set to 16-bit during run-up.
– ColorDepth=2
The color depth is set to 32-bit during run-up.

4.11 Activating/deactivating the multitouch operation of TCUs
4.11 Activating/deactivating the multitouch operation of TCUs

If you use SINUMERIK TCUs, which support capacitive multitouch operation, you can centrally
activate/deactivate this functionality in the configuration file tcu.ini for all of the connected
TCUs.
Multitouch operation is activated via a default setting.
Requirement
● Hidden directories are not shown
● A copy of the tcu.ini configuration file is stored in the user directory: C:\ProgramData
\Siemens\MotionControl\user\System\etc\tcu.ini
● The tcu.ini configuration file in the user directory is not write-protected
Procedure
Proceed as follows to configure multitouch operation:
1. Open the tcu.ini configuration file in the C:\ProgramData\Siemens\MotionControl
\user\System\etc\ directory.
2. Enter the desired value:
– TouchSupport=1 (default value)
Multitouch operation is centrally activated for all of the TCUs that support the
functionality.
– TouchSupport=0
Multitouch operation is centrally deactivated for all of the TCUs that support the
functionality.
Result
The setting has been changed and is active after a restart of the Siemens PC system.

4.12 Calibrating the touch operation of a screen
4.12 Calibrating the touch operation of a screen

If you use an operator panel or screen with touch functionality, you may have to calibrate it.
The calibration of the touch functionality is always relative to the set screen resolution and is
specifically saved for it after the calibration.
Requirement
Procedure
To calibrate the touch functionality of a screen, proceed as follows:
1. In the Start menu, click "Start > All Programs > Touchware > UPDD".
The "TouchWare Properties" dialog box opens.
2. In the "Calibrate" tab, click on "Calibrate" and follow the instructions that appear on screen.
You can find additional information in the dialog via the "Help" button.

4.13 Configuring the SITOP UPS module for use with the PCU Base
Software
4.13.1 Overview of SITOP UPS

SITOP UPS modules can continue operation of the SIEMENS PC system temporarily if a power
failure occurs and/or shut down the system correctly.
For example, a SITOP UPS module also protects against data loss when the SIEMENS PC
system hardware is shut down, because for technical reasons with Windows-based systems,
data is still written to the SSD after shutdown.
● You will find general information about SITOP UPS modules used in combination with the
PCU base software in Chapter SITOP modules for the PCU 50.5 (Page 43).
● If you want to use a SITOP UPS module in combination with the PCU base software, you
must first adapt the settings of the SITOP software (Page 43).
● Optionally, you can adapt the delay time after which the HMI software will be forced to shut
down (Page 46).
● You must configure the hardware (Page 48) of the SITOP UPS module before using it with
the PCU base software.
NOTICE
Ensure the readiness for operation of the SITOP power supply
In order to prevent data loss, the SITOP power supply must be ready for operation. Note the
following:
● The SITOP power supply may not be ready for operation immediately after being switched
on (a capacitor-buffered UPS500 requires 1-2 minutes make time, for example).
● The operating system and the SITOP software must have run up so that the SITOP
software can shut down the system correctly when a power failure occurs.
● The readiness for operation and the functional capability of the SITOP power supply must
be ensured (e.g. battery of capacitor charged).
● Please also note all the information on the readiness for operation in the documentation
of your SITOP device.
Further information
Information on the use of SITOP UPS modules in combination with the PCU base software
can also be found on the Internet:
● Service & Support Portal: SINUMERIK PCU 50.5: Use of an uninterruptible power supply
(http://support.automation.siemens.com/WW/view/en/90142681)
● Service & Support Portal: Typical values for an operator station with PCU 50.5 Windows 7
● SITOP Selection Tool (http://www.siemens.com/sitop-selection-tool) (Tool for the selection
of a SITOP UPS module)

4.13.2 SITOP modules for the PCU 50.5
Suitable SITOP UPS modules

SITOP UPS modules can continue operation of a PC system temporarily if a power failure
occurs and/or shut down the system correctly.
In conjunction with the PCU base software, all specific applications are taken into account (e.g.
HMI software) with the USVShutdown.bat component.
Safe shutdown after a power failure of the PCU 50.5 as delivered takes approximately 20
seconds. For a typical power consumption of approx. 60 W, a capacitor-buffered UPS with an
energy storage device of 2.5 kW is recommended for a PCU 50.5. If longer buffer times are
required, then several expansion modules can be connected in a cascade connection.
Example of a compatible SITOP UPS module:

SITOP 500S (15 A / 2.5 kWs capacitor)
Article no.: 6EP1933-2EC41
Note
The functionality has been tested in the standard configuration with the PCU base software.
When installing add-on or OEM software components, you must check the shutdown
procedure of the entire system and adapt the factory setting (180 seconds).
See: Parameterizing a delay time for quitting the HMI software (Page 46)
Further information
Information about available SITOP UPS modules is given in the catalog or in the Internet:
● Service & Support Portal: SINUMERIK PCU 50.5: Use of an uninterruptible power supply
● Service & Support Portal: Typical values for an operator station with PCU 50.5 Windows 7
● SITOP Selection Tool (http://www.siemens.com/sitop-selection-tool) (Tool for the selection
of a SITOP UPS module)
● Catalog KT 10.1 Power supply SITOP
● SIEMENS Industry Mall > 24 V DC Uninterruptible Power Supplies (https://
eb.automation.siemens.com/mall/en/US/Catalog/Products/7010117)
4.13.3 Configuring SITOP software for PCU Base Software

If you want to use a SITOP UPS module in combination with the PCU base software, you must
first adapt the settings of the SITOP software.

Requirement
● The SITOP UPS hardware is connected via the USB interface.
● The SITOP software of version 3.x.2.16 or later is installed in directory C:\Program
Files (x86)\SITOP\
● If you want to use SITOP software of version 3.2.1.16 or older, this must be installed as a
normal application, not as a service.
Note
Windows service of the SITOP software version 3.2.1.16 or older is not compatible with the
PCU base software
If you use SITOP software of version 3.2.1.16 or older as a Windows service with the PCU
base software, the correct shutdown procedure cannot be performed!
If you have installed the SITOP software of version 3.2.1.16 as a Windows service, you
must uninstall this and install it again as an application in order to be able to use it in
conjunction with the PCU base software.
As of version 3.2.1.17, the SITOP software can be used as service with the PCU base
software and is recommended.
● The SITOP software was configured during the installation so that it starts automatically
when Windows is run-up (factory setting).

Procedure
Proceed as follows to configure the SITOP software for use with the PCU base software:
1. Call the settings of the SITOP software, for example, by right-clicking the SITOP UPS icon
in the Windows information area and then selecting "Configuration".
The "SITOP DC UPS Configuration" dialog box opens.
2. In the "General" tab, select "UPS" in the drop-down list at "Serial interface".

3. Switch to the "Floating operation" tab and make the following settings:
– Deactivate the "Display monitoring window after" checkbox
Note
Deactivating the monitoring window
Display of the monitoring window can cause malfunctioning of the HMI software.
– Click directly in the text field at "Start application after" and specify the path of the
USVShutdown.bat:
C:\Program Files (x86)\Siemens\MotionControl\siemens\sinumerik
\hmi\base\USVShutdown.bat
Note
Do not use the "Browse" button
The dialog can crash if you use the "Browse" button to specify the path of the
USVShutdown.bat.
Instead, enter the path directly in the text field.
– After you have specified the path of the USVShutdown.bat, activate the "Start
application after" checkbox. Optionally, you can specify the wait time after which the
USVShutdown.bat is to be executed (e.g. 5 seconds).
4. Confirm the settings with "Save".
4.13.4 Parameterizing a delay time for quitting the HMI software

Before the SITOP monitor closes Windows 7, USVShutdown.bat shuts down operation of
the HMI software.

If the HMI software cannot be shut down within 180 seconds (factory setting) due to an error,
HMI software shutdown is forced and Windows 7 is shut down.
If the HMI software of your OEM installation is not shut down within 180 seconds, you can
parameterize this wait time manually.
Note
The "SITOP UPS" function has been tested in the standard configuration with the PCU base
software. When installing add-on or OEM software components, you must check the shutdown
procedure of the entire system and adapt the factory setting.
Requirement
● The SITOP UPS module is configured for use with the PCU base software.
See Configuring SITOP software for PCU Base Software (Page 43).
Procedure
Proceed as follows to change the delay time:

1. Call the settings of the SITOP software, for example, by right-clicking the SITOP UPS icon
in the information area and then selecting "Configuration".
2. In the "SITOP DC UPS Configuration" dialog box, enter the wait time in seconds as a
command line parameter in the "Floating operation" tab:
– Syntax: <Path>\USVShutdown.bat -<Time in seconds>
– Example: C:\Program Files (x86)\Siemens\MotionControl\siemens
\sinumerik\hmi\base\USVShutdown.bat -180
Figure 4-1 SITOP Monitor Floating operation
3. Confirm the setting with "Save".
4.13.5 Hardware configuration of the SITOP UPS module
Buffering parameterization
The UPS module can be used to select whether buffering should be completed after a
predetermined period of time or not until the accumulator’s lowest discharge threshold (=
maximum buffer time) has been reached. Both buffering parameterizations result from this.
"Maximum buffer time" mode

This mode enables the system to be shut down in a time-optimized manner. The UPS module
is synchronized with the shutdown of the operating system. Buffering is maintained until the
operating system has been shut down. The operating system must shut down within a
maximum of five minutes (including all applications). Otherwise, the UPS module buffers for
the maximum buffer time (dependent on the accumulator state).

Required settings on the UPS module (USB interface)
On - Off
1 +2V
Cut-in threshold
2 +1V
+22V fixed
3 +0.5V
4 +1V
5 +1V
End-of-charge voltage
6 +0.5V
+ 26.3V fixed
7 +0.2V
8 +0.2V
9 +0.1V
On - Off
2 +320 s
3 +160s
Buffer time
4 +80s
5 +40s
6 +20s +5 s fixed
7 +10s
8 Disconnection
Legend:
“Fixed buffer time” mode

In this mode, the UPS module always buffers for the pre-selected, fixed period of time. It is not
possible to synchronize the UPS module with the operating system shutdown.

Required settings on the UPS module
On - Off
1 +2V
Cut-in threshold
2 +1V
+22V fixed
3 +0.5V
4 +1V ∘
5 +1V ∘
End-of-charge voltage
6 +0.5V
+ 26.3V fixed
7 +0.2V
8 +0.2V
9 +0.1V
On - Off
2 +320 s ∘
3 +160s ∘
Buffer time
4 +80s
+5 s fixed
5 +40s
6 +20s
7 +10s
8 Disconnection
Legend:

4.14.1 Overview
You can permanently adapt the settings for the backup and restoration of disk images (Service
Center (Page 107) component) in the "Service Center Backup/Restore" dialog box:
● Configuration of the network adapter (Page 52)
● Configuration of the host (Page 53)
Adaptations that you make here are stored in the servicesystem.ini configuration file.
You can also adapt the settings directly in the associated configuration files:
● servicesystem.ini
● Additional settings: ghost.ini
You can also view the log files of the Service Center or restart the PC system in the Service
Center in the "Service Center Backup/Restore" dialog box.
To open the dialog box, click the ServiceCenter Backup-Restore icon on the Desktop.
Figure 4-2 ServiceCenter Backup/Restore

4.14.2 Configuration of the network adapter

You can make the network settings in the "Adapter Settings" tab and permanently save this
Center (Page 111).
file.
Overview
You can make the following IP settings in the "Adapter Settings" dialog box:
Figure 4-3 Adapter settings - Ethernet 1 (company network)
Table 4-4 Settings in the "Adapter Settings" dialog box

Settings Purpose
Adapter Select the Ethernet interface that you want to configure.
All settings in this dialog box refer to the selected Ethernet interface.
Obtain an IP address automatically Select whether the addresses are to be fetched dynamically from the DHCP server.
(DHCP) If the checkbox is deactivated, you must make the settings manually.
IP Address Set the IP address of the NCU.
192.168.214.250 - 254
Subnet Mask Specify a subnet mask, e.g. 255.255.255.0

Settings Purpose
A standard gateway creates a standard route in the IP routing table for all destinations that are
not in the subnet.
4.14.3 Configuration of the host

You can make the network settings in the "Host Settings" tab and permanently save this
Center.
file.
Overview
You can make the following settings in the "Host Settings" dialog box:
Figure 4-4 Host settings

Table 4-5 IP settings in the "Host Settings" dialog box

Settings Purpose
Network enabled Activate or deactivate the network interfaces of the PC system.
Firewall enabled Activate or deactivate the firewall of the PC system.
DNS Configuration > Computer Name Specify the DNS computer name.
DNS Configuration > Suffix Search List Parameterize a search list for DNS suffix, e.g. "network.com".
The factory setting of the Ethernet interface "Local Area Connection"
is ".local".

4.15 Adapting the firewall settings
4.15.1 Overview
From a PG/PC in the plant network, you can directly access resources on the Siemens PC
system. The same applies when accessing a PG/PC from the Siemens PC system in the plant
network or in the company network.
If you want to access the Siemens PC system via the company network instead or in addition,
you must adapt the firewall settings.
&RPSDQ\QHWZRUN 3ODQWQHWZRUN
3*3& 3&8
)LUHZDOO
You can adapt the following settings:

● Activate the remote access to the PC system (Page 61)
● Enabling SNMP communication (Page 59)
● Activation/deactivation of the file and printer release (Page 64)
● Activation of the ping execution (ICMP) (Page 76)
As a rule, you can make these settings in the Control Panel or via the prompt or a script/batch
file (relevant for series commissioning) (Page 58).
You can save and restore (Page 79) the firewall settings. (Even on different Siemens PC
systems, e.g. due to series commissioning)
Also note the general information in this chapter:
● Factory setting of the Windows Firewall on the Siemens PC system (Page 56)
● General information on the operating principle of the Windows Firewall (Page 57)
● General information on the settings recommended for Windows (Page 58)

4.15.2 Factory setting of the Windows Firewall on the Siemens PC system

The Windows Firewall settings on your Siemens PC system are appropriately configured by
the PCU-Basesoftware for the use of SINUMERIK software and systems. For security reasons,
the Windows Firewall is activated in the company network and expanded by additional rules.
The Windows Firewall is deactivated in the system network. The descriptions in this chapter
therefore largely relate to the adaptation of the firewall settings for the company network.
Table 4-6 Factory settings for network adapter and Windows Firewall
Plant network Company network

Interface X2 X1
Network name Local Area Connection Local Area Connection 2
Network profile Public Public
Status Windows Firewall Deactivated Activated
See: General information on the settings
recommended for Windows (Page 58)
File and printer release Activated and permit‐ Deactivated and blocked by firewall
See: Activation/deactivation of the file ted
and printer release (Page 64)
SNMP communication Permitted Blocked
See: Enabling SNMP communication
(Page 59)
Remote access (via port 5900) Permitted Blocked
See: Activate the remote access to the
PC system (Page 61)
Outgoing ICMP Ping requests from the Permitted Permitted
PC system
See: Activation of the ping execution
(ICMP) (Page 76)
Incoming ICMP Ping requests on the PC Permitted Blocked
system
See: Activation of the ping execution
(ICMP) (Page 76)
See also
Patch management and security updates (Page 84)
Saving and restoring firewall settings (Page 79)

4.15.3 General information on the operating principle of the Windows Firewall

Windows Firewall rules are structured as follows:
● The firewall rules are divided into Inbound Rules and Outbound Rules.
● Each firewall rule is valid for one or several network profiles (Profiles).
Each network connection in Windows is assigned to a specific network profile. In the factory
settings state of the PC system, both the plant network ("Local Area Connection") and the
company network ("Local Area Connection 2") have the network profile "Public".
● Some firewall rules are already assigned to so-called "Groups". As a result, you can more
easily activate or deactivate specific related network functionalities (e.g. file and printer
release).
● To ensure that the compatibility with Windows XP systems exists in the network, the
Windows XP Firewall settings still exist in Windows 7 in the "Local Group Policy Editor"
under "Computer Configuration > Administrative Templates > Network > Network
Connections > Windows Firewall".
If you make changes at this point, the settings take effect in addition to the settings of the
Windows 7 Firewall. Conflicts can occur if the configuration is erroneous. Do not make any
changes to the Windows XP settings if there are no Windows XP systems in your network.
You can make the Windows Firewall settings both via the Control Panel and via the prompt or
script/batch files. The use of script/batch files is particularly recommended for series
commissioning. Alternatively, for series commissioning, you can make all of the Windows
Firewall settings on an individual PC system, save these settings, and apply them on other
devices (Page 79).

4.15.4 General information on the settings recommended for Windows
Firewall settings recommended by Windows are unsuitable for use in the plant network
In the Control Panel, under "Windows Firewall", there is a display indicating that the firewall
settings do not correspond to the settings recommended and automatically checked by
Windows. The corresponding sections are highlighted in red:
The settings automatically recommended by Windows are not suitable for use in the plant
network, however, and would limit the functioning of the system. The network security in the
plant network must therefore be ensured by other security precautions. In this regard, observe
the information on industrial security (Page 84).
Note
Do not use the firewall settings that are automatically recommended by Windows!
The command "Use recommended settings" overwrites the existing firewall settings, which are
required for operating the PCU-Basesoftware, and therefore this command must not be used.
Otherwise, the Windows Firewall will be activated in the plant network and communication of
internal services of the PCU-Basesoftware will be inhibited.
4.15.5 Configuration by means of a prompt or script/batch file

You can make most of the settings described in this chapter both via the Control Panel and
via the prompt or script/batch files. The use of script/batch files is particularly recommended
for series commissioning.

Basic procedure
You can enter these commands either directly into the prompt or save the command in a script
or batch file:
● Direct input of the command:
– Call the prompt as the administrator.
– You can enter the commands either directly or in succession.
● Calling the command via a script file (or batch file):
– Save the command in a text file.
– Call the prompt as the administrator.
– Specify the script file as follows:
netsh -f <File name of the script file>
Further information
● MSDN Library - Netsh (command-line program) (https://msdn.microsoft.com/en-us/library/
cc785383(v=ws.7).aspx)
4.15.6 Enabling SNMP communication

Some network diagnostics functions use SNMP communication (e.g. in SINUMERIK Operate).
This is not blocked in the plant network. If, however, you have productively linked your plant
in the company network, SNMP communication is partially blocked:
● In the factory settings version of the PCU-Basesoftware, incoming SNMP communication
is blocked in the company network.
● Outgoing SNMP communication in the company network is not blocked.
In the settings for the Windows Firewall, you can activate SNMP communication via the
checkbox "SNMP Service" for specific network profiles.
Procedure
To permit incoming SNMP communication on the Siemens PC system, proceed as follows:
1. Click "Start > Control Panel".
2. Enter "Windows Firewall" in the search field and then click on "Windows Firewall" in the
search results.

3. Click "Allow a program or feature through Windows Firewall".

The dialog box opens. The various checkboxes for "SNMP Service" are checked and
displayed with a green or gray background, because the SNMP service is partially activated:
Incoming queries are blocked on the Siemens PC system and outgoing queries from the
PC system are permitted.
4. Click on "Change Settings" and confirm with "Yes", if applicable.

5. Activate the checkbox of the corresponding network profile completely, e.g. "Public" for the
company network (factory setting).
6. Click "OK" to confirm the change.

4.15.7 Activate the remote access to the PC system
4.15.7.1 Overview
Basically, it is possible to access the Siemens PC system both via the plant network and via
the company network via VNC:
● The remote access to the Siemens PC system from a PG/PC in the plant network is
activated via the factory setting.
● If you want to access the Siemens PC system via the company network instead or in
addition, you must adapt the firewall settings.
)LUPHQQHW] $QODJHQQHW]
3*3& 3&8
91&9LHZHU 91&6HUYHU
3RUW
The inbound rule "vnc5900", which is deactivated in the factory settings state, is available
for this purpose in the expanded settings for the Windows Firewall. To activate the remote
access to the PC system in the company network, you can activate this rule either directly
in the Control Panel (Page 61), or in the prompt or by means of a script/batch file
(Page 62).
Further information
In addition to the firewall settings, you may have to adapt other settings to establish a remote
connection in the company network. You can find additional information on this in Chapter
Remote access (Page 148), especially under Remote access to the PCU for operation and
maintenance (Page 149).
4.15.7.2 Via the Control Panel
Procedure
To activate remote access from the PG/PC in the company network to the Siemens PC system,
proceed as follows:
search results.

3. Click on "Advanced settings" and confirm the call of the expanded settings with "Yes" if
necessary.
4. In the "Windows Firewall with Advanced Security" dialog, right-click under "Inbound Rules"
on the rule "vnc5900", then click on "Enable Rule".

Result
With the activation of the inbound rule "vnc5900", Port 5900 was activated in the company
network, which allows remote access from a PG/PC to the Siemens PC system in the company
network.
If you want to deactivate remote access in the company network, right-click on the rule
"vnc5900" and select "Disable Rule" in the shortcut menu.
Further information
You can find general information on remote access to the Siemens PC system (via VNC Viewer
or SSH client) in Chapter Remote access (Page 148).
4.15.7.3 By prompt, script or batch file
Basic procedure
With a command according to the following scheme, you can activate remote access from the
PG/PC in the company network to the Siemens PC system.

To do this, call the prompt as the administrator and enter the command either completely or
successively.
Alternatively, you can save the command and the associated parameters in a script file
(Page 58).
Syntax for activating a firewall rule via the prompt

netsh advfirewall firewall set rule name="<Name of the firewall rule>" new
enable=yes profile=<Name of the network profile>
Table 4-7 Description of the Netsh commands in the context of the advfirewall firewall
Com‐ Parameter Description Value

mand
netsh Specification of the command line pro‐ -
gram, which executes the following
commands.
adv‐ Defines the context in which the follow‐ -
firewall ing commands are to be carried out.
firewall Subcontext of "advfirewall". -
set Adaptation of an existing firewall rule. -
rule
name Name of the firewall rule in quotation "vnc5900" | ... | all
marks
new Specifies that the following parameters -
are to be changed or added.
enable Activates or deactivates the specified yes | no
firewall rule.
profile Name of the network profile for which public | private | domain | any | ...
the corresponding firewall rule is to be
activated or deactivated.
Example
Activation of the firewall rule "vnc5900" for the "Public" profile.

netsh advfirewall firewall set rule name="vnc5900" new enable=yes profile=public
Further information
Descriptions of the commands and of all of the associated parameters of Netsh within the
Advfirewall firewall context can be found on the Microsoft website:
● Microsoft TechNet - Netsh AdvFirewall Firewall Commands (https://technet.microsoft.com/
en-us/library/dd734783(v=ws.7).aspx#BKMK_3_set)
● Microsoft TechNet - Use of the command line tool Netsh AdvFirewall (https://
technet.microsoft.com/en-us/library/cc770887(v=ws.7).aspx)

4.15.8 Activation/deactivation of the file and printer release
4.15.8.1 Overview
From a PG/PC in the plant network, you can easily and directly access a directory on the
Siemens PC system.
If you want to access the PC system via the company network instead or in addition, you must
adapt the firewall settings.
&RPSDQ\QHWZRUN 3ODQWQHWZRUN
3*3& 3&8
:LQGRZV([SORUHU 'LUHFWRU\
)LOHDQG
SULQWHUUHOHDVH
Figure 4-5 Access to a released directory of the PCU 50.5 from a PG/PC in the company network
Overview
You can activate the file and printer release either for all of the network profiles, for a specific
network profile, or for a specific network connection:
● General activation for all network profiles (Page 66)
– Via the Control Panel (Page 66)
– By prompt or script file (Page 67)
● Activation for a specific network profile (Page 69)
● Activation for a specific connection (Page 74)

4.15.8.2 General information
General information on the file and printer release in Windows

In Windows, there are basically settings for the file and printer release at two different locations:
In the settings of the corresponding network adapter and in the Windows Firewall settings.
● In the Windows Firewall settings, the file and printer release is at least partially blocked:
– The Windows Firewall is deactivated in the plant network, however, which allows access
to USB flash drives and external hard disks.
– In the company network, the Windows Firewall is activated and the file and printer
release is blocked by the Windows Firewall.
These settings can be changed in various dialog boxes, e.g. in the "Network and Sharing
Center" or in the "Allowed Programs" dialog box.
● In the settings of the network adapter for the plant network, the file and printer release is
activated. However, in the settings of the network adapter for the company network, the
file and printer release is deactivated. This setting primarily takes effect prior to the general
setting of the Windows Firewall.
This can be seen in the corresponding Windows Firewall settings dialogs by means of a
partially activated checkbox (green or gray background).

Further information
● Microsoft Windows support - File and printer release: Frequently Asked Questions (http://
windows.microsoft.com/en-us/windows/file-printer-sharing-faq#1TC=windows-7)
4.15.8.3 General activation for all network profiles
Via the Control Panel

There are several procedures for activating the file and printer release for all of the network
profiles in the Windows Firewall. (For example, there is the alternative procedure via the
"Network Sharing Center" under "Change advanced sharing settings").
Procedure
To activate the file and printer release on the Siemens PC system, proceed as follows:
search results.
3. Click "Allow a program or feature through Windows Firewall".

4. Click on "Change Settings" and confirm with "Yes", if applicable.

The "Allowed Programs" dialog box opens.
Also observe the entry in the column "Group Policy" and the color of the checkboxes (a
checkbox with a green or gray background indicates partial activation).
5. Activate the corresponding checkbox for the corresponding entry "File and Printer Sharing"
for the desired network profiles.
6. Click "OK" to confirm the change.
By prompt, script or batch file
Basic procedure
With a command according to the following scheme, you can allow the file and printer release
in the company network for all of the network profiles together. All of the firewall rules of the
group "File and Printer Sharing" are changed for all network profiles.

successively.
(Page 58).
Syntax for activating a group of firewall rules via the prompt

netsh advfirewall firewall set rule group="<group name>" new enable=yes

mand
commands.
set Adaptation of existing firewall rules. -
rule
group Name of the group with firewall rules "File and Printer Sharing" | ...
group of firewall rules.
Example
Activation of the firewall rule "File and printer release" for the "Public" profile.
netsh advfirewall firewall set rule group="File and Printer Sharing" new enable=yes
Further information

4.15.8.4 Activation for a specific network profile
Procedure
To activate the file and printer release from a PG/PC in the company network to PCU 50.5 for
a specific network profile, proceed as follows:
search results.
necessary.
4. In the "Windows Firewall with Advanced Security" dialog, right-click on the rule "Inbound
Rules", then click on "New Rule..."


5. In the "New Inbound Rule Wizard" dialog, select the option button "Predefined", select in
the "File and Printer Sharing" drop-down list, and click on "Next".

6. Depending on the network profile (e.g. Public or Domain) for which the file and printer
release is to be activated, check the corresponding checkbox.
7. Click "Next".
8. Select the option button "Allow the connection" and click on "Finish".
Basic procedure
With a command according to the following scheme, you can switch off the blocking of the file
and printer release by the Windows Firewall for a special network profile.
successively.

(Page 58).
Syntax for the activation of all firewall rules regarding file and printer release
netsh
advfirewall firewall
set rule name="File and Printer Sharing (NB-Session-In)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (NB-Session-Out)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (SMB-In)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (SMB-Out)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (NB-Name-In)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (NB-Name-Out)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (NB-Datagram-In)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (NB-Datagram-Out)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (Spooler Service - RPC)" new
enable=yes profile=<profile>
set rule name="File and Printer Sharing (Spooler Service - RPC-EPMAP)" new
set rule name="File and Printer Sharing (Echo Request - ICMPv4-In)" new
set rule name="File and Printer Sharing (Echo Request - ICMPv4-Out)" new
set rule name="File and Printer Sharing (LLMNR-UDP-In)" new enable=yes
profile=<profile>
set rule name="File and Printer Sharing (LLMNR-UDP-Out)" new enable=yes
profile=<profile>

mand
commands.
rule
name Name of the firewall rule in quotation "File and Printer Sharing (NB-
marks. Session-In)" | ...


mand
firewall rule.
Example
Example for the activation of all firewall rules regarding file and printer release
netsh
advfirewall firewall
set rule name="File and Printer Sharing (NB-Session-In)" new enable=yes
profile=public
set rule name="File and Printer Sharing (NB-Session-Out)" new enable=yes
profile=public
set rule name="File and Printer Sharing (SMB-In)" new enable=yes
profile=public
set rule name="File and Printer Sharing (SMB-Out)" new enable=yes
profile=public
set rule name="File and Printer Sharing (NB-Name-In)" new enable=yes
profile=public
set rule name="File and Printer Sharing (NB-Name-Out)" new enable=yes
profile=public
set rule name="File and Printer Sharing (NB-Datagram-In)" new enable=yes
profile=public
set rule name="File and Printer Sharing (NB-Datagram-Out)" new enable=yes
profile=public
set rule name="File and Printer Sharing (Spooler Service - RPC)" new
enable=yes profile=public
set rule name="File and Printer Sharing (Spooler Service - RPC-EPMAP)" new
set rule name="File and Printer Sharing (LLMNR-UDP-In)" new enable=yes
profile=public
set rule name="File and Printer Sharing (LLMNR-UDP-Out)" new enable=yes
profile=public
Further information

4.15.8.5 Activation for a specific connection
Procedure
To activate the file and printer release for a specific connection (e.g. company network),
proceed as follows:
2. Enter "Network and Sharing Center" in the search field and then click on "Network and
Sharing Center" in the search results.
3. Click on the desired connection, e.g. "Local Area Connection 2" (company network).

4. Click on "Properties" and confirm the call of the properties with "Yes" if applicable.
5. In the "Networking" tab, check the checkbox "File and Printer Sharing for Microsoft
Networks" and confirm the change with "OK".

In Windows, the activation of the file and printer release for a specific connection via the prompt
or script/batch file is not supported. This is possible, however, with the aid of the separate, free
command line program "Hyper-V Network VSP Bind (nvspbind)":
● Microsoft TechNet - Hyper-V Network VSP Bind (nvspbind) (https://
gallery.technet.microsoft.com/Hyper-V-Network-VSP-Bind-cf937850)
Command line program for configuring network adapters and connections via the prompt
You can find additional information in the documentation for nvspbind.
Example: Activation of the file and printer release for "Local Area Connection 2" (company network)
nvspbind -e "Local Area Connection 2" ms_server

4.15.9 Activation of the ping execution (ICMP)
4.15.9.1 Via the Control Panel

In the factory setting state, incoming ping requests are blocked on the company network
interface (X1) of the Siemens PC system. Outgoing ping requests are permitted.
Note
Dependency for the file and printer release
If you activated the file and printer release in the company network, incoming ping requests
are already permitted because they are required for the file and printer release.
Procedure
To permit ICMP pings, which arrive at the company network interface (X1) of the Siemens PC
system, proceed as follows:
search results.
necessary.
4. In the "Windows Firewall with Advanced Security" dialog, click on "Inbound Rules".

5. Select the corresponding rule for the relevant network profile:

– File and Printer Sharing (Echo Request - ICMPv4-In) - Profile "Domain"
– File and Printer Sharing (Echo Request - ICMPv4-In) - Profile "Public"
– File and Printer Sharing (Echo Request - ICMPv4-In) - Profile "Private"
In the factory setting state, the network profile "Public" is assigned to the company network.
Figure 4-6 Rules for incoming ICMP pings, separate for each network profile
6. Right-click on the selected rule, then click "Enable Rule".
4.15.9.2 By prompt, script or batch file
Basic procedure
With a command according to the following scheme, you can permit ICMP pings which arrive
at the company network interface (X1) of the Siemens PC system. Outgoing pings from the
Siemens PC system are already activated.
Note
Dependency for the file and printer release
If you activated the file and printer release in the company network, incoming ping requests
are already permitted because they are required for the file and printer release.
The name of the relevant firewall rule is "File and Printer Sharing (Echo Request - ICMPv4-
In)". To do this, call the prompt as the administrator and enter the command either completely
or successively.

Alternatively, you can save the command and the associated parameters in a script or batch
file (Page 58).
Syntax for activating a firewall rule via the prompt

netsh advfirewall firewall set rule name="<Name of the firewall rule>" new enable=yes
profile=<Name of the network profile>

mand
commands.
rule
name Name firewall rule "File and Printer Sharing (Echo
Request - ICMPv4-In)" | ...
firewall rule.
profile Name of the network profile for which
the firewall rule is to be changed.
Example
Activation of incoming ping requests

netsh advfirewall firewall set rule name="File and Printer Sharing (Echo Request - ICMPv4-
In)" new enable=yes profile=public
Further information

4.15.10 Saving and restoring firewall settings
4.15.10.1 Overview
Overview
You can save all of the Windows Firewall settings of the Siemens PC system as a policy file
with the file extension ".wfw". Policy files are saved in binary format and are Windows version-
dependent.
You have the following options for backing up or restoring the firewall settings:
● Backup of firewall settings (Page 79)
– By prompt, script or batch file (Page 80)
● Restoring of firewall settings (Page 81)
You can restore the firewall settings on the same Siemens PC system or import the same
policy file to different Siemens PC systems for the purpose of series commissioning.
– By prompt, script or batch file (Page 81)
4.15.10.2 Backup of firewall settings
Procedure
To back up the Windows Firewall settings of the Siemens PC, proceed as follows:
search results.
necessary.
4. Right-click on the master object "Windows Firewall with Advanced Security on Local
Computer" and then click on "Export Policy...".
5. In the "Save As" dialog, select a save location and file name and confirm with "Save".

Basic procedure
With a command according to the following scheme, you can back up the Windows Firewall
settings in a policy file (.wfw).
To do this, call the prompt as the administrator and first define the save location of the policy
memory, then enter a file path for backing up the policy file.
Alternatively, you can save the commands and the associated parameters in a script or batch
file (Page 58).
Syntax of the Netsh commands for defining the policy memory and for exporting the policy file
netsh advfirewall set store local
export <File path and file name>.wfw
Table 4-11 Description of the Netsh commands for defining the policy memory and for exporting the
policy file

mand
commands.
set Definition of the save location of the pol‐ -
store icy memory for the following commands.
local Defines that the work is to be done with -
the local policy memory.
export Backup of all firewall settings in a policy <File path and file name>.wfw
file (.wfw).
Example
Example of the Netsh commands for defining the policy memory and for exporting the policy file
export D:\Backup\DefaultSettings.wfw
Further information
Advfirewall context can be found on the Microsoft website:
● Microsoft TechNet: Netsh Commands for Windows Firewall with Advanced Security (https://

4.15.10.3 Restoring of firewall settings
Procedure
Note
Importing a policy file overwrites all existing firewall rules
When the firewall settings are restored, all of the existing firewall rules are overwritten. You
cannot undo the import of firewall rules via a policy file.
Therefore, back up (export) the existing firewall settings before you import a policy file.
To restore the Windows Firewall settings of the Siemens PC system, proceed as follows:
search results.
necessary.
4. Right-click on the master object, then click "Windows Firewall with Advanced Security on
Local Computer", then click on "Import Policy..." and confirm the command with "Yes".
5. In the "Open" dialog, select the policy file and confirm with "Open".
Basic procedure
Note
Importing a policy file overwrites all existing firewall rules
When the firewall settings are restored, all of the existing firewall rules are overwritten. You
cannot undo the import of firewall rules via a policy file.
Therefore, back up (export) the existing firewall settings before you import a policy file.
With a command according to the following scheme, you can restore the Windows Firewall
settings from a policy file (.wfw).
To do this, call the prompt as the administrator and first define the save location of the policy
memory, then enter a file path for backing up the policy file.

Alternatively, you can save the commands and the associated parameters in a script or batch
file (Page 58).
Syntax of the Netsh commands for defining the policy memory and for importing the policy file
import <File path and file name>.wfw
Table 4-12 Description of the Netsh commands for defining the policy memory and for importing the
policy file

mand
commands.
set Definition of the save location of the pol‐ -
store icy memory for the following commands.
local Defines that the work is to be done with -
the local policy memory.
import Restoration of firewall settings from a <File path and file name>.wfw
policy file (.wfw).
Example of the Netsh commands for defining the policy memory and for importing the policy file
import D:\Backup\DefaultSettings.wfw
Further information
Advfirewall context can be found on the Microsoft website:
● Microsoft TechNet: Netsh Commands for Windows Firewall with Advanced Security (https://

Installing and configuring updates and automation
software 5
5.1 Overview
Once you have completed installation of the PCU-Basesoftware and possibly configured the
network settings, you can set up handling of the security updates, patches, and software
installations or install them directly.
● You will find information about Windows updates and the network security of an automation
system in Chapter Patch management and security updates (Page 84).
● The PCU Installer (Page 95) will assist you with automatic installation of setup packages.
● You can install SINUMERIK Operate (Page 85) or other HMI software and at the same
time (Page 85) orsubsequently (Page 87) set it up for autologon mode.
● To prevent operation of the HMI software from being interrupted by key combinations such
as CTRL+ALT+DEL, you can activate and configure the key filter (Page 89).
● You can install STEP 7 and the SINUMERIK add-on (Page 93) and add a softkey to the
HMI software to start STEP 7 (Page 94).
● If you want to transfer existing data to the newly installed automation software, read
ChapterMigration (Page 106).

Installing and configuring updates and automation software
5.2 Patch management and security updates
5.2 Patch management and security updates
Overview
Microsoft regularly eliminates security holes in Windows and makes these corrections available
on its "Windows Update" website.
As a solution for managing and making Windows updates available in a network, Microsoft
offers the component Windows Server Update Services (WSUS).
Microsoft TechNet - Windows Server Update Services (http://technet.microsoft.com/en-us/
wsus/default.aspx)
Industrial security
You will find information about network security for an automation system and a comprehensive
protection concept under Industrial Security on the SIEMENS website:
SIEMENS Industrial Security (http://www.industry.siemens.com/topics/global/en/industrial-
security/)
SINUMERIK-specific information about Industrial Security can also be found in the following
documents:
SINUMERIK/SIMOTION/SINAMICS Configuration Manual Industrial Security (https://
support.industry.siemens.com/cs/document/108862708?lc=en-WW)
Compatibility with automation software

Information about compatibility of a Windows update with specific application software of
SIEMENS may possibly be available on the product pages of the application software in
question in the Service&Support portal:
SIEMENS Industry Service & Support Portal (https://support.industry.siemens.com/)
Generally, it is recommended that you check the compatibility of updates in a dedicated project
test environment before installing it in a productive environment.

5.3 Setting up SINUMERIK Operate for autologon mode

If you want the PC system to start automatically in SINUMERIK Operate after switching on
without having to make any further entries, set up the Autologon mode.
During installation of SINUMERIK Operate, you can define an existing user account as an
autologon account. The PC system then starts without the password for this user account
being entered. SINUMERIK Operate is then started automatically because a link is created in
the "Startup" Autostart folder.
For security reasons, you should use a special user account without administrator rights.
You can also configure the key filter and deactivate certain keyboard entries (Page 89), e.g.
to prevent a switchover from SINUMERIK Operate to the Windows Desktop. (Desktop access
is then only possible via the splash screen (Page 146).)
Requirement
● A Windows user account without administrator rights is set up.
● SINUMERIK Operate is not installed.
● You are logged on as an administrator or you know the password of the administrator
account.
● The keyboard layout of the system is set to English.
See: Configuring the keyboard layout (Page 32)

Procedure
To set up autologon mode, proceed as follows:
1. Start installation of SINUMERIK Operate and, in the installation wizard, proceed to step
"Autologon".
Figure 5-1 SINUMERIK Operate Installer - Autologon
2. In the list, select the user account to be logged on automatically.

3. Confirm with "Next", then in the next steps of the installation wizard make all the necessary
settings and confirm the installation with "Finish".
Result
SINUMERIK Operate is installed and Autologon mode of the PC system is set up. During this
process the password of the autologon user account is stored encrypted in Windows, and
SINUMERIK Operate is linked with the autostart folder "Startup".
Autologon mode is active at the next startup. The autologon user account is automatically
logged on and SINUMERIK Operate is started.

5.4 Modifying the user account for autologon mode.

Because of the way autologon works, only one user account can ever be set up for autologon
mode.
If you set up autologon mode during installation of SINUMERIK Operate for one particular user
account, but now want to use another user account for autologon mode, you can change this
manually in the Service Desktop.
Requirement
SINUMERIK Operate is installed and autologon mode is set up.
The Service Desktop is active.

Procedure
To change the user account that is used for automatic startup in autologon mode, proceed as
follows:
1. To open the "User Accounts" dialog box, proceed in one of the following ways:
– On the Desktop, double-click the "Netplwiz" icon.
– In the search field of the Start menu, enter netplwiz and confirm the entry.
– At the prompt, enter control userpasswords2.
The "User Accounts" dialog box opens.
Figure 5-2 "User Accounts" dialog box in Windows 7: Please note that the deactivated checkbox
refers to the selected user account.
2. Activate the "Users must enter a user name and password to use this computer" checkbox.
3. In the "Users for this computer" list, select the user account to be used for autologon mode.
4. Deactivate the "Users must enter a user name and password to use this computer"
checkbox.
You may be prompted to enter a password.
5. Confirm these settings in the "User Accounts" dialog box with "OK".
6. In the Autostart folder of the autologon mode user account, create a link to SINUMERIK
Operate.

5.5 Configuring a key filter for HMI software

To prevent unwanted interruption of the HMI software while it is running, you can specify that
certain keyboard entries will be filtered out and thus ignored.
You can configure the key filter in the pcuhwsvc.ini configuration file:
● This key filter is not activated as delivered.
● You can activate the key filter and individually select which of the 20 filterable keyboard
entries will be ignored. During this, you can deactivate known shortcut keys, for example,
or even deactivate individual add-on keys, such as the left (SeqActive_16) or right
(SeqActive_17) Windows key.
You cannot configure any additional keyboard entries to be filtered.
● You can also completely deactivate the repeat function of the F1-F12 keys and all hard
keys with the key filter. When the repeat function is deactivated, a key held pressed is
considered as pressed once and not as pressed repeatedly.
Per default, the repeat function is activated during Service or Desktop operation. The repeat
function is always deactivated during operation of SINUMERIK Operate.
Requirement
● Hidden directories are shown
See also: Directory structure and file conventions (Page 13).
Procedure
To configure the key filter, proceed as follows:
1. Switch to the template directory: C:\ProgramData\Siemens\MotionControl
\siemens\System\etc\
The settings can be viewed in the template pcuhwsvc.ini.
2. Save a copy of the template pcuhwsvc.ini to one of the user directories:
– C:\ProgramData\Siemens\MotionControl\user\System\etc\
– C:\ProgramData\Siemens\MotionControl\oem\System\etc\
– C:\ProgramData\Siemens\MotionControl\addon\System\etc\
3. In the new file (e.g. ...\oem\System\etc\pcuhwsvc.ini), delete all data except for
the section name [KEYB_FILTER] and the keys that are to differ from the template.
All data and keys that do not occur in your file are automatically taken over from the template
in the siemens directory.
4. Save your file.

Example: Activating the key filter, but allowing use of the NUM-lock key.
This example activates the key filter (KeySequencesEnable = 1) and filters all possible
keyboard entries except the NUM-lock key.
KEYB_FILTER Section name (mandatory):

KeySequencesEnable = 1 Activate key filter
SeqActive_19= 0 Do not filter NUM-lock key
In the adapted file in the user directory (e.g. ...\oem\System\etc\) therefore only the
section name [KEYB_FILTER] is mandatory as well as the settings that you want to adapt.
All other settings and values are taken over from the template.
Template of the key filter in the delivery condition

The template is located in directory C:\ProgramData\Siemens\MotionControl
Do not overwrite this template, but save a copy of this template pcuhwsvc.ini in one of the
user directories.
● C:\ProgramData\Siemens\MotionControl\user\System\etc\
● C:\ProgramData\Siemens\MotionControl\oem\System\etc\
● C:\ProgramData\Siemens\MotionControl\addon\System\etc\
How the configuration file works

You can configure the key filter in section [KEYB_FILTER]. The lines identified by a number
sign (#) are comments as to which line further down deactivates a particular keyboard entry.
● To activate a particular keyboard entry, find the key in the comment and then set the value
to 0.
● To allow all keyboard entries and thus deactivate the key filter (factory setting), set the value
to 0 in the KeySequencesEnable key.
If the value 0 is set for this key, all other keys will be ignored and the key filter is deactivated.
● To completely deactivate the repeat function of the F1-F12 keys and all hard keys, set the
value 1 at the AutorepeatSuppression key.
Table 5-1 Overview: Key filter in the configuration file pcuhwsvc.ini
Section [KEYB_FILTER]
Key SeqActive_x
Value 0 = specific keyboard entry activated
1 = specific keyboard entry will be filtered and is deactivated
Factory setting 1
pcuhwsvc.ini (Vorlage im Verzeichnis ...\siemens\System\etc)

[GLOBAL]
# -----------------------


# SIEMENS GLOBAL SECTION
# -----------------------
# enable logfile PCUHardwareservice.log
EnableLogFile=0
# Emulating of "Mode-Switch" from Sinumerik PCU50 Box.
# "Mode-Switch" is a rotary switch, which is attached to the rear side of the PCU50 V5 Box.
# About this, different methods of booting the computer are controlled.
# 0 Normal mode
# 3 Desktop mode (welcome screen)
ModeSwitch=0
[SERVER]
FTP=hmisvr_PCU_betaftpd
DHCP=hmisvr_PCU_udhcpd
TFTP=hmisvr_PCU_netkit-tftpd
TCUHWS=hmisvr_TCU_hardware_services
VNC=uvnc_service
[APPLICATION]
# ---------------------------------------
# STARTUP APPLICATION DIAGNOSTIC SECTION
# ---------------------------------------
[KEYB_FILTER]
# -------------------------------------------
# SIEMENS KEYBOARD-FILTER DRIVER SECTION
# -------------------------------------------
# Filtering Key Sequences

# =======================
# Activation of Key-Sequences to be ignored
# SeqAct_x
# The following 20 sequences are implemented
# 0 CTRL-ALT-DEL
# 1 ALT-F4
# 2 ALT-TAB
# 3 LEFTSHIFT-ALT-TAB
# 4 RIGHTSHIFT-ALT-TAB
# 5 CTRL-ESC
# 6 ALT-ESC
# 7 ALT-SPACE
# 8 (SHIFT)-CTRL-F1
# 9 (SHIFT)-CTRL-F2


# 16 M$_1
# 17 M$_2
# 18 CAPSLOCK
# 19 NUMLOCK
# 20 (reserved)
KeySequencesEnable = 0
SeqActive_0= 1
SeqActive_1= 1
SeqActive_2= 1
SeqActive_3= 1
SeqActive_4= 1
SeqActive_5= 1
SeqActive_6= 1
SeqActive_7= 1
SeqActive_8= 1
SeqActive_9= 1
SeqActive_11= 1
SeqActive_12= 1
SeqActive_13= 1
SeqActive_14= 1
SeqActive_15= 1
SeqActive_16= 1
SeqActive_17= 1
SeqActive_18= 1
SeqActive_19= 1
SeqActive_20= 1
# Autorepeat-Suppression of Function Keys F1-F12 and Hardkeys

#===============================================
AutorepeatSuppression = 0

5.6 Installing STEP 7
5.6 Installing STEP 7
Requirement
● The Service Desktop is active
● The STEP 7 product DVD is available on the PC system, e.g. via an external DVD drive or
network.
Procedure
1. To start the installation assistant of STEP 7, on the product DVD in directory "CD_1", double-
click setup.exe
2. Confirm the preselected directory under C:\Program Files (x86)\Siemens
\Step7\ as the installation directory.
3. In step "Transfer license keys", select "No, transfer license keys later".
Note
Licensing of STEP 7 with SINUMERIK Add-on
The licensing for STEP 7 is performed during installation of the SINUMERIK Add-on.
4. After you have installed STEP 7, restart the PC system and switch to the Service Desktop.
5. To start the installation wizard of the SINUMERIK Add-on, double-click setup.exe on the
product DVD in directory "Sinumerik_Add_On".
The installation wizard guides you through the following steps.
6. After you have installed the SINUMERIK Add-on, restart the PC system.
Result
STEP 7 has been installed with SINUMERIK Add-on.
The software has been registered in the Control Panel under the following designations:
● STEP 7 V5.5
● SINUMERIK Add-on for STEP7 V5.5

5.7 Linking the HMI software with STEP 7
5.7 Linking the HMI software with STEP 7

If you want to make it possible to start STEP 7 directly from the user interface of the installed
HMI software, add a softkey to it.
Requirement
● STEP 7 V5.5 SP3 or higher is installed
● The SINUMERIK Add-on for STEP 7 V5.5 or higher is installed
● An HMI software version is installed (SINUMERIK Operate or HMI Pro sl)
Procedure
To add a softkey to the menu of the HMI software for starting STEP 7, proceed as follows:
1. Double-click the "STEP7-Authorizing" desktop icon.
Result
A softkey for starting STEP 7 has been added to the HMI software. This softkey requires access
level 3.
In C:\Program Files (x86)\Siemens\MotionControl\compat\add_on
\oemframe.ini, the following settings have been made for this purpose:
[s7tgtopx]
; with HMI-Advanced: eliminate minimize- / maximize-buttons of the
STEP7-window
WindowStyle_Off=196608
; with HMI-Advanced: switch to previous task when STEP7 is terminated
nSwitchToTaskAfterTermination= -2
Note
Adjustments for OEM configurations
The entries in oemframe.ini can be modified for OEM configurations.
For more information about templates for parameterizing the system, see Section Directory
structure and file conventions (Page 13).

5.8 PCU Installer
5.8 PCU Installer
5.8.1 Overview
The PCU Installer assists you with the installation of setup packages on PC systems:
● The PCU Installer checks definable setup directories on the PC system, on removable
disks, or in the network.
These setup directories must not be write-protected.
● If setup packages exist, they are automatically installed one after the other. The order in
which these packages are installed can be parameterized (Page 99).
● On the top right of the screen, a status display is displayed while the PCU Installer carries
out such activities.
For further information on the activities of the PCU Installer, see Chapter Procedure example
of an installation with the PCU Installer (Page 104).
Overview of the configuration and operation

● In the delivery condition of the PCU-Basesoftware, the PCU Installer is deactivated. You
can activate the PCU Installer during the unattended installation of the PCU-Basesoftware
via the response file (Page 20) or activate it manually after the attended installation
(Page 95).
● You can make all settings in the PCU Installer in the associated configuration file
(Page 99).
● Copy the setup packages to the defined directories to start the installation (Page 103).
● The PCU Installer consists of a client and a service, whereby setup packages can also be
installed for a user account without administrator rights.
5.8.2 Activating the PCU Installer
5.8.2.1 Overview
In the delivery condition of the PCU base software, the PCU Installer is deactivated.

5.8 PCU Installer
There are different ways of activating the PCU Installer:

● If you complete the installation of the PCU-Basesoftware unattended, you can have the
PCU Installer activated via the unattend.xml response file. See Configuring an answer
file (Page 20).
● If you complete the installation of the PCU base software with Windows 7 attended, or have
not configured activation of the PCU Installer in the response file, you must activate the
PCU Installer manually. To do this, use one of the following procedures:
– Copy a preconfigured template of the PCUInst.ini to the "user" directory (Page 96)
– Create your own version of the PCUInst.ini in one of the user directories and set the
appropriate values
See: Reference to the PCUInst.ini configuration file (Page 99)
5.8.2.2 Activating via a configuration template
Requirement
● The PCU Installer is deactivated
● The PCU Installer has not been configured yet and there is no adapted PCUInst.ini
configuration file
Procedure
To activate the PCU Installer by copying a preconfigured template, proceed as follows:
1. Copy the following file to the clipboard: D:\etc\Template_PCUInst.ini
2. Paste the file into the following directory: C:\ProgramData\Siemens\MotionControl
\user\system\etc
3. Rename the copied file to PCUInst.ini
Result
The PCU Installer has been activated and checks the setup directories during startup of the
PC system, but not during system operation.
The copied configuration file only differs from the default configuration file by the following
value:
[processing_loginphase]
StartState=activated
The settings of the copied configuration file are used because they are in a directory with higher
priority than the default configuration file.
To also use the PCU Installer during system operation, you must make an additional setting
in the copied configuration file (Page 99):

5.8 PCU Installer
[processing_systemphase]
5.8.3 Deactivating the PCU Installer

In the delivery condition of the PCU-Basesoftware, the PCU Installer is deactivated.
Note
Troubleshooting for incorrect installation routines
If completion of an installation requires a restart, but the installation cannot be completed after
the restart, the Service Desktop is not started.
In this case, restart the PC system in protected mode to prevent the PCU Installer from starting.
(To start in protected mode, press F8 repeatedly during startup until a selection menu opens.)
Then reconfigure the PCU Installer or remove the setup packages.
Requirement
● Hidden directories are not shown (at least C:\ProgramData\)
See also: Directories hidden in delivery condition (Page 13).
● A copy of the PCUInst.ini configuration file is stored in the user directory: C:
\ProgramData\Siemens\MotionControl\user\System\etc\PCUInst.ini
● The PCUInst.ini configuration file in the user directory is not write-protected
Procedure
To partly or completely deactivate the installation of the setup files by means of the PCU
Installer, proceed as follows:
1. Open the PCUInst.ini configuration file in the C:\ProgramData\Siemens
\MotionControl\user\System\etc\PCUInst.ini directory.
2. Deactivate the start of the PCU Installer in the desired phase:
– To deactivate the PCU Installer during system operation, change the relevant key value
in the [processing_systemphase] section: StartState=stopped.
– To only deactivate the PCU Installer while a specific application is being executed (e.g.
SINUMERIK Operate), enter the file name of the relevant application in the
[noactivation] section, e.g. APP001=run_hmi.exe
(You can specify any number of applications, e.g.
APP002=Siemens.Automation.Portal.exe)
– To deactivate the PCU Installer during run-up, change the relevant key value in the
[processing_loginphase] section: StartState=stopped.

5.8 PCU Installer
Further information
For information on all configuration options, see Reference to the PCUInst.ini configuration
file (Page 99).
5.8.4 Copying and adapting the configuration file

You can define PCU Installer operation in the associated configuration file. To do this, you
must first copy the configuration file to a user directory.
Alternatively, you can copy a template in which the PCU Installer has already been activated
(Page 96).
For example, you can configure the following in the configuration file:
● Which directories have been checked how many times for new setup packages.
● That installations are not started automatically while certain software is active.
A list of all setting options can be found under Reference to the PCUInst.ini configuration file
(Page 99).
Requirement
● The PCU Installer has not been configured yet and there is no adapted PCUInst.ini
configuration file
Procedure
To copy and adapt the configuration file of the PCU Installer, proceed as follows:
1. Switch to the template directory: C:\ProgramData\Siemens\MotionControl
The settings can be viewed in the template PCUInst.ini
2. Save a copy of the template PCUInst.ini to one of the user directories:
– C:\ProgramData\Siemens\MotionControl\user\System\etc\
– C:\ProgramData\Siemens\MotionControl\oem\System\etc\
– C:\ProgramData\Siemens\MotionControl\addon\System\etc\

5.8 PCU Installer
3. Adapt the values of the keys. You will find information about the syntax and setting options
at Reference to the PCUInst.ini configuration file (Page 99) or in the comments of the
configuration file.
Note
The factory setting is taken if key pairs are missing
All key pairs that are not available in your file are taken automatically from the template in
the siemens directory.
Therefore, in the new file (e.g. ...\oem\System\etc\PCUInst.ini), delete all the data
except the section names and the keys that are to differ from the template.
See also: Directory structure and file conventions (Page 13), Reference to the PCUInst.ini
configuration file (Page 99)
Result
The configuration file has been copied to a user directory and can be adapted.
You will find further information on the setting options in the following chapters.
5.8.5 Reference to the PCUInst.ini configuration file

You can define PCU Installer operation in the associated PCUInst.ini configuration file.
For example, you can configure the following:
● Which directories have been checked how many times for new setup packages.
● That installations are not started automatically while certain software is active.
The priority concept of this configuration file is the same as that of the other configuration files,
see Directory structure and file conventions (Page 13).
You can also deactivate settings in PCUInst.ini by deleting the value of the key in the higher
priority configuration file. For example, to deactivate DIR002=C:\Setup in a file of lower
priority, enter DIR002= in the file with higher priority.
Note
Maximum length of the file path
The file path to a setup must not exceed 255 characters (including the file name).

5.8 PCU Installer
Table 5-2 Setting options in the configuration file of the PCU Installer
Section Settings Description
[local_setupdirs] DIR001= Specifies the local setup directories on the PC system to be checked.
DIR002= The directories must not be write-protected.
... You can specify several directories, which are then checked in the specified order.
You define the order with a number after "DIR".
Subdirectories at the first level are also scanned.
[removable_ DIR001= Specifies the setup directories on removable disks to be checked.
setupdirs] DIR002= The directories must not be write-protected.
... You can specify several directories, which are then checked in the specified order.
If you do not know the drive letters to be checked, use the <REMOVABLE_MEDIA>
drive variable, e.g.:
DIR001=<REMOVABLE_MEDIA>:\Install
The drive variable then represents all the removable disks that are known at the time
in Windows. You can also specify fixed drive letters without the directories being
checked twice.
The drive variable is only valid in the [removable_setupdirs] section.
[net_setupdirs] DIR001= Specifies the setup directories on network drives to be checked.
DIR002= The directories must not be write-protected.
... See also: Creating a shortcut to the network drive (Page 137)
You can specify several directories, which are then checked in the specified order.
[setupdirs_ deleteTmpLocal Temporary directories are created during installation of a setup from a removable disk,
settings] SetupDirs= network drive or the default setup directory D:\Install
(See also: Procedure example of an installation with the PCU Installer (Page 104))
Here you can specify whether these temporary directories are to be deleted again
after installation.
Possible values: yes; no
keepDInstall You can specify that subdirectories of D:\Install with a particular prefix in the
SubdirsWithPrefix= directory name are not to be deleted after setup is completed.
[setupnames] NAME001= Specifies which files are setup packages and are to be included in the check of setup
NAME002= directories.
... You can specify entire file names with their file extensions or represent individual parts
of them with wildcard character *.
[setupexecution] checkSetupLogFile= Specifies whether a check is to be performed as to whether the file has already been
installed before the installation of a setup file.
The check is performed based on the computer name and the setup name of the setup-
specific log file.
copyToTmp You can specify whether setup files on removable disks are to be copied to a tempo‐
LocalSetupDir= rary, local directory before installation.
Setup files on network drives are always copied before installation.
[noactivation] APP001= Specifies which applications of the PCU Installer are inactive during operation.
APP002= This setting is required to prevent operation of the HMI software or another application
from being interrupted during execution of a setup.

5.8 PCU Installer

[processing_ StartState= Specifies whether the PCU Installer is active before the Desktop runs up.
loginphase] The setting StartState=activated is required, in particular, if an installation re‐
quires a cold start.
Possible values:
● activated PCU Installer starts setups
● stopped PCU Installer is stopped completely
continueSetups= Some setups can only be completed after the system has been restarted. In this case,
the PCU Installer waits until you restart the PC system.
You can specify here whether such setups are to be continued after a restart.
(See also: Note: Troubleshooting for incorrect installation routines (Page 103))
scanSetupDirs= Specifies whether setup directories are to be checked and, if required, setup files
executed before the Desktop run-up.
The following directories are checked if this setting has been activated:
● Local setup directories from the [local_setupdirs] setting are always checked.
● You can define separately whether additional directories on removable disks or
in the network are to be checked. (See settings "scanRemovableDriveSetupDirs"
and "scanNetworkDriveSetupDirs")
If you deactivate this setting, neither local directories, nor directories on removable
disks or in the network are checked, i.e. the setting scanSetupDirs=no overwrites, for
example, scanNetworkDriveSetupDirs=yes.
scanRemovableDrive Specifies whether directories on removable disks are to be checked from the setting
SetupDirs= [removable_setupdirs] and, if required, setup files executed before the Desktop run-
up.
The setting "scanSetupDirs" must also be activated so that these directories are
checked.
scanNetworkDrive Specifies whether network directories are to be checked from the setting [net_setup‐
SetupDirs= dirs] and, if required, setup files executed before the Desktop run-up.
checked.
waitTimeDevicesDete Specifies the maximum wait time for device detection (removable media) in the system
ction= run-up. This setting is only relevant if the PCU Installer searches for setups on remov‐
able media prior to the desktop run-up. (See settings "scanSetupDirs", "scanRemo‐
vableDriveSetupDirs" in the section [processing_loginphase] and section [remova‐
ble_setupdirs])
Possible values:
● Positive integer (milliseconds)
● infinite
waitTimeDriveLetter Specifies how long the PCU Installer will wait during the system run-up until the system
sAssignment= has assigned a drive letter to all of the logical drives. This setting is only relevant if the
PCU Installer searches for setups on removable media prior to the desktop run-up.
(See settings "scanSetupDirs", "scanRemovableDriveSetupDirs" in the section [pro‐
cessing_loginphase] and section [removable_setupdirs])
Possible values:
● Positive integer (milliseconds)
● infinite

5.8 PCU Installer

[processing_ StartState= Specifies whether the PCU Installer is active during operation of the Desktop.
systemphase] Possible values:
● activated PCU Installer starts setups
● stopped PCU Installer is stopped completely
You can define exceptions in Section "[noactivation]".
scanSetupDirs= Specifies whether setup directories are to be checked and, if required, setup files
executed during Desktop operation.
The following directories are checked if this setting has been activated:
● Local setup directories from the [local_setupdirs] setting are always checked.
● You can define separately whether additional directories on removable disks or
in the network are to be checked. (See settings "scanRemovableDriveSetupDirs"
and "scanNetworkDriveSetupDirs")
If you deactivate this setting, neither local directories, nor directories on removable
disks or in the network are checked, i.e. the setting scanSetupDirs=no overwrites, for
example, scanNetworkDriveSetupDirs=yes.
scanRemovableDrive Specifies whether directories on removable disks are to be checked from the setting
SetupDirs= [removable_setupdirs] and, if required, setup files executed during Desktop operation.
checked.
scanNetworkDrive Specifies whether network directories are to be checked from the setting [net_setup‐
SetupDirs= dirs] and, if required, setup files executed during Desktop operation.
checked.
numberOfScanCycles Specifies whether and how often the setup directories check for new setup packages.
Possible values:
● infinite Infinite
● Integer
You can define the waiting time between checks in key
waitTimeBetweenScanCycles
waitTimeBetween Specifies how long the PCU Installer waits after the setup directories have been
ScanCycles checked before checking them again.
Enter the waiting time in milliseconds.
In key numberOfScanCycles, you can specify how often the setup directories will
be checked.
report InfoLevel Specifies how detailed the information is to be which is stored in the log files.
Possible values:
● 1: Only basic information on the actions of the PCU Installer is logged
● 2: All PCU Installer-specific information is logged
● 3: All PCU Installer-specific information and some trace information is logged
● 4: All PCU Installer-specific information and additional trace information is logged
● 5: All PCU Installer-specific information and all trace information is logged

5.8 PCU Installer
5.8.6 Example configuration: Installation behavior as for PCU base software Windows
XP
If you want the automatic installation of setups to be configured in the same way as for the
PCU base software Windows XP, you can use the following configuration example in your
configuration file with higher priority.
[removable_setupdirs]
DIR001=E:\install
[processing_loginphase]
scanRemovableDriveSetupDirs=yes
You can deactivate all other entries of a PCUInst.ini with lower priority by entering the
appropriate key in your configuration file, but leaving the value empty. For example, to
deactivate DIR002=C:\Setup in a configuration file of lower priority, enter DIR002= in your
file.
You can make any number of adaptations in your file. See: Reference to the PCUInst.ini
configuration file (Page 99)
5.8.7 Installing software with the PCU Installer
Requirement
● The PCU Installer is activated
See: Activating the PCU Installer (Page 95)
● If you want to install multiple setup packages one after the other, you must have defined
multiple setup directories in the configuration file
● The setup directories to be used are empty and not write-protected
Procedure
To make the PCU Installer accessible to setup packages, proceed as follows:
1. Copy the setup packages to be installed into the setup directories. Copy each setup
package into a separate directory.
Note
Maximum length of the file path
The file path to a setup must not exceed 255 characters (including the file name).

5.8 PCU Installer
Result
The installation of the setup packages is started.
After a setup has been completed or cancelled, a specific log file is stored in the associated
setup directory. The general log files of the PCU Installer are also supplemented in the log
directory.
Further information
● Log files (.log) (Page 105)
● Procedure example of an installation with the PCU Installer (Page 104)
Note
Troubleshooting for incorrect installation routines
If completion of an installation requires a restart, but the installation cannot be completed after
the restart, the Service Desktop is not started.
In this case, restart the PCU 50.5 in protected mode to prevent the PCU Installer from starting.
(To start in protected mode, press F8 repeatedly during startup until a selection menu opens.)
Then reconfigure the PCU Installer or remove the setup packages.
5.8.8 Procedure example of an installation with the PCU Installer

The following example describes the activities of the PCU Installer if you have stored a setup
file on a removable disk or network drive after the activation and configuration of the PCU
Installer.
In this procedure example, it is assumed that you have already performed the following steps:
● You have activated the PCU Installer
● You have activated the checking of the network directories in the settings of the PCU
Installer and defined an additional setup directory on a network drive.
In the example: F:\Setup with F: as network drive.
● You have stored a setup file in this additional setup directory (e.g. F:\Setup\Update.exe).
● The setup directory is not write-protected.
Example: Activities of the PCU Installer during installation of a network drive

● The defined setup directories are checked.
● The Update.exe file is found in the F:\Setup directory.
As the Update.exe file has not been installed yet, there is no setup-specific log file in the
directory.
● The Update.exe file is copied to a local temporary directory, e.g. D:\Install39\Update.exe

5.8 PCU Installer
● The copied setup file is executed from the local temporary directory, e.g. D:
\Install39\Update.exe
● Log files are created after completion of the installation:
– The general log files are extended
– The setup-specific log file is created in the original setup directory F:\Setup and in the
local temporary directory D:\Install39
See: Log files (.log) (Page 105)
5.8.9 Log files (.log)

In order to be able to track which setup packages and updates have been installed at any time,
the activities of the PCU Installer are recorded in various log files.
Setup-specific log files

A separate setup-specific log file is created for each setup package that is executed by the
PCU Installer. The name of the setup and the name of the computer are entered in the file
name of the log.
Archiving The setup directory in which the associated setup file was originally
located, and (if copied by the setup) the local temporary directory.
File name The log file is designated according to the following scheme:
<Name of the setup file>@<Computer name>.log, e.g. Update@MyP‐
CU50.log
If you activate the checkSetupLogFile= setting in the "PCUInst.ini" configuration file (Page 99),
then the setup-specific log file prevents the same setup being installed several times on the
same computer. The check is performed based on the computer name and the setup name.
In the delivery condition of the base software, this setting is deactivated. The setting should
remain deactivated for the series start-up of devices with the same name or for the repair of
an installation.
General log files

The general PCU Installer log files record the operation and the communication of the PCU
Installer client and PCU Installer service. There are therefore separate files for the client and
service.
Archiving C:\ProgramData\Siemens\MotionControl\User\System
\Log\
File name PCU Installer client: PCUInstaller_C.log
PCU Installer service: PCUInstaller_S.log

5.9 Migration
5.9 Migration
Basic procedure
To transfer data from a PCU with Windows XP to a Siemens PC system with Windows 7, store
the data on a USB flash drive, for example, and then copy it to the PC system:
● For SINUMERIK Operate, use the functions for generating and reading in commissioning
archives.
● For STEP 7 V5.x, copy the generated STEP 7 project data onto the PC system.
Further information
● Information about how commissioning files work in SINUMERIK Operate can be found in
the SINUMERIK 840D sl SINUMERIK Operate Commissioning Manual (IM9), Chapter Data
backup.
● Information on STEP 7 V5.x can be found in the associated online help.
● Information about other SINUMERIK applications is provided in the relevant
documentation. You will find documentation on a large number of products in the SIEMENS
Service&Support portal:
Service&Support portal > CNC automation system SINUMERIK (http://
support.automation.siemens.com/WW/view/en/10805517/133300)

6.1 Overview
You can perform installation and commissioning work on the PC system in the Service Center,
which is based on Microsoft Windows PE.
When the Desktop is active, configuration of the Service Center is possible via the
"ServiceCenter Backup-Restore" (Page 51) icon.
Most of the functions of the Service Center are available in the main menu (Page 109).
In particular, you can create or restore disk images in the Service Center. The following options
are available:
● Create a disk image of the SSD (Page 114)
● Restore a disk image of the SSD (Page 116)
● Create a disk image of a partition (Page 118)
● Restore a disk image of a partition (Page 120)
The Service Center uses the Symantec Ghost (Page 125) software, which you can also call
separately.


To start the Service Center, proceed in one of the following ways:
● To call up the Service Center on the SSD while the PC system is starting, select the "Booting
Service System" during startup in the Windows boot menu.
● To call up the emergency boot system on a USB flash drive while the PC system is starting,
set the service switch to E or press F12 during startup to show the boot selection.
● To switch to the Service Center while the Service Desktop (Windows 7) is active, click the
"ServiceCenter Backup-Restore" icon on the Desktop and then click "Start ServiceSystem".

Overview
In the upper section of the Service Center main menu, you can select one of five tasks. Buttons
for additional functions are available in the lower section.
Figure 6-1 Service Center - Main menu
Table 6-1 Functions in the main menu of the Service Center

Disk Backup Create a disk image of the local SSD.
With this command, you can create a disk image of the entire SSD (with all partitions).
Disk Restore Restore the local SSD with an existing disk image.
With this command, you can restore the complete SSD (with all partitions) with a previously created disk
image.
Partition Backup Create a disk image of a partition on the local SSD.
With this command, you can create a disk image of an individual partition of the SSD.
Partition Restore Restore a partition on the local SSD with a disk image.
With this command, you can restore an individual partition of the SSD with a previously created disk image.


Log Files View and save log files.
About Viewing information about the Service Center.
Shell Open the prompt.
With this command, you can enter commands for executing tasks on the PC system without using a graph‐
ical user interface.
Network Making network settings (Page 111).
Any network settings you make in this dialog box are temporary. To change network settings permanently,
switch to the Service Desktop.
Reboot Restart the PC system.
Shutdown Shut down the PC system.
Note
Data backup and restore with CompactFlash cards
If there is a CompactFlash card in the slot of the PC system, you will not be able to back up
or restore data via the Service Center.
Instead, start the "ghost32.exe" program via the prompt of the Service Center.


You can make network settings in the main menu of the Service Center by clicking "Network":
● IP settings at the enterprise network interface X1 (Local Area Connection 2)
● IP settings at the plant network interface X2 (Local Area Connection)
● Configuration of the host
● Configuration of IP routing
Note
Temporarily storing network settings in the Service Center
Any network settings you make in this dialog box are immediately effective, but temporary.
To change network settings permanently, switch to the Service Desktop.
For further information, see Section Configuration of the Service Center (Page 51).
Overview
IP settings
You can make the following IP settings in the "Network Settings" dialog box:
Figure 6-2 Service Center - IP settings

Table 6-2 IP settings in the "Network Settings" dialog box

Adapter configuration Adapter Select the Ethernet interface that you want to
configure.
All settings in Section "Adapter configuration"
refer to the selected Ethernet interface.
DHCP Enabled Select whether the addresses are to be fetch‐
ed dynamically from the DHCP server.
If the checkbox is deactivated, you must
make the settings manually.
Address Set the IP address of the NCU.
You can specify an IP address from the fol‐
lowing range:
192.168.214.250 - 254
Subnet Specify a subnet mask, e.g. 255.255.255.0
A standard gateway creates a standard route
in the IP routing table for all destinations that
are not in the subnet.
A name server answers questions asked
about a domain name zone using a DNS da‐
tabase.
Host configuration Suffix Search List Parameterize a search list for DNS suffix, e.g.
"network.com".
The factory setting of the Ethernet interface
"Local Area Connection" is ".local".
Routing settings
You can make the following routing settings in the "Network Settings" dialog box:

Table 6-3 Routing settings in the "Network Settings" dialog box

Settings Purpose
Add Route Add a new route.
Remove Route Delete a selected route.
Destination Specify the network destination of the route as an IP address.
Mask Subnet mask of the specified IP addresses.
Next Next hop or forwarding IP address via which the network destination can be accessed.
Interface Select an interface to which the configured IP routing applies:
● Enterprise network interface X1 (Local Area Connection 2)
● Plant network interface X2 (Local Area Connection)
Metric Integer cost metric (1 to 9999). Required if several routes for sending a packet to a network destination are possible in
the routing table.
See also
Network settings (Page 9)
Release directory of the PC/PC in the network (Page 134)
Creating a shortcut to the network drive (Page 137)
Configuring routing in the network (Page 129)


You can create a disk image of the entire SSD in the Service Center with the "Disk Backup"
function.
Procedure
To save the SSD as a disk image, proceed as follows:
2. In the main menu of the Service Center, click "Disk Backup".
The "Service Center - Disk Backup" dialog box opens.
Figure 6-4 Service Center - Disk Backup


Base parame‐ Ghost version Select the Symantec Ghost version that is to be used when
ters creating the disk image:
● Version for Windows 7: "Ghost version 11.5.x"
● Version for Windows XP: "Ghost version 8.2.x"
Source disk Select a data medium of which you want to create a data image.
Base parame‐ Connect share Open the "Connect a Share" dialog box (Page 123).
ters > Destina‐ You can set up a shared resource (e.g. a directory in the net‐
tion file work), to which you can store the disk image.
Select destina‐ Open the "Select Destination File" dialog box.
tion You can navigate through a local directory of the PC system
Optional pa‐ Split image size Split the disk image and select a split image size.
rameters You can split the disk image into several files of a defined size.
● If the file system (e.g. FAT32) can only manage files of a
certain size.
● If the disk image is to be archived onto multiple data media,
for example, when using CDs.
of the "PCU-Basesoftware Windows XP" can be read in by Win‐
dows XP.
It is not possible to use a different operating system on a Sie‐
mens PC system other than the preinstalled system (e.g. Win‐
dows XP on a PCU 50.5 Windows 7).
Compress im‐ Activate Compression or select a compression level.
age Higher compression results in a smaller file size, but increases


Note
When you restore the PC system from a disk image, all programs, settings and files are
completely replaced by the disk image. You cannot restore individual files or exclude individual
files from restoration.
Requirement
A disk image exists
See: Create a disk image of the SSD (Page 114)
Procedure
To restore a disk image, proceed as follows:
2. In the main menu of the Service Center, click "Disk Restore".
The "Disk Restore" dialog box opens.


Base parame‐ Source file Select the disk image from which the SSD is to be restored.
ters You can use local disk images or disk images stored in the net‐
work.
Destination disk Select the SSD to be restored from the disk image.
ters > Destina‐ You can manage a shared resource (e.g. a directory in the net‐
tion disk work), to use a disk image stored on the network to restore the
SSD.
Select source Open the "Select Source File" dialog box.
You can navigate through a local directory of the PC system
Optional pa‐ Adjust partitions Select the partition scheme to be used when restoring the disk
rameters image on a PCU 50.x:
● If the PCU-Basesoftware Windows 7 is on the disk image,
choose "PCU Base Windows 7 partition scheme".
● If the PCU-Basesoftware Windows XP is on the disk image,
choose "PCU Base Windows XP partition scheme".
If you are using a different PC system than the PCU 50.5, you
must deactivate the "Adjust partitions" setting.
4. To start the restore process and entirely replace the existing data on the SSD with the disk
image, confirm the settings with "Restore".
Result
Note
If data transfer is interrupted during the restore process, the PC system will have no executable
system.
again.


You can create a disk image of an individual partition of the SSD in the Service Center with
the "Partition Backup" function.
Procedure
To save a partition of the SSD as a disk image, proceed as follows:
2. In the main menu of the Service Center, click "Partition Backup".
The "Service Center - Partition Backup" dialog box opens.
Figure 6-6 Service Center - Partition Backup


Base parame‐ Ghost version Select the Symantec Ghost version that is to be used when
ters creating the disk image:
● Version for Windows 7: "Ghost version 11.5.x"
● Version for Windows XP: "Ghost version 8.2.x"
Source partition Select a data medium of which you want to create a data image.
ters > Destina‐ You can set up a shared resource (e.g. a directory in the net‐
tion file work), to which you can store the disk image.
Select destina‐ Open the "Select destination file" dialog box.
tion You can navigate through a local directory of the PC system
Optional pa‐ Split image size Split the disk image and select a split image size (PCU 50.5
rameters only).
If you are using a PCU 50.5, you can split the disk image into
several files of a defined size.
● If the file system (e.g. FAT32) can only manage files of a
certain size.
● If the disk image is to be archived onto multiple data media,
for example, when using CDs.
If you are using a different PC system than the PCU 50.5, you
must deactivate the "Split image size" setting.
of the "PCU-Basesoftware Windows XP" can be read in by Win‐
dows XP.
Compress im‐ Activate Compression or select a compression level.
age Higher compression results in a smaller file size, but increases


Note
When you restore a partition from a disk image, all programs, settings, and files are completely
replaced on this partition by the disk image. You cannot restore individual files or exclude
individual files from restoration.
Requirement
A disk image of a partition exists
See: Starting the Service Center (Page 108)

Procedure
To restore a partition from a disk image, proceed as follows:
2. In the main menu of the Service Center, click "Partition Restore".
The "Partition Restore" dialog box opens.


Base parame‐ Source file Select the disk image from which the partition is to be restored.
ters You can use local disk images or disk images stored in the net‐
work.
Destination par‐ Select the partition to be restored from the disk image.
tition
ters > Destina‐ You can manage a shared resource (e.g. a directory in the net‐
tion partition work), to use a disk image stored on the network to restore the
SSD.
Select source Open the "Select source file" dialog box.
You can navigate through a local directory on the PC system
4. To start the restore process and entirely replace the existing data on the partition with the
Result
Note
If data transfer is interrupted during the restore process, the PC system will have no executable
system.
again.


To manage a disk image in the network, you can display a shared network directory on the
PC system as a drive.
In the Service Center, you configure network drives in the "Connect a share" dialog box. You
can call this dialog box directly from the relevant dialog boxes to both create (Page 114) and
restore (Page 116) disk images.
Requirement
The network directory is shared with the relevant user accounts in the domain and on the PC
system.
See also: Release directory of the PC/PC in the network (Page 134)
Overview
The setting options in the "Connect a share" dialog box have the following meaning:
Figure 6-8 "Connect a Share" dialog box

Table 6-4 Settings in the "Connect a Share" dialog box in the Service Center
Connection Local drive To select drive letters under which the network directories are to be accessible on the PC system.
Remote path Specify the device in the network and share name of the resource.
Credentials User name Enter the user account under which the resource in the network can be accessed.
If you have shared the resource on the server for certain users only, you must enter one of these user accounts
here.
Password Enter the password of the user account.
Further information
You will find information about releasing directories in the network and network drives in the
following chapters:
● Release directory of the PC/PC in the network (Page 134)
● Creating a shortcut to the network drive (Page 137)


With the "Symantec Ghost" software you can store the entire contents of an SSD as a disk
image. Disk images can be kept on various storage media for subsequent restoration of the
data on the SSD.
Symantec Ghost is included in the PCU base software scope of delivery and on the spare part
SSD for PCU. Symantec Ghost is used by the components of the PCU base software to back
up or restore data.
You can also start Symantec Ghost directly from the prompt to execute the data backup tasks
from the user interface of Ghost. This is necessary, for example, when using CompactFlash
cards.
Procedure
To start Symantec Ghost directly, proceed as follows:
1. Call the prompt from the Service Center or the Service Desktop.
2. Enter "ghost.32.exe" and confirm the entry.
Further information
More information is available in the Internet on website Ghost.com (http://www.ghost.com).

Usage
You can generate a bootable Service Center (Emergency Boot System) based on Microsoft
Windows PE on a USB flash drive as preventive measure against a defect.
The Ghost image for the creation of the bootable USB flash drive is on the installed PCU base
software at: D:\Eboot\eboot.gho
Requirement
● You have a USB flash drive (e.g. SIMATIC PC USB flash drive)
Procedure
To create a bootable USD flash drive, proceed as follows:
1. Connect the USB flash drive to a USB interface of the PC system.
2. Start Symantec Ghost, for example, by entering Ghost32.exe in the search bar in the
start menu.
3. In Symantec Ghost, select the "From Image" command from the "Local > Disk" menu.
4. Select D:\Eboot\eboot.gho as the source and the USB flash drive as the destination.
Result
The Emergency Boot System is installed on the USB flash drive and the data medium is
renamed to "EBOOT". The Service Center on the bootable USB flash drive can now be used.

6.12.1 Overview
System network
In the following applications, you will need, for example, a connection between the PC system
and a PG/PC in the system network:
● Save the disk image of the SSD to a PG/PC
● Restore the SSD of a PC system via the DVD drive of a PG/PC
● Start up the replacement SSD
● Install the software on the PC system via the DVD drive of a PG/PC
Company network
If you want to connect the service PG/PC via a company network (Local Area Connection 2;
interface X1), contact your network service center.
More information on the Windows Firewall settings in the company network can be found in
the section Adapting the firewall settings (Page 55).
6.12.2 Connection options in the system network
Overview
The following figures show the typical connection options in the system network:
● Service PG/PC with (twisted) Ethernet cable direct to interface "X2" of the Siemens PC
system.
● Service PG/PC with (non-twisted) Ethernet cable via switch to interface "X2" of the Siemens
PC system.

Configuration with PG/PC direct to the Siemens PC system (e.g. PCU 50.5)
3*3&
3ODQWQHWZRUN
;
3&8
&RPSDQ\QHWZRUN ;
Figure 6-9 Connecting a PG/PC directly to PCU 50.5
Configuration with PG/PC and switch direct to the Siemens PC system (e.g. PCU 50.5)
3ODQWQHWZRUN
7&8 3*3&
6ZLWFK
;
3&8
&RPSDQ\QHWZRUN
Figure 6-10 Connecting a PG/PC to PCU 50.5 via a switch
Note
If a PCU without its own OP/TP including TCU is switched off and then back on, and if this is
to be followed by the power up of the PCU of the service system (EBS), an external screen
and keyboard are needed to operate the PCU.
An external screen and keyboard are not needed if the TCUs are operating and the PCU is
not switched off with the EBS during booting.

Basic procedure
On the PG/PC with Windows 7:
● Connecting a PG/PC to a Siemens PC system according to one of the configurations shown
above.
● The network protocol used is: TCP/IP.
TCP/IP is already pre-configured on the Siemens PC system.
● Setting up IP addresses on the same subnetwork.
● Releasing a directory on the PG/PC for network access.
On the Siemens PC system in the Service Center (WinPE):
● On the PCU start the Service Center (WinPE).
● Establish a network connection to the shared directory of the PG/PC.
See: Functions of the Service Center (Page 109)
Further information
● Further information on the permissible network structures and network configurations can
be found in the SINUMERIK 840D sl Operator Components and Networking Manual.
6.12.3 Configuring routing in the network
Overview
If you have connected a PG/PC at interface X127 of the NCU, configure the network routing
to establish the connection between the PG/PC and the PCU.

7&8
6\VWHPQHWZRUN,QGXVWULDO(WKHUQHW
;
;
1&8 3&8
; ;
;
3*3&
&RPSDQ\QHWZRUN
Figure 6-11 A networking example using IP routing
Conditions
The following conditions must be met in order to use this function:
● The PG must be connected to interface X127 of an NCU in the system network.
● The NCU and PCU must be connected via the system network.
● On the NCU, the routing is activated in one of the following ways:
– In SINUMERIK Operate 4.5 SP2 or higher, the routing is configured in image "Settings
of the system network".
– In the configuration file basesys.ini, key EnableSysNetToIBNForwarding=1 is set.
● If you wish to access a network directory, it must be shared.
● The user account in question is known to the PG/PC.
● The Service Center is active.

Procedure
To configure the IP routing in the Service Center, proceed as follows:
1. In the main menu of the Service Center, click "Network".
2. In the "Network Settings" dialog box, click the "IP Routing" tab.
3. Configure the necessary routes. See also: Network settings in the Service Center
(Page 111)
Result
The routing has been configured and the PG/PC and Siemens PC system are connected via
the NCU.
Now, perform the desired steps, for example, a Restore a disk image of the SSD (Page 116).
6.12.4 Configure the network settings of the PG/PC

Once you have connected a PG/PC in the network, make the network settings on the PG/PC.
The basic procedure for setup under Windows 7 or Windows XP is described below. Detailed
information from Microsoft is provided in Windows under "Help and Support" or in the Internet:

Precondition
● The PG/PC is linked with the Siemens PC system in one of the following ways:
– The PG/PC is connected to the PC system with an Ethernet cable (either directly or via
a switch)
– The PG/PC is networked with the PC system via an interface on the NCU and the routing
is configured.
See: Configuring routing in the network (Page 129)
● A current Microsoft Windows operating system is installed on the PG/PC
● The PG/PC is switched on

Procedure
To configure the network settings of the PG/PC for connecting a PC system in the system
network, proceed as follows:
1. Open the "network connections" window:
– To do this under Windows XP: in the "Start > Control Panel > Network and Internet
Connections" menu, choose "Network Connections."
– To do this under Windows 7: in the Control Panel in category "Network and Internet >
View network status and tasks," choose "Change adapter settings."
2. Right-click on the network adapter you want to configure, then choose "Properties" from
the shortcut menu.
This opens the "Properties of <connection>" dialog box.
Figure 6-13 Properties of <connection>
3. Make the following settings:

– Click "File and Printer Sharing for Microsoft Networks."

– To change the IP address of the PG/PC, double-click "Internet Protocol Version 4 (TCP/
IPv4)", then configure the settings as follows:
Section Element Settings

Use the following IP ad‐ IP address The following IP addresses in the system net‐
dress work can be used for the PG/PC:
● 192.168.214.250
● 192.168.214.251
● 192.168.214.252
● 192.168.214.253
● 192.168.214.254
Subnet mask ● 255.255.255.0
Result
The network settings of the PG/PC are now configured for use with the Siemens PC system.
6.12.5 Release directory of the PC/PC in the network

If you want to, for example, store disk images on a PG/PC that you have linked to the Siemens
PC system via the network, set up a network drive.
As soon as it has been set up, a new drive will appear on the PC system, which is really a
directory on the PG/PC.
The basic procedure for setup under Windows 7 and Windows XP is described below. Detailed
Requirement
● There is sufficient space on the PG/PC for saving, for example, disk images from the PCU.
● The user accounts to which you want to grant share rights are known in the domain or on
the Siemens PC system.
Procedure
Proceed as follows to share a directory for use in the network:
1. On the PG/PC, in the Control Panel call up Computer Management.
2. Under "System > Shared Folders" select the file "Shares."
3. In the "Action" menu, click the "New File Share..." command.
The "Create A Shared Folder Wizard" opens.

4. Under step "Name, Description, and Settings," make a note of the Share path, which is a
combination of the computer name and the share name. You will have to specify this name
when you create a link to the network drive on the Siemens PC system.
Figure 6-14 Create A Shared Folder Wizard - Name, Description, and Settings

5. Under step "Shared Folder Authorizations," select the "Customize authorizations" radio
button, then click "Custom..."
Figure 6-15 Create a Shared Folder Wizard - Shared Folder Authorizations
The "Customize Authorizations" dialog box opens.
Figure 6-16 "Customize Authorizations" dialog box

6. In section "Group or user names," click "Add..."

The "Select Users, Computers, Service Accounts, or Groups" opens.
Figure 6-17 "Select Users, Computers, Service Accounts, or Groups" dialog box
7. In section "Authorizations for <user name>," under column "Allow," click the "Change"
checkbox.
8. Confirm these settings in the "Customize PermiAuthorizations" dialog box with "OK."
9. In the next steps of the wizard, make all the settings you require and confirm the share with
"Finish".
6.12.6 Creating a shortcut to the network drive

To be able to access the shared directory on the PG/PC from the Siemens PC system, after
you have connected and configured the PG/PC in the network, you must set up the folder
released on the PC system as a network drive.
As soon as it has been set up, a new drive will appear on the PC system, which is really a
directory on the PG/PC.
The basic procedure for setup under Windows 7 and Windows XP is described below. Detailed
Creating a shortcut to a network drive (association) (http://windows.microsoft.com/en-us/
windows7/create-a-shortcut-to-map-a-network-drive)
Requirement
● The folder on the PG/PC is shared for the relevant user accounts on the domain and on
the PC system.

Procedure
Proceed as follows to connect a shared directory as a network drive:
1. Start the Windows Explorer and click the "Map network drive" button.
2. Make the following settings in the "Map network drive" dialog box:
Settings Purpose
Drive To select drive letters under which the network directories are to be accessible
on the PC system.
Folder Specify the device in the network and share name of the resource.
Syntax: \\Name of the server\share name of the network
directory
Reconnect at logon Select this checkbox to automatically connect the network drive on booting.
Connect using dif‐ Select this checkbox if you have not shared the directory in the network with
ferent credentials the user for whom you would like to set up the network drive.
In the next dialog box "Enter Network Password," enter the log-on information
of a user with whom the network directory is shared.
3. Confirm your settings with "Finish."
See also


Information on the replacement or installation of an SSD can be found in the hardware
documentation for your PC system:
● SINUMERIK PCU 50.5
– Manual SINUMERIK 840D sl Operator Components and Networking
● SIMATIC IPC
– SIMATIC IPC627 operating instructions
– SIMATIC IPC427 operating instructions
Note
If data transfer is interrupted during the reading process, there will be no executable operating
system available on the Siemens PC system.
again.
See also
Network settings (Page 9)
Restore a disk image of the SSD (Page 116)


7.1 PCU Hardware Diagnostics
Intended use
The PCU hardware supports the diagnostics of important system components via an integrated
"safecard", which is designated as a Safecard-On-Motherboard (SOM).
Monitored Parameters
The following physical parameters of the PCU hardware are monitored:
● CPU temperature
● Housing temperature
● I/O chip temperature
● Speed of the two housing fans
● S.M.A.R.T - status of the hard disk
Logging faults
The PCU hardware monitor logs all hardware faults in the Windows event log so that the faults
can be output even without installing an HMI software.
The alarms are output in the log under "Control Panel" → "Administrative Tools" → "Event
Viewer".
See also
● Starting up the replacement SSD (Page 139)
● Operator Components and Networking Manual: Chapter, spare parts
● Description of the alarms: SINUMERIK 840D sl Diagnostics Manual

7.2 Evaluation of the diagnostic displays H1/H2

The PCU 50.5 has the diagnostics displays "H1" and "H2", which output status codes by means
of LEDs and 7-segment displays. In particular, these simplify the diagnostics of the PCU 50.5
in headless mode (without a screen or input devices).
If an error is found, you can connect a screen for further error analysis.
+ +
Figure 7-1 Diagnostics displays H1 and H2 of the PCU 50.5 with LEDs and 7-segment displays
The diagnostics displays display the following information:

● The diagnostics display "H1" displays status codes of the PCU-Basesoftware.
● The diagnostics display "H2" is assigned to the application software.
The meaning of the displayed status codes depends on whether the PCU 50.5 is in system
startup (Page 142) mode, running mode (Page 142), or shutdown (Page 142) mode.
Further information
Additional information on the diagnostics display, e.g. the meaning of the BIOS POST codes,
can be found in the Manual SINUMERIK 840D sl Operator Components and Networking.
Table 7-1 Status codes of the diagnostics display during the system power up

display H1/H2
Orange Orange Output of the After switching on the system
BIOS post co‐
des
Orange Off After cycling the BIOS
Orange Off After starting Windows
1 0 Starting Windows Loading of the device drivers
required by Windows
2 0 PCU hardware service The PCU hardware service has
been started.
5 0 Network Wait for network interfaces to
be ready
8 0 TCU support test step 1 Wait for FTP server to start
9 0 TCU support test step 2 Wait for TCU network boot proc‐
ess and starting of the TCU
hardware service
A 0 TCU support test step 3 Wait for VNC server to start


display H1/H2
B 0 - -
E 0 PCU-Basesoftware General fault: see Windows
"Event Viewer"
Table 7-2 Status codes of the diagnostics display during operation

display H1/H2
Flashing -- 0 0 OK
green
Flashing red -- Error:
1 0 Temperature alarm Housing or CPU temperature;
temperature above limit value
(SOM error)
2 0 Fan alarm Housing or CPU: Low fan
speed or fan failure (SOM error)
3 0 Hard disk alarm S.M.A.R.T hard disk error
6 0 VNC server failure or VNC serv‐
er service stopped
Table 7-3 Status codes of the diagnostics display during the shutdown process

display H1/H2
Flashing red/ -- 5 0 Shutdown in progress
green

7.3 Setting of the operating mode during run-up
7.3.1 Service switch (PCU 50.5)

The service switch on the PCU 50.5 is a rotary switch with 16 possible positions.
The "PCU Hardware Service" component as part of the PCU-Basesoftware provides a function
to read-out the switch positions.
The switch position on the hardware can be used to specify the operating mode for the run-up
of the PCU 50.5.
You can find the meanings of the switch positions under Possible operating modes
(Page 145).
Figure 7-2 Service switch
Further information
You can find details on the hardware of the PCU 50.5 in the Manual SINUMERIK 840D sl
Operator Components and Networking.

7.3.2 Possible operating modes

Only the settings of the service switch that are relevant for the commissioning engineer are
listed:
Switch setting Function

0 Normal mode (switch setting in delivery condition)
3 Desktop operation:
Run-up in the "SINUMERIK" splash screen which enables the desktop selection.
Relevant if HMI software is installed with autologon mode set.
See also: Switching to the Service Desktop during autostart / autologon opera‐
tion (Page 146).
9 Reset BIOS to factory settings
E Boot device at the USB interface, e.g. USB flash drive with emergency boot
system
See also: Bootable USB flash drive (Page 126)
7.3.3 Software-side setting (SIMATIC IPC)

In contrast to SINUMERIK PCUs, SIMATIC IPCs have no service switch on the hardware side
for selecting the mode. Therefore, on the SIMATIC devices, you can define the mode on the
software side in the configuration filepcuhwsvc.ini.
Archiving of the configuration file pcuhwsvc.ini

The template is located in directory C:\ProgramData\Siemens\MotionControl
Do not overwrite this template, but save a copy of the template pcuhwsvc.ini in one of the
user directories:
● C:\ProgramData\Siemens\MotionControl\user\System\etc\
● C:\ProgramData\Siemens\MotionControl\oem\System\etc\
● C:\ProgramData\Siemens\MotionControl\addon\System\etc\
You can find detailed information on the configuration files in Chapter: Directory structure and
file conventions (Page 13).
Table 7-4 Mode setting in configuration file pcuhwsvc.ini
Section [GLOBAL]
Key ModeSwitch=
Value 0 = Normal mode
3 = Desktop mode (startup in the welcome screen)
Other modes (Page 145) are not permitted in the software-side setting for SIMATIC IPC.
Factory setting 0

7.4 Switching to the Service Desktop during autostart / autologon operation
7.4 Switching to the Service Desktop during autostart / autologon

operation
If you have set up the autologon operation and the autostart of SINUMERIK Operate with the
activated keyboard filter, the PC system runs up with SINUMERIK Operate after being switched
on.
To be able to switch to the Windows desktop in this case, interrupt the startup of SINUMERIK
Operate with an entry, as described here.
Alternatively, you can switch the mode for the next startup on the hardware side (SINUMERIK
PCU 50.5) (Page 144) or on the software side (SIMATIC IPC) (Page 145).
Requirement
● SINUMERIK Operate is installed and autologon mode is set up.
See Chapter Setting up SINUMERIK Operate for autologon mode (Page 85).
● The PCU is switched off.

7.4 Switching to the Service Desktop during autostart / autologon operation
Procedure
To switch to the desktop when the autostart/autologon mode is activated, proceed as follows:
1. Switch on the PC system and wait until the "SINUMERIK" welcome screen is displayed.
2. While the "SINUMERIK" welcome screen is being displayed, make one of the following
entries:
– Press the key 3 on your keyboard.
– Click or tip the copyright information.
The counter for starting SINUMERIK Operate is suspended and you can select one of three
options:
Figure 7-3 Welcome screen "SINUMERIK" after key input
3. Select the "Display Desktop" option.
Result
The Service Desktop opens.

7.5 Remote access
7.5 Remote access
7.5.1 Overview
You can use a remote connection to access other devices via the network:
● Access to maintenance with prompt (SSH) via PuTTy.
● Access via VNC Viewer with all of the operating and servicing options, which are also
provided directly on the Siemens PC system.
See also
Setting up and using SSH (Page 151)
7.5.2 Searching for devices in the system network

The "sc_show_net" command shows devices available in the system network in the prompt
and offers additional information about these devices.
As both these functions rely on SNMP (Simple Network Management Protocol), only SNMP-
capable devices will be found. In the case of Windows-based devices, this depends on the
software version. If a simple call is made, without any additional options, a list of the devices
found will appear showing the relevant IP address, DNS name (if known), and a short
description (module name).
sc_show_net command
This command is executed in the prompt:
Syntax: sc_show_net [-xml] [-hw|-tco|-sw|-swfull|-loc|-panel| -dhcp|-

switch|-all] [HOSTS...]
7.5.3 Display of accessible stations in SINUMERIK Operate

You can use the network diagnostics function in SINUMERIK Operate to show accessible
nodes in the system network.

7.5 Remote access
Procedure
Proceed as follows to show accessible nodes:
1. Select "MENU SELECT" to open the menu.
2. In the horizontal softkey menu, choose "Diagnostics > Bus TCP/IP."
3. In the vertical softkey menu, choose "TCP/IP > Diagnostics Network > Accessible nodes."
The "Accessible nodes" screen opens showing all nodes that use the SNMP or DCP
protocol.
Further information
You will find Information about showing accessible nodes in SINUMERIK Operate in the
SINUMERIK 840D sl SINUMERIK Operate (IM9) Commissioning Manual, Section Service and
diagnostics.
7.5.4 Remote access to the PCU for operation and maintenance

With the VNC Viewer, you can remotely connect with devices which have an active VNC server,
e.g. PCU 50.5 or NCU.
● The remote access to the Siemens PC system from a PG/PC in the plant network
(Page 127) is activated via the factory setting. If you want to access the PCU 50.5 PC
system via the company network instead or in addition, you must adapt the firewall
settings (Page 61).
● With the factory settings, a system (e.g. PCU 50.5) can only be monitored via an external
VNC Viewer.
To operate the system from another station, the system in question must grant permission.
You make the necessary settings in the tcu.ini in section [VNCViewer].
Note
Defining a secure password for the VNC server
To access the PCU 50.5 by remote access, you require a password. The factory setting of the
password in the VNC Server on the PCU 50.5 is "password". Modify this password during
commissioning in the settings of the VNC server to avoid security risks.
Further information
● Further information on the permissible network structures and network configurations can
be found in the Operator Components and Networking Manual.

7.5 Remote access
Options for the VNC viewer
Note
Do not change the factory settings!
To ensure that the VNC viewer works properly, the following options must not be changed.
Table 7-5 Connection settings in the start dialog of the VNC Viewer
Option Factory setting

VNC Server 192.168.214.241
Quick Options AUTO (Auto select best settings)
Table 7-6 Further connection settings (button "Options...")
Option Factory setting

Format and Encoding Auto select best settings
Misc Share the Server
Mouse Buttons Emulate 3 Buttons (with 2-button click)
Mouse Cursor Let remote server deal with mouse cursor
Display Show Buttons Bar ("Toolbar")

7.5 Remote access
7.5.5 Setting up and using SSH

You can use remote access to access devices from the PCU.
An SSH environment is preinstalled when the PCU base software for Windows 7 is installed.
You can log on with PuTTy.
You can use an SSH key to log on. A script for setting up the infrastructure on devices is
provided. However, for security reasons no previously generated keys have been stored.

7.5 Remote access
Setting up remote access with SSH and key pair

The procedure for setting up users and using remote access is the same as the usual procedure
for remote access with SSH.
Table 7-7 Support with setting up remote access

Task Recommended application Storage path Help
Generate key pair PuTTy Key Generator C:\Program Files (x86)\PuTTy Online help in PuTTy
\puttygen.exe (Chapter Public key for pasting into au‐
thorized_keys file)
Set up infrastructure on devices Supplied script ssh_key_log‐ C:\ProgramData\Siemens\Mo‐ Call up the script via the prompt. To do
in.bat tion Control\siemens\etc. this, enter user name and file name of
\ssh_key_login.bat the public key as the parameters.
Syntax:
ssh_key_login.bat <user
name> <public key>
Example:
ssh_key_login.bat username
publicKey.pub
Access devices via remote con‐ PuTTy C:\Program Files (x86)\PuTTy Online help in PuTTy
nection \putty.exe
IP address of the PCU (factory setting):

● System network: 192.168.214.241
● Company network: IP address is
taken from the DHCP server
See also
Remote access (Page 148)
Encryption via SSH protocol (Page 152)
7.5.6 Encryption via SSH protocol
Security
The security of SSH is ensured by a series of cryptographic algorithms for encryption and
authentication.
Authentication
The server identifies itself to the client with an RSA, DSA or ECDSA certificate, which enables
detection of manipulation in the network (no other server can identify itself as a known server).
The client can authenticate itself either by public key authentication with a private key whose
public key is stored on the server, or with a normal password. While in the latter case, user
interaction is always necessary (unless the password is stored unencrypted on the client

7.5 Remote access
computer), public key authentication allows client computers to log on to SSH servers without
user interaction, without a password having to be stored in plain text on the client. However,
for added security the private SSH keys can also be protected with a password.
Subsystems
In the case of Secure Subsystem Execution, subsystems that were defined in an SSH server
installation can be executed remotely without knowing the precise path of the program
executed on the server. SFTP is the most common subsystem.
Further information
● Chapter Setting up and using SSH (Page 151).
● "NCU Operating System" Commissioning Manual (IM7).
● Description of PuTTy.

7.5 Remote access

Index
7 D
7-segment display, 142 DHCP, 9, 11
Diagnostics display, 142
Dialog box
A netplwiz, 87
ServiceCenter Backup/Restore, 51, 52, 53
Answer file, 20
Directory
Autologon, 20
C:\ProgramData, 13
Switch to Service Desktop, 146
D:\Install, 20
Autologon mode, 87
Disk image
AutoRepeat, 89
Restoring, 116, 120
DOS shell, (Prompt)
B
Backup time, 48
Batch file E
USVShutdown.bat, 43, 46
Emergency Boot System, 126, 145
Batch processing file, (Batch file)
BIOS
BIOS post code, 142
Factory setting, 145
F
Boot stick, 126 FirstLogonCommands, 20
C H
Color depth, 39 Hard disk
Command, (Command) Replacing, 139
control userpasswords2, 88 HMI software, 94
sc_show_net, 148
sc_usb disable, 31
sc_usb enable, 31 I
Command line, (Prompt)
Initialization files, (Configuration file)
Commissioning
Input area scheme, (Keyboard layout), (Keyboard
unattended, 20
layout)
USB flash drive, 20
Installation, (See Commissioning)
with identical settings, 20
Interface
Configuration file
Ethernet, 9, 11
Archive, 13
X1, 9, 11
basesys.ini, 130
X2, 9, 11
ghost.ini, 51
oemframe.ini, 94
pcuhwsvc.ini, 89, 145
PCUInst.ini, 95, 97, 98, 99
K
servicesystem.ini, 51, 52, 53 Key, (Repeat function)
tcu.ini, 34, 35, 39, 40, 149 Key filter, 89
Templates, 13 Key filter, 89

Index
Keyboard layout, 32, 85 Configure for VNC server, 149

Kiosk mode, (Autologon mode; key filter) For network drive, 123
For unattended installation, 20
Password reset diskette, 28
L unattend.xml, 20
PCU
Language
Checking the hard disk, 141
Configuring the keyboard layout, (Keyboard
PCU Installer
layout), (Keyboard layout)
Activating, 95, 97
Language bar, (Keyboard layout), (Keyboard layout)
Configuring, 98, 99
Log file
Log file, (Log file), (Log file)
PCUHardwareservice.log, 90, 91, 92
PCUInst.ini, 99
PCUInstaller_C.log, 102, 104, 105
PCUInstaller_S.log, 102, 104, 105
Using, 103
Setup-specific, 104
Port 80 display, (See 7-segment display)
Log File, (Log file), (Log file)
Power-up
Operating mode during run-up, 145
Prompt
M Open, 31
Mode of operation
Headless mode, 20
Multitouch, 40 R
Remote access, 149
Via VNC server, 149
N With SSH encryption, 151
Network Response file
Adapting settings, 30, 52, 53 unattend.xml, 23
Company network, 9, 11
Domain, 30
IP address, 30 S
System network, 9, 11
Screen resolution, 34, 35
Network protocol
Service Desktop, 146
SNMP, (SNMP)
Service switch, 144, 145
Network release
Service system for PCU, 126
Driven on PG/PC, 134
Shutdown, 42
Network security
SINUMERIK Operate
Define password for VNC server, 149
Unattended installation, 20
SITOP UPS, 42
Softkey, 94
O SSD
OEM Replacing, 139
Configuration, 94 SSH encryption, 151, 152
Operating mode, 145 Startup
Autologon mode, (Autologon mode) Initial startup, 20
Service switch, 144 STEP 7, 94
P T
Password, (Password) Troubleshooting
Administrator account, 20, 28 PCU Installer, 97, 104
Authentication for SSH encryption, 152 Restore failure, 117, 122

Index
U
Uninterruptible power supply, 42
USB FlashDrive, 126
USB interface
Activating, 31
Disabling, 31
User account, (Setting up for autologon mode)
Setting up, 27, 28
Setting up for autologon mode, 85
User administration, 28
V
VNC Viewer, 149
X
XML
Response file, 20
unattend.xml, 20
XML file
unattend.xml, 20, 23

Index

Appendix A
A.1 Documentation overview

840D OPCUA en en-US

Uploaded by

Copyright:

Available Formats

840D OPCUA en en-US

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

840D OPCUA en en-US

Uploaded by

Copyright:

Available Formats

Basesoftware and operating software ___________________

Siemens AG Order number: 6FC5397-1DP40-5BA3 Copyright © Siemens AG 2006 - 2015.

My Documentation Manager (MDM)

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

1.2 Handling electrostatic sensitive devices (ESD)

Basesoftware and operating software

1.3 Industrial security

1.4 Residual risks of power drive systems

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Basesoftware and operating software

Machine and setting data 7

10/2015 Continued on next page

Service and diagnostics 17

OEM-specific online help 18

Siemens AG Order number: 6FC5397-1DP40-5BA3 Copyright © Siemens AG 2006 - 2015.

SINUMERIK Operate (IM9)

5.2 Setting EXTCALL...................................................................................................................52

SINUMERIK Operate (IM9)

8.7.1 Activating block search mode................................................................................................95

SINUMERIK Operate (IM9)

12.2.2.5 Magazine location parameter identifiers..............................................................................158

SINUMERIK Operate (IM9)

SINUMERIK Operate (IM9)

14.7.3.6 File and parallel 3D file protection area element..................................................................284

SINUMERIK Operate (IM9)

16.6.4.1 Diagnostics of the network and DHCP server......................................................................340

SINUMERIK Operate (IM9)

17.12.2.2 Saving the trace file..............................................................................................................403

SINUMERIK Operate (IM9)

20.2.2 Display SGE/SGA signals....................................................................................................455

SINUMERIK Operate (IM9)

21.8.2 Setting up a kinematics transformation................................................................................561

SINUMERIK Operate (IM9)

24.3 Configuring the function display at user-specific keys (U keys)...........................................630

SINUMERIK Operate (IM9)

SINUMERIK Operate (IM9)

SINUMERIK Operate (IM9)

1.2 System requirements

SINUMERIK Operate under Windows

SINUMERIK Operate (IM9)

SINUMERIK Operate (IM9)

SINUMERIK Operate (IM9)

SINUMERIK Operate (IM9)

2.2 Editing files

2.2.1 Editing the file at the controller

Copying / pasting / opening a file

1. Select the "Start-up" operating area.

2. Press the "System data" softkey.

SINUMERIK Operate (IM9)