Endress+Hauser Tankvision NXA20 User manual

Products Solutions Services
BA01334G/00/EN/01.14
71260207
Valid as of software version:
1.1.0
Modbus Map Protocol
Tankvision Gauge Link NXA20
Enraf BPM / Emerson TRL/2 to RS485 Modbus

Tankvision Gauge Link
2Endress+Hauser
Table of Contents
1 Document information . . . . . . . . . . . . . . 4
1.1 Target audience for this manual . . . . . . . . . . . . . . . 4
1.2 Version history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 Document function . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.4 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2 Basic safety instructions . . . . . . . . . . . . 6
2.1 Requirements for the personnel . . . . . . . . . . . . . . . 6
2.2 IT security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.3 Designated use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.4 Workplace safety . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.5 Operational safety . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.6 Product safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3 Identification . . . . . . . . . . . . . . . . . . . . . . 8
3.1 Product identification . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2 Nameplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.3 Order code and device version . . . . . . . . . . . . . . . . . 9
3.4 Registered trademarks . . . . . . . . . . . . . . . . . . . . . . . 9
4 Introduction . . . . . . . . . . . . . . . . . . . . . . 10
4.1 Reference documentation . . . . . . . . . . . . . . . . . . 10
4.2 Communication Parameters . . . . . . . . . . . . . . . . 10
4.3 Modbus Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.4 Timeout and retries . . . . . . . . . . . . . . . . . . . . . . . 10
5 Modbus Task – Function: 4
(read 16 bit registers). . . . . . . . . . . . . . 11
5.1 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5.2 Primary information . . . . . . . . . . . . . . . . . . . . . . . 11
5.3 Temperature data . . . . . . . . . . . . . . . . . . . . . . . . . 12
5.4 Density data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5.5 Temperature data status . . . . . . . . . . . . . . . . . . . 14
5.6 Floating point format and signed integer level
format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5.7 Temperature data . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.8 Temperature data status . . . . . . . . . . . . . . . . . . . 16
5.9 Density data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
5.10 Diagnostic data . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
6 Enraf Devices . . . . . . . . . . . . . . . . . . . . . 20
6.1 Modbus Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.2 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.3 Level addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.4 Average temperature addresses . . . . . . . . . . . . . 21
6.5 Temperature element addresses . . . . . . . . . . . . . 22
6.6 Live Water addresses . . . . . . . . . . . . . . . . . . . . . . 23
6.7 Water dip addresses . . . . . . . . . . . . . . . . . . . . . . . 23
6.8 Density addresses . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.9 Reserved addresses . . . . . . . . . . . . . . . . . . . . . . . . 25
6.10 Vapour temperature addresses . . . . . . . . . . . . . . 26
6.11 Base pressure P1 addresses . . . . . . . . . . . . . . . . . 27
6.12 Liquid pressure P2 addresses . . . . . . . . . . . . . . . . 28
6.13 Vapour pressure P3 addresses . . . . . . . . . . . . . . . 29
6.14 Type of Enraf gauge . . . . . . . . . . . . . . . . . . . . . . . . 29
7 Emerson Devices. . . . . . . . . . . . . . . . . . .31
7.1 Modbus Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.2 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
7.3 All parameter gauge address except
temperature devices . . . . . . . . . . . . . . . . . . . . . . . . 31
7.4 Temperature device addresses . . . . . . . . . . . . . . . 32
7.5 Live Water registers . . . . . . . . . . . . . . . . . . . . . . . . 33
7.6 Vapour temperature registers . . . . . . . . . . . . . . . . 34
7.7 Base pressure P1 registers . . . . . . . . . . . . . . . . . . . 35
7.8 Liquid pressure P2 registers . . . . . . . . . . . . . . . . . 36
7.9 Vapour pressure P3 registers . . . . . . . . . . . . . . . . 36
8 Modbus Task – Function: 1
(read coil status). . . . . . . . . . . . . . . . . . .38
8.1 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9 Modbus Task – Function: 5
(Force single coil) . . . . . . . . . . . . . . . . . .39
9.1 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
10 Modbus Task – Function: 15
(Force multiple coil). . . . . . . . . . . . . . . .40
10.1 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
11 Modbus Task – Function: 6
(Preset single register) . . . . . . . . . . . . .41
11.1 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
11.2 Gauge operation code. Data offset 26 (40027) . 41
12 Modbus Task – Function: 16
(Preset multiple register) . . . . . . . . . . .42
12.1 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
13 Modbus Task – Function: 8
(sub function 0) (Diagnostics) . . . . . . .43
13.1 Modbus Address . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
14 Status . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
14.1 Product Level Status . . . . . . . . . . . . . . . . . . . . . . . . 44
14.2 Product Temperature Status . . . . . . . . . . . . . . . . . 44
14.3 Water Level Status . . . . . . . . . . . . . . . . . . . . . . . . . 45
14.4 Vapour Temperature Status . . . . . . . . . . . . . . . . . 45
14.5 Base Pressure P1 Status . . . . . . . . . . . . . . . . . . . . . 45
14.6 Liquid Pressure P2 Status . . . . . . . . . . . . . . . . . . . 46
14.7 Vapour Pressure P3 Status . . . . . . . . . . . . . . . . . . 46

