SRM007FVAE0306

4590 Tank Side Monitor

Field device for tank sensor operation and monitoring and for
integration into inventory control systems

Service Manual
Modbus Communication Protocol

www.varec.com
Varec, Inc.
5834 Peachtree Corners East, Norcross (Atlanta), GA 30092 USA
Tel: +1 (770) 447-9202 Fax: +1 (770) 662-8939
4590

Copyright
All rights reserved. Printed in the United States of America. Except as permitted under
the United States Copyright Act of 1976, no part of this publication may be reproduced,
stored in a retrieval system or transmitted in any form or by any means- electronic,
mechanical, photocopying, recording or otherwise- without the prior written permission
of the Publisher:

Varec, Inc.
5834 Peachtree Corners East
Norcross (Atlanta) GA 30096
USA

Trademarks Acknowledged
Varec, Inc. recognizes all other trademarks. Trademarks of other products mentioned in
this document are held by the companies producing them.

Varec® is a registered trademark of Varec, Inc. Copyright 2003

FuelsManager® is a registered trademark of Varec, Inc. Copyright 2004

Modbus® is a registered trademark of the Modbus Organization, Inc.

HART® is a registered trademark of HART Communications Foundation

Smart Family® is a registered trademark of Rosemount Inc.

ToF® is a registered trademark of Endress+Hauser GmbH+Co, KG, Maulberg,

Germany

i
 Tank Side Monitor

Disclaimer of Warranties
The contract between the Seller and the Buyer states the entire obligation of the Seller.
The contents of this document shall not become part of or modify any prior or existing
agreement, commitment or relationship between the Seller and Buyer. There are no
express or implied warranties set out in this document. The only warranties that apply
are those in the existing contract between the Seller and Buyer.

Varec, Inc. products have not been tested by Varec, Inc. under all possible operational
conditions, and Varec, Inc. may not have all the data relative to your application. The
information in this document is not all inclusive and does not and cannot take into
account all unique situations. Consequently, the user should review this product
literature in view of his/her application. If you have any further questions, please contact
Varec, Inc. for assistance.

Limitations of Seller's Liability

In the event that a court holds that this document created some new warranties, Seller's
liability shall be limited to repair or replacement under the standard warranty clause. In
no case shall the Seller's liability exceed that stated as Limitations of Remedy in the
contract between the Seller and Buyer.

Terms of Use
The information provided in this document is provided “as is” without warranty of any
kind. Varec, Inc. disclaim all warranties, either express or implied, including the
warranties of merchantability and fitness for a particular purpose. In no event shall
Varec, Inc. or its suppliers be liable for any damages whatsoever including direct,
indirect, incidental, consequential, loss of business profits or special damages, even if
Varec, Inc. or its suppliers have been advised of the possibility of such damages.

Use of parts that are not manufactured or supplied by Varec, Inc. voids any Varec, Inc.
warranty and relieves Varec, Inc. of any obligation to service the product under warranty.
Varec, Inc. recommends the use of only Varec, Inc. manufactured or supplied parts to
maintain or service Varec, Inc. products.

ii Service Manual
4590 Contents

Contents

1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

2 Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1 Register Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.1 Parity Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.2 Description of the Basic Configuration Parameters ID (9211) . . . . . . . . . . . . 7
3.2.3 Description of the Extended Configuration Parameters Word Type (9221) . . 7

4 Functions and Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.1 Word registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.1.1 Word data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.1.2 Integer data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.1.3 Coded data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.1.4 Coded Discrete Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.1.5 Packed bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.1.6 Varec Model 8130 RTU configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.2 Floating-point registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.2.1 Two 16-bit register format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.2.2 Varec Model 8130 RTU configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.2.3 Convert to Word registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.3 Error values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5 Exception Responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

6 Hardware Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6.1 Termination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
6.2 RS-485 Modbus Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

7 Modbus Register Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7.1 Tank parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.1.1 Integer Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.1.2 Status Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.1.3 Unit values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7.1.4 Float Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.1.5 TSM SW 1.x parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.1.6 MFT parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7.2 Non-i.s. Analog output parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

iii
Contents Tank Side Monitor

8 Modbus - Example Telegram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

9 Tables and Reference Information . . . . . . . . . . . . . . . . . . . . . . . . 33

9.1 HART units coded table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
9.1.1 Temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
9.1.2 Pressure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
9.1.3 Volumetric flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
9.1.4 Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
9.1.5 Volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9.1.6 Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9.1.7 Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9.1.8 Mass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.1.9 Mass Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.1.10 Mass per volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.1.11 Viscosity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.1.12 Electromagnetic Unit of Electric Potential . . . . . . . . . . . . . . . . . . . . . . . . 37
9.1.13 Electrostatic Unit of Current . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.1.14 Electromagnetic Unit of Resistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.1.15 Energy (includes Work) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9.1.16 Power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9.1.17 Radial Velocity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9.1.18 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
9.1.19 Special . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
9.1.20 Manufacturer Specific 4590 TSM Definitions . . . . . . . . . . . . . . . . . . . . . . 39

iv Service Manual
4590 Introduction

1 Introduction

This protocol guide explains the operation of the Modbus protocol per Modicon
document PI-MBUS-300 Rev C (1991) implemented in the Varec 4590 Tank Side Monitor
(TSM).

The Modbus protocol defines the format of data and the techniques used to control the
flow of data. In Modbus, the flow of data between two devices uses a master/slave type
arrangement. The 4590 TSM acts as a Modbus slave and runs on the EIA (RS)-485
version of the Modbus communications board.

