Siemens SITRANS F User manual

4/2014Edition
Answers for industry.
Operating Instructions
Ultrasonic Flowmeters
SITRANS CONNECTION APP
SITRANS F

SITRANS F
Ultrasonic Flow Meters
SITRANS CONNECTION APP
Operating Instructions
04/2014
A5E32182725
-AC
Introduction
1
SITRANS CONNECTION
Main Settings
2
Configuring SITRANS
Flowmeter to Communicate
with SITRANS
CONNECTION
3
Launching Connections
(Session Manager)
4
Communicating with
SITRANS Flowmeter
5
Troubleshooting
6

Siemens AG
Industry
Sector
Postfach 48 48
90026 NÜRNBERG
GERMANY
Order number: A5E32182725
Ⓟ
04/2014 Subject to change
Copyright © Siemens AG 2014.
All rights reserved
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by
personnel qualified
for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.

SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 3
Table of contents
1 Introduction............................................................................................................................................. 7
1.1 What is the SITRANS CONNECTION App?..................................................................................7
1.2 SITRANS CONNECTION App Requirement .................................................................................8
1.3 Connecting to SITRANS F US Serial Port .....................................................................................8
1.4 Terminal Overview .......................................................................................................................10
2 SITRANS CONNECTION Main Settings................................................................................................ 11
2.1 Terminal Settings .........................................................................................................................11
2.1.1 Columns (Default: 80) ..................................................................................................................12
2.1.2 Rows (Default: 24) .......................................................................................................................12
2.1.3 Scrollback (Default: 100)..............................................................................................................12
2.1.4 Clear On Contact .........................................................................................................................12
2.1.5 LineWrap......................................................................................................................................12
2.1.6 Text Size ......................................................................................................................................12
2.1.7 Console Logging (Default: Off) ....................................................................................................13
2.1.8 Auto Upload Logs (Default: Disabled) .........................................................................................13
2.1.9 Advanced Terminal Settings........................................................................................................13
2.2 Keyboard Settings........................................................................................................................16
2.2.1 Backspace Key ............................................................................................................................16
2.2.2 Enter Key .....................................................................................................................................16
2.2.3 Use Option as Ctrl........................................................................................................................17
2.3 Serial Settings..............................................................................................................................17
2.3.1 Auto Connect ...............................................................................................................................17
2.3.2 Baud Rate ....................................................................................................................................18
2.3.3 Stop Bits (Default: 1 Stop Bit) ......................................................................................................18
2.3.4 Flow Control .................................................................................................................................18
2.3.5 Parity ............................................................................................................................................19
2.3.6 Data Bits.......................................................................................................................................19
2.4 SSH Settings................................................................................................................................19
2.4.1 Keyboard Auth (SSH) ..................................................................................................................19
2.4.2 Private Keys .................................................................................................................................19
2.5 Shared Settings............................................................................................................................20
2.5.1 Siemens SITRANS CONNECTION Server .................................................................................20
2.5.2 Secure Connection (Default: Off).................................................................................................20
2.6 About SITRANS CONNECTION..................................................................................................21
2.6.1 Version .........................................................................................................................................21
2.6.2 Copyright......................................................................................................................................21
2.6.3 About SITRANS CONNECTION..................................................................................................21

Table of contents
SITRANS CONNECTION APP
4Operating Instructions, 04/2014, A5E32182725-AC
3 Configuring SITRANS Flowmeter to Communicate with SITRANS CONNECTION ................................ 23
3.1 RS-232 Configuration.................................................................................................................. 23
3.1.1 iOS Device .................................................................................................................................. 23
3.1.2 SITRANS Flowmeter................................................................................................................... 24
3.2 Cable Connections...................................................................................................................... 25
3.2.1 Cable Connection........................................................................................................................ 25
4 Launching Connections (Session Manager) .......................................................................................... 27
4.1 Session Manager ........................................................................................................................ 27
4.2 Quick Connect............................................................................................................................. 28
5 Communicating with SITRANS Flowmeter ............................................................................................ 31
5.1 Initial Setup.................................................................................................................................. 31
5.2 Navigating the SITRANS Menu .................................................................................................. 34
5.3 Downloading Data Files (Console Logging)................................................................................ 35
5.3.1 Console Logging ......................................................................................................................... 35
5.3.2 Downloading Files....................................................................................................................... 36
5.3.3 Viewing/Using Data Files ............................................................................................................ 37
5.4 Connection Manager................................................................................................................... 38
5.4.1 Serial ........................................................................................................................................... 39
5.4.2 Managing Connections in Folders .............................................................................................. 40
5.5 In Session Options ...................................................................................................................... 41
5.6 Session Sharing .......................................................................................................................... 42
5.6.1 Session Sharing .......................................................................................................................... 42
5.6.2 Establishing a Tech Support Session ......................................................................................... 43
5.6.3 Remote User Access .................................................................................................................. 44
5.6.4 Stop Sharing Session.................................................................................................................. 44
6 Troubleshooting .................................................................................................................................... 45
6.1 Serial Connectivity Issues........................................................................................................... 45
6.1.1 C2-RJ45V Cable Pinouts ............................................................................................................ 45
6.1.2 Console Cable Not Detected....................................................................................................... 45
6.1.3 Cable detected but no communication........................................................................................ 46
6.2 Session Sharing Issues............................................................................................................... 46
Tables
Table 1- 1 Connectivity Requirements ............................................................................................................9
Table 5- 1 Shared Session Options ..............................................................................................................43

