SiteSentinel Automated Monitoring System Model 2 and Model 3. Operator Manual Software Version 1.12CUS

SiteSentinel

QUICK INVENTORY REPORT LINE (tanks and groups)

M08/u/tnk/m/ps/sen/mmddyyyy/hhmmss/dddddd.ddd/dddddd.ddd/dddddd.ddd/

dddddd.ddd

M08

Line Title

Units of Measurement: F = English; T = Metric

tnk/m/ps/sen

Device Identification: tank number (0 to 999) / smart module (1 to 8) / module

position (1 to 16) / device type

mmddyyyy/hhmmss

Date & Time of Measurement: month, day, year / hours, minutes, seconds

dddddd.ddd

Net Corrected Tank Volume

dddddd.ddd

Product Level (blank for groups)

dddddd.ddd

Average Product Temperature (average of temperature sensors which are currently

submersed in product)

dddddd.ddd

Water Level (blank for groups)

SENSOR DATA LINE

M09/dddddd.ddd/dddddd.ddd

M09

Line Title

dddddd.ddd

Measured Sensor Voltage; floating point number

dddddd.ddd

Reserved for Parts per million; floating point number

SALE/DELIVERY/THEFT VOLUMES

M10/dddddd.ddd/dddddd.ddd/dddddd.ddd/dddddd.ddd/dddddd.ddd

M10

Line Title

dddddd.ddd

Net Corrected Tank Volume Change

dddddd.ddd

Gross Measured Tank Volume Change

dddddd.ddd

Net Product Volume Change

dddddd.ddd

Gross Water Volume Change

dddddd.ddd

Estimated Delivery Temperature (blank for sale and theft)

204

Appendices

TIMED LEAK TEST RESULTS

M11/dddddd.ddd/dddddd.ddd/dddddd.ddd/dddddd.ddd/dddddd.ddd/resu

M11

Line Title

dddddd.ddd

Measured Leak Rate

dddddd.ddd

Water Volume Rate of Change

dddddd.ddd

Duration of Timed Leak Test

dddddd.ddd

Temperature Change During Timed Leak Test

dddddd.ddd

Leak Threshold

resu

Test Results:

LEAK -- "LEAK INDICATED"

ACTV -- "ACTIVITY DURING TEST"

ICV -- "INVALID CORRECTED VOLUME",

ITMP -- "INSUFFICIENT THERMISTORS IMMERSED"

IVOL -- "INSUFFICIENT VOLUME"

SHRT -- "TEST TOO SHORT"

PASS -- "TEST PASSED"

ALARM HEADER LINE

MSG/typ/tnk/m/ps/sen/mmddyyyy/hhmmss/mmddyyyy/hhmmss

MSG

Line Title

typ

Message Types: always 3 characters exactly (see table below)

tnk/m/ps/sen

Device Identification: tank number (0 to 999) / smart module (1 to 8) / module

position (1 to 16) / sensor type

mmddyyyy/hhmmss

Starting Date & Time of Alarm: month, day, year / hours, minutes, seconds

mmddyyyy/hhmmss

Ending Date & Time of Alarm: month, day, year / hours, minutes, seconds

SHOW REPORT SHOWING DATA IN VARIABLES

VAR/<arv>/<variable>/<index>/<data>

VAR

Line Title

<arv>

Association, Restriction, Version

Variable Name

<index>

Index of the Variable

Data Contained in the Variable: the quantity and type of fields included depend on

<data>

the particular variable type; note that fields of the same type are always the same

size, but different field types may have different sizes

205

SiteSentinel

SHOW REPORT SHOWING DATA IN VARIABLES

VRP/<arv>/<variable>/<index>/<tnk/m/ps/sen>/<data>

VRP

Line Title

<arv>

Association, Restriction, Version

Variable Name

<index>

Index of the Variable

Device Identification: tank number (0 to 999) / smart module (1 to 8) / module

position (1 to 16) / device type

Data contained in the variable: the quantity and type of fields included depend on

<data>

the particular variable type; note that fields of the same type are always the same

size, but different field types may have different sizes

WARNING HEADER LINE

WR1/typ/tnk/m/ps/sen/mmddyyyy/hhmmss

WR1

Line Title

typ

Message Type: always 3 characters exactly (see table below)

tnk/m/ps/sen

Device Identification: tank number (0 to 999) / smart module (1 to 8) / module

position (1 to 16) / sensor type

mmddyyyy/hhmmss

Starting Date & Time of Warning: month, day, year / hours, minutes, seconds

206

Appendices

SAMPLE REPORTS (Not all apply to both Model II and III)

SAMPLE TANK INVENTORY REPORT (INVP)

DESCRIPTION

DATA LINE

(`/' = data separator;

`.' = explicit decimal;

`-'

= blank space; `[CR][LF]' =

carriage return & line feed)

Report Header

INV/01021993/123456[CR][LF]

Measurement Header