1
Introduction Tank Side Monitor

2 Service Manual
4590 Implementation

2 Implementation

The implementation of Modbus protocol for the 4590 TSM provides a standard form of
digital communication. Every effort has been made to parallel current implementations
so that the 4590 TSM communicates with existing Modbus masters.

Check compatibility carefully to ensure that the 4590 TSM is properly configured for the
data format expected by the host computer. Due to the unique application requirements
of the 4590 TSM, exceptions have been made and noted.

Note! This is no guarantee, however, that the interpretation made here will be the same as
that followed by the Modbus master.

The 4590 TSM implementation of Modbus protocol provides for the passing of
measured and calculated variables, configuration information and diagnostics in data
registers. Data is sent in these registers as floating-point values, word values, numeric
codes related to configuration lists, status summary words (packed bits) or individual
status flags (single bits).

One master and up to 31 4590 TSMs as Modbus slaves may be multidropped on a single
EIA (RS) 485 communication bus.

The Modbus functions implemented in the 4590 TSM are listed in the following table.

Modbus functions

Function code Function Information type Modbus nomenclature

03 Read Word, code, status word, floating point Read output registers
04 Read Word, code, status word, floating point Read input registers

06 Write Word, code, status word Preset single register

16 Write Word, code, status word, floating point Force multiple registers

65 Read MFT 32bit floating point Read floating point registers

66 Write MFT 32bit floating point Write floating point

registers

3
Implementation Tank Side Monitor

4 Service Manual
4590 Configuration

3 Configuration

The Modbus port on the 4590 TSM must be configured to establish communications.
The local display or Time-of-Flight (ToF) tool allows the user to set the 4590 TSM
Modbus port to match the Modbus master.

4590 TSM addresses provide unique identification for the host. The 4590 TSM address
is configurable through the local display or ToF tool. This address may range from 1 to
147 and must be unique for each Modbus device on a loop. Each 4590 TSM only
responds when a query has been sent to its unique address by the host.

The Modbus protocol defines two modes of transmission, Remote Terminal Unit (RTU)
or ASCII (American Standard Code for Information Interchange). The choice between
these two modes is dependent on the preference of the host. RTU is often the preferred
protocol because of its improved error detection capabilities and higher throughput.
ASCII mode uses ASCII printable characters to represent hexadecimal values, this mode
of transmission requires almost twice as many characters to pass information compared
with the RTU transmission mode.

Note! The 4590 TSM only supports the RTU mode of communications.

3.1 Register Map

The 4590 TSM supports both input and output register and coil assignments.

• Function codes 03 and 04 apply to the same data registers.

• Function codes 01 and 02 are not supported by the 4590 TSM.

5
Configuration Tank Side Monitor

3.2 Parameters

The EIA485 port must be configured for a transmission speed (baud rate). Allowable
values are 1200, 2400, 4800, 9600 bits per second. This item must be configured using
the local display or ToF tool. A summary of the configuration information required by
the 4590 TSM in order to implement Modbus is provided in the following table. Default
values are highlighted.

Modbus configuration information

Configuration item Valid entries Modbus configurable Local display or

ToF Tool configurable

Modbus address 1 ... 247 No Yes

Baud rate 600 No Yes

1200
2400
4800
9600

Parity Odd No Yes

Even
None
One Stop Bit

Mode Default no swap No Yes

Swap data
WW swap1

Word type Unsigned No Yes

Signed

1. The mode value affects the format for the floating point data returned by the 4590 TSM

3.2.1 Parity Settings

The following table explains, how the data is sent when one of the available parity
settings is selected in the 4590 TSM Modbus Menu. The column "RTU Settings" is
important when the 4590 TSM is connected to a RTU8130, it shows how the RTU8130
has to be set up.

NRF parity RTU Settings Parity bit Stop bits Data bits Startbits

Odd ODD odd 1 8 1

Even EVEN even 1 8 1

None   2 8 1

One Stop Bit 1)

NONE 1)
 1 8 1

1. default Values

6 Service Manual
4590 Configuration

3.2.2 Description of the Basic Configuration Parameters ID (9211)

This Value set the ID of the 4590 TSM. Never setup two TSM with the same ID on the
same loop.

3.2.2.1 Baud Rate (9212)

Setup the baud rate for communication speed (600, 1200, 2400, 4800, 9600).

3.2.2.2 Type (9213)

This is the setup for the parity bit (Odd, Even, None, One Stop Bit).

3.2.2.3 FP Mode (9214)

Set the format of the floating point value (no swap, swap data, WW swap).

3.2.3 Description of the Extended Configuration Parameters Word Type (9221)

Set Signed or Unsigned configuration for the integer registers. The 0% and 100% range
has to be defined before otherwise a valid integer value could not be calculated.

3.2.3.1 Invalid Data (9222)

The data value that would be filled in, if an error occurred during transferring the data
to the UART. (0xFF, 0x00).

3.2.3.2 Map Mode (9223) of 4590 TSM SW 1.x

Float Vals.: all values in the TSM SW 1.x (see Section 7.1.4) register map is transferred
as float values to the host

Integer Vals.: all value in the TSM SW 1.x (see Section 7.1.5) register map is transferred
as integer values to the host (signed or unsigned, based on the global
settings - menu 9221)

3.2.3.3 Bus Termination (9224)