Table of contents
SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 5
Figures
Figure 1-1 Main Settings Window .................................................................................................................10
Figure 2-1 Terminal Settings .........................................................................................................................11
Figure 2-2 Adjusting Text Size ......................................................................................................................12
Figure 2-3 Advanced Settings .......................................................................................................................13
Figure 2-4 Keyboard Settings........................................................................................................................16
Figure 2-5 Serial Settings ..............................................................................................................................17
Figure 2-6 Shared Settings............................................................................................................................20
Figure 2-7 About SITRANS CONNECTION..................................................................................................21
Figure 3-1 Serial Settings ..............................................................................................................................23
Figure 3-2 RS-232 Setup...............................................................................................................................24
Figure 3-3 RS-232 Connection Points for meters without DB-9....................................................................25
Figure 4-1 Session Manager .........................................................................................................................27
Figure 4-2 Live Session and Live Session & Closed Session.......................................................................28
Figure 4-3 Quick Connect..............................................................................................................................28
Figure 5-1 Initial Screen ................................................................................................................................31
Figure 5-2 Custom Key Selection..................................................................................................................32
Figure 5-3 Keyboard Presence Settings .......................................................................................................33
Figure 5-4 Keypad Brightness.......................................................................................................................33
Figure 5-5 Main Menu Screen .......................................................................................................................34
Figure 5-6 Downloading Files........................................................................................................................36
Figure 5-7 File Menu and File Control Options .............................................................................................37
Figure 5-8 Clipboard Editor ...........................................................................................................................38
Figure 5-9 Connection Details.......................................................................................................................39
Figure 5-10 Create Folder ...............................................................................................................................40
Figure 5-11 File and Folder Management .......................................................................................................40
Figure 5-12 Session Options...........................................................................................................................41
Figure 5-13 Shared Session Notification and Token Code .............................................................................42
Figure 5-14 Session Token Code....................................................................................................................43
Figure 6-1 C2-RJ45V Cable Pinouts .............................................................................................................45

Table of contents
SITRANS CONNECTION APP
6Operating Instructions, 04/2014, A5E32182725-AC

SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 7
Introduction
1
1.1
What is the SITRANS CONNECTION App?
SITRANS CONNECTION is an Apple App Store distributed terminal application for Apple
iPhones and iPads that allows users of Siemens SITRANS F-US clamp-on flowmeters to
connect to, and control their meter’s RS-232 serial ports to communicate directly with the
flowmeter menu without the need for cellular service. The user can also establish terminal
sessions over WIFI and 3G.
With the SITRANS CONNECTION App, you can perform programming, maintenance, data
gathering, and troubleshooting operations directly on your SITRANS F clamp-on flowmeter
and you can achieve remote connection over Wifi/3G for technical support assistance!
The SITRANS CONNECTION App has many features including:
●Physical serial access to all SITRANS clamp-on flowmeters with your iPhone or iPad via
the C2-RJ45V cable and DB-9 dongle (use of a C2-Lightning adaptor required for iPhone
5)
●Programmable serial configuration supports 300-57600 baud (38400 typical setting for
SITRANS communication) selectable parity, selectable flow-control, variable stop bits and
either 7 or 8 data bits
●SSHv2, Telnet, and RAW connectivity over WIFI/3G
●VT100, xterm and many other common Terminal emulations
●Encoding support for ASCII, UTF-8 and 17 other major encoding formats, including multi-
byte characters for non-Latin text terminals
●One Tap Secure Session Sharing allows a remote Siemens technical support engineer to
view and interact with the iPad/iPhones terminal window
●Tight integration with iPhone/iPad clipboard and cut/copy/paste directly from the terminal
window
●Comprehensive logging support, Command Shortcuts, Stored Passwords, Bluetooth
Keyboard and many other features.

