File315403376031 2
File315403376031 2
TECHNICAL GUIDE
(PTS controller PCB board modification: PTS-U3)
TECHNOTRADE LTD
PTS CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-U3)
Revision: R02 Review date: 29 July, 2013
CONTENT
REVISION HISTORY .......................................................................................................................................... 6
PURPOSE OF THE DOCUMENT ......................................................................................................................... 7
TECHNICAL FEATURES ..................................................................................................................................... 8
Appointment ........................................................................................................................................... 8
Specification ............................................................................................................................................ 8
SUPPORTED FUEL DISPENSERS COMMUNICATION PROTOCOLS ....................................................................... 9
SUPPORTED ATG SYSTEMS COMMUNICATION PROTOCOLS........................................................................... 11
BOARD CONNECTORS AND INTERFACES ........................................................................................................ 12
COMMUNICATION PORTS ............................................................................................................................. 13
CONNECTION TO CONTROL SYSTEM .............................................................................................................. 14
CONNECTION TO FUEL DISPENSERS ............................................................................................................... 15
CONNECTION TO ATG SYSTEMS ..................................................................................................................... 16
PTS CONTROLLER MULTI POS SYSTEMS OPERATION ...................................................................................... 17
PTS CONTROLLER CONFIGURATION ............................................................................................................... 19
General information ...............................................................................................................................19
Scheme of connections ...........................................................................................................................20
Launching pts_conf utility .......................................................................................................................20
Configuration of pump channels .............................................................................................................20
Configuration of ATG channels ................................................................................................................22
Parameters configuration .......................................................................................................................23
Configuration of parameters for pumps protocols ...............................................................................23
Configuration of parameters for ATG systems .....................................................................................24
Configuration of parameters for PTS controller ...................................................................................25
Configuration of parameters for interface converters..........................................................................26
Configuration of parameters for logging ..............................................................................................27
Update of the PTS controller firmware ....................................................................................................28
Logging of PTS controller operation ........................................................................................................30
Self-diagnostics of PTS controller interfaces and DIP-switch ....................................................................33
Saving of all configuration of PTS controller to file ..................................................................................35
Loading of all configuration of PTS controller from file ............................................................................36
Additional possibilities of PTS controller configuration utility ..................................................................37
Reading of PTS controller firmware version .........................................................................................37
Setting of PTS controller configuration utility language .......................................................................37
Setting of PTS controller configuration utility skin for graphical user interface ....................................38
Logging of Pts_conf utility operations..................................................................................................39
BUILT-IN PUMP SIMULATOR .......................................................................................................................... 40
BUILT-IN ATG PROBE SIMULATOR.................................................................................................................. 41
APPLICATION PROGRAMMING INTERFACES (API) .......................................................................................... 42
C and C++ API..........................................................................................................................................43
C# API .....................................................................................................................................................45
C# application .........................................................................................................................................47
Delphi API ...............................................................................................................................................49
Java API ..................................................................................................................................................51
Python API ..............................................................................................................................................53
Visual Basic .NET API ...............................................................................................................................55
Visual Basic .NET application ...................................................................................................................57
COM-object for MS Windows OS.............................................................................................................59
REVISION HISTORY
R02 29.07.2013 Evgeniy UniPump pumps software simulator Updated UniPump pumps software simulator
Vasyliev UniProbe ATG probes software simulator Updated UniProbe ATG probes software
simulator
TECHNOTRADE LTD
Ukraine, 04114 Kiev, Polupanova str. 10, office 1
Tel: +38-044-502-46-55, +38-044-502-46-77
Web: www.technotrade.ua
Mail: [email protected]
TECHNICAL FEATURES
Appointment
PTS controller over fuel dispensers and ATG systems for petrol stations is a specialized controller intended
to be used in connection with third party control system for petrol station (POS system, cash register, OPT
terminal, etc) to provide simultaneous remote control over petrol, diesel, CNG and LPG dispensers and
automatic tank gauge (ATG) systems installed at petrol, CNG and LPG stations and storage depots.
PTS controller provides control using the single common communication protocol. PTS controller provides
conversion of the common communication protocol into various proprietary communication protocols of
fuel dispensers and ATG systems.
PTS controller is supplied with a rich set of API (application programming interfaces) developed under most
popular programming languages and environments in order to make comfortable and quick
implementation of PTS controller into control systems for petrol stations (POS system, cash register, OPT
terminal, etc).
Specification
PARAMETER VALUE
Power supply voltage 12 V DC
Current consumption 200 mA max
Temperature range -40°C ÷ +80°C
Weight 120 g
Overall dimensions 120 x 85 x 30 mm
NOTE! Jumper XP4 serves for selection of DISP channel interface between RS-485 and RS-232.
COMMUNICATION PORTS
Pump port 3 for lines A and B, 2 wires for RTS configurable proprietary communication
control protocol (up to 16 fuel dispensers)
Optically isolated RS-485: 2 wires Connection with fuel dispensers using
Pump port 4 for lines A and B, 2 wires for RTS configurable proprietary communication
control protocol (up to 16 fuel dispensers)
1. PTS controllers interconnection (up to 16
PTS controllers) for simultaneous control
over the same fuel dispensers and ATG
DISP port Optically isolated RS-485: 2 wires
systems
(RS-485) for lines A and B
2. Connection with ATG systems (probes)
using configurable proprietary com.
protocol (up to 16 ATG probes)
Connection with ATG system (console) using
DISP port
RS-232 configurable proprietary communication
(RS-232)
protocol (up to 16 ATG probes)
1. Connection with ATG system (console)
ATG PORTS
Connection to the control system (POS system, cash register, OPT terminal, etc) is made through a PC port,
which has RS-232 interface.
Scheme of connections:
In case if the control system does not have a COM-port – it is possible to use any type of converter to COM-
port (like USB-to-COM converter, Ethernet-to-COM, others).
Communication with PTS controller is made using commands and responses described in UniPump
communication protocol (own proprietary protocol of TECHNOTRADE LTD) – see document “UniPump
communication protocol specification for PTS controller over fuel dispensers and ATG systems” for more
information. Thus PTS controller provides conversion of the common communication protocol UniPump
into various proprietary communication protocols of fuel dispensers and ATG systems.
PTS controller can simultaneously control up to 16 fueling places (16 sides of 1-sided dispensers or 8 sides
of 2-sided fuel dispensers) that use up to 4 various communication protocols (each of the pump channels
can be adjusted to a separate communication protocol and baud rate and connect up to 16 fueling places)
(see section “Examples of connection to fuel dispensers”).
NOTE: if there are less than 4 various types of fuel dispensers at petrol station (which use various exchange
protocols) – it is recommended to distribute fuel dispensers between 4 PTS controller channels in
approximately equal quantities in order to minimize delays between fuel dispensers querying in the same
channel.
www.technotrade.ua page 15 from 182
PTS CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-U3)
Revision: R02 Review date: 29 July, 2013
PTS controller can simultaneously control up to 16 ATG probes (gauges) (separate probes or probes
connected to ATG systems / consoles) that use up to 3 various communication protocols (each of the ATG
channels can be adjusted to a separate communication protocol and baud rate and connect up to 16 ATG
probes) (see section “Examples of connection to ATG systems”).
NOTE: DISP channel provides a possibility to connect ATG system (probes) over either RS-485 or RS-232
interfaces – interface is selected using a jumper XP4, located on PTS PCB board.
NOTE! In order to enable PTS interconnection a jumper XP4 should be selected for DISP RS-485 interface
and DISP channel should not be configured for any ATG system (see section “PTS controller configuration”).
Configuration:
At necessity to organize several working places at petrol station (several POS systems) each of the POS
systems should have its own PTS controller connected. PTS controllers should be interconnected with each
other through a dispatcher PTS port (DISP channel on RS-485 interface) and with fuel dispensers. Thus
control over each fuel dispenser at petrol station can be made from every POS system and each PTS
controller will know measurement data of every ATG probe connected to any of the interconnected PTS
controllers. At authorization of a fuel dispenser from one POS system the fuel dispenser becomes locked by
PTS controller of this POS system and while it is locked all other POS systems can not control over given fuel
dispenser, they can only monitor current state of the fuel dispenser. When operation of given POS system
is finished with given fuel dispenser, PTS controller of this POS system unlocks the fuel dispenser and it
becomes commonly available for all other PTS controllers, which makes it possible to be controlled (locked)
by any of the PTS controllers connected to other POS systems.
NOTE! In order to provide control over same fuel dispensers from several PTS controllers locking and
unlocking of dispensers is required. For this reason in configuration of PTS controller in parameters for PTS
controller ‘Lock’ and ‘Unlock’ commands should be set to be used (see section “Configuration of
parameters for PTS controller”).
NOTE! In order to provide correct exchange of ATG systems measurement data between interconnected
PTS controllers logical addresses of connected ATG probes in configuration of interconnected PTS
controllers should not intersect.
PTS controller configuration utility Pts_conf.exe is a multipurpose utility for PTS controller. It provides the
following possibilities:
- configuration of pumps (fuel dispensers) channels
- configuration of ATG systems (probes) channels
- configuration of pumps (fuel dispensers) parameters
- configuration of PTS controller parameters
- configuration of logging parameters
- update of the PTS controller firmware
- taking logs from PTS controller
- self-diagnostics of PTS controller interfaces and switches
- saving of all configuration of PTS controller to file
- loading of all configuration of PTS controller from file
Pts_conf.exe utility is developed to be multilanguage and supports various skins in order to suit to various
control systems graphical interfaces.
Use PTS controller configuration utility Pts_conf.exe to make configuration of the PTS controller.
Scheme of connections
NOTE! On some PCs for correct operation COM-port FIFO settings should be adjusted to Tx: 1, Rx: 1. This
may also apply to situations when a PC does not have a native COM-port and external COM-port converter
are applied (like USB-to-COM, PCI-to-COM, Ethernet-to-COM, etc).
To read current configuration of the PTS controller use a button “READ CONFIGURATION”.
Selection of the pump channel is made by activating of a checkbox near it (there are 4 pump channels
available). When pump channel is activated it is necessary to select a protocol to be used on pump channel
and baud rate from the dropdown lists.
Selection of the connected pump is made by activating of a checkbox near it (there are 16 pumps available).
When pump is activated it is necessary to select:
- a pump channel, to which this pump belongs to, from the dropdown list
- physical address of the fueling place from the dropdown list
After configuration is finished it is necessary to click a button “WRITE CONFIGURATION”, which will write
current pump channels configuration to controller. Information about result of operation of writing of
configuration to controller (whether it is made successfully or there was some problem) will be written in
the log window on the form.
Selected baud rate in Logical address of pump Selected pump Fueling place
pump channel visible for POS system channel physical address
For some protocols it is also required to configure parameters. In this case after a button “WRITE
CONFIGURATION” is clicked a warning dialog will appear:
At this a button with a letter “P” on it will be activated. By clicking on this button a corresponding window
for parameters configuration of the selected pump channel protocol will be shown (see section ‘Parameters
configuration’ below).
Current configuration of pump channels can be saved to a file on a hard drive for future usage (select in
main menu a tab ‘File’ → ‘Save as pump configuration’ to save configuration or ‘File’ → ‘Open pump
configuration’ to open configuration from file).
To read current configuration of the PTS controller use a button “READ CONFIGURATION”.
Selection of the ATG channel is made by activating of a checkbox near it (there are 4 ATG channels
available). When ATG channel is activated it is necessary to select a protocol to be used on ATG channel
and baud rate from the dropdown lists.
Selection of the connected ATG is made by activating of a checkbox near it (there are 16 ATG available).
When ATG is activated it is necessary to select:
- ATG channel, to which this ATG belongs to, from the dropdown list
- physical address of the ATG probe from the dropdown list
Logical address of the ATG means the address on which the control system (POS system, cash register, OPT,
etc) will see given ATG probe. Physical address of the ATG means address of the real ATG probe, which is
programmed or set in configuration of the ATG console (probe).
After configuration is finished it is necessary to click a button “WRITE CONFIGURATION”, which will write
current ATG channels configuration to controller. Information about result of operation of writing of
configuration to controller (whether it is made successfully or there was some problem) will be written in
the log window on the form.
Current configuration of ATG channels can be saved to a file on a hard drive for future usage (select in main
of performed operation
menu a tab ‘File’ → ‘Save as ATG configuration’ to save configuration or ‘File’ → ‘Open ATG configuration’
to open configuration from file).
Parameters configuration
Configuration of parameters in PTS controller includes:
configuration of parameters for pumps protocols
configuration of parameters for ATG systems
configuration of parameters for PTS controller
configuration of parameters for interface converters
configuration of parameters for logging
All parameters are described in details in UniPump communication protocol description.
All forms for configuration of pump parameters are similar and include:
switch for selection a pump number, which parameters are configured
set of parameters to be configured
button “Read” to read parameters for selected pump from PTS
button “Write” to write parameters for selected pump into PTS
button “Write default” to write default parameters for selected pump from PTS
description of default parameters, which are to be written at clicking a button “Write default”
As an example a form for configuration of parameters for Tatsuno SS-LAN protocol look as shown below:
Parameter for setting of flexible configuration of communication adjustments is necessary for cases when
different ATG systems using the same communication protocol may have different communication settings.
In accordance with UniPump communication protocol of PTS controller commands ‘Lock’ and ‘Unlock’ are
used every time control system wants to take control over fuel dispenser – it should first lock it with
command ‘Lock’ and in the end of control – unlock it with command ‘Unlock’. This behavior is required for
www.technotrade.ua page 25 from 182
PTS CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-U3)
Revision: R02 Review date: 29 July, 2013
cases when there are several control systems installed at the same sight (petrol station) each having its
own PTS controller connected and each of these control systems should be able to provide control over any
of the fuel dispensers on the sight. Using these commands ‘Lock’ and ‘Unlock’ gives a possibility for each
control system to provide control over any of the connected fuel dispensers, Read more about it below in
section “PTS controller multi POS systems operation”.
In case if parameters are set not to use commands ‘Lock’ and ‘Unlock’ – then PTS will always respond that
pump is locked.
Parameters for interface converters are used for some of manufactured interface converters working
together with PTS controller, which are used for fuel dispensers, which do not have addressing in
communication protocol. So, addressing of the fuel dispenser is made by a number of a pump channel of
the interface converter, to which a fuel dispenser is connected.
PTS controller firmware update is made using a built-in updater in Pts_conf.exe utility.
In Pts_conf.exe utility leave a COM-port closed. Form for updating of PTS controller firmware is called from
main form main menu tab ‘Firmware update’ → ‘Firmware update’.
On the opened form select a COM-port of connected PTS controller, path to a file with a new firmware and
press a button “UPDATE”. Firmware will start to be updated. Wait until the process is finished. In case of
any errors - restart a tool and try again.
After the firmware update is completed - check PTS controller configuration. Some of the new firmwares (in
case if it contains sufficient changes of PTS controller operation) may erase the PTS controller
configuration.
Due to a reason that some firmware versions may erase all configuration of the PTS controller it
recommended to save all configuration of PTS controller to file before making an update (see section
‘Saving of all configuration of PTS controller to file’) and in case if after the update the PTS controller
configuration turns out to be erased – restore all the configuration from the previously saved file (see
section ‘Loading of all configuration of PTS controller from file’).
Before taking a log from PTS controller it is necessary to configure a channel, from which a log will be taken.
Scheme of connections of the PTS controller should be same as for configuration:
In Pts_conf.exe utility leave a COM-port closed. Form for logging is called from main form main menu tab
‘Logging’ → ‘Logging’.
On the opened form click on a button “Select a channel to log” to open a form of selection of the channel,
from which a log will be taken.
On the opened form open a COM-port, to which PTS controller is connected and select a channel, from
which a log will be taken. Click a button “Write” to save configuration and close a form.
After the channel, from which a log will be taken, is configured it is possible to get a log from it. PTS
controller sends a LOG to a LOG-port, so it is necessary to connect it to COM-port of the control system.
In Pts_conf.exe utility on form for logging it is necessary to select a COM-port, to which a LOG-port of PTS
controller is connected and to select a .bin file, in which a log will be accumulated. After this clicking on a
button “START LOG” will start saving of the log into the file, which size is indicated on the form. If the file
size stays equal to zero – then log is being taken incorrectly. In case of any problem to take the log
information about it will be shown on the screen.
www.technotrade.ua page 31 from 182
PTS CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-U3)
Revision: R02 Review date: 29 July, 2013
Log will be accumulated to the selected file. As an evidence of it logged data size of the accumulated file
will be displayed on the screen. To stop logging press a button ”STOP LOG”. In case of any errors – restart a
tool and try again.
Log in transferred in the encrypted form. After a log of exchange is taken it is required to pass a received
.bin file to “TECHNOTRADE LTD” for examining and elimination of possible problems, for reasons of which it
was taken.
With a reason to quickly provide diagnostics of PTS controller’s RS-485 and RS-232 interfaces and DIP-
switches a special diagnostics of PTS controller is used. Use Pts_conf.exe utility to provide diagnostics of PTS
controller.
In Pts_conf.exe utility open a COM-port with connected PTS controller. Form for PTS controller diagnostics
is called from main form main menu tab ‘Diagnostics’ → ‘Self-diagnostics’.
Configuration:
In order to check RS-485 interfaces connect all RS-485 connectors of C012 cable with appropriate
connectors of diagnostics cable C055 (connector X1 to connector X1, X2 – to X2, X3 – to X3 and so on).
Close XP4 jumper on the board of PTS controller to position RS-485.
On form for PTS controller self-diagnostics press a button “START DIAGNOSTICS” in order to start self-
diagnostics. On the tab “Diagnostics of RS-485 interface channels” results of diagnostics will be shown by
color of labels. Green color means that correspondent channel is working correctly (OK), red color –
correspondent channel is working incorrectly (BAD).
Tab for diagnostics of RS-485 Tab for diagnostics of Tab for diagnostics of RS-485
interfaces on the board DIP-switch on the board interfaces on the board
In order to check RS-232 interfaces (ports USER, LOG, DISP on cable C029 or on cable C033, which is
connected to cable C029) connect pins 2 (Tx) with pins 3 (Rx) on each of these ports. Close XP4 jumper on
the board of PTS controller to position RS-232. On the tab “Diagnostics of RS-232 interface channels”
results of diagnostics will be shown by color of labels. Green color means that correspondent channel is
working correctly (OK), red color – correspondent channel is working incorrectly (BAD).
Diagnostics of DIP-switch:
Tab “Diagnostics of DIP-switches” will display current position of switches in a DIP-switch on PTS board. If
displayed position of switches correspond to real position of switches in a DIP-switch on PTS board after
checking them in various positions – then DIP switch is working correctly.
On the opened form it is necessary to specify a file, to which configuration of PTS controller will be saved,
and click “Save” button. The utility will save one by one:
pumps channels configuration
ATG systems channels configuration
parameters
On the opened form it is necessary to specify a file, from which configuration of PTS controller will be
loaded, and click “Load” button. The utility will load one by one:
pumps channels configuration
ATG systems channels configuration
parameters
In order to make it on the main form of the utility open a COM-port, to which PTS controller is connected
and click a button “Check firmware version”.
Setting of PTS controller configuration utility skin for graphical user interface
PTS controller configuration utility in order to be used together with various POS systems and applications
has a possibility to change its skins to suit to various graphical user interfaces. Selection of the skin is made
form main menu tab ‘Adjustments’ → ‘Skin selection’:
Examples of skins:
Retro WEB2
In order to make easy debugging of control systems without a fuel dispenser connected to PTS controller a
simulator of fuel dispenser is present in PTS controller firmware. There are 2 pump simulators present:
pump protocol “13. PUMP SIMULATOR 10”
pump protocol “37. PUMP SIMULATOR”
When any of these protocols is selected in configuration of the PTS controller – baud rate can be set any.
Purpose of the pump simulator protocol is to help developers in debugging of the control system software
over PTS controller at absence of real dispenser pumphead for connection or software simulators of fuel
dispenser.
When protocol “37. PUMP SIMULATOR” is selected then for pump with logical address 1 position of first 4
nozzles is selected using a DIP switch on the PTS controller board (DIP-switch has 4 switches: switch 1 is
responsible for position of nozzle 1, switch 2 – for nozzle 2 and so on). For pumps with logical addresses 2 –
16 the pumps always have nozzle 1 up (nozzle can not be placed down).
In protocol “13. PUMP SIMULATOR 10” all pumps always have nozzle1 up.
Difference of protocol “13. PUMP SIMULATOR 10” from protocol “37. PUMP SIMULATOR” is that when an
order is given in protocol “37. PUMP SIMULATOR” – dispensing is made from zero till the ordered dose.
When an order is given in protocol “13. PUMP SIMULATOR 10” – then dispensing is made from ordered
dose minus ten liters till the ordered dose, so always only last ten liters are dispensed (this is useful for
purposes when there is a need to make quick void sales for book keeping account at control systems).
PTS controller firmware between its ATG probes protocols has a protocol “7 ATG SIMULATOR”, which
allows to simulate presence of connected ATG probe. Baud rate at this can be set to any possible.
At this depending on the selected address of the ATG probe output measurement values will be the
following:
For ATG probes with logical address 1 – dynamically changing all measurement parameters looping in the
following sequence (measurement numbers coming from 1 to 9 and back from 9 to 1):
Measurement number
1 2 3 4 5 6 7 8 9
Product level,
1000 1250 1500 1750 2000 2250 2500 2750 3000
mm
Water level, mm 100 125 150 175 200 225 250 275 300
Measurement parameter
Product volume, l 8000 10000 12000 14000 16000 18000 20000 22000 24000
Water volume, l 800 1000 1200 1400 1600 1800 2000 2200 2400
Temperature,
11 12 13 14 15 16 17 18 19
deg. C
Product
temperature
8500 10500 12500 14500 16000 17500 19500 21500 23500
compensated
volume, l
Product ullage, l 22000 20000 18000 16000 14000 12000 10000 8000 6000
Product density,
720 730 740 750 760 770 780 790 800
kg/m3
Product mass, kg 5760 7300 8880 10500 12160 13860 15600 17380 19200
Duration between changes equals 2 seconds.
For ATG probes with logical addresses 2-16: statically fixed measurement values:
product level – logical address + 123.4 mm (example - for address 6: 6123.4 mm)
water level – logical address + 56.7 mm (example - for address 9: 956.7 mm)
temperature – logical address + .8 deg. C (example - for address 12: 12.8 deg. C)
PTS controller for developers is supplied together with rich set of API (application programming interfaces)
for mostly used programming languages and operation platforms:
C and C++: API for communication with a PTS controller through a COM-port, documentation and
examples of application in source codes under Windows OS and Linux operation systems
C#:
o open source library, which includes classes, methods and properties for communication
with PTS controller for provision of control over dispensers and ATG systems and
configuration of PTS controller
o open-source utility for testing and indication of all operations provided by the PTS
controller, allows to perform all operations with the PTS controller
o open source fully-functional application for provision of control over up to 8 pumps and 4
ATG systems by the PTS controller, allows to perform all operations with the PTS controller
Delphi: API for communication with a PTS controller through a COM-port, documentation and
examples of application in source codes
Java:
o open source library, which includes classes, methods and properties for communication
with PTS controller for provision of control over dispensers and ATG systems and
configuration of PTS controller
o open-source utility for testing and indication of all operations provided by the PTS
controller, allows to perform all operations with the PTS controller
Python: API for communication with a PTS controller through a COM-port, documentation and
examples of application in source codes
Visual Basic .NET:
o open source library, which includes classes, methods and properties for communication
with PTS controller for provision of control over dispensers and ATG systems and
configuration of PTS controller
o open-source utility for testing and indication of all operations provided by the PTS
controller, allows to perform all operations with the PTS controller
o open source fully-functional application for provision of control over up to 8 pumps and 4
ATG systems by the PTS controller, allows to perform all operations with the PTS controller
COM-object for PTS controller:
o open-source COM-object (written in Microsoft Visual C++ 6.0 IDE in C++ programming
language) with methods and properties for communication with PTS controller for
provision of control over dispensers and ATG systems and configuration of PTS controller
o open-source application in Microsoft Visual Basic 6.0 for testing and indication of all
operations provided by the PTS controller, allows to perform all operations with the PTS
controller
Description of communication protocol of PTS controller: describes communication parameters,
messages structure, commands and responses of communication between POS management
system and PTS controller, typical flowchart and diagram of interoperation
API can be compiled as a static or dynamic library. The library can be compiled by different compilers for
different operating systems: POSIX compatible (tested with GNU Linux only) and Microsoft Windows.
Library functions (except for : pts_open, pts_open_dev, pts_close) have common features:
return value: functions return 0 (FM_OK) if no error and error code if error (see
include/pts_errors.h for
determine the type of error)
PS: If you want use *.bat files for call make, please edit it for set true path to your favorite language
installation.
C# API
The API for PTS controller is written in C# programming language in Visual Studio 2010 Express and requirs
.NET Framework 2.0.
PtsLib - project of PtsLib_CSharp.dll library for operation with a PTS controller. Includes classes,
methods and properties for communication with PTS controller using requests and responses
described in UniPump communication protocol for communication with PTS controller for provision
of control over dispensers and ATG systems and configuration of PTS controller.
Open-source utility for testing and indication of all operations provided by the PTS controller,
allows to perform all operations with the PTS controller (uses classes and methods of
PtsLib_CSharp.dll library).
Form for testing and indication of all operations provided by the PTS controller
C# application
The application for PTS controller is written in C# programming language in Visual Studio 2010 Express and
requirs .NET Framework 2.0.
PtsLib - project of PtsLib.dll library for operation with a PTS controller. Includes classes, methods
and properties for communication with PTS controller using requests and responses described in
UniPump communication protocol for communication with PTS controller for provision of control
over dispensers and ATG systems and configuration of PTS controller.
Fully-functional open source application for provision of control over up to 8 pumps and 4 ATG
systems by the PTS controller, allows to perform all operations with the PTS controller (uses classes
and methods of PtsLib.dll library).
Form of PTS controller configuration: allows to set configuration for pumps and ATG systems channels
and also set parameters
Delphi API
Delphi API implements shared library libpts.dll calls.
Library libpts.dll was build with Borland compiler C PTS API (source C files you can find in libpts.zip).
Source code of library are located in ./src directory. Directoty ./examples contains several examples of
using library functions.
Graphical form for testing API for PTS controller written in Delphi
Library functions (except for : pts_open, pts_open_dev, pts_close) have common features:
return value: functions return 0 (FM_OK) if no error and error code if error (see
include/pts_errors.h for
determine the type of error)
first of parameter - pts_api_descriptor - integer obtained by the open function: pts_open or
pts_open_dev
last parameter - pointer to PTS response structure - see include/pts_data.h for determine the data
type.
Java API
Java API for PTS controller is written in Java programming language in NetBeans IDE 7.2.1.
Communication over the COM-port (RS-232 interface) is done using RXTX Java library (visit
www.rxtx.qbang.org for downloads and information): RXTX is a Java library, using a native implementation
(via JNI), providing serial and parallel communication for the Java Development Toolkit (JDK). It is based on
the specification for Sun's Java Communications API, though while many of the class descriptions are the
same the package used it not, since gnu.io is used instead. For more information please visit the rxtx wiki at
http://rxtx.qbang.org/wiki (latest releases of the library can be downloaded there).
Form for testing and indication of all operations provided by the PTS controller
Python API
Before installation of this package it is necessary to install PySerial (http://pyserial.sourceforge.net/).
To install PTS module, run python setip.py install, Where python = your desired python version executable.
Graphical form for testing API for PTS controller written in Python
The package was tested with python of versions 2.7 and 3.0
Work with the protocol can be set for work without exceptions (when error occured), and with generation
of exceptions (PtsException). Parameter of initialization of use_exceptions is responsible for it.
Form for testing and indication of all operations provided by the PTS controller
The Visual Basic .NET application for PTS controller is written in VB.NET programming language in Visual
Studio 2010 Express and requirs .NET Framework 2.0.
Form of PTS controller configuration: allows to set configuration for pumps and ATG systems channels
and also set parameters
For communication with a PTS controller it uses API (application programming interface), written in C
language (located in C_API folder).
Form for testing and indication of all operations provided by the PTS controller
PTS controller SDK (Software Development Kit) is appointed on developers of control system software
applications (POS system, cash register, OPT terminal, etc) for petrol stations providing control over fuel
dispensers and ATG systems through PTS controller.
PTS controller SDK includes a PTS controller and RS-232/RS-485 interface converter board, which allow to
run software simulators of fuel dispensers and ATG systems on personal computer and debug operation of
control systems software with PTS controller on it without a necessity to connect to real fuel dispensers
and ATG systems. Thus it is convenient to work in office or at home rather than on a working petrol station
being connected to real equipment.
HARDWARE:
1. PTS controller over fuel dispensers and ATG systems for petrol stations - 1 pcs
2. Interface converter RS-485 / RS-232 - 1 pcs
3. USB software protection dongle Guardant (required for NaftaPOS software and fuel dispensers
software simulators) - 1 pcs
4. Cabling
SOFTWARE:
1. NaftaPOS software for petrol stations – 1 license (protected by USB-dongle)
2. PumpDemo - free contracted version of NaftaPOS software for petrol stations
3. Software simulators of popular fuel dispensers
4. Software simulators of ATG systems (probes)
5. API for developers in various programming languages
6. Useful tools for debugging of communication with PTS controller
Communication ports
PARAMETER VALUE
PC port RS-232
Pump port RS-232
PTS SDK box includes 2 boards mounted inside of a plastic case (PTS controller board and RS-232/RS-485
interface converter board) and all required cablings for power supply and communication of these boards.
Control systems software, which uses UniPump communication protocol, connects to the PTS controller
SDK box through a connector with inscription “RS-232 (control system)” is connected.
Fuel dispenser software simulator is connected to the PTS controller SDK box through a connector with
inscription “RS-232 (fuel dispenser simulator)”.
RS-232/RS-485 interface converter board is used in order to convert signals coming from PTS controller
pump channels in RS-485 interface into signals of RS-232 interface for the fuel dispenser software
simulator, which runs on PC and communicates through a COM-port. RS-232/RS-485 interface converter
board has 2 independent conversion circuits, so it is possible to simultaneously connect 2 fuel dispenser’s
simulators to PTS controller pump channels using the same RS-232/RS-485 interface converter board.
Connection of pump port to RS-232/RS-485 interface converter board is made through cable C029 and
C018-1. Connection of the RS-232/RS-485 interface converter board to PC COM-port is made through
cables C020.
For connection to software simulators of ATG systems PTS controller does not need the RS-232/RS-485
interface converter board because ATG port is already in RS-232 interface and can be connected through
cables C029-3 and C033 to the COM-port of PC, where the ATG systems software simulator is launched.
Thus it is possible to debug a correct operation of software, being developed, with the PTS controller
without a necessity to connect to real fuel dispensers and ATG systems, but using fuel dispenser’s software
simulators and ATG system’s software simulators.
Appointment
RS-232 to RS-485 interface converter is intended for conversion of signals from RS-232 interface to signals
of RS-485 interface and backwards. Converter contains 2 separate independent conversion channels.
More technical information regarding interface converter RS-232/RS-485 can be found in technical guide
on: http://www.technotrade.ua/rs232_to_rs485_converter.html.
Specification
PARAMTER VALUE
Voltage +12 V DC, +5 V DC
Current consumption 250 mA max
Temperature range 0°C ÷ +40°C
Weight 120 g
Dimensions 145 x 100 x 20 mm
Communication ports
PARAMTER VALUE
RS-232 port RS-232 (can be with RTS control)
RS-485 port Half-duplex (2-wire) or full-duplex (4-wire)
Features
PARAMTER VALUE
Channels Converter contains 2 separate independent channels
Galvanic isolation Receiver and transmitter are galvanically isolated
RS-232 port can receive RTS control, for cases when it does not
RTS control
receive RTS control a RTS generating chip should be installed
Top view
Back view
Signals of RS-232 interface enter the MAX232 chip, where are converted into signals of TTL logics, and after
conversion go through optocouplers H11L1, that serve for galvanic isolation of transmitter and receiver,
enter the TTL input of MAX485 chip, from the output of which signals of RS-485 interface are received.
Analogous behavior takes places in contrary direction of signals.
The board of the Converter has 2 separate channels, the only thing which unites them is source voltage
+5 V, which feeds interface RS-232. Voltage +5 V for circuits of RS-485 interface of the channels is taken
from separate DC-DC converters with galvanical isolation for the channels.
Depending on the state of switches Sn (where n=1,2 – number of channel) output of RS-485 interface can
be adjusted for operation in half-duplex or full-duplex modes (2-wire or 4-wire schemes of connection
accordingly). When switches Sn:1, Sn:3, Sn:4 (where n=1,2 – number of channel) are in position “OFF” – the
Converter works in full-duplex (4-wire) mode of RS-485 interface, in position “ON” - the Converter works in
half-duplex (2-wire) mode of RS-485 interface. Switch Sn:2 (where n=1,2 – number of channel) is intended
for switching on (position “OFF”) or turning off (position “ON”) of echo mode in half-duplex (2-wire) mode
of RS-485 interface (repeating of all signals, received on input).
Half-duplex (2-wire) mode of RS-485 interface requires presence of RTS (Request To Send) signal on the
input of RS-232 interface for synchronization of transmit/receive. In case if RTS signal is impossible to
receive from the source of signal of RS-232 interface, then it is possible to generate it with a help of RTS
generating chips of each channel, which are installed only in case of such necessity. If input of RS-232
interface contains RTS signals and RTS generating chips are not installed then it is necessary to place a
jumper Jn (where n=1,2 – number of channel) for the required channel, in contrary case the jumper should
be removed.
Appointment
USB protection dongle Guardant is required for running of NaftaPOS software and fuel dispensers software
simulators. To run this software it is necessary to have the dongle inserted in the USB port. Electronic
protection dongle Guardant – is a device that is connected to USB port (or a parallel port LPT in older
versions), located on a panel of a PC motherboard. Electronic protection dongle Guardant is necessary for
protection of NaftaPOS software and fuel dispensers software simulators from unauthorized copying and
illegal distribution. Scope of protection is that the dongle contains part of the code of protected software.
Without a dongle being inserted to PC protected software will not launch and correspondent error will be
shown to user.
Installation
To install Guardant dongle drivers run GrdDriversEN.msi.
Guardant USB dongle drivers are installed during NaftaPOS software installation process or can be
installed/updated any time later:
During installation process it is necessary to follow all steps in the installation wizard until installation is
completed.
Appointment
Front-Office software NaftaPOS is intended for control over technological processes, automated
measurement and commercial account at petrol stations (also called fuel stations or gas stations) and
petroleum storage depots.
Area of application – petrol stations for dispensing of light petroleum products, diesel fuel, liquified
petroleum gas (LPG), compressed natural gas (CNG), multifuel petrol stations, petroleum storage depots.
NaftaPOS system is developed with account of all modern requirements to systems for automation of
petrol stations, at this it is oriented as on small petrol stations, so as on big petrol complexes with
organization of several working places of operators and administrator (Back-Office) of a petrol station.
User Manual on NaftaPOS software system can be downloaded from NaftaPOS software web-page
http://www.technotrade.ua/petrol_station_software.html. it is strongly recommended to read User
Manual on NaftaPOS software prior to installation.
More technical information regarding NaftaPOS software can be found on NaftaPOS software web-page:
http://www.technotrade.ua/petrol_station_software.html
Installation
There are 2 types of installation files for NaftaPOS system:
32-bit version
64-bit version
Installation file, which corresponds to hardware characteristics of the POS terminal, should be used for
installation of the system.
NaftaPOS software is to be installed on a POS terminal (or a standard PC) with Microsoft Windows
operation system (supported OS Windows 2000, XP, Embedded POSReady 2009, Vista, 7, 8).
At using NaftaPOS you should in Windows Control Panel in configuration of regional parameters on tabs
"Numbers" and "Currency unit" as a "Separator of integer and fractional parts" set ‘.’ (point, dot).
Installation of NaftaPOS software is made by running an installation file following instructions, specified in
installation wizard windows:
During installation process MySQL RDMS will be installed (starting MySQL service):
Borland Database Engine will be installed during NaftaPOS software installation process, so it is important
to agree with a request on its installation:
Guardant dongle drivers are installed during NaftaPOS software installation process, so it is important to
agree with a request on its installation:
After installation of NaftaPOS software a logical drive, on which the system is installed, will contain a
directory “NaftaPOS” with all files of NaftaPOS software and NaftaPOS system files that track its operation
(log-files):
main_logfile.txt
controller.txt
CashErr.txt,
Others log files may be created automatically during the system operation. By content of these log-files it is
possible to track reasons of possible errors and misoperations arisen during software operation and lead a
log of actions performed by operator of the petrol station. This information is written in logs that at
necessity can be sent to TECHNOTRADE LTD company for defining of found errors and their initial reasons
with subsequent fixing of these errors.
At entering the configuration utility a user is requested to authenticate in order to prove his permission to
make configurations of the system:
By defaults after installation there is only 1 user present with login ‘Service’ and no password (adding of
other users and changing of passwords is made in configuration utility).
After logging inside the configuration utility the following window is shown, where on the left side – there
is a selector of tabs to be configured, and on the right side – configurable parameters of the selected tab.
www.technotrade.ua page 73 from 182
PTS CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-U3)
Revision: R02 Review date: 29 July, 2013
Initial configuration of NaftaPOS for operation with PTS controller should include the following steps:
Make sure that you have the tanks quantity set and tanks are linked to fuel types:
Setting of Setting of contracted
tanks quantity products names
Make sure that you have the pumps quantity set and pumps’ nozzles are linked to fuel types:
NOTE!
Due to a reason of constant development of PTS controller firmware and adding to it communication
protocols of new fuel dispensers and ATG systems PTS controller configuration tool is also constantly being
developed. That is why in order to have the latest version of the configuration tool and the latest firmware
of the PTS controller – request it from “TECHNOTRADE LTD” company. Location of PTS controller
configuration tool (in case of installation of NaftaPOS system on drive C:\) is “C:\NaftaPOS\pts_conf\”.
Make sure that you have the windows to be displayed on main form to be checked here:
- Pump window #... (for each of configured pumps quantity set on tab “Pumps” above)
- Window of products sales (for a reason to be able to provide sales of retail products from main form)
- Table of tanks
Check all the checkboxes in the options for graphical user interface adjustments.
Tab ‘Drivers’ serves for configuration of drivers of connected equipment to NaftaPOS software, namely:
Cash registers (receipt printers)
Forecourt controllers
ATG systems
Barcode scanners
Controller service
Tanks service
For operation of NaftaPOS software with PTS controller it is necessary to click on button “Controller” from
the top menu in this tab “Drivers” and there select from the list of drivers a driver for PTS controller and
click on a button “Set “ to make it applied in the system.
Tab “Controller” specifies the pumps in NaftaPOS system, with which NaftaPOS works. To each of these
pumps on tab “Pumps” can be linked any pump logical address, which is configured in PTS controller
configuration.
Clicking of button “Test” opens a window for checking communication with the current PTS controller on
specified COM-port: If response is OK – communication is successful, otherwise various errors will be
displayed.
Response type:
if “OK” – successful, Quantity of received
else – various errros responses
In configuration of “PTS controller” driver only logical addresses of dispensers are set, the physical address
of the connected fueling place is specified in PTS controller configuration utility.
Pump number in
NaftaPOS system
Multipliers can be set separately for each of the pumps. Clicking on button “Set for all pumps” leads to
setting of the current multipliers on currently selected pump for all other pumps.
Shown on image above multipliers set that there are 2 digits on the pump in fields of monay amount,
volume and price and also pump gives out total counters (volume and money) with 2 digits after decimal
separator.
Setting multipliers for pump with 0 digit in money Setting multipliers for pump with 1 digit in money
amount and 3 digits in volume amount and 2 digits in volume
Except setting of multipliers for each of the pumps it is necessary to set multipliers in NaftaPOS system in
order to set how data should be accounted in system, stored in database and displayed in reports. Setting
of multipliers for NaftaPOS system is made on tab “Order” in configuration utility of NaftaPOS.
Driver “Virtual controller” is used for simulation of fuel dispensers. At using of this driver NaftaPOS can
simulate presence of actual fuel dispensers, but at this no real dispensers are connected to the system.
Driver “Virtual controller (HIGHSPEED)” is used for simulation of fuel dispensers like driver “Virtual
controller”, but unlike it dispensing is made very quickly and there is no need to wait until dispensing is
finished no matter what is the order value.
Driver “PTS ATG driver” is used for communication with various ATG systems using the PTS controller.
In configuration of “PTS ATG driver” driver only logical addresses of ATG system probes (sensors) are set,
the original physical addresses of probes are specified in PTS controller configuration utility.
Selection of a number of
connected PTS controller
Selection of logical number of
ATG probe is PTS controller
Selection a place from where the calibration chart
of tank should be taken (for calculation of fuel
volume in accordance with fuel level)
Tank number in
NaftaPOS system
Driver “Driver of virtual tank” is used for simulation of ATG system presence in system. This driver should
be set, when there is no ATG system connected. In this case a checkbox “Level meter presence in system”
on tab “General” should be unchecked.
Tab ‘Drivers’ serves for configuration of several things of NaftaPOS system connected with order placing.
Make sure that the following things are checked:
Checkbox “order autoclose in Manual mode”
Only-non-zero dispensings
Area “Setting of multipliers” sets how many digits after decimal separator in values of money amount,
volume, price and total counter values received from pumps should be accounted in NaftaPOS system for
calculations, storing in database and displaying in reports.
All the described steps are basic configuration of NaftaPOS software to operate with PTS controller.
NaftaPOS has more options to configure, more details about them please read on NaftaPOS web-page:
http://www.technotrade.ua/petrol_station_software.html. For testing purposes of NaftaPOS software
operation with PTS controller these adjustments are enough.
In “NaftaPOS” shift mode of operation is applied. Cashier at beginning of operation should open a new shift
(in main menu tab ‘Shift’ → item ‘New shift’). Shift control is required in order to make the system operate
under responsibility of the logged cashier (under his personal login and password) and thus make him bear
responsibility for all actions happening at petrol station. Shift control can be switched off in configuration of
NaftaPOS on tab ‘General’.
Detailed description on running the NaftaPOS system is given in section “Step by step configuration” below.
To understand better how to work in NaftaPOS and lead control over fuel dispensers, sales of products and
management over a petrol station – please read documentation and see online videos on the NaftaPOS
software web-page: http://www.technotrade.ua/petrol_station_software.html.
Localization of NaftaPOS software to any language is quite easy. All text strings and their correspondent
translation is located in XML file lang.xml in root folder of NaftaPOS software.
PumpDemo utility is a contracted version of NaftaPOS software used for debugging purposes. It does not
require installation.
Configuration of the system is done by running a setup.bat file. Configuration is similar to configuration of
NaftaPOS software for operation with PTS controller (see section “Configuration of NaftaPOS software to
work with PTS controller” above):
Dispensing
progress bar
PTS controller .NET application is provided on both C# and VB.NET languages and requires .NET Framework
2.0 for operation.
Note: connection with PTS controller is made through a 3-wire realization of RS-232 interface, an
asynchronous half-duplex channel, baud rate 57600 baud without a parity check. This configuration is
hardly coded inside a program.
Configuration allows to set pump channels, ATG channels, parameters in PTS controller. It is quite
convenient to use and open source code helps to understand better how the PTS controller works.
Pumps configuration tab allows to configure pumps channels of PTS controller (like PTS_conf.exe utility):
ATGs configuration tab allows to configure ATGs channels of PTS controller (like PTS_conf.exe utility):
Parameters tab allows to read/write parameters in PTS controller (like PTS_conf.exe utility):
Tab “Version information” allows to reseave information about date and version of PTS controller firmware
release and also a list of supported communication protocols of pumps and ATG systems (like PTS_conf.exe
utility):
Main view
In main view 8 fuel point icons are shown on the screen, which are to be linked to physical fuel points and
show its state.
Given window contains a dropdown list with all 4 pump channels of the PTS controller, selecting each of
which leads to displaying of all fuel points’ IDs and corresponding fuel points’ addresses configured to given
pump channel for a PTS controller in a field below. Selecting one of the fuel point IDs and pressing OK
button leads to linking given fuel point icon to selected fuel point ID and displaying its status. Selecting of a
PTS pump channel with value 0 will lead to switching off a fuel point icon.
Given window for each of the fuel points also contains a list of 6 nozzles for setting of prices per 1
liter/gallon of fuel, dispensed through these nozzles, in a range 0,00 – 999,99. If a fuel point has less than 6
nozzles – prices will be set only for first number of nozzles, which a fuel point has.
Clicking ‘Set prices’ button leads to updating prices on selected fuel point. Clicking ‘Get prices’ leads to
receiving of prices from selected fuel point.
Clicking OK button leads to updating a fuel point icon and updating (creating) a file “Config.xml” in root
folder with configuration of fuel point icons. At launching of a PTS controller .NET application next time
configuration of fuel point icons will be read from this file “Config.xml” in root folder.
In the end of every dispensing application itself reads total counters from the pump on the nozzle, whih
was dispensing. At this a sign of totals reading appears in the left top corner of the pump icon (and under
the header of the ‘T’ command is displayed, which means that currently PTS controller processes
TotalInfoRequest command).
Total counters can be updated at any moment from any of the pumps. Selecting of a button “Totals” on a
fuel point icon and clicking a button Update in it leads to reading of total counters:
Settings
Selection from top menu “Configuration” an item “Settings” leads to opening a new window, which allows
adjustment of
In ATG view 4 ATG icons are shown on the screen, which are to be linked to physical ATG systems (probes)
and show its state.
Each of the displayed ATG icons contains information about measured by ATG system (probe) parameters
of petroleum product inside tanks. Depending on the type (communication protocol) of ATG system (probe)
the following data may be displayed:
- Product level (accuracy 0.1 mm)
- Product volume (accuracy 1 liter)
- Product temperature compensated volume (accuracy 1 liter)
- Product ullage (volume) (accuracy 1 liter)
- Water level (accuracy 0.1 mm)
- Water volume (accuracy 1 liter)
- Temperature (accuracy 0.1 degree Celcium)
- Product density (accuracy 0.1 kg/m3)
- Product mass (accuracy 0.1 kg)
If ATG system does not support any the parameters – a correspondent value label on ATG icon stays
disabled. Picture of a tank on the ATG icon shows visually level of product in tank compared to tank height
(which should be equal to ATG probe height). If ATG icon is linked with an ATG system – its state is
“ACTIVE”, else – “NOT ACTIVE”.
PTS COM-object
In order to provide control over PTS controller and simplify work of developers, who are working in
Windows OS in implementation of UniPump communication protocol of PTS controller, a COM-object with
methods and properties for operation with PTS controller is provided.
COM-object is compiled on Visual C++ 6.0 and is supplied together with a test application, written on Visual
Basic 6.0.
Documentation of COM-object describes all methods and properties of the COM-object and its application.
REGSVR32 PTSDriver.dll
from
PTS_SDK\API TOOLS\COM_object_API_plus_VB6.0_appilcation.rar\PTSDriver\ReleaseMinDependency\
folder.
Purpose
PTS controller test utility is written in the following languages:
C#
VB 6.0
VB.NET
Java
It is written for developers in order to give open source test application, which shows how to communicate
with PTS controller using commands from UniPump communication protocol without a necessity to
implement this protocol from zero.
Utility provides all operations with a PTS controller. Thus developers using one of the above languages can
view how control over PTS controller is provided in the utility and implement the same functions in own
developed applications for petrol stations.
C# (developed in Visual Studio Express 2010) VB.NET (developed in Visual Studio Express 2010)
Purpose
PTS terminal is used in order to provide debugging of PTS controller operation. It allows to send to PTS
controller requests formed with bytes in accordance with UniPump communication protocol commands
without a necessity to add framing bytes and CRC.
This utility can be useful during development of own control software, when developers can test sending of
commands to PTS controller and receive its responses using this utility and in such a way compare then
with responses processed in own developed control software.
Purpose
PTS controller SDK includes a pumps software simulator with a purpose to enable debugging of PTS
controller implementation in third party software. Purpose of software simulators is to debug operation of
control system software (cash register, POS system, OPT, etc) over fuel dispensers through PTS controller
without a necessity to connect to real fuel dispensers.
Dispensed volume,
Main view money amount and price
total counters
Selection and Simulation of Pump mode of Volume and money Selection of nozzle to State of
opening/closing presence operation total counters take up/down and its pump
of a COM-port trigger state
Pump physical
address
Each of the pumps can be transferred to automatic mode of operation (controlled from the control system)
or manual mode of operation (controlled manually and does not response to control system).
In right-click mouse menu it is possible to preset the pump with money amount or volume value, stop the
pump, reset, pause and change volume:
Configuration
Configuration of the pumps simulator includes configuration of:
communication settings, which include setting of baud rate, number of data bits and stop bits,
parity control
quantity of pumps (physical address is set on each pump control independently)
technical characteristics of the pumps in simulator (flow rate, slow flow rate (when flowdown valve
is on), quantity of pulses before the flowdown valve is switched on
Pumps simulator can simulate presence at the pumps – take up nozzles and make dispensing in random
way thus making it possible to debug control system software as if it was operating on real petrol station.
Log window of the pumps simulator enables to see all the requests and responses in communication and
their respective data.
For communication of PTS controller with the UniPump pumps software simulator it is necessary to select
in PTS controller configuration of the pump channel communication protocol “2. UNIPUMP” and select
appropriate baud rate (equal to set in simulator (9600 baud rate by defaults) and set pumps physical
addresses equal to those, which are set for pumps in simulator. Also it is necessary to set parameters to
UniPump protocol for each of the pumps in PTS controller configuration (see image below):
1. Parameter “Multiplier of dose” set equal to 1.
2. Parameter “Protocol type” set equal to “UniPump standard protocol” in case if protocol type is set to
“Standard UniPump” in pumps simulator or “Extended protocol for PTS controller” in case if protocol
type is set to “Extended UniPump for PTS controller” in pumps simulator.
Purpose
PTS controller SDK includes a ATG probes software simulator with a purpose to enable debugging of PTS
controller implementation in third party software. Purpose of software simulators is to debug operation of
control system software (cash register, POS system, OPT, etc) over ATG systems through PTS controller
without a necessity to connect to real ATG systems or probes.
Main view
Selection and Simulation of ATG probe measurements
opening/closing presence (allows enable/disable any of the
Connection state
of a COM-port measured parameters)
Each of the ATG probes can be transferred to connected (responses to PTS controller) or disconnected
(does not response to PTS controller) state.
Configuration
Configuration of the pumps simulator includes configuration of:
communication settings, which include setting of baud rate, number of data bits and stop bits,
parity control
quantity of ATG probes (physical address is set on each probe control independently)
selection of graphical skin
Log window of the probes simulator enables to see all the requests and responses in communication and
their respective data.
For communication of the PTS controller with UniProbe ATG probes software simulator it is necessary to
select in PTS controller configuration of the ATG channel communication protocol “9. UNIPROBE” and
select appropriate baud rate (equal to set in simulator (9600 baud rate by defaults) and set probes physical
addresses equal to those, which are set for probes in simulator. Also it is necessary to set parameters to
UniPump protocol for each of the pumps in PTS controller configuration (see image below):
3. Parameter “Multiplier of dose” set equal to 1.
4. Parameter “Protocol type” set equal to “UniPump standard protocol” in case if protocol type is set to
“Standard UniPump” in pumps simulator or “Extended protocol for PTS controller” in case if protocol
type is set to “Extended UniPump for PTS controller” in pumps simulator.
Purpose
In order to simplify understanding of PTS controller SDK operation and assembling this step-by-step
instruction is provided. It describes basic steps to be made with PTS controller SDK to assemble it correctly
and also to install and configure software coming in its structure.
In this step-by-step instruction we will connect 1 pump simulator and 1 ATG probes simulator. Scheme of
connections should be the following:
So, PTS controller is to be connected to a COM-port of the PC using cable C013-1 (cable C013-1 comes
mounted to the PTS SDK box with inscription “RS-232 (control system)”). Connection can be made through
a cable C014-1, which serves as a prolonger of the COM-port.
RS-232/RS-485 interface converter board serves for connecting of PTS controller pump channels (in RS-485
interface) with COM-port of PC (which is in RS-232 interface), on which pumps software simulator is to be
launched. RS-232/RS-485 interface converter board has 2 independent conversion circuits. Input cable is
C018-1 (RS-485 interface), output cable is C020 (RS-232 interface).
On tab “Pumps” click on a button “PTS configuration” and set “2. UniPump” protocol and “4. 9600” baud
rate for pump channel 1. Adjust pumps 1 – 8 for pump channel 1 and write configuration.
As parameters for UniPump protocol set default parameters for each of the enabled pump:
In configuration of ATG channels set “2. START_ITALIANA SMT-XMT” protocol and “4. 9600” baud rate for
USER ATG channel. Adjust ATGs 1 – 8 for USER pump channel and write configuration.
Close PTS controller configuration utility and go to POSSet tab “General”, where set configuration as
shown on screen shots:
Go to tab “Drivers” and set for a cash register a driver “Void cash register driver”:
Go to configuration of “PTS controller” driver and set there the following configuration on tab
“Controllers”:
Number of COM-port, to which PTS controller is connected
Enable pumps 1 – 8
Set “Use pumps electronic totalizers”
After specifying the COM-port number click on the button “Test”. The opened Window should show “OK”
statuses, which say that PTS controller is connected to the system and is responding correctly. In case if
you see any errors – there are mistakes in connection or configuration of the equipment.
On tab “Pumps” it is necessary to set for each of the configured pumps a correspondent number of the
pump in controller:
Pump #1 → 1
Pump #2 → 2
…………………
Pump #8 → 8
Also for each of the selected pump nozzle mask should include all nozzles (from 0 to 5).
Go to configuration of “PTS ATG” driver and set there the following configuration:
As drivers of “Barcode scanner”, “Controller service”, “Tanks service” leave the drivers, which are set as
default.
Go to tab “Order” and check that configuration is set as shown on the screenshot:
On tab “Pump modes” set the check that all modes are switched on:
Now PTS controller is configured to work with a pumps software simulator and also ATG software
simulator.
Run SimUniPump.exe and go to configuration of its properties. Set properties as shown on screenshot:
After properties are set click OK and on the main form select a COM-port, to which the output of RS-
232/RS-485 interface converter board is connected, and click “Open” button:
After COM-port is opened in case all equipment is correctly connected and configured – you should see
blinking of the green and red LEDs on pump channel 1 of the PTS controller:
In case if only green LED is blinking on pump channel 1 – there is a mistake in connection or configuration
of equipment.
Run probe_simulator.exe and go to tab “Config. Select a COM-port, to which the cable C029-3 is connected,
and click “Apri porta” button as shown on screenshot:
Go to tab “Sonde 1-8”, where set some values for measurement of temperature, product and water levels
for each of the probes:
After COM-port is opened in case all equipment is correctly connected and configured – you should see
blinking of the green and red LEDs on USER channel of the PTS controller happening once per 2 seconds:
In case if only green LED is blinking on USER channel – there is a mistake in connection or configuration of
equipment.
After the system loads open a new shift (“Shift” → “New shift”) using your login / password (if default user
credentials were not changed – then by defaults after installation there is only 1 user present with login
‘Service’ and no password (adding of other users and changing of passwords is made in configuration utility
POSSet).
After start the system will ask you to adjust the prices for fuel in tanks:
After that you will need to place icons of pumps on the screen as it is comfortable for you and make their
scale as you need. This is made only once. After that in right-button menu of each of pump icons select
“Save attributes”:
Total counter values from dispensers can be read using a main menu item “Pumps” → “Totalizers”
For viewing of fuel parameters in tank select a main menu item “Fuel” → “Fuel in tanks” and you will be
able to view measurements of the ATG probes:
Also remains of fuel in tanks is possible to view from main form of NaftaPOS. For this select a main menu
item “View” → “Table of tanks”:
Now the NaftaPOS system correctly works with pumps and ATGs software simulators.
Open a COM-port and go to main menu item “Configuration” → “Fuel point configuration settings”.
Make sure that all pumps channels and ATG channels are configured correctly:
In main form of the application for each of the fuel point icons go to setting (“Settings” button) and set a
correspondent fuel point number (from fuel point channel 1) and prices for each of the nozzles:
Fuel point icon #1 → FuelPoint ID = 1, Address = 1
Fuel point icon #2 → FuelPoint ID = 2, Address = 2
…..…..…..…..…..…..…..…..…..…..…..…..…..…..…..…..…..
Fuel point icon #1 → FuelPoint ID = 8, Address = 8
Now the main form of the application allows to provide control over pumps in pump software simulator:
To view the measurement by the ATGs in PTS application go to main menu item “ATG” → “ATG
measurement data”, where for each of the ATG icons in settings set configuration of ATG to get
measurement values and also set tank’s height:
Now PTS application is able to indicate current level measurement data from ATG system:
NOTE! In case of necessity to debug operation with PTS controller and there are no software simulators
present (or equipment to do this) it is comfortable to use built-in simulators of pumps and ATGs in PTS
controller (read more in sections “BUILT-IN PUMP SIMULATOR” and “BUILT-IN ATG PROBE SIMULATOR”.
+5 V
GND
GND
+12 V
Cable C027
Cable C027
Cable C027
Cable C027
Cable C027
Connection to Wayne Dresser dispenser is made directly without any interface converter.
Configuration of PTS controller: protocol WAYNE Dart, baud rate 9600.
+5 V
GND
GND
+12 V
Cable C027
Cable C027
Cable C012-1
(connector X1)
Cable C012-1
(connector X1)
TTD
DCC
TTC
TTD
TTC
TTD
TTC
TTD
Cable C012-1
(connector X1)
GND
24 V
Rx+
Rx+
Tx+
Tx+
Rx-
Rx-
Tx-
Tx-
Nuovo Pignone dispenser board
+5 V
GND
GND
+12 V
Cable C027
Cable C027
DIP-switch for
address setting
Address setting on S&B T20 interface converter board using a DIP switch
Address 1&2 3&4 5&6 7&8 9 & 10 11 & 12 13 & 14 15 & 16
DIP 1 OFF OFF OFF OFF ON ON ON ON
DIP 2 OFF OFF ON ON OFF OFF ON ON
DIP 3 OFF ON OFF ON OFF ON OFF ON
DIP 4 OFF OFF OFF OFF OFF OFF OFF OFF
+5 V
GND
GND
+12 V
Cable C027
S4 computer
+5 V
GND
GND
+12 V
Cable C027
Petposan-Beta CPU
+5 V
GND
GND
+12 V
Cable C027
+5 V
GND
GND
+12 V
Cable C027
RS-232 port
RS-232 port
RS-232 port
RS-232 port
RS-232 port
RS-232 port
RS-232 port
RS-232 port
Cable C028-1
Cable C033 Cable C029-3
Cable C012-1
Cable C013-1
CABLE C013
CABLE C015
CABLE C020
CABLE C029-1
CABLE C029-3
CABLE C055
Bottom view
Cable C013
Cable C028
Bottom view
Cable C013
Cable C028