Activate bus termination. Termination resistors should be placed at each end of the
communication bus to minimize reflections on the line.

Note! Bus termination is normally not needed at baud rates of 9600 or less.

Note! Do not use bus termination if the field communication is installed in a "star" configu-
ration. Use bus termination only for daisy-chained field wiring.

3.2.3.4 CRC Mode (9225)

This section set the start value of the CRC register, default value is 0xFFFF but some
Modbus Masters are working with 0x0000.

7
Configuration Tank Side Monitor

8 Service Manual
4590 Functions and Data Formats

4 Functions and Data Formats

The Modbus data in the 4590 TSM is arranged in word registers, floating point registers
and status bit registers. The assignment for these registers is found in “Modbus register
assignments”.

The 4590 TSM also supports a two 16-bit register floating point data format. Function
codes 03 and 04 are used to read these floating point register pairs while function code
16 is used to write the floating point register pairs.
A complete description of all the Modbus commands, can be found in the Modicon
Modbus Protocol Reference Guide, document number PI-MBUS-300.

4.1 Word registers

Word registers holding 16 bits of data (sometimes referred to as integers) are the most
commonly used type of Modbus data and are supported by most Modbus hosts. In the
4590 TSM implementation, the Modbus word registers are used to transfer one of the
following four formats:

• Word Data (unsigned) - a scaled number from 0 to 65535.

• Integer Data (signed) - a scaled number form -32768 to 32767
• Coded Data - Multiple choice configuration data chosen from a coded list.
• Packed Bit Data - Registers form of 16 packed single bits.

The word and coded data registers contain all of the information needed to configure
and read process data. Any word register may be read with function code 03 or function
code 04. These same registers may be written one at a time with function code 06 or
multiple registers can be written with function code 16.

4.1.1 Word data

The word data (unsigned) is a whole number between 0 and 65,535 stored as a 16 bit
binary number.

4.1.2 Integer data

Integer data (signed) is a scaled number from -32768 to +32767.

4.1.3 Coded data

Coded data responds to a look-up table value. Data written to these registers must be
a valid table entry or the value is rejected. For example, within the 4590 TSM the units
of a value are represented by the HART standard value look-up table (see “Modbus
register assignments”). Therefore, if the Units value read from a HART device was 45
(002D Hex), the units would be Meters.

9
Functions and Data Formats Tank Side Monitor

4.1.4 Coded Discrete Values

State Description

0 Unknown

1 Inactive

2 Active

3 Invalid

4.1.5 Packed bits

Packed bits represent 16 individual status bits packed into one register. The status bits
have been packed this way for systems that prefer handling only register information.
The bits within the packed registers are grouped by data or function type.

4.1.6 Varec Model 8130 RTU configuration

When configuring an Varec Model 8130 RTU to read these values (NOT using the default
RTU "TSM" interface point), you should make sure the “Operational Mode” parameter of
the MIREG point on the Model 8130 RTU is set to 1.

4.2 Floating-point registers

