Endress+Hauser Tankvision Multi Scan NXA83B User manual

Products Solutions Services
BA01289G/00/EN/02.15
71303671
Valid as of software version:
3.0.12
Operating Instructions
Tankvision
Multi Scan NXA83B
OPC Tank Data Server

Tankvision
2Endress+Hauser
Table of Contents
1 Document information . . . . . . . . . . . . . . 3
1.1 Target audience for this manual . . . . . . . . . . . . . . . 3
1.2 Version history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Document function . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.4 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Basic safety instructions . . . . . . . . . . . . 5
2.1 Requirements for the personnel . . . . . . . . . . . . . . . 5
2.2 IT security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.3 Designated use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.4 Workplace safety . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.5 Operational safety . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.6 Product safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3 Introduction . . . . . . . . . . . . . . . . . . . . . . . 7
3.1 Registered trademarks . . . . . . . . . . . . . . . . . . . . . . . 7
4 Installation . . . . . . . . . . . . . . . . . . . . . . . . 8
5 Starting/Stopping the OPC server. . . . . 9
6 OPC Client Licensing. . . . . . . . . . . . . . . 11
7 OPC Server Name. . . . . . . . . . . . . . . . . . 13
8 OPC Server Namespace. . . . . . . . . . . . . 14
8.1 Globals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
8.2 Tank Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
8.3 Gauge Duty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
8.4 Data Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
8.5 Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
9 Data Items Per Gauge . . . . . . . . . . . . . . 23
9.1 Tank Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 23
9.2 Status Bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
9.3 Profile Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
9.4 Calculated Parameters . . . . . . . . . . . . . . . . . . . . . 28
9.5 Gauge Commands . . . . . . . . . . . . . . . . . . . . . . . . . 29
9.6 Alarm Setpoints . . . . . . . . . . . . . . . . . . . . . . . . . . 30
9.7 Gauge Configuration Items . . . . . . . . . . . . . . . . . 31
9.8 Inventory Configuration Items . . . . . . . . . . . . . . 33
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Tankvision Document information
Endress+Hauser 3
1 Document information
1.1 Target audience for this manual
This guide is for users of Tankvision system and OPC Servers/Clients. The intended audience
includes Project Engineers and System Administrators.
Beside basic PC operating knowledge no special training is needed to perform the Tank
Gauging System operations. Nevertheless it is recommended receiving a training on the
system by Endress+Hauser.
1.2 Version history
1.3 Document function
1.3.1 Used symbols
Safety symbols
Symbols for certain types of information
Document version Valid for SW version Changes to the previous version
BA01289G/00/EN/01.14 3.0.10 Initial version
BA01289G/00/EN/02.15 3.0.12 Change of order code structure
Symbol Meaning
A0011189-EN
DANGER!
This symbol alerts you to a dangerous situation. Failure to avoid this situation will
result in serious or fatal injury.
A0011190-EN
WARNING!
This symbol alerts you to a dangerous situation. Failure to avoid this situation can
result in serious or fatal injury.
A0011191-EN
CAUTION!
This symbol alerts you to a dangerous situation. Failure to avoid this situation can
result in minor or medium injury.
A0011192-EN
NOTICE!
This symbol contains information on procedures and other facts which do not result
in personal injury.
Symbol Meaning
A0011193
Tip
Indicates additional information.
A0011195
Reference to page
Refers to the corresponding page number.
, , ... Series of steps
A0018373
Result of a sequence of actions
DANGER
WARNING
CAUTION
NOTICE
1.
2.

Document information Tankvision
4Endress+Hauser
Symbols in graphics
1.4 Documentation
1.4.1 Operating instructions
Symbol Meaning
1, 2, 3 ... Item numbers
, , ... Series of steps
A, B, C... Views
A0011187
Hazardous area
Indicates a hazardous area.
A0011188
Indicates a non-hazardous location
Safe area (non-hazardous area)
Document number Instrument Type of Document
BA01288G/00
•MultiScanNXA83B
Operation manual
BA01290G/00 Installation and Maintenance manual
BA01291G/00 Configuration manual
BA01292G/00 DCC Configuration manual
BA01289G/00 OPC Tank Data Server manual
BA01297G/00 Web Client System Operation manual
BA01287G/00 Weights and Measures Additions
BA01296G/00 Redundancy manual
1.
2.
-
.