Tankvision Gauge Link
Endress+Hauser 3
14.8 Density Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
14.9 Sensor Position Status . . . . . . . . . . . . . . . . . . . . . 47
14.10 Temperature Element . . . . . . . . . . . . . . . . . . . . . . 48
14.11 Density Position Status . . . . . . . . . . . . . . . . . . . . . 48
14.12 Density Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
14.13 Gauge Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Document information Tankvision Gauge Link
4Endress+Hauser
1 Document information
1.1 Target audience for this manual
This manual should support during the installation of the NXA20 units. It deals with the
mechenical, electrical and signal line installation. The first commisioning steps are described
as well.
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
Electrical symbols
Document version Valid for SW version Changes to the previous version
BA01334G/00/EN/01.14 1.1.0 Initial version
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
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.
DANGER
WARNING
CAUTION
NOTICE
)
*

Tankvision Gauge Link Document information
Endress+Hauser 5
Symbols for certain types of information
Symbols in graphics
1.4 Documentation
1.4.1 Operating instructions
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)
Document number Instrument Type of Document
BA01334G/00 Tankvision NXA20 Gauge Link Installation, Operation and Maintenance
Manual
1.
2.
3.
1.
2.
3.
-
.

Basic safety instructions Tankvision Gauge Link
6Endress+Hauser
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.
2.3 Designated use
2.3.1 Application
The Tankvision Gauge Link is a tank gauging protocol converter to allow integration of third
party gauging equipment into the Tankvision system. The Tankvision Gauge Link is available
with a range of different field bus interface options. Most field bus interfaces will support
connection of a number of gauges in a “multi-drop” or bus configuration. The number of
gauges which may be configured in the Tankvision Gauge Link is limited to 32, which should
be adequate for most typical tank gauging field busses, however electrical and / or protocol
limitations may reduce this number. The functionality which obtains will be determined by
that offered by the connected gauge(s) and the interface / protocol.
Connection to the host system is via EIA/TIA-485 (formerly RS-485) Modbus. This is
primarily intended for “one-to-one” connection with the Tankvision Tank Scanner or similar
device.
The Tankvision Gauge Link must only be used in “safe” areas where there is no hazard from
the presence of potentially explosive or flammable atmospheres.
The Tankvision Gauge Link has not been assessed in respect of functional safety.
Accordingly it is not intended to be used as a safety critical component or part of a safety
critical system or in the implementation of any safety function.
2.4 Workplace safety
For work on and with the device:

Tankvision Gauge Link Basic safety instructions
Endress+Hauser 7
• 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.

