VEEDER - ROOT SERIAL INTERFACE MANUAL for

1 VEEDER - ROOTSERIAL INTERFACE MANUALforTLS-300 and TLS-350 UST Monitoring SystemsandTLS-350 REnvironmental & InventoryManagement Systemthrough Software Versions 020/123/323/423/520 MANUAL Number 576013 -635 Revision NSerial INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision N2 TABLE OF RS-232 FORMAT AND BAUD MESSAGE MESSAGE FLOATING POINT CODES AND RESPONSE LEAK DEVICE INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision FUNCTIONS & , ALARM, & AUTO-PRINT LINE LEAK SENSOR LINE LEAK PLLD MAP & DELIVERY TICKET DEVICE DIAGNOSTIC DIAGNOSTIC DIAGNOSTIC LEAK DIAGNOSTIC DIAGNOSTIC ANALYSIS DATABASE LEVEL GAUGE LEVEL GAUGE ERROR CODE PROBE CONTENTS TABLE TEMPERATURE TABLE PROBE ERROR CODE DOWNLOAD SERVICE CODE INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision SERIAL RS-232 INTERFACE is used to connect the system to a controlling computer, a display terminal (CRT)or a printing terminal.

2 A modem can be connected directly to the system to provide telephone line : The software versions for these systems vary depending on when they were purchased and if softwareupgrades have been installed. The version in which each function code first appeared is indicated in a box nextto its description in Section 7. Commands appearing in software versions greater than 100 are only active insystems equipped with an CONNECTIONSThe RS-232 INTERFACE is a module accessed via a 25-pin D-connector located on the bottom-left of RS-232 D-connector is a panel mount, 25-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. ACRT or printing terminal (DTE) may be connected to the INTERFACE by using a null cable which reverses thesense of the transmit/receive signals. The system does not require or activate any handshake signals are wired to the female D-connector as follows:PIN2 Transmitted Data3 Received Data7 Signal Ground (common return) and RS-232 INTERFACEThe EIA RS-232 INTERFACE is designed to connect to modems for transmission of data over telephone lines.

3 Itcan be used for direct local attachment of terminals if the cable run is no more than 50 feet. In practice, cableruns longer than 50 feet have performed satisfactorily; however, since the RS-232 specification is designed foroperation up to 50 feet, direct connect cable runs greater than 50 feet are not warranted for proper INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision MODEMThe optional internal modem operates at up to 2400 Baud. The modem module contains two RJ11 jacks forphone line connections, and is accessible at the bottom left of the FORMAT AND BAUD RATEThe system receives and sends characters via the RS-232 INTERFACE in an ASCII format that is configured viathe system front panel keypads. Selections consist of: 1 start bit; 7 or 8 data bits; odd, even or no parity; and1 or 2 stop bits. Communications rate is selectable: 300, 1200, 2400, 4800 or 9600 baud. The systemoperates in a full duplex mode.

4 Characters are not echoed when received, and transmitted characters must notbe echoed back to the system. Transmit and receive can occur simultaneously, and commands can be stackedin the system buffer (up to 128 characters). SWITCHA four-position DIP switch is located on the CPU board, which is mounted in the right-back of the consoleprinter compartment. The DIP switch is next to the battery switch. The DIP switch enables the security codeand the switch positions are assigned as follows:Switch1 Front Panel Setup Security Enable2RS-232 Security Enable3, 4 UnusedSerial INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision MESSAGE FORMATAll command and response messages are configured in a format which includes a surrounding envelope ofcontrol characters and a function code and data field message. The control characters are described in thissection while the function codes and data field messages are described in subsequent system responds to a command message that has the following configuration:SOHS ecurity CodeFunction CodeData FieldSOH is a control-A character (ASCII 01).

5 The RS-232 security code is an optional six-digit code used to limit external SERIAL access to the system forsecurity purposes. It can be set to any unique set of characters using either the front panel switches or theexternal communication INTERFACE setup commands. The system will not respond to a command without theproper security code, if the DIP switch is set to enable RS-232 function code is a six character command code which the system interprets to determine the type of actionto take and response to return. System function codes and response messages are defined in data field is optional and contains information necessary to perform the selected function (such as setupinformation).If the system receives a command message string containing a function code that it does not recognize, it willrespond with a <SOH>9999FF1B<ETX>. The "9999" indicates that the system has not understood thecommand, while the "FF1B" is the appropriate checksum for the preceding <SOH>9999 is one command which does not follow the above format.

