Content      ..     38      39      40      41     ..

SINUMERIK 840D sl. Service - Configuring Commissioning. Manual (2011-2020) - page 40

Service and diagnostics

16.5 Machine identity

Copy file

1.

Select the "Start-up" operating area.

2.

Press the "System data" softkey.

3.

Open the folder specified above, and select the required screenshots.

4.

Press the "Copy" softkey.

- OR -

Press the "Cut" softkey.

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".

16.5

Machine identity

Important information about the machine that was previously only available on paper can now

be stored electronically, e.g. for an end-user certificate. When the equipment is serviced, these

entries can be viewed by means of remote diagnostics or can be transmitted for the purpose of

registering the machine on the Siemens Service Platform Industry.

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 enter the data manually or import it from templates.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

291

Service and diagnostics

16.5 Machine identity

Procedure

1.

Select the "Diagnostics" operating area.

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.

4.

Press the "Change" softkey.

The "IdentSNAPSHOT" window opens.

5.

Enter the machine name and the machine type.

- or -

Import a template: Import template (Page 295)

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 "Manufac-

turer 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 template: Import template (Page 295)

Press the "OK" softkey to save the changes.

See also

1. Documenting startup (Page 301)

2. Defining start-up (Page 301)

Making a logbook entry (Page 302)

16.5.2

Create a template

You use the templates to prepare the machine information and address information and transfer

it to the controller. This means that it does not have to be manually entered.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

293

Service and diagnostics

16.5 Machine identity

Templates

You have the capability of importing files with any name. The content of the files is evaluated.

The new file name is derived from the contained 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

1.

Select the "Diagnostics" operating area.

2.

Press the "Version" softkey.

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.

5.

Select the appropriate drive and the required file.

6.

Press the "OK" softkey.

The file is automatically copied to the correct location in the system.

If the template 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 template 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.

The selection or the manual change is confirmed and saved.

See also

Create a template (Page 293)

SINUMERIK Operate

296

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.5 Machine identity

16.5.4

Save information

All the machine-specific information of the control is combined in a configuration via the user

interface. You then have the option of saving the machine-specific information on the drives that

have been set up.

Procedure

1.

Select the "Diagnostics" operating area.

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 "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.

7.

Specify the desired settings.

• "Name:" input 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.

• "Comment:" input field

You can enter a comment that is stored with the configuration data.

• Version data (.TXT)

Activate the checkbox if you wish to output the pure version data in the

text format.

• Configuration data (.XML)

Activate the checkbox if you wish to output the configuration data in

the XML format.

The configuration file contains the data you entered under Machine

identity, the license requirements, the version information and the

logbook entries.

8.

Press the "OK" softkey to start the data transfer.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

297

Service and diagnostics

16.5 Machine identity

Procedure

1.

Select the "Diagnostics" operating area.

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.

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 Service Platform Industry 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 Service Platform Industry 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

7.

Press the "OK" softkey.

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+.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

299

Service and diagnostics

16.6 Logbook

16.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 292)

16.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.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

301

Service and diagnostics

16.7 Action log

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

Procedure

1.

Select the "Start-up" operating area.

2.

Press the "HMI", "Diagnostics", and "Action log" softkeys

The "Action Log Settings" window opens.

The "Data selection" area is active by default.

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.

16.7.2

Inserting variables

In the "Action Log Settings" window, you can insert up to 50 variables that you want to log or

monitor.

You select available variables from the drop-down list or add them manually to the list.

Inserting variables from a variable list

1.

You are in the "Action Log Settings" window.

2.

Press the "Variable selection" softkey.

The "Variables for ongoing monitoring" window opens.

3.

Press the "Insert variable" softkey to insert a variable from a list of all

existing variables.

The "Select variable" window opens.

4.

Select the desired variable from the list.

5.

Click on the "Insert" softkey.

The "Variable properties" window opens.

6.

Accept or, if necessary, change the displayed properties, for example, the

axis assignment.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

305

Service and diagnostics

16.7 Action log

You will find the saved files in the HMI data folder under /logs/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.

16.7.4

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.

Additional search option

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.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

307

Service and diagnostics

16.7 Action log

16.7.5

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.

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.

16.7.6

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

SINUMERIK Operate

308

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.7 Action log

Entry

Description

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

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 display"

ALARM_OFF

Entry of an alarm going event

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 des-

ignated with an "-".

Entry text

Event data is written in plain text.

DETAILS

If additional information regarding an entry is known, e.g. a

recorded 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

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

309

Service and diagnostics

16.9 PROFIBUS diagnosis

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 ms; defines the position control cycle clock at

the same time.

Sync. Component (TDX)

Configured interval in ms for the cyclic data exchange within a PROFIBUS DP

cycle.

PROFIBUS diagnostics/slaves

Slave address

Configured number of the DP slave

Assignment

