Professional Documents
Culture Documents
SIMATIC Project Insight DEMO-V1.0.3.0 DOC EN
SIMATIC Project Insight DEMO-V1.0.3.0 DOC EN
Siemens
DEMO Version Service Pack 3 Industry
Online
https://support.industry.siemens.com/cs/ww/en/view/109818320 Support
Legal information
Legal information
Use of application examples
Application examples illustrate the solution of automation tasks through an interaction of several components in
the form of text, graphics and/or software modules. The application examples are a free service by Siemens AG
and/or a subsidiary of Siemens AG ("Siemens"). They are non-binding and make no claim to completeness or
functionality regarding configuration and equipment. The application examples merely offer help with typical
tasks; they do not constitute customer-specific solutions. You yourself are responsible for the proper and safe
operation of the products in accordance with applicable regulations and must also check the function of the
respective application example and customize it for your system.
Siemens grants you the non-exclusive, non-sublicensable, and non-transferable and time-limited right to have
the application examples used by technically trained personnel until December 31, 2024. After the license period
the use of the application examples is prohibited and technically not possible anymore. After this period Siemens
may at its own discretion stop distribution of this application examples, provide new application examples free of
charge/ fee-based and/or offer a product which contains the functionality of the application examples Any change
to the application examples is your responsibility. Sharing the application examples with third parties or copying
the application examples or excerpts thereof is permitted only in combination with your own products and only
during the license period. The application examples are not required to undergo the customary tests and quality
inspections of a chargeable product; they may have functional and performance defects as well as errors. It is
your responsibility to use them in such a manner that any malfunctions that may occur do not result in property
damage or injury to persons.
Disclaimer of liability
Siemens shall not assume any liability, for any legal reason whatsoever, including, without limitation, liability for
the usability, availability, completeness and freedom from defects of the application examples as well as for
related information, configuration and performance data and any damage caused thereby. This shall not apply in
cases of mandatory liability, for example under the German Product Liability Act, or in cases of intent, gross
negligence, or culpable loss of life, bodily injury or damage to health, non-compliance with a guarantee,
fraudulent non-disclosure of a defect, or culpable breach of material contractual obligations. Claims for damages
© Siemens AG 2024 All rights reserved
arising from a breach of material contractual obligations shall however be limited to the foreseeable damage
typical of the type of agreement, unless liability arises from intent or gross negligence or is based on loss of life,
bodily injury or damage to health. The foregoing provisions do not imply any change in the burden of proof to
your detriment. You shall indemnify Siemens against existing or future claims of third parties in this connection
except where Siemens is mandatorily liable.
By using the application examples you acknowledge that Siemens cannot be held liable for any damage beyond
the liability provisions described.
Other information
Siemens reserves the right to make changes to the application examples at any time without notice. In case of
discrepancies between the suggestions in the application examples and other Siemens publications such as
catalogs, the content of the other documentation shall have precedence.
The Siemens terms of use (https://support.industry.siemens.com) shall also apply.
Security information
Siemens provides products and solutions with industrial security functions that support the secure operation of
plants, systems, machines and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is necessary to implement –
and continuously maintain – a holistic, state-of-the-art industrial security concept. Siemens’ products and
solutions constitute one element of such a concept.
Customers are responsible for preventing unauthorized access to their plants, systems, machines and networks.
Such systems, machines and components should only be connected to an enterprise network or the internet if
and to the extent such a connection is necessary and only when appropriate security measures (e.g. firewalls
and/or network segmentation) are in place.
For additional information on industrial security measures that may be implemented, please visit
https://www.siemens.com/industrialsecurity.
Siemens’ products and solutions undergo continuous development to make them more secure. Siemens strongly
recommends that product updates are applied as soon as they are available and that the latest product versions
are used. Use of product versions that are no longer supported, and failure to apply the latest updates may
increase customer’s exposure to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS Feed under
https://www.siemens.com/cert.
Table of contents
Legal information ......................................................................................................................... 2
1 Introduction ........................................................................................................................ 5
1.1 Overview ............................................................................................................... 5
1.2 Mode of operation.................................................................................................. 6
1.3 Components used ................................................................................................. 7
2 Navigation........................................................................................................................... 8
2.1 Navigation ............................................................................................................. 8
2.2 Call Structure....................................................................................................... 11
2.3 Sequence Analytics ............................................................................................. 12
2.4 Signal Flow.......................................................................................................... 13
2.5 UDT Dependencies ............................................................................................. 14
2.6 Query Builder ...................................................................................................... 15
2.7 Unit Relations View ............................................................................................. 16
2.8 Project Structure.................................................................................................. 17
2.9 Global Objects Dependencies.............................................................................. 18
© Siemens AG 2024 All rights reserved
SIMATIC Project Insight (Figure 1-1) analyzes TIA Portal V14 SP1, V16, V17, V18 and V19
versions of projects, accepts TIA Portal Engineering projects as inputs and helps users to
understand the complexity and poor design of the engineering projects by providing insights in
the form of visualizations. The same insights can also be exported in the form of JSON for
further downstream analysis.
Customer Benefits:
• Quick insights on the engineering project.
• Better understanding on the anomalies of the engineering project.
• Helps to uncover the complex design of the engineering projects.
© Siemens AG 2024 All rights reserved
Sequence Analytics
Visualize the STEP 7 GRAPH (S7-GRAPH) transitions as a tree structure for the given PLC and
can be exported in the form of JSON for downstream analysis, see Figure 4-2.
Signal Flow
Helpful when the UDTs datapoints or the UDTs itself are treated as real-world materials/object
in the automation line. The signal flow visualization helps to understand the flow of the UDTs
datapoints as parameters across blocks which are calling the UDTs. The datapoints of the
signal flow can also be exported in the form of JSON for downstream analysis, see Figure 4-3
UDT dependencies
The type dependencies, Instance dependencies of the UDT and the data points which are
read/written by the UDTs are visualized. The datapoints of the interest of the UDTs can also be
exported in the form of JSON for downstream analysis, see Figure 4-4.
© Siemens AG 2024 All rights reserved
Query Builder
The user is allowed to write his/her own queries targeting a custom search in the engineering
project concerning plc data points. The queries can be saved, opened for later use and the data
points queried can be exported in the form of JSON for downstream analysis, see Figure 4-5.
Project Structure
Export all the engineering objects (such as organizational blocks, function blocks, function calls,
data blocks, user defined types and tags), in the form of JSON for further analysis,
see chapter 4.9.
System requirements
The recommended hardware and software are listed in the following table.
Network 1 Gbit
8
© Siemens AG 2024 All rights reserved
The result after the extraction you find in Figure 2-2 on the next page.
In the next Figure 2-3, you see the available functions for the TIA Project after extraction.
1. The required PLC that needs to be analyzed is selected from the drop-down.
2. The functions are available as tiles.
3. The functions are available in the carousels.
4. It is easily to understand the internal background actions via the logs.
1 8
5
© Siemens AG 2024 All rights reserved
1. The call structure can be centered, fit to screen & the highlighted nodes can be reset.
2. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
3. The views provide user with options to view the full call structure/sub call structure, the user
can also type the block name to view the sub call structure of the block.
4. The "Block Criticality" toggle enables the view of blocks ranked based on the criticality with
Top 10 critical blocks displayed on the top right. The uncalled blocks in the call structure are
also listed here.
5. The legends represent the color of the blocks in accordance with the TIA portal block colors.
6. A different project can be analyzed using the link "Change Project".
7. The blocks can be hovered and selected to understand the block properties and
highlighting.
8. The logs, top 10 critical blocks are available for the user at the top right of the application.
NOTE The functions of the "Call Structure", you find in chapter 4.1.
6
© Siemens AG 2024 All rights reserved
1. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
2. The expand button is used to expand the blocks of the PLC.
3. The collapse button is used to collapse the blocks of the PLC to parent level.
4. The TIA PNV objects are displayed in tree form.
5. All nodes starting from parent nodes to child nodes are displayed.
6. The S7-GRAPH blocks sequences and transitions are visualized in tree form.
7. The datapoints obtained are added to the export cart.
8. The datapoints visualized are exported in the form of JSON file using the export cart.
9. A different project can be analyzed using the change project link.
NOTE The functions of the "Sequence Analytics", you find in chapter 4.2.
4
© Siemens AG 2024 All rights reserved
1. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
2. The User Defined Datatype (UDT) that needs to be analyzed is selected from the drop
down, a partial name of the user defined type can also be typed in to get all the types
matching the name.
3. Press the Arrow button to start analyzing the UDT.
4. The UDT datapoints which are used as Input parameters to the blocks are visualized here.
5. Hover on the block to understand the properties of the block.
6. All signal flows can be visualized using this option.
7. Individual signal flows can be visualized using this option.
8. The datapoints can be added to the export cart for export.
9. The datapoints visualized are exported in the form of JSON file using the export cart.
NOTE The functions of the "Signal Flow", you find in chapter 4.3.
4 5 7
6 8
© Siemens AG 2024 All rights reserved
1. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
2. The User Defined Datatype that needs to be analyzed is selected from the drop down, a
partial name of the user defined type can also be typed in to get all the types matching the
name.
3. Press the arrow button to start analyzing the UDT.
4. The type dependencies of the UDT that uses the UDT and the UDTs that are dependent on
this UDT are shown here.
5. The datapoints of the UDT that are read as members in blocks are shown here.
6. The datapoints of the UDT that are written as members in blocks are shown here.
7. The blocks which read the UDTs datapoints are shown here.
8. The blocks which write the UDTs datapoints are shown here.
9. The UDTs datapoints visualized are exported in the form of JSON file using the export cart.
NOTE The functions of the "UDT Dependencies", you find in chapter 4.4.
3
2
5
© Siemens AG 2024 All rights reserved
1. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
2. The Query Builder syntax guide helps the user to understand object types, filter expression,
operations, and value to query the information from PLC.
3. Enter the required query in the query editor.
4. Execute the query.
5. The results are displayed in the tabular form and the text from the table can be copied using
context menu.
6. The query can be saved and opened for a later point of use.
7. The data points displayed in the tabular form can be added to export cart.
8. The datapoints visualized are exported in the form of JSON file using the export cart.
9. A different project can be analyzed using the change project link.
NOTE The functions of the "Query Builder", you find in chapter 4.5.
5
3
© Siemens AG 2024 All rights reserved
1. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
2. The unit that needs to be analyzed is selected from the drop down, a partial name of the
unit can also be typed in to get all the types matching the name.
3. The units visualized are clickable and user would be able to view the published blocks and
UDTs.
4. The technology objects related to the units are visualized here.
5. The data blocks related to the units are visualized here.
6. A different project can be analyzed using the change project link.
NOTE The functions of the "Unit Relations View", you find in chapter 4.6.
4
© Siemens AG 2024 All rights reserved
1. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
2. Select the required PLC for which the project structure needs to be exported.
3. The project structure functionality can be selected via carousel or the tile.
4. The export progress is shown by the cascading tooltip.
5. The cascading tooltip is shown once the export of the project structure is completed.
6. A different project can be analyzed using the change project link.
NOTE The functions of the "Project Structure", you find in chapter 4.7.
4 5 7
6 8
© Siemens AG 2024 All rights reserved
1. All the functions which are available for analysis can be viewed by clicking the logo of the
application.
2. The data blocks that need to be analyzed is selected from the drop down, a partial name of
the data block can also be typed in to get all the types matching the name.
3. The tags that need to be analyzed is selected from the drop down, a partial name of the tag
can also be typed in to get all the types matching the name.
4. The data block or the Tag is visualized here.
5. The data block members or the datapoints that are read from blocks are visualized here.
6. The data block members or the datapoints that are written from blocks are visualized here.
7. The blocks which read the UDTs datapoints are shown here.
8. The blocks which write the UDTs datapoints are shown here.
9. The datapoints obtained are added to the export cart & the datapoints visualized are
exported in the form of JSON file using the export cart.
NOTE The functions of the "Global Objects Dependencies", you find in chapter 4.8.
NOTE The functions of the "Scheduling tasks for Batch Export", you find in chapter 4.10.
3.2 Pre-requisites
• User using SIMATIC Project Insight in the PC should be part of "Siemens TIA Openness"
group.
• Users trying to analyze TIA Portal know-how protected blocks should know the passwords
of the blocks, the know-how protected blocks are ignored for analysis if the passwords are
not provided.
• Compile (rebuild all) and make TIA project consistent (save the project) before importing to
SIMATIC Project Insight.
Un-Supported Environment:
• TIA Portal project protected by UMAC.
3.3 Performance
© Siemens AG 2024 All rights reserved
• There will be considerable time taken by SIMATIC Project Insight for analysis which is
indicated to the user.
• The analysis of the project is dependent on the size of the project/number of blocks in the
project the data points present in the project/ the relationship amongst objects in the project.
3.4 Operation
Know-How Protection:
1. The user will be prompted to provide Know-how protection passwords, if the user chooses
to analyze know-how protected blocks.
2. SIMATIC Project Insight does not store the know-how protected blocks passwords but uses
to extract the content of the know-how protected blocks.
Telemetry:
1. The user chooses to provide telemetry (non-sensitive SIMATIC Project Insight usage) data
back to Siemens.
Feedback:
1. The user is provided with an option to send back feedback to Siemens SIMATIC Project
Insight team in case of a crash.
Uninstallation:
1. Un-installation of SIMATIC Project Insight is done via standard windows uninstallation
mechanism.
2. Remove SIMATIC Project Insight folder if any in the installation path after un-installation (to
avoid further problems during next installation).
NOTE The navigation for the "Call Structure", you find in chapter 2.2.
Enabling the block criticality view to classify all the blocks present in the call structure according
to the criticality, the blocks are classified into three categories with stars as denoted,
★★★ – Highly critical block
★★ – Medium critical block
★ – Low critical block
The criticality is calculated considering various parameters like the number of times the block is
called, number of data points accessed inside the blocks. On hovering the block, the user gets
to know the reason for the criticality of the block, if the block is highly critical. The organization
blocks are not considered for criticality calculation.
The blocks that are uncalled in the runtime execution system are listed in the form of a list.
The uncalled list of blocks might have been called from non-supported languages like STL or
there can be usage of the block data points through their instances.
Call structure can visualize the blocks that are widely used, blocks that are seldom used and the
blocks that are never called by any other block in the PLC.
Mouse hover on a block displays the properties of the block.
Selecting a block for analysis displays the blocks in red color and the blocks that are called by
the block and the blocks that are calling the block selected in green, blue, and purple to
highlight the call structure of the block being selected.
Center icon Clicking the center icon reset the call structure visualization to the
center of the screen.
Fit to screen Clicking the fit to screen icon fits the entire call structure of the PLC
to the screen size
Refresh Clicking the refresh icon resets the nodes highlighted to the default
color of the entire call structure
Logs User understands the background process while the call structure
generation happens
Critical blocks The top 10 critical blocks of the entire PLC is displayed,
irrespective of the call structure view showing sub call structures
Uncalled The blocks that are never called in the runtime execution system
Blocks are listed.
Namespace Groups blocks based on the namespace clusters the blocks belong
to
Units Groups blocks based on the units clusters the blocks belong to
Ungroup Remove namespace & units view for sub call structure if filtered
based on the OBs or all blocks call structure filter
Full View Shows the entire call structure of the blocks inside the PLC
Block Criticality Turn On/Off the block criticality functionality
If the call structure is too big to visualize, SIMATIC Project Insight automatically shows the
blocks that cannot be visualized in white in color, so that the users can use filters to visualize
sub call structure, also a message:
"The call structure is incomplete due to its size. Please refine the search based on
individual blocks." Is shown to the user on the left side pane of the call structure.
NOTE The navigation for the "Sequence Analytics", you find in chapter 2.3.
NOTE The navigation for the "Signal Flow", you find in chapter 2.4.
Center Clicking the center icon reset the signal flow visualization to the
center of the screen.
All signal Displays all available signal flow for the selected UDT.
flows
NOTE The navigation for the "UDT dependencies", you find in chapter 2.5.
The UDT cluster shows the linkage of the UDT selected for analysis with other UDTs.
The datapoints Read From cluster shows all the datapoints of the UDT that are being read from
blocks.
The datapoints Written To cluster shows all the datapoints of the UDTs that are being written to
blocks.
The reader blocks clusters show all the blocks from which the datapoints of the UDT are read
from. The writer blocks clusters show all the blocks to which the UDT datapoints are written to.
© Siemens AG 2024 All rights reserved
Center Clicking the center icon reset the UDT Dependencies visualization
to the center of the screen.
NOTE The navigation for the "Query Builder", you find in chapter 2.6.
All_FC Retrieves data points from all functions Select * from All_FC;
All_Program_Blocks Retrieves data points from all FBs, FCs & OBs Select * from
All_Program_Blocks;
All_Instance_DB Retrieves data points from all instance DBs of Select * from
© Siemens AG 2024 All rights reserved
All_Global_DB Retrieves data points from all global DBs Select * from
All_Global_DB;
All_DB Retrieves data points from all DBs, DBs include Select * from
instance, array and global DBs All_DB;
All_Blocks Retrieve data points from all Blocks including FBs, Select * from
FCs, OBs, DBs All_Blocks;
PLC_Tags Retrieves data points from all tags inside the PLC Select * from
PLC_Tags;
All_Objects Retrieves data points from all FBs, FCs, OBs, DBs, Select * from
plc tags & technology objects All_Objects;
"Block Name" Retrieves all data points from the block name Select * from "Main";
provided
Datapoint_Name Retrieve data point matching the name Select * from All_FB where
Datapoint_Name StartsWith
"main";
DataType Retrieve data point matching the data type Select * from All_Objects
where DataType contains
"Bool";
Datapoint Property used to retrieve the unused Select * from plc_tags where
datapoint datapoint isUnused;
Contains Retrieve data point matching the name Select * from All_FB where
"main" as a starting sub string in the name Datapoint_Name StartsWith
of the datapoint as shown in example "main";
StartsWith Retrieve data point matching the data type Select * from All_Objects
"Int" as a sub string from all objects as where DataType contains
shown in the example "Int";
EndsWith Retrieve data point matching the address Select * from
ending with "Pos" from all program blocks All_Program_Blocks where
Address EndsWith "Pos";
Another example is where the user can filter by datatype, from a given subset of datapoints.
Yet another example of the query is that of using regular expressions where the user can use
well-known patterns to make a very specific search.
The saved queries can be loaded with the option to load only the current device related queries
or from all queries saved until now.
Figure 4-9: Query Builder – open an existing query
© Siemens AG 2024 All rights reserved
The dynamic user query currently does not support some of the features that are common
with SQL queries – such as joins and sub-queries.
NOTE
The Query Editor window also does not support features such as intellisense, autocomplete,
undo and redo actions.
It is possible to turn off syntax highlighting when the user does not need it, for example, when
making multiline queries – otherwise syntax highlighting might not work as intended when a
newline is entered by the user. To turn it off, use the settings icon.
NOTE The navigation for the "Unit Relations View", you find in chapter 2.7.
Center Clicking the center icon reset the Units relations visualization to the
center of the screen.
NOTE The navigation for the "Project Structure", you find in chapter 2.8.
NOTE The navigation for the "Global Object dependencies", you find in chapter 2.9.
Center Clicking the center icon reset the data blocks & tags visualization to
the center of the screen.
Fit to screen Fits the visualization to the screen size
Add to export Used to export all the required data points in the form of JSON file
Export cart Export cart checkouts the required datapoints
Logs User understands the background process while the Data blocks &
Tags visualization generation happens.
All functions of SIMATIC Project Insight have logging feature built in. All background process of
the functionalities is logged in the form of logs which are available for viewing to the user in the
top right corner of SIMATIC Project Insight.
The functionalities "UDT Dependencies", "Signal Flow", "Query Builder" & "Project Structure"
allows the required data points to be exported in the form of JSON file.
1. The required data points from all the functionalities are added to the "Export Cart" by
clicking the "Add to Export" button,
2. the JSON file is exported by clicking the "Check out" button in the "Export Cart".
3. The datapoints in the export cart can be removed by pressing the "Clear Cart" button.
Figure 4-13 shows a sample (left) for an empty "Export Cart" and (right) for an "Export Cart" with
datapoints.
1. The Task can be made active or inactive for task execution in the scheduler using the
checkbox as shown in the above figure
2. All tasks can be made active or inactive using the "Activate all tasks" checkbox
3. The task name is editable
4. The workflow name is editable
© Siemens AG 2024 All rights reserved
The tasks can be configured using the task configuration fields and options
Export Path – Path where the JSONs should be exported
Project Import Path – Path from where the TIA projects should be imported
Execution Time – Start time of the tasks to be executed
Repeat – Repeat for particular days
PLC Name – Name of the PLCs to analyze
Repeat for all PLCs – Repeat the analysis for all PLCs
Workflows – This selection is used to select the functionalities available for export
Delete Icon – Delete a particular task
^^
The exported JSONs and the task reports are available in export path folder as shown.
Performance
The performance of the system might get degraded during the batch execution as SIMATIC
Project Insight might use most of the system resources during batch execution.
© Siemens AG 2024 All rights reserved
NOTE The navigation for the "Scheduling tasks for Batch Export", you find in chapter 2.10.
Representation
In "Call Structure", "UDT Dependencies", "Signal Flow", "Unit Relations View", "Sequence
Analytics" & "Dynamic Queries", the TIA V18 datapoints/blocks/UDTs are displayed or used in
the form of <Namespace>.<ObjectName>.<DatapointName>
The Units information is visualized in "Call Structure" and "Signal Flow".
The fully qualified name of the block should be used in the query of "Query Builder" application
if the block is contained within a namespace.
Eg : To get all datapoints from block "Block_1" present in the namespace "spinner"
Select * from "spinner.block_1";
Visualization
The functionalities "Call Structure", "UDT Dependencies", "Material Flow", "Unit Relations View",
"Sequence Analytics" display the fully qualified namespace in the visualization and the blocks
without namespace are displayed only with block name.
Export
The JSON export contains the namespace information of the datapoints/blocks in the format
shown below:
<Namespace>.<ObjectName>.<DatapointName>
Crash Handling
In case of unforeseen circumstances where SIMATIC Project Insight crashes, an e-mail client
opens with crash report attached in the mail attachment, and the user can write his free text
feedback to inform Siemens about the crash.
© Siemens AG 2024 All rights reserved
4.17.1 Overview
With SIMATIC Controller Profiling, you can analyze and evaluate the runtime behavior of your
user program on a SIMATIC S7-1500 controller in depth. All relevant information can be
graphically displayed and evaluated with Google Chrome.
Profiling is integrated in the firmware of many SIMATIC S7-1500 controllers from firmware V3.1.
You can find out whether the controller supports profiling in the technical data.
The controllers record the profiling data in a ring buffer. A bin file contains a list containing the
start and end of block numbers with priorities and time stamps. The associated INF file contains
the block names for the block numbers.
When the ring buffer is full, older data will be overwritten.
The data must therefore be read from the CPU immediately after an event to be examined. If
the CPU goes into the STOP state after an error, the data is only overwritten by motion OBs.
You can read the data from the controller using the SIMATIC Profiling Tool via the Web API
interface and generate a compressed trace file in JSON format for analysis with the Chrome
browser.
In the SIMATIC S7-1500 controllers from firmware V3.1 onwards, profiling is integrated into the
firmware. The controllers record the profiling data in a ring buffer.
This binary data consists of a list of building block names, timestamps, and flags that indicate
the start and end of the building block calls. If the ring buffer is full, older data will be overwritten.
The data must therefore be read from the CPU immediately after an event to be investigated. If
the CPU goes into the STOP state after an error, the data will not be overwritten. You read the
data from the controller with the profiling tool via the Web API interface and use it to generate a
compressed trace file in JSON format for analysis with the Chrome browser.
Profiling for CPU 1516TF, CPU 1517F, CPU 1517TF, CPU 1517F, CPU 1518TF and
NOTE
CPU 1518 MFPs are currently not supported.
This application example has been created with the following hard- and software components:
Google Chrome - - -
You can purchase these components from the Siemens Industry Mall.
SIMATIC Project Insight
Entry-ID: 109818320, DEMO Version 1.0.3.0 (Service Pack 3), 04/2024 45
4.17.5 Web Server Settings
7. Under "Runtime rights", activate the "Function right" "Read process data"
8. ("Read process data").
If the web server is activated on your CPU, you can use the Profiling Tool to read the profiling
data from the SIMATIC S7-1500 CPU via the Web API. To do this, follow these steps:
1. Launch the profiling tool and enter the IP address of the CPU as well as the user and
password you have for the web server.
2. Select a folder where you want to save the profiling data. The option "Write profiling data to
file" is enabled by default.
3. Click on "Download profiling data from PLC" to read the profiling data from the CPU. →The
data is stored as binary data in the selected folder.
4. Click on "Export everything to a compressed trace file" to download all the data for
evaluation in the Chrome browser.
Alternatively, you can generate only the overview, see Figure 4-30.
You can use the "Load profiling data from file" button to transfer the stored profiling data to
the Tool and generate it for evaluation in the Chrome browser.
Disabling the "Export PIP entries" options can help prevent the trace viewer from is not
NOTE
overwhelmed by many TPA events.
Disabling the "Export direct access entries" options can help ensure that the trace viewer is
not overloaded with many random-access events.
© Siemens AG 2024 All rights reserved
Basics
Google Chrome's tracing tool offers you the opportunity to evaluate the profiling data in a
targeted manner. You can access the tool with the URL "chrome://tracing". Various functions
are available for the evaluation of recordings:
The following table provides an overview of the most important features:
Service Function
Alt + Mouse Wheel Zoom in / out
Or: w/s
A/D Swivel left/right
f Zoom to selection
m Select Current Selection
0 Reset zoom and pan
Mouse Controls
Selection mode: Select fields or area with mouse
Pan Mode: Pan Left/Right
Zoom mode: zoom in/out by dragging up/down Timing
© Siemens AG 2024 All rights reserved
By clicking on "?" you will get an overview of all functions for operation.
NOTE Place the "Mouse Controls" as high up as possible so that they are not obstructed by moving
the window areas. If the "Mouse Controls" are hidden, they can be by scrolling with the right
scroll bar.
Loading a Recording
To load a generated recording, follow these steps:
1. Enter the URL "chrome://tracing" or "about:tracing" in the address bar.
2. Drag and drop the file generated by the profiling tool into the browser.
Alternatively, you can click on "Load" and select the file.
Load the profiling data with the profiling tool and generate the overview for the evaluation in
the Chrome Browser. Load the generated data with Chrome tracing and select the "Select
mode" option.
3. Mark the entire tracks or a specific area. → After that, you will see a list of all the marked
OBs are displayed.
4. Select the OB with the highest processing time.
(OB "Main" and OB "SimaHydTO_Main_HMI" are the same length.)
8. Click "m" and then "f" to highlight the cycle and zoom the selection.
Result
The SimaHydTO_Main_HMI [OB124] has a maximum processing time of 44.109ms in cycle
1375. There are no irregularities to be detected. The communication load is also no higher than
before and after the cycle.
→ Further evaluation of the building blocks is required.
In chapter 4.17.7, the OB cycle with the maximum processing time was determined.
To find the block with the longest processing time in this OB cycle, follow these steps:
1. Load the profiling data using the profiling tool. In the "Export Range" tab, select the OB and
a cycle range in the range of the specific OB cycle. In chapter 4.17.7, the 1375 cycle was
designated as the longest cycle. Therefore, a range from 1370 to 1380 is chosen to have
several cycles for comparison. Generate the area for evaluation in the Chrome browser.
Figure 4-36: Building block with the longest processing time - (Example 1) - 1
© Siemens AG 2024 All rights reserved
2. Load the generated data with chrome tracing. The longest cycle can be seen quickly in the
following figure. However, you can also enter the number of the OB cycle you are looking
for in the search box and the cycle will then be highlighted.
Figure 4-37: Building block with the longest processing time - (Example 1) - 2
Result
In this example, the first entries are "Interrupted" and a parent building block. "Interrupted" are
higher-priority OBs that interrupt the OB cycle. What can already be seen in the recording is the
block "SimaHydTO_AxisBasics_AnyAxis [FB33192]" the block with the longest total processing
time. By searching for the module, it is highlighted and thus the evaluation is facilitated.
A comparison of the cycles shows that the device is called three times in all OB cycles. The
second call of the block is so short in the other cycles that it can only be seen by zooming in
(see figure below).
Result
With the information, the programmer can analyze and optimize the one component in a targeted
manner.
To find the block with the longest total processing time in an OB cycle, follow these steps:
1. Load the generated data with Chrome tracing and select the "Select mode" option.
2. Mark all the building blocks in this OB cycle.
→ After that, you will be presented with a list of all the building blocks.
3. Click on "Self-time" twice.
→ The building blocks are sorted in descending order of "self-time".
Result
The GetSymbolPath [FC913] function is invoked 750 times in the OB cycle and has a total
© Siemens AG 2024 All rights reserved
4.17.11 Timing
For example, to measure the time between two OB calls, do the following:
1. Select the "Timing mode" option.
2. Click at the beginning of the OB call and move the mouse pointer to the beginning while
holding down the mouse button of the next OB call. From there, release the mouse button.
Result
1. The measured time is shown to you at the top.
Timing also allows you to measure the time between two interrupts.
NOTE
With it, you can check that the projected times are adhered to.
Note 2:
For PLC Tags, the complete symbolic name is now displayed with the members separated by a
dot, e.g.:
PLC_Tag . Member
However, the address of the PLC tags and the comments are not extracted presently. This
behavior is related to the following applications: "UDT dependencies", "Query Builder", "Signal
Flow" and "Sequence Analytics".
In "Query Builder", the address of the PLC tag members is given as the parent tag address
appended with an asterisk (*) in the query results, e.g.:
For a PLC_Tag with address of %Q0.0, the PLC_Tag.Member address would be displayed as
%Q0.0*.
Note 3:
Due to an inherent limitation in TIA Portal Openness, datapoints corresponding to some of the
inbuilt datatypes may not be considered.
A datatype example for this limitation is DTL. This behavior affects the following applications:
"UDT Dependencies", "Signal Flow", "Sequence Analytics" and "Query Builder".
Note 4:
The individual array indices as datapoints are not considered and hence, represented in the
form of [*] in all the functions and JSON export.
Note 5:
SIMATIC Project Insight does analysis on the symbolic name/symbolic access of the variables
of the blocks. The reference/absolute/pointer access of variables are not considered for analysis
in SIMATIC Project Insight.
Note 6:
Data blocks used as datapoints in TIA portal are not considered for analysis in "Query Builder"
feature of SIMATIC Project Insight.
Technical Support
The Technical Support of Siemens Industry provides you fast and competent support regarding
all technical queries with numerous tailor-made offers
– ranging from basic support to individual support contracts. Please send queries to Technical
Support via Web form:
siemens.com/SupportRequest
© Siemens AG 2024 All rights reserved
Service offer
Our range of services includes the following:
• Plant data services
• Spare parts services
• Repair services
• On-site and maintenance services
• Retrofitting and modernization services
• Service programs and contracts
You can find detailed information on our range of services in the service catalog web page:
support.industry.siemens.com/cs/sc
The Siemens Industry Mall is the platform on which the entire siemens Industry product portfolio
is accessible. From the selection of products to the order and the delivery tracking, the Industry
Mall enables the complete purchasing processing – directly and independently of time and
location:
mall.industry.siemens.com