Endress+Hauser Tankvision NXA820 User manual

Products Solutions Services
BA01137G/00/EN/03.17
71387780
Valid as of software version:
V 02.01.00
Operating Instructions
Tankvision
NXA820 OPC Server
User Manual

Tankvision
2Endress+Hauser
A0023555
Make sure the document is stored in a safe place such that it is always available when
working on or with the device.
To avoid danger to individuals or the facility, read the "Basic safety instructions" section
carefully, as well as all other safety instructions in the document that are specific to
working procedures.
The manufacturer reserves the right to modify technical data without prior notice. Your
Endress+Hauser distributor will supply you with current information and updates to
these Instructions.
Order code:
Ext. ord. cd.:
Ser. no.:
www.endress.com/deviceviewer Endress+Hauser
Operations App
XXXXXXXXXXXX
XXXXX-XXXXXX
XXX.XXXX.XX
Serial number
1.
3.
2.

Tankvision
Endress+Hauser 3
Table of Contents
1 Document information . . . . . . . . . . . . . . 4
1.1 Target audience for this manual . . . . . . . . . . . . . . . 4
1.2 Version history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 Acronyms, Abbreviation and Definition . . . . . . . . 4
1.4 Document function . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.5 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 Basic safety instructions . . . . . . . . . . . . . 7
2.1 Requirements for the personnel . . . . . . . . . . . . . . . 7
2.2 IT security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3 Designated use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.4 Workplace safety . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.5 Operational safety . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.6 Product safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3 Installation . . . . . . . . . . . . . . . . . . . . . . . . 9
3.1 Required files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2 Supported Windows version . . . . . . . . . . . . . . . . . . 9
3.3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4 Configuration . . . . . . . . . . . . . . . . . . . . . 12
4.1 Basic OPC Server Configuration . . . . . . . . . . . . . 13
4.2 Start OPC Server . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.3 Stop OPC Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5 OPC Data Structure . . . . . . . . . . . . . . . . 14
6 Tankvision OPC Parameter. . . . . . . . . . 15
6.1 Tank Parameter Reference . . . . . . . . . . . . . . . . . 19
7 Advanced OPC Server Configuration. .23
7.1 TankvisionOPC.config . . . . . . . . . . . . . . . . . . . . . . 23

Document information Tankvision
4Endress+Hauser
1 Document information
1.1 Target audience for this manual
This documents describes installation and user guide for configuration and usage of
Tankvision OPC DA 3.0 Server.
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 Acronyms, Abbreviation and Definition
1.4 Document function
1.4.1 Used symbols
Safety symbols
Document version Valid for SW version Changes to the previous version
BA01137G/00/EN/01.13 01.05.00 Initial version
BA01137G/00/EN/02.17 02.00.00 Added Temperature and Density Profile
parameters
BA01137G/00/EN/03.17 02.01.00 Introduced Floating Roof Weight
Correction, Redundancy functionality
with NXA820 Interface Only, CH alarm
for Volume or Mass
Abbreviation Meaning
OPC OLE for Process Control
Open Interoperability standards developed by OPC Foundation
OPC DA 3.0 OPC Data Access specification version 3.0 specification
COM Component Object Model
DCOM Distributed Component Object Model
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.
DANGER
WARNING
CAUTION

Tankvision Document information
Endress+Hauser 5
Electrical symbols
Symbols for certain types of information
Symbols in graphics
A0011192-EN
NOTICE!
This symbol contains information on procedures and other facts which do not result
in personal injury.
Symbol Meaning
A0011197
Direct current
A terminal to which DC voltage is applied or through which direct current flows.
A0011198
Alternating current
A terminal to which alternating voltage is applied or through which alternating current flows.
A0011200
Ground connection
A grounded terminal which, as far as the operator is concerned, is grounded via a grounding
system.
A0011199
Protective ground connection
A terminal which must be connected to ground prior to establishing any other connections.
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
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)
Symbol Meaning
NOTICE
)
*
1.
2.
1.
2.
-
.

Document information Tankvision
6Endress+Hauser
1.5 Documentation
1.5.1 Operating instructions
Document number Instrument Type of Document
BA01137G/00 Tankvision NXA820 OPC Server User Manual