Information as to 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 as to whether the DP slave is identified on the bus via the com-

munication state.

Green: DP slave has been detected on the PROFIBUS DP and data ex-

change with the assigned component (NC and/or PLC) is working error-free

Red: Incorrect response / no communication

Synchr. with NC

Information as to 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

Further information

Further information about the configuration of the properties of the network interface for

PROFIBUS can be found in

CNC Commissioning Manual: NCK, PLC, drive.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

313

Service and diagnostics

16.9 PROFIBUS diagnosis

Procedure

1.

Select the "Diagnostics" operating area.

2.

Press the menu forward key and the "Bus TCP/IP" softkey.

The "PROFIBUS Diagnostics" window opens.

3.

If multiple PROFIBUS connections have been configured, press the "Bus -"

or "Bus +" softkey to select the configuration you require.

- OR -

Press the "Select bus" softkey and, when the list is displayed, select the

required configuration in it.

Press the "OK" softkey.

16.9.1

Displaying details for DP slaves

Further information about the slots of a selected DP slave is displayed here.

Display

Meaning/information

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

SINUMERIK Operate

314

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.10 Drive system

Display

Meaning/information

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

1.

Select the "Diagnostics" operating area.

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.

4.

Press the "Details" softkey.

The "PROFIBUS Diagnostics ... - Details" window is opened.

16.10

Drive system

16.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.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

315

Service and diagnostics

16.10 Drive system

Display icon

Meaning

Gray

The drive status could not be determined for this drive object.

#

Special charac-

Error when reading the data.

ters

Procedure

1.

Select the "Diagnostics" operating area.

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 316)

16.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.

SINUMERIK Operate

316

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.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

Display icon

Meaning

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

1.

Select the "Diagnostics" operating area.

2.

Press the menu forward key and the "Drive system" softkey.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

317

Service and diagnostics

16.11 Remote diagnostics

6,180(5,. 2SHUDWH

RQ 3&8

;

;

1&8

;

7HOHVHUYLFH DGDSWHU

6HUYLFH 3&

Figure 16-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.

;

;

;

VW 1&8

QG 1&8

Q 1&8

;

7HOHVHUYLFH DGDSWHU

6HUYLFH 3&

Figure 16-3

System with several NCUs and a fixed modem

The "Access MyMachine /P2P" 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

SINUMERIK Operate

320

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.11 Remote diagnostics

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

RQ VW 3&8

RQ QG 3&8

RQ UG 3&8

;

;

;

;

;

;

VW 1&8

QG 1&8

Q 1&8

;

7HOHVHUYLFH DGDSWHU

6HUYLFH 3&

Figure 16-4

System with several NCUs, several PCUs and a fixed modem

The "Access MyMachine /P2P" 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.

16.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

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

321

Service and diagnostics

16.12 Trace

16.12.2

Trace session

16.12.2.1

Creating a session file

Procedure

1.

Select the "Diagnostics" operating area.

2.

Press the menu forward key and the “Trace" softkey.

3.

Press the "Load trace" and "New" softkeys.

The "New Session" window opens in which the "Session" name is recom-

mended. The file format is automatically specified as ".xml".

4.

Supplement the file name or enter a new file name.

5.

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 326)

16.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 335)", the session file is saved as a csv file in addition to xml format.

SINUMERIK Operate

324

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.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 stor-

age 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.

Press the "OK" softkey.

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.

16.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.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

325

Service and diagnostics

16.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.

Press the "OK" softkey.

The data of the selected session are loaded displayed in the "Trace" win-

dow.

16.12.3

Variable for trace

16.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, ...

SINUMERIK Operate

326

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.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 "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 param-

eters.

4.

Press the "Filter/search" softkey to start a specific search.

In the "Filter" selection box, select a variable area.

- OR -

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

327

Service and diagnostics

16.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 an-

other one.

6.

Press the "OK" softkey to add or replace the variable.

Each variable is automatically allocated a reference number, which is dis-

played in the upper section of the window. This number is opened auto-

matically allocated. If a version is removed, then the following variables

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

cut out a variable.

or right-click, shortcut menu "Cut"

Ctrl + C

Press the key combination or open the shortcut menu in order to

copy a variable.

or right-click, shortcut menu "Copy"

Ctrl + V

Press the key combination or open the shortcut menu in order to

insert a variable.

or right-click, shortcut menu "Paste"

16.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.

SINUMERIK Operate

328

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.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

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

329

Service and diagnostics

16.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.

16.12.3.3

Displaying details of a variable

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, and press the "Details" softkey.

A subscreen with the most important information as well as the graphic

display is shown in the lower half of the window.

3.

Press the "Details" softkey again to display the subscreen.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

331

Service and diagnostics

16.12 Trace

16.12.4

Trace settings

16.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" softkey 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, descending,

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, descending,

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)

SINUMERIK Operate

332

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.12 Trace

