FuB LineIntegration PDITestTool DOC en
FuB LineIntegration PDITestTool DOC en
https://support.industry.siemens.com/cs/ww/en/view/86302104
Warranty and liability
Note The Application Examples are not binding and do not claim to be complete
regarding the circuits shown, equipping and any eventuality. The Application
Examples do not represent customer-specific solutions. They are only intended
to provide support for typical applications. You are responsible for ensuring that
the described products are used correctly. These Application Examples do not
relieve you of the responsibility to use safe practices in application, installation,
operation and maintenance. When using these Application Examples, you
recognize that we cannot be made liable for any damage/claims beyond the
liability clause described. We reserve the right to make changes to these
Application Examples at any time without prior notice.
If there are any deviations between the recommendations provided in these
Application Examples and other Siemens publications – e.g. Catalogs – the
contents of the other documents have priority.
We do not accept any liability for the information contained in this document.
Any claims against us – based on whatever legal reason – resulting from the use of
the examples, information, programs, engineering and performance data etc.,
described in this Application Example shall be excluded. Such an exclusion shall
not apply in the case of mandatory liability, e.g. under the German Product Liability
Act (“Produkthaftungsgesetz”), in case of intent, gross negligence, or injury of life,
body or health, guarantee for the quality of a product, fraudulent concealment of a
Siemens AG 2016 All rights reserved
Security Siemens provides products and solutions with industrial security functions that
informa- support the secure operation of plants, systems, machines and networks.
tion 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 only
form one element of such a concept.
Customer is responsible to prevent unauthorized access to its plants, systems,
machines and networks. Systems, machines and components should only be
connected to the enterprise network or the internet if and to the extent necessary
and with appropriate security measures (e.g. use of firewalls and network
segmentation) in place.
Additionally, Siemens’ guidance on appropriate security measures should be
taken into account. For more information about industrial security, please visit
http://www.siemens.com/industrialsecurity.
Siemens’ products and solutions undergo continuous development to make them
more secure. Siemens strongly recommends to apply product updates as soon
as available and to always use the latest product versions. Use of product
versions that are no longer supported, and failure to apply 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 http://www.siemens.com/industrialsecurity.
Table of contents
Warranty and liability ............................................................................................... 2
1 PDI Interface test tool ..................................................................................... 4
1.1 Overview ........................................................................................... 4
1.2 Description of the core functionality.................................................... 6
1.3 Overview of the test environment ....................................................... 8
1.4 Hardware and software components .................................................. 9
1.5 System requirements ....................................................................... 10
2 Commissioning ............................................................................................ 11
2.1 Installation ....................................................................................... 11
2.1.1 PDF printer on engineering system .................................................. 12
2.1.2 PDF printer at Comfort Panel ........................................................... 12
2.2 Project configuration and runtime start ............................................. 13
2.2.1 Configuring the runtime simulation ................................................... 13
2.2.2 Use of a Comfort Panel.................................................................... 14
2.2.3 OPC UA configuration ..................................................................... 19
3 Controlling the application .......................................................................... 24
3.1 Configuration ................................................................................... 25
3.1.1 Configure connection ....................................................................... 25
3.1.2 Entering test report information ........................................................ 26
3.1.3 Configuring the interface .................................................................. 27
Siemens AG 2016 All rights reserved
Schema
The following picture shows the most important components of this application.
PDF CSV
Siemens AG 2016 All rights reserved
Benefits
The application presented in this document offers you the following advantages:
Qualitative test of the configured PackTags of a data interface according
to OMAC or Weihenstephan (based on PDI).
Archiving of PackTag value changes and messages in CSV files.
Reporting of test results in compressed form and output in a PDF file.
Management of multiple report and archive files.
Export of report and archive files.
Delimitation
This application does not contain a description of:
Installation and operation of the TIA Portal
Installation and operation of HW-Config (STEP 7 Classic)
Installation and operation of SIMOTION SCOUT
Installation and configuration of a PDF printer driver
Required knowledge
A basic working knowledge of the required Siemens applications (see delimitation)
as well as a working knowledge of Personal Computers, Microsoft operating
systems and TCP/IP networks is needed.
Technical requirements
All participant units must be networked in an Ethernet network. Communication
between the application and the OEM PLC must take place via TCP/IP or OPC UA.
Scope
Siemens AG 2016 All rights reserved
Note At the present time and due to the system characteristics, it is not possible to
determine automatically the data structure of a projected interface. Therefore,
the User must configure the data interface before a test. This is done mainly via
the configuration pages of the application. However, if the communication takes
place via OPC UA, the variables connection in the TIA Project must also be
Siemens AG 2016 All rights reserved
adjusted.
The following Flow chart shows the individual phases that are run through in an
interface test:
After the application has been configured and the connection to the
Controller successfully established, the interface test can be started.
Start of test From this moment on, a continuous check of the PackTags used
takes place, and the optional archiving of value changes is possible.
During an active interface test the operator must operate the system
in such a way that value changes can be registered from all the
PackTags used. When doing so, he must bear in mind that the
PackTag status for “Mode”, “State”, “LightStack” and “Reason Code”
Siemens AG 2016 All rights reserved
are each made up from several individual states. The current test
status is displayed in a status table and graphically in color in a pop-
up display so that it is possible to see which PackTags remain to be
Check tested.
of
PackTags Archiving and checking of PackTags is paused.
Pause In this phase it is also possible to end or abort the
test.
At the end of the test archiving is stopped and the final status of the
End of test PackTag is determined.
Report After the interface test is finished a report is generated and the
and archive files are saved.
Logging
Via a further user interface, the reports and archive files saved on
Export the system, can be exported, for example to a connected USB drive.
The individual categories can be accessed via the bottom toolbar. In addition there
are buttons to set the language and to exit.
Interface
Hardware components
Software components
Update 8
SIMATIC STEP 7 1 6ES7 810-4CC10-0YA5 or newer; required for
V5.5 SP4 SIMOTION via OPC UA
SIMOTION SCOUT 1 6AU1 810-1BA44-0XT7 or more recent; required
V4.4 HF11 for SIMOTION via OPC UA
XML Editor (e.g. 1 - required for SIMOTION
XML Notepad) via OPC UA
CAUTION The XML configuration file must not be modified since this could cause the
application to malfunction!
CAUTION Due to the characteristics of the system, the current version of the application
cannot record rapid value changes of the PackTags smaller than 100 ms.
In particular when checking the status changes this can cause an unwarranted
warning to be registered in the log.
2 Commissioning
2.1 Installation
In order to use this application, an Engineering Station with WinCC
Comfort/Advanced/Professional V13 SP1 Update 8 (or higher) is needed.
Additionally, STEP 7 Classic, SIMOTION SCOUT and an XML Editor (e.g. XML
Notepad) will be required if machine control is via SIMOTION.
Perform the following tasks on the test system:
1. Install and configure a PDF printer driver as standard printer for the test system
used:
– Chapter 2.1.1 PDF printer on engineering system
– Chapter 2.1.2 PDF printer at Comfort Panel
2. Download project file from the entry page and unpack it with the function
Siemens AG 2016 All rights reserved
Please refer to the documentation of the PDF program used to see where these
settings can be configured.
On a Comfort Panel the report just can be printed by the selected standard printer.
Siemens AG 2016 All rights reserved
In the entry "Printing with SIMATIC Comfort Panels" you will find further information
on this topic. The documents that can be downloaded from there describe all the
necessary installation steps for the PDF printer driver.
Make the following settings:
Control panel > Printer
– Activate color options
Desktop > PDFsettings
– Main storage path: “SD”
– Filing location: “\Storage Card SD\PDI_Reports\”
– Activate monitor and report printing
– File name: “PDI_Report_YYYY_MM_DD_HH_MM_SS.pdf”
CAUTION When using a Comfort Panel the configuration of the standard printer cannot
be changed while the application is running!
5. Open the PDI Test tool application with the TIA portal.
6. Open the connections of the projected HMI device.
7. Select connection “C1_SIMATIC” (1). Assign the same IP address (2) as
previously in the parameter settings for the LAN-interface. The Controller’s
address does not need to be matched, since this occurs during the runtime.
1
Siemens AG 2016 All rights reserved
9. In the project navigation, select HMI device and carry out the context command
to rebuild all (3).
10. Start the simulation or Runtime if you have a license, by selecting the HMI
device and clicking the corresponding button.
Siemens AG 2016 All rights reserved
11. After the start of Runtime, the XML configuration file will be checked if it’s
present and whether the file version matches the tool project version. If one of
the two conditions is not fulfilled you will be prompted to select the
configuration file belonging to the project. Select with the button “Search” (4)
the storage path of the XML file and confirm with “Continue” (5).
4 5
3. Select the PROFINET interface (1) of the Comfort Panel and then open the
Properties window for the Ethernet address. In the sector for the IP protocol
now enter a freely available IP address as well as the subnet mask (2).
2
Siemens AG 2016 All rights reserved
6. If communication between the application and the Controller is via OPC UA,
configure the connection and variables as shown in 2.2.3 OPC UA
configuration. If not please go on with step 7.
7. In the project navigation, select HMI device and carry out the context command
“Software - rebuild all” (5), then start the download of the HMI project to the
Panel (6).
6
Siemens AG 2016 All rights reserved
If then the dialog “Load preview” appears, you may continue with step 10.
8. Make the following settings:
– Type of PG/PC interface: PN/IE (7)
– PG/PC interface: Engineering Station LAN port used (7)
– Show all compatible devices: activate (8)
Then click on the “Start search” button (9).
9. In the list of participants found, select the corresponding panel (10) and click
on “Load” (11).
10
Siemens AG 2016 All rights reserved
11
NOTE During the transfer the Panel’s IP address is adapted in accordance with the
project.
10. In the preview dialog you can check some more settings and start transfer
to the panel clicking the “Load” (12) button.
12
11. After the start of the runtime the application checks whether the XML file
is present and whether the file version matches the application project version.
If one of the two conditions is not fulfilled you will be prompted to select the
configuration file belonging to the application project. Select “Locate” to search
for the storage location of the configuration file and then click on “Continue”.
Siemens AG 2016 All rights reserved
4. Open the properties dialog for the SIMOTION and switch to the "Ethernet
expanded / web server" tab.
5. Activate both options for the OPC XML DA (2) and confirm the changes with
“OK”.
2
Siemens AG 2016 All rights reserved
6. Save and compile (3) the HW configuration and start transfer (4) to SIMOTION.
3 4
7. Switch off SIMOTION and insert the SIMOTION CF card in a free slot of your
Engineering Station.
8. Open the XML web configuration file “WebCfg.xml” with an appropriate XML
Editor (e.g. XML Notepad). The file is available in the directory
"...\SIMOTION_D\USER\SIMOTION\HMICFG".
6
Siemens AG 2016 All rights reserved
10. Insert the CF card back in the appropriate SIMOTION slot and switch it on.
11. Open the TIA application project in the TIA portal
12. Open the connections of the HMI device.
13. Select the connection “C2_OPC_UA” (7) and enter the URL for the OPC UA
server (8) in the OPC server sector. Take care the syntax is correct!
Example: “opc.tcp://192.168.0.3:4840”
8
Siemens AG 2016 All rights reserved
Note Since this is only a test phase, selection of “Security policy” and “Message
security mode” is not absolutely essential, but is possible if needed.
Example: “PDI.BASIC.STATUS.CurMachSpeed”
10 11
12
Siemens AG 2016 All rights reserved
Note In Chapter Error! Reference source not found. Error! Reference source not
und. you will find a list of the available connection variables and the reference to
the PackTags, defined in the individual PDI versions.
16. In the project navigation, select HMI device and in the context menu carry out
the command for complete transfer (13).
13
3.1 Configuration
3.1.1 Configure connection
This configuration page contains all the necessary selections and inputs for the
configuration of the connection to the Controller that contains the data interface.
2
Siemens AG 2016 All rights reserved
CAUTION When using a SIMATIC S7 1500, the function “Allow PUT/GET communication”
must be activated in the CPU!
When using a SIMOTION or control with an OPC UA server, the connection
and variable addressing needs to be adapted in the TIA project (see Chapter
2.2.3 OPC UA configuration).
In order to assign the test report to a project, project name and type of machine
must be input (e.g. case packer) as well as person-related data. These items are
documented on the first page of the report.
1
Siemens AG 2016 All rights reserved
Select a PDI version developed by Siemens for the project-related data interface.
Then the settings can be made either directly or via the detail configuration in
accordance with the project.
Modifications to a version are automatically saved in the XML Configuration file.
The PDI standard can be restored at any time via the detail configuration.
3 4 5
Note The PackTags of a deselected type will not be tested and will be marked as “not
used” in the reporting.
The system can show addressing errors on PackTags during the establishment
of the connection. This can be ignored.
The reset to the original PDI PackTag configuration can be done via buttons in
the detail configuration pop up.
CAUTION The selections and entries are not checked for plausibility!
When using a SIMATIC S7 1500 the attribute “Optimized module access” must
be deactivated for the interface database!
When using a SIMOTION or a PLC with an OPC UA server, the connection and
variable addressing needs to be adapted in the TIA project before the Runtime
is started!
Siemens AG 2016 All rights reserved
On this configuration page the settings can be adjusted for mode changes and
their states. The display of the state models is dependent on the specification
chosen and PDI version.
2
Siemens AG 2016 All rights reserved
3 4
Note Mandatory states are marked in light gray and cannot be deselected.
The two buttons (4) beneath the state model can be used to select all states or to
deselect all states.
2
Siemens AG 2016 All rights reserved
Before the interface test is started the following settings must be checked and,
if necessary, changed. Once the interface test is active it is no longer possible
to change settings.
1. Select the category “Diagnose” and the tab “PDI Test” (1).
2. Check the selected interface specifications and version (2).
3. Select an acceptance reason (3).
The acceptance reason for the test procedure serves the purpose of recording
in the report the moment in the project when the interface test was carried out
At the present time the following acceptance reasons are available to choose
from:
– Pre-test
– Factory acceptance test (FAT)
– Final acceptance
– Continuous testing
4. Activate the option “incl. PackTag recording in CSV” (4) if during the interface
Siemens AG 2016 All rights reserved
test all the value changes of the PackTags (except strings) are to be archived
in CSV files separately for each type of interface. In the subsequent export
these are copied and can then be used with the help of Microsoft Excel or
other tools for a detail analysis.
Test control
The actions described in the following - and which are recorded in the “Log” – are
available for the control of the interface test.
The application also allows a review of the LCU interface, if this has been activated
in the Configuration.
1. Select the category “Diagnose” and the tab “PDI Test” (1).
2. Click the “LCU controlling” button (2) to open the control dialog.
3. Activate Remote control (3). This enables the input and selection boxes.
Note Control can only be activated if the relevant enable is set in the LCU interface.
7
1
During an active test the PackTags used are reviewed in accordance with their
type and as described in the following table. Some of the results of a review are
recorded in the Log.
unit
Strings - Value equal not empty
“pure” numerical - Value change
values - Value within limits (according to underlying PDI
specification)
Boolean - Value change
To provide a general overview, for each type of interface there is a status table
available for the display of the current test status of the individual PackTags. In it,
name, current value (with active connection) and the PacTag’s acquisition cycle
are tabulated.
Siemens AG 2016 All rights reserved
The test status for all PackTags whose name is marked with an * is composed
of the individual statuses. The detail view can be opened via the respective control
button.
Status marking
The current test status marking is defined as follows:
1. Select the category “Diagnose” and the tab “PDI Test” (1).
2. Click the “PackTags details” button (2).
1
Siemens AG 2016 All rights reserved
If the “incl. PackTag register in CSV” option is activated, during the interface test
all the value changes of the PackTags (except strings) are archived in CSV files
separately for each type of interface. Archiving takes place in segmented short-
term archives consisting of a maximum of 20 individual segments with up to
25,000 values each. This way, up to 500,000 value changes can be archived
per interface type.
However, it is not possible to state a precise maximum for the archiving time,
because the entry type “Upon change” was set as parameters for each PackTag.
Furthermore, in the respective interface type archives not only the PackTags for
the currently selected version are parameterized, but all the PackTags contained
in the individual versions as well. The characteristics of the system do not allow
for this parameterization to be modified during the runtime.
The following table provides an overview of the current parameterization of the
PackTag recording archives.
PARA 2 17
PEC 15
3.3.6 Logs
Certain events during an interface test are registered in the runtime message buffer
for better analysis and displayed under “Logs”. At the end of the test the message
buffer is archived and can later be exported together with the PDF report and the
PackTag recording archives.
Siemens AG 2016 All rights reserved
CAUTION The Message buffer can record a maximum of 1024 messages without
a problem! In the event of a buffer overflow 1 percent of the messages are
deleted! It is especially important to bear this in mind when carrying out
a continuous test.
Several reports can be stored on the system used, if every report file is
automatically allocated a time stamp when the standard printer is configured.
These reports can be displayed in the report view. Subsequently it will be possible
to export the files, including the archive files, to a USB drive.
1. Select the category “Diagnose” and the tab “Report view” (1).
2. Select a report (2).
3. Using the file browser you can select the folder for the report-related Log files
(3). The time stamp in the folder name can help you, as it coincides with the
time stamp registered in the test report indicating the end of the test.
4. If a report and the folder for the report-related Log files are selected, they can
be exported to a USB drive (4). To do this it is essential that a USB device be
connected. If this is not the case, an error message is displayed.
5. As an option it’s also possible to print the PDF report with a real printer (5).
Siemens AG 2016 All rights reserved
2 4 5
3.4 Messages
There are two message screens available for the display of current (1) and
archived (2) system messages. However, they only display system messages. The
messages concerning the actual interface test can be found under “Logs” in the
PDI test image in the Diagnostics sector.
2
Siemens AG 2016 All rights reserved
It is a possible to reset the archive file in the archive image, thus deleting all the
system messages archived until then.
3.5 Service
In the category “Service” some service functions can be carried out, depending on
the runtime system used.
2
Siemens AG 2016 All rights reserved
3 4 5 6
4 OPC UA Variables
4 OPC UA Variables
HMI Variable OMAC User Group Weihenstephan Standards
PackTag V1.1.0 V2.0.0 PackTags V1.0.0 V2.0.0
C2_BASIC_ConsumedEnergyDWORD - SIE_Cons_Elec_Energy
C2_BASIC_ConsumedEnergyREAL BASIC.Status.Parameter[1].Value -
BASIC.Status.Parameter1.Value -
C2_BASIC_CurMachSpeed BASIC.Status.CurMachSpeed WS_Cur_Mach_Spd
C2_BASIC_EquipmentInterlockBlocked BASIC.Status.EquipmentInterlock.Blocked -
C2_BASIC_EquipmentInterlockBlocked BASIC.Status.EquipmentInterlock.Blocked -
C2_BASIC_InitialErrorDWORD - WS_Not_Of_Fail_Code
C2_BASIC_InitialErrorREAL BASIC.Status.Parameter[2].Value -
C2_BASIC_LightStack BASIC.Status.Light_Stack SIE_Light_Stack
C2_BASIC_MachDesignSpeed BASIC.Admin.MachDesignSpeed WS_Mach_Design_Spd
C2_BASIC_MachSpeed BASIC.Status.MachSpeed WS_Set_Mach_Spd
C2_BASIC_ModeCurrent - WS_Cur_Mode
C2_BASIC_PDIVersion BASIC.Status.PDIVersion SIE_Ver_BASIC
C2_BASIC_PowerUpTimeDWORD BASIC.Status.Parameter0.Value SIE_Mach_Cum_Time
C2_BASIC_PowerUpTimeREAL BASIC.Status.Parameter[0].Value -
C2_BASIC_ProdDefective{0}AccCount BASIC.Admin.ProdDefectiveCount[0].AccCount WS_Bad_Packages
C2_BASIC_ProdDefective{0}Count BASIC.Admin.ProdDefectiveCount[0].Count SIE_Bad_Packages
C2_BASIC_ProdProcessed{0}AccCount BASIC.Admin.ProdProcessedCount[0].AccCount WS_Tot_Packages
C2_BASIC_ProdProcessed{0}Count BASIC.Admin.ProdProcessedCount[0].Count SIE_Tot_Packages
C2_BASIC_ProductRatio BASIC.Status.Parameter2.Value WS_Prod_Ratio
C2_BASIC_ProductRatioTypeBOOL BASIC.Status.Parameter3.Value -
C2_BASIC_ProductRatioTypeDWORD - SIE_Prod_Ratio_Typ
4 OPC UA Variables
4 OPC UA Variables
4 OPC UA Variables
4 OPC UA Variables
5 Related literature
Table 5-1
Topic
\1\ Siemens Industry Online Support
https://support.industry.siemens.com
\2\ Download page of this entry
https://support.industry.siemens.com/cs/ww/en/view/86302104
6 History
Table 6-1
Siemens AG 2016 All rights reserved