Tankvision Basic safety instructions
Endress+Hauser 7
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 Application
Tankvision is a dedicated tank inventory management system.
Components:
• Tankvision Tank Scanner NXA820
scans parameters from tank gauges and performs tank calculations
• Tankvision Data Concentrator NXA821
summarizes data from various Tank Scanners NXA820
• Tankvision Host Link NXA822
provides data to host systems (such as PLC or DCS) via Modbus
The above mentioned components are operated via a standard web browser. It does not
require any proprietary software. Tankvision is based on a distributed architecture on a Local
Area Network (LAN). Due to its modular structure it can be adjusted to any application. It is
ideally suited for small tank farms with only a couple of tanks, but also for large refineries
with hundreds of tanks.

Basic safety instructions Tankvision
8Endress+Hauser
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
the factory 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 Installation
Endress+Hauser 9
3Installation
3.1 Required files
TankvisionOPCServer_Installer.msi: This file contains complete installable for Tankvision
OPC Server application.
3.2 Supported Windows version
• Windows XP (Service Pack 3)
• Windows 7 (32 bit / 64 bit)
• Windows 10 (32 bit / 64 bit)
On 64-bit machines OPC Server will be installed and run in 32-bit compatibility mode.
I.e. OPC Server will be installed in C:\Program Files(x86) or equivalent location.
3.3 Installation
You need to have administrator access right to install the software.
Install Microsoft .NET Framework 4 or higher before installation.
3.3.1 Install Microsoft .NET Framework 4
• Web Installer
http://www.microsoft.com/en-us/download/details.aspx?id=17851
• Standalone Installer
http://www.microsoft.com/en-in/download/details.aspx?id=17718
3.3.2 Install Tankvision OPC Server
Windows 7
Open Command prompt in Administrator mode as shown in below figure:

Installation Tankvision
10 Endress+Hauser
Go to directory where TankvisionOPCServer_Installer.msi is located and type
TankvisionOPCServer_Installer.msi.
Installation
Follow the below instructions to install.
Press Next to continue.

Tankvision Installation
Endress+Hauser 11

Configuration Tankvision
12 Endress+Hauser
4Configuration
This section explains some of the basic settings required to configure OPC server.
Windows 7
Configuration files are stored at %ALLUSERSPROFILE%\Endress+Hauser GmbH+Co.
KG\Tankvision OPC Server\Version_Number \PluginData location. and can also be access
from Start Menu → All Programs → Tankvision-OPCServer → Configuration.
To change any configuration file user has to follow below steps to make file writable:
•Right click on any configuration file and select Properties. Select Security tab and
press Edit Button.
• Select Users from Group or User Names tab and press select Full control from
Permissions for Users and press OK.

Tankvision Configuration
Endress+Hauser 13
Windows XP
Configuration file are stored at %ALLUSERSPROFILE%\Application
Data\Endress+Hauser GmbH+Co. KG\Tankvision OPC
Server\Version_Number\PluginData.
4.1 Basic OPC Server Configuration
Different NX820 unit can be configured by modifying the configuration file
TankvisionOPC.config. A connection can be added using the form of key value pairs as
shown in below example:
Basic-OPC-Server-Configuration
In above example 3 NX820 devices are added to OPC server using key UNITIP_.
Valid values for the item UnitIP_ are UnitIP_1 to UnitIP_15 is allowed. The current
version supports up to 15 NXA820 devices connected to one OPC server.
4.2 Start OPC Server
OPC server will be automatically started after installation. User can also manually start/
restart OPC server by executing RegServer.exe.
4.3 Stop OPC Server
OPC server can be stopped by executing UnregServer.exe.
For Windows 7 , to start/stop server open command prompt in Administrator mode, go
to project install directory and type RegServer.exe or UnRegServer.exe.

OPC Data Structure Tankvision
14 Endress+Hauser
5OPCDataStructure
Below diagram shows Tankvision OPC elements view from OPC Client. Here, text mentioned
in blue color are dynamic text and value will be received from Tankvision Tankscanner. Texts
in red color are static text.
OPC-Data-Structure