Identification Tankvision Gauge Link
8Endress+Hauser
3 Identification
3.1 Product identification
The following options are available for identification of the measuring device:
• Nameplate specifications
• Order code with breakdown of the device features on the delivery note
• Enter serial numbers from nameplates in W@M Device Viewer
(www.endress.com/deviceviewer): All information about the measuring device is
displayed.
For an overview of the technical documentation provided, enter the serial number from the
nameplates in the W@M Device Viewer (www.endress.com/deviceviewer)
3.2 Nameplate
nameplate_NXA20
1 Address of manufacturer
2Devicename
3Ordercode
4 Extended order code (Ext. ord. cd.)
5 Serial number (Ser. no.)
6DataMatrixCode
7 Degree of protection
8 Technical data of the Serial Service port
9Barcode
10 CE mark
11 Admissible ambient temperature
12 Type of fieldbus communication (output)
13 Type of fieldbus communication (input)
14 Supply voltage
Baud rate: 9600 Baud
Data bits: 8
Parity: none
Stop bits: 1
Flow control: none
90 ... 250 V AC 50/60 Hz 23 VA
MODBUS IP20
TRL2
250002972-B
Made in Great Britain
Melsonby, DL10 5NY
Tankvision
Order code: NXA20
Ext. ord. cd.:
Ser.-No.: XXXXXXXXXXX
-XXXX/XXX
NXA20-XXXXXXXX
-40°C (-40°F) £
T 60°C (140°F)£
amb
12345
6
8
9
10
11
12
13
14
7

Tankvision Gauge Link Identification
Endress+Hauser 9
3.3 Order code and device version
To find out the version of your device, enter the order code indicated on the nameplate
in the search screen at the following address: www.products.endress.com/order-ident
3.4 Registered trademarks
Microsoft®, Windows®and Internet Explorer®
Registered trademarks of the Microsoft Corporation
Modbus®
Registered trademark of the Modbus-IDA, Hopkinton, MA, USA
Java®
Registered trademark of Sun Microsystems, Inc.
Mozilla®Firefox®
Registered trademark of the Mozilla Foundation
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.

Introduction Tankvision Gauge Link
10 Endress+Hauser
4Introduction
This specification details the Modbus Protocol to be used by a host system or Modbus Master
device to interface with the TVGL (Tankvision Gauge Link) so as to retrieve data from the
attached gauges.
Requests made outside the modbus map register range as detailed below will cause the TVGL
to return an exception. Similarly any requests for functions which are not detailed below will
cause the TVGL to reply will an exception.
Parameters and data can only be configured and returned if the attached gauge will support
that feature otherwise the TVGL will return an error code for the associated parameter.
When references are made to data offset. Data offset represents 1 less than the Modicon
register.
There are 2 versions of the Tank Vision Gauge Link. A version which supports the Enraf GPU
protocol and a version which supports the SAAB Rosemount TRL/2 protocol.
4.1 Reference documentation
The Modbus interface shall be in accordance with the Modicon Modbus Protocol Reference
Guide, PI-MBUS-300, Rev.J.
4.2 Communication Parameters
• Baud Rate: 1200 to 19200 Baud
•StartBits:1
•StopBits:1
• Data Bits: 8
• Parity: NONE
4.3 Modbus Type
The Modbus protocol will be RTU mode.
4.4 Timeout and retries
The TVGL is a Modbus Slave device, as such it is the responsibility of the Modbus Master to
provide for communication timeouts and retries in the event of missing, incomplete or
corrupted responses.
It is recommended that the Master device provides a timeout timer of more than one second
and even longer for slow baud rates between the issuing of a request to the TVGL and
determination of a bad response.
In the event of a bad response, the Master should retransmit its request to the TVGL. The
Master should not deem that communication with the TVGL has failed unless the Master
still fails to receive a valid response after a predetermined number of retries.