6 The escape command is performed bysending an ESC (escape character, ASCII 27), to the system. It is a means to halt a response message at anytime before its INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision MESSAGE FORMATT here are two types of response message formats: computer (or packed data format) and display format. Each format uses a different surrounding envelope of control FORMATThe computer format is a stream of numbers without any formatting characters; , carriage return, line feed,spaces, labels, etc. The message format is as follows:SOHF unction CodeData Field&&ChecksumETXThe function code is identical to the received command message function data field contains the response message which is described in subsequent "&&" is a fixed tag character which indicates that the checksum immediately Checksum is a series of four ASCII-hexadecimal characters which provide a check on the integrity of allthe characters preceding it, including the control characters.

7 The four characters represent a 16-bit binarycount which is the 2's complemented sum of the 8-bit binary representation of the message characters after theparity bit (if enabled) has been cleared. Overflows are ignored. The data integrity check can be done byconverting the four checksum characters to the 16-bit binary number and adding the 8-bit binary representationof the message characters to it. The binary result should be is programmable if enabled via the S53100f command. If it is disabled, the ETX is a fixed Control-Ccharacter (ASCII 03). Caution should be taken before changing the ETX character, because it affects thetransmitted messages on ALL communications ports of the system, and additional host devices may beconnected to other ports which expect the ETX to be a FORMATThe display format is intended for display on a CRT or printer. It includes all the necessary formattingcharacters such as carriage returns, line feeds, nulls, spaces, labels, etc.

8 The message format is as follows:SOHF unction CodeData FieldETXSee subsequent sections for a description of the data field response INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision FLOATING POINT (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 32-bits are arranged as follows:Byte1234S EEEEEEEE MMMMMMMMMMMMMMMMMMMMMMMN ibble12345678S 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 theresulting MMMM MMMM MMMM MMMM MMMM represents the 23-bit mantissa. Since themantissa describes a value which is greater than or equal to and less than , the 24th bit isalways assumed to be equal to 1 and is not transmitted or stored.

9 The value of the mantissa can bedetermined by dividing the value of the M field by 8,388,608 (2) and adding complete value of the floating point number can then be determined by multiplying the exponentby the mantissa and attaching the appropriate positive or negative convention, 00 00 00 00 represents the value even though it actually converts to eight "nibbles" are transmitted in sequence from 1 through 8 as shown in section INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision hex = 0011 1111 1000 0000 0000 0000 0000 0000 binS = 0 = + (positive)E = 011 1111 1 bin = 7F hex = 127 decM = 000 0000 0000 0000 0000 0000 bin = 0 hex = 0 decExponent = 2 = (127-127)Mantissa = + (0/8,388,608) = Value = + x = hex = 1011 1000 1101 0001 1011 0111 0001 0111 binS = 1 = - (negative)E = 011 1000 1 bin = 71 hex = 113 decM = 101 0001 1011 0111 0001 0111 bin = 51 B7 17 hex = 5,355,287 decExponent = 2 = (113-127)Mantissa = + (5,355,287/8,388,608) = Value = x = hex = 1100 0010 1100 0111 1111 1010 1110 0001 binS = 1 = - (negative)E = 100 0010 1 bin = 85 hex = 133 decM = 100 0111 1111 1010 1110 0001 bin = 47 FA E1 hex = 4,717,281 decExponent = 2 = 64(133-127)Mantissa = + (4,717,281/8,388,608) = Value = -64 x = hex = 0100 0110 0001 1100 0100 0000 0000 0000 binS = 0 = + (positive)

10 E = 100 0110 0 bin = 8C hex = 140 decM = 001 1100 0100 0000 0000 0000 bin = 1C 40 00 hex = 1,851,392 decExponent = 2 = 8,192(140-127)Mantissa = + (1,851,392/8,388,608) = Value = +8,192 x = 10,000 SERIAL INTERFACE ManualTLS-300/350/350R Monitoring SystemsPart No. 576013 -635, Revision CODES AND RESPONSE MESSAGESAll response messages are sent in a format described in previous sections. The function codes and data fieldsof these message formats are described in this section. The data field response messages are divided into thefollowing major groupings:Function Types001 to Functions101 to Reports (System)201 to Reports (In-tank)301 to Reports (Sensor)351 to Reports (Line Leak) Reports (Miscellaneous)401 to Reports (I/O Device)501 to Functions & Reports (System)520 to Functions & Reports (Communications)532 to Functions & Reports (Warning, Alarm, & Auto-print)601 to Functions & Reports (In-tank)701 to Functions & Reports (Sensor)751 to Functions & Reports (Volumetric Line Leak)771 to Functions & Reports (Pump Sensor)777 to Functions & Reports (Pressure Line Leak)790 to Functions & Reports (Reconciliation)7A0 to Functions & Reports (Wireless PLLD)7B1 to Functions & Reports (Meter Map & Delivery Ticket)7BC to Functions & Reports (I/O Device)851 to Functions & Reports (EEPROM)881 to Functions & Reports (Miscellaneous)901 to Reports (System)A01 to Reports (In-tank)B01 to Reports (Sensor)B50 to Reports (Line Leak)