Field Tools Quick Start Guide en 132498
Field Tools Quick Start Guide en 132498
Field Tools Quick Start Guide en 132498
D301703X412
November 2023
System Training
A well-trained workforce is critical to the success of your operation. Knowing how to correctly install, configure, program,
calibrate, and troubleshoot your Emerson equipment provides your engineers and technicians with the skills and confidence to
optimize your investment. ETS offers a variety of ways for your personnel to acquire essential system expertise. Our full-time
professional instructors can conduct classroom training at several of our corporate offices, at your site, or even at your regional
Emerson office. You can also receive the same quality training via our live, interactive Emerson Virtual Classroom and save on
travel costs. For our complete schedule and further information, contact the ETS Training Department at 800-338-8158 or email
us at [email protected].
Grounding Equipment
Ground metal enclosures and exposed metal parts of electrical instruments in accordance with relevant safety standards. For the
USA, refer to OSHA rules and regulations as specified in Design Safety Standards for Electrical Systems, 29 CFR, Part 1910, Subpart S,
dated: May 16, 1981 (OSHA rulings are in agreement with the National Electrical Code). For international locations, refer to IEC
60364-4-41: PROTECTION AGAINST ELECTRIC SHOCK. You must also ground mechanical or pneumatic instruments that include
electrically operated devices such as lights, switches, relays, alarms, or chart drives. The chassis (or earth ground) lug provides a
safe connection point to a customer-designated ground location for ESD and transient voltage suppression. Do not use the
chassis ground lug for signal, common, or return connections. Do not connect the chassis ground lug directly to a lightning
arrestor/lightning rod. Do not run signal wiring in conduit or open trays with power wiring or near heavy electrical equipment.
If shielded wiring is used, ground the shield of the signal wiring at any one point of the signal loop.
Important: Complying with the codes and regulations of authorities having jurisdiction is essential to ensuring personnel safety.
The guidelines and recommendations in this manual are intended to meet or exceed applicable codes and regulations. If
differences occur between this manual and the codes and regulations of authorities having jurisdiction, those codes and
regulations must take precedence.
Ethernet Connectivity
This automation device is intended to be used in an Ethernet network which does not have public access. The inclusion of this
device in a publicly accessible Ethernet-based network is not recommended.
Returning Equipment
If you need to return any equipment to ETS, it is your responsibility to ensure that the equipment has been cleaned to safe levels,
as defined and/or determined by applicable federal, state and/or local law regulations or codes. You also agree to indemnify ETS
and hold ETS harmless from any liability or damage which ETS may incur or suffer due to your failure to ensure device
cleanliness.
ii
Field Tools Quick Start Guide
D301703X412
November 2023
Contents
Chapter 1. Introduction 1
1.1 What is Emerson Field Tools? .............................................................................................. 1
Chapter 2. Installation 3
2.1 Minimum System Requirements ........................................................................................ 3
2.1.1 Notes on USB to Serial Converters ......................................................................... 3
2.2 Before you Begin .................................................................................................................. 3
2.2.1 Disabling User Account Control (UAC) in Windows .............................................. 4
2.2.2 Special Notes for BSI_Config/TechView Users ...................................................... 5
2.2.3 Special Notes for OpenBSI Users ........................................................................... 6
2.2.4 Special Notes for ROCLINK Users ........................................................................... 6
2.3 Installing Field Tools............................................................................................................. 6
2.3.1 Custom Install/Upgrade without User Prompts .................................................11
2.3.2 Validating the Field Tools Zip file Hash ................................................................14
Contents iii
Field Tools Quick Start Guide
D301703X412
November 2023
Chapter 4. FBxNet™ 49
4.1 What is FBxNet?.................................................................................................................. 49
4.2 Licensing FBxNet ................................................................................................................ 49
4.3 How do I configure FBxNet? ............................................................................................. 53
4.4 Starting FBxNet .................................................................................................................. 55
4.5 Switching Between Monitor and Configuration Mode .................................................. 57
4.6 Creating a Site .................................................................................................................... 57
4.6.1 Editing the Site ....................................................................................................... 59
4.6.2 Deleting a Site ........................................................................................................ 60
4.7 Creating a Subscriber Directly in FBxNet ........................................................................ 60
4.7.1 Editing a Subscriber .............................................................................................. 62
4.7.2 Deleting a Subscriber ............................................................................................ 62
4.8 Adding a Publisher ............................................................................................................. 62
4.8.1 Editing a Publisher................................................................................................. 63
4.8.2 Deleting a Publisher .............................................................................................. 63
4.9 Adding a New Parameter .................................................................................................. 63
4.9.1 Editing Existing Publishing Parameters .............................................................. 64
4.9.2 Deleting a Parameter ............................................................................................ 65
4.10 Synchronizing CSV Files .................................................................................................... 65
4.11 Manually Creating the Subscriber CSV File .................................................................... 66
4.11.1 Subscriber File Format ........................................................................................ 67
4.11.1 Subscriber File Example – Created in Excel ...................................................... 69
4.11.2 Subscriber File Example – Created in a Text Editor ......................................... 70
4.12 CSV File Validation ............................................................................................................. 71
4.13 FBxNet Authentication ...................................................................................................... 71
4.14 Downloading CSV Files ..................................................................................................... 72
4.14.1 Downloading CSV Files for a Single Site............................................................ 73
4.15 Making Changes to Your CSV Files.................................................................................... 73
4.15.1 Making Edits Manually in Microsoft® Excel or a Text Editor ........................... 73
4.15.2 Making Edits Directly in FBxNet ......................................................................... 74
4.15.3 Downloading the Modified CSV Files to Subscribers ....................................... 74
4.16 Restoring the Backup of Previous CSV Files at the PC .................................................. 74
4.17 Viewing Status of the Subscriber Device ........................................................................ 75
4.18 Viewing Status of the Publisher Devices......................................................................... 76
4.19 Viewing Details on a Single Publisher ............................................................................. 78
4.20 Modifying FBxNet Configuration Parameters................................................................ 79
4.21 Enabling/Disabling Fault Processing............................................................................... 80
4.22 Troubleshooting Tips ........................................................................................................ 82
4.23 FBxNet Settings ................................................................................................................. 82
4.24 Working with the Tag Browser ........................................................................................ 83
Index 121
Contents v
Field Tools Quick Start Guide
D301703X412
November 2023
vi Contents
Field Tools Quick Start Guide
D301703X412
November 2023
Chapter 1. Introduction
1.1 What is Emerson Field Tools?
Emerson Field Tools provides a single integrated package for connecting to and
configuring ROC, FloBoss™, ControlWave™ flow computers and RTUs, FB1000/FB2000
Series Flow Computers, and FB3000 RTUs.
In addition, if you install configuration tools for the controller (ROCLINK, TechView, and/or
FBxConnect) Field Tools automatically launches the appropriate tool when you open a
connection to a ROC, FloBoss, ControlWave device, an FB1000/FB2000 Series Flow
Computer, or an FB3000 RTU.
Introduction 1
Field Tools Quick Start Guide
D301703X412
November 2023
2 Introduction
Field Tools Quick Start Guide
D301703X412
November 2023
Chapter 2. Installation
2.5 GB available hard disk space to install the full software package
8 GB RAM
o Ethernet port
For details on compatibility of Field Tools with particular hardware, software, and
firmware, please refer to the Field Tools Product Data Sheet (D301735X012).
BlackBox IC199A
IOGear® GUC232A
CHIPI-X10
If you experience problems with your converter, see Appendix A – Troubleshooting Tips.
Installation 3
Field Tools Quick Start Guide
D301703X412
November 2023
Important
Field Tools cannot reside on a computer running any components of OpenEnterprise
2.x, OpenEnterprise 3.x, OpenEnterprise Client/Server software, or ObjectServer.
Field Tools includes components of BSI_Config (such as TechView) which are from
OpenBSI version 5.9 Service Pack 3.
Field Tools can co-exist on a computer running OpenBSI Network Edition 5.9 Service
Pack 2 (or newer). It cannot be installed on a computer running OpenBSI versions
older than 5.9 Service Pack 2.
You must have administrative privileges to install Field Tools. The reason you need
these privileges is because the Field Tools installer writes to certain folders on your PC
that are normally hidden from regular users.
Field Tools requires Internet access to communicate with RTUs and flow computers
via Ethernet, and during installation and license registration. If your anti-virus
software blocks Field Tools, you must follow instructions for that anti-virus program
to“white list” Field Tools so it can communicate through the firewall.
If installing TechView, close all other programs down before you begin installation. In
particular Office 365 components must be closed because they can interfere with the
Field Tools installer.
You must disable User Account Control (UAC) prior to the installation (you can re-
enable it after a successful installation). See Section 2.2.1.
If you are using an Enterprise version of the Windows operating system and your
administrative privileges do not include read/write access to \ProgramData\Emerson
and its sub-folders, these privileges must be set manually by your system
administrator.
For best results on a PC or laptop, set your Windows Control Panel display settings for
smaller fonts (100% default). Larger fonts may cause some screen items to overlap or
be cut off.
For best results on a tablet, set your Windows Control Panel display settings for either
smaller fonts (100%) or medium fonts (125% default). DPI should be 100.
4 Installation
Field Tools Quick Start Guide
D301703X412
November 2023
1. Click Start > Control Panel to open the Windows Control Panel.
4. Drag the sliding control down to Never notify and click OK.
Installation 5
Field Tools Quick Start Guide
D301703X412
November 2023
To preserve your existing files, always backup the device directory (which includes the
ROC_USER.MDB file) before you install ROCLINK, and then copy it back after the
installation completes. The device directory is the folder \Program Files\ROCLINK800.
You can only have three simultaneous ROCLINK connections to devices through Field
Tools.
Important
If you are not a registered SupportNet™ user, activating a new SupportNet account to
obtain Field Tools software may take up to 24 hours to process.
If you are installing the Field Tools executable from a network drive, there may be a long
delay while the installer extracts and uncompresses files onto the local PC.
1. Right-click on the Field Tools (.EXE) installation file and choose Run as administrator
from the pop-up menu.
2. The installation process starts and checks whether certain necessary software
components exist on the laptop, and if they are not present, the installation process
prompts you to install them. Click Install. This process may take several minutes, and
the installer may require you to reboot your PC.
6 Installation
Field Tools Quick Start Guide
D301703X412
November 2023
Once installation of the required components finishes, the Field Tools installation
wizard starts:
3. Click Next.
Installation 7
Field Tools Quick Start Guide
D301703X412
November 2023
4. To proceed with the installation, click I accept the terms of the license agreement
and then click Next.
5. Use the default installation folders for the program and data or click Browse to
specify different locations. Then select the optional configuration packages you want
to install and click Next.
8 Installation
Field Tools Quick Start Guide
D301703X412
November 2023
Notes
You must purchase a license to use FBxDesigner; see the FBxDesigner Quick Start
Guide (D301860X012) for instructions on licensing that product. FB3000 users can
purchase various features and applications. You can license these from within
FBxConnect, or through the Emerson Customer Portal. See the FBxConnect online
help and the Emerson Customer Portal Quick Start Guide (D301878X012) for details.
You can access licensing tools through the Help > Licensing menu item in Field
Tools.
If you are installing over an existing version of Field Tools, you have the option to
preserve any saved connections by checking Retain Previous Connections, and
to preserve the password for Field Tools software by checking Retain
Administrator Password.
Installation 9
Field Tools Quick Start Guide
D301703X412
November 2023
7. The software prompts you whether you want the installer to create a Field Tools
desktop icon; click Yes if you want to start Field Tools from the desktop.
10 Installation
Field Tools Quick Start Guide
D301703X412
November 2023
To do this with Field Tools, you must create a custom setup file in a temporary folder that
specifies which packages the installer should load.
The recommended way (and easiest way) to create the setup file is to create a desktop
shortcut to the Field Tools installer, and then invoke the installer with the record option
“/r” to save your installation choices to a file. Then you can use the file with the silent
install “/s” option to install Field Tools for a user.
1. With the Field Tools installer in your temporary folder “C:\temp”, right-click on it and
choose Create shortcut and then examine the Target field in the properties of the
resulting shortcut:
2. Edit the target line to set the record option “/r” along with the “/f1” option to specify
the path and name of the setup file:
C:\temp\FieldTools3110131.exe /r /f1"C:\temp\full.iss"
4. Right-click on the shortcut and choose Run as administrator to invoke the Field Tools
installer and make your installation choices. See Section 2.3 for information on what
the different fields mean. When you click Finish to complete the installation, you
should have a completed ISS file in the C:\temp folder that reflects the choices you
made in the installer and looks similar to the file, below:
[InstallShield Silent]
Version=v7.00
File=Response File
[File Transfer]
OverwrittenReadOnly=NoToAll
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-DlgOrder]
Dlg0={A336A33B-40A8-4032-BAD6-58A04D514F12}-SdWelcome-0
Count=5
Dlg1={A336A33B-40A8-4032-BAD6-58A04D514F12}-SdLicense2Rtf-0
Dlg2={A336A33B-40A8-4032-BAD6-58A04D514F12}-Options-0
Installation 11
Field Tools Quick Start Guide
D301703X412
November 2023
Dlg3={A336A33B-40A8-4032-BAD6-58A04D514F12}-AskYesNo-0
Dlg4={A336A33B-40A8-4032-BAD6-58A04D514F12}-SdFinish-0
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-SdWelcome-0]
Result=1
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-SdLicense2Rtf-0]
Result=1
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-Options-0]
Designer=0
ROCLink=0
TechTools=0
FBx=1
Connections=1
Password=1
Path=C:\Program Files (x86)\Emerson\OpenEnterprise
[Application]
Name=Field Tools
Version=3.11.0.131
Company=Emerson
Lang=0409
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-AskYesNo-0]
Result=0
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-SdFinish-0]
Result=1
bOpt1=0
bOpt2=0
The bolded items are portions you may choose to edit manually if you decide you want to
change the setup file. Table 2-1, below, explains these items:
12 Installation
Field Tools Quick Start Guide
D301703X412
November 2023
Note
Once you complete the standard install you should save the _users.bin and
FieldToolsContainer.config files from the \Emerson\FieldTools\Application Data\
folder. When you want to run an install/upgrade on a new PC, place these files in the
same folder on the new PC before installing Field Tools because these files are only read
at install/upgrade time.
1. Edit the target line for the shortcut you created for the installer, and change “/r” to
“/s”
C:\temp\FieldTools3110131.exe /s /f1"C:\temp\full.iss"
2. Right-click on the shortcut and choose Run as administrator to invoke the Field Tools
installer with your setup file.
3. The installer generates a log file – setup.log – in the C:\temp folder. If you see
“Resultcode=0” you know the installation completed successfully.
When upgrading existing Field Tools installations, you need to create a separate setup file
specific to the upgrade. Follow the same procedure of creating a shortcut and specifying
a setup file path and filename with the “/r” and “/f1” options to record the upgrade; be
sure to use a different name to avoid overwriting your existing setup file.
Then run the file in the same way by editing the shortcut using the “/s” and “/f1” options.
[InstallShield Silent]
Version=v7.00
File=Response File
[File Transfer]
OverwrittenReadOnly=NoToAll
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-DlgOrder]
Dlg0={A336A33B-40A8-4032-BAD6-58A04D514F12}-Options-0
Count=2
Dlg1={A336A33B-40A8-4032-BAD6-58A04D514F12}-SdFinish-0
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-Options-0]
Designer=1
ROCLink=1
TechTools=1
FBx=1
Connections=1
Password=1
Path=C:\Program Files (x86)\Emerson\OpenEnterprise
[Application]
Installation 13
Field Tools Quick Start Guide
D301703X412
November 2023
Name=Field Tools
Version=3.11.0.131
Company=Emerson
Lang=0409
[{A336A33B-40A8-4032-BAD6-58A04D514F12}-SdFinish-0]
Result=1
bOpt1=0
bOpt2=0
Once you download the zip file to your PC, make note of the folder where it resides so
you can check the hash of the zip file as follows:
2. Use the CD command to go to the folder where the ZIP file resides.
4. Compare the hash number you see with the one in the MD5 TXT file. If they do not
match, it indicates the Field Tools zip file has been altered. See example, below:
6. Compare the hash number you see with the one in the SHA256 TXT file. If they do
not match, it indicates the Field Tools zip file has been altered. See example,
below:
14 Installation
Field Tools Quick Start Guide
D301703X412
November 2023
7. If either the MD5 hash or the SHA256 hash you generate from the ZIP file does
not match the corresponding .TXT files for MD5 or SHA256, do not use the ZIP file.
Contact Emerson for assistance.
Installation 15
Field Tools Quick Start Guide
D301703X412
November 2023
16 Installation
Field Tools Quick Start Guide
D301703X412
November 2023
CAUTION
When making multiple FBxConnect connections to the same device (as with a remote
and a local connection), be aware that the changes one connection makes to the device
may not be immediately visible to other connections and may even require the other
connections to restart FBxConnect before changes become visible. For example, simple
changes (such as changes to setpoints) may be immediately visible to all connections,
but changing the number of meters, configuring I/O, adding/deleting menu items, or
other major configuration changes may require re-establishing the connection using
FBxConnect.
For IP connections, connect the laptop to the same IP network which includes the
controller or flow computer.
If you have an FBx-series device with the FBxWifi option, you can use a wireless IP
connection. This option requires you know the connection key for the wireless
network.
For details on cabling/wiring, consult the hardware manual for your controller or flow
computer.
Important
When using Field Tools for serial communication, you must plug into the Local
Port. For ControlWave-series units, this is a port for which you’ve set the
_Pn_LOCAL_PORT system variable TRUE in the ControlWave project running in
Communication Setup 17
Field Tools Quick Start Guide
D301703X412
November 2023
the unit. Local ports answer to requests sent to a BSAP local address of 1 which
is what Field Tools requests. For Network 3000, this is a BSAP slave or pseudo-
slave port. For a ROC or FloBoss, the Local Port is a specific port (the LOI port)
which answers to the address of 240 and a group number of 240.
For ControlWave/Network 3000 devices only, you need to know which TechView
session (*.TVS) file is appropriate for your device so you can specify it when you
establish your connection. If you installed TechView, a set of default TVS files resides
on your hard disk in your \openbsi installation path. The Connection wizard opens
that folder first when you specify your TVS file. For example, there is a CWaveEFM.TVS
file to support the ControlWave EFM, a CWaveGFC.TVS file to support the ControlWave
GFC, and so on. If you have a customized application with a customized TVS file, you
should place it in that folder.
2. In the Log In dialog box, enter your User name and Password and click Log in.
Important
The very first time you log in, use admin for the User name and leave the Password
field blank. Once you’ve logged in with these defaults, Field Tools prompts you to
change your password:
3. The Field Tools main screen opens. Use it to establish a connection with the controller
/ flow computer.
18 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
1. Click Security > Change password from the menu bar. The Change Password dialog
box opens.
Note
The very first time you start Field Tools, the default password for the ADMIN account
is blank, and Field Tools forces you to define a new password; click OK to open the
Change Password dialog box. Passwords are case sensitive.
2. In the Change Password dialog box, enter the current password in the Old password
field, then enter the new password in both the New password and Confirmation
fields, then click OK. Your password is now changed.
Communication Setup 19
Field Tools Quick Start Guide
D301703X412
November 2023
To define the Field Tools users on this PC click Security > User management from the
menu bar. This opens the User Management dialog box.
2. Click Add User. Optionally choose a Role for the user. (Particular roles can have
particular privileges associated with them.)
Notes
Usernames are case-insensitive and are stored in the database as lowercase.
Do not create a user named Operator. This word is reserved for use internally by
Field Tools.
5. Click OK.
20 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
1. Click Security > Security configuration to open the Security configuration dialog
box.
2. Enter the minimum number of characters required for a valid password and click OK.
From this point on, all users you define must have a password of this length or longer.
Existing users created previously with passwords shorter than this number are
unaffected.
1. If the User Management dialog box is not already open, click Security > User
management to open it.
Communication Setup 21
Field Tools Quick Start Guide
D301703X412
November 2023
2. Click the name of the user for which you want to define RTU login credentials then
click Credentials mapping. The Credentials mapping dialog box opens.
3. Enter a Username and Password for accessing the particular RTU type(s). If your
system includes a mixture of different ROC/FloBoss devices in which some use the
enhanced security scheme and others use the legacy security scheme, you should
enter appropriate usernames and passwords for both schemes.
Note
ROC/FloBoss devices with newer firmware support either the legacy security scheme
(shorter usernames and passwords); or the enhanced scheme, but once upgraded to
the enhanced scheme, they no longer support the legacy scheme. Devices with older
firmware only support the legacy scheme. Refer to Table 3-1 to determine which
ROC/FloBoss devices support the enhanced security scheme.
4. Click OK.
22 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
Communication Setup 23
Field Tools Quick Start Guide
D301703X412
November 2023
Icon Description
Site - A site is just a name underneath which you can group one or more
connections. It could represent a geographical area, a department, or any
other logical grouping you need. The Connections list comes with a default site
name called “All Connections” which you can rename and/or add additional
sites underneath. Although you can rename it, you cannot delete the “All
Connections” site; you can delete other sites if they have no devices
underneath.
Add Connection. Click to launch the Connection wizard. You can find this icon
in the Connections list toolbar and in the context menu when you right click on
a site.
Edit Connection. Click to change the connection parameters for the selected
connection. You cannot edit an active connection.
Note: If you change the connection name, when you save, Field Tools prompts
you to decide whether you want to save the connection as a new connection
under the new name (Add new connection), or to just rename the existing
connection (Replace connection).
24 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
2. To activate a connection, double-click on its icon and Field Tools activates that
connection and automatically launches the appropriate configuration tool (ROCLINK,
TechView, or FBxConnect). Alternatively, you can right-click on the connection name,
and choose Connect in the context menu:
2. If you want to associate the device with a particular site, first click the site name in the
Connections list. (If you don’t want to choose a site at this time, you can skip that – the
connection will automatically belong to the All Connections site.)
3. Click the Add connection icon in the Connections pane toolbar. If the icon is not
visible (because no site is selected) click Connections > Add connection from the
menu bar. Either way, the Connection wizard opens.
Communication Setup 25
Field Tools Quick Start Guide
D301703X412
November 2023
4. Select the type of device to which you want to connect in the Device platform field.
The choices are: FloBoss/ROC/DL8000, ControlWave/33xx, or FBx (for the
FB1000/FB2000 Series Flow Computers or FB3000 RTU).
Note
“33xx” refers to Network 3000 devices (for example, DPC 3330, DPC 3335, RTU 3310).
5. Enter the name of the field device in the Specify name field. For FBx devices, click the
Get name from device button and Field Tools obtains the device name from the
device (if it exists). If no name exists in the device, Field Tools uses the name “Default.”
Note
Make connection names alpha-numeric; you can also include dashes, underscores, or
spaces. Connection names cannot include special characters such as single or double
quotation marks, commas, slashes, periods, colons, or asterisks. There is no pre-set
maximum length for connection names.
26 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
subsequent connection sessions check the Save as default box. Click OK to finish and
close the dialog box. Once you have saved the defaults, you can reload the default
username and password when creating subsequent connections by clicking Restore
Default.
Note
For FB1000/FB2000 Series Flow Computers or the FB3000 RTU, Field Tools uses the
Field Tools Username and Password by default. If that username/password
combination is not correct for the device, you can enter the correct ones, when
prompted, and Field Tools then stores them with the connection details for that
device. For that reason, there is no Device Credentials option for these devices.
Note
If you do not currently have a ZSL file for the connection on your PC but you want to
use low bandwidth mode, you must connect to the device normally (without low
bandwidth) and upload the solution running in the device to your PC. Then close the
connection and create a new connection and select low bandwidth mode and when
prompted, select the ZSL file you uploaded from the device.
8. Choose a Connection type. Choices include either Serial, IP, or WiFi (if you have an
FB1000/FB2000 Flow Computer). Proceed to Step 9 for serial communication; skip to
Step 10 for IP communication; skip to Step 11 for Wi-Fi communication.
Communication Setup 27
Field Tools Quick Start Guide
D301703X412
November 2023
Figure 3-11. Serial Connection Settings – FB1000/FB2000 Series Flow Computers &
FB3000 RTU
Select the PC communication port in the Comm port drop down menu, otherwise
leave it at the Auto default which causes the Connection wizard to cycle through the
various ports until it finds the correct one. You can refresh the port selections by
clicking the refresh ( ) button.
The Wizard hides certain parameters to simplify configuration using default values;
while this is useful in some situations, we recommend you enter the Baud rate and
Address if you know them, rather than letting Field Tools attempt to auto-discover
them. Most other parameters may be left at default values. Click Show more
parameters to specify additional parameters as follows.
If you know the baud rate for communicating with the field device, you can specify it
in the Baud rate drop-down field. Otherwise use the Auto default which causes the
Connection Wizard to cycle through the supported baud rates (9600, 19200, 38400,
57600, and 115200) until it finds the correct one.
28 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
Optionally specify the Link Timeout for this connection. That value defines the period
of time (in milliseconds) Field Tools waits for a response from the RTU or flow
computer before declaring a communication failure. If you enter 0, Field Tools uses a
default of 200 milliseconds. Optionally, you can change the Retries parameter, which
sets the total number of attempts to send a communication message before declaring
an error.
Specify the Address and the Group according to the following table:
For ROC/FloBoss only: Under Extra Parameters use the […] button to specify the
ROC/FloBoss .800 Configuration file to associate it with this connection when
ROCLINK launches. The .800 file must reside on this laptop PC.
Communication Setup 29
Field Tools Quick Start Guide
D301703X412
November 2023
For ControlWave/Network 3000 units only: Under Extra Parameters use the […]
button to specify the TechView session file you want to use with this connection
when TechView launches. The TechView session file must reside on this laptop PC.
Tips
The Auto options are useful if you do not know the communication port, baud rate, or
(for ControlWave/33xx only) the local address. If you leave all of these fields at Auto,
however, it could take considerable time to establish the connection since the system
must successively try each port, each of the five supported baud rates, and for
ControlWave/33xx each of 127 possible local addresses.
The maximum number of connection attempts if all fields are left at Auto for a
ROC/FloBoss is (# of serial ports) * 5.
The maximum number of connection attempts if all fields are left at Auto for a
ControlWave/33xx is (# of serial ports) * 635.
30 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
Notes
If you make an invalid entry in one of the Connection Wizard fields, a warning icon
blinks, and you must correct the invalid entry.
Specify the IP address of the RTU or flow computer. Position your cursor in the left-
most digit position of the IP address field, enter the value for that position and use
the tab key to move to the next position and so on until you enter the complete IP
address. If you want to highlight the entire address to type over it, click the icon.
Specify the port (IP socket number) used by this connection. The following table
shows the default ports:
Note
Field Tools only supports a single active IP connection to one ControlWave device at a
time on a given default port. If more than one ControlWave device shares the same
default port, only one of those ControlWave devices can have an active IP connection
at any one time. If you attempt to start a second connection, Field Tools posts the
message “An IP connection to a Bristol device already exists. Only one such
Communication Setup 31
Field Tools Quick Start Guide
D301703X412
November 2023
connection is allowed.” To make the new connection you must manually close down
the existing active connection and then you can start the new connection.
Optionally specify the Link Timeout for this connection. That is the period of time (in
milliseconds) Field Tools waits for a response from the RTU or flow computer before
declaring a communication failure. If you enter 0 Field Tools uses a default of 5000
milliseconds.
If the connection is through a terminal server, select the Terminal Server checkbox
and set the IP address and Port (socket) to be the IP address and port of the terminal
server.
For ROC/FloBoss only: Under Extra parameters use the […] button to specify the
ROC/FloBoss .800 Configuration file in order to associate it with this connection
when ROCLINK launches. The .800 file must reside on this laptop PC.
For ControlWave/Network 3000 units only: Under Extra parameters use the […] button
to specify the TechView session file you want to use with this connection. The
TechView session file must reside on this laptop PC.
32 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
Wi-Fi networks that your laptop detects are shown onscreen. For this type of
connection to work, the laptop must first detect the WiFi Network to which the
device belongs. The default WiFi Network follows the format FBxxxx_serialnumber.
Specify the IP address of the RTU or flow computer as described in Table 3-5.
Position your cursor in the left-most digit position of the IP address field, enter the
value for that position and use the tab key to move to the next position and so on
until you enter the complete IP address. If you want to highlight the entire
address to type over it, click the icon. The default IP address for
FB1000/FB2000 Flow Computers when they ship from the factory is 192.168.1.10.
If you do not know the address, check the Discover address of device box.
Specify the Port (IP socket number) of the RTU or flow computer. The default port
is 20000.
Enter the Security Key for the wireless network. To see it as you type it, click the
eyeball icon. The default security key for FB1000/FB2000 Flow Computers when
they ship from the factory is EmersonFBXX00. Be sure to change it to something
only your organization knows when you place the device in service.
If you don’t want to activate the connection right now, but just want to save your configuration
entries, you can click Save; this saves your entries in the Connection list, and exits the wizard. If
you want to connect right now, click Connect and the wizard attempts to establish the
connection.
Communication Setup 33
Field Tools Quick Start Guide
D301703X412
November 2023
Note
1. If you previously specified the zipped solution file to use, you can select
Use existing cached solution to proceed. Optionally, you additionally
may also select Do not show these options again. Always use cached
solution and going forward, Field Tools will always use the cached
solution for this particular connection.
2. If, however, Use existing cached solution is grayed out, and Import
cached solution is already chosen, it means you have not specified the
zipped solution (*.ZSL) file yet and you must do so now to proceed. Click
Browse and navigate to the correct solution file. If when you select, a
mismatch is reported between the solution currently in the FB3000, and
the cached solution, we recommend you exit Low Bandwidth Mode and
recreate the connection at the regular bandwidth speed (no low
bandwidth) and upload the solution running in the FB3000 to your PC,
then select that newly uploaded file as your cached solution so that the
solutions in both locations match. Alternatively, you can proceed with the
mismatch but data from some object instances may not be available.
Field Tools reports details of the connection progress in the Connection progress pane.
If the connection is successful, the Active connection pane of the Field Tools main screen
shows an icon for the newly connected device and its toolbar populates with icons appropriate
to the device type.
34 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
If the device has SAv5 secure authentication enabled, and Field Tools does not have the key,
you must provide it. You can import the key by clicking Import key from file and Browse for the
ZCF file (zipped connection file) containing the key; select the file and provide the file password
when prompted. Alternatively, you can type in the key manually, or right-click in the field and
paste the key if you copied it from another file. To see the key, click the eye icon . In either
case, once you provide the key, click Connect.
In addition, Field Tools automatically launches the configuration tool (ROCLINK, TechView, or
FBxConnect) appropriate for the device platform.
Communication Setup 35
Field Tools Quick Start Guide
D301703X412
November 2023
Click Connections > Direct Connect and select the type of device from the options
presented. Field Tools attempts to establish a local serial connection by sequentially
trying each serial port using the default settings for that device type.
36 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
The Active Connection pane includes a separate tab for each active connection. Click on
the tab to see details about a particular connection.
To see information about a device (RTU, flow computer), move the cursor over that device
and a small status box opens that shows details based on the type of device. This could
include its address, or certain status information.
To disconnect an active connection, right click on the icon for the device and choose
Disconnect. To disconnect all connections, click Connections > Close all connections.
Device icon(s).
Note: The devices’ device descriptor (DD) files provide the device icons.
Consequently, depending upon the type of HART or WirelessHART device,
you may see different device icons.
Communication Setup 37
Field Tools Quick Start Guide
D301703X412
November 2023
Icon Description
Expand branch. Click this to expand the branch of the tree.
Hide branch. Click this to hide the portion of the tree underneath.
Apply Pin. Click to display only the portion of the tree below the cursor’s
current position. This is useful if you have a large tree with many items and
you want to see only a portion of the tree.
Remove Pin. Click to turn off the Apply Pin option and display the entire tree.
2. Specify a name for the file. Its extension must be ZCF (for zipped connection file).
If one or more of the connections include DNP3 security keys for communication with DNP3
SAv5 enabled FB1000/FB2000/FB3000 devices, Field Tools asks whether you want export the
keys. If you choose No, skip to step 5. If you choose Yes, proceed to step 3.
3. To export DNP3 security keys, you must assign a password to the file. Enter it in the
Password and Verify fields and click OK.
38 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
4. Field Tools exports the file. Click OK. You can import this file on other Field Tools PCs
to bring in the connections.
2. Navigate to the file that contains the connection information and click Open.
3. If the connection file includes secure authentication keys, Field Tools prompts you to
confirm whether you want to import the keys. If you click Yes, you must provide the
password for the connection file. If you choose No, skip to step 5.
5. If there are duplicate connection names, Field Tools prompts you to confirm that you want to
replace the the connection details for connections that already exist.
Communication Setup 39
Field Tools Quick Start Guide
D301703X412
November 2023
1. Click Connections > Import > Connections from ROCLINK. The Import ROCLINK
connections dialog box opens.
2. In the Import ROCLINK Connections dialog box, choose the site name which contains
the ROCLINK connections you want to import.
3. If you want to overwrite existing ROCLINK connections, select the Overwrite Existing
Connections Data option.
3.12 Settings
Click Settings in the menu bar to open the Settings dialog box. The Settings dialog box
lets you pre-configure certain items for FBxConnect or Field Tools.
40 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
General
If you want to see firmware revision warnings when you connect to an FB1000/FB2000
Flow computer or FB3000 RTU, ensure the Show “Device has older firmware” and
“Show Ðevice has newer firmware” check boxes are selected.
If you want the system to prompt operators whether to override the time zone of an FBx
device when a time synchronization message comes in, select the Show “Override device
time zone” dialog box before synchronizing time of an FBx device.
Select Show “SHA256 and MD5 hash values” when importing an application if you
want to compare those values with the original published values for the application
available on SupportNet. If the hash values displayed on import do not match the hash
values on SupportNet, you know the application has been modified from its original
released version. This could indicate malicious or unauthorized modifications to the code.
Select Show “SHA256 and MD5 hash values” when updating firmware if you want to
compare those values with the original published values for the firmware available on
SupportNet. If the hash values displayed when updating firmware do not match the hash
values on SupportNet, you know the firmware has been modified from its original
released version. This could indicate malicious or unauthorized modifications to the code.
Communication Setup 41
Field Tools Quick Start Guide
D301703X412
November 2023
Click Show “Cached Solution Selector” dialog box if you want to specify the cached
solution file used for this connection.
For a ROC or FloBoss device, see the ROCLINK online help for more information.
2. Specify a name for the solution file (*.zsl) and click Save.
42 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
3. Select the correct Device type for your flow computer, and then select the correct
configuration characteristics for sensor types, ranges, and so on. Finally, click Open.
Communication Setup 43
Field Tools Quick Start Guide
D301703X412
November 2023
4. You can now optionally configure various features through the FBxConnect toolbar. (See
D301850X012 - FBxConnect Configuration Software User Manual for the FB1000-FB2000 Series for
details on configuring features in FBxConnect.) You can specify an associated Site for the flow
computer. If you created a custom FBxVue display for the flow computer which you would like
to appear when starting an FBxConnect connection instead of the default, specify it in the
Home screen field. Optionally you can go back to change the characteristics by clicking Edit
Model Spec.
5. When you are finished with all entries, click Save to save your offline solution file. At a later
time, you can download the solution file to the flow computer.
44 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
2. Specify a name for the solution file (*.zsl) and click Save.
Communication Setup 45
Field Tools Quick Start Guide
D301703X412
November 2023
3. First, select the Device type. If this is an FB3000 RTU with the 3CPU16 CPU installed,
choose FB3000. If this is an FBxRemote I/O rack with the 3IOCPU installed, choose
FBRIO.
4. Depending upon whether or not your FB3000 includes one or more extension chassis,
choose the appropriate number of chassis in the Select Chassis size field. You can
then select the type of module in each slot using the Module Type selection box.
Finally, click Open. Note: Slot 1 is always reserved for the CPU module so you cannot
make selections for that Module Location.
5. You can now optionally configure various features through the FBxConnect toolbar.
(See D301882X012 - FBxConnect Configuration Software User Manual for the FB3000 for
details on configuring features in FBxConnect.) You can specify an associated Site for
the RTU. If you created a custom FBxVue display for the RTU which you would like to
appear when starting an FBxConnect connection instead of the default, specify it in
the Home screen field.
46 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
When you are finished with any entries, click Save to save your offline solution file. At
a later time, you can download the solution file to the FB3000.
2. Select the solution file (*.zsl) and click Open. You can now edit the solution as desired.
1. Click Configurations/Solutions > Open > FBx > Flow Computer Configuration.
Communication Setup 47
Field Tools Quick Start Guide
D301703X412
November 2023
3. Field Tools prompts you to convert the XML file to a solution file.
You can optionally specify that you want Field Tools to delete the original XML after
conversion by clicking Delete original configuration file after conversion. If you
don’t select that, the original file remains unchanged after the conversion.
48 Communication Setup
Field Tools Quick Start Guide
D301703X412
November 2023
Chapter 4. FBxNet™
A subscriber device in the network must be an Emerson FB3000 RTU with a firmware
revision that supports FBxNet.
Publisher devices in the network can be any mixture of Emerson FB3000 RTUs, Emerson
FB1200 Flow Computers, or Emerson FB2200 Flow Computers with firmware revisions
which support FBxNet.
FBxNet transfers data between the subscriber and its publishers according to parameter
definitions. Each parameter definition specifies a correspondence between a tag in the
publisher and a tag in the subscriber. These two tags exchange data using FBxNet.
The graphic, below, shows a peer-to-peer network with a single subscriber (A) and three
publishers (B, C, and D).
Note
If you install Field Tools on a server, you should purchase a Multi-User Server license so
multiple users can log in from remote PCs and use FBxNet.
FBxNet 49
Field Tools Quick Start Guide
D301703X412
November 2023
Note
If launching the Licensing Manager through a newer browser such as Edge, you must run
the browser in IE mode.
1. Within Field Tools, click Help > Licensing > License FBx Products.
3. The License Manager prompts you to save the LRF file. (Make sure you make note of
where you save it, before you click Save because you will need it later.
50 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
5. On the registration page, enter your License Id and Password and click Sign-On.
FBxNet 51
Field Tools Quick Start Guide
D301703X412
November 2023
7. Now enter your contact information, email, and other details in the upper part of the
page and use the scroll bar to reach the lower fields. Then click Browse to select the
license request file (LRF) you saved in Step 2 and click Next.
Figure 4-6. Entering Contract Details and Selecting the LRF File
8. From the Unlock Software Licenses page, click Unlock for the item you want to
unlock, then click Submit License Request.
52 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
9. A page opens with a Key file link from which you can download your key file. The
website also sends a copy of the key file to the email address you specified with your
contact information.
Important
If you use Microsoft® Internet Explorer 9, it automatically saves your key file with
a .TXT extension. License Manager handles the .TXT extension; do not change the
extension or the file may become unusable.
If you right-click on the Key File link and select the Save Target as context menu
item, the key file is saved with an .XML extension.
10. To apply the license, click Include Key in the License Manager (see Figure 4-3). Browse
to the location of your key file and click Open to apply the key file. FBxNet is now
licensed. You’re done!
FBxNet 53
Field Tools Quick Start Guide
D301703X412
November 2023
1. In FBxConnect, click Configure > FBxNet and use the FBxNet display to configure one
or more Ethernet ports on your FB3000 Subscriber device to use FBxNet. (See the
FBxConnect online help for details). If you do not see the FBxNet option, it means
FBxNet is not licensed for that device. (See Licensing FBxNet.)
2. Each device in your FBxNet network must have an identical user with the same login
credentials. In FBxConnect, click Services > User Management.
Specify a Username and Password combination. All FBxNet users you define on
your network must share this same username/password combination.
Specify the Role for the user; Admin provides the most access; Auditor provides
the least access.
54 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
5. Click OK to save your changes, and OK to exit the User Management screen.
7. Create one or more sites and specify an RTU to hold CSV files for the site. (Sites are
just a way to organize subscribers.) (See Creating a Site.)
8. Specify one or more subscribers for each site. The subscriber is an FB3000. (See
Creating a Subscriber Directly in FBxNet.)
9. Specify one or more publishers for each subscriber. A publisher is an FB1200, FB2200,
or FB3000. (See Adding a Publisher.)
10. Specify parameters which define which data should be transferred between the
publisher(s) and the subscriber. (See Adding a New Parameter.)
11. Download the CSV file to the subscriber device. (See Downloading CSV Files.)
FBxNet 55
Field Tools Quick Start Guide
D301703X412
November 2023
Important
If the FBxNet item is not visible in the menu bar of Field Tools, it means you have not
licensed FBxNet on this PC. See Licensing FBxNet.
3. FBxNet opens and reads the subscriber CSV file(s) and based on them, creates a list of
the subscribers, and generates a graphical network tree for the selected subscriber
and its associated publishers. FBxNet displays the lines connecting the publishers in
colors to differentiate between the communication ports used.
1 Menu Bar
2 Subscriber List (the subscriber icon includes a green dot if the connection is
active)
3 Network Pane (use mouse wheel to zoom in/zoom out)
4 Status Pane
5 Mode Indicator (Monitor or Configuration)
6 Messages
7 Name of current CSV file
56 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
4. In the FBxNet Subscriber List, click the name of the subscriber you want to view; the
Network pane updates with a graphical tree for that subscriber and its publishers.
Monitor Mode lets you view data and parameters for each subscriber and publisher.
You can also change FBxNet subscriber configuration parameters. To open Monitor
Mode, click Mode > Monitor.
Configuration Mode lets you edit/change publisher and subscriber tag names for a
particular subscriber. To open Configuration Mode, click Mode > Configuration.
FBxNet 57
Field Tools Quick Start Guide
D301703X412
November 2023
2. Now enter the name of the site in Site Name. The Setup designated device section
defines a device where FBxNet stores CSV files for the subscribers associated with this
site. This provides other PCs a place to locate FBxNet configuration details for the site.
Check the Specify a designated device... box, and enter the Designated device's IP
Address.
3. Click Save. The Subscriber List pane updates to show the newly defined Site Name.
58 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
4. FBxNet then prompts you to decide whether it should upload CSV files from the
device to your PC.
5. If you answer Yes FBxNet connects with the designated device and then notifies you if
the version of CSV files on the designated device is newer, older, or the same as those
on your PC. You can decide what you want to do. Typically, you would want to upload
is the CSV files on the designated device are newer than the CSV files on the PC.
FBxNet 59
Field Tools Quick Start Guide
D301703X412
November 2023
In Configure Mode, click on the site name in the Subscriber List pane, then click the delete
icon.
60 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
1. In Configure Mode, click in the Subscriber List pane on the site in which you want to
add a subscriber, then click the Add Subscriber icon.
3. You can add publishers for this subscriber. (See Adding a Publisher.)
4. You can add publisher parameters and specify associated subscriber parameters for
data exchange through FBxNet. (See Adding a New Parameter.)
5. Click Save To File to save your edits to the subscriber CSV file and FBxNet adds the
name to the subscriber list.
FBxNet 61
Field Tools Quick Start Guide
D301703X412
November 2023
In Configure Mode, click on the subscriber in the Subscriber List pane, then click the
delete icon. You will be prompted to confirm the deletion.
2. Enter the Name of the publisher, its device Type (FB3000, FB1200, or FB2200), its IP
Address, IP Port (default is 20000), Subscriber Comm Port (5 or 6), and check Polling
Enabled to allow communication to occur.
3. When you finish with all your edits on this page, click Save To File to update the CSV
file.
62 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
After entering Configure Mode, selecting a subscriber, and clicking you can delete a
publisher device from this subscriber:
1. In the Publisher’s Configuration pane, use the scroll bar (if necessary) to locate the
publisher you want to delete, and click on the line for it.
2. Click Delete Publisher. This deletes the publisher from the grid and from the CSV file.
1. In the Publisher’s Configuration pane, use the scroll bar (if necessary) to select the
publisher for which you want to edit parameters, and click on its line.
2. In the Publisher Parameters Configuration pane you can see the existing parameters
for this publisher. Use the scroll bar (if necessary) to locate the line below where you
want to add the parameter and click on that line.
3. Click Add Parameter to add an empty line into which you can define the new
parameter.
4. Launch the Tag Browser. For more information on using the Tag Browser, see
Working with the Tag Browser.
5. Select the attribute whose tag you want as a Subscriber Tag, then click Copy Tag.
FBxNet 63
Field Tools Quick Start Guide
D301703X412
November 2023
6. Go to the Subscriber Tag field in the empty line in the Publisher Parameters
Configuration pane, right-click and choose Paste to paste in the tag. Repeat steps 5
and 6 to specify the Publisher Tag.
8. When you finish with all your edits on this page, click Save To File to update the CSV
file.
Note
Instead of Copy Tag in Step 5, and Paste in Step 6, you can drag the attribute from the
Tag Browser attribute pane into the desired Subscriber Tag or Publisher Tag field.
1. In the Publisher’s Configuration pane, use the scroll bar (if necessary) to select the
publisher for which you want to edit parameters, and click on its line.
Click on the Publisher or Subscriber tag you want to edit, and proceed to edit the
names as desired; press the [Enter] key when you’re satisfied with your change.
Copy a tag name by clicking once on a tag and right clicking and selecting Copy;
then you can click on a different field, right click and choose Paste.
64 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
Drag or paste in a tag name from the FBx Tag Browser. See Working with the Tag
Browser for details.
4. When you finish with all your edits on this page, click Save To File to update the CSV
file.
Note
If you make a mistake in your edits, you can undo them by clicking Cancel Edits. Once
you have saved the file, however, you cannot undo your changes.
After entering Configure Mode, selecting a subscriber, and clicking you can delete a
parameter from this subscriber:
1. In the Publishers Configuration pane, use the scroll bar (if necessary) to locate the
parameter you want to delete, and click on the line for it.
2. Click Delete Parameter. This deletes that line from the grid and from the CSV file.
Note
If you make a mistake in your edits, you can undo them by clicking Cancel Edits. Once
you have saved the file, however, you cannot undo your changes.
When you first create a site and specify a designated device to hold CSV files, FBxNet
prompts you to synchronize files and if you agree, checks to see if CSV files on the
designated device are newer, older, or the same as those on your PC. FBxNet also
prompts you for this check when you click on a site name for the first time or expand the
tree for a site the first time.
FBxNet 65
Field Tools Quick Start Guide
D301703X412
November 2023
If you answer Yes FBxNet connects to the designated device and checks the CSV file
versions and notifies you whether the CSV files on the designated device are newer, older
or the same as CSV files on your PC. You can then choose whether or not you want to
proceed with the upload. Typically, you would want to answer Yes to upload if the files on
the designated device are newer than the ones on your PC.
Create one or more subscribers for each site. You can create subscribers directly in
FBxNet as described in Creating a Subscriber Directly in FBxNet.
Alternatively, you can create a CSV file manually in a text editor or Microsoft® Excel If you
have multiple subscriber devices, you must create a separate CSV file for each one. For
example, if you have three subscribers, you must create three CSV files – one for each
subscriber.
If you have many subscribers or many publishers, you may want to create your first
subscriber or publisher directly in FBxNet, and then manually edit the resulting CSV file to
add additional publishers, or copy the CSV file and use it as a basis for defining another
subscriber and set of associated publishers.
66 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
The first line, which is bolded, provides a guide to the meaning of entries on the second
line. The second line entries define the subscriber device.
The third line and fourth line (both bolded) provide a guide to the meaning of entries for
the subscriber devices, defined on subsequent lines.
From line five to the end of the file are definitions of individual publisher devices, and
their associated parameters. Lines that describe the actual tags begin with a comma “,”.
SubscriberName,SubscriberIPAddress,SubscriberIPPort
SubscriberDeviceName, SubscriberIPAddress,SubscriberIPPort
PublisherName,PublisherType,PublisherIPAddress,PublisherIPPort,SubscriberCommPort,Enabled
,SubscriberTag,Operation,PublisherTag,FaultMode,FixedFaultValue,FBxNDataInstance
PublisherName:PublisherDeviceName1,PublisherType1,PublisherIPAddress1,PublisherIPPort1, CommPortNumber1,
EnableFlag1
,SubscriberTag1, Operation1, PublisherTag1,FaultMode1,FixedFaultValue1,FBxNDataInstance1
,SubscriberTag2, Operation2, PublisherTag2,FaultMode2,FixedFaultValue2,FBxNDataInstance2
: :
,SubscriberTagx, Operationx, PublisherTagx,FaultModex,FixedFaultValuex,FBxNDataInstancex
PublisherName:PublisherDeviceName2,PublisherType2,PublisherIPAddress2,PublisherIPPort2, CommPortNumber2
EnableFlag2
,SubscriberTag1,Operation1,PublisherTag1,FaultMode1,FixedFaultValue1,FBxNDataInstance1
,SubscriberTag2,Operation2,PublisherTag2,FaultMode2,FixedFaultValue2,FBxNDataInstance2
: :
,SubscriberTagy,Operationy,PublisherTagy,FaultModey,FixedFaultValuey,FBxNDataInstancey
: :
PublisherName:PublisherDeviceNamew,PublisherTypew, PublisherIPAddressw, PublisherIPPortw, CommPortNumberw
EnableFlagw
,SubscriberTag1,Operation1,PublisherTag1,FaultMode1,FixedFaultValue1,FBxNDataInstance1
,SubscriberTag2,Operation2,PublisherTag2,FaultMode2,FixedFaultValue2,FBxNDataInstance2
: :
,SubscriberTagz,Operationz,PublisherTagz,FaultModez,FixedFaultValuez,FBxNDataInstancez
Where:
FBxNet 67
Field Tools Quick Start Guide
D301703X412
November 2023
Parameterr Description
SubscriberIPAddress Is the IP address of the subscriber device. This is
the IP address used by Field Tools to connect to
the subscriber.
SubscriberIPPort Is the TCP/IP port number of the subscriber device.
If not specified, FBxNet uses a default of 20000.
Note: Do not enter 9009 for this number; it is
reserved by FBxNet.
PublisherName:Publisher Marks the beginning of a publisher (server) device
DeviceName definition. The keyword PublisherName: is
required followed by the name of the publisher.
Publisher names must be unique within the file;
FBxNet ignores any duplicate publisher names
PublisherType Specifies the type of device. Valid values are
FB1200, FB2200, and FB3000. If not specified,
FBxNet assumes a default of FB3000.
PublisherIPAddress Is the IP address of this publisher device.
PublisherIPPort Is the TCP/IP port number of this publisher device.
If not specified, FBxNet assumes a default of
20000. (RESERVED FOR FUTURE USE)
CommPortNumber Is the subscriber communication port number.
This is either 5 or 6.
EnableFlag Is set TRUE to turn on polling for this publisher
device, or FALSE to turn off polling for this
publisher device.
,SubscriberTag Specifies the name of a database parameter in the
subscriber device for which you want to transfer its
value via peer-to-peer communication.
Operation is set to READ if the subscriber should read from
this publisher or WRITE if the subscriber should
write to this publisher.
PublisherTag Specifies the name of a database parameter in the
publisher device whose value the subscriber wants
to read from or write to.
FaultMode (This field is Optional, but if you include it you must
also include the related FixedFaultValue and
FBxNDataInstance fields) – Specify how FBxNet
handles a communication failure or other error
from this publisher. Choices are:
LIVE Disables fault handling.
68 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
Parameterr Description
Switch to a pre-defined value, as
FAULT specified in the FixedFaultValue
field.
LAST_GOOD Show the last good value received.
FixedFaultValue (This field is Optional, but if you include it you must
also include the related FaultMode and
FBxNDataInstance fields.) When Fault Mode is set to
FAULT, specifies an override value to be used when
a communication error or other fault occurs.
FBxNDataInstance (This field is Optional, but if you include it you must
also include the related FaultMode and
FixedFaultValue fields.) This field specifies the name
of a fault handling database object and registers it
in the FB3000 database. You can specify any
unused FBxNDataInstance object number; they
follow the format:
//FBXNData_x//
Where x is any integer between 1 and 10000. Once
registered in the FB3000 database to belong to a
particular publisher tag, this object instance stores
any data quality or parameter “health” code
received about a fault. This data can then be
logged and may be viewed in the FBxConnect
diagnostic report.
FBxNet 69
Field Tools Quick Start Guide
D301703X412
November 2023
Although not required, the base name of the file should be the name of the subscriber
device and when you save the file, you must save it as type CSV (Comma separated
variable) (*.csv) so that the required commas are included in the file.
Typically, a subscriber file could refer to dozens of devices, but the simple example below,
shows a subscriber named MYFB3000 with three publishers named MyPublisher1,
MyPublisher2, and MyPublisher3. Each of the publishers have three data points to be
transferred, and they all use the default IP port of 20000, so that field can be left blank,
delimited by commas.
SubscriberName,SubscriberIPAddress,SubscriberIPPort
MyFB3000,10.208.15.82,20000
PublisherName,PublisherType,PublisherIPAddress,PublisherIPPort,SubscriberCommPort,Enab
led
,SubscriberTag,Operation,PublisherTag
PublisherName:MyPublisher1,FB1200,10.208.15.83,,5,TRUE
,User Data_5.FLOAT_1,READ,User Data_5.FLOAT_1
,User Data_2.LONG_7,WRITE,User User Data_1.LONG_1
,User Data_1.SHORT_1,READ,User Data_1.SHORT_1
PublisherName:MyPublisher2,FB1200,10.208.15.84,,5,TRUE
,User Data_5.FLOAT_1,READ,User Data_5.FLOAT_1
,User Data_2.LONG_7,WRITE,User User Data_1.LONG_1
,User Data_1.SHORT_1,READ,User Data_1.SHORT_1
70 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
PublisherName:MyPublisher3,FB2200,10.208.15.85,,5,FALSE
,User Data_5.FLOAT_1,READ,User Data_5.FLOAT_1
,User Data_2.LONG_7,WRITE,User User Data_1.LONG_1
,User Data_1.SHORT_1,READ,User Data_1.SHORT_1
Other than the CSV extension (which is required), the name of the subscriber file is
irrelevant but for good practices it should be the name of the subscriber device (for
example MyFB3000.csv ).
If there are errors in subscriber data, FBxNet ignores that subscriber file.
If there are errors in publisher data, FBxNet ignores that publisher section.
If there are errors in the peer-to-peer data for a parameter, FBxNet ignores that
parameter.
If FBxNet can apply a default in order to continue it will. For example, if the file
specifies an invalid operation, FBxNet applies a default of READ.
If FBxNet detects errors as it loads CSV files, it creates a log file of those errors and
reports this message:
You should open the log file and try to correct the errors, and then re-download the files
and restart FBxNet so it loads the corrected files.
FBxNet 71
Field Tools Quick Start Guide
D301703X412
November 2023
2. The Download files to Subscribers screen shows a list of subscriber devices, showing
the Site, Device name and IP Address of each FB3000 subscriber device.
Note
You will only see FB3000 devices in the list because only an FB3000 can serve as a
subscriber
3. By default, the screen shows subscribers for all sites. To only download the
subscribers for a specific site, select the desired site from the Site selection box.
4. To download CSV files for all subscribers, select the Download check box. If you only
want to download CSV files to certain subscribers, de-select the Download check box,
and then check the boxes for only those subscribers to which you want to download
CSV files.
72 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
5. To start polling all subscribers automatically after the download completes, select the
Start Poll Cycle checkbox. If you do not want polling for all subscribers to occur, de-
select that and only check those devices for which you want polling to occur.
6. Click the Download button. FBxNet downloads CSV files to the selected subscriber(s)
and starts polling for any that have Start Poll Cycle selected. The Status field shows
any error messages that occur during the download for particular subscribers.
This opens the Download files to subscribers dialog box for that subscriber only. Click
Download to proceed.
FBxNet 73
Field Tools Quick Start Guide
D301703X412
November 2023
FBxNet validates the new CSV files and loads them into memory.
If, for some reason, you accidentally overwrite the CSV file for a site, you can restore the
previous version from that site's FBxNetFilesBackup.ZIP file.
1. Close FBxNet.
\Users\Public\Public
Documents\Emerson\FieldTools\FBx\FBxNet\sitefolder\FBxNetBackupFolder
74 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
\Users\Public\Public Documents\Emerson\FieldTools\FBx\FBxNet\sitefolder\
4. Unzip the FBxNetFilesBackup.ZIP file, then copy the unzipped CSV files to:
\Users\Public\Public Documents\Emerson\FieldTools\FBx\FBxNet\sitefolder\
5. Restart FBxNet.
2. In the Network pane, click on the subscriber device (the top node in the tree) to open
the Subscriber Status tab.
Field Description
Subscriber The name of the subscriber device.
IP Address The IP address of the subscriber device.
Status The status of the connection between FBxNet and the
subscriber device.
Last time values were The timestamp showing when status fields were last
refreshed updated.
Parameter This column shows the name of the database tag(s) in the
subscriber device that provide status information.
Description This column provides a textual description of the
parameter to provide greater detail than the parameter
name.
Value This column shows the value of the database tag.
Units This column shows engineering units for the value, if
appropriate.
FBxNet 75
Field Tools Quick Start Guide
D301703X412
November 2023
Field Description
Available Data Points Shows a list of the communication ports connected to this
subscriber, and the number of data points on each port
that FBxNet could potentially collect.
Field Description
Subscriber, IP Address, See Section 4.17.
Status, Last time values
were refreshed
Publisher Device This column shows names of the publisher (server)
devices.
IP Address This column shows IP addresses of the publisher devices.
Comm Port This column shows the communication port numbers used
by the publisher devices. This is either 5 or 6.
Rows Loaded This column shows the number of parameter mapping file
rows that were successfully parsed from the publisher
device. For example, if you have 5 parameters you are
transferring between a publisher and the subscriber, this
number should be 5. If Rows Loaded is less than the
number of parameters you are transferring, this indicates
FBxNet could not parse one or more of the parameter
lines in your CSV file, and you should check the file for
errors.
Connection Status This column shows the current connection status of the
publisher device. Possible status messages include:
76 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
Field Description
Not Started FBxNet not setup for the device (no
parameter mapping file for the
publisher) or polling not started.
Connecting The subscriber is attempting to
establish a TCP connection to the
publisher.
Resolving The subscriber is resolving all the
tags to be read/written as well as the
fault handling instructions.
Online System is communicating with no
issues found.
Offline Publisher is disabled in the device
connection file.
Invalid Publisher’s parameter mapping file is
invalid, or the response received
from the publisher is invalid. This is a
critical error - the system will attempt
to recover.
Connection Subscriber could not connect to the
Timeout publisher. TCP connection request
failed.
Transmission Subscriber could not send message
Error to the publisher. Transmission of the
data failed.
Response Timeout No response received. Subscriber
timed out waiting for response from
the publisher.
Resolving Failure Critical error occurred while resolving
the parameter map.
Read Failure Critical error occurred while reading
the parameters from the publisher.
Disabled Device is disabled.
Online with System transferring data but there
Parameter Error(s) are errors - see subscriber diagnostic
file for details.
No Account Found There is no FBxNet user account on
the subscriber.
Authentication There is a mismatch between the
Failed FBxNet user accounts (username and
password) on the subscriber and the
publisher. If this happens, you must
FBxNet 77
Field Tools Quick Start Guide
D301703X412
November 2023
Field Description
stop communications between the
subscriber and publisher, use
FBxConnect to modify the FBxnet
user account usernames and/or
passwords in the subscriber and
publisher so they are identical in both
devices, and then restart
communications.
Note: If the user account is locked
out you must either wait for the lock
out to expire, or a security
administrator must temporarily
disable the lockout in FBxConnect,
then re-enable it when you finish.
Authenticating The subscriber is attempting
authentication with the publisher.
Parse Status This column shows the current parsing status of the
publisher device’s parameter mapping file. Possible status
messages include:
No Error Parse was successful.
File Open Fail Could not find or open the publisher
map file.
Column Mismatch Column of the map file is invalid.
Missing Required Missing required column header in
Column the map file.
Exceeded Max Map file number parameters exceed
Data Points the maximum allowed.
Error Count This shows the total number of errors for connections to
each publisher. You can zero-out this number by clicking
Reset Error Count.
78 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
Field Description
Publisher This shows the name of the selected publisher device.
IP Address This shows the IP address of the publisher device.
Comm Port This column shows the communication port number used
by the publisher device. This is either 5 or 6.
Status Shows the status of the connection to this publisher.
Last time values were Shows the last time the values were updated in the Status
refreshed pane. Click Refresh to force an update.
Subscriber Tag This column shows the names of database parameters in
the subscriber device for which you want to transfer values
using peer-to-peer communication. The heading for the
column shows the subscriber device name.
Subscriber Value This column shows the value of the subscriber parameter.
Subscriber Status In this column, if FBxNet could not collect the value, it
shows an error code. The most typical error is “Tag name
is not valid. Error code:1307” which occurs when a
parameter does not exist.
Operation This column shows READ if the subscriber should read
from this publisher or WRITE if the subscriber should write
to this publisher.
Publisher Tag This column specifies the names of database parameters
in the publisher whose values the subscriber wants to read
from or write to. The heading for the column shows the
publisher’s device name.
Click Refresh to update the Status pane with the latest values from the publisher
FBxNet 79
Field Tools Quick Start Guide
D301703X412
November 2023
The Subscriber Configuration tab updates to show configuration parameters for each
port on the subscriber device. The Parameter names begin with the name FBxNConfig_x
where x is the port number. The Description field provides a textual description for the
parameter and the Value field shows the current value of the parameter. The Limits field
shows the range of valid values for that parameter.
You can select a Parameter and then enter its new value in the New Value field. The
Units field shows the engineering units (if applicable). To finish and write the new value(s)
to the subscriber, click Save.
Parameter Description
TCP_CONN_TIMEOUT The number of seconds the subscriber waits for a
response from a connection request before a timeout
occurs.
RX_TIMEOUT The number of seconds the subscriber waits for a
response from the publisher after the connection has been
established.
RETRIES_NUM The number of retry attempts when a timeout occurs.
SCAN_RATE The frequency at which the subscriber polls its publishers.
POLL_CYCLE Enables/disables polling for this port.
80 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
configured fixed fault value. Fault processing also captures any error code generated
from the fault, allowing it to be logged in the FBxConnect Diagnostic Report.
Important
For I/O points, built-in hardware fault handling and user-configured fault handling in
FBxConnect supersedes FBxNet fault processing because the hardware/firmware fault
handling is more feature-rich
Once enabled, FBxNet adds three additional columns to the Publisher Parameters
Configuration screen. You must configure all three for fault processing to work.
Note
If after you configure the fault handling columns you de-select Enable Fault Handling,
FBxNet deletes those columns and the entries you made from the configuration and your
CSV file.
Column Description
FaultMode Use the selection box to specify how FBxNet handles a
communication failure or other error from this publisher.
Choices are:
LIVE Disables fault handling.
FAULT Switch to a pre-defined value, as specified
in the FixedFaultValue field.
LAST_GOOD Show the last good value received.
FixedFaultValue When Fault Mode is set to FAULT, specifies an override
value to be used when a communication error or other
fault occurs.
FBxNDataInstance This field specifies the name of a fault handling database
object and registers it in the FB3000 database. You can
FBxNet 81
Field Tools Quick Start Guide
D301703X412
November 2023
Column Description
specify any unused FBxNDataInstance object number;
they follow the format:
//FBXNData_x//
where x is any integer between 1 and 10000. Once
registered in the FB3000 database to belong to a particular
publisher tag, this object instance stores any data quality
or parameter “health” code received about a fault. This
data can then be logged and may be viewed in the
FBxConnect diagnostic report.
Did you put your CSV files in the correct folder? They must be in \Users\Public\Public
Documents\Emerson\FieldTools\FBx\FbxNet\
If you edited your CSV file(s) in Excel, did you remember to save them in the CSV
format? They must be CSV files, not XLS files.
Check the Rows Loaded, Connection Status, and Parse Status entries on the Publisher
Status tab. This can help you identify where problems might exist.
82 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
1. Either click Open Tag Browser in the FBxNet menu bar, or click Tag Browser from
the link in Publisher Parameters Configuration pane; either one opens the Tag
Browser.
2. In the Tag Browser, select the Device name of the RTU or flow computer from which
you want to view tags; once you make your selection, the Tag Browser populates the
Target Object pane.
Each database object shown in the Target Object pane corresponds to a particular
feature or component that you configure in FBxConnect. For example, if you install a
mixed I/O module in the device, there will be a database object for each type of input
or output you configure in FBxConnect.
So, for an I/O module that has two (2) digital outputs, there will be two instances (or
copies) of the digital output (DO) object – one for each DO.
FBxNet 83
Field Tools Quick Start Guide
D301703X412
November 2023
3. Select the desired Target Object instance. Once you click on it, the rightmost pane
updates with the attributes for that object instance.
Each object typically also has one or more attributes. For example, for an analog input
(AI), you could choose the raw value from the I/O point, the live value scaled for the
applied engineering units, the tag name, or many other things.
84 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
4. Click the attribute of interest. Tag Browser updates the Tag, Data Type, Value, and
1131 Data Type (if applicable) for the selected tag.
5. You can click Copy Tag to store the tag name associated with that attribute in the
clipboard, and then right click and Paste it into any field that accepts a publisher or
subscriber tag.
Or you can drag the name of the attribute from the attribute pane and release your
cursor in the field where you want it; FBxNet pastes in the associated tag name.
FBxNet 85
Field Tools Quick Start Guide
D301703X412
November 2023
86 FBxNet
Field Tools Quick Start Guide
D301703X412
November 2023
This chapter covers the Device Security Management tool in Field Tools.
FB1100, FB1200, FB2100, and FB2200 flow computers with firmware 2.13 or newer.
Device Security Management’s Credential Manager tab (if present) works with:
FB3000 RTU
ROC and FloBoss devices that support either the legacy username/password scheme
using PT 57 Parameter 0 (3-character user id) and Parameter 4 (4-character
password), or the enhanced username/password scheme with longer usernames and
passwords. Contact Technical Support for exact firmware revisions for the legacy
scheme.
To implement SAV5, both the devices and the SCADA system must support SAV5.
When the message arrives the protocol performs an operation on the message using a
DNP3 security key - that must be known at both the source and destination - to tell that
the message is valid .
1. Create DNP3 security keys for FB1000/2000 Series Flow Computers and the FB3000
RTU that communicate via DNP3 protocol using SAV5. (See Section 5.3.1).
2. Save the keys for those RTUs with their associated Field Tools connections. (See
Section 5.3.3).
3. Create a security target file (*.STF) for each RTU containing its DNP3 security key. (See
Section 5.3.4).
1. On the DNP3 Security Keys tab, click in the Key column for a particular device (or
site).
2. Click Generate Random Key. Device Security Management generates a DNP3 key in
the Key column.
3. By default, the screen hides the Key entry, but you can click on it to view the actual
key in plain text:
4. You can optionally enter descriptive text in the Notes field such as an asset tag
number. Do not copy the key text into this field.
In Device Security Management, click: Transfer > Transfer DNP3 Keys to FieldTools
1. In Device Security Management, click Transfer > Create Security File for Target
Device. This opens the Device Security File dialog box.
2. In the Device Security File dialog box, use the Select Device field to choose the device
for which you want to create a target file. You can choose from any device present in
the Field Tools tree.
Figure 5-6. Choosing the Device for which you want to create a target file
3. Click OK.
4. By default, the security target file name matches the device name. Although you can
optionally change it, we recommend you keep the matching name to avoid confusion
among multiple STF files. Navigate to the location where you want to save the STF file
and click Save.
5. Device Security Management prompts you to supply a password for the STF file. Enter
it in both the Target File Password and Verify file password fields and click OK.
6. Click OK when the message box confirms creation of the STF file.
7. Repeat this process for each and every RTU that requires DNP3 security keys.
DANGER
EXPLOSION HAZARD - MAY CAUSE DEATH
1. Connect a cable between your Field Tools laptop and the device:
For an FB3000 RTU, connect a USB cable between the laptop and the USB port on
the CPU module.
For an FB1000 or FB2000 Series Flow Computer, connect a serial cable (or USB to
serial converter cable) between the laptop and COM1 on the flow computer.
FB3000 RTU:
Set the Baud rate and Link timeout as shown in Figure 5-10.
If you know which COM port on your laptop is the USB port, select it in the Comm
port field; if you do not know which port is the USB port, choose Auto, and Field
Tools will cycle through the ports to find the USB port when it connects.
Set the Baud rate and Link timeout as shown in Figure 5-11.
4. Click Connect. Field Tools initiates the connection with the device and launches
FBxConnect.
6. In the Apply Security File dialog box, click Browse to locate the STF file for the device.
7. Enter the Target File Password for your STF file and click OK.
8. Click Apply. FBxConnect now loads the STF file containing the DNP3 security key into
the device. You should see the message “Device has been updated with the Security
Key.”
Important
We recommend you do not leave Field Tools and Device Security Management
running on a computer that is unattended. If you need to step away from the
computer, you should save your work and shut down Field Tools and restart it when
you return. This is to prevent an unauthorized user from modifying the security
master file. This is similar to closing your browser after an online banking session.
Note
If you do not see the Credential Manager tab, it means you do not have the Credential
Manager license for Field Tools on this PC. Normally you will only have this license if you
have the role of Administrator.
Important
For an additional level of protection, we recommend you store security master files on an
encrypted disk. There are numerous encryption tools available to accomplish this such as
VeraCrypt, DiskCryptor, or GnuPG.
Only Administrators can change passwords; other roles (Engineer, Operator, etc.) cannot
change their own passwords.
1. Click Configuration > User roles and permissions to open the User roles and
permissions page.
2. For FB1000/FB2000 flow computers, the FB3000 RTU, or ROC/FloBoss devices with
enhanced security, select the FB Series tab and assign permissions for each role. For
ControlWave series RTUs, select the ControlWave tab and assign permissions for
each role.
1. Click Configuration > Password Checks to open the Password checks dialog box.
2. You can define the Minimum password length. Longer passwords are more secure.
The password length for FB1000, FB2000, and FB3000 devices, as well as ROC/FloBoss
devices using enhanced security can range from 8 to 32 characters. ControlWave
passwords can range from 8 to 16 characters; any additional characters are not read.
Some security certification organizations recommend you use at least 12 characters.
Passwords require 1 number means that passwords must include at least one
number from 0 to 9.
Passwords require 1 Upper case and 1 Lower case character means the
password must include at least one UPPER CASE and at least one lower case
character.
Passwords require 1 Special character means that the password must include at
least one of the following characters: ~!@#$%^*
Passwords cannot match last 10 entered for a user requires that the password
defined cannot match any of the last 10 passwords that were defined for this user.
4. When you complete your choices, click Set as Defaults to indicate that choices will be
used as defaults for future smf files you create.
5. Click Save to save your choices in the smf file and exit the dialog box, or Close or
Cancel to discard your selections and exit the dialog box.
Note
While you define passwords or pins for any device type, you can click see the plain text
while you type it in. At all other times, the text is blacked out.
1. On the Credential Management tab, click Add User to add a row which you can
configure.
2. Click on “new user” in the Username column, and type in the name for the user.
Usernames for FB1000/FB2000/FB3000 devices as well as ROC/FloBoss devices using
enhanced security can be up to 30 characters. Usernames for ControlWave devices
can be up to 16 characters; any additional characters are not read. Usernames cannot
include spaces.
3. Click in the Password column and enter the password this user will use when logging
into the RTU. Passwords for FB1000/FB2000/FB3000 as well as ROC/FloBoss devices
using enhanced security support up to 32 characters. Passwords for ControlWave
devices can be up to 16 characters; any additional characters are not read. If you
saved password rules as defaults in the Password checks dialog box (Section 5.4.3) the
tool enforces those rules in a later step when you save your entries.
4. Click in the Role column and use the drop down to select the desired role
(Administrator, Engineer, Measurement Tech, Operator, or Auditor). The permissions
associated with each role are configured in the User roles and permissions page
(Section 5.4.2).
Protocol – Click and use the dropdown to select the communication protocol used
for a local connection to the device. Choices include DNP, FBxNet, ROC, or BSAP
protocol. (This field also applies to FB3000 devices.)
Localization – Select the desired localization profile which sets the language used
in the HMI display. (Future)
Enable pin – Check this to require that someone using the HMI display on the
flow computer must enter a four digit pin.
Pin – Type the pin this user must enter when using the local HMI display.
6. For legacy ROC/FloBoss devices or newer ROC 800, FB107, DL8000 devices not yet
configured for enhanced security, ensure the Show legacy ROC/FloBoss settings box
is checked. Define credentials as follows:
Username – Usernames for these devices are three characters long. This column
displays the first three characters of the full username defined in Step 2. You
cannot change it without changing the full username.
Level – Select the level from the dropdown (0 to 5). The higher the number, the
greater the level of access allowed. Repeat these steps for each user you want to
create. When finished save the user information. Note: Changing the Role on the
FB Series tab changes this number, but you can change it back in this field.
3. Click Yes to confirm that you want to delete the user(s), or click No to keep the user(s).
Note
If an error window opens, it means the password rules selected earlier detected a
problem with the password associated with the listed username. Review the error
message(s), then close the error window and correct the passwords for those
usernames so it conforms to the chosen rules.
2. Navigate to the location on the PC where you want to store the security master file,
and specify a name for the file.
3. In the File password dialog box, specify a master password for the security master file
in the Master file password field, and then enter it again in the Verify file password
field.
Important
If you forget your master password, there is no way to retrieve the information in the
security master file.
5. When you save the file, you will see a confirmation message; click OK at the prompt.
Important
We recommend you do not leave Field Tools and credential manager running on a
computer that is unattended. If you need to step away from the computer, you should
save your work and shut down Field Tools and restart it when you return. This is to
prevent an unauthorized user from modifying the security master file. This is similar
to closing your browser after an online banking session.
2. Navigate to the location on your PC where you store security master files, click on the
filename, then click Open.
3. Enter the master file password for that file, and click OK. You can now view/edit the
file.
2. Navigate to the location on the PC where you want to store the new security master
file and specify a name for the file.
3. In the File password dialog box, specify a master password for the security master file
and repeat it in the verify field. If you need to edit the password after you type it, be
sure to highlight the entire field before you start typing.
5. When you save the file, you will see a confirmation message; click OK at the prompt.
1. Click File > Transfer to devices to open the Transfer users to devices page.
2. In Figure 5-21:
The Site/Device column shows all the connections, sites, and devices in your
current Field Tools configuration.
The Last Updated field shows the last time this RTU/flow computer received an
updated security master file.
6. Select the devices to which you want to send the security master file. If you click on a
site name, it automatically selects all the devices for that site. If you click on All
connections and sites, it automatically selects every device. If you see a device
selected that you do not want to update, un-check it.
7. If you want to delete users from devices if they are not defined in this security master
file, select Remove users from the device that are not in the file. Those user
accounts will be deleted from the devices.
8. When you finish making your selections, you can transmit the security master file to
the selected RTUs and flow computers. Click Transfer to send the file.
9. The Status field shows the status of the file transmission to each of the selected RTUs
and flow computers. You can click View Log File to see all status messages associated
with the file transmission. Timestamps of the last transfer and error messages
associated with the transfer are stored in the Field Tools database so they can be read
and displayed the next time you invoke the tool.
Important
We recommend you do not leave Field Tools and Device Security Management running on
a computer that is unattended. If you need to step away from the computer, you should
save your work and shut down Field Tools and restart it when you return. This is to
prevent an unauthorized user from modifying the security master file. This is similar to
closing your browser after an online banking session.
2. Double-click Services.
3. Right-click on the OpenEnterprise Session and choose Stop from the menu.
3. Expand the Ports (COM & LPT) selection to display a list of ports.
4. Right-click once on the port used for Field Tools communications and choose
Properties from the pop-up menu. The Communications Port (COM1) Properties
dialog box opens.
5. Select the Port Settings tab, then click Advanced to display the Advanced Port
Settings dialog box.
6. In the Advanced Port Settings dialog box, drag the Receive Buffer and Transmit Buffer
slide bars to the low end of their ranges, and click OK.
7. Choose OK in the Communication Port Properties dialog box, and exit the Device
Manager and Control Panel to save the settings.
BlackBox IC199A
IOGear® GUC232A
FDI’s CHIPI-X10
If you experience problems with a particular USB to serial converter, there are a few
things you can try:
Make sure you installed the correct up-to-date software driver for your USB to serial
converter. Sometimes a driver update can solve the problem.
If the connection failure occurs after you unplug and plug back in, close the
connections and unplug the USB from the PC. Then reconnect the USB and restart the
connection.
Some problems can occur from truncated messages. In Windows Device Manager, set
FIFO transmit and receive buffers for the port to low as described above in
Communication Problem Causing Truncated Messages. This may improve the USB
connection.
Connecting to a VPN shuts down certain Windows services that Field Tools uses.
(Because they share some common code, Field Tools makes use of an OpenEnterprise
service.) While some services can reconnect automatically, others may require you to
restart the OpenEnterprise service. If you need to do this, follow these steps:
To solve this, set display settings in Windows Control Panel to use smaller text sizes.
To do this, you need to edit the values for the BootTimeAfterConfigApply and
BootTimeAfterColdWarmStart parameters. These parameters specify the amount of time
(in minutes) FBxConnect waits after a device reboot before declaring a communications
timeout failure.
These parameters are located in the FieldToolsContainer.config file located in the folder:
\ProgramData\Emerson\OpenEnterprise\Application Data\
In the example shown below, FBxConnect waits 5 minutes after a configuration download
and waits 6 minutes after a cold or warm start before declaring a communication
timeout.
To prevent errors associated with this, you must disable (de-select) the System
cryptography: Use FIPS compliant algorithms for encryption, hashing, and signing
option for the Local Security Policy of your laptop/PC workstation.
3. Select Ports. Locate the CDC Serial Driver and right click on it, and choose Update
Driver.
5. From the next screen, choose Let me pick from a list of available drivers on my
computer.
6. From the list presented, choose Remote Automation Solutions as the Manufacturer
and QNX Serial Converter as the Model, then click Next and Windows reinstalls the
driver.
Change the CCListenPort value to 50000, the DriverBaseListenPort value to 50010, the
VPCListenPort value to 50001, the RasAdminTaskListenPort value to 50002, and the
DBBuildServer value to 50006.
To make the changes take effect, stop the OpenEnterprise Session, then re-start the
OpenEnterprise Session. For information on how to do this, see the first troubleshooting
tip in this appendix.
Note
If you subsequently reinstall Field Tools you must redo these changes.
2. Right click on Field Tools from the Uninstall or Change a program list.
4. Choose Remove and click Next. Wait for the uninstall process to complete (this may
take a few minutes), then click Finish, and reboot your PC.
Note
If Windows prevents you from doing this, go to Task Manager and stop the
OpenEnterprise and Emerson.RuntimeDataService services and under Details, end the
OEOPCDAServer.exe task.
Note
If the ProgramData\Emerson folder is not visible, go to Windows Control Panel,
choose File Explorer Options and from the View tab, make sure “Show hidden files,
folders, and drives” is selected.
2. Delete all EMERSON keys that are followed by the text “.OE,” “.OpenEnterprise,” or
“.Tools.Shared”.
3. Navigate to:
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Control\SessionManager\Environ
ment\
4. Double click on the Path string and then delete the C:\Program Files
(x86)\Emerson\OpenEnterprise\Bin; path from the Edit String dialog box as shown
below:
6. Click Edit >Find. In the Find dialog box, make sure selections are made to look at
Keys.
7. Type OpenEnterprise in the Find what edit field and click Find Next.
8. Delete each OpenEnterprise key and continue (use F3 key to continue the search) until
no OpenEnterprise keys can be found.
Index
C F
Connection .......................................................... 22 FBxNet
before establishing ........................................ 17 adding a new parameter in ........................... 63
creating ........................................................... 25 authentication ................................................. 71
direct ................................................................ 36 configuration parameters.............................. 79
exporting a ...................................................... 38 configuring ...................................................... 53
importing a ..................................................... 39 CSV file validation ........................................... 71
importing from ROCLINK .............................. 40 editing a site .................................................... 59
saving .............................................................. 38 editing a subscriber ..................................61, 62
starting ............................................................ 25 fault processing
Connections list................................................... 22 enabling or disabling ................................. 81
Credential Management Tab............................. 94 licensing ........................................................... 49
CSV file validation settings ............................................................ 82
in FBxNet ......................................................... 71 starting ............................................................. 55
CSV files switching between Monitor and
downloading to FBxNet subscribers ............ 72 Configuration mode ..................................... 57
downloading to subscriber of a single site . 73 Field Tools .............................................................. 1
making changes for FBxNet.......................... 73 logging in ......................................................... 18
restoring backups in FBxNet......................... 74 starting ............................................................. 18
synchronizing ................................................. 65 Figures
2-1. Changing User Account Control .............. 5
D 2-2. Installshield Wizard ................................... 7
Deleting 2-3. Installshield Wizard ................................... 7
an FBxNet publisher ...................................... 63 2-4. Installer Welcome Screen ......................... 8
an FBxNet site ................................................. 60 2-5. License Agreement.................................... 8
an FBxNet subscriber..................................... 62 2-6. Optional Package Selection ...................... 9
Field Tools user............................................... 21 2-7. Setup Status Screen ................................ 10
Deleting an FBxNet parameter ......................... 65 2-8. Installshield Wizard Finish Screen ......... 10
Device Security Management............................ 87 3-1. Log-in Dialog Box .................................... 18
Direct connection................................................ 36 3-2. Field Tools Main Screen .......................... 19
Disabling UAC.........................................................4 3-3. Change Password Dialog Box ................ 19
Index 121
Field Tools Quick Start Guide
D301703X412
November 2023
3-4. User management dialog box ............... 20 4-2. Calling Up the License Manager ........... 50
3-5. Add new user Dialog Box ....................... 20 4-3. Creating the LRF File ............................... 50
3-6. Security configuration dialog box ......... 21 4-4. Saving the LRF File .................................. 51
3-7. Device credentials dialog box ................ 22 4-5. Signing on with your License Id and
3-8. Connections List ...................................... 23 Password ....................................................... 51
3-9. Connection Wizard .................................. 26 4-6. Entering Contract Details ....................... 52
3-10. Device credentials dialog box .............. 27 4-7. Unlock Software Licenses and Submit
3-11. Serial Connection Settings – License Request ........................................... 53
FB1000/FB2000-Series Flow Computers & 4-8. Download the Key File ............................ 53
FB3000 RTU ................................................... 28 4-9. Adding a User .......................................... 54
3-12. Serial Connection Settings – 4-10. Defining User Details ........................... 55
ROC/FloBoss.................................................. 28 4-11. Starting FBxNet ..................................... 56
3-13. Serial Connection Settings – 4-12. FBx Main Screen ................................... 56
ControlWave/33xx ........................................ 28 4-13. Adding a Site ......................................... 58
3-14. Specifying the ROC Configuration File 29 4-14. Defining the Site ................................... 58
3-15. Specifying the TechView Session File .. 30 4-15. Site Defined ........................................... 59
3-16. IP Connection Settings – 4-16. Editing a Site.......................................... 60
FB1000/FB2000 Series Flow Computers & 4-17. Adding a Subscriber ............................. 61
FB3000 RTUs ................................................. 30 4-18. Subscriber Added ................................. 61
3-17. IP Connection Settings – ROC/FloBoss 31 4-19. Copying a Tag ....................................... 64
3-18. IP Connection Settings – 4-20. Subscriber CSV File in Excel ................. 70
ControlWave/33xx ........................................ 31 4-21. Download Files to Subscribers ............ 72
3-19. Specifying the ROC Configuration File 32 4-22. FBxNet Subscriber Status tab visible .. 75
3-20. Specifying the TechView Session File .. 32 4-23. FBxNet – Publisher Status tab visible . 76
3-21. WiFi Connection Parameters ............... 33 4-24. Details on a Single Publisher ............... 79
3-22. Connection in Progress ........................ 34 4-25. Subscriber Configuration tab .............. 80
3-23. Supply Secure Authentication Key ...... 35 4-26. Enabling Fault Processing.................... 81
3-24. RTU Configuration Tools – FBxConnect, 4-27. Fault Handling Columns ...................... 81
TechView, ROCLINK ...................................... 36 4-28. FBxNet Options dialog box .................. 82
3-25. Direct Connection ................................. 36 4-29. Effect on Network Diagram ................. 83
3-26. Active Connection Pane........................ 37 4-30. Tag Browser .......................................... 84
3-27. Settings dialog box ............................... 41 4-31. Attribute Pane Showing Attributes of a
3-28. Offline Configurations .......................... 42 Target Object Instance ................................ 85
3-29. Specifying the name of the solution file 5-1. DNP3 Security Keys tab .......................... 88
........................................................................ 43 5-2. Creating DNP Security Keys ................... 88
3-30. Specifying the characteristics of the 5-3. Generating a Random Key ..................... 89
solution .......................................................... 44 5-4. Viewing the Key in Plain Text................. 89
3-31. Saving the Offline Solution File ........... 45 5-5. Device Security File dialog box .............. 90
3-32. Specifying the name of the solution file 5-6. Choosing the Device for which you want
........................................................................ 45 to create a target file ................................... 90
3-33. Specifying I/O for the FB3000 .............. 46 5-7. Confirming the selection........................ 90
3-34. Saving the Offline Solution File ........... 47 5-8. Saving the STF File .................................. 91
3-35. Navigating to the Configuration (xml) 5-9. Assigning a password to the Target File
File .................................................................. 48 ........................................................................ 91
3-36. Converting a Configuration XML file to a 5-10. Creating a Connection to the RTU ...... 92
Solution File................................................... 48 5-11. Creating a Connection to the Flow
4-1. Subscriber and Publisher Devices ......... 49 Computer ...................................................... 93
122 Index
Field Tools Quick Start Guide
D301703X412
November 2023
Index 123
Field Tools Quick Start Guide
D301703X412
November 2023
124 Index
Field Tools Quick Start Guide
D301703X412
November 2023
Index 125
Field Tools Quick Start Guide
D301703X412
November 2023