Although not part of the Modbus protocol specification, floating point numbers have
been implemented using the IEEE 754 standard 32-bit representation [see the IEEE
Computer Society (1985) "IEEE Standard for Binary Floating-Point Arithmetic, IEEE
Std 754-1985" for complete technical information on this format]. Floating point
numbers increase accuracy and reduce the complexity required in scaling word values
and provide a means to transmit numbers used by the 4590 TSM that are not easily
scaled.

4.2.1 Two 16-bit register format

The 4590 TSM makes these values available through a pair of 16-bit Modbus registers.
Function code 03 or 04 are used to read a floating point register pair. Function code 16
is used to write floating point register pairs. The pair of registers holding the floating
point MUST ALWAYS be read and written with a single command.

4.2.2 Varec Model 8130 RTU configuration

When configuring a Varec Model 8130 RTU to read these values (NOT using the default
RTU "TSM" interface point), you should have the 4590 TSM Modbus Mode parameter set
to 0 (default) and use a MFPREG point on the Model 8130 RTU with it's Mode parameter
set to 1.

Modbus FP Mode compatibility

TSM modbus mode Compatibility

Default no swap Model 8130 RTU MFPREG point (operational mode = 1)

Swap data Model 8130 RTU MFPREG point (operational mode = 0)

WW swap Modicon format floating point

10 Service Manual
4590 Functions and Data Formats

4.2.3 Convert to Word registers

When this mode was activated in software version 1.x, ALL floating point values in the
Modbus map were converted into integer values using the same scaling factors. This
means there were only two options:

1. read all registers as floating-point values

2. read all registers as integer values converted by the same scaling factor

Improvements:

1. in software version 2.x the floating-point and integer values using their own block
of registers. This makes it possible to read for example the level as floating-point
and temperature as integer value.

2. every group (like Level or Temperature) uses their own scaling factor (see Menu
9251 "Integer Scaling")

Group 0% 100% Unit

Level Values 0 30000 mm

Temp. Values 0 100 °C

Press. Values 0 0,25 bar

Density Values 0 1000 kg/m3

Flow Values --- --- ---

Vol. Flow. Val. --- --- ---

GP1 - 4 Values --- --- ---

User Map Values --- --- ---

4.3 Error values

When Invalid or Offline: + 99999999.999 0x4CBEBC20 (hex)

Maximum: + 99999999.999 0x4CBEBC20 (hex)

Minimum: - 99999999.999 0xCCBEBC20 (hex)

11
Functions and Data Formats Tank Side Monitor

12 Service Manual
4590 Exception Responses

5 Exception Responses

The exception responses returned by the 4590 TSM are listed below:

Modbus exception responses

Exception Response Reason

01 Illegal function Try to use functions that are not supported

02 Illegal data address Data address (bit or register) is not defined

03 Illegal data value Data value being written is out of range

10 (0x0A) Value read only Data address being written is read only

In addition, messages that are received with a parity error, checksum error or message
format error will be ignored.

13
Exception Responses Tank Side Monitor

14 Service Manual
4590 Hardware Implementation

6 Hardware Implementation

The 4590 TSM uses a 3-Wire EIA485 hardware interface to communicate with the
Modbus master. EIA485 is a high speed differential communications network which
allows up to 32 devices to operate on one network. The 4590 TSM and Modbus master
share a twisted triad of wires to communicate.

The communication distance EIA485 can reliably travel is dependent on baud rate
(communication speed), wire quality, environmental electrical noise, wiring
configuration and the number of multi-dropped 4590 TSMs. The recommended wire for
EIA485 systems is 18-gauge or larger, shielded, twisted triad. The shield should be
grounded at the Modbus master (control system or computer) end.

6.1 Termination

Termination resistors should be placed at each end of the communication bus to

minimize reflections on the line. If multiple 4590 TSM instruments are connected using
Modbus communication, then an adjustment must be made on the Modbus
communication board. For the last 4590 TSM connected on the Modbus, a resistor must
be activated by setting it in the Modbus Extended Setup Menu (Menu 9224).

Note! Bus termination is normally not needed at baud rates of 9600 or less.

Note! Do not use bus termination if the field communication is installed in a "star" configu-
ration. Use bus termination only for daisy-chained field wiring.

6.2 RS-485 Modbus Interface

There are various methods of interfacing a RS-485 Modbus loop to the control system,
such as an Varec Model 8130 RTU or a PC RS-485 interface. The method used will
depend on the system and software being installed. However, if a direct PC RS-485
interface is required, it is recommended that this be an internal industrial specification
interface card (e.g. ISA, PCI, PCMCIA) providing galvanic isolation and lightning
protection and not an external RS-232 to RS-485 converter.

15
Hardware Implementation Tank Side Monitor

16 Service Manual
4590 Modbus Register Assignments

7 Modbus Register Assignments

7.1 Tank parameters

7.1.1 Integer Values

Tank Parameters Data Modbus register Data type Access

Address

User Assignable Register 8 2000 2001 Integer Read Only

User Assignable Register 7 2001 2002 (use
function 03
User Assignable Register 6 2002 2003 and 04)
User Assignable Register 5 2003 2004

User Assignable Register 4 2004 2005

User Assignable Register 3 2005 2006

User Assignable Register 2 2006 2007

User Assignable Register 1 2007 2008

Level 2009 2010

Product Temperature 2010 2011

Vapor Temperature 2011 2012

Water Level 2012 2013

Observed Density 2013 2014

Pressure P1 (bottom) 2014 2015

Pressure P2 (middle) 2015 2016

Pressure P3 (top) 2016 2017

General Purpose Value 1 2017 2018

General Purpose Value 2 2018 2019

General Purpose Value 3 2019 2020

General Purpose Value 4 2020 2021

Measured Level 2021 2022

Level Percentage 2022 2023

Level Flow 2023 2024

Volume Flow 2024 2025

Level Correction 2025 2026

17
Modbus Register Assignments Tank Side Monitor

Tank Parameters Data Modbus register Data type Access

Address

Temperature Element 1 2026 2027 Integer Read Only

Temperature Element 2 2027 2028 (use

function 03
Temperature Element 3 2028 2029 and 04)
Temperature Element 4 2029 2030

Temperature Element 5 2030 2031

Temperature Element 6 2031 2032

Temperature Element 7 2032 2033

Temperature Element 8 2033 2034

Temperature Element 9 2034 2035

Temperature Element 10 2035 2036

Temperature Element 11 2036 2037 Coded Read Only

see (use
Temperature Element 12 2037 2038 section function 03
Temperature Element 13 2038 2039 4.1.4 and 04)
Temperature Element 14 2039 2040

Temperature Element 15 2040 2041

Temperature Element 16 2041 2042

Discrete read Value 1 2042 2043

Discrete read Value 2 2043 2044

Discrete read Value 3 2044 2045

Discrete read Value 4 2045 2046

Discrete read Value 5 2046 2047

Discrete read Value 6 2047 2048

Discrete read Value 7 2048 2049

Discrete read Value 8 2049 2050

Discrete write Value 1 2090 2091 Integer Read

Discrete write Value 2 2091 2092 only (function

0 and 1 03, 04)
Discrete write Value 3 2092 2093 is
allowed /
Discrete write Value 4 2093 2094 Write
(function 06,
16)

Discrete Value:
Valid values are 0 (zero) or 1. Trying to write a value > 1 will set the current value
automatically to 0 (zero).

18 Service Manual
4590 Modbus Register Assignments

7.1.2 Status Values

The following table describes the meaning of the bits in a status value.

bits Value not set (0) set (1)

0 W&M Status bad good

1 Valid Value invalid valid

2 Error none yes

3..4 reserved 0 1

5 Data Status live data held data

6 Device Status online offline

7 Unit Error none yes

8..11 reserved 0 1

12 Initialized Value unknown initialized

13..15 reserved 0 1

19
Modbus Register Assignments Tank Side Monitor

7.1.3 Unit values

Tank Parameters Data Modbus register Data type Access

Address

User Assignable Register 8 2200 2201 Coded Read Only

User Assignable Register 7 2201 2202 (use

function 03
User Assignable Register 6 2202 2203 and 04)
User Assignable Register 5 2203 2204

User Assignable Register 4 2204 2205

User Assignable Register 3 2205 2206

User Assignable Register 2 2206 2207

User Assignable Register 1 2207 2208

Level 2209 2210

Product Temperature 2210 2211

Vapor Temperature 2211 32212

Water Level 2212 2213

Observed Density 2213 2214

Pressure P1 (bottom) 2214 2215

Pressure P2 (middle) 2215 2216

Pressure P3 (top) 2216 2217

General Purpose Value 1 2217 2218

General Purpose Value 2 2218 2219

General Purpose Value 3 2219 2220

General Purpose Value 4 2220 2221

Measured Level 2221 2222

Level Percentage 2222 2223

Level Flow 2223 2224

Volume Flow 2224 2225

Level Correction 2225 2226

Temperature Element 1 2226 2227

Temperature Element 2 2227 2228

Temperature Element 3 2228 2229

Temperature Element 4 2229 2230

Temperature Element 5 2230 2231

Temperature Element 6 2231 2232

Temperature Element 7 2232 2233

Temperature Element 8 2233 2234

Temperature Element 9 2234 2235

20 Service Manual
4590 Modbus Register Assignments

Tank Parameters Data Modbus register Data type Access

Address

Temperature Element 10 2235 2236 Coded Read Only

Temperature Element 11 2236 2237 (use

function 03
Temperature Element 12 2237 2238 and 04)
Temperature Element 13 2238 2239

Temperature Element 14 2239 2240

Temperature Element 15 2240 2241

Temperature Element 16 2241 2242

User Write Value 1 2290 2291 Read

User Write Value 2 2291 2292 (function

03, 04)
User Write Value 3 2292 2293
/
User Write Value 4 2293 2294
Write
(function
06, 16)

21
Modbus Register Assignments Tank Side Monitor

7.1.4 Float Values

Tank Parameters Data Modbus register Data type Access

Address

User Assignable Register 8 2300 2301 Float Read Only

User Assignable Register 7 2302 2303 (use

function 03
User Assignable Register 6 2304 2305 Coded and 04)
User Assignable Register 5 2306 2307

User Assignable Register 4 2308 2309

User Assignable Register 3 2310 2311

User Assignable Register 2 2312 2313

User Assignable Register 1 2314 2315

Level 2318 2319

Product Temperature 2320 2321

Vapor Temperature 2322 2323

Water Level 2324 2325

Observed Density 2326 2327

Pressure P1 (bottom) 2328 2329

Pressure P2 (middle) 2330 2331

Pressure P3 (top) 2332 2333

General Purpose Value 1 2334 2335

General Purpose Value 2 2336 2337

General Purpose Value 3 2338 2339

General Purpose Value 4 2340 2341

Measured Level 2342 2343

Level Percentage 2344 2345

Level Flow 2346 2347

Volume Flow 2348 2349

Level Correction 2350 2351

Temperature Element 1 2352 2353

Temperature Element 2 2354 2355

22 Service Manual
4590 Modbus Register Assignments

Tank Parameters Data Modbus register Data type Access

Address

Temperature Element 3 2356 2357 Coded Read Only

Temperature Element 4 2358 2359 (use

function 03
Temperature Element 5 2360 2361 and 04)
Temperature Element 6 2362 2363

Temperature Element 7 2364 2365

Temperature Element 8 2366 2367

Temperature Element 9 2368 2369

Temperature Element 10 2370 2371

Temperature Element 11 2372 2373

Temperature Element 12 2374 2375

Temperature Element 13 2376 2377

Temperature Element 14 2378 2379

Temperature Element 15 2380 2381

Temperature Element 16 2382 2383

User Write Value 1 2490 2491 Read

User Write Value 2 2492 2493 (function

03, 04)
User Write Value 3 2494 2495
/
User Write Value 4 2496 2497
Write
(function
06, 16)

23
Modbus Register Assignments Tank Side Monitor

7.1.5 TSM SW 1.x parameters

Tank Parameters Data Modbus register Data type Access

Address

Corrected Level 3000 3001 Float Read Only

Tank Level 3002 3003 (use
function 03
Product Temperature 3004 3005 and 04)
Pressure P3 (top) 3006 3007

Pressure P2 (middle) 3008 3009

Pressure P3 (bottom) 3010 3011

Observed Density 3012 3013

Water Level 3014 3015

Vapor Temperature 3016 3017

Point Status 3018 3019 Coded Read Only

Bit #0 – Invalid Level (use
Bit #1 – Invalid Temp function 03
and 04)
Bit #2 – Invalid Water Level
Bit #3 – Invalid Density
Bit #4 – Invalid Top Pressure
Bit #5 – Invalid Middle Pressure
Bit #6 – Invalid Bottom Pressure
Bit #7 – Invalid Standard Density
Bit #8 – Reserved
Bit #9 – Level below minimum
Bit #10 – Reserved
Bit #11 – Reserved
Bit #12 – Reserved
Bit #13 – Invalid Air Temp
Bit #14 – Invalid Vapor Temp
Bit #15 – Invalid Flow
Product Temperature 3030 3031 Float