Tankvision Basic safety instructions
Endress+Hauser 5
2 Basic safety instructions
2.1 Requirements for the personnel
The personnel for installation, commissioning, diagnostics and maintenance must fulfill the
following requirements:
• Trained, qualified specialists: must have a relevant qualification for this specific function
and task
• Are authorized by the plant owner/operator
• Are familiar with federal/national regulations
• Before beginning work, the specialist staff must have read and understood the instructions
in the Operating Instructions and supplementary documentation as well as in the
certificates
(depending on the application)
• Following instructions and basic conditions
The operating personnel must fulfill the following requirements:
• Being instructed and authorized according to the requirements of the task by the facility's
owner operator
• Following the instructions in these Operating Instructions
2.2 IT security
We only provide a warranty if the device is installed and used as described in the Operating
Instructions. The device is equipped with security mechanisms to protect it against any
inadvertent changes to the device settings.
IT security measures in line with operators' security standards and designed to provide
additional protection for the device and device data transfer must be implemented by the
operators themselves.
Endress+Hauser can be contacted to provide support in performing this task.
2.3 Designated use
2.3.1 Applications
Inventory control
By using Tankvision Multi Scan to monitor the tank level and stored volume of valuable
liquids remotely, owners or operators of tank farms or terminals for petroleum products and
chemicals (liquids) can visualize the volume of the stored medium in real time. The data can
be used to plan the inventory and distribution. The data can also be used to manage tank
farm operations like pumping or transferring products. Tankvision has its unique concept
using network technology. Without using proprietary software, the users can visualize and
manage their valuable liquids stored in the tanks by a web browser. Tankvision Multi Scan
is a flexible and cost effective solution due to its scalable architecture. The application
coverage goes from small depots with only a few tanks up to refineries.
Inventory Calculations
Tankvision Multi Scan calculates based on measured variables and tank capacity tables:
• Observed/Gross volumes,
•Netvolumesand
•Mass

Basic safety instructions Tankvision
6Endress+Hauser
of products like
• Hydrocarbons,
• Liquefied gases,
• Asphalt.
They are corrected according to international standards, including API/ASTM tables 5A, 5B/
6, 53A, 53B/54, 23/24, LPG.
This includes temperature corrections at 15 °C, 60 °F and alternative temperatures.
Additionally, available pumpable volumes and water volume are calculated.
Remote configuration of measuring equipment
Some on-site operations can be avoided using remote configuration of measuring equipment
during commissioning or maintenance (the availability of this feature may depend on the
system configuration).
Application areas
• Tank farms in refineries
• Ship loading terminals
• Marketing and distribution terminals
• Pipeline terminals
• Logistic terminals for tanks storing products like crude oils, refined white and black
products, chemicals, LPG
2.4 Workplace safety
For work on and with the device:
• Wear the required personal protective equipment according to federal/national
regulations.
• Switch off the supply voltage before connecting the device.
2.5 Operational safety
Risk of injury!
• Operate the device in proper technical condition and fail-safe condition only.
• The operator is responsible for interference-free operation of the device.
Conversions to the device
Unauthorized modifications to the device are not permitted and can lead to unforeseeable
dangers
• If, despite this, modifications are required, consult with Endress+Hauser.
Repair
To ensure continued operational safety and reliability,
• Carry out repairs on the device only if they are expressly permitted.
• Observe federal/national regulations pertaining to repair of an electrical device.
• Use original spare parts and accessories from Endress+Hauser only.
2.6 Product safety
The device is designed to meet state-of-the-art safety requirements, has been tested and left
thefactory in a condition in which it is safe to operate. The device complies with the
applicable standards and regulations as listed in the EC declaration of conformity and thus
complies with the statutory requirements of the EG directives. Endress+Hauser confirms the
successful testing of the device by affixing to it the CE mark.

Tankvision Introduction
Endress+Hauser 7
3Introduction
The OPC Data Access Server provides users of tank gauging systems with facilities for
monitoring and controlling their equipment using an industry standard that is growing in its
adoption rate.
The server allows access to data in the Real-Time database of our Tank Management
systems for such items as live tank data, configuration data and profile data. Gauges may
also be controlled via the gauge commands items in the OPC server.
Multiple OPC clients may be connected simultaneously to the server, up to a maximum limit
defined in the run-time license purchased by a user.
The server supports OPC clients using versions 1.0, 2.0 and 3.0 of the OPC Data Access
specification.
3.1 Registered trademarks
Microsoft®and Windows®
Registered trademarks of the Microsoft Corporation
MatrikonOPC®
Registered trademark of the Matrikon Inc.
Enraf, Honeywell, Rosemount, Emerson, Saab, L&J, VAREC, GPE are registered trademarks
and trademarks of these organizations and companies.
All other marks are property of their respective owners.