Introduction
1.2 SITRANS CONNECTION App Requirement
SITRANS CONNECTION APP
8Operating Instructions, 04/2014, A5E32182725-AC
1.2
SITRANS CONNECTION App Requirement
●iPhone3 + (iOS version 5.1 or later is required)
●iPad1 onwards
●C2-RJ45V serial cable
●RJ45-DB9 dongle (SITRANS meters without DB-9 connector will also require a standard
serial cable)
●Wifi/3G connection for sharing session
1.3
Connecting to SITRANS F US Serial Port
Siemens SITRANS clamp on flowmeters utilize several different configurations for their RS-
232 port connectivity. Some have DB9 connectors while others have hard-wired or
specialized connections. Therefore; while all connections will utilize the C2-RJ45V cable with
an RJ45-DB9 dongle; depending on your specific meter type you will need to select one of 2
dongles and possibly an interconnection cable. Siemens offers the standard SITRANS
CONNECTION kit (P/N A5E32299674) which includes the C2-RJ45V cable and both a “Null
Modem” dongle (Brown) and a “Standard” dongle (Black); plus a gender changer), this kit
provides the basics for connection with any of clamp-on meters. Since not all of our meters
are equipped with a DB9 serial port Siemens offers 2 additional connection kits to connect
with those that don’t. The table below illustrates each meter variant, its serial port type, and
the connection kit.

Introduction
1.3 Connecting to SITRANS F US Serial Port
SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 9
Table 1- 1 Connectivity Requirements
Meter Type
Serial Port
Dongle Type
Connection Kit
FUP1010 (IP67)
Amphenol
Standard (Black)
A5E32299677
FUE1010 (IP65)
Wire Terminal
Standard (Black)
A5E32299675
FUE1010 (IP65) with
extended Io option
1
)
DB9 Null-Modem (Brown) A5E32299674
FUE1010 (IP40
portable)
DB9 Null-Modem (Brown) A5E32299674
FUG1010 all types
Wire Terminal
Standard (Black)
A5E32299675
FUG1010 (Not compact-
X) with extended Io
option
2,4
DB9 Null-Modem (Brown) A5E32299674
FUH1010 all types
Wire Terminal
Standard (Black)
A5E32299675
FUH1010 with extended
Io option
3,4
DB9 Null-Modem (Brown) A5E32299674
FUS1010 all types
Wire Terminal
Standard (Black)
A5E32299675
FUS1010 with extended
Io option
1,4
DB9 Null-Modem (Brown) A5E32299674
FUT1010 all types DB9 Null-Modem (Brown) A5E32299674
FST020
DB9
Null-Modem (Brown)
A5E32299674
Notes
1. FUS/FUE1010 Extended Io op
tion indicated by “J1B” adder in meter part number
2. FUG1010 Extended Io option indicated by “B” code in 9th digit of meter part number
3. FUH1010 Extended Io option indicated by “C” code in 9th digit of meter part number
4. Extended Io option not available on IP65 compact meters
In addition to the connection kit the SITRANS CONNECTION App P/N A5E33299678 can be
purchased from Siemens or downloaded from the iTunes App Store.

Introduction
1.4 Terminal Overview
SITRANS CONNECTION APP
10 Operating Instructions, 04/2014, A5E32182725-AC
1.4
Terminal Overview
The picture illustrates the main SITRANS CONNECTION window (for iPhone) and identifies
the major user interface features.
①
Data Transfer Indicator
⑤
Tools menu icon
②
Main Settings icon
⑥
Keypad on/Off/Dim icon
1. Full screen (no keypad)
2. Keypad in foreground
3. Keypad in background
③
Connection Manager
⑦
Special Function Key
④
Keypad Selector: 3 States
1. Std iOS keypad
2. Fixed special keys
3. Selectable special keys
Figure 1-1 Main Settings Window
The Main Settings icon is where most of the App features are configured.

SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 11
SITRANS CONNECTION Main Settings
2
The Main Settings page is accessible via the icon. This sets the application default
settings for all sessions. Some of these defaults can be varied on individual saved
connections (see Section 4 - Session Manager).
The App settings cover 5 main areas:
●
Terminal Settings
– functions specific to the terminal window including: linewrap, local
echo, scrollback size, and also access to the terminal scripting features.
●
Keyboard Settings
– Settings for how the keyboard behaves (with or without external
Bluetooth keyboard running).
●
Serial Settings
– Settings specific to serial connections with the SITRANS flowmeter;
baud rate, parity, data & stop bits.
●
SSH Settings
– Features specific to “Secure Shell Connections” (i.e. certificates/keys and
authentication methods).
●
Sharing Settings
– Settings requiring configuration in order to share the iOS device
terminal window with a remote user via the session server.
The following section details each of these setting areas.
2.1
Terminal Settings
Figure 2-1 Terminal Settings