Vapor Temperature 3032 3033

(453x ATC Average Temperature)
Vapor Temperature 3034 3035
(453x ATC Vapor Temperature)

Temperature Element 1 3036 3037

(453x ATC Temperature 0)

Temperature Element 2 3038 3039

(453x ATC Temperature 1)

Temperature Element 3 3040 3041

(453x ATC Temperature 2)

Temperature Element 4 3042 3043

(453x ATC Temperature 3)

Temperature Element 5 3044 3045

(453x ATC Temperature 4)

24 Service Manual
4590 Modbus Register Assignments

Tank Parameters Data Modbus register Data type Access

Address

Temperature Element 6 3046 3047 Float Read Only

(453x ATC Temperature 5) (use function
Temperature Element 7 3048 3049 03 and 04)
(453x ATC Temperature 6)

Temperature Element 8 3050 3051

(453x ATC Temperature 7)

Temperature Element 9 3052 3053

(453x ATC Temperature 8)

Temperature Element 10 3054 3055

(453x ATC Temperature 9)

Temperature Element 11 3056 3057

(453x ATC Temperature 10)
Temperature Element 12 3058 3059
(453x ATC Temperature 11)

Temperature Element 13 3060 3061

(453x ATC Temperature 12)

Temperature Element 14 3062 3063

