TH Scope U v3 70-1 en
TH Scope U v3 70-1 en
TH Scope U v3 70-1 en
TH SCOPE
Version: EN-042021-3.70-1
© Softing Industrial Automation GmbH
Disclaimer of liability
The information contained in these instructions corresponds to the technical status at the time of printing of it and is passed on with the
best of our knowledge. Softing does not warrant that this document is error free. The information in these instructions is in no event a basis
for warranty claims or contractual agreements concerning the described products, and may especially not be deemed as warranty
concerning the quality and durability pursuant to Sec. 443 German Civil Code. We reserve the right to make any alterations or
improvements to these instructions without prior notice. The actual design of products may deviate from the information contained in the
instructions if technical alterations and product improvements so require.
Trademarks
FOUNDATION™ and HART® are marks of the FieldComm Group of Austin, Texas, USA.
Modbus® is a registered trademark of Schneider Electric, licensed to the Modbus Organization, Inc.
OpenSource
To comply with international software licensing terms, we offer the source files of open source software used in our products. For details
see http://opensource.softing.com/
If you are interested in our source modifications and sources used, please contact: [email protected]
Scan the QR code to find the latest documentation on the product web page under Downloads.
Table of Contents
Table of Contents
Chapter 1 Introduction
.......................................................................................... 5
1.1 About.............................................................................................................................
TH SCOPE 5
1.2 About.............................................................................................................................
this manual 6
1.3 Typographic
.............................................................................................................................
conventions 6
1.4 Document
.............................................................................................................................
history 7
Chapter 2 General requirements
.......................................................................................... 8
2.1 System
.............................................................................................................................
requirements 8
2.2 Network
.............................................................................................................................
settings 9
Chapter 3 Installing TH SCOPE
.......................................................................................... 10
3.1 Licensing
............................................................................................................................. 12
3.1.1 Licensing on PC
....................................................................................................................... 12
3.1.2 Licensing on USB dongle
....................................................................................................................... 13
3.2 Displaying
.............................................................................................................................
device images 14
3.3 Using
.............................................................................................................................
device description files 15
Chapter 4 Opening TH SCOPE
.......................................................................................... 16
4.1 User.............................................................................................................................
interface 18
4.2 TH LINK
.............................................................................................................................
login 18
4.3 TH LINK
.............................................................................................................................
user administration 21
4.4 Functions
............................................................................................................................. 21
4.5 View.............................................................................................................................
area 22
4.5.1 Printing....................................................................................................................... 22
4.5.2 Filtering....................................................................................................................... 22
4.5.3 Updating views
....................................................................................................................... 22
4.5.4 Viewing.......................................................................................................................
and hiding table columns 22
4.5.5 Sorting ....................................................................................................................... 23
4.5.6 Tooltips....................................................................................................................... 23
Chapter 5 Working with TH SCOPE
.......................................................................................... 24
5.1 Network
.............................................................................................................................
monitoring 24
5.2 Network
.............................................................................................................................
overview 25
5.2.1 Network.......................................................................................................................
list 26
5.2.2 Error statistics
....................................................................................................................... 27
5.2.3 Trend ....................................................................................................................... 28
5.3 TH LINK
.............................................................................................................................
View 29
5.3.1 Live list ....................................................................................................................... 29
Version EN-042021-3.70-1 3
Table of Contents
5.3.2 Inventory
....................................................................................................................... 30
5.3.2.1 Inventory data of PROFINET modules
..................................................................................................... 31
5.3.2.2 Inventor data of other Ethernet devices
..................................................................................................... 32
5.3.3 Topology
....................................................................................................................... 36
5.3.4 Error statistics
....................................................................................................................... 38
5.3.5 Trend ....................................................................................................................... 39
5.3.6 Network.......................................................................................................................
statistics 39
5.3.7 Diagnostics list
....................................................................................................................... 40
5.3.8 Reference
....................................................................................................................... 41
5.3.9 Export ....................................................................................................................... 43
5.4 Settings
............................................................................................................................. 44
5.4.1 TH SCOPE ....................................................................................................................... 44
5.4.2 TH LINK....................................................................................................................... 45
5.4.3 TH LINK.......................................................................................................................
- xEPI2 45
5.4.4 Black List
....................................................................................................................... 46
5.5 Acceptance
.............................................................................................................................
reports 48
5.5.1 Frame analysis
....................................................................................................................... 50
5.6 Product
.............................................................................................................................
information 52
Chapter 6 Configuring TH SCOPE
.......................................................................................... 53
6.1 TH LINK
.............................................................................................................................
detection 54
6.2 TH LINK
.............................................................................................................................
grouping 55
6.3 SNMP.............................................................................................................................
agent 56
6.4 User.............................................................................................................................
administration 57
6.5 Automatic
.............................................................................................................................
export 57
6.6 OPC.............................................................................................................................
UA server configuration 58
6.7 Network
.............................................................................................................................
views in TH SCOPE 59
Chapter 7 Tips and Troubleshooting
.......................................................................................... 60
7.1 Solving
.............................................................................................................................
port conflicts 60
7.2 Installing
.............................................................................................................................
Microsoft Internet Information Services (IIS) 62
7.2.1 Windows 7
....................................................................................................................... 62
7.2.2 Windows Server 2012, 2012 R2, 2016
....................................................................................................................... 63
4 Version EN-042021-3.70-1
Chapterl 1 - Introduction
1 Introduction
1.1 About TH SCOPE
TH SCOPE is a software application for industrial network management and network diagnostics.
Geared to plant operators and maintenance personnel, TH SCOPE is an all-in-one, easy-to-use solution
for permanent monitoring and predictive maintenance, for acceptance testing and for troubleshooting.
Relevant data of connected network devices is collected by a TH LINK and forwarded to TH SCOPE.
Combined with TH LINK components, the product supports PROFIBUS, PROFINET, EtherNet/IP and
Modbus TCP protocols.
In the following diagram, the TH LINK PROFIBUS and TH LINK Ethernet show two typical industrial
network topologies.
When TH SCOPE is started for the first time it must be connected with a TH LINK device. For more
details see Chapter TH LINK detection 54 .
To access the fieldbus system, at least one of the following products is required:
§ TH LINK PROFIBUS
§ TH LINK PROFINET
§ TH LINK EtherNet/IP
Version EN-042021-3.70-1 5
TH SCOPE - User Manual
Keys, buttons, menu items, commands and other Open Start à Control Panel à Programs
elements involving user interaction are set in bold
font and menu sequences are separated by an arrow
Buttons from the user interface are enclosed in Press [Start] to start the application
brackets and set to bold typeface
Coding samples, file extracts and screen output is set MaxDlsapAddressSupported=23
in Courier font type
Filenames and directories are written in italic Device description files are located in C:
\<Application
name>\delivery\software\Device Description
files
CAUTION
CAUTION indicates a potentially hazardous situation which, if not avoided, may result in
minor or moderate injury.
Note
This symbol is used to call attention to notable information that should be followed during
installation, use, or servicing of this device.
6 Version EN-042021-3.70-1
Chapterl 1 - Introduction
Version EN-042021-3.70-1 7
TH SCOPE - User Manual
2 General requirements
§ The TH SCOPE software has been installed successfully.
§ At least one of the following products is needed to connect with the fieldbus system(TH LINK
PROFIBUS, TH LINK PROFINET, TH LINK EtherNet/IP, TH LINK Modbus TCP, TH LINK Industrial
Ethernet, TH LINK PC Industrial Ethernet).
§ A measurement must have been started for each TH LINK gestartet sein. Click the Info ( ) tab to
see if a measurement has been started. Make sure Measurement started is displayed below TH
SCOPE.
Note
TH SCOPE V3.60 and versions following do not work properly with TH LINK V4.4 (and
newer). This is because the number of measuring ranges has been increase and older TH
SCOPE and TH LINK versions were set to manage only 5 measuring ranges. Therefore, when
accessing a TH Link from TH SCOPE 3.60 and older the user interface may freeze.
Note
The instructions given in this user guide are based on the operating system Microsoft
Windows Professional 7.
Software required
§ Microsoft Excel 2010 or higher to open or edit the acceptance reports
§ Adobe Reader 8 or higher
§ Microsoft Internet Information Services (IIS) 5.1 or higher (available on Microsoft Windows
installation CD or via Internet download at http://www.iis.net.
§ Microsoft .NET Framework 4.0 (included in TH SCOPE installation)
8 Version EN-042021-3.70-1
Chapterl 2 - General requirements
Browsers supported
Note
To provide the complete functionality for creating and downloading the acceptance report
make sure that no pop-up blockers are activated and downloading of files or documents is
allowed.
The following ports are used by TH SCOPE for internal communication only:
§ Port 22
§ Port 80
§ Port 1100
§ Ports 1123 - 1151
§ Port 1500
§ Port 1501
§ Ports 2363 - 2366
§ Ports 49152 - 49171
Version EN-042021-3.70-1 9
TH SCOPE - User Manual
3 Installing TH SCOPE
Make sure that all system requirements 8 are met.
1. Start the installation:
a. for 64 bit systems with a double-click on Install64_TH_SCOPE.exe
b. for 32 bit systems with a double-click on Install32_TH_SCOPE.exe
Note
If you install a Softing product for the first time, a window is opened that prompts you
to trust the publisher. Activate the option Always trust software from Softing AG, if
you
do not want to be asked in subsequent installations. Then select [Install] to start the
installation.
2. Select your installation language and click [OK].
The Welcome screen appears:
4. Carefully read the information. Click I accept the terms in the license agreement. Then click [Next].
5. Click I accept the terms in the license agreement and continue with [Next].
The Destination Folder appears::
6. Click [Next] to copy the software to the folder currently displayed or click [Change] to copy TH
SCOPE to a different folder.
The installation screen appears.
7. Click [Instal] to start the installation. If you want to review or change any of your installation
settings, click [Back].
10 Version EN-042021-3.70-1
Chapterl 3 - Installing TH SCOPE
Version EN-042021-3.70-1 11
TH SCOPE - User Manual
3.1 Licensing
To use all TH SCOPE features you will need to acquire a license.
Note
With the installation of TH SCOPE you will automatically have a 30-day demo license.
3.1.1 Licensing on PC
Installing a PC licence with Internet access
1. Start the license manager: Start à All Programs à Softing àLicense Manager à License Manager
V4.
2. Select Activate for this PC.
3. Enter the license key in the input field using the following format XXXXX-XXXXX-XXXXX-XXXXX.
4. Click [Activate license].
After the license key has been activated successfully it will appear under Available licenses on this
PC.
5. Restart your PC to activate the licence.
12 Version EN-042021-3.70-1
Chapterl 3 - Installing TH SCOPE
2. Start the license manager: Start à Alle Programme à Softing àLicense Manager à License
Manager V4.
3. Enter the license key in the input field using the following format XXXXX-XXXXX-XXXXX-XXXXX.
Version EN-042021-3.70-1 13
TH SCOPE - User Manual
If you want to display device images in the topology, you need to store the images in the following
folder:
<Installationsverzeichnis>\Softing\TH SCOPE\WebContent\Bitmaps
The file name of the device image consists of an identifier (prefix) and an extension (suffix). The
identifier is a combination of vendor ID and device ID followed by a dot and the file extension
(e.g. .png). Both the vendor ID and the device ID can be found in the tab "Inventory" of the connected
TH Link device. Example: 002A-0302
If a device cannot be identified by vendor ID and device ID you can alternatively use the MAC address
or the order number of the device.
14 Version EN-042021-3.70-1
Chapterl 3 - Installing TH SCOPE
Note
All characters which must not be used in Windows file names such as \ / : * ? " < > | have
to be replaced by a hyphen.
Example
order number appears as: 1846/56482
file name must be written as: 1846-56482
Proceed as follows:
1. Store the GSD or GSDML files in the corresponding folder in the TH SCOPE installation directory
(see screenshot below).
2. Restart your PC. If you have administrator right on the PC, restart the TH SCOPE service
Version EN-042021-3.70-1 15
TH SCOPE - User Manual
4 Opening TH SCOPE
After TH SCOPE has been installed, open the user interface to familiarize yourself with the features and
the user interface. You can start TH SCOPE user interface from your local computer or remotely from
another computer on the network.
Note
The configuration of your TH SCOPE is done in the TH
SCOPE Configuration user interface:
TH SCOPE user interface opens in the default browser on your computer showing the network
overview.
Note
If you have a second web server installed on your computer, see the Section Solving port
conflicts 60 .
Note
If you have configured the HTTP port manually you will reach the TH SCOPE service in your
default web browser on localhost:<Portnummer>/THSCOPE (example:
localhost:8080/THSCOPE). The port the selected HTTP port.
Hint
Save the TH SCOPE address and port to your browser favourites.
16 Version EN-042021-3.70-1
Chapterl 4 - Opening TH SCOPE
Note
If you have configure the HTTP port manually for TH SCOPE you will reach the TH SCOPE
service in your default web on http://<Computername>:<Port>/THSCOPE (example:
192.168.0.1:8080/THSCOPE)
Note
Install IIS as described in Chapter 7.2 (Installing Microsoft Internetinformationsdienste
(IIS) 62 .
Version EN-042021-3.70-1 17
TH SCOPE - User Manual
1. Login area - allows you to log in and log out as administrator and switch between languages (English
and German)
2. Function area - allows you to select specific functions and features
3. View area - displays the network structure, connected devices and give you an a general status
overview
18 Version EN-042021-3.70-1
Chapterl 4 - Opening TH SCOPE
2. Click the information icon to open the product information page of the selected TH LINK
device.
The following page appears.
3. Copy the serial number of the device to the login input filed and click [Login].
Version EN-042021-3.70-1 19
TH SCOPE - User Manual
Note
We recommend that you change the password of your devices after login (see Chapter TH
LINK user administration 21 ).
Note
Log out after you have changed the settings. Otherwise you will have to wait about 5
minutes to reopen this page after closing the browser.
20 Version EN-042021-3.70-1
Chapterl 4 - Opening TH SCOPE
2. Enter the Old Password and the New Password in the corresponding fields under user
administration .
4.4 Functions
Version EN-042021-3.70-1 21
TH SCOPE - User Manual
4.5.1 Printing
Click the printer icon ( ) to print tables, topology views or acceptance reports.
Note
When printing tables, the printer settings of your computer from which you access to the
TH SCOPE are used. The topology is exported into a PDF file that you can print afterwards.
4.5.2 Filtering
Most view areas will allow you to filter status information and table content (including names,
addresses, network protocols, device types). Click the icon. A window opens allowing you to filter
displayed data by state or address:
22 Version EN-042021-3.70-1
Chapterl 4 - Opening TH SCOPE
4.5.5 Sorting
1. Click the corresponding column header in the table to sort table content.
You can sort ascending or descending (click again).
2. To sort consecutive columns press and hold the Ctrl key and select the desired columns.
Note
Not all columns can be sorted.
4.5.6 Tooltips
All station icons have tool tips. Move the mouse over the icon to read the tool tip:
Version EN-042021-3.70-1 23
TH SCOPE - User Manual
Red icon
Error signal: Station is displayed with a red icon.
Error cause: At least on station is malfunctioning.
Action: Check the station for damaged connections, correct installation
of connectors and defects.
Yellow icon
Error signal: Station is displayed with a yellow icon.
Error cause: At least one station has a diagnostic.
Action: Check the station and evaluate the manufacturer-specific
diagnostics if necessary.
Green icon
Fully functioning.
Grey Icon
Station is inactive (in PROFIBUS networks) or has no valid IP address (in Ethernet network).
Hint
See the diagnostics list 40 for detailed information about possible errors and remedies.
24 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
The TH SCOPE navigation has a hierarchical structure. The network overview presents a status
summary of the monitored networks and is divided into the level overview, groups and links. The
following network overview contains the groups HAAR2 and TRUDERING. The level below the group
shows the connected TH LINKs.
Each TH LINK in the navigation tree indicates the status of the monitored area. If a connected TH LINK
reports an error, the incident is reflected across the entire network overview and immediately
indicated at the highest level.
The navigation tree shows all reachable TH LINKs and is automatically updated with every modification
in the configuration of TH SCOPE.
When a group has been created, the group structure is shown in the navigation tree. The status of the
higher level group node shows the worst network status of the group. Example: 2 TH LINKs are yellow,
1 TH LINK is green => group node is yellow).
Each group node has a network list which shows all assigned and available TH LINKs, their names,
status, protocol type and further details.
Version EN-042021-3.70-1 25
TH SCOPE - User Manual
Furthermore you can see the firmware version and how many devices are located in the network.
Network overview is highlighted and the tab Network
list is selected:
1 TH LINK state
2 Host name of TH LINK
3 Protocol type
4 IP address of TH LINK
5 Tag name of TH LINK
6 Firmware version of TH LINK
7 Number of all devices in the network
8 Overview of all networks available, monitored or not monitored or faulty
26 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
Note
If this view is empty, all networks are running properly. That means since measurement
start no error in the networks occurred.
Note
Lost packets are among: discarded packets (discarded caused by overload), error packets
(defect packets) and unknown packets (not corresponding to the Ethernet standard).
Version EN-042021-3.70-1 27
TH SCOPE - User Manual
5.2.3 Trend
The Trend view s view displays graphically state changes of all networks are in a chronological
sequence between one hour up to one month. The state change of the network icon is shown. Thus it is
readily identifiable when and how long a faulty was existing in the network.
Note
Up to 1000 state changes can be saved. If 1000 entries are reached, the oldest entry will be
overwritten.
28 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
Note
Top left the station IP address range is displayed.
If different address ranges have been specified in the settings for the measurement, then
the Live List display corresponds to these ranges configured.
Note
Top right the number of PROFINET, Ethernet/IP or Modbus TCP devices (according to the
used TH LINK), other network devices and TH LINK is displayed.
Other network devices could be for example PCs, printers or switches. The state of these devices can be
either ok or failed.
Version EN-042021-3.70-1 29
TH SCOPE - User Manual
5.3.2 Inventory
The Inventory view displays all network stations, their modules, submodules and those of the TH LINKs
.
Note
If for some devices several cells are empty, this is because the information is not stored in
the device and thus cannot be read.
Note
If you restart the measurement, check boxes for all stations will be automatically reset.
PROFIBUS
The Inventory view for PROFIBUS networks appears as follows. TH LINK is highlighted and the tab
Inventory is selected:
Reading and displaying of values in the inventory depends on the TH LINK operation mode. Values in
the columns Station and Address/Slot can be determined in both operation modes. The values of the
columns Tag, Location, Installation date, Serial number, Description, Order number, HW version and
FW version are part of the I&M data (Identification & Maintenance). These I&M data can only be read
actively.
30 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
Note
However, some slaves can crash when reading the I&M data because of wrong firmware
behavior.
You can deselect these devices before reading by deactivating the check box in the right
column
Note
For devices that have no tags and descriptions, you can add these manually if you are
logged in as administrator.
This data is stored permanently. All other I&M data is deleted on reboot of the TH LINK and
restart of the TH SCOPE measurement.
To see all modules and sub-modules the filter settings must be adjusted.
§ Click the filter icon ( ) and move "Module" and "Submodule" with the arrow keys to the field
„Device class Include".
Note
For some module you may need a GSDML file to show the device description. You find
more details about the import of GSDML files here 15 . If several entries are found in the
device description file (GSDML) this is highlighted by an asterisk (*).
In the column Address/Slot you find the type of module. The information has the format <IP address
controller> / <module number in hex> / <submodule number in hex>. Ethernet ports of the modules
have the number "0x8…".
Version EN-042021-3.70-1 31
TH SCOPE - User Manual
Example:
The table above shows the controller with IP address 172.36.1.11. Below you see module 0 with the
address 172.36.1.11 / 0x0000 and the associated submodule 1 with address 172.36.1.11 / 0x0000 /
0x0001.
Hint
The information for Identification & Maintenance(I&M) is included in the export file and
can be exported in the Excel format for further use.
The version number appears in the inventory list (see screenshot below) of the Ethernet device in the
firmware column "FW version".
32 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
To read the inventory data, the SNMP services must first be enabled on each connected network
device. The following steps describe how you enable SNMP services using the Windows 10 operating
system:
1. Click the Windows symbol in the bottom left corner Start à Windows System à Control Panel
àPrograms à Programs and Features and select Turn Windows features on or off.
2. In the window that opens, check the boxes for Simple Network Management Protocol (SNMP)
and WMI SNMP Provider and click [OK].
3. Click Windows Start again in the lower left corner and enter the search term Services on your
keyboard.
Version EN-042021-3.70-1 33
TH SCOPE - User Manual
5. Select SNMP Service in the Services window and right-click to select Properties.
The SNMP Service Properties window appears.
6. Click the Security tab and make sure that the Send Authentication Trap checkbox is checked.
7. Click [Add] beneath the window frame Accept authentication tap an enter a new community with
the name public and the community rights READ ONLY
9. Click [Add] beneath the lower window frame to specify the requesting host more precisely or
specify the host name or IP address of the polling device.
34 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
Version EN-042021-3.70-1 35
TH SCOPE - User Manual
5.3.3 Topology
The Tolology view shows in graphical or tabular form which stations are connected with each other in
the network. It includes those whose peer cannot be determined. These stations without topology
information can be hidden from the view. In addition, information on the status of the stations and
their connection is displayed.
Note
Stations supporting LLDP (Link Layer Discovery Protocol) or CDP (Cisco Discovery Protocol)
are displayed, as well as terminal stations that are connected directly to a managed switch.
Use the icons in the upper right corner to select the preferred view mode:
36 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
Note
The paper sizes A1, A2, A3, A4 and Letter are supported.
§ Information displayed in the graphical representation (Name, Address, Device images (refer to
Display of device images in the topology 14 ), Protocol, Ports, Type of connection, Connection
state, Bandwidth in MBit/s, Duplex type, Redundancy manager) and stations without topology
information can be displayed or hidden as required. To do so click the filter icon and select the
desired data.
§ Each line displays the following information:
Type of connection: As label and per line type.
Copper: solid line.
Wireless: Dotted line.
OFC: Dashed line, displaying absorption in parentheses.
For unknown line types a solid line without text is displayed.
Cable length: Cable length is displayed in meters. If the device connected
does not support this functionality, "n.a." is displayed.
Connection state: (network quality)
Lost packets: connection line is displayed in orange.
Line disconnection: connection line is displayed in red.
Swapped ports are displayed with the following icon:
Bandwidth: The bandwidth is displayed in MBit/s.
Duplex type: The duplex type is displayed as a line label: HX - half-duplex, DX
- full duplex
After clicking this icon the topology information is displayed in tabular form. By sorting the
columns, you may for example identify the connections with the highest utilization by a single click:
Version EN-042021-3.70-1 37
TH SCOPE - User Manual
§ duplex type
§ transmitted data in bytes
These values are read approximately 2 to 3 times per minute from the devices.
The utilization results from the difference of the transmitted bytes and the time difference between the
readout times and is related to the negotiated bandwidth per duplex type. The maximum utilization
value is stored and compared to the next new calculated value. If a new value is higher than the one
before, this value is the new maximum value.
2 Number of failures
3 Number of all diagnostics
4 Lost packets
5 Show/hide in graphical view
6 Sum of all failures, diagnostics and repetitions/lost packets
7 Show/hide in chart view
Note
As soon as a diagnostics repeater, a DP/PA link or an SK3 is detected in a PROFIBUS
network, additional tables are displayed in the error statistics.
38 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
5.3.5 Trend
The tab Trend displays the state changes of all stations in chronological order. This makes it easy to
determine when and for how long a station has been malfunctioning. Maintenance cycles can be
derived from this information. For a Trend view see Section Trend 28 in Chapter Network overview.
For each station the following information is displayed: state of the station, protocol, address, tag, data
rate (incoming and outgoing), network statistics.
§ Click on a station in the displayed network statistics view to display the port-specific properties of
the station:
Version EN-042021-3.70-1 39
TH SCOPE - User Manual
Note
For PROFIBUS networks you can use GSD files and for PROFINET networks you can use
GSDML files to decode manufacturer-specific diagnostics (refer to Using device description
files 15 ).
CAUTION
Obsolete GSDML files generate a diganostic message in PROFINET. TH SCOPE deliberately
ignores this message and does not list it in the diagnostics list. If you have other
preferences, please contact our support for further information.
Duplicated IP address
If TH LINK detects after start multiple devices with identical IP address, the device symbol appears in
yellow together with an according tooltip and the explanation text that you must switch off the device,
then reconfigure it and then restart the measurement:
40 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
5.3.8 Reference
The Reference tab is a useful tool to detect changes in the network structure. Save at any time the
state of your network as reference state (the reference file must be saved as .xml file). When you have
created a reference file you can compare the stored network data at a later point in time with the
current state of your network and print the comparison results.
Version EN-042021-3.70-1 41
TH SCOPE - User Manual
The reference state can be compared in TH SCOPE with only a few clicks:
1. Click the [Save] button at the top of the tab to define the current network state as reference
state.
The "Save reference" window appears.
42 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
5.3.9 Export
Using the Export tab you can archive TH SCOPE diagnostics data for network acceptance and further
processing. The data is exported into a spreadsheet file.
§ Highlight the TH LINK for which you want to export diagnostics data.
§ To use the exported file for network acceptance, see Chapter Acceptance report 48 .
Note
The file column headers can be used to filter and sort. For each view in TH SCOPE (except
for reference and Trend) a spreadsheet is added to the file. Diagrams and graphics are not
stored in the file.
Version EN-042021-3.70-1 43
TH SCOPE - User Manual
5.4 Settings
Click the Settings icon to set parameters for measurements, alarms and data backups.
5.4.1 TH SCOPE
Type of measurement
Measurement range Default: The measurement range will be automatically set according
to the measurement
IP address of TH LINK. Starting with firmware version 4.4, an
automatic range calculation is performed for
Class B networks based on PROFINET (see Automatic Address Range
Calculation).
User defined: Up to eight (8) measurement ranges can be selected
for one TH LINK. As per TH LINK a total of 254 devices can be
monitored.
Data view The measurement data can be viewed from the start of the
measurement or with historic data (from SD card).
Data restore after voltage If an SD card is inserted in the TH LINK, the recovered measurement
recovery data will be cached on the SD card. Activate data restore only if the
TH LINK has a card inserted.
Measurement Starts, stops or continues the measurement.
Sorting of the diagnostics list Sorts the diagnostic list = latest results first.
Delete the diagnostics Deletes entries from the diagnostic list.
messages
Additional SNMP community
name
Retries in case of no response A device is reported as being "down" by a TH LINK if the request limit
has been reached (example: 3 requests before the device is reported
down).
Start-up delay in sec.
Alerting
Email alerting active Activating (Yes) or deactivating (No) of the email alerting. If email
alerting is activated alerts and email settings can be configured.
The user is informed by email about diagnostics or downtimes
( configurable!). The email contains information about the faulty
network and a link to the corresponding TH LINK.
Threshold monitoring
Value increase of lost If the number of lost packets exceeds the time threshold value of 15
packets / 15 min in % minutes, a diagnostic message is sent.
Value exceedance of lost If the number of lost packets exceeds the daily threshold value a
packets / day diagnostic message is sent.
Value max. utilization in % If a station exceeds the defined utilization a diagnostic message is
sent.
Threshold monitoring for Stations can be included in and excluded from monitoring.
station
44 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
5.4.2 TH LINK
User management changing of the password
old password
new password
repeat password
change password
TH LINK description
tag defining a TAG for the TH LINK
location assigning a location for the TH LINK
installation date defining an installation date for the TH LINK
description defining a description for the TH LINK (e.g. monitored network).
default language selecting a default language in TH LINK (German / English)
network configuration
network adapter (TH LINK PC selecting a network adapter, which is used for scanning the network
only) (if there is more than one available)
Version EN-042021-3.70-1 45
TH SCOPE - User Manual
Preconditions
§ You have installed a firmware version 3.4 or higher on your TH LINK devices.
§ You are using TH LINK Ethernet devices.
§ You are logged in as administrator.
Note
Following a firmware update you first need to restart the measurement. Then close your
browser and restart the TH SCOPE application.
Download
1. Click Settings ( )
2. Click the tab Black List.
3. Click [Download from device], to download the current version of the file device_blacklist.txt from
the TH LINK device to the PC. The file is located per default in the installation directory C:
\Programs (x86)\Softing\TH LINK
46 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
Upload
1. Use the button [...] to select a file or enter a directory and file name into the empty field in the
middle of the window.
2. Click [Upload to device] to upload this file from the PC to the corresponding device.
Note
The functions download/upload are not available for TH LINK PC. It is only possible to
activate/deactivate the Black List. To modify the list content you need to edit the file C:
\Program Files (x86)\Softing\TH LINK\device_blacklist.txt with administrator rights directly.
Then restart the measurement to activate your changes.
Activate/deactivate functionality
Click Yes right beside Black Listing active to activate the function. Modifications in the black list will not
be effective immediately but following the next measurement start. No deactivates this functionality.
Version EN-042021-3.70-1 47
TH SCOPE - User Manual
TH SCOPE allows you to create a protocol for acceptance test purposes of PROFINET networks. The
report makes use of the information provided by TH SCOPE.
§ collect the data required for report creation such as network addresses, network environment etc.
Note
If you intend to generate the acceptance report offline (based on an older
measurement), at least one TH LINK (e.g. TH LINK PC) must be detected by the
report-generating PC.
3. Select the Language in which you want to publish the protocol (English or German) and the Output
format (PDF, Excel or PDF and Excel).
4. Select the Configuration tab.
5. If you create a protocol for the first time and you do not dispose of a configuration file:
a. Fill out the fields in section Tester and in section Customer. You can upload logos by clicking
[...].
b. Then specify the Criteria for Topology and consistency data. You get detailed information
about specific values in the online help. To open the help click the question mark ( ) right
beside the section heading.
48 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
c. Then specify the criteria for statistical data. Select which devices are to be validated. Enter the
corresponding values.
d. Then enter the Project data.
e. Save your configuration by clicking . Enter a file name and click [Ok].
6. If you already have saved configuration files:
a. Open your list by clicking the arrow on the right. Select your file. The corresponding data is
automatically entered into the corresponding fields. Review your data and add or modify the
data if required.
b. Save your file with the existing name by clicking or enter a new name and click .
Hint
Configuration files are located in the installation directory in <drive, e.g. C:>:
\Programs (x86)\Softing\TH SCOPE\AcceptanceReport\Configurations.
Default file name extension is .cfgAll.
Version EN-042021-3.70-1 49
TH SCOPE - User Manual
This setup ensures that the frame traffic of each PROFINET device in the network is recorded. What
follows is an analysis of the traffic time of the data frames. The measured jitter, load ratio and update
intervals are recorded in the acceptance reports.
Note
You must have TH SCOPE version 3.5 and TH LINK PC version 4.2 installed to perform a
frame analysis.
50 Version EN-042021-3.70-1
Chapterl 5 - Working with TH SCOPE
7. Now connect your PROFITAP with the network as described and shown above.
8. Tick the checkbox Enable Timestamps (right window above) and click [Flash].
Version EN-042021-3.70-1 51
TH SCOPE - User Manual
*The load ratio is the ratio between PROFINET frames and non-PROFINET frames.
52 Version EN-042021-3.70-1
Chapterl 6 - Configuring TH SCOPE
6 Configuring TH SCOPE
Note
The configuration of your TH SCOPE is done in the TH
SCOPE Configuration user interface:
The TH SCOPE Configuration user interface gives you access to the following configuration options:
The default browser on your PC opens with the configuration interface of TH SCOPE.
Note
To change the configuration of you must have logged in as administrator. Default password
is THSCOPE_Admin.
Version EN-042021-3.70-1 53
TH SCOPE - User Manual
Note
TH LINKs which have been unreachable by TH SCOPE for at least five minutes are displayed
by a grey icon ( ) and can be removed from the navigation tree by clicking the [Remove]
button.
Manual detection
TH SCOPE detects the TH LINKs via unicast packets. For manual detection select "Manually" and enter
the IP address for each TH LINK. Confirm your selection by clicking the [Add] button (see below).
Note
In the navigation tree all TH LINKs are displayed to which a connection can be established.
Manually entered TH LINK devices are currently not shown, if they cannot be reached.
Note
When changing from automatic to manual and vice versa remember to restart the TH
SCOPE service on your PC. Alternatively you can also simply restart your PC.
54 Version EN-042021-3.70-1
Chapterl 6 - Configuring TH SCOPE
Creating a group
1. Enter a group name.
2. Click the [New] button.
The new group appears als a button in the column Available Groups. Groups can be renamed at any
time by clicking the [Rename] button.
3. Now you assign all available TH LINK devices to a group of your choice by moving them with the
arrow button .
A TH LINK can not be assigned to more than one group. The navigator preview on the right-hand
side of the window shows the current group structure. Changes (new groups, or TH LINKS which
have been added or deleted from a group) are shown immediately. Group content can be viewed
and hidden by clicking the arrow to the left.
4. Confirm your changes by clicking the save button. Only saved changes will be managed by TH
SCOPE.
Note
The symbols of all TH LINKs are grey and do not show the Live status of the corresponding
TH LINK.
Version EN-042021-3.70-1 55
TH SCOPE - User Manual
Note
The SNMP Client settings have to match with the SNMP Agent settings.
The Object Identifier (OID) of the SNMP MIB is: 1.3.6.1.4.1.29345. The following data is available:
56 Version EN-042021-3.70-1
Chapterl 6 - Configuring TH SCOPE
2. Enter the default passwords THSCOPE_Admin in the Old password input field
3. Select a new password and confirm it by re-entering.
4. Click [Change password] to save the changes.
1. Start TH SCOPE Configuration 53 (All Programs à Softing à TH SCOPE àTH SCOPE Configuration).
2. Click the tab Automatic Export and log in als Administrator.
3. Select one of the options from the selection list. The default setting for automatic export is off
(deactivated).
4. Confirm your settings with a click on the Save icon .
Version EN-042021-3.70-1 57
TH SCOPE - User Manual
Note
During automatic export a session is created on every TH LINK device. If the maximum
number of session (6) is reached, no file can be generated for the corresponding TH
LINK in this iteration.
§ details about TH LINK (device status, device name, protocol, IP address, tag, firmware)
Note
No additional installations are required to make network data of TH SCOPE available on the
OPC UA. TH SCOPE is installed with an NGINX (http server software) and an OPC UA Discovery
Server.
4. Select OPC UA Server Settings on the left side and click Identity.
Here you find the server endpoint and the port the OPC UA server uses in TH SCOPE.
5. Copy this information to your OPC UA application to establish a connection with TH SCOPE.
58 Version EN-042021-3.70-1
Chapterl 6 - Configuring TH SCOPE
The OPC UA Server option can be activated and deactivated in the "OPC UA Server Configuration" tab.
Here you can start and stop the server manually and define the startup behavior of the server at system
start.
Note
To change the settings, you must be logged in as an administrator.
This user-defined configuration makes is possible to show workflows in TH SCOPE in accordance with
individual requirements. The settings are available only i the active browser session and will be
discarded when the browser is closed. To keep the settings for future browser sessions, click the icon (
) to save them.
Version EN-042021-3.70-1 59
TH SCOPE - User Manual
Several web servers can be installed on one PC at the same time. But only one of them can
communicate via port 80. Therefore, you may have to change the HTTP port for TH SCOPE or the IIS
web server manually.
60 Version EN-042021-3.70-1
Chapterl 7 - Tips and Troubleshooting
5. Change port 80 for example to 8080 and click [OK]. Then close all windows.
Note
Instead of port 8080 you can also select another free port. Consult your IT department for
more information. Ports up to 1004 are managed by IANA.
Version EN-042021-3.70-1 61
TH SCOPE - User Manual
Note
To install Microsoft IIS you need administrator rights on your PC and if necessary the
Microsoft Windows operating system installation CD.
7.2.1 Windows 7
1. Go to Start àControl Panel àPrograms àPrograms and Features and click on Turn Windows
features on or off:
62 Version EN-042021-3.70-1
Chapterl 7 - Tips and Troubleshooting
1. Open the Server Manager and click on Add roles and features:
2. Activate Web Server (IIS) and IIS Hostable Web Core in the Select server Roles dialog:
Version EN-042021-3.70-1 63
TH SCOPE - User Manual
3. Activate the options .Net Framework 4.5 and ASP.NET 4.5 in the dialog window Features:
4. Activate User Interfaces and Infrastructure (to allow installing the Flash Add on in your browser):
64 Version EN-042021-3.70-1
This page is intentionally left blank.
Version EN-042021-3.70-1 65
Softing Industrial Automation GmbH
Richard-Reitzner-Allee 6 + 49 89 45 656-340
85540 Haar / Germany + 49 89 45 656-488
http://industrial.softing.com [email protected]