Installation Tankvision
8Endress+Hauser
4Installation
The OPC Data Access server is installed as standard with all our Tank Management systems
but will only allow clients to connect to live data with the correct licensing details.
The following files will be installed in the installation directory:
•OPC_Server.exe
• SOCmnas.dll
•SODaSas.dll
•SOSrvas.dll
In addition to the above, a set of OPC Core Component files provided by the OPC foundation
will be installed on the system. These require that the Microsoft Installer package is loaded
onto the system, which comes as standard for Windows XP onwards.

Tankvision Starting/Stopping the OPC server
Endress+Hauser 9
5 Starting/Stopping the OPC server
The OPC Data Access server runs as a system service, and will be automatically started when
a client attempts to connect. However it may be manually stopped or started using the
DCCConfig applet in the Start Menu, or desktop shortcut.
NXA83_Windows-Desktop_DCCConfig
1 Windows menu item: DCCConfig
NXA83_Windows-Desktop_DCCConfig-Icon
1 DCCConfig Desktop shortcut icon
NXA83_DCC-Config-Service
To stop the DCC services click on the Stop Services button.
1
1

Starting/Stopping the OPC server Tankvision
10 Endress+Hauser
When all Service Details have changed to Stopped the button will change to Start Services.
To start the DC Host again simply click the Start Services button. After a few moments all
installed services should change to Running.

Tankvision OPC Client Licensing
Endress+Hauser 11
6 OPC Client Licensing
The OPC Data Access server will allow multiple OPC clients to connect simultaneously, up to
a limit defined in the licensing details for the site. Clients above this limit may still browse
the server namespace, viewing properties and certain configuration data, but as soon as they
connect to live tank data they will be disconnected by the server.
To view the licensing details, run the DCC Config tool and select the License tab.
NXA83_DCC-Config_License_OPC-Clients
1 Licensing details
The maximum number of concurrent OPC clients allowed is defined in the item Number of
OPC Clients.
Details of the current number of connected clients are available in the OPC server GLOBALS
namespace (for more details →ä14).
The server supports OPC clients using versions 1.0, 2.0 and 3.0 of the OPC Data Access
specification.
All modes of accessing data items are supported (i.e. synchronous, asynchronous, refresh
and subscription), however when creating groups in the client there are some
recommendations for the value of the update time.
When setting up a group to contain data items from the namespace sections:
• Profile Data
• Gauge Commands
•AlarmSetpoints
•Units
• Gauge Configuration Items
• Inventory Configuration Items
1

OPC Client Licensing Tankvision
12 Endress+Hauser
It is recommended that the update time of the group should be set to zero seconds. This is
because these items rarely change in the database and are updated in the OPC server only
when they change. The other sections in the namespace contain live data items that should
be polled at regular intervals i.e. 1 second.

Tankvision OPC Server Name
Endress+Hauser 13
7 OPC Server Name
When using a test client (e.g. MatrikonOPC Explorer from Matrikon Inc.), the OPC server will
appear in the list of all OPC servers supported by the system, under the name Tank Data
Server or Tank.DataServer.1.
NXA83_MatrikonOPC-Explorer_Network-Neighnorhood
The actual name of the OPC server (i.e. the COM Program ID) is Tank.DataServer.1.
This is the name that should be used when manually entering item paths in a client.

