PSS 5000

Quick Guide

PSS configuration for flow rate monitoring

Date June 19, 2014

Document number PSS5000/USGU/805604/00

Doms ApS Formervangen 28 Tel. +45 4329 9490 [email protected]

DK-2600 Glostrup Fax. +45 4343 1012 [email protected]
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

Legal Notices
Copyright Statement This documentation is owned by Doms or its licensors and is copyright pro-
tected. Your right to use this documentation is subject to the limitations and
restrictions imposed by applicable licenses and copyright laws. Unauthorized
reproduction, modification, distribution, display or other use of this documen-
tation may result in criminal and civil penalties.

About This Documentation

Purpose This documentation describes how to configure a PSS 5000 to acquire flow
rate data for dispensers that are connected to the forecourt controller. This data
is accessible to other applications by using the Doms Host Protocol.

Audience The content of this documentation is designed for service technicians or sys-
tem integrators who need to configure a site where it is necessary to monitor
the flow rates of the dispensers on the forecourt.

Prerequisites
Before you start Before this solution can be implemented the following conditions must be ful-
filled:
• PSS Application must support Performance Monitoring. Use the relevant
SRD to verify that this is supported by your application.
• PSS Configurator must have the following plugin installed: dispense.jar
version 1.11 or later

2 of 11 PSS5000/USGU/805604/00
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

Contents

Legal Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
About This Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1 Configuring a PSS 5000 for Flow Rate Data . . . . . . . . . . . . . . . . . . . 4