Tankvision Tankvision OPC Parameter
Endress+Hauser 15
6 Tankvision OPC Parameter
Device Parameters (NXA820-01.Device Status Code)
Tank Parameter (NXA820-01.TANKS.Tank-1.Tanke Name)
Measured Parameter (NXA820-01.Tanks.Tank-1.MEASURED_PARAMS.Free Water
Level)
No Item Name Comm ID Type Default Value Unit
1 Device Status Code 5009 String 0 NA
2 Device Connection Active 5010 String 0 NA
3 Last Heart Beat Time 5011 Datetime 01.01.1970 00:00 NA
4 IP Address 5012 String 0.0.0.0 NA
5 Device Name * 5013 String 0 NA
6OrderCode* 5014 String 0 NA
7 Serial Number * 5015 String 0 NA
8 Firmware Version * 5016 String 0 NA
9 Redundancy Mode ** 5017 unsigned long 0 NA
10 Redundancy Unit Type ** 5018 unsigned long 0 NA
11 Redundancy State ** 5019 unsigned long 0 NA
12 Redundancy Manual SwitchOver ** 5020 unsigned long 0 NA
No Item Name Comm ID Type Default Value Unit
1 Tank Name 5000 String TankName NA
2 Tank Shape 5520 unsigned long 0 NA
3 Tank Status 5516 unsigned long 0 NA
4 Tank Location 5515 String 0 NA
5 Transfer State 5519 unsigned long 0 NA
6 Product Code 5517 unsigned long 0 NA
7 Gauge Command $5514 unsigned long 0 NA
8 Gauge Communication Status 5004 unsigned long 0 NA
9 Product Name 5518 String No Product NA
No Item Name Comm ID Type Default Value Unit
1 Free Water Level 624 Double Float 0 m
2 Vapour Temperature 626 Double Float 0 C
3 Vapour Pressure 627 Double Float 0 KPa
4 Product Temperature 625 Double Float 0 C
5 Sample Temperature 1551 Double Float 0 C
6 Product Pressure 692 Double Float 0 KPa
7 Product Level 622 Double Float 0 m
8 Water Dip 1594 Double Float 0 m
9 Dip Temperature 1595 Double Float 0 C
10 Dip Product Level 1593 Double Float 0 m
11 Dip Observed Density 1596 Double Float 0 kg/m3

Tankvision OPC Parameter Tankvision
16 Endress+Hauser
12 Lab Reference Density 2887 Double Float 0 kg/m3
13 Reference Density 661 Double Float 0 kg/m3
14 Observed Density 628 Double Float 0 kg/m3
15 Ambient Temperature 660 Double Float 0 C
16 Alcohol Content in Volume 2102 Double Float 0 %
17 Alcohol Content in Mass 2101 Double Float 0 %
18 Secondary Level 623 Double Float 0 m
19 Gauge Status 2756 Double Float 0 NA
20 Gauge Error 2755 Double Float 0 NA
21 Analog Input * 2841 Double Float 0 %
22 Percentage Level 2654 Double Float 0 %
23 Temperature Element 1 to 16 1634 to
1649 Double Float 0 C
24 Temperature Element 17 to 24 1652 to
1659 Double Float 0 C
25 Temperature Element position 1
to 24
1660 to
1683 Double Float 0 m
26 Density Element 1 to 50 3001 to
3050 Double Float 0 kg/m3
27 Density Position 1 to 50 3051 to
3100 Double Float 0 m
28 FRT Level 1 ** 3111 Double Float 0 m
29 FRT Level 2 ** 3112 Double Float 0 m
30 FRT Level 3 ** 3113 Double Float 0 m
No Item Name Comm ID Type Default Value Unit