(453x ATC Temperature 13)

Temperature Element 15 3064 3065

(453x ATC Temperature 14)

Temperature Element 16 3064 3065

(453x ATC Temperature 15)
Analog Output Point Status 3114 3115 Coded
Bit #0 – Invalid source value reference
Bit #1 – Source value is below offset
value
Bit #2 – Source value is above scale value
Bit #3 – Not calibrated
Bit #4 – Value has been forced to ZERO
Bit #5 – Output is open circuit
Bit #6 – Source value is offline
Bit #7 ... #15 - Reserved

W&M Lock 3115 3116

Tank W&M Status 3176 3177

Bit #0 – Level W&M Status valid
Bit #1 – Temperature W&M valid
Bit #2 ... #15 - Reserved

Level Units 3179 3180

Temp Units 3180 3181

Pressure Units 3181 3182

Density Units 3182 3183

Level Percentage Range 3193 3194 Float

Hydrostatic Level 3195 3196

25
Modbus Register Assignments Tank Side Monitor

7.1.6 MFT parameters

The 4590 TSM Modbus map provides a compatible sub map to replace the Varec 4200
Multi-Function Transmitter without changing Modbus master settings, depending on
parameters used.

Reference: 4200 Multi-Function Transmitter Installation and Operations Manual.

Tank Parameters Data Modbus register Data type Access

Address

Effective Mass 0025 0026 MFT Read Only

True Mass 0026 0027 32 bit1) (use

function 03
Density 0027 0028 and 04)
Standard Density 0028 0029

Level 0030 0031

Water Level 0031 0032

Product Volume 0032 0033

Standard Product Volume 0033 0034

Water Bottom Volume 0034 0035

Remaining Volume 0035 0036

Product Temp 0036 0037

Ambient Temp 0037 0038

Temp Bottom 0038 0039

Temp Middle 0039 0040

Temp Top 0040 0041

Time To Fill 0041 0042

Flow Rate 0042 0043

Roof Mass 0043 0044

Pressure P3 (top) 0044 0045

26 Service Manual
4590 Modbus Register Assignments

Tank Parameters Data Modbus register Data type Access

Address

Pressure P1 (bottom) 0045 0046 MFT Read Only

Pressure P2 (middle) 0046 0047 32 bit 1)

(use
function 03
Available Product 0047 0048 and 04)
User Assignable Reg. 1 0000 0001 Integer

User Assignable Reg. 2 0001 0002

User Assignable Reg. 3 0002 0003

User Assignable Reg. 4 0003 0004

User Assignable Reg. 5 0004 0005

User Assignable Reg. 6 0005 0006

User Assignable Reg. 7 0006 0007

User Assignable Reg. 8 0007 0008

Effective Mass 0051 0052

True Mass 0052 0053

Density 0053 0054

Standard Density 0054 0055

Level 0056 0057

Water Level 0057 0058

Product Volume 0058 0059

Standard Product Volume 0059 0060

Water Bottom Volume 0060 0061

Remaining Volume 0061 0062

Product Temp 0062 0063

Ambient Temp 0063 0064

Temp Bottom 0064 0065

Temp Middle 0065 0066

Temp Top 0066 0067

Time To Fill 0067 0068

Flow Rate 0068 0069

Roof Mass 0069 0070

Pressure P3 (top) 0070 0071

Pressure P1 (bottom) 0071 0072

Pressure P2 (middle) 0072 0073

Available Product 0073 0074

27
Modbus Register Assignments Tank Side Monitor

Tank Parameters Data Modbus register Data type Access

Address

Alarm Status 0076 0077 Float Read Only

User Assignable Reg. 1 0300 0301 (use

function 03
User Assignable Reg. 2 0302 0303 and 04)
User Assignable Reg. 3 0304 0305

User Assignable Reg. 4 0306 0307

User Assignable Reg. 5 0308 0309

User Assignable Reg. 6 0310 0311

User Assignable Reg. 7 0312 0313

User Assignable Reg. 8 0314 0315

Effective Mass 0350 0351

True Mass 0352 0353 Float Read Only

Density 0354 0355 (use

function 03
Standard Density 0356 0357 and 04)
Level 0360 0361

Water Level 0362 0363

