Veeder-Root TLS-4 Series User manual

VEEDER - ROOT
SERIAL INTERFACE MANUAL
for
TLS4 Series
TLS-450 Series
TLS-450PLUS Series
Environmental & Inventory
Management System
Manual Number 577013-950
Revision L

Notice
Veeder-Root makes no warranty of any kind with regard to this publication, including but not limited to,
the implied warranties of merchantability and fitness for a particular purpose. Veeder-Root shall not be
liable for errors contained herein or for incidental or consequential damages in connection with the
furnishing, performance, or use of this publication. The information contained in this publication may
be subject to change without notice. This publication contains proprietary information which is
protected by copyright. All rights reserved. No part of this publication may be photocopied,
reproduced, or translated to another language without the prior written consent of Veeder-Root.
©Veeder-Root 2014. All rights reserved.

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision Liii
Table of Contents
1.0 INTRODUCTION ............................................................... 1
2.0 HARDWARE CONNECTIONS ..................................................... 1
2.1 RS-232 .................................................................................................................................................................. 1
2.2 EIA RS-232 INTERFACE ....................................................................................................................................... 2
2.3 INTERNAL MODEM .............................................................................................................................................. 2
3.0 CHARACTER FORMAT AND BAUD RATE............................................ 3
4.0 SWITCH SETTINGS............................................................. 3
4.1 DIP SW ITCH ......................................................................................................................................................... 3
5.0 COMMAND MESSAGE FORMAT................................................... 4
6.0 RESPONSE MESSAGE FORMAT .................................................. 5
6.1 COMPUTER FORMAT .......................................................................................................................................... 5
6.2 DISPLAY FORMAT ............................................................................................................................................... 5
6.3 ASCII FLOATING POINT FORMAT ........................................................................................................................ 6
6.3.1 NOTES ......................................................................................................................................................... 6
6.3.2 EXAMPLES .................................................................................................................................................. 7
7.0 FUNCTION CODES AND RESPONSE MESSAGES ..................................... 8
7.1 CONTROL FUNCTIONS ........................................................................................................................................ 10
7.2 OPERATIONAL REPORTS ................................................................................................................................... 23
7.2.1 SYSTEM REPORTS ..................................................................................................................................... 23
7.2.2 IN-TANK REPORTS ..................................................................................................................................... 46
7.2.3 SENSOR REPORTS .................................................................................................................................... 121
7.2.4 LINE LEAK REPORTS ................................................................................................................................. 135
7.2.5 I/O DEVICE REPORTS................................................................................................................................. 151
7.3 SETUP FUNCTIONS & REPORTS ........................................................................................................................ 157
7.3.1 SYSTEM SETUP .......................................................................................................................................... 157
7.3.2 COMMUNICATIONS SETUP ........................................................................................................................ 189
7.3.3 W ARNING, ALARM, & AUTO-PRINT SETUP .............................................................................................. 198
7.3.4. ADDRESS BOOK SETUP ............................................................................................................................ 229
7.3.5. AUTOMATIC EVENTS SETUP ..................................................................................................................... 255
7.3.6 IN-TANK SETUP ........................................................................................................................................... 271
7.3.7 SENSOR SETUP.......................................................................................................................................... 360
7.3.8 PUMP SENSOR SETUP .............................................................................................................................. 383
7.3.9 PRESSURE LINE LEAK SETUP .................................................................................................................. 390
7.3.10 RECONCILIATION SETUP ......................................................................................................................... 428
7.3.11 I/O DEVICE SETUP .................................................................................................................................... 476
7.3.12 MISCELLANEOUS SETUP ........................................................................................................................ 486
7.4 DIAGNOSTIC REPORTS ...................................................................................................................................... 532
7.4.1 SYSTEM DIAGNOSTIC REPORTS .............................................................................................................. 532
7.4.2 IN-TANK DIAGNOSTIC REPORTS ............................................................................................................... 537
7.4.3 SENSOR DIAGNOSTIC REPORTS.............................................................................................................. 577
7.4.4 LINE LEAK DIAGNOSTIC REPORTS........................................................................................................... 590
7.4.5 RECONCILIATION DIAGNOSTIC REPORTS ............................................................................................... 610

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision Liv
7.5 RECONCILIATION REPORTS .............................................................................................................................. 614
7.6 GUI DISPLAY SETUP............................................................................................................................................ 649
7.7 DEVICE VR-BUS CONFIGURATION .................................................................................................................... 665
8.0 FUNCTION CODE SUMMARY ..................................................... 673

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L1
1.0 INTRODUCTION
The serial RS-232 interface is used to connect the system to a controlling computer, a display
terminal (CRT) or a printing terminal. A modem can be connected directly to the system to provide
telephone line access.
NOTE: The software versions for these systems vary depending on when they were purchased
and if software upgrades have been installed. The version in which each function code first
appeared is indicated in a box next to its description in Section 7.
2.0 HARDWARE CONNECTIONS
The RS-232 interface is a module accessed via a 9-pin D-connector located on the bottom-left of
the console. Table 2.0 describes all allowable serial ports.
Table 2.0 – Console Slots and their Supported Comm Device Types
Comm Device
Type
Communicatio
n
Type
Slot 1
Slot 2
Slot 3
Slot 4
Slot 5
P1
P2
P1
P2
P1
P2
P1
P2
P1
P2
RS-232
Serial
X
X
X
X
X
X
RS-485
Serial
X
X
X
X
X
X
Internal Modem
Serial
X
X
X
X
X
Notes:
− P1 is port 1, P2 is port 2.
− Slot 1 (Ports 1 and 2), Slot 2 (Ports 1 and 2), and Slot 3 (Port 2) support Comm Device Types that need
Full Handshaking for serial communications.
− Slot 3 Port 1 is not available.
− Slot 4 Port 1 does not support Comm Device Types that need Full Handshaking for serial communications.
Slot 4 Port 2 is only available for Ethernet devices.
2.1 RS-232
The RS-232 D-connector is a panel mount, 9-pin female type, wired in a Data Terminal Equipment
(DTE) configuration. A modem (DCE) may be connected directly to the interface using a straight-
through cable. A CRT or printing terminal (DTE) may be connected to the interface by using a null
cable which reverses the sense of the transmit/receive signals. The system does not require or
activate any handshake signals.

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L2
RS-232 signals are wired to the female D-connector as follows:
2.2 EIA RS-232 INTERFACE
The EIA RS-232 interface is designed to connect to modems for transmission of data over
telephone lines. It can be used for direct local attachment of terminals if the cable run is no more
than 50 feet. In practice, cable runs longer than 50 feet have performed satisfactorily; however,
since the RS-232 specification is designed for operation up to 50 feet, direct connect cable runs
greater than 50 feet are not warranted for proper operation.
2.3 INTERNAL MODEM
The optional internal modem operates at up to 115200 Baud. The modem module contains two
RJ11 jacks for phone line connections, and is accessible at the bottom left of the console.

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L3
3.0 CHARACTER FORMAT AND BAUD RATE
The system receives and sends characters via the RS-232 interface in an ASCII format that is
configured via the system front panel keypads. Selections consist of: 1 start bit; 7 or 8 data bits;
odd, even or no parity; and 1 or 2 stop bits. Communications rate is selectable: 300, 1200, 2400,
4800, 9600, 19200, 38400, 57600 or 115200 baud. The system operates in a full duplex mode.
Characters are not echoed when received, and transmitted characters must not be echoed back to
the system. Transmit and receive can occur simultaneously, and commands can be stacked in
the system buffer (up to 128 characters).
4.0 SWITCH SETTINGS
4.1 DIP SWITCH
Not available in the TLS-450

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L4
5.0 COMMAND MESSAGE FORMAT
All command and response messages are configured in a format which includes a surrounding
envelope of control characters and a function code and data field message. The control
characters are described in this section while the function codes and data field messages are
described in subsequent sections.
The system responds to a command message that has the following configuration:
SOH
Security Code
Function Code
Data Field
SOH is a control-A character (ASCII 01).
The RS-232 security code is an optional six-digit code used to limit external serial access to the
system for security purposes. It can be set to any unique set of characters using either the front
panel switches or the external communication interface setup commands. The system will not
respond to a command without the proper security code, if the DIP switch is set to enable RS-232
security.
The function code is a six character command code which the system interprets to determine the
type of action to take and response to return. System function codes and response messages are
defined in subsequent sections.
The data field is optional and contains information necessary to perform the selected function
(such as setup information).
If the system receives a command message string containing a function code that it does not
recognize, it will respond with a <SOH>9999FF1B<ETX>. The "9999" indicates that the system
has not understood the command, while the "FF1B" is the appropriate checksum for the preceding
<SOH>9999 string.
There is one command which does not follow the above format. The escape command is
performed by sending an ESC (escape character, ASCII 27), to the system. It is a means to halt a
response message at any time before its completion.

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L5
6.0 RESPONSE MESSAGE FORMAT
There are two types of response message formats: computer (or packed data format) and display
format. Each format uses a different surrounding envelope of control characters.
6.1 COMPUTER FORMAT
The computer format is a stream of numbers without any formatting characters; i.e., carriage
return, line feed, spaces, labels, etc. The message format is as follows:
SOH
Function Code
Data Field
&&
Checksum
ETX
The function code is identical to the received command message function code.
The data field contains the response message which is described in subsequent sections.
The "&&" is a fixed tag character which indicates that the checksum immediately follows.
The Checksum is a series of four ASCII-hexadecimal characters which provide a check on the
integrity of all the characters preceding it, including the control characters. The four characters
represent a 16-bit binary count which is the 2's complemented sum of the 8-bit binary
representation of the message characters after the parity bit (if enabled) has been cleared.
Overflows are ignored. The data integrity check can be done by converting the four checksum
characters to the 16-bit binary number and adding the 8-bit binary representation of the message
characters to it. The binary result should be zero.
ETX is programmable if enabled via the S53100f command. If it is disabled, the ETX is a fixed
Control-C character (ASCII 03). Caution should be taken before changing the ETX character,
because it affects the transmitted messages on ALL communications ports of the system, and
additional host devices may be connected to other ports which expect the ETX to be a Control-C.
6.2 DISPLAY FORMAT
The display format is intended for display on a CRT or printer. It includes all the necessary
formatting characters such as carriage returns, line feeds, nulls, spaces, labels, etc. The
message format is as follows:
SOH
Function Code
Data Field
ETX
See subsequent sections for a description of the data field response messages.

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L6
6.3 ASCII FLOATING POINT FORMAT
6.3.1 NOTES
6.3.1.1 HHHHHHHH (H = 0-9 or A-F) indicates the 8 "nibble" ASCII-Hexadecimal
representation of a 4-Byte Floating Point number. Many data parameters are transmitted
in this format.
6.3.1.2 The 32-bits are arranged as follows:
Byte
1
2
3
4
S EEE
EEEE
E MMM
MMMM
MMMM
MMMM
MMMM
MMMM
Nibble
1
2
3
4
5
6
7
8
S is the sign bit (0 if positive, 1 if negative).
EEE EEEE E represents the 2's exponent. It is a 2's complement value biased by 127
(7F Hex). The exponent can be determined by subtracting 127 from the value of the E
field and raising 2 to the resulting power.
MMM MMMM MMMM MMMM MMMM MMMM represents the 23-bit mantissa. Since the
mantissa describes a value which is greater than or equal to 1.0 and less than 2.0, the
24th bit is always assumed to be equal to 1 and is not transmitted or stored. The value of
the mantissa can be determined by dividing the value of the M field by 8,388,608 (223)
and adding 1.0.
6.3.1.3 The complete value of the floating point number can then be determined by multiplying
the exponent by the mantissa and attaching the appropriate positive or negative sign.
6.3.1.4 By convention, 00 00 00 00 represents the value 0.0 even though it actually converts to
5.8775 x 10-39.
6.3.1.5 The eight "nibbles" are transmitted in sequence from 1 through 8 as shown in section
6.3.1.2.