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.

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L7
6.3.2 EXAMPLES
6.3.2.1 3F800000 hex = 0011 1111 1000 0000 0000 0000 0000 0000 bin
S = 0 = + (positive)
E = 011 1111 1 bin = 7F hex = 127 dec
M = 000 0000 0000 0000 0000 0000 bin = 0 hex = 0 dec
Exponent = 2(127-127) = 1.0
Mantissa = 1.0 + (0/8,388,608) = 1.0
Decimal Value = +1.0 x 1.0 = 1.0
6.3.2.2 B8D1B717 hex = 1011 1000 1101 0001 1011 0111 0001 0111 bin
S = 1 = - (negative)
E = 011 1000 1 bin = 71 hex = 113 dec
M = 101 0001 1011 0111 0001 0111 bin = 51 B7 17 hex = 5,355,287 dec
Exponent = 2(113-127) = 0.0000610352
Mantissa = 1.0 + (5,355,287/8,388,608) = 1.63840
Decimal Value = -0.0000610352 x 1.63840 = -0.0001
6.3.2.3 C2C7FAE1 hex = 1100 0010 1100 0111 1111 1010 1110 0001 bin
S = 1 = - (negative)
E = 100 0010 1 bin = 85 hex = 133 dec
M = 100 0111 1111 1010 1110 0001 bin = 47 FA E1 hex = 4,717,281 dec
Exponent = 2(133-127) = 64
Mantissa = 1.0 + (4,717,281/8,388,608) = 1.56234
Decimal Value = -64 x 1.56234 = -99.99
6.3.2.4 461C4000 hex = 0100 0110 0001 1100 0100 0000 0000 0000 bin
S = 0 = + (positive)
E = 100 0110 0 bin = 8C hex = 140 dec
M = 001 1100 0100 0000 0000 0000 bin = 1C 40 00 hex = 1,851,392 dec
Exponent = 2(140-127) = 8,192
Mantissa = 1.0 + (1,851,392/8,388,608) = 1.22070
Decimal Value = +8,192 x 1.22070 = 10,000

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L8
7.0 FUNCTION CODES AND RESPONSE MESSAGES
All response messages are sent in a format described in previous sections. The function codes
and data fields of these message formats are described in this section. The data field response
messages are divided into the following major groupings:
Function Codes .................................................................................................. Response Types
003 to 094 .............................................................................................................. Control Functions
101 to 122 ........................................................................................... Operational Reports (System)
201 to 2E4............................................................................................ Operational Reports (In-tank)
301 to 347 ........................................................................................... Operational Reports (Sensor)
373 to 385 ....................................................................................... Operational Reports (Line Leak)
401 to 408 ...................................................................................... Operational Reports (I/O Device)
501 to 572 ............................................................................... Setup Functions & Reports (System)
521 to 531 ................................................................. Setup Functions & Reports (Communications)
536 to 5BF ............................................ Setup Functions & Reports (Warning, Alarm, & Auto-print)
5G1 to 5K7 .................................................................... Setup Functions & Reports (Address Book)
5P1 to 5Q1 ....................................................................... Setup Functions & Reports (Auto Events)
601 to 6SU ............................................................................... Setup Functions & Reports (In-tank)
701 to 749 ................................................................................ Setup Functions & Reports (Sensor)
P01 to P07 .....................................................................Setup Functions & Reports (Pump Sensor)
75A to 78G ............................................................ Setup Functions & Reports (Pressure Line Leak)
51N to 7H5 .................................................................... Setup Functions & Reports (Reconciliation)
7C7 to 7C8 .................................................................... Setup Functions & Reports (Pump Monitor)
801 to 822 ........................................................................... Setup Functions & Reports (I/O Device)
871 to D02 .................................................................... Setup Functions & Reports (Miscellaneous)
902 to 907 ............................................................................................ Diagnostic Reports (System)
A01 to A9J ............................................................................................ Diagnostic Reports (In-tank)
B01 to B46 ............................................................................................ Diagnostic Reports (Sensor)
B61 to B8J ........................................................................................ Diagnostic Reports (Line Leak)
BA0 to CA2 ................................................................................ Diagnostic Reports (Reconciliation)
C01 to CA3 .................................................................................................... Reconciliation Reports
G01 to G0D.......................................................................................................... GUI Display Setup
L01 to L07 ...................................................................................................... Line Setup (Line Leak)
N01 to N07 .......................................................................................... Device VR-Bus Configuration
S51 to SA1 ......................................... Line Pressure Sensor Setup & Reports (Pressure Line Leak)

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L9
Most response messages can be requested for either a single device (tank, sensor, line, etc.) or all
devices. A "TT" in the function code signifies single device number 01 through 16. When "TT" is
00, it signifies all devices.
Typically, response messages include information on the active devices only. That is, those
devices that are connected and working. However, the system can be forced to send data on
inactive devices by using an inactive device number. In this case, if no valid data is available on a
device, the message is filled out with question marks (?) in the place of numbers.
Computer format response messages do not include any formatting characters such as carriage
returns, line feeds, spaces, nulls, labels, etc. Only those characters shown are actually included in
the response message. For convenience, the messages are shown in segments and do not
actually include any line feeds, carriage returns, etc. Also, the notes to the right and between the
message lines are not included in the messages. All number values contained in the response
messages retain leading zeroes.
Display format response messages include the formatting characters shown. All message lines
end with a carriage return, line feed and six nulls. All response messages start and end with at
least one blank line.
The system function codes and response messages are described in detail in the following
sections under the major headings given above. A summary list of all function codes is given at
the end of this document.

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L10
7.1 CONTROL FUNCTIONS
Function Code: 003 Version 2
Function Type: Remote Alarm Reset
Command Format:
Display: <SOH>S00300
Computer: <SOH>s00300
Typical Response Message, Display Format:
<SOH>
S00300
MAR 27, 1996 8:04 PM
<ETX>
Typical Response Message, Computer Format:
<SOH>s00300YYMMDDHHmm&&CCCC<ETX>
Notes:
1. YYMMDDHHmm - Current Date and Time
2. && - Data Termination Flag
3. CCCC - Message Checksum

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L11
Function Code: 010 Version 1
Function Type: Cancel Autodial Computer Mode Session
Command Format:
Display: <SOH>S01000
Computer: <SOH>s01000
Typical Response Message, Display Format:
<SOH>
S01000
MAR 27, 1996 8:04 PM
<ETX>
Typical Response Message, Computer Format:
<SOH>s00300YYMMDDHHmm&&CCCC<ETX>
Notes:
1. YYMMDDHHmm - Current Date and Time
2. && - Data Termination Flag
3. CCCC - Message Checksum

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L12
Function Code: 052 Version 1
Function Type: Start In-Tank Leak Detect Test
Command Format:
Display: <SOH>S052TT (Use 203 command for inquiry)
Computer: <SOH>s052TT
Typical Response Message, Display Format:
<SOH>
S052TT
MAR 27, 1996 6:28 PM
TANK LABEL
1 UNLEADED REGULAR LEAK TEST START
TEST BY EXTERN INTERFACE
<ETX>
Typical Response Message, Computer Format:
<SOH>s052TTYYMMDDHHmmTTk&&CCCC<ETX>
Notes:
1. YYMMDDHHmm - Current Date and Time
2. TT - Tank Number (Decimal, 00=all)
3. k - Status Flag
0=OFF
1=ON
4. && - Data Termination Flag
5. CCCC - Message Checksum

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L13
Function Code: 053 Version 1
Function Type: Stop In-Tank Leak Detect Test
Command Format:
Display: <SOH>S053TT
Computer: <SOH>s053TT
Typical Response Message, Display Format:
<SOH>
S053TT
MAR 29, 1996 6:27 PM
TANK LABEL
1 REGULAR UNLEADED LEAK TEST STOP
<ETX>
Typical Response Message, Computer Format:
<SOH>s053TTYYMMDDHHmmTTk&&CCCC<ETX>
Notes:
1. YYMMDDHHmm - Current Date and Time
2. TT - Tank Number (Decimal, 00=all)
3. k - Status Flag
0=OFF
1=ON
4. && - Data Termination Flag
5. CCCC - Message Checksum

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L14
Function Code: 054 Version 1
Function Type: Delete CSLD Rate Table
Command Format:
Display: <SOH>S054TT149
Computer: <SOH>s054TT149
Notes:
1. TT - Tank Number (command valid for single tank only)
2. 149 - This verification code must be sent to confirm the command
Typical Response Message, Display Format:
<SOH>
S054TT
MAR 29, 1996 6:27 PM
T 1:REGULAR UNLEADED CSLD RECORDS DELETED
<ETX>
Typical Response Message, Computer Format:
<SOH>s054TTYYMMDDHHmm&&CCCC<ETX>
Notes:
1. YYMMDDHHmm - Current Date and Time
2. TT - Tank Number
3. && - Data Termination Flag
4. CCCC - Message Checksum

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L15
Function Code: 081 Version 1
Function Type: Start Pressure Line Leak Test
Command Format:
Display: <SOH>S081QQ149
Computer: <SOH>s081QQ149
Notes:
1. 149 - This verification code must be sent to confirm the command
Typical Response Message, Display Format:
<SOH>
S081QQ
MAR 29, 1996 6:27 PM
Q 1:REGULAR UNLEADED
STATUS: TEST COMPLETE
<ETX>
Typical Response Message, Computer Format:
<SOH>s081QQYYMMDDHHmmQQtt&&CCCC<ETX>
Notes:
1. YYMMDDHHmm - Current Date and Time
2. QQ - Pressure Line Leak sensor number (Decimal, 00=All)
3. tt - Test status
00=test complete
01=dispensing
02=testing at 3.00 gal/hr
03=testing at 0.10 gal/hr
04=test aborted
05=running pump (manual test starting)
06=line lockout
07=disable alarm
08=test pending
09=testing delay
0A=pressure check
0B=testing at 0.20 gal/hr
4. && - Data Termination Flag
5. CCCC - Message Checksum

Serial Interface Manual
TLS4/TLS-450 Monitoring Systems
Part No. 577013-950, Revision L16
Function Code: 082 Version 1
Function Type: Stop Pressure Line Leak Test
Command Format:
Display: <SOH>S082QQ149
Computer: <SOH>s082QQ149
Notes:
1. 149 - This verification code must be sent to confirm the command
Typical Response Message, Display Format:
<SOH>
S082QQ
MAR 29, 1996 6:27 PM
Q 1:REGULAR UNLEADED
STATUS: TEST COMPLETE
<ETX>
Typical Response Message, Computer Format:
<SOH>s082QQYYMMDDHHmmQQtt&&CCCC<ETX>
Notes:
1. YYMMDDHHmm - Current Date and Time
2. QQ - Pressure Line Leak sensor number (Decimal, 00=All)
3. tt - Test status
00=test complete
01=dispensing
02=testing at 3.00 gal/hr
03=testing at 0.10 gal/hr
04=test aborted
05=running pump (manual test starting)
06=line lockout
07=disable alarm
08=test pending
09=testing delay
10=pressure check
11=testing at 0.20 gal/hr
4. && - Data Termination Flag
5. CCCC - Message Checksum