Product Volume 0364 0365

Standard Product Volume 0366 0367

Water Bottom Volume 0368 0369

Remaining Volume 0370 0371

Product Temp 0372 0373

Ambient Temp 0374 0375

Temp Bottom 0376 0377

Temp Middle 0378 0379

Temp Top 0380 0381

Time To Fill 0382 0383

Flow Rate 0384 0385

Roof Mass 0386 0387

Pressure P3 (top) 0388 0389

Pressure P1 (bottom) 0390 0391

Pressure P2 (middle) 0392 0393

Available Product 0394 0395

1. IEEE 754 floating-point standard

28 Service Manual
4590 Modbus Register Assignments

7.2 Non-i.s. Analog output parameters

Non-i.s. analog output parameters Data address Modbus register Data type Access

Analog Output Point Status 3114 33115 Bits Read Only

Bit #0 - Invalid source value reference
Bit #1 - Source value is below offset
value
Bit #2 - Source value is above scale
value
Bit #3 - Not calibrated
Bit #4 - Value has been forced to 0
Bit #5 - Output is open circuit
Bit #6 - Source value is offline
Bits #7 ... #15 - Reserved

29
Modbus Register Assignments Tank Side Monitor

30 Service Manual
4590 Modbus - Example Telegram

8 Modbus - Example Telegram

Device ID Function Address Number of CRC

registers

Rx 08 03 0B BC 00 02 07 52

Device ID Function Byte Count Value CRC

Tx 08 03 04 41 93 33 30 93 C6

31
Modbus - Example Telegram Tank Side Monitor

32 Service Manual
4590 Tables and Reference Information

9 Tables and Reference Information

"The encoding of the units transmitted by the 4590 TSM follow the HART units coded
table".

9.1 HART units coded table

As per HART Communications Foundation Document Number: HCF_SPEC-183 “HART -

SMART Communications Protocol, Common Tables”

The highlighted units are supported by the 4590 TSM Tank parameters. Other generic
HART devices may provide any of these values.

9.1.1 Temperature

HART unit code Unit Symbol

32 Degrees Celsius °C
33 Degrees Fahrenheit °F

34 Degrees Rankin °R

35 Degrees Kelvin Kelvin

9.1.2 Pressure

HART unit code Unit Symbol

1 Inches of Water (68 °F) InH2O

2 Inches of Mercury (0°C) InHg

3 Feet of Water (68 °F) FtH2O

4 Millimeters of Water (68 °F) mmH2O

5 Millimeters of Mercury (0°C) mmHg

6 Pounds per Square Inch PSI

7 Bars bar

8 Millibars mbar

9 Grams per Square Centimeter g/cm2

10 Kilograms per Square Centimeter kg/cm2

11 Pascals PA

12 Kilopascals kPA

13 Torr torr

14 Atmospheres ATM

237 Megapascals MPA

238 Inches of Water (4 °C) inH2O 4 °C

239 Millimeters of Water (4 °C) mmH2O 4°C

33
Tables and Reference Information Tank Side Monitor

9.1.3 Volumetric flow

HART unit code Unit Symbol

15 Cubic Feet per Minute ft3/min

16 Gallons per Minute (US) gal/min

17 Liters per Minute l/min

18 Imperial Gallons per Minute ImpGal/min

19 Cubic Meters per Hour m3/hr

22 Gallons per Second (US) gal/sec

23 Million Gallons per Day MilGal/day

24 Liters per Second lt/sec

25 Million Liters per Day MilL/day

26 Cubic Feet per Second ft3/sec

27 Cubic Feet per Day ft3/day

28 Cubic Meters per Second m3/sec

29 Cubic Meters per Day m3/day

30 Imperial Gallons per Hour ImpGal/hr

31 Imperial Gallons per Day ImpGal/day

121 Normal Cubic Meters per Hour "MKS System" m3/hr

122 Normal Liters per Hour "MKS System" l/hr

123 Standard Cubic Feet per Minute "US System" ft3/min

130 Cubic Feet per Hour ft3/hr

131 Cubic Meters per Minute m3/min

132 Barrels per Second (1 barrel = 42 US gallons) bbl/s

133 Barrels per Minute (1 barrel = 42 US gallons) bbl/min

134 Barrels per Hour (1 barrel = 42 US gallons) bbl/hr

135 Barrels per Day (1 barrel = 42 US gallons) bbl/day

136 Gallons per Hour (US) gal/hr

137 Imperial Gallons per Second ImpGal/s

138 Liters per Hour l/hr

235 Gallons per Day (US) gal/day

9.1.4 Velocity

HART unit code Unit Symbol

20 Feet per Second ft/s

21 Meters per Second mtr/s

114 Inches per Second in/s

115 Inches per Minute in/min

116 Feet per Minute ft/min

120 Meters per Hour mtr/hr

34 Service Manual
4590 Tables and Reference Information

9.1.5 Volume

HART unit code Unit Symbol

40 Gallons gal

41 Liters lt

42 Imperial Gallons ImpGal

43 Cubic Meters m3

46 Barrels (1 barrel = 42 US gallons) bbl

110 Bushels bush

111 Cubic Yards yd3

112 Cubic Feet ft3

113 Cubic Inches in3

124 Liquid Barrel (= 31.5 US gallons) bblLiq

166 Normal Cubic Meter "MKS System" m3

167 Normal Liter "MKS System" lt

168 Standard Cubic Feet "US System" ft3

236 Hectoliters hecto lt

