industrial-edge / performance-analytics

This application example is used to find delays in sequential control systems with the help of Performance Insight.

Performance Analytics

Below you can find the structure of this use case:

• Performance Analytics
  • Description
    • Overview
    • General Task
  • Requirements
    • Prerequisites
    • Used components
  • Configuration steps
  • Documentation
  • Contribution
  • Licence and Legal Information

Description

Overview

The 'Step Time Analysis' dashboard of the Edge App 'Performance Insight' is used to assess the efficiency of the implemented sequential control systems. First, it needs to be synchronized with the asset model of the plant, representing the control systems in operation. This synchronization allows for the establishment of a reference duration for each step in the process. Then, the configured (or expected) step time is compared with the actual measured time during operation.

This comparison makes it easier to identify specific steps in the production process that are experiencing delays, thereby enabling more targeted and efficient corrective actions.

This specific example shows how an exemplary production line is connected, the data from the plant is transferred to the edge system and evaluated there. This is shown using the step time analysis of a simulated automobile production with 5 assembly stations and randomly delayed steps.

General Task

This sample application is based on five S7-1500 PLCs to control the manufacturing process of cars. A sequential control system that was implemented with the TIA Portal programming language “Graph” runs on each PLC.

The Industrial Edge Device connects to the PLCs using different protocols:

• PLC 1 sends the "Station 1" data to the Edge Device by OPC UA using the "OPC UA Connector".
• PLC 2 sends the "Station 2" data to the Edge Device by OPC UA using the "OPC UA Connector"
• PLC 3 sends the "Station 3" data to the Edge Device by Optimized S7 Protocol (S7+) using the "S7 Connector".
• PLC 4 sends the "Station 4" data to the Edge Device by Optimized S7 Protocol (S7+) using the "S7 Connector".
• PLC 5 sends the "Station 5" data to the Edge Device by Optimized S7 Protocol (S7+) using the "S7 Connector".

And after setting other connections requirements on the Edge Device (Explained in the Configuration Steps) we can use this data on the Step Time Analysis dashboard of the Performance Insights app.

For each implemented step the PLC shall provide a tag that carries the step activity status. For each sequential control an asset model with the activity status of the step needs to be configured and connected with the related PLC status tags.

The option “Step time analysis” of the Edge App “Performance Insight” needs to be aligned with the asset model that represents the implemented sequential control systems in order to assign a reference duration for each step. This dashboard of the Edge App “Performance Insight” compares the configured and measured step time which allows localizing the steps that are causing delays.

Requirements

Prerequisites

• Industrial Edge Learning Path (Module 1-3)
• Access to an Industrial Edge Management System (IEM)
• Onboarded Industrial Edge Device (IED) on Industrial Edge Management
• Establish connection to 5 PLCs for getting data into the Edge Device
• Installed system configurators (S7 Connector Configurator, Databus Configurator)
• Installed apps on IED (S7 Connector, Databus, IIH Essentials, Performance Insight)
• Google Chrome (Version ≥ 72)

Used components

TIA and PLC:

• TIA Portal V16
• PLC1: CPU 1518F-4 PN/DP FW 2.8
• PLC2: CPU 1518F-4 PN/DP FW 2.8
• PLC3: CPU 1517TF-3 PN/DP FW 2.8
• PLC4: CPU 1517F-3 PN/DP FW 2.8
• PLC5: CPU 1517TF-3 PN/DP FW 2.8
• HMI: TP900 Comfort

Industrial Edge:

• Industrial Edge Management OS V1.5.2-4
• Industrial Edge Virtual Device V1.16.1-1-a
• SIMATIC S7 Connector V2.0.0-1
• OPC UA Connector V2.0.1-0
• Common Import Converter V2.0.0-1
• Common Connector Configurator V1.9.1-1
• Registry Service V1.9.0-0
• Databus V2.3.1
• Databus Configurator V 2.3.1-4
• IIH Essentials V1.9.0
• Performance Insight V1.16.1

Configuration Steps

You can find further information about the following steps in the docs:

• Configure PLC project in TIA Portal
• Configure PLC connections in Industrial Edge
  • Configure Databus
  • Configure PLC Connectors
• Configure IIH Essentials
  • Enter Databus Credentials.
  • Link Connectors to IIH.
  • Configure Assets
  • Configure Aspects
• Configure Performance Insight
  • Defining limits
  • Show step time analysis

Documentation

You can find further documentation and help in the following links

• Industrial Edge Hub
• Industrial Edge Forum
• Industrial Edge landing page
• Industrial Edge GitHub page
• Industrial Edge Learning Path

Contribution

Thank you for your interest in contributing. Anybody is free to report bugs, unclear documentation, and other problems regarding this repository in the Issues section. Additionally everybody is free to propose any changes to this repository using Pull Requests.

If you haven't previously signed the Siemens Contributor License Agreement (CLA), the system will automatically prompt you to do so when you submit your Pull Request. This can be conveniently done through the CLA Assistant's online platform. Once the CLA is signed, your Pull Request will automatically be cleared and made ready for merging if all other test stages succeed.

Licence and Legal Information

Please read the Legal information.

performance-analytics's Issues

No guidance on how to do it with IIH Essentials integrated into IIH, also change references to Data Service

Performance-Analytics/docs/Installation.md

Lines 141 to 164 in 517fb04

	### Configure an asset with variables
	Click on the icon "Assets & Connectivity" on the left bar. Add a child asset for the main "edge" asset. Into this child asset add 5 subassets for the stations.
	
	Create an aspect for every step. The first step of each branch (step 2 and step 11) must be configured as initial step. This is necessary to mark the beginning of the sequence and to link the corresponding product for the branch.
	First step of the branch:
	
	Following steps of the branch:
	
	Link the variables that have been created by adding the aspects to the corresponding Connector tags.
	
	Repeat this process for every station.
	

Link to TIA Portal project redirects wrong

Issue-template

Summary

Link to the TIA Portal project redirects wrong

Steps to reproduce

Click on the link here

Please add relevant screenshots and logs

Solution

Either fix the link or better upload a zap16 file instead of a ap16

Bug Report 1

Issue-template

Summary

Enable OPC UA Server on PLC 2

Version of the used components

• Industrial Edge Device: V1.2.0-56
• Performance Insight: V1.2.0

Steps to reproduce

In the Documentation is mentioned that OPC UA is used for PLC2
But in the tia project its not enabled also the runtime license needs to be selected.

What is the current bug behavior?

Programm cannot run.

What is the expected correct behavior?

How should the app behave?

Relevant logs and/or screenshots

Please add relevant screenshots and logs

Line of code

Please refer to the dedicated line of code/ description if possible

Example how to refer to a line of code:

https://github.com/industrial-edge/how-to-template/blob/f195f788dc2c2572aaf822202b08fa3681e868a1/docker-compose.yml#L1-L3

Update Connectors

Issue-template

Summary

Description how to configure OPC UA in S7 Connector is outdated. Add OPC UA Connector application or update completely to IIH.

What is the current bug behavior?

You can't configure OPC UA connections with the S7 Connector anymore. The description should be updated, that you need both connector apps (S7 & OPC UA) now to perform the steps in this HowTo.

Line of code

https://github.com/industrial-edge/Performance-Analytics/blob/main/docs/Installation.md#configure-s7-connector