Tankvision Tankvision OPC Parameter
Endress+Hauser 17
Calculated Parameter (NXA820-01.Tanks.Tank-1.CALCULATED_PARAMS.Dead
Stock)
Fast View Parameter (NXA820-01.Tank-1.Dead Stock)
No Item Name Comm ID Type Default Value Unit
1 Usable Volume 719 Double Float 0 m3
2 Floating Roof Correction 762 Double Float 0 m3
3 Floating Roof Position 763 Double Float 0 NA
4 Free Water Volume 725 Double Float 0 m3
5 Gross Observed Volume 726 Double Float 0 m3
6 Gross Standard Volume 727 Double Float 0 m3
7 Liquid in Vapour Volume 1561 Double Float 0 m3
8 Vapour Mass 756 Double Float 0 kg
9 Net Standard Volume 728 Double Float 0 m3
10 Net Standard Weight 761 Double Float 0 kg
11 Net Standard Flowrate 723 Double Float 0 m3/min
12 Volume Flow Rate 722 Double Float 0 m3/min
13 Product Level Change Rate 721 Double Float 0 mm/sec
14 Product Mass 729 Double Float 0 kg
15 Dead Stock 718 Double Float 0 m3
16 Sediment and Water Volume 720 Double Float 0 m3
17 Tank Shell Correction Factor 774 Double Float 0 m3
18 Total Observed Volume 717 Double Float 0 m3
19 Total Mass 730 Double Float 0 kg
20 Mass Flow Rate 724 Double Float 0 kg/min
21 Total Standard Volume 752 Double Float 0 m3
22 Vapour Density 1591 Double Float 0 kg/m3
23 Vapour Room Volume 1592 Double Float 0 m3
24 Volume Correction Factor 754 Double Float 0 NA
25 Calculated Reference Density 661 Double Float 0 kg/m3
26 Calculated Observed Density 628 Double Float 0 kg/m3
27 HTMS Product Temperature 2201 Double Float 0 C
28 FRT Delta Level 3114 Double Float 0 m
29 FRT Delta Mass 3115 Double Float 0 m
No Item Name Comm ID Type Default Value Unit
1 Alcohol Content in Mass 2101 Double Float 0 %
2 Alcohol Content in Volume 2102 Double Float 0 %
3 Ambient Temperature 660 Double Float 0 C
4 Analog Input * 2841 Double Float 0 %
5 Dead Stock 718 Double Float 0 m3
6 Dip Observed Density 1596 Double Float 0 kg/m3
7 Dip Product Level 1593 Double Float 0 m

Tankvision OPC Parameter Tankvision
18 Endress+Hauser
8 Dip Temperature 1595 Double Float 0 C
9 Water Dip 1594 Double Float 0 M
10 Floating Roof Correction 762 Double Float 0 m3
11 Floating Roof Position 763 Double Float 0 NA
12 Free Water Level 624 Double Float 0 m
13 Free Water Volume 725 Double Float 0 m3
14 Gauge Command $5514 unsigned long 0 NA
15 Gauge Error 2755 Double Float 0 NA
16 Gauge Status 2756 Double Float 0 NA
17 Gross Observed Volume 726 Double Float 0 m3
18 Gross Standard Volume 727 Double Float 0 m3
19 Liquid in Vapour Volume 1561 Double Float 0 m3
20 Mass Flow Rate 724 Double Float 0 kg/min
21 Net Standard Flowrate 723 Double Float 0 m3/min
22 Net Standard Volume 728 Double Float 0 m3
23 Net Standard Weight 761 Double Float 0 kg
24 Observed Density 628 Double Float 0 kg/m3
25 Percentage Level 2654 Double Float 0 %
26 Product Code 5517 unsigned long 0 NA
27 Product Level 622 Double Float 0 M
28 Product Level Change Rate 721 Double Float 0 mm/sec
29 Product Mass 729 Double Float 0 kg
30 Product Name 5518 String No Product NA
31 Product Pressure 692 Double Float 0 KPa
32 Product Temperature 625 Double Float 0 C
33 Reference Density 661 Double Float 0 kg/m3
34 Sample Temperature 1551 Double Float 0 C
35 Secondary Level 623 Double Float 0 m
36 Sediment and Water Volume 720 Double Float 0 m3
37 Tank Location 5515 String 0 NA
38 Tank Name 5000 String TankName NA
39 Tank Shape 5520 unsigned long 0 NA
40 Tank Shell Correction Factor 774 Double Float 0 NA
41 Tank Status 5516 unsigned long 0 NA
42 Temperature Element 1 to 16 1634 to
1649 Double Float 0 C
43 Temperature Element 17 to 24 1652 to
1659 Double Float 0 C
44 Total Observed Volume 717 Double Float 0 NA
45 Total Standard Volume 752 Double Float 0 NA
46 Transfer State 5519 unsigned long 0 NA
47 Usable Volume 719 Double Float 0 NA
48 Vapour Density 1591 Double Float 0 kg/m3
49 Vapour Mass 756 Double Float 0 kg
No Item Name Comm ID Type Default Value Unit

