Professional Documents
Culture Documents
Part 3 11 Deliverycontrolapplicationv1.06
Part 3 11 Deliverycontrolapplicationv1.06
WORKING GROUP
PROPOSAL
PART III.11
DELIVERY CONTROL
APPLICATION
V1.06
Page 2
The content (content being images, text or any other medium contained within this document which is
eligible of copyright protection) is Copyright © IFSF Ltd 2011. All rights expressly reserved.
You may print or download to a local hard disk extracts for your own business use. Any other
redistribution or reproduction of part or all of the contents in any form is prohibited.
You may not, except with our express written permission, distribute to any third party.
Where permission to distribute is granted by IFSF, the material must be acknowledged as IFSF copyright
and the document title specified. Where third party material has been identified, permission from the
respective copyright holder must be sought.
You agree to abide by all copyright notices and restrictions attached to the content and not to remove or
alter any such notice or restriction.
Subject to the following paragraph, you may design, develop and offer for sale products which embody the
functionality described in this document.
No part of the content of this document may be claimed as the Intellectual property of any organisation
other than IFSF Ltd, and you specifically agree not to claim patent rights or other IPR protection that
relates to:
any design or part thereof that embodies the content of this document whether in whole or part.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 3
AUTHORS
This document is written by the Delivery Control working group, September 1996
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 5
TABLE OF CONTENTS
0 RECORD OF CHANGES ..................................................................................................................................................................... 6
1 GENERAL ............................................................................................................................................................................................. 7
1.1 DEFINITIONS AND ABBREVIATIONS ................................................................................................................................... 7
1.2 INTRODUCTION TO THE DELIVERY CONTROL PROTOCOL .......................................................................................... 5
1.3 FILLING OPERATION ................................................................................................................................................................. 6
1.4 FILLING BY LEVEL/VOLUME .................................................................................................................................................. 6
1.5 CLASSIFICATION OF THE TANK LORRY DEVICE ............................................................................................................. 6
1.6 DELIVERY CONTROL PROTOCOL: STATUS DESCRIPTION ............................................................................................ 7
2 INITIALIZATION OF THE DELIVERY CONTROL ....................................................................................................................... 7
2.1 STARTING OPERATION OF THE DELIVERY CONTROL: INITIALIZATION .................................................................. 7
2.2 CONFIGURATION ....................................................................................................................................................................... 8
2.3 COMMUNICATION RELATION ................................................................................................................................................ 8
2.4 SPECIAL OPERATING STATES ................................................................................................................................................ 8
2.5 CHECK DIAGRAM ....................................................................................................................................................................... 8
3.1 EVENT DESCRIPTION ............................................................................................................................................................... 9
3.2 COMMUNICATIONS ................................................................................................................................................................. 12
3.3 MAIN STATE .............................................................................................................................................................................. 12
4 STATES ............................................................................................................................................................................................... 13
4.1 STATE DIAGRAM ...................................................................................................................................................................... 13
4.2 STATE TABLE ............................................................................................................................................................................ 14
4.3 STATE DESCRIPTION .............................................................................................................................................................. 15
4.3.1 INOPERATIVE [1] ............................................................................................................................................................... 15
4.3.2 CLOSED [2] .......................................................................................................................................................................... 16
4.3.3 IDLE (SET-UP) [3] ............................................................................................................................................................... 14
4.3.4 OPERATIVE[4] .................................................................................................................................................................... 18
4.3.5 FILLING [5] .......................................................................................................................................................................... 19
4.3.6 FILLING BY THE LEVEL/VOLUME [6] .......................................................................................................................... 22
5 DELIVERY DATA BASE .................................................................................................................................................................. 23
5.1 GENERAL .................................................................................................................................................................................... 23
5.2 DATA BASE OVERVIEW ......................................................................................................................................................... 24
5.3 OBC DATA BASE ADDRESSING ............................................................................................................................................ 24
5.4 FIELD FORMATS ....................................................................................................................................................................... 25
5.5 MAIN ............................................................................................................................................................................................ 26
5.6 MANUFACTURER CONFIGURATION .................................................................................................................................. 36
5.7 SYSTEM CONFIGURATION .................................................................................................................................................... 37
5.8 ERROR CODES ........................................................................................................................................................................... 39
5.9 DATA DOWNLOAD ................................................................................................................................................................... 41
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 6
0 RECORD OF CHANGES
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 7
1 GENERAL
The petrol stations are refilled, upon needs, by the tank lorry. The tank lorry may have many compartments and several hoses for
the discharge, that could be computerized. If suitable sensors are installed into tank compartments, density and temperature may be
measured and processed. The tank lorry on board computer (OBC) will be the key factor that processes all discharge information
and parameters.
The safe discharge of the product is under the responsibility of the lorry driver, who will use various electronic or mechanical
devices (grounding of the tank lorry, preventing of the overfilling, filling of the wrong product into a tank*, vapour recovery nozzle,
etc).
In some delivery control system a filling devices updates the OBC with the tank identification number and the product grade.
The discharge operation may be executed in a known mode, in the sense that the OBC knows in advance only the products and
the volumes to discharge for any petrol station and even, in some cases, for each buried tank.
The refilling may be executed, however, in a blind mode, in the sense that the OBC will monitor the discharge transmitting and
receiving data and information to and from the petrol station.
Any petrol station must have as fixed component of the bus a communication node which performs data exchange, adhering to
IFSF standard, in a wire-bound or in a wireless form.
The OBC will be in such way directly connected to the communication bus of the service station, allowing mutual direct exchange
of the available data.
Even the filling by level/volume of any tank of the petrol station can be automatically followed by the tank lorry OBC through the
tank gauge system of the station.
The OBC, the petrol station console (PSC) the tank gauging level (TLG) and the other IFSF devices on the station bus have to be
considered as independent systems:
The PSC will continue to follow the station operation while the OBC is making the product discharge; the OBC will follow the
safety discharge and request the product level and sale data to the PSC, as well as the OBC may also request tank levels directly to
the tank gauging system (TLG) of the petrol station through the station bus.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 8
At the discharge end the OBC will sent discharge data to the station bus.
* for ex.: a tag device on the station tank inlet may send an encoded message to the tank lorry OBC using the concept of the
parasitic power.
The filling operation will be driven by the tank lorry OBC according to the order.
During the filling operation many control will be performed by the OBC, by the TLG and by the PSC:
- in case of excessive filling the TLG itself raises an alarm asking to stop the filling operation;
- during the discharge operation, the TLG will provide the OBC with the current values of the available space in the involved tanks.
The relevant information to make possible the above operations can be performed only if communication will be established
between the OBC and the station node and so on.
Filling of the petrol station tanks by the level/volume refers to the filling level/total volume reference list of the tank gauge. The
process of filling by the level/volume takes place by repeated delivery of specified quantity of product required to the tank lorry
with evaluation by the tank gauge (TLG); the TLG checks the filling operation and informs the OBC and the PSC about the
quantity to be filled and gives the tank designation.
The PSC notify the variable “Tank_Status” in accordance with and makes it available to the OBC after that the connection with has
been established. The filling is then carried out with the supervision of the petrol station staff specialist. In other words the TLG
notifies the quantity to be filled in.
Delivery stop take place in the same way as for the normal delivery.
The basic functionality is determined by the present state of the european and national rules and by the state of the art.
The petrol station may determine further functionality of the device by reading out the list of the names of the associated variables.
- basic functionality:
preconfiguration of the device at manufacturer‟s works
ensuring also of a paperless delivery voucher (sealed parcel), depending upon the country
- options:
ensuring protection from mixing
support filling of buried tanks by the level/volume
download of programs and configuration data
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 10
IFSF
Delivery Control
Loading Tank
Compartments
Truck sealing
system
Transfer loading
information to the
OBC
Transfer data to
Depot or Company
system
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 11
3.1 CONFIGURATION
The petrol station uses external configuration data determining the delivery functions. Configuration of the device is possible only
in the function state “INOPERATIVE”. The basic configuration pertain the initial or first installation of the device.
4 CHECK DIAGRAMM
Transmission active
Discharge active
Discharge stop
Discharge terminated
4.1
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 12
EVENT DESCRIPTION
‘EVENT_DESCRIPTION’ = internal event.
„EVENT_DESCRIPTION‟ = external event (controller device).
„***‟ = all other events/commands which are not included in the list.
The Data_Id is an unique identifier for a data element in a data base. The data base is defined by the data base address “DB_Ad”
(for details see document “Part II, Communication Specification”).
In the second column the name of the data element is defined. In this column is also the description of the data element.
The field types in the column three are described in chapter 0, page 25 of this document.
The “Read/Write in state” column indicates if the related data can be Read and/or Written by any device and which OBC state
(states are indicated between brackets). The following notations can be used:
The “M/O” column (Mandatory/Optional) indicates if the data element must be supported/implemented by the OBC and any
controller devices controlling the OBC. “M” indicates that the data element must be supported, “O” indicates that the data element
is optional.
NOTE: All mandatory data elements must be supported/implemented for a device to be IFSF compatible and pass the
certifications.
The fields from 200 up to 255 of each data base are free to use by the manufacturer or the oil company.
4.2 COMMUNICATIONS
Independent to the state that the OBC is located, the OBC must respond always to all communications (read, write instructions and
commands) from the controller device.
Please note that the OBC will evaluate the write messages from left to right (compliant the IFSF STANDARD FORECOURT
PROTOCOL, PART II) and verify/validate all the data fields up to the first command field (included). All the data and command
fields after the first command field will be rejected either with „1 - Invalid value (too big / too small / not accepted)„ or „6 -
Command not accepted‟. In case no validation/consistency error is detected within the first part (up to the first command field),
than the first command will be executed. Meaning also, if any data field preceding the first command is rejected (Data
Acknowledge Status = 1, 3, 5 or 6), the command will not be executed, but however the valid data elements will be stored in the
database.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 13
STATES
2
IDLE INOPERATIVE
[3] [1]
3
1
2
CLOSED
10 [2]
11
4
5
OPERATIVE
[4]
9 11
6
7
PROCESSING
(FILLING)
[5] 11
8
POCESSING
(BY THE L/V)
[6] 11
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 14
STATE 1 2 3 4 5 6
EVENT INOPERATIVE CLOSED IDLE OPERATIVE FILLING FILLING BY
THE
LEVEL/VOLUM
INOPERATIVE # 1 1 1 1 1
OPERATIVE 2 # # # # #
DEL. STARTED - 4 - - - -
OBC.CONNECTED - - - 4 4
DEL. ACCEPTED - - - 5 4 4
IDLE(SET-UP) 3 3 - - - -
ACTIVATE - - # - - -
RESTART - - 1 - - -
EXIT IDLE - - 1 - - -
OPERATIVE - 4 - - -
DEL: REJ/COM - - - - 2 2
CON. ABOLISHED - - - - 4 4
STOP DISCH. - - - - 4 4
TERMINATE - - - 2 4 4
MAJOR ERROR # 1 1 1 1 1
MINOR ERROR # # # # 4 #
*** (OTHER) - - - - - -
Description:
# No state change.
n State change to n.
- Not applicable (state error).
NOTE: When an event occurs which puts the system in an inoperative state and this event is not defined in the document,
then the application must move or stay in the state which is defined in the 'INOPERATIVE' event. The above
defined 'INOPERATIVE' event (which is not defined in the state descriptions) should be considered as an
emergency break or fall back event.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 15
STATE DESCRIPTION
INOPERATIVE The OBC is in the INOPERATIVE state when it is not possible to function. The reason for
this is that essential operational data is missing or a major error has been detected. The OBC is
also in the INOPERATIVE state after a system boot and after an exit from the IDLE state.
While in the INOPERATIVE state the OBC should continuously run a self test to establish if
the device is still inoperative or if the device has been configured to allow it to operate.
EVENT DESCRIPTION
OPERATIVE When the OBC have been configured with the essential data to operate and no major errors are
detected, the OBC goes to the CLOSED state.
Action: The OBC sends the unsolicited data OBC_Status and OBCEC_ErrMsg1.
MINOR ERROR If a minor error event occurs, the OBC stays in the INOPERATIVE state.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 16
STATE DESCRIPTION
CLOSED The OBC is completely configured and no major error has been detected. In this state, the OBC
is ready to operate, but, the OBC will not perform any delivery operation.
EVENT DESCRIPTION
IDLE When the OBC_Set-Up command is received from a controller device, the OBC moves into
the IDLE state.
Action: The OBC sends the unsolicited data OBC_Status and OBCEC_ErrMsg1.
MINOR ERROR If a minor error event occurs, the OBC stays in the CLOSED state.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 17
5.3.3 IDLE[3]
STATE DESCRIPTION
IDLE The OBC is put into the IDLE state as a result of a OBC_SetUp command issued by the
controller device.
The IDLE state allows the controller device to write to the following data bases:
- OBCSC (SYSTEM CONFIGURATION)
- OBCDD (DATA DOWNLOAD)
- OBCEC (ERROR CODES)
EVENT DESCRIPTION
ACTIVATE When the OBCDD_Activate command (Data Download data base) is received from a
controller device, the OBC is forced activate and verify (when necessary) the downloaded data.
Action: Before rebooting the system, the OBC must change the state to INOPERATIVE
and sends the unsolicited data OBC_Status.
EXIT IDLE When the OBC_ExitIdle command is received from a controller device, the OBC moves into
the INOPERATIVE state.
Action: The OBC sends the unsolicited data OBC_Status and OBCEC_ErrMsg1.
MINOR ERROR If a minor error event occurs, the OBC stays in the IDLE state.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 18
STATE DESCRIPTION
OPERATIVE In this state the OBC is waiting for a tank lorry to perform the delivery operations. Once a
delivery operation has been started, the OBC will follow the delivery operation up to the
completion.
In case of the filling by the level/volume event, then the OBC device should in this state
automatically enable the delivery by this mechanism.
EVENT DESCRIPTION
DELIVERY When no error occurred, the OBC moves into the OPERATIVE state.
STARTED
Action: The OBC sends the unsolicited data OBC_Status.
TERMINATE When the OBC_Terminate command is received from a controller device, the OBC is forced
to cancel the current operation, stop any operation follow-up (if applicable) and to move into
the CLOSED state.
Action: When the operation follow-up has been executed (if applicable), the OBC sends
the unsolicited data OBC_Status.
MAJOR ERROR If a major error event occurs, the OBC stops the delivery operation (if applicable, wait until it is
stopped externally) and moves into the INOPERATIVE state.
Action: When the operation has been stopped (if applicable), the OBC sends the
unsolicited data OBC_Status and OBCEC_ErrMsg1.
MINOR ERROR If a minor error event occurs, the OBC ejects the bank note (if applicable, wait until it is
removed) and stays in the OPERATIVE state.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 19
STATE DESCRIPTION
PROCESSING Check connection
The OBC will move to this state after that communication connection with the petrol station
has been established. The connection will be estabilished as soon as one of the following
switches will become active (on):
a) tank shutter switch is enabled by opening the tank lorry meter compartment door;
or
b) the first hose junction between a tank compartment of the tank lorry and the filling/vapour
rec. socket of the buried tank has been estabilished.
or
c) any other.
Connection estabilished
The OBC supports the communication protocol;
Action: the OBC sends. to the station node the function state “OBC_Connected”.
Electrical connection
The tank lorry does not have an OBC or the petrol station does not support the tank
lorry available protocol.
EVENT DESCRIPTION
OBC CONNECTED The OBC node reaches this condition when the connection with the PSC/TLG has been
succesfully made and until the the discharge has been completed.
After that the connection has been made the OBC and the PSC must ensure that the time-
critical condition are met until the end of the filling operations.
The OBC checks whether the right petrol station has been stopped at.
Upon a discharge operation completed, cheks will be made for the total order “Completely
_executed”. In case an additional discharge will be initiated.
For an invalid connection, the OBC waits until it is removed and moves into the OPERATIVE
state.
Action: When the invalid connection has been removed, the OBC sends the unsolicited
data OBC_Status.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 20
DELIVERY The tank lorry has stopped at the right petrol station.
ACCEPTED The petrol station is ready to accept the delivery:
The tank lorry has been notified that the hose connection between the lorry compartment and
the right tank has been estabilished in accordance with the ordered quality.
The station node driven by the PSC or by the TLG enters the function “Ready_for
_discharge”.
When a delivery accepted is recognised, the OBC moves into the FILLING state.
Action: The OBC sends the unsolicited data OBC_Status and OBC_Info.
DELIVERY Change in function state may happen for:
REJECTED/COMPL - Tank lorry stopped at wrong station;
ETED - Filling was rejected by the PSC;
- The tank lorry has executed the order totally or partially;
- Safety reasons interrupted the delivery.
- The PSC send the function state “Tank_lorry_may_leave_the_petrol_station”
When a delivery rejected/completed is recognised, the OBC moves into the CLOSED state.
Action: The OBC sends the unsolicited data OBC_Status and OBC_Info
READY FOR The PSC receives the information Report “Tank_Delivery” to unambigously address the due
DISCHARGE tank variable. The PSC then send the variable “Space_Available” for nornall filling or filling
by level/volume and additionally the variable “Gross specified volume”.
At the end the PSC writes the variable “Tank_Status”.
PERMITTED The petrol station and the tank lorry are ready for discharge.
DISCHARGE The OBC enters the function state “Discharge active”
NON-PERMITTED The petrol station or the tank lorry are not ready for discharge.
DISCHARGE The station node driven by the TLG or by the PSC enters the function state “Discharge stop”
The tank lorry OBC continously monitors an eventually stop request made by the PSC.
STOP DISCHARGE Filling is stopped by the tank lorry when:
The delivery to the specified tank has been completed;
The delivery for the connected tank compartment has been executed;
The tank compartment becomes empty;
The presetting and filling by the level/volume has been complied with;
The tank lorry discharge protection has answered;
HiHi level alarm warns from the tank gauge;
Other safety device from the tank lorry have send alarm messages;
PSC requires an emergency stop;
The available room has been exceeded, because the values from the tank gauging
are not plausible;
Data transmission between the devices are disturbed.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 21
CONTINUE Change of the function state may happen for.
DISCHARGE a non permissible discharge is invalid;
filling of the connected tank by the level/volume is continued;
filling of the tank beyond the order is requested;
The station nodes driven by the PSC sends the request “Ready_for_discharge”
TERMINATE Terminate discharge
The filling will be terminated for:
The PSC dictates the discharge termination into a tank;
The tang gauge TLG has triggered the HiHi level alert;
Filling by the level/volume is completed;
The delivery order has been executed or the tank compartment is empty;
Lack of safety requires the discharge stop;
The function “Discharge terminated” will become active:
Discharge terminated
The tank lorry or the petrol station have terminated the discharge operations.
The PSC may finally read the final level of the buried tank and will be notified by the OBC of
the delivered product quantity.
At that point in time, the connection between the OBC and PSC may be truncated.
When the OBC_Terminate command is issued, the OBC moves into the OPERATIVE state.
CONNECTION Any connection between the tank compartement and the station tank will be abolished.
ABOLISHED Transition to the function “OPEN” status will take place.
Interruption of the sole hose connection
Action: Whether the sole connection to the tank lorry was interrupted the state emigrates
versus the function “Check_connection”.
TANK LORRY Communication between the OBC and PSC is no longer required. The tank lorry may leave the
LEAVES THE petrol station.
PETROL STATION
Action: When the communication has been removed, the OBC sends the unsolicited data
OBC_Status.
MAJOR ERROR If a major error event occurs, the OBC waits until it is removed and moves into the
INOPERATIVE state.
Action: The OBC sends the unsolicited data OBC_Status and OBCEC_ErrMsg1.
MINOR ERROR If a minor error event occurs, the OBC waits until it is removed and move into the
OPERATIVE state.
Action: The OBC sends the unsolicited data OBC_Status and OBCEC_ErrMsg1.
*** In case of a command is sent which is not included in this event description, the command will
be rejected and the OBC stays in the same state.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 22
STATE DESCRIPTION
PROCESSING In this state the OBC will wait for instruction to start filling:
with specified values from the PSC
or
filling by the level/volume
EVENT DESCRIPTION
When this special filling will be issued the OBCwill wait for special instruction by the
PSC/TLG and the events will take place exactly as per the FILLING [5] case..
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 23
6.1 GENERAL
This part of the document details the standard data organisation for a Tank Lorry Delivery Application.
Every data element in the Tank Lorry Delivery data base is described in this chapter. The access to the data element is done by a
Data Base Address “DB_Ad” and a Data Identifier “Data_Id”.
The Data_Id is an unique identifier for a data element in a data base. The data base is defined by the data base address “DB_Ad”
(for details see document “Part II, Communication Specification”).
In the second column the name of the data element is defined. In this column is also the description of the data element.
The field types in the column three are described in chapter 0, page 25 of this document.
The “Read/Write in state” column indicates if the related data can be Read and/or Written by any device and which Tank Lorry
Delivery state (states are indicated between brackets). The following notations can be used:
The “M/O” column (Mandatory/Optional) indicates if the data element must be supported/implemented by the Tanl Lorry
Delivery and any controller devices controlling the Tank Lorry Delievery. “M” indicates that the data element must be supported,
“O” indicates that the data element is optional.
NOTE: All mandatory data elements must be supported/implemented for a device to be IFSF compatible and pass the
certifications.
The fields from 200 up to 255 of each data base are free to use by the manufacturer or the oil company.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 24
OBC_ID
MAIN
OBCMC_ID MANUFACTURE
CONFIGURATION
OBCSC_ID SYSTEM
CONFIGURATION
OBCEC_ENTRY ERROR_ID
ERROR CODE
OBCDD_ID DATA
DOWNLOAD
The following data bases must be stored in non volatile memory (the data may not be lost after a power down):
- Manufacturer Configuration.
- System Configuration.
- Error Codes.
NOTE: In case the „Communication Service‟ data base is stored in volatile memory, then the Tank Lorry Delivery must
send during the system boot a broadcast heartbeat2 message with bit 1 (configuration needed) of the
DEVICE_STATUS set. Also, the Tank Lorry Delivery must wait at least 8 seconds3 before moving from the
INOPERATIVE state to another state. This to give a controller device time to set-up the communication service
data base.
1
The maximum number is defined by the manufacturer
2
Ref.: Standard Forecourt Protocol, PART II, Communication Specification.
3
Ref.: Standard Forecourt Protocol, PART II, Communication Specification.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 25
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 26
6.5 MAIN
This database provides access to the OBC ID. This access to the main database is done by the database address OBC_ID
1 = INOPERATIVE
2 = SET-UP
3 = IDLE
4 = ASSIGNED
5 = BUFFER FULL
6 = RELEASING
5 FPR_StationState Bit16 R(*) M
Used to indicate the state of the sub device and paper.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 27
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
21 Tank_status Bit16 R/W M
Describes the tank lorry function required by the PSC
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 28
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
22 Tank_Config Bit16 R/W M
Describes the technical device of the tank lorry
23 Filling_Protection. 0 - 99999 R O
Describes the filling protection option for the OBC/PSC.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 29
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
24 Petrol_Station_St Bit8 R/W M
Describes all petrol station function required by the tank
lorry.
bit 0 on OK_Discharge
All tank compartment ready for
discharge
bit 1 on Trans_In_Prog
. Active when discharge takes place
bit 2 on Faucet_Guard_Bar_St
All valve locked
bit 3 on Sealed_Parcel_Ok
In all tank compartments, the
gauged volume loaded is
complete
bit 4 on Tamper_Warning
Indicate violation of one of the
criterions of tampering for tank
compartment
bit 5 on Order_Completed
Indicate that the delivery for the
petrol station is completed
bit 6 on Cops_Warning
Alarm the mixing danger for one
delivery hose ???
bit 7 on Vapour_Recovery_Warn
. The vapour return hose present a
mulfunctioning
bit 8 on OBC_St_Fail
The OBC does not operate properly
bit 9 on Tractor_Trailer_Con
Indicate the state of the connection
between the tractor and the trailer
bi1 10 on Tank_Gauge_Protection
The tank lorry OBC request the
tank gauge assistence for operating
discharge protection
bit 11on Tank_Gauge_Disc._Def.
Indicate problems connected with
the data tank-gauging and whether
tank gauge monitoring has been
required, the delivery must be
stopped or not started.
bit 12.15 free
25 Compart_num Bit16 R M
Number of compartments in the tank lorry
26 Volume_Num Bit16 R M
Number of volume meters in the tank lorry
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 30
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
27 Change_St Bit4 R/W M
Command to change of the status of the reuter
communication device.
00 = terminate
01 =deactivate
10 = set idle state
11 = close
28 Free
Position free for the customer.
50 Truck_Com Asc10 R O
Truck Company
51 Truck_Haul Asc10 R O
Truck hauler id.
52 Tractor_Id Asc16 R O
Identification of the truck; read from truck mounted tag
on arm coupling into black box
53 Driver_id Asc10 R O
Identification of the driver
54 Comptm id Asc10 R O
Compartment identification; read on truck mounted tag
on arm coupling, into black box
55 Product id Asc10 R O
Identification by arm???
56 Prod Litres @ Ambient Asc10 R O
Meter pulses counted by measurements device
57 Prod Litres @ 15° Deg C Asc10 R O
From W&M device
58 Prod temp Asc10 R O
59 Prod mass Asc10 R O
60 Prod weight Asc10 R O
61 Prod density Asc10 R O
62 Batch id Asc10 R O
Generated by system
62 Date Asc10 R O
Of loading
63 Time Asc10 R O
End of loading
64 Meter id Asc10 R O
65 Terminal id Asc10 R O
66 FRT_DType Byte R/W M
This Data_Id is used to select the data type to be printed
(see also FPRMC_DType).
67 FPR_Font Byte R/W M
This Data_Id is used to select the font (see also
FPRMC_Font).
68 FPR_DfltData Byte R/W M
This Data_Id is used to select the default data buffer to
be printed. The range is from 1 to 4 (see also
FPRSC_DfltDataX, 1 = data of field 1 of the FPRSC
data base).
69 FPR_Data Xbyte R/W M
This Data_Id is used to write the data to be printed to the
printer station(s). The controller device can write from 1
to 255 characters/bytes of printable data. The PRT is
responsible for automaticaly handling line returns where
the data is longer than the printer width.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 31
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
70 Digits_Unit_Price Bcd2 R(1-9) O
W(1-2)
Configure layout of the Unit Price field.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 32
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
71 Tank_Status Bit8 R/W M
The variable is generated by the PSC according to the
tank status
Bit 0 on Ok_To_Disch.
Permission to filling the indicated
tank
bit 1 on HI_HI_Level_Alarm
The maximum allovable level has
been reached
bit 2 on HI_Level_Alarm
The maximum allovable level is
quite reached
bit 3 on Lo_Level_Alarm
The minimum allovable level is
(nearly) reached
bit 4 on Delivery_Request
Made request or heach tank
bit 5 on Exceeding_Permitted
Permission to fill beyond the
delivery quantity
bit 6 on Filling_by_Level/Volume
Tank lorry OBC requires that the
tank will be filled by the
level/volume
bit7 on Filling_by_Level/Volume
The tank lorry OBC fills the tank
by the level/volume
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 33
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
81 Compartment_Status Bit16 R M
The variable is generated by OBC according to the tank
compartment status
The field is a structure consisting of:
Specification of variable
“Tank_Compartment_Status”
Bit 0 on OK_Discharge
The tank compartment is ready for
discharge
bit 1 on Trans_In_Prog.
Active when discharge takes place
from the indicated compartment
bit 2 on Discharge_Stop
bit 3 on Discharge_Finished
bit 4 on Sealed_Parcel_Ok
The tank compartments still contains
the complete volume filled by the
level/volume
bit 5 on Tamper_Warning
Indicate violation of one of the
criterions of tampering for tank
compartment
bit 6 on Manual_Entry_Of_Qty
Indicate that the tank quantity was
inserted manually
bit 7 on Compartment_Empty
Alarm that tank compartment is
empty
bit 8 on Preset_Value_Reached
Active when product is filled by
level/volume
bit 9 on Discharge_Beyond_Order
bit 10 on Tamper_Warning
Active when the discharge hose is
connected to tank containing other
product
bit 11 on As_Warning
Active when discharge
protection will be activated during
filling
bit 12 on Ass_Warning
Active when the discharge hose
protection will be activated
during filling
bit 13 on Vapour_Recovery_Warn
. The vapour return hose present a
mulfunctioning
bit 14 on Meter_Warning
Alarm the meter instrument
malfunctioning
bit 15 on Not assigned
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 34
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
82 Product_Code Bit256 R M
Indicates the product code as reported by the
general list
83 Product_Designation Asc5 R M
Indicates the product designation code as
reported by the general list.
84 Connected_Tank_Id Bit256 R M
Identifies the buried tank connected to the
lorry compartment
85 Gross_Vol._ 0 - 99999 R O
Indicate the quantity of the tank
compartmennt (in level/volume)
86 Net_Vol 0 - 99999 R O
Indicate the amount (related to 15°C) in the
tank compartment
COMMANDS
90 OBC_Setup Cmd W(1-3) M
Forces the OBC to move to the „IDLE‟ state.
91 OBC_ExitSetup Cmd W(2) M
Forces the OBC to move to the „INOPERATIVE‟ state.
92 OBC_Open Cmd W(3) M
Forces the OBC to move to the „OPERATIVE‟ state.
93 OBC_Connected Cmd W(6) M
Forces the OBC to move to the „FILLING‟ state.
94 OBC_Terminate Cmd W(6) M
Forces the OBC to move to the „CLOSED‟ state.
95 OBC_Check_Connection Cmd W(6) M
Forces the OBC to stop the discharge and to wait until
the stop has been removed and to move to the „OPEN‟
state.
96 OBC_SwitchOn Bit16 W(4-6) M
Forces the OBC to set on the selected (one or multiple
bits on) switch(es).
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 35
TANK DELIVERY APPLICATION DATA BASE
DB_Ad = OBC_ID (01H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description
UNSOLICITED DATA
101 OBC_Status Byte M
This status message (= OBC_State)must be sent
unsolicited (without acknowledge) by the OBC when
ever a change has occurred in the OBC_State.
102 OBC_Info Byte M
This message (= OBC_Note) must be sent unsolicited + Bin16
(without acknowledge) by the OBC before the state + Asc3
change from „PROCESSING‟ state to the „DELIVERY + Bin24
ACCEPTED‟ state.
103 OBC_FKeySignal Byte O
This message must be sent unsolicited (with
acknowledge) by the OBC when ever a key is pressed .
01H to 7FH Reserved for IFSF.
80H to FFH Reserved for manufacturers.
104 FPR_Status Byte M
This status message must be sent unsolicited (without +Bit16
acknowledge) by the MT when ever a change has
occurred in the FPR_State or in FPR_StationState.
The field is a structure consisting of:
Byte FPR_State
Bit16 FPR_StationState
201 OBC_Polling Bytes 12 R O
This message must be sent unsolicited (with
acknowledge) by the OBC to identify the petrol station
devices
202 OBC_LevelRequest Bytes 12 W O
This message must be sent unsolicited (with
acknowledge) by the OBC to request the station tank
topology and data
203 OBC_SalesRequest Bytes 12 W O
This message must be sent unsolicited (with
acknowledge) by the OBC to start product sales
accumulation during the discharge by the PSC
204 OBC_EndDischarge Bytes 12 R O
This message must be sent unsolicited (with
acknowledge) by the OBC the communicate to the
station devices the discharge end
205 PSC_DischargeRequest Bytes 12 R O
This message must be sent unsolicited (with
acknowledge) by the PSC to request all discharge data
206 OBC_StationReset Bytes 12 R O
This message must be sent unsolicited (with
acknowledge) by the OBC to reset all involved station
devices at the end of the discharge
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 36
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 37
TANK LORRY DELIVERY MANUFACTURER CONFIGURATION DATA BASE
DB_Ad = OBCMC_ID (02H)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description (OBC_State)
20 FPRMC_DType Bit8 R(*) M
To allow other devices to interrogate the supported
format.
Bit 1 on ASCII (all printable charareters from 20H
to 7EH and the 0AH, 0DH control
characters).
Bit 2 on Graphics/Bit map.
Bit 3 on Security Telegram.
Bit 4 to 8 Reserved for future use.
21 FPRMC_Font Bit8 R(*) M
To allow other devices to interrogate the supported font
of the printable data.
Bit 1 on Normal.
Bit 2 on Bold.
Bit 3 on Double width.
Bit 4 on Double Hight.
Bit 5 on Underline.
Bit 6 on Centralise.
Bit 7 to 8 Reserved for future use.
22 FPRMC_Columns Byte R(*) M
To allow other devices to interrogate the maximum
number of columns of one line.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 38
TANK LORRY DELIVERY SYSTEM CONFIGURATION DATA BASE
DB_Ad = OBCSC_ID (03H) + [ CNCY_ID (01H-XXH) ]
Data_Id Data Element Name Field Type Read/Write in State M/O
Description (OBC_State)
18 Petrol station name Asc30 R/W M
Name of the company managing the petrol station
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 39
ERROR DATA
1 OBCEC_Type Byte R(*) M
Every error has a unique error code. This number is the W(2)
same number as used in the address ERROR_ID of this
data base.
A list off all errors is at the end of this table.
An unsolicited message is generated by the OBC when a
major or minor error occurs.
2 OBCEC_Description Asc20 R(*) O
Description of the error. W(2)
3 OBCEC_Total Byte R(*) M
Total of error having that code. If more than 255 errors W(2)
are counted, the value remains 255. When a value is
written in this field, the total is cleared and the date is
recorded.
5 OBCEC_ErrorState Byte R(*) M
Specifies the OBC state during which the latest error
(with the selected ERROR_ID) occurred. The OBC state
numbering described in chapter 0, page 13 are used.
6 OBCEC_ErrorOriginator Byte R(*) O
Specifies the OBC originator data base address during + Byte8
which the latest error (with the selected ERROR_ID)
occurred.
The following address is valid:
DB_Ad = OBC_ID (01H)
UNSOLICITED DATA
100 OBCEC_ErrMsg1 Byte M
This message must be sent unsolicited (without + Byte
acknowledge) when ever an error occurs.
The field is structure consisting of:
Byte OBCEC_Type
Byte OBCEC_ErrorState
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 40
TANK LORRY DELIVERY ERROR CODE DATA BASE
DB_Ad = OBCEC_ENTRY (41H) + ERROR_ID (01H-3FH)
Data_Id Data Element Name Field Type Read/Write in State M/O
Description (OBC_State)
101 OBCEC_ErrMsg2 Byte O
This message must be sent unsolicited (without + Byte
acknowledge) when ever an error occurs. + Byte9
The field is a structure consisting of:
Byte OBCEC_Type
Byte OBCEC_ErrorState
Byte9 OBCEC_ErrorOriginatior
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011
Page 41
DOWNLOAD DATA
1 OBCDD_Type Byte W(2) O
Identifies the type of data to be downloaded.
2 OBCDD_Block Bin24 W(2) O
Identifies the data block within the software program.
3 OBCDD_Address Bin32 W(2) O
Specifies the start address where the first byte from the
OBCDD_Data field must be downloaded.
4 OBCDD_Size Bin16 W(2) O
Specifies the number of bytes which are downloaded by
the OBCDD_Data field.
5 OBCDD_Data Xbytes W(2) O
Contains the data to be downloaded. The length of this
field is maximum 1 Kb (size allocated to communication
buffers).
6 OBCDD_Checksum Byte8 W(2) O
Depending on the requirements, this can be checksum,
MAC, ... which has to be calculated and verified.
IFSF TANK DELY DRAFT 1.06 IFSF - STANDARD FORECOURT PROTOCOL December 2011
WORKING GROUP PROPOSAL TANK DELIVERY CONTROL APPLICATION
Copyright © IFSF Ltd 2011