OPC Server Namespace Tankvision
14 Endress+Hauser
8OPCServerNamespace
All data parameters from the Tank Gauging database (Levels, Temperatures, Volumes etc.)
will be structured in a NAMESPACE in the OPC Server, which will be generated dynamically
from the configuration of the Tank Gauging System.
This namespace can then be used by OPC Clients to access any data parameters they require.
Data parameters are grouped in a hierarchy of Tank Name, then Gauge (duty), then data
section, then data item: Tank Name.Gauge Duty.Data Section.Data Item
e.g. to access the Level for TK001 primary gauge, the name would be: TK001.Primary.Tank
Parameters.Product Level
8.1 Globals
There is always one fixed section in the namespace, called Globals.
This contains items which do not apply to an individual tank, but to the system as a whole.
Current data items in this group are:
•Watchdog: This is an integer value which increments every second when the system
communications are valid. The actual value is not important, as long as it is changing the
data in the DCC subsystem is valid. The value will reset back to 0 when it reaches the
maximum value for an integer. If the Watchdog stops incrementing this would indicate a
problem with the DCC sub-system (e.g. the Hermes or DCCHost services may have
stopped) and the validity of ALL tank data should not be trusted.
•Connected Clients: This is an integer value which contains a count of the total number of
client systems that have connected to the server. This includes clients that are only
browsing the OPC namespace, and those clients that have created OPC groups and are
receiving live data from the server system.
•Max Data Client: This is an integer value which contains the licensed maximum number
of clients that can be connected AND requesting live data, at the same time. Clients that
connect merely to browse the namespace (i.e. do not create OPC Groups for live data) are
not restricted by the license.
•Connected Data Clients: This is an integer value which contains the number of clients
that are connected and receiving live data from the server. It will never exceed the licensed
maximum allowed, and when this figure is reached any new clients attempting to obtain
live data from the server will be disconnected.
8.2 Tank Name
The tank name will be the tank name in the tank gauging database, with a maximum length
of 12 characters.
8.3 Gauge Duty
Each tank may have multiple gauges installed, with each gauge being configured as a
different duty.
Gauges may be configured with one of the following duties:
•Primary: The main gauge on the tank, used to calculate tank volumes, weights etc. A tank
MUST have a primary gauge configured.
•Secondary: Reserve gauge which is mainly used to check against the primary gauge values
for levels, temperatures etc.
•Backup (alarm): Used to generate hihi level shutdown alarms
•Densitometer: An advanced gauge used on LNG systems to carry out density profiles
A tank will ALWAYS have a primary gauge configured, whereas the other gauges are
optional. LNG systems will generally have all four gauges installed on each tank.

Tankvision OPC Server Namespace
Endress+Hauser 15
8.4 Data Section
The Data Section nodes divide Data Items into logical sections of related items.
The Data Section nodes currently supported for each gauge are:
•Tank Parameters: Live data usually from the gauge
•Status Bits: Gauge status bits, alarms etc.
•Profile Data: Profile data tables from the gauge
•Calculated Parameters: Volumes, mass etc.
•Gauge Commands: Commands to the gauge
•Alarm Setpoints: User configurable values used to generate software alarms
•Units: Parameter units
•Gauge Configuration Items: Configuration data
•Inventory Configuration Items: Configuration data used to calculate volumes
8.4.1 Data Scanning
The update rates, deadbands etc. may be set by the client, however as some data rarely
changes Endress+Hauser recommends the following guidelines:
• The data sections Tank Parameters, Status Bits and Calculated Parameters all contain
data items that may change regularly therefore should be on a relatively high update rate,
possibly as low as every 5 seconds.
•ThesectionProfile Data contains data that will only change when a new profile has been
carried out and thus should have a much lower update rate or be updated on demand only.
• The sections Alarm Setpoints, Gauge Configuration Items and Inventory Configuration
Items contain data items that only change when the user enters new data and should be
not be updated regularly. One suggestion is to set the update time in the client for these
items to 0so that the server will update the client only when these items change.
• The data items in the Units section are fixed and will never change. These are made
available for reference only.
8.5 Data Item
Each Data Item is a tank parameter from the Tank Gauging database and may be a level,
temperature, density, volume or similar parameter. The list of Data Items available is defined
later in this document.
Many live data parameters have an associated status parameter which defines whether the
parameter is valid or in error. e.g. Product Level has an associated field called Product Level
Status.
The status will have the following values:
• –1 = parameter is valid
• 0 or above = parameter is invalid and the status is the DN code
Unless otherwise stated, all data items are READ ONLY, that is, they may only be read
by the client.
8.5.1 Legacy Error Mode
In NORMAL mode when a parameter (level, temperature etc.) is invalid this will be indicated
by the associated status field (level status, temperature status etc.) being set to the error
code
(–1 = valid, 0+ = DN error code).
The actual parameter field will retain its last known value. The OPC Quality for the
parameter and status fields will remain GOOD (→ä16).
There is a LEGACY mode where the parameter field will be set to an OPC Quality of BAD if
the parameter is invalid.

OPC Server Namespace Tankvision
16 Endress+Hauser
By default the error mode will be NORMAL. To switch to LEGACY mode for data errors, start
the DCC Slave Configuration utility and change the item OPC Configuration → Global
Parameters →Error Mode.
NXA83_DCC-Slave-Configuration_OPC-Configuration_Global-Parameters
8.5.2 Data Item Properties
All Data Items will have an associated set of OPC Data Properties.
These will always include the six standard OPC properties:
•1DataType
•2Value
•3Quality
•4Timestamp
• 5 Access Rights
• 6 Scan Rates
The standard Timestamp property is the time the data item was read from the RTDB,
not the time of update from the gauge.
Unless otherwise stated, all data items have Access Rights of READ ONLY.
Many items will also have extra properties defining configuration data which only
applies to that item. These generally define certain configuration data that is usually
fixed or change very infrequently, such as alarm limits, units, manual values etc.