SITRANS CONNECTION Main Settings
2.1 Terminal Settings
SITRANS CONNECTION APP
12 Operating Instructions, 04/2014, A5E32182725-AC
2.1.1
Columns (Default: 80)
Supports any column width up to 132 characters wide.
2.1.2
Rows (Default: 24)
Supports any number of rows on the screen.
2.1.3
Scrollback (Default: 100)
Number of lines retained by the terminal for review. Setting this above 250 will impact
performance on iPhone4 and below. iPad2, iPad3 and iPhone 4WS supports 500 scrollback
without impact due to improved hardware specifications.
2.1.4
Clear On Contact
Defines whether the terminal should clear the screen when starting a new connection.
The default is OFF
Options:
ON
OFF
2.1.5
LineWrap
Defines whether the terminal should automatically wrap the line to the next line when the
output received from the remote device exceeds the column width and no carriage return
has been received.
The default is ON
Options:
ON
OFF
2.1.6
Text Size
Sets font size in the terminal window.
Smaller................................................................Larger
Figure 2-2 Adjusting Text Size

SITRANS CONNECTION Main Settings
2.1 Terminal Settings
SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 13
2.1.7
Console Logging (Default: Off)
Logs all printable output to file stored on iOS device. The log files can be uploaded to
Siemens SITRANS CONNECTION website, or extracted via iTunes. Typically this function is
enabled when the user wishes to download a data file from the SITRANS flowmeter. Log
upload is performed via the Files section described below.
Options:
ON
OFF
2.1.8
Auto Upload Logs (Default: Disabled)
Automatically upload log files to remote storage repository (remote server) when the session
finishes. Note that this feature will not operate if Wifi/3G connectivity is not available during
the session.
Options:
Disabled
Remote Server
Note that to upload logs automatically to the remote server requires that the remote server
username/password be configured in the main settings in order to be linked to the SITRANS
CONNECTION App.
2.1.9
Advanced Terminal Settings
Figure 2-3 Advanced Settings

SITRANS CONNECTION Main Settings
2.1 Terminal Settings
SITRANS CONNECTION APP
14 Operating Instructions, 04/2014, A5E32182725-AC
● Bell Behavior
Allows the iOS device to create an alert when there is a Terminal event or stay silent.
Options:
Play Alert (bell/vibrate phone)
Do Nothing (silent)
● Cursor
Allow the choice of cursor style – the default is Underline.
Options:
●
None
●
Outline
●
Block
●
Vertical line
●
Underline
● Blink Cursor
Set cursor behavior – the default is Off
● Color Scheme
Changes the color scheme of the text and background of the terminal screen.
Options:
White on Black
White text on Black background
Black on White
Black Text on White background
Green on Black
Green Text on Black background
Rainbow
Helps debugging by coloring different parts of the screen.
•Blue: Left and right border
•Red: Upper border of the scrollback limit
•Black: Active area of the console within the scrollback limit
● ANSI Color
Allows up to 256 colors on terminal window following the ANSI spec for signaling color. The
default is ON.
Options:
ON
OFF

SITRANS CONNECTION Main Settings
2.1 Terminal Settings
SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 15
● Local Echo
Controls whether the terminal will echo characters entered to the screen locally or rely on the
SITRANS flowmeter to echo them. The default is Auto – where the terminal attempts to
recognize if remote serial device is echoing characters, and if so disables local echo. The
SITRANS flowmeter will echo typed characters therefore the default setting (Auto) is
acceptable.
Options:
●
Auto
●
Force On
●
Force Off
● Term Environment
Indication only, SITRANS CONNECTION is a VT100 terminal.
● Scroll Mode
Defines where the terminal view is positioned. For communication with SITRANS flowmeters
the default setting of “Keyboard Input” is recommended.
Options:
●
None - use touch screen to move around the terminal and scrollback window
.
●
Keyboard Input (Default) - pressing any key on keyboard will return the window view to
the active cursor position within the terminal window.
●
Terminal Activity – any terminal generated activity will center the terminal view to where
the terminal activity is being generated.
● Character Encoding
SITRANS CONNECTION supports 17 different encoding formats. The default is UTF-8
which is the required selection for serial communication with SITRANS flowmeters.
● Paste Rate Limit
When pasting large text files into the terminal window the remote serial device buffer or
buffer memory inside the (C2-RJ45V) cable can overflow, producing garbled text.
SITRANS CONNECTION has a speed control to allow for text from clipboard or scratchpads
to be “fed” into the terminal at a slower speed to ensure that the receiving device and C2-
RJ45V cable do not overflow their receive buffers.
Options:
●
Disabled (Text is sent to active terminal at maximum speed.)
●
Fast (Text is sent in 512 byte blocks with 1 second pause between blocks.)
●
Medium (Text is sent in 256 byte blocks with 1 second pause between blocks.)
●
Slow (Text is sent in 128 byte blocks with 1 second pause between blocks.)