Tankvision Tankvision OPC Parameter
Endress+Hauser 19
Note!
6.1 Tank Parameter Reference
6.1.1 Device Status Codes
50 Vapour Pressure 627 Double Float 0 KPa
51 Vapour Temperature 626 Double Float 0 C
52 Volume Correction Factor 754 Double Float 0 NA
53 Volume Flow Rate 722 Double Float 0 m3/min
54 Lab Reference Density 2887 Double Float 0 kg/m3
$Read/writable OPC Parameter.
* OPC Parameters available only in software version V01.05.00 and onwards.
** New parameters available only from Software Version 02.01.00 onwards
Diagnostic
Code
Short Text Cause
F101 NXA 820 Conn. Lost Unable to Communicate with NXA820
F301 Data Mem. Fault Failed to Detect or Initialize Data Flash Memory
F302 LAN Fault LAN Cable Disconnected or Failed
F303 SYNC Fault SYNC Link Cable Disconnected or Failed
F304 FPGA Error Unable to access FPGA
F305 NV Data Error The data in the NV memory does not match the RAM copy
F306 Order Code Error The factory set order code is invalid, NXA is unable to startup
F307 Expansion Board Fault Expansion boardtypedoesnotmatchexpectedprotocol typeor failed to
program FPGA
F308 Watchdog Error Software Watchdog Error
F309 FS Security Error Security policy compromised due to file-system error
F310 High CPU Load High CPU Utilization
F311 Low Disk Space Low Disk Space
F312 Low RAM Low RAM
F313 Bad Thread Bad Thread Status
F314 Reset by WD Hardware reset by WatchDog
F315 CheckSum Error CheckSum Error
F316 Language Error Language Installation Error
F317 Access Cnfg Err Access Configuration Error: No machines registered for access
F318 FPGA Config Err fpga.conf file is corrupted or not available
F319 RTC LowVolt Err Real Time Clock Battery Low voltage Detected
F320 Time Read Err Real Time Clock Read Error
F321 Time maybe bad! Time maintained by the RTC might be wrong
F322 RTC Nvmgr Err RTC could not access NV memory to store or retrive time
C324 Archive Export Started –
F325 NAND not accessible NAND Flash damaged
No Item Name Comm ID Type Default Value Unit

Tankvision OPC Parameter Tankvision
20 Endress+Hauser
6.1.2 Tanks Status
6.1.3 Product Transfer State
F326 NAND Write exceeded NAND Flash Write operation exceeded
F327 NAND Write stop
exceeded
NAND Flash Write operation stop exceeded
F328 Database corrupted Configuration database corrupted
F329 All Gauges failed All connected gauges are failed. Valid only when redundancy activated.
F330 Connection lost with
Primary unit
Secondary redundant unit lost the connection with Primary redundant
unit
F331 Connection lost with
Secondary unit
Primary redundant unit lost the connection with Secondary redundant
unit
F332 Module restarted often Module is restarted more 5 times
C485 Simulation Mode On Field scan simulation mode is activated
C486 Manual Switch Over
ON
Redundancy Manual Switch Over is activated.
C487 Redundancy activated Redundancy feature is activated.
C488 Unit is active Redundant unit is active. i.e. field scan is active.
C489 Unit is passive Redundant unit is passive. i.e. field scan is in standby mode
F501 Database Fault Database Failure
F502 Not Configured LAN Has Not Been Configured
C503 HART Tunneling Gauge Configuration In Progress
F504 Subscrip. Store Subscription Store Cannot Be Found
M505 Time Server –
C506 Field Scan Off The field scan has been stopped
C507 Interface Off The hostlink interface has been stopped
Status Code Meaning
646 In Maintenance
647 Locked
648 Manual
649 In Operation
Status Code Meaning Description
0 None Transfer not started
1 Armed Transfer initialized
2 Active Transfer is in progress
3 Completed Transfer completed , here product transfer is within defined min, max batch
size
4 Finished Transfer finished by user by pressing Finish button
5 Aborted Transfer aborted by user
6PausedTransferispaused
Diagnostic
Code
Short Text Cause