MO1/F/--1/1/-1/--2/FFFFFFFF/01021993/123456[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

Measurement Header

MO1/F/--2/1/-2/--2/FFFFFFFF/01021993/123456[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

Measurement Header

MO1/F/--3/1/-3/--2/FFFFFFFF/01021993/123456[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

SAMPLE TANK INVENTORY REPORT FOR MANIFOLDED TANKS (INVP)

DESCRIPTION

DATA LINE

(`/' = data separator;

`.' = explicit decimal;

`-'

= blank space)

Report Header

INV/01021993/123456[CR][LF]

Measurement Header

MO1/F/--1/1/-1/--2/FFFFFFFF/01021993/123456[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

Measurement Header

MO1/F/--2/1/-2/--2/FFFFFFFF/01021993/123456[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

Measurement Header

MO1/F/--3/1/-3/--2/FFFFFFFF/01021993/123456[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

Group. Header

MO1/F/--0/1/-1/202/FFFFFFFF/01021993/123456[CR][LF]

Measurement Line #1

MO4/123456.123/123456.123/123456.123/----------/123456.123/-----

-----[CR][LF]

Measurement Line #2

MO6/123456.123/123456.123[CR][LF]

SAMPLE SENSOR LEVEL REPORT (INVS)

DESCRIPTION

DATA LINE

(`/' = data separator;

`.' = explicit decimal;

`-'

= blank space; `[CR][LF]' =

carriage return & line feed)

Report Header

INV/01021993/123456[CR][LF]

Measurement Header

MO1/F/--1/1/-4/--1/FFFFFFFF/01021993/123456[CR][LF]

Sensor Data

MO9/123456.123[CR][LF]

Measurement Header

MO1/F/--2/1/-5/--3/FFFFFFFF/01021993/123456[CR][LF]

Sensor Data

MO9/123456.123[CR][LF]

207

SiteSentinel

Measurement Header

MO1/F/--3/1/-6/--4/FFFFFFFF/01021993/123456[CR][LF]

Sensor Data

MO9/123456.123[CR][LF]

Measurement Header

MO1/F/--4/1/-7/--5/FFFFFFFF/01021993/123456[CR][LF]

Sensor Data

MO9/123456.123[CR][LF]

SAMPLE WARNINGS IN PROGRESS REPORT (WARN)

DESCRIPTION

DATA LINE

(`/' = data separator;

`.' = explicit decimal;

`-'

= blank space; `[CR][LF]' =

carriage return & line feed)

Report Header

WRN/01021993/120000[CR][LF]

Warning

WR1/HPL/--1/1/-1/--1/01021993/120000[CR][LF]

Warning

WR1/LPL/--2/2/-2/--1/01021993/120000[CR][LF]

Warning

WR1/SAL/--3/3/-3/--1/01021993/120000[CR][LF]

SAMPLE SENSOR, PROBE, INPUT, HARDWARE FAILURE REPORT (EVENT)

DESCRIPTION

DATA LINE

(`-'

= blank space; `[CR][LF]' = carriage return & line feed)

Report Header

ALR/01021993/120000[CR][LF]

Alarm Header Line

MSG/DEL/--1/1/ 3/--1/01021993/064552/01021993/075336[CR][LF]

Measurement Header

MO1/F/--3/1/-3/--2/FFFFFFFF/01021993/064552[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

Measurement Header

MO1/F/--3/1/-3/--2/FFFFFFFF/01021993/075336[CR][LF]

Measurement Line #1

MO2/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Measurement Line #2

MO5/123456.123/123456.123[CR][LF]

Delivery info.

M10/123456.123/123456.123/123456.123/123456.123/123456.123/12345

6.123[CR][LF]

Alarm Header Line

MSG/HSL/--1/1/-4/--1/12111992/134515/12151992/153723[CR][LF]

Measurement Header

MO1/F/--1/1/-4/--1/FFFFFFFF/01021993/123456[CR][LF]

Sensor Data

MO9/123456.123[CR][LF]

Alarm Header Line

MSG/IO1/--0/0/-0/200/12111992/134515/12151992/153723[CR][LF]

Alarm Header Line

MSG/PRB/--1/1/-1/--2/12111992/134515/12151992/153723[CR][LF]

Alarm Header Line

MSG/POW/--0/0/-0/200/12151992/150227/12151992/153614[CR][LF]

208

Appendices

K.5 Configuration Variables

K.5.1 INTRODUCTION

Most of the variables have a one-to-one correspondence with the entries on the menus. This section

explains the important differences between menu and command line operation.

K.5.2 SETTING THE VARIABLES

Change system configuration with the SET or SETV commands.

The SETV command combines the functions of the SET and SHOW commands. Variables are

associated with one of the following

G The controller

G A Smart Module

G A module position

G A manifolded tank group.

The <range> specification must be sufficient to identify the item associated with the variable (refer

to the section on range specification for details). Some variables also require an <index>

specification.

For example, the command `SET TIME=12251994/233000' sets the system date to December 25,

1994 and the system time to 23:30 (11:30 PM).

If there is an error in parsing or setting a variable, or in any of the fields within the variable, none of

the data for the variable is changed.

If a field is empty or not included, that field is not modified. It is not necessary to used "fixed format"

fields for data entry.

K.5.3 SHOWING VARIABLES

The SHOW command displays SiteSentinel data. A short report consisting of a <VPR line> or <VAR

line> for each instance of a variable is created.

<VRP lines> are used in variables requiring a <tank/m/ps/sen> specification, such as those associated

with a smart module, module position, or a manifold tank group.

<VAR lines> are used for variables that do not require a such specification.

When the SiteSentinel outputs data, the field formats and sizes are fixed according to field type (as

on other reports).

209

SiteSentinel

K.5.4 EXCHANGE VERSIONS

At the beginning of a session (that is, before performing any configuration or requesting any reports),

your program should send the computer interface version to the SiteSentinel using the VERSION

variable.

The version lets the program communicate with enhanced versions of the SiteSentinel.

If the version of your program is higher than that of the SiteSentinel, this command causes an error.

The VERSION variable is not the same as the EPROM version.

K.5.5 MODULE CONFIGURATIONS

Before you configure a smart module, reset all data. This makes sure you are starting from a known

point.

The INIT command initializes setup data for a module; for example, `INIT M1' initializes

configuration data for module #1.

Once a module is initialized, all previous configuration data associated with that module is lost.

The MOD variable assigns the module type; for example, the command string `SET MOD

M1=BAIR' assigns module #1 as a "smart" module.

At present, the smart module is the only type available.

K.5.6 POSITION CONFIGURATION

Before configuring a module position, reset all the data. This ensures that you are starting from a

known point.

The command INIT initializes setup data for a position; for example, INIT P1A initializes

configuration data for position #1A.

Once a position is initialized, all previous configuration data associated with that position is lost.

The POS variable assigns the position type; for example, the command string `SET POS

P1A=PROB' defines position #1A as being connected to a probe; the command string `SET POS

P3G=VSEN' defines position 3G as being connected to a vapor sensor.

The history buffer data assumes the type of device connected to the position If this data is changed,

previously stored data may be incorrect.

The command `CLRHST' clears the history buffer.

210

Appendices

If a smart module position has not been previously configured or if the device type has been changed,

the POSDAT variable must be initialized. If the position is assigned as a probe, the POSDEN and

POSTNK variables must also be initialized.

For example, the tank setup command string `P1A=3/DIESEL/SOUTH TANK' selects tank #3, sets

the product name to "DIESEL," and sets the description to "SOUTH TANK."

The command `SET POSDEN P1A=62.5' sets the API/density to 62.5EAPI (corrected to the base

temperature).

The command `SET POSTNK P1A=9528/98.5/CYLR/1.2/2.7/T' (English units enabled) sets the tank volume

to 9258.0 gallons, the tank diameter to 98.5 inches, the tank shape to cylindrical with round end caps,

the product offset to 2.7 inches, and indicates a water float is on the probe.

For example, the sensor setup command string `SET POSDAT P1A=5/DIESEL/WEST WELL' selects

sensor #5, sets the product name to "DIESEL," and sets the descriptions to "WEST WELL."

After device is assigned to a position and its data initialized, set the position state to CONF to

indicate the position is configured.

For example, the command string `SET POS P1A=/CONF' sets the state of position 1A to

"configured."

A manifold group can be defined for position on a module. Positions must be configured or installed

before assigning them to a group.

When a manifold group is defined, the common group data are copies from the first position in the

group to all other group positions.

Changing the product name, API/density, minimum theft, minimum sale, or minimum delivery value

for a single group member changes that parameter for the entire group.

For example, the command string `SET GRP G11=ABD' defines manifold group #1 on smart module

#1 to include positions A, B, and D.

The commands SET POSLIMP and SET POSMIN are used to set the thresholds for a probe.

For example, the command string `SET POSLIMP P1A=85.25/15.0/3.0' (English units enabled) sets the

overflow level to 85.25 inches, the low product level to 15.0 inches, and the high water level to 3.0

inches.

The command string `P1A=5.0/10000.0/10.0' (English units enabled) sets minimum theft volume to

5.0 gallons, minimum sales volume to 10000.0 gallons, and minimum delivery volume to 10.0 gallons.

For a sensor position, the command to set thresholds is SET POSLIMS. For example, the command

string `SET POSLIMS P3G=4.8/0.0/180' sets upper threshold to 4.8 volts, lower threhold to 0.0 volts, and

upper threshold alarms delay to 180 minutes.

211

SiteSentinel

A position must be installed before the SiteSentinel will generate reports. The command to install a

module is `SET MOD'.For example, the command string `SET MOD P1=/INST' installs module 1.

The command to install a position is `SET POS'; for example, the command string `SET POS 1A'

installs position 1A.

The command to enter tank correction data is SET POSCORP. For example, the command string

`SET POSCORP P1A=28.2/2.25' (English units enabled) sets the first correction entry (#2 on the menu)

to 28.2 gallons at 2.25 inches.

The following example is a program needed to configure module #1 with position A as a probe and

position B as a vapor sensor.

SET VERSION=1

INIT M1

SET MOD M1=BAIR

INIT P1A

SET POS P1A=PROB

SET POS P1A=0/ /

SET POSTNK

P1A=9528/98.5/CYLR/0.0/0.0/T

SET POS P1A=\CONF

SET POS P1A=\INST

INIT P1B

SET POS P1B=VSEN

SET POSDAT P1B=0/ /

SET POS P1B=/CONF

SET POS P1B=/INST

SET MOD M1=/INST

Set VERSION at the start of each session. Before configuring any position,. it should be initialized

and the type should be set.

Once a module has been intialized and its type have been set, it is not necessary to uninstall it to

configure additional positions.

The following example lists the commands needed to configure position C as a probe on module that

has previously been configured.

SET VERSION=1

INIT P1C

SET POS P1C=PROB

SET POSDAT P1C=0/ /

SET POSTNK P1C=9528/98.5/CYLR/0.0/0.0/T

SET POS P1C=/CONF

SET POS P1C=/INST

Once a position has been configured, it is not necessary to change the position state to modify most of the

variables associated with the position.

212

Appendices

K.5.7 CONSOLE VARIABLES (Not all apply to both Model II and III)

CONSOLE VARIABLES

VARIABLE

DATA <value> FORMAT

NAME

CONSOLE

Console protocol name: NONE; MICRA; MICRB; GENRB; PVA;TMS

;PV2A

Baud rate: NONE; 300; 1200; 2400; 4800; 9600; 19200;

Parity: NONE; EVEN; ODD;

Word length: N; 7; 8;

SYSTEM

'OPEN' open; 'CLOS' closed -- system state.

POSINTF

Console protocol name - NONE, SMITH, TIG, KIENZ, GILB, TMS or PV2

Baud rate - NONE, 300, 1200, 2400, 4800, 9600 or 19200

Parity - NONE, EVEN or ODD

Word length - N, 7 or 8 bits

PASSW

<word:8>/<word:8>/<TF>/<TF>

System password

Restricted password.

'T' enable; 'F' disable -- restricted mode.

'T' enable; 'F' disable -- Timed logout.

IDLE

'T' enable; 'F' disable -- idle graphs.

'LEV' level; 'VOL' volume; 'LV' level & volume -- graph type.

'TEXT' text; 'BAR' bar; 'TB' text and bar -- display mode

SYSID

<text:16>

System ID.

213

SiteSentinel

CONSOLE VARIABLES

VARIABLE

DATA <value> FORMAT

NAME

TIME

<time>

Current system time.

DATEFMT

'L' long; 'S' short -- date format

'SLAS' '/'; 'DASH' '-'; 'SPAC' space; 'NONE' -- separator

'NONE'; 'ZERO'; 'SPAC' space -- leading char

'MDCY' 'mmm dd, yyyy'; 'DMCY' 'dd mmm, yyyy';

'DMY' 'dd mmm yyyy'; 'DDMY' -- long date order.

'MDY'; 'DMY'; 'YMD' -- short date order

TIMEFMT

'12H'; '24H' -- 12 or 24 hour clock.

'COL' ":"; 'SPAC' space; 'NONE' -- separator

'NONE'; 'ZERO'; 'SPAC' space -- leading char

AM designator

PM designator

CONSOLE VARIABLES

VARIABLE

MAX

DATA <value> FORMAT

NAME

INDEX

DCD

DCD module state: NONE; INST; DOWN;

DCD display units: US (ft, gl, deg F); SI system international (metric).

DCDHDR

I0-I1

I0 -- First line of DCD printer header.

I1 -- Second line of DCD printer header.

214

Appendices

CONSOLE VARIABLES

<range>

DATA <value> FORMAT

VARIABLE

NAME

PTR

Printer type: NONE no printer; PV internal printer; EXT external printer.

'T' -- insert leading <FF>; 'F' no leading <FF>

'T' -- insert trailing <FF>; 'F' no trailing <FF>

PTRHDR

I0-3

<text:40>

I0 -- First line of printer header.

I1 -- Second line of printer header.

I2 -- Third line of printer header.

I3 -- Fourth line of printer header.

RPT

Starting <modpos> of menu selected reports.

Ending <modpos> of menu selected reports.

Starting time of menu selected reports.

Ending time of menu selected reports

Report order: SEQ - list in sequential order; TYPE - list by event type.

Output location: SCR - list report on screen; PTR - list report on printer

Report format on printer: LINE - Inline format; SCR - same as on screen.

View rate in seconds.

CONSOLE VARIABLES

VARIABLE

<range>

DATA <value> FORMAT

NAME

EVTIND

<event>

T/F - Print warning at start of event.

T/F - Sound buzzer at start of event.

T/F - Illuminate lamp at start of event.

T/F - Print message at end of event.

<event> -- Any individual event.

EVTWRAP

ON/OFF - Allow events to wrap around.

REFTEMP

15/20 - Volume Reference Temperature

215

SiteSentinel

CONSOLE VARIABLES

VARIABLE

<range>

DATA <value> FORMAT

NAME

OUT

I0-1

Activation type: DUR - activate for duration; EVER - activate until

terminated with button, menu selection, or OUT 2;TIME - for a programmed

period of time (OUT 1)

Activation duration in seconds (only when OUT 0 is TIME)

Current state of output: ON; OFF.

I0 -- Light.

I1 -- Buzzer.

BUTTON

Button terminates: NONE; LITE Output 0 (light), BUZZ Output 1 (buzzer),

BZLT Output 0 and 1 (both light and buzzer),

CONSOLE VARIABLES

VARIABLE

<range>

DATA <value> FORMAT

NAME

VERSION

<int:4>

Computer interface version that the "computer" is expecting.

DEFPOS

modpos to use on position setup menus. (Usually menu selection # 1)

UNITS

Measurement units: US (ft, gl, deg F); SI system international (metric).

PROTO

Default protocol: ASCI Ascii; PV; XMOD Xmodem; KERM Kermit; KER8 8-

bit Kermit.

Default file name.

TERMOPT

Use input flow control: T/F

Terminal type: ASCI ASCII; WY50 Wyse-50; VT10 VT-100; VT52 VT-52.

ASCII terminal are not useable with menus. If chosen, the "chose terminal

type" screen is displayed when returning to the menus.

216

Appendices

K.5.8 SCHEDULE VARIABLES (Not all apply to both Model II and III)

SCHEDULE VARIABLES

VARIABLE

<index>

DATA <value> FORMAT

NAME

SCHCHST

I0-15

Next time to clear history buffer

Frequency: CLR clear schedule entry; ONCE do once; DY every day; WK

every week; MO every month.

SCHOPEN

I0-15

0/1

time/frequency to open or close system.

OPEN; or CLOSE the system according to schedule.

SCHTLT

I0-15

0/1

time/frequency to perform timed leak tests.

First <modpos> to test.

Last <modpos> to test.

Leak test duration in minutes.

SCHSAV

I0-15

0/1

Time/frequency to save tank inventories.

First <modpos> to save.

Last <modpos> to save.

SCHWARN

I0-15

0/1

time/frequency to print warning report.

SCHEVNT

I0-15

0/1

time/frequency to print event report.

SCHINV

I0-15

0/1

time/frequency to print inventory report.

SCHDEL

I0-15

0/1

time/frequency to print delivery report.

217

SiteSentinel

K.5.9 POSITION VARIABLES (Not all apply to both Model II and III)

POSITION VARIABLES associated with a position

VARIABLE

<index>

DATA <value> FORMAT

NAME

POS

Position type: NONE; PROB probe; GSEN generic sensor; VSEN; LSEN;

SSEN; RSEN; FSEN; HSEN; WSEN.

Position state: NONE; ASG assigned; CONF configured; INST installed;

DOWN down.

POSDAT

<int:4>/<text:16>/<text:16>

Position number:

Product name

Position description.

POSITION VARIABLES - General

VARIABLE

<index>

DATA <value> FORMAT

NAME

POSTLT

<int:4>/<choice>/<float:R>/<TF>

Duration of non scheduled leak test in minutes.

Frequency: ONCE perform the test once; REPT repeat the test.

Leak threshold.

T - immediately start a timed leak test; F - immediately stop a timed leak

test.

POSLEAK

<float:R>

Leak rate threshold

POSACT

<float:R>/<int:4>/<int:4>/<int:4>/<int:4>/<int:4>

Activity rate: vol/min

Hist to use.

Debounce on.

Debounce on weight.

Debounce off.

Debounce off weight.

218

Appendices

POSITION VARIABLES (Associated with a Tank)

VARIABLE

<index>

DATA <value> FORMAT

NAME

POSTNK

<float:V>/<float:D>/<choice>/<float:D>/<float:D>/<TF>

Volume

Diameter

Shape: CYLF cylindrical with flat ends; CYLR cylindrical with flat ends; LIN

Straight sides.

Product offset.

Water offset.

Water float present: T/F

POSDEN

<float:F>/<float:T>/<TF>

API/Density.

Temperature API/Density was measured.

Correct for glass hydrometer: T/F

POSLIMP

<float:D>/<float:D>/<float:D>

Overflow.

Low product

High water

POSMIN

<float:V>/<float:V>/<float:V>

Minimum Theft

Minimum Sale

Minimum Delivery

POSCORT

I0-19

<float:D>/<float:V>

Level

Volume

I0 - first correction (menu # 2)

I19 - last correction (menu # 21)

POSITION VARIABLES (Associated with a Sensor)

VARIABLE

<index>

DATA <value> FORMAT

NAME

POSLIMS

<float:VT>/<float:VT>/<int:10>/<int:10>

Upper threshold

lower threshold

upper threshold delay to alarm

lower threshold delay to alarm

POSCORS

I0-19

<float:VT>/<float:F>

Reserved

219

SiteSentinel

K.5.10 GROUP VARIABLES (Not all apply to both Model II and III)

GROUP VARIABLES

VARIABLE

<range>

DATA <value> FORMAT

NAME

GRP

<word:16>

Manifold positions.

The positions in the group are specified by including the letter for that group

('A'-'P') in this field. Embedded spaces are NOT acceptable. Letters or

numbers outside the range of allowable positions are ignored; that is, the

following selects the group of positions 'A', 'B' and 'D': "ABD", "abd",

"ABzD", "DBA". The following are not acceptable: "AB D", "AB.D",

"ABD

On output, the letter 'Z' is substituted for all positions not in the group. I.E.

"ABZDZZZZZZZZZZZZ".

GRPDAT

<int:4>/<text:16>/<text:16>

Reserved

Product name

Reserved

GRPDEN

<float:F>/<float:T>/<TF>

API/Density.

Temperature API/Density was measured.

Correct for glass hydrometer: T/F.

GRPMIN

<float:V>/<float:V>/<float:V>

Minimum Theft

Minimum Sale

Minimum Delivery

K.5.11 MODULE VARIABLES (Not all apply to both Model II and III)

MODULE VARIABLES

VARIABLE

MAX

DATA <value> FORMAT

NAME

INDEX

MODUL

Module type: BAIR (smart module) is currently the only allowable value.

Module state: NONE; INST installed; DOWN.

220

Appendices

K.6 Data Formats

K.6.1 NUMBER FORMAT

See the table below. The SiteSentinel reports probe and sensor measurements using floating point

numbers rounded to three digits, and assigned 10-char fields. For negative values, a — precedes the

value. If the value is too large for the field, the value is rounded. If FAR too large, a blank field is

assigned.

ACTUAL VALUE

COMPUTER FORMAT

12345.123

-12345.123

1234567.891

1234567.89

12345678.901

12345678.9

123456789.012

123456789.

1234567890.123

1234567890

12345678900.123

K.6.2 LOGICAL VALUES

Logical values are represented by a `T' (for true) or an `F' (for false).K.6.3 TIME AND DATE

Time and date are represented in two adjacent fields. Format mmddyyyy/hhmmss.

SYMBOL

DEFINITION

RANGE

month

01 to 12

day

01 to 31

yyyy

year

1990 to 2089

hour

00 to 23

minute

00 to 59

second

00 to 59

K.6.4 SPECIAL TIMES

The following symbols define special times:

power up

00000000/000000

in progress

99999999/999999

not programmed

99999999/000000

221

SiteSentinel

K.6.5 STANDARD FIELD TYPES (Not all apply to both Model II and III)

STANDARD FIELD TYPES FOR REPORTS

mmddyyyy

Date of an Event: month, day, year

hhmmss

Time of an Event: hours, minutes, seconds

Units of Measure: F = English; T = Metric

tnk/m/ps/sen

Device Identification:

Tank Number (0 to 999) - label only

Smart Module (1 to 8) - specific hardware installation

Module Position (1 to 16) - specific hardware installation

Device Type (0 to ???) -

None

Fsensor

Generic sensor

Hsensor

Probe

Wsensor

Vsensor

Lsensor

200

SiteSentinel console

Ssensor

201

Smart Module

Rsensor

202

Manifolded Group

ffffffff

Flags: not implemented

dddddd.ddd

Measured & Calculated Data: floating point value; decimal point is explicit; if

the value is too large for the field, digits to the right of the decimal point are

rounded as necessary, negative values are preceded by a '-'

STANDARD FIELD TYPES FOR REPORTS

type

width

format

description

<float:t>

dddddd.ddd

Floating point value.

There are several types of floating point values

designated by the units of measure: F - generic; D

distance (inches or centimeters); V volume (gallons or

liters); T temperature (oF oroC); R rate (gallons or

liters per period of time); or, VT voltage.

222

Appendices

STANDARD FIELD TYPES FOR REPORTS AND VARIABLES

type

width

format

description

cccc

There is a list of choices for each field. The allowable

choices is dependent on the variable.

<TF>

cccc

The <TF> field type is the same as the <choice> field

type with the exception that the only two choices are:

'T' (true) or 'F' (false). There may be more choices in

future releases.

<time>

mmddyyyy/hhmmss

The time and date are treated as one field, even

(8/6)

though it contains a '/' that otherwise would be used as

a field delimiter. If either the time or date are

included, the other must also be included. If either the

time or date portion is blank, its value is defaulted to

the current time or date.

The modpos is used to specify module and position.

The 'm' is used to specify the module number and

could range from '1'-'8'. The 'p' specifies the position

and ranges from 'A'-'P'.

<int:n>

Unsigned integer value. The maximum allowable

number of digits and the field width is 'n'.

<word:n>

A word composed of up to 'n' letters ('A'-'Z') and/or

numbers ('0'-'9'). The letters are be converted to

upper case. Allowable combinations are: 'ABC123',

'12345678', 'ABCDEFGH'.

<text:n>

A text string not containing control characters or field

delimiters ('/'). The maximum length of the string

(including leading, trailing, and embedded spaces) is

'n' characters.

<arv>

arvs

The field is used to show some information about a

variable. The first character (a) shows variable

association: Console; Module; Position; or Group.

The second character (r) indicates the variables

restriction: Console; Module; Position; Group; Tank; or

Sensor. The third character (v) indicates the version

of the variable.

cccccccc

This represents the variable's name.

<index>

dddd

This field is used for indexed variables. If it is not

needed, it contains a value of zero.

tnk/m/ps/sen

<value>

This represents a group of values representing the

data contained in a variable.

The width is the field width when the field is output by the SiteSentinel. The format is used for output by

the SiteSentinel.

223

SiteSentinel

MESSAGE <event> TYPES

SYMBOL

DEFINITION

SYMBOL

DEFINITION

HPL

High Product Level

HSL

High Sensor Level

LPL

Low Product Level

LSL

Low Sensor Level

HWL

High Water Level

IO1

External Input #1

TMP

Temperature

IO2

External Input #2

TFT

Theft

PRB

Probe Failure

DEL

Delivery

MOD

Smart Mod. Failure

SAL

Sale

PRN

Printer Failure

TLT

Timed Leak Test

POW

Power Failure

INV

Saved Inventory

I/O MODULE VARIABLES

VARIABLE NAME

MAX INDEX

DATA <Value> FORMAT

IOMOD

I/O Module State;NONE;INST

Installed; DOWN

IOPOS

I/O Module State;NONE;INST

Installed; DOWN

IOPCONF

<int:4>/<text;16>/<text;16>

I/O Position number

Product name

I/O Position description

IOPSTAT

SHOW <IO position>/<event name>/<position>

I/O Module Ouput setup

DEEN - De-energize

ENER - Energize (it keeps going...and

going

)

IOEVOUT*

Event name: HPL, LPL, TMP, TFT,

DEL, SAL, TLT, HSL,

LSL, IOM, IO1, IO2,

PRB, MOD, PRN

I/O Module output setup

DEEN - De-energize

ENER - Energize

Position number associated with

event

* The syntax

name>/<position>FOR EXAMPLE: SHOW IOEVOUT P1E/HWL/P1C. For IOEVOUT The SETV commands

work the same as the SET command.

224

Appendices

When a command is received by the SiteSentinel, one of the following occurs:

Kermit Remote Host command line protocol:

G A <report> is sent to the host, showing the <command line> was successfully received and

interpreted OR

G An <error> packet is sent by the SiteSentinel. This indicates that the packet was received

correctly, but the <command line> could not be interpreted. Examine the error to determine

the cause of failure.

If a <command file> is used

G A successful file transfer that indicates all <command line>in the file were successfully

received and interpreted. This may immediately be followed by the SiteSentinel sending a

<report> to the host if one was requested OR

G An <error> packet goes to SiteSentinel telling you packets were received, but one <com-

mand line> could not be interpreted. Examine error to determine the cause of failure.

If ASCII or other protocols are used:

G A <report> is sent to the host, followed by a prompt, showing that the <command line> was

successfully received and interpreted OR

G An <error> is sent to the host, followed by a prompt. This indicates that the packet was

received, but the <command line> could not be interpreted. Examine error to determine the

cause of failure.

K.6.6 ERROR MESSAGES

Error messages are sent in one of several forms. If Kermit protocol is used, a Kermit error packet

is sent containing the error message. Once the protocol has been exited, the message is sent again

in a plain text form (either menu or command line). If ASCII or another protocol is used, the

message is sent in a plain text.

The format of the message depends on the <command file> in use:

G Error occurred in a command file:

<error #>','<line #>' '<system name>' '<ERROR>' -- '<error text> OR

G Error did not occur in a command file:

The <system name>, <ERROR>, and <error text> fields depend on the SiteSentinel version, and

language, being used. Programs attempting to interpret or recover from an error should use <error

#> and <line #> fields.

225

SiteSentinel

The <system name> is the product name ("SiteSentinel II").

The <ERROR> is the word "ERROR" in the language of choice.<error text> describes the error in

plain text.

If a <range format> is specified for a command that does not require a <range format>, it is

ignored.

If a <range format> is not specified, or specifies more than one tank or position for a

command that requires a single tank or position, the variable DEFPOS is used. This is

modpos that appears on the menus.

If there is any printable text following a <command line>, an error is generated.

Commands are split into three categories:

Reports. Inventory, show warnings, show events, tank chart, etc.

Commands dealing with variables. Set, initialize, examine, download information on, etc.

Miscellaneous. Hello (login), bye, do ram test, clear history buffer, pass-through, etc.

A <variable> is any user-adjustable item. It may be associated with a module, group, position,

schedule entry, or other entity within the SiteSentinel (for example, tank diameter or group position

string), or with the SiteSentinel itself (time and date, for example).

When set, the SiteSentinel checks the value entered and (if valid) sets the internal value.

K.6.7 OPERATING MODES

G MENU Mode. This is “normal” operation mode. This is the mode most non-programmers

will use.

G ASCII Prompt Mode. To enter, type "LI" at a suitable prompt. The SiteSentinel displays a

prompt. After you enter a command line, the command is performed, and then a new prompt

appears.

To exit, type "EXIT" at the prompt, or use (CTRL) (C).

G SERVER or REMOTE HOST Mode. To enter, send a Kermit "I" packet (or other packet

requiring server mode) at a suitable prompt.

The SiteSentinel enters Kermit server mode, then interprets the packet and contents. The

command is performed. The SiteSentinel will stay in server mode until you exit.

To exit, have the host send a Kermit "FINISH", "BYE", or "EXIT" packet; or, the user can

type one or more carriage returns without a Kermit packet; or, the user could type ctrl-C.

G COMMAND FILE Mode. Similar to SERVER mode, except that to enter, a Kermit "S"

packet is sent at a suitable prompt.The SiteSentinel enters Kermit server mode, then interprets

the packet and contents. The command is performed. The SiteSentinel will stay in server

mode until you exit.

226

Appendices

To exit, have the host send a Kermit "FINISH", "BYE", or "EXIT" packet; or, the user can type one

more carriage returns without a Kermit packet; or, the user could type ctrl-C.

A “suitable” prompt is either the "Terminal type" prompt or any menu selection prompt (using the

function MENU_SELECTION). When exiting any of the non-menu modes, the user is returned to

the "suitable prompt" that had been left. If it is a menu, the menu is redisplayed.

Typing (CTRL) (C) at any time returns you to a menu prompt, or to the terminal type request.

A standard timeout releases the line in any mode as well.

The host system can do one or more of the following:

G Replace the Entire User Interface. This is done by entering SERVER or Command Line

mode from the Terminal type prompt.

G Replace the User Interface with the Exception of Any Menu. Same as above. The

"DOMENU" along with a terminal emulator executes the SiteSentinel menu.

G Add Hot Key Features to Any Menu. The host system jumps out of the SiteSentinel menu

when a function key is pressed and jumps back into the menu when it is done.

A dynamic update is done by the host system by repeated interrogation of the SiteSentinel.

A graphics screen is entirely implemented on the host system.

227

SiteSentinel

Syntax Notes

RANGE SPECIFICATION

Many commands either require a range specification or use the range to limit the amount of information included in

a report.

<range>:

' '<range specifier>[<range>]

<range specifier>:

The <modpos range>, <index range>, and <event group> specifiers can be combined in any order.

<modpos range>:

'P'<mod><pos>['-'<mod><pos>]

'M'<mod>['-'<mod>]

'G'<mod><grp>['-'<mod><grp>]

The <modpos range> specifiers ('P', 'M', and 'G') are mutually exclusive and cannot be combined with one another. If multiple <modpos

range> specifiers are used in a single <range>, only the last <modpos range> specifier is used.

<mod>:

'1'-'8'

<pos>:

'A'-'P'

<grp>:

'1'-'8'

<index range>:

'I'<index>['-'<index>]

<event group>:

<event>

'SPIF'

(all spi and hfe events)

'SPI'

(all spi events)

'HFE'

(all hfe events)

'SIN'

(saved invetory)

<event>:

<spi events>:

'HPL' | 'LPL' | 'HWL' | 'TMP' | 'TFT' |

'DEL' | 'SAL' | 'TLT' | 'HSL' | 'LSL' |

'I01' | 'I02' | 'IOM' |

<hfe events>:

'PRB' | 'MOD' | 'PRN' | 'POW' |

228

Index

Alarm Setup example

Graphs: Smart Module

Alarms

Group variables

220

Events

Setup

33, 89

Hardware Failure Events report

119

Threshold delays

Hardware Test

36, 45

Alarms: Setup

Header, printed

Alpha Coefficient

High Water level, setting

Alpha, setting

High water timer

API

History Buffer, clearing

101

ASCII conversion table

153

ASCII protocol

193

I/O Module

Auto Logout

Configuration

Data menu

Backing up system

107

Device Level Summary

Battery

165

Graphs

Battery test

Hardware

Buzzer, termination

Installing/Removing

Introduction

Cable

3, 4

Setup

Cable/Conduit troubleshooting

172

Status Report

122

Clear History Buffer

126

I/O Module: Setup

Cold Average Temp

Idle Mode Graphs

Cold starts

32, 165

Idle Mode Setup menu

Command line format

194

Individual Events menu

120

Communication protocol

Interstitial Sensor

Computer access programs

189

Computer Protocol setup

Kermit protocol

190

Computer reports

106

Computer, external

Leading Page Form Feed

Configuration variables

209

Leak Rate, setting

Console variables

213

Leak Test, results

104

Controller Introduction

LEDs, for Troubleshooting

182

Controller Setup Menu

Liquid Phase Sensor

Corrections: Tank/Sensor

Liquid Sensor

Low Product level, setting

Data formats

221

Date, setting current

Manifolded Tanks

Delivery Timer

Measurement units, setting

Density coefficient

Menus

Diagnostics

Alarm Setup

Smart Module

178

Clear History Buffer

126

Voltages

179

Computer Reports

107

Dip Chart

92, 93

Controller Setup

Event History Buffer

Emulation software

150

Event Output Setup

EPROM Replacement

145

I/O Configuration

EPROM, Clearing Checksum Error

I/O Module Hardware

Event History

35, 44

I/O Module Output State

108

Event Output Setup menu

I/O Module Setup

Idle Mode Graph Setup

File Transfer Protocol

151

Individual Events

120

Flow Control

55, 193

Install/Remove Modules & Positio

78, 87

Freon Sensor

Main

Module Device Level Summary

Graphs

Module Position & Type

Types

116

Open/Close System

125

Graphs: I/O Module

Outline

Graphs: Idle Mode

Printer Setup

229

SiteSentinel

Probe & Sensor Configuration

Quick Reports

131

Probe & Sensor Diagnostic

Probe & Sensor Hardware Data . . . 95

Record Buffer

Protocol Options

Red Button/Light & Buzzer

Red Button & Light

Report data format

198

Report Output Setup

111

Reports

197

Reports

109, 129

Computer

106

Save Tank Inventory

128

Event

199

Scheduled Commands and Reports 123

Formats

156

Security

Hardware Failure Events

119

Smart Module

I/O Module Status

122

Smart Module Setup

Inventory report

198

Smart/IO Module Data

Output options

112

System Commands

101

Output setup

111

System Hardware Test

Protocols & Formats

151

Tank & Sensor Correction

Quick

131, 198

Tank & Sensor Data

Range settings

111

Tank & Sensor Thresholds

Sample

207

Tank Dip Chart

Sensor Levels

117, 161

Tank Manifolding

Sensor/Probe/Input Failure

163

Tank, Probe, Sensor Status Graph

116

Status

115

Time/Date Setup

Tank Inventory

Timed Leak Test

127

Tank Summary, Individual

157

Menus: Probe Configuration

Tank Summary, Manifolded

159

Menus: Red Button/Light/Buzzer

Terms

113

Menus: Sensor Thresholds

Timed Leak Test

104

Metric units

Types

109

Minimum Delivery, setting

Warnings In Progress . .

118, 162, 199

Minimum Sale, setting

Reports menu

129

Modem connections

150

Restoring system

107

Modem use

143

Restricted mode

Module Position

Module positioning & typing

Save Tank Inventory

105, 128

Module variables

220

Schedule variables

217

Security

35, 37

Opening/Closing system

125

Sensor

Operating modes

226

Configuration

59, 63

Overflow level, setting

Data menu

Diagnostics

Passthrough port

105

Liquid drying procedure

147

Passwords

Overview

PC connections

149

Thresholds

Position variables

218

Server mode

190

Printer

Setup

Paper replacement

185

Alarms

18, 33

Troubleshooting

184

Controller

Printer options

I/O Module

17, 33

Printer setup

Smart Module

17, 33

Probe

Site ID

Configuration

Smart Module

Data menu

Diagnostics

45, 96

Graphs

Failed Tolerence

Installing/Removing

Overview

Introduction

Temperature Differential

Setup

Timed Test

Specifications

Water/Temp Ratio

Controller

2, 3

Protocol, reports

151

Status Report

115

PV protocol

190

Sump Sensor

System State

101

230

Index

Tank

Activity test

Correction

Data menu

Diameter

Dip Chart

Inventory report

117

Inventory save

105

Manifolding

Shape

Thresholds

60, 72

Volume

Terminal, external

Thermistors, error message

104

Thresholds

Tank/Sensor

Upper/Lower, Vapor

Time, setting current

Time/Date Setup

35, 39

Timed Leak Test

102

Timed Leak Test report

104

Timed Leak Test, Scheduled

127

Trailing Page Form Feed

Troubleshooting

167

Vapor Sensor

Volume Change line

157

Volume Conversion Tables

Volume Reference Temperature

Warnings in Progress report

118

Water Float

Worksheet, setup

133

Wraparound, buffer

Xmodem protocol

193

XON/XOFF

231

European Compliance

DEVICE

AGENCY

STANDARDS

MARKING

CERTIFICATE

NUMBER

Model 924

BASEEFA

EN 50014 (1997) +

BASEEFA03ATEX0349X

Probe

Amds 1 & 2

EN 50020 (2002)

II (1) G

(See below for Conditions

EN 50284: 1999

of Safe Use)

EEx ia IIA T4

Model 4323

BASEEFA

EN 50014 (1997) +

BASEEFA03ATEX0348X

Intrinsically

Amds 1 & 2

Safe Module

EN 50020 (2002)

II (1) G

(See below for Conditions

of Safe Use)

[EEx ia] IIA

BASEEFA03ATEX0349X Conditions of Safe Use:

1.) The apparatus enclosure may contain light metals. The apparatus must be

installed in such a manner as to eliminate the risk of impact or friction with

other metal surfaces.

2.) Items of the apparatus are made of plastic. The apparatus must not be installed

in a position where it may be subjected to an excessive air/fluid flow or be

subjected to rubbing that may cause an electrostatic build- up.

BASEEFA03ATEX0348X Conditions of Safe Use:

1.) When installed, the terminals must be afforded a degree of protection of at

least IP20.

SiteSentinel Automated Monitoring System Model 2 and Model 3. Operator Manual Software Version 1.12CUS - part 4