SITRANS CONNECTION Main Settings
2.2 Keyboard Settings
SITRANS CONNECTION APP
16 Operating Instructions, 04/2014, A5E32182725-AC
2.2
Keyboard Settings
There are 3 configuration items under the Keyboard Settings section of the main App
Settings.
Figure 2-4 Keyboard Settings
Note
It is possible to use the SITRANS CONNECTION app with a Bluetooth keyboard and the
settings configured here will have an effect on the keyboard. Further, full Bluetooth keyboard
support is not yet implemented as ESC and arrow key
s will not work on Bluetooth
keyboards.
2.2.1
Backspace Key
The default setting is CTRL-H which is correct for SITRANS flowmeter communication.
Options:
Control-H
Control-? (127)
2.2.2
Enter Key
SITRANS CONNECTION has 3 options for the command that will be sent when the enter
key is pressed. By default it sends “Carriage Return” (0x0D) which is the OSX standard. This
setting can be changed to Line Feed (0x0A) or both, Carriage Return followed by Line Feed
(0x0D0A) each time the Enter key is pressed. For SITRANS flowmeters the default setting is
correct.
Options:
●
Carriage Return
●
Line Feed
●
CR + LF

SITRANS CONNECTION Main Settings
2.3 Serial Settings
SITRANS CONNECTION APP
Operating Instructions, 04/2014, A5E32182725-AC 17
2.2.3
Use Option as Ctrl
SITRANS CONNECTION implements a workaround for the control key inoperability on
Bluetooth keyboards. If using a Bluetooth keyboard with SITRANS CONNECTION, you can
select the “Use Option as Ctrl” to use the Alt/Option key on the keyboard to send CTRL-[key]
sequences. The default setting is OFF.
Options:
ON
OFF
2.3
Serial Settings
The SITRANS CONNECTION serial settings allow for the full range of physical serial
settings available on the C2-RJ45V cable to be set. When the C2-RJ45V cable is adapted to
a DB9 connection, only the pins available on the RJ45V connector can be carried through;
e.g. Pin 9 on DB9 connector (ring indicator) cannot be carried. This limitation does not affect
communication with SITRANS flowmeters.
The parameters available for each Serial option are described below:
Figure 2-5 Serial Settings
2.3.1
Auto Connect
SITRANS CONNECTION App automatically connects to the physical cable connection (C2-
RJ45V or serial) when it’s plugged into the iPhone/iPad/iPod port. This applies whether or
not there is an existing Telnet or SSH connection (a new Serial connection will be added to
your connection list).
Options:
ON
OFF

SITRANS CONNECTION Main Settings
2.3 Serial Settings
SITRANS CONNECTION APP
18 Operating Instructions, 04/2014, A5E32182725-AC
2.3.2
Baud Rate
Allows the choice of different baud rates to suit communication with the SITRANS flowmeter.
This setting must match the RS-232 configuration of the SITRANS flowmeter; failure to
match the Baud rates will result in either no output or garbled screen output. The default
Baud rates of the SITRANS flowmeter and the SITRANS CONNECTION App are 9600. The
maximum baud rate for the SITRANS meters is 38400. It is recommended to set the
SITRANS CONNECTION App and the SITRANS meter to 38400 for fastest communication
of data.
Options:
●
1200 Baud
●
2400 Baud
●
4800 Baud
●
9600 Baud
●
19200 Baud
●
38400 Baud
●
57600 Baud
●
115200 Baud
2.3.3
Stop Bits (Default: 1 Stop Bit)
1 stop bit is the standard configuration of the SITRANS flowmeter therefore this setting need
not be changed.
Options:
1 Stop Bit
2 Stop Bits
2.3.4
Flow Control
The default setting of Hardware RTS/CTS is suitable for communication with SITRANS
flowmeters. If the flow control setting is changed the C2-RJ45V cable must be removed and
reinserted to reset its configuration.
Options:
●
None
●
Hardware (RTS/CTS)
●
Hardware (DSR/DTR)
●
Software (XON/XOFF)