PI TINA User manual

TINA
user manual
V1.05
English
User manual compatible with TINA firmware V1.05 or higher!
by PI 2017-2018

Content
1 General..................................................................................................4
1.1 About the manual.............................................................................4
1.2 Requirements to the user.................................................................5
1.3 Use for intended purpose.................................................................5
1.4 Particularities...................................................................................5
2 System requirements.............................................................................6
2.1 Software...........................................................................................6
2.2 Hardware.........................................................................................6
3 Commissioning......................................................................................7
3.1 Web server access..........................................................................7
3.1.1 access via WLAN.......................................................................7
3.1.2 access via LAN..........................................................................8
3.1.3 web interface..............................................................................8
3.2 Bridge interfaces..............................................................................9
3.3 User interaction..............................................................................10
4 web server...........................................................................................11
4.1 start page.......................................................................................12
4.2 recording........................................................................................13
4.2.1 detail view................................................................................14
4.2.2 frame information and settings.................................................15
4.2.3 view filter..................................................................................16
4.2.4 search......................................................................................46
4.2.5 protocol streams.......................................................................47
4.2.6 RTP streams............................................................................48
4.2.7 VoIP connections.....................................................................50
4.2.8 PROFINET-IO connections......................................................51
4.2.9 application protocols................................................................52
4.2.10 save recording........................................................................55
4.2.11 open recording.......................................................................55
manual TINA V1.05 page 2

4.3 monitoring......................................................................................56
4.4 network scan.................................................................................59
4.5 network tools..................................................................................62
4.5.1 resolve IP to MAC....................................................................63
4.5.2 ping..........................................................................................64
4.5.3 traceroute.................................................................................64
4.5.4 resolve NetBIOS name............................................................64
4.5.5 determine NetBIOS name........................................................64
4.5.6 resolve LLMNR name..............................................................64
4.5.7 determine LLMNR name..........................................................64
4.5.8 resolve DNS name...................................................................65
4.5.9 determine DNS name...............................................................65
4.5.10 Wake On LAN - MAC.............................................................65
4.5.11 Wake On LAN - IP..................................................................65
4.6 IP addresses..................................................................................66
4.7 IP connections...............................................................................68
4.7.1 IP changer................................................................................69
4.8 DHCP clients..................................................................................71
4.9 configuration..................................................................................75
4.9.1 password..................................................................................75
4.9.2 LAN-A settings.........................................................................76
4.9.3 WLAN settings.........................................................................77
4.9.4 FTP settings.............................................................................80
4.9.5 SMTP settings..........................................................................81
4.9.6 Bridge settings.........................................................................82
4.10 firmware update...........................................................................85
4.11 log in and out...............................................................................87
5 Technical data.....................................................................................89
page 3manual TINA V1.05

1 General
1.1 About the manual
This manual describes the device TINA (shortcut for German version of
„mobile intelligent network-analyser“) and can be downloaded on the web
page of the product via downloads  documentation.
The manual are aimed to the following user groups:
planners
operators
commissioning staff
service and maintenance staff
Before you use this device, you should read this manual.
If you have questions and / or problems you can contact the technical
support from your dealer.
manual TINA V1.05 page 4

1.2 Requirements to the user
The product / system which belongs to this manual should only be used
from qualified staff, which should respect this documentation and the in
this documentation included safety and warn notes.
Qualified staff has the possibilities due their education and experience to
detect risks and possible dangers. Further they have knowledge for the
correct connection of the device.
1.3 Use for inten e purpose
The TINA devices are constructed for the use in weatherproofed indoor
places.
The operating conditions which are named in this documentation have to
be followed. The operation of the device outside its specification can
affect the safety which is given by the device from default.
The TINA device has the possibility to analyze and change the network
traffic which occurs between two network interfaces. Especially for a
change of the network traffic you should take care of the changes to
prevent IP conflicts or something similar. Otherwise your network may
break.
1.4 Particularities
Attention: Avoid condensation!
Sudden temperature fluctuations can cause an condensation. A
condensation can affect the function of the device. So in this case you
should store the device at least 2 hours at the usage place before using
it.
page 5manual TINA V1.05