Tankvision OPC Server Namespace
Endress+Hauser 17
NXA83_MatrikonOPC-Explorer_Item-Properties_Product-Level
8.5.3 Bit-Mapped Data Items
Certain data items are available as bit-mapped integers; these include Alarm Status, Gauge
Mode etc. Such items will have the property EU Units set to Bit-Mapped.
A further set of properties will then define the bit definitions.
NXA83_MatrikonOPC-Explorer_Item-Properties_Alarm-Status
The following bit-mapped items in the Tank Parameters block have also been made
available, split into separate Boolean data items and located in the Status Bits block:
•AlarmsStatus1
•AlarmStatus2
•ServoStatus
•GaugeStatus
•SystemStatus

OPC Server Namespace Tankvision
18 Endress+Hauser
The most efficient way to access these items is through the bit-mapped field, however if the
client does not support bit manipulations the Boolean data items may be used instead.
In addition to the standard bit-mapped status data there are a number of status fields that
have no fixed mapping, but rather have a "free form" bit allocation dependent on the type of
gauge being polled.
These codes include:
•GaugeMode
• ExtendedGaugeStatus
At present only the Scientific Instruments 6280/6290 and Whessoe ITG60/70 gauges will
have a set of bits defined, all others will be blank.
8.5.4 Array Data Items
Certain of the data items are available as arrays of integers or floats. These include the
Element Temperatures (in the Tank Parameters block) and all Profile items in the
Profiles block.
Each array item will have 200 points. Array items will be in pairs, one with the actual values
and one with the corresponding statuses.
NXA83_MatrikonOPC-Explorer_Aray-Data-Items
1 Array data item (Element Temperatures in the Tank Parameters block)
Thus the Element Temperatures data item contains the array of 200 actual data values
whilst the Element Temperatures Status data item contains the array of 200 statuses that
correspond to the values.
1

Tankvision OPC Server Namespace
Endress+Hauser 19
NXA83_MatrikonOPC-Explorer_Item-Properties_Element-Temperatures
Statuses are mapped as –1 if the corresponding value is valid and zero or above if invalid, i.e.
bad.
NXA83_MatrikonOPC-Explorer_Item-Properties_Element-Temperatures-Status
The profile data items consist of the levels, temperatures and densities of the last profile
carried out by the gauge. The Time item is the time that the profile was carried out.
Only certain types of gauges support profiles.

OPC Server Namespace Tankvision
20 Endress+Hauser
8.5.5 Gauge Commands
The Gauge Commands section contains data items that may be written to by a client. These
are used to issue commands to control a gauge.
The Gauge Command data field should be written to with a control code to activate a
command (simply enter the decimal value into the shortint).
The other items are a number of arguments that supply further information for the
command being activated. They should be written to BEFORE sending the control code to the
Gauge Command item.
The Gauge Command data item consists of an ASCII character which may be one of the
following:
If the gauge command is stow (S) then the following items may be used to set any options:
ASCII Description
AAlternate (Fast) Scan (decimal 65)
BBasic (Normal) Scan (decimal 66)
OSingle Scan (for Off-Scan gauge) (decimal 79)
XExclude from Scan/Off-Scan (decimal 88)
TTest Gauge (Servo Check) (decimal 84)
CCancel Test (decimal 67)
FFreeze (decimal 70)
NUn-Freeze (decimal 78)
SStow (decimal 83)
UUn-Stow (decimal 85)
RRaise (decimal 82)
LLower (decimal 76)
QCalibrate (decimal 81)
1Interface 1 (air - product)
2Interface 2 (tank bottom)
3Interface 3 (product – water)
MStore current Level, Temperature and Alarm Status
EUpdate Element Temperatures
IUpdate Tank/Interface Profile Levels
KUpdate Tank/Interface Profile Temperatures
PUpdate Tank/Interface Profile Densities
DDip mode (level/temperature dip)
VProfile Scan (temperature/density/water/datum, etc.)
WWater dip
YDatum dip (zero level)
ZInitialise Gauge (Initialise Gauge Comms – does not reset the gauge itself)
–Cancel current command
(sp) No command active (status indication - not actually sent as a command)