1.1 Using Doms POS Protocol (DPP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 Using PSS Configurator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.3 Verify Configuration in PSS 5000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.4 Troubleshooting Flow Rate Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.5 Monitoring Flow Rate Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2 Reference Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.1 PSS Configurator Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2 PSS 5000 Configuration Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Revision Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

PSS5000/USGU/805604/00 3 of 11
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

1 Configuring a PSS 5000 for Flow Rate Data

Introduction When dispensers are manufactured, each individual dispenser has a specified
flow rate. Normally, these flow rate values are displayed on a plate that is
mounted on the dispenser and are known as the Nominal Flow Rates.
When a dispenser is capable of dispensing fuel at 2 different speeds, then there
are 2 values: Nominal Normal Flow Rate and Nominal High Speed Flow Rate.
These flow rate values are provided together with the measured values in the
Doms Host Protocol (DHP). By including both the nominal values and the
measured values to monitoring software it makes it possible to see if the actual
values are what one expected.

Flow rate parameters To configure the PSS 5000 for flow rate measurements, then the following pa-
rameters must be set:

Parameter Value

Nominal normal flowrate This is the flow rate specified for the meter on the dis-
penser.

For example, this may be 40 L/min.

Note: If this is a dual-speed dispenser, use the lowest
of the 2 values displayed.

Nominal high speed flow This is only valid for dual-speed dispensers (i.e. 2 flow
rate rates).

Use the highest flow rate specified for the dispenser.

For example, the plate may state 40 & 70 L/min. In this

case, use the value = 70.

High speed trigger flow The system cannot see when high-speed flow rate is
rate selected on a dispenser. So, by setting a value for this
parameter, flow rate is registered as high speed data
when the flow rate exceeds the set value.

For example, this parameter could be set to 45. So,

whenever the flow rate exceeds 45 L/min. then the
data is returned as high speed data.

Configuration options The PSS 5000 can be configured using either of the following methods:
• ‘1.1 Using Doms POS Protocol (DPP)’ on page 5
• ‘1.2 Using PSS Configurator’ on page 6

4 of 11 PSS5000/USGU/805604/00
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

1.1 Using Doms POS Protocol (DPP)

Configure flow rate using When using DPP to configure the PSS 5000 to provide flow rate data from the
DPP dispensers, the install_Fp (subcode 3) command must be used.
Command install_Fp
Code 10H
SUBC 03H
DATA FpId
NoFpInstallPars +
NoFpInstallPars
{
FpInstallParId +
FpInstallParLen +
FpInstallPar
}

Note: If your implementation of DPP does not support install_Fp (subcode3),

then you will need to change to this command in order to acquire nom-
inal flow rate data.

Example of install_Fp The example below, which is a highly simplified transcript of the install_Fp
configuration using DPP (subcode3) command, shows how the install parameters are used to configure
the flow rate for a dual-speed dispenser. The dispenser has FpId = 03 and dis-
penses either at 40 L/min. or 70 L/min. (high speed). Any flow rate over
45 L/min. is recorded as high speed.

Install_Fp Code: 10H Subc: 03

FpId 03
NoFpInstallPars 08
...
(min. 5 mandatory parameters for install_Fp (subc 03))
...
FpInstallParId 14 NominalNormalSpeed_id
FpInstallParLen 0200 NominalNormalSpeed_len
FpInstallPar 40 NominalNormalSpeed_par

FpInstallParId 15 NominalHighSpeed_id
FpInstallParLen 0200 NominalHighSpeed_len
FpInstallPar 70 NominalHighSpeed_par

FpInstallParId 16 HighSpeedTrigger_id
FpInstallParLen 0200 HighSpeedTrigger_len
FpInstallPar 45 HighSpeedTrigger_id

For more information about using DPP, see Doms POS Protocol, Application
Level Specification, Control Functions (PROTOCOL/SPEC/804706/--)

PSS5000/USGU/805604/00 5 of 11
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

1.2 Using PSS Configurator

Before you start Before you can use the PSS Configurator to configure a PSS 5000 for flow rate
data, the dispense.jar version 1.11 or later must be installed. We also recom-
mend that you make a copy of the current PSS 5000 configuration. If you do
not know how to do either of these, see:
• ‘2.1 PSS Configurator Plugins’ on page 9.
• ‘2.2 PSS 5000 Configuration Backup’ on page 10

Configure flow rate using This procedure describes how to use the PSS Configurator to configure the
PSS Configurator dispensers connected to a PSS 5000 so that flow rate data is acquired.
Note: Before starting this procedure, close all the forecourt devices.
1. Open the PSS Configurator application.
Note: It is assumed that the PSS Configurator has the correct plugins in-
stalled.
2. Select File → Get from PSS.
The Get window appears.
3. Type in the IP address of your PSS 5000 and the necessary user name and
password to log in.
Note: If you do not know this information contact your System Adminis-
trator.
The current PSS configuration is displayed.
4. Expand the Fuelling points in the Devices tree.
5. Click the Fuelling point where flow rate data acquisition is required.
The configuration details for the fuelling point appear.
Note: If you cannot see 2 x 16 type bits, then click Convert in the Upgrade
group box. This also results in the flow rate fields being displayed.
6. Locate the flow rate parameters and type in the relevant values.
Note: It is not necessary to type in the units for the flow rate.

In this illustration any flow rate over 45 L/min. is considered as high speed.
7. Click OK to save the configuration settings.
8. Do one of the following:
• If you need to configure more dispensers, repeat steps 5 – 7.
• If this was the last dispenser configuration, go to the next step.
9. Select File → Send to PSS.
The Send window appears.

6 of 11 PSS5000/USGU/805604/00
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

10. Type in the necessary user name and password to log in and click Send.
The Send - Mode:Normal window appears.
11. Click No to reject the backup request.
The Success! window appears.
12. Click OK to acknowledge that the upload is complete and exit the window.

1.3 Verify Configuration in PSS 5000

To verify the This procedure describes how to verify that the configuration in the PSS 5000
configuration is in the is correct and that flow rate data is configured for the relevant dispensers.
PSS 5000
1. Open a browser and in the URL field type in the following syntax:
http://<PSS IP addresss>/site_sta.xml
If you are not already logged in to the PSS 5000, provide your log in details
in the Windows Security window that appears.
2. In the xml file that appears, locate the <pumps> element, which is located
under the following parent elements: <devices> <forecourt>
3. Expand the <pumps> element and locate the dispenser ID (e.g. device id =
01) to which you assigned the flow rate parameter values.
4. Expand the <monitoring> element and expand the individual
<grade_option_gropt=n> elements.
When a dual-speed dispenser (40–70 L/min.) is configured, a successful
configuration will display values similar to those below:
<flow_info total_no_pump_trans="n" nominal_flow_rate="40"
flow_type="normal_speed"> </flow_info>
<flow_info total_no_pump_trans="n" nominal_flow_rate="70"
flow_type="high_speed"> </flow_info>

If you do not see the parameters shown above, go to Troubleshooting flow rate
configuration.

1.4 Troubleshooting Flow Rate Data

Troubleshooting flow If when you used the site_sta.xml file you did not see the correct result, then
rate configuration use the table below to help solve the problem.

Observation Action

<flow_info> elements not Performance Monitoring is not supported by the current

present PSS Application (see SRD).

Contact Doms ([email protected]) about upgrading your

PSS Application to a version that supports Perfor-
mance Monitoring.

<flow_info> parameter Open configuration file in the controller and check that
values incorrect all the parameter values are set correctly.

For more details, see Configure flow rate using PSS

Configurator.

PSS5000/USGU/805604/00 7 of 11
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

1.5 Monitoring Flow Rate Data

Introduction to Flow rate data is available to BOS or HOS applications via the Doms Host Pro-
monitoring flow rate data tocol (DHP). This enables these applications to visualize the data graphically,
making it easier to spot performance trends.
The data in the DHP is only available when an EXTENDED_INFO license key is
installed on the PSS 5000.
For more information about SiteInfo or DHP (and how to use it), contact
[email protected].

Example of flow rate The illustration below shows how SiteInfo uses the DHP to visualize the flow
monitoring in SiteInfo rate data graphically for a fuelling point.

8 of 11 PSS5000/USGU/805604/00
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

2 Reference Information
Reference overview To help you complete the tasks in this documentation, this section contains a
couple of general PSS Configurator procedures.
• ‘2.1 PSS Configurator Plugins’ on page 9
• ‘2.2 PSS 5000 Configuration Backup’ on page 10

2.1 PSS Configurator Plugins

Verify/update PSS This procedure describes how to verify that the necessary plugin is installed in
Configurator plugins the PSS Configurator, and how to install it if it is not installed.
1. Open the PSS Configurator application.
2. Select Help → About Doms PSS Configurator.
The About Doms PSS Configurator window opens.
3. Use the scroll bar to scroll down through the Installed Plugins list.
4. Locate the Plugin file name: dispense.jar.
This must show version 1.11 or later.
5. Do one of the following:
• If the plugin version is 1.11, click OK. The PSS Configurator is ready
for use and you can exit this procedure.
• If an older version of the plugin is installed, continue to the next step.
6. Select File → Get from PSS.
The Get window appears.
7. Type in the IP address of your PSS 5000 and the necessary user name and
password to log in.
Note: If you do not know this information contact your System Adminis-
trator.
8. Click Get.
The Update plugins window appears.
9. Verify that the New version is 1.11 and click Update.
The plugin is updated automatically and the current PSS configuration ap-
pears.
Note: The updated plugin is not activated until the PSS Configurator is re-
started.
10. Select File → Exit.
The PSS Configurator application closes.

PSS5000/USGU/805604/00 9 of 11
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

2.2 PSS 5000 Configuration Backup

How to copy the PSS This procedure describes how to use the PSS Configurator to extract the con-
configuration figuration currently installed in the PSS 5000 and save it.
Note: Make sure that all operations are stopped, transactions are cleared and
that any other relevant data has been saved by either local or remote ap-
plications.
1. Open the PSS Configurator application.
2. Select File → Get from PSS.
The Get window appears.
3. Type in the IP address of your PSS 5000 and the necessary user name and
password to log in.
Note: If you do not know this information contact your System Adminis-
trator.
The current PSS configuration is displayed.
4. Select File → Save to File.
The Save window appears.
5. Select a suitable location to save the configuration file and give it a suit-
able, identifiable name.
6. Click Save.

10 of 11 PSS5000/USGU/805604/00
 PSS 5000 – Quick Guide
PSS configuration for flow rate monitoring

Revision Information
Revision history This documentation has changed as follows:

Rev. Date Description of Changes

00 June 19, 2014 First release

PSS5000/USGU/805604/00 11 of 11