2 System requirements
2.1 Software
For using and configuring the TINA devices you need the following tools
ans software's:
internet browser (e. g. Microsoft Internet Explorer, Mozilla Firefox
or Google Chrome)
Using the TINA devices is independent of your operating system and
browser.
Important:
For viewing the website correctly you shoul check that JavaScript
isn't isable in your browser.
2.2 Har ware
WLAN interface
24VDC power supply over detachable connector or USB power
supply from PC / Power-Pack
2 x Ethernet cables (LAN)
manual TINA V1.05 page 6

3 Commissioning
The device has one WLAN interface and two LAN interfaces. The WLAN
interface is used that you can connect your PC, tablet or mobile phone
with the device. The LAN interfaces are used for the network analyzing.
But by default the LAN-A interface can also be used to access the web
server of the device.
Important:
This chapter escribes the factory efault of the evice. Via the
configuration other configuration combinations (e. g. a bri ge
between LAN to WLAN) are possible.
3.1 Web server access
The TINA device (and it's web server) can be accessed by either using
the WLAN or LAN-A interface.
3.1.1 access via WLAN
If you want to use the WLAN interface, please make sure the WLAN
interface on you PC, tablet or mobile phone is enabled and open the list
of available WLAN networks.
In the list of the available WLAN networks you should see a network with
the SSID “TINA WiFi”. The network is not encrypted and so you can
connect to it without a password.
All TINA devices are running a DHCP server on the WLAN interface. If
the device from where you want to access the TINA device is configured
as DHCP client you don't have to change any setting. If your device has
an fixed IP address you have to either change your setting to DHCP
client or change your IP address so it matches the subnet
192.168.1.0/24 (IP addresses from 192.168.1.1 to 192.168.1.254). The
IP address 192.168.1.1 can't be used, because it is the address of the
TINA device.
page 7manual TINA V1.05

3.1.2 access via LAN
For using the LAN interface you have to connect the LAN-A interface of
the TINA device with a LAN cable to the network socket of your
computer.
On the LAN-A interface no DHCP server is running by default. This
means that you have to open the network settings of the network card
from your PC and navigate to the IP settings. In the IP settings dialog
you have to configure a fixed IP address from the subnet 192.168.2.0/24
(addresses from 192.168.2.1 to 192.168.2.254). The IP address
192.168.2.1 is already in use by the TINA device and can't be used for
your PC.
3.1.3 web interface
After you are connected to the TINA device you can open a web browser
on your PC, tablet or mobile phone. Now you can enter the IP address
192.168.1.1 (for access via WLAN) or 192.168.2.1 (for access via
LAN-A) in the address line.
At the first use of the device you will see a dialog with some hints and an
input field for the serial number. In this field you have to enter the serial
number of the device (the number can be found on the bottom side of the
device) and click on the button “unlock device”:
manual TINA V1.05 page 8

If the input is correct the device is unlocked and can be used normally.
After the unlocking you will be redirected to the configuration page of the
device (see also web server → configuration). The function release have
to be done only once of course.
Important:
The function release is a security mechanism of the TINA evice to
protect your network ata. The reason therefore is that everyone,
which is within the WLAN range of the evice, can connect to it
without a passwor an view the network ata.
Hint:
The TINA evices are always using the channel 1 for the WLAN
interface by efault.
3.2 Bri ge interfaces
The TINA devices have the possibility to analyze and change the
network traffic. Therefore the devices have two LAN interfaces which are
operating similar to a network bridge. This means all frames which are
received on interface A are sent out on interface B and the other way
around. If settings are set through which the device should change
network frames the frame which was received on the first interface is
different from the frame which is send on the second interface.
If you have problems e. g. with the communication between a PC and a
PLC you can connect the PC via a Ethernet cable to the interface A of
the TINA device and the PLC with another Ethernet cable to the interface
B of the TINA device.
Now you can analyze the communication between the two devices on
the web server of the TINA device and find the cause of the
communication problem.
page 9manual TINA V1.05

Hint:
Both LAN interfaces are supporting the automatically switching of
the sen an receive line pair (auto MDIX). Thus you can use a 1:1
occupie or a crosse network cable.
Even if the LAN-A interface is use for the network analyzing the
interface can still be use for accessing the web server.
3.3 User interaction
The device has some status LEDs on the front size of the device. The
LEDs have the following meanings:
•ON: lights if the device is powered
•Wi: lights on active WLAN and blinks on data transfer
•S1: currently not in use
•S2: currently not in use
•S3: currently not in use
•S4: currently not in use
•LAN A: lights if the link state on interface A is active and blinks on
data transfer
•LAN B: lights if the link state on interface B is active and blinks on
data transfer
manual TINA V1.05 page 10

4 web server
The complete operation of the TINA device (display and
parameterization) can be done via the integrated web server which is
available over the WLAN interface and / or the LAN-A interface of the
device, depending on the configuration.
The surface of all web pages consists of a
header, a footer and a big content area. Thus
on all web pages are much space for the real
content. This is very helpful on devices with
small resolutions or monitor sizes (e. g. smart
phones).
If you want to show the navigation bar you
have to click on the icon or the text “menu” on
the top left corner. With the same method you
can hide the menu. The menu entries which
you can also see on the image will be
described in this chapter of the manual.
If a password is set in the configuration and if
you are currently logged a menu item with the
name “log out” is shown.
The language of all surfaces can be changed
between German and English in the menu on
the bottom of the navigation.
page 11 manual TINA V1.05

4.1 start page
On the start page of the device you can see some status information
separated to interface A and B:
•link state: Indicates if the the link state is active or not.
•recv. packets: Number of received packets.
•recv. bytes: Amount of received bytes.
•sent packets: Number of sent packets.
•sent bytes: Amount of sent bytes.
manual TINA V1.05 page 12

4.2 recor ing
On this page you can record the network traffic of one of the two
interfaces.
Before you start the recording you should choose the interface on which
you want to record the network traffic. The selection can be done via the
selection list “interface”.
Furthermore it is necessary to specify where do you want to view or store
the recorded traffic. You can select between web browser and FTP
server with the help of the selection list “storage”. The usage of the FTP
server recording requires a configuration of the FTP server on the
configuration page (see also chapter web server → configuration).
If you want to start recording you just have to click on the symbol .
After a recording is started you can stop it with a click on the symbol.
Alternatively you can restart a recording / reset the view via clicking on
the symbol (only possible for web browser recordings).
A helpful feature is the automatically scrolling which can be enabled by
clicking on the icon . If the scrolling is enabled and a new frame arrives
page 13 manual TINA V1.05

the recording table will scroll down to the bottom of the table. The
scrolling function can be disabled by clicking on the icon .
If you start a recording to the FTP server you will get a pop-up window. In
this window you have to specify the file format (currently only the
Wireshark file formats pcapng and pcap are available) and a file name
(without the extension):
If a FTP server recording is running the frames will not appear in the
frame table in the browser. To check if a FTP recording is running or
which error has occurred on the last transfer you can look at the status
text on the right side (same height as the toolbar):
4.2.1 etail view
The recording table shows only the direction ( for received frames and
for sent frames), an ongoing number, the time, the source address and
the destination address of a frame. If the window has enough width the
protocol, the length and a description is also shown.
manual TINA V1.05 page 14

For a detailed view or analyze this information is not enough. Thus the
recording page contains a detail view. The detail view of a frame can be
opened by clicking on a frame in the table. Now you should see
something similar to the following:
On the left side you can see the analyzed data of the frame in textual
form. The right side shows the raw data (bytes) of the frame. If your
monitor has a small width the two windows will be shown among
themselves.
Both the entries in the text view and the bytes in the raw view can be
clicked. A selected entry and the corresponding raw data or entry in the
text view will be highlighted with a blue color:
Hint:
Entries in the text view which have sub entries are getting
automatically unfol e if you click on them.
4.2.2 frame information an settings
Every frame has some additional information and settings which are not
shown within the frame table or the detail view, because they doesn't
belong to the data of the frame directly.
If you want to open the view for information and settings of a single
frame you have to click on the entry on the frame table first. Thereby the
entry get's colored in light blue and maybe the detail view get's opened
too. Now you can click on the symbol, which can be found on the
page 15 manual TINA V1.05

toolbar which is located above the frame table. Next you should see a
dialog similar to the following:
Each line has it's own meaning:
transport protocol: If the frame is a TCP or UDP frame a button
will appear, which allows you to set a view
filter. This view filter will affect that only
frames which belong to the same TCP or
UDP stream will be shown.
default application protocol: The application protocol (if available) as
which the frame would be analyzed by
default.
application protocol: Here you can choose as which application
protocol the frame should be analyzed. If the
checkbox “apply to stream” is checked this
setting will also affect all frames which
belong to the same TCP or UDP stream.
If you have changed the application protocol of the frame you have to
click on the button “submit” to reanalyze the frame or the complete
stream.
4.2.3 view filter
If you want to filter the viewed record data (e. g. to show only frames with
a specific IP address, port or protocol) you have the possibility to set a
view filter. The view filter it a string which consists of one or more
conditions.
manual TINA V1.05 page 16

Important:
The view filter only affects the view in the browser. The evice
always recor s everything.
To submit the view filter you have to press the return key (only possible if
the focus is on the text field) or click on the icon behind the text field.
Hint:
The inputs an comman s for the the view filter are largely
compatible with them from the program Wireshark.
For the data fields (see next table) the following data types exists:
name escription
- fields without a data type can be checked for
existence only
truth value y for true; n for false
number numeric value (hexadecimal with 0x, octal with 0,
binary with 0b or decimal)
string a string; as well as DNS names or NBNS names
MAC address a MAC address; address blocks at the end can be
omitted
IPv4 address a IPv4 address; address blocks at the end can be
omitted
IPv6 address a IPv6 address; shortened with :: allowed; address
blocks at the end can be omitted
The following fields can be checked via the view filter:
name ata type escription
eth - Ethernet header
eth.dst MAC address destination MAC address
page 17 manual TINA V1.05

eth.src MAC address source MAC address
eth.vlan.tpid number VLAN protocol ID
eth.vlan.prio number VLAN priority
eth.vlan.cfi truth value VLAN DEI-/CFI bit
eth.vlan.id number VLAN ID
eth.type number Ethernet type
eth.len number frame length
llc - LLC header
llc.dsap number destination SAP
llc.ssap number source SAP
llc.control number control value
llc.snap - SNAP extension header
llc.snap.oui number manufacturer ID
llc.snap.vlan.tpid number VLAN protocol ID
llc.snap.vlan.prio number VLAN priority
llc.snap.vlan.cfi truth value VLAN DEI-/CFI bit
llc.snap.vlan.id number VLAN ID
llc.snap.proto number protocol (Ethernet type)
ip - IPv4 Header
ip.version number version
ip.hdr_len number header length
ip.tos number Type Of Service (QoS parameter)
ip.len number total length
ip.id number identification number
ip.flags number flags
ip.frag_offset number fragmentation offset
ip.ttl number Time To Live
manual TINA V1.05 page 18

ip.proto number IP protocol
ip.checksum number header checksum
ip.src IPv4 address source IPv4 address
ip.dst IPv4 address destination IPv4 address
ip.opt - IPv4 option
ip.opt.type number option type
ip.opt.len number option length
ip.opt.data - option data
ipv6 - IPv6 header
ipv6.version number version
ipv6.class number traffic class (QoS parameter)
ipv6.flow number flow label
ipv6.plen number payload length
ipv6.nxt number IP protocol or next header
ipv6.hlim number maximum count of hops
ipv6.src IPv6 address source IPv6 address
ipv6.dst IPv6 address destination IPv6 address
arp - ARP protocol
arp.hw.type number type of hardware addresses
arp.proto.type number type of protocol addresses
arp.hw.size number size of hardware addresses
arp.proto.size number size of protocol addresses
arp.opcode number operation code
arp.src.hw MAC address source hardware address
arp.src.proto IPv4 address source protocol address
arp.dst.hw MAC address destination hardware address
arp.dst.proto IPv4 address destination protocol address
page 19 manual TINA V1.05

rarp - RARP protocol
rarp.hw.type number type of hardware addresses
rarp.proto.type number type of protocol addresses
rarp.hw.size number size of hardware addresses
rarp.proto.size number size of protocol addresses
rarp.opcode number operation code
rarp.src.hw MAC address source hardware address
rarp.src.proto IPv4 address source protocol address
rarp.dst.hw MAC address destination hardware address
rarp.dst.proto IPv4 address destination protocol address
lldp - LLDP protocol
lldp.tlv - Type-Length-Value (TLV)
lldp.tlv.type number TLV type
lldp.tlv.len number TLV length
lldp.tlv.data - TLV value
mrp - MRP protocol
mrp.version number version
mrp.block - block
mrp.type number block type
mrp.length number block length
mrp.sequence_id number Sequence number
mrp.domain_uuid number domain UUID
mrp.prio number priority
mrp.sa MAC address sender MAC address
mrp.port_role number port state
mrp.ring_state number ring state
mrp.transition number transition
manual TINA V1.05 page 20