9.1.6 Length

HART unit code Unit Symbol

44 Feet ft
45 Meters m

47 Inches in

48 Centimeters cm

49 Millimeters mm

9.1.7 Time

HART unit code Unit Symbol

50 Minutes min

51 Seconds sec

52 Hours hr

53 Days day

35
Tables and Reference Information Tank Side Monitor

9.1.8 Mass

HART unit code Unit Symbol

60 Grams g

61 Kilograms kg

62 Metric Tons MetTon

63 Pounds lb

64 Short Tons ShTon

65 Long Ton LTon

125 Ounce ounce

9.1.9 Mass Flow

HART unit code Unit Symbol

70 Grams per Second g/s

71 Grams per Minute g/min

72 Grams per Hour g/hr

73 Kilograms per Second kg/s

74 Kilograms per Minute kg/min

75 Kilograms per Hour kg/hr

76 Kilograms per Day kg/day

77 Metric Tons per Minute MetTon/min

78 Metric Tons per Hour MetTon/hr

79 Metric Tons per Day MetTon/day

80 Pounds per Second lb/s

81 Pounds per Minute lb/min

82 Pounds per Hour lb/hr

83 Pounds per Day lb/day

84 Short Topns per Minute ShTon/min

85 Short Tons per Hour ShTon/hr

86 Short Tons per Day ShTon/day

87 Long Tons per Hour LTon/hr

88 Long Tons per Day LTon/day

36 Service Manual
4590 Tables and Reference Information

9.1.10 Mass per volume

HART unit code Unit Symbol

90 Specific Gravity Units SGU

91 Grams per Cubic Centimeter g/cm3

92 Kilograms per Cubic Meter kg/m3

93 Pounds per Gallon (US) lb/gal

94 Pounds per Cubic Feet lb/ft3

95 Grams per Milliliter g/ml

96 Kilograms per Liter kg/l

97 Grams per Liter g/l

98 Pounds per Cubic inch lb/CuIn

99 Short Topns per Cubic Yard ShTon/CuYd

100 Degrees Twaddell °Twad

102 Degrees Baume Heavy °BaumHv

103 Degrees Baume Light °BaumLt

104 Degrees API °API

9.1.11 Viscosity

HART unit code Unit Symbol

54 Centistokes centi stokes

55 Centipoise cpoise

9.1.12 Electromagnetic Unit of Electric Potential

HART unit code Unit Symbol

36 Millivolts mV

58 Volts V

9.1.13 Electrostatic Unit of Current

HART unit code Unit Symbol

39 Milliamperes mA

9.1.14 Electromagnetic Unit of Resistance

HART unit code Unit Symbol

37 Ohms Ohm

163 Kiloohms kOhm

37
Tables and Reference Information Tank Side Monitor

9.1.15 Energy (includes Work)

HART unit code Unit Symbol

69 Newton Meter NM

89 Deka Therm

126 Foot Pounds Force

128 Kilo Watt Hour kWh

164 Mega Joule MJ

165 British Thermal Unit BTU

162 Mega Calorie MCal

9.1.16 Power

HART unit code Unit Symbol

127 Kilo Watt kW

129 Horsepower HP

140 Mega Calories per Hour

141 Mega Joule per Hour kWh

142 British Thermal Unit per Hour BTU/hr

9.1.17 Radial Velocity

HART unit code Unit Symbol

117 Degrees per Second deg/s

118 Revolutions per Second rev/s

119 Revolutions per Minute rpm

9.1.18 Miscellaneous

HART unit code Unit Symbol

38 Herts Hz

56 Microsiemens uMho

57 Percent %

59 pH pH
66 Milli Siemens per Centimeter mSiemen/cm

67 Micro Siemens per Centimeter uSiemen/cm

68 Newton N

101 Degree Brix °Brix

105 Percent Solids per Weight %Sol/wt

106 Percent Solids per Volume %Sol/vol

107 Degrees Balling °Ball

38 Service Manual
4590 Tables and Reference Information

HART unit code Unit Symbol

108 Proof per Volume proof/vol

109 Proof per Mass proof/mass

139 Parts per Million ppm

143 Degrees °

150 Percent Steam Quality %StmQual

151 Feet-Inch-1/16ths Ftin16

152 Cubic Feet per Pound ft3/lb

153 Picofarads pF

160 Percent Plato %Plato

9.1.19 Special

HART unit code Unit Symbol

250 Not Used

251 No Units

252 & 0 Unknown Units

253 Special

9.1.20 Manufacturer Specific 4590 TSM Definitions

HART unit code Unit Symbol

240 1/16th Inch 1/16in

241 Feet-Inch-1/16ths (stored as ft) Ftin16

242 Meters per second per second m/s2

243 Feet-Inch-1/8ths (stored as ft) Ftin8

244 Cubic decimeter dm3

245 Cubic decimeter dm3

246

247

248

249 Ampere A

39
Tables and Reference Information Tank Side Monitor

40 Service Manual
4590

NOTES

41
Your official representative
Your offical representative

www.varec.com
Varec, Inc.
5834 Peachtree Corners East, Norcross (Atlanta), GA 30092 USA
Tel: +1 (770) 447-9202 Fax: +1 (770) 662-8939
© 2006 Varec, Inc. All Rights Reserved. This document is for information purposes only. Varec, Inc. makes no warranties, express or implied, in this summary.
The names of actual companies and products mentioned herien may be the trademarks of their respective owners.