Condition for Start trace

With "Start trace" softkey

The recording is started immediately after pressing the "Start

trace" softkey.

If variable

The recording is activated after pressing the "Start trace" soft-

key when the selected variable clearly satisfies the condition

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 dura-

tion 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 ef-

fective sampling rate. With a higher sampling rate, the record-

ing 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.

SINUMERIK Operate

334

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.12 Trace

• 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.

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.

16.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

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

337

Service and diagnostics

16.12 Trace

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.

16.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

1.

A recording is opened in the "Trace" graphics window.

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 -

SINUMERIK Operate

338

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.12 Trace

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

appropriate property.

5.

Press the "Scale" softkey to save the settings.

- OR -

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.

16.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

1.

A recording is opened in the "Trace" graphics window.

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 -

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

339

Service and diagnostics

16.12 Trace

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 -

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.

16.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

1.

A recording is opened in the "Trace" graphics window.

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.

SINUMERIK Operate

340

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.12 Trace

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.

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.

16.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.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

341

Service and diagnostics

16.13 PROFIBUS/PROFINET and AS-i bus diagnostics

16.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

1.

Select the "Diagnostics" operating area.

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.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

343

Service and diagnostics

16.13 PROFIBUS/PROFINET and AS-i bus diagnostics

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.

16.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

SINUMERIK Operate

344

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.13 PROFIBUS/PROFINET and AS-i bus diagnostics

[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.

16.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 Advanced 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 OK

Internal EEPROM OK

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

SINUMERIK Operate

346

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Service and diagnostics

16.13 PROFIBUS/PROFINET and AS-i bus diagnostics

Flags acc. to the AS-i specification

Description

Operating mode

Operating mode state

Auto.-Addr.progr. executed

Automatic address assignment executed

Auto-Addr.progr. possible

Automatic address assignment possible

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

1.

Select the "Diagnostics" operating area.

2.

Press the menu forward key twice and the "AS-i diag." softkey.

The "Diagnostics AS-Interface" window opens.

3.

Select the required DP AS-Interface.

The complete diagnostics information is displayed.

The values in italics indicate an error counter > 0.

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

347

OEM-specific online help

17.2 Generating HTML files

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

backg24round color

<color>

Background color for elements

backg24round-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 right-hand edge of the paragraph in

pixels

vertical-align

baseline | sub | super | middle

Vertical alignment for text (in tables, only the val-

| 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

backg24round

[ <'backg24round-color'> ||

Short notation for backg24round property

<'backg24round-image'> ]

page-break-before

[ auto | always ]

Page break before a paragraph/table

page-break-after

[ auto | always ]

Page break after a paragraph/table

backg24round-image

<uri>

Background image for elements

SINUMERIK Operate

352

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

OEM-specific online help

17.3 Generating the help book

Supported CSS selectors

All of the CSS 2.1 selector classes are supported, with the exception of so-called pseudo-selector

classes, such as :first-child, :visited and :hover.

17.3

Generating the help book

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 con-

I

straint that no name predefined by the system is used (such as sinu-

I

merik_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 entry

I

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

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

353

OEM-specific online help

17.3 Generating the help book

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.

<?xml version="1.0" encoding="utf-8"?>

<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>

<ENTRY ref="section_2.html" title="Section 2">

<INDEX_ENTRY ref="section_2.html#Keyword_3" title="Keyword_3"/>

</ENTRY>

<ENTRY ref="section_3.html" title="Section 3">

<ENTRY ref="section_31.html" title="Section 31">

INDEX_ENTRY ref="section_31.html#test" title="test;section31"/>

</ENTRY>

<ENTRY ref="section_32.html" title="Section 32">

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.

SINUMERIK Operate

354

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

OEM-specific online help

17.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"/>

17.4

Integrating the online help in SINUMERIK Operate

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

type

Data type of the value (QString)

III

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

SINUMERIK Operate

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

355

OEM-specific online help

17.4 Integrating the online help in SINUMERIK Operate

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

0, 1

value

true, false

III

type

type, data type of the value (bool)

III

III-DisableIndex

Disable the subject index for the help book.

III

Attributes:

III

0, 1

value

true, false

III

III

type

type, data type of the value (bool)

III-DisableContent

Disable the table of contents for the help book.

III

Attributes:

0, 1

III

value

true, false

III

type

type, data type of the value (bool)

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.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<!DOCTYPE CONFIGURATION>

<CONFIGURATION>

<OnlineHelpFiles>

<hmi_myHelp>

<EntriesFile value="hmi_myhelp.xml" type="QString"/>

<DisableIndex value="frue" type="bool"/>

</hmi_myHelp>

</OnlineHelpFiles>

</CONFIGURATION>

SINUMERIK Operate

356

Commissioning Manual, 10/2020, 6FC5397-1DP40-6BA4

Content      ..     38      39      40      41     ..