PTS 1 Controller Technical Guide
PTS 1 Controller Technical Guide
PTS 1 Controller Technical Guide
TECHNICAL GUIDE
(PCB board modification: PTS-1, revision: PTS-U5-v7)
CONTENT
REVISION HISTORY ................................................................................................................................................ 6
PURPOSE OF THE DOCUMENT .............................................................................................................................. 7
TECHNICAL FEATURES ........................................................................................................................................... 8
Appointment ................................................................................................................................................. 8
General specification ..................................................................................................................................... 8
SUPPORTED BRANDS OF FUEL DISPENSERS AND REGISTER METERS ................................................................... 9
SUPPORTED BRANDS OF ATG SYSTEMS AND PROBES ........................................................................................10
BOARD CONNECTORS AND INTERFACES.............................................................................................................11
COMMUNICATION PORTS ...................................................................................................................................12
COMPLETE SET ....................................................................................................................................................13
CONNECTION TO POWER SUPPLY .......................................................................................................................14
CONNECTION TO CONTROL SYSTEM...................................................................................................................15
INSTALLATION REQUIREMENTS FOR PETROL STATION ......................................................................................16
CONNECTION TO FUEL DISPENSERS ...................................................................................................................18
CONNECTION TO ATG SYSTEMS AND PROBES ....................................................................................................19
SENDING OF PUMPS SALES DATA TO CONSOLES ...............................................................................................20
CONVERSION BETWEEN PUMPS PROTOCOLS ....................................................................................................21
CONVERSION BETWEEN ATG CONSOLES PROTOCOLS .......................................................................................22
MONITORING OVER FUEL DISPENSERS AND TANKS ...........................................................................................23
FUEL DISPENSERS SALES DATA FOR ATG CONSOLES FOR RECONCILIATION ......................................................24
PTS-1 CONTROLLER MULTI POS SYSTEMS OPERATION ......................................................................................25
PTS-1 CONTROLLER CONFIGURATION AND TESTING UTILITY ............................................................................26
General information .................................................................................................................................... 26
Scheme of connections ............................................................................................................................... 27
Starting PTS configuration utility ............................................................................................................. 27
Tab “General” .............................................................................................................................................. 28
Tab “Pumps configuration” ......................................................................................................................... 29
Tab “Probes configuration” ......................................................................................................................... 30
Tab “Parameters” ........................................................................................................................................ 31
Tab “Control” ............................................................................................................................................... 33
Tab “Logging” .............................................................................................................................................. 35
Tab “Firmware update” ............................................................................................................................... 40
Tab “Diagnostics ”........................................................................................................................................ 44
BUILT-IN PUMPs SIMULATOR .............................................................................................................................46
BUILT-IN ATG PROBEs SIMULATOR .....................................................................................................................48
PTS-1 controller API (APPLICATION PROGRAMMING INTERFACES) ...................................................................50
C and C++ API............................................................................................................................................... 51
C# PTS-1 controller configuration and testing utility .................................................................................. 53
C# application .............................................................................................................................................. 55
C# API........................................................................................................................................................... 57
Delphi API .................................................................................................................................................... 59
Java API ........................................................................................................................................................ 61
Python API ................................................................................................................................................... 63
Visual Basic .NET PTS-1 controller configuration and testing utility ........................................................... 65
Visual Basic .NET application ....................................................................................................................... 67
Visual Basic .NET API.................................................................................................................................... 69
PTS-1 controller COM-object for MS Windows OS ..................................................................................... 71
www.technotrade.ua page 2 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
REVISION HISTORY
R04 2018.11.17 Evgeniy Supported communication protocols, Updated list of supported communication
Vasyliev examples of connection schemes protocols of fuel dispensers and ATG systems,
added examples of connection to fuel dispensers
and ATG systems
R05 2019.03.01 Evgeniy Supported input communication protocols Communication with PTS-1 controller using pump
Vasyliev and ATG consoles protocols
Technotrade LLC
Ukraine, 04114 Kiev, Priorska str. 10, office 1
Tel: +38-044-502-46-55, +38-044-502-46-77
Web: www.technotrade.ua
Mail: mail@technotrade.ua
TECHNICAL FEATURES
Appointment
PTS-1 controller over fuel dispensers and ATG (automatic tank gauge) systems for petrol stations serves
as a protocols converter. It knows communication protocols of a great variety of fuel dispensers and ATG
probes and allows control over any of them in exactly the same way using its own input communication
protocol or popular pumps and ATG systems communication protocols. POS system (cash register, payment
terminal) should not matter what is the brand of fuel dispenser or ATG system connected – it simply
communicates to the PTS-1 controller the same way regardless the brand of fuel dispensers and ATG
systems used, PTS-1 controller undertakes all work on communication with fuel dispensers and ATG
systems using their native communication protocol and takes into account all their peculiarities.
This completely simplifies work for a POS system developer: by having implemented input common
communication protocol of PTS-1 controller the POS becomes able to provide control over any of fuel
dispensers and ATG systems supported by PTS-1 controller. PTS-1 controller itself converts input
communication protocol into proprietary communication protocols of fuel dispensers and ATG systems.
Thus, the time required for development of POS system for petrol stations is significantly reduced.
PTS-1 controller can be called a forecourt controller and can be used together with POS systems, cash
registers, OPTs (outdoor payment terminals) and other control systems for petrol stations in order to
provide control over fuel dispensers, LPG (liquified petroleum gas) dispensers, CNG (compressed natural
gas) dispensers and various brands of ATG systems at petrol stations and storage depots.
PTS-1 controller is supplied with a rich set of APIs (application programming interfaces) developed under
most popular programming languages and environments in order to provide comfortable and quick
implementation of the PTS-1 controller into control systems for petrol stations (POS system, cash register,
OPT terminal, etc).
General specification
## PARAMETER VALUE
1 Power supply voltage 12 V DC
2 Current consumption 400 mA max
3 Temperature range -40°C ÷ +80°C
4 Weight 120 g
5 Overall dimensions 85 x 58 x 30 mm
* Communication parameters (baud rate, parity control, data and stop bits) are configured for probe ports
in PTS-1 controller independently from used communication protocol
PTS-1 controller is supplied together with terminal blocks for each of the connectors for screwing of
connection wires.
COMMUNICATION PORTS
Pump RS-485
dispensers).
port 3 (2 wires: line A, line B)
It is required to use shielded cable, which shield is
connected to ground on the side of connected pump.
Connection with fuel dispensers using configurable
proprietary communication protocol (up to 16 fuel
Pump port RS-485
dispensers).
4 (2 wires: line A, line B)
It is required to use shielded cable, which shield is
connected to ground on the side of connected pump.
1. PTS-1 controllers interconnection (up to 16 PTS-1
controllers) for simultaneous control over the same
fuel dispensers and ATG systems
2. Connection with ATG systems (probes) using
DISP port RS-485
configurable proprietary com. protocol (up to 16 ATG
(RS-485) (2 wires: line A, line B)
probes)
It is required to use shielded cable, which shield is
connected to ground on the side of connected ATG
system (probe).
Connection with ATG system (console) using configurable
DISP port RS-232
proprietary communication protocol (up to 16 ATG
(RS-232) (3 wires: TxD, RxD, Gnd)
probes).
PROBE PORTS
Manufacturer reserves a right to bring in modifications in construction of controller for improving of its
technical and functional characteristics, so supplied version of controller may differ from described in given
technical guide.
Warning! This is a class A product. In a domestic environment this product may cause radio interference in
which case the user may be required to take adequate measures.
COMPLETE SET
Depending on the order code (see section “Order information”) PTS-1 controller can be supplied either in a
view of electrical board (variant of controller supply PTS1-PCB-z), or installed in a mounting box with cables
inputs and a power switching button (variant of controller supply PTS1-BOX-z).
Variant of controller supply installed in a plastic box with cables inputs and a power switching button
(variant of controller supply PTS1-BOX-z)
Ferrite ring coil should be located on the power supply cable nearby (up to 3 cm) the power supply
connector of controller board (in case if controller is supplied in a view of electrical board, variant of supply
PTS1-PCB-z) or nearby the power supply cable input of box (in case if controller is supplied in plastic box,
variant of supply PTS1-BOX-z). After placing a ferrite ring on the power supply cable, it is required to check
correctness of its installation, it is possible to check it by moving ferrite ring along the power supply cable
by pushing power supply cable into it from one side and pulling the cable from another side of the ferrite
ring.
Connection to the control system (POS system, cash register, OPT terminal, etc) is made through a PC port,
which has RS-232 interface (3 wires: TxD, RxD, Gnd).
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, Ethernet-to-COM, Bluetooth-to-COM, other converters).
Communication with PTS-1 controller is made using commands and responses described in UniPump
communication protocol (own proprietary protocol of Technotrade LLC) – see document “UniPump
communication protocol specification for PTS-1 controller over fuel dispensers and ATG systems” for more
information. Thus, PTS-1 controller provides conversion of the common communication protocol UniPump
into various proprietary communication protocols of fuel dispensers and ATG systems.
WARNING! Manufacturer guarantees reliable and stable operation of products only at compliance with
below requirements. In case of absence of uninterruptible power supply or incorrect wiring of products
to it any claims to malfunction of software are not accepted.
The described products come into structure of control system (POS) for petrol station. Power supply of the
products should be done from a separate power supply with built-in filter of radio frequency interferences
and limiter of high voltage pulse interferences. Power supply should have a safety factor of 1.5.
At emergency switching off the power supply or in case of power voltage exceeding its permitted ranges
the products can switch off with loss or corruption of data and possible damage of hardware and software.
Power supply of all electronic blocks of POS and electronic pumpheads of dispensers, which are connected
through information lines, should be made from single common uninterruptible power supply source (UPS).
Connection of other devices to given UPS is strictly prohibited. UPS should be of continuous action (online)
and work with double conversion with output voltage regulation. UPS should have a safety factor of 1.5.
Filter of radio frequency interferences and limiter of high voltage pulse interferences should be used for
feeding equipment from UPS.
Supply of electronic pumpheads of dispensers should be made from the UPS unit using 3-wires scheme
with isolated neutral through dedicated two-pole breaker for each dispenser. Connection of other parts of
dispenser to UPS unit (expect electronic pumpheads) is strictly prohibited.
UPS unit should be connected to a separate three-pole socket fed through the three-wire feeder (phase,
neutral, ground wires) with insulated neutral from a dedicated circuit breaker of switchboard. Feeder
coming from the switchboard to the socket should located not closer than 0.3 meters to other feeders. The
socket should be located at a distance of not more than 1 meter away from the POS. Phase wire of the
feeder should not have any other consumer, which are sources of interferences (for example motors).
For protection of POS and UPS from secondary effects of atmospheric electricity it is required to install
high-voltage arresters (dischargers) at the transformer substation or on poles of power lines.
2. Requirements to grounding
In the switchboard the ground wire of feeder socket should be connected to the grounding screw, which
should be connected by means of welding with a protection grounding circuit of petrol station by steel wire
with a diameter of not less than 5 mm.
Protection grounding circuit of petrol station should correspond to safety requirements and be separated
from the station lightning protection circuit. Distance from the nearest electrode of protection grounding
circuit to electrode of lightning protection circuit must be at least 10 meters. Resistance of the protection
grounding circuit should be not more than 4 Ohms and must be confirmed by the test report. Length of
wires from the switchboard to the nearest electrode of protection grounding circuit should not exceed 15
meters.
Laying of power and information wires to dispensers should be done in separate pipes with distance of not
less than 0.3 meters between each other. For informational wires (current loops, RS-485, other interfaces)
it is recommended to use shielded twisted-pair cables (recommended type – FTP CAT 5E). The cable shield
must be connected to the ground connector on one side only – on the side of the dispenser.
PTS-1 controller can simultaneously control up to 16 fueling places (16 sides of 1-sided dispensers or 8 sides
of 2-sided fuel dispensers or mixture of 1-sided and 2-sided dispensers) that use up to 4 various
communication protocols (each of the pump ports can be adjusted to a separate communication protocol
and baud rate and can connect up to 16 fueling places) (see section “Examples of connection to fuel
dispensers”).
So, you can connect in total 16 pumps to the same pump port or you can distribute all the 16 pumps
between the any of the pump ports.
NOTE: if there are less than 4 various types of fuel dispensers at petrol station (which use various
communication protocols) then it is recommended to distribute fuel dispensers between 4 PTS-1 controller
ports in approximately equal quantities in order to minimize delays between fuel dispensers querying in the
same pump port.
PTS-1 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 probe
ports 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 port provides a possibility to connect ATG system (probes) over either RS-485 or RS-232
interfaces – interface is selected using a configuration parameter in PTS-1 controller.
At communication to ATG consoles PTS-1 controller can be used for sending fuel dispensers sales data to
consoles in order to make console provide tanks reconciliation reports and automatic tanks calibration:
In case if POS system already knows some open communication protocol of dispensers then it can use PTS-
1 controller for its conversion to any other pump protocols without any additional integration.
Communication of PTS-1 controller with control system (POS system, cash register, OPT terminal, etc) for
provision of control over dispensers can be done using popular open pump protocols. At this connection is
made through one of the pump ports, which has RS-485 interface (2 wires: A, B). Any of the pump ports can
be configured to work as input port for communication with control system.
Scheme of connections:
In this case the control system should know pump communication protocol. PTS-1 controller in this case
serves as a protocols converter: converts input pump protocol into any other supported pump protocols.
At this control over pumps can be done in parallel from control systems connected through pump port and
PC port, PTS-1 controller internally tracks which control system locks control over dispensers:
In case if POS system already knows some open communication protocols of ATG consoles then it can use
PTS-1 controller for its conversion to any other ATG console or probe protocols without any additional
integration.
Communication of PTS-1 controller with control system (POS system, cash register, OPT terminal, etc) for
getting measurement data from probes can be done using popular open ATG console protocols. At this
connection is made through one of the probe ports, which has RS-232 interface (3 wires: TxD, RxD, Gnd) or
RS-485 interface (2 wires: A, B). Any of the probe ports can be configured to work as input port for
communication with control system.
Scheme of connections:
In this case the control system should know communication protocol of ATG console. PTS-1 controller in
this case serves as a protocol’s converter: converts input ATG console protocol into any other supported
ATG consoles and probe protocols.
In case if there is an existing POS system already installed on the station PTS-1 controller allows to monitor
operation of the fuel dispensers and tanks (and optionally to make sales when required). At this PTS-1
controller is connected between existing POS system and fuel dispensers and ATG console (tank probes),
PTS-1 controller communicates with fuel dispensers and ATG console (probes) using their proprietary
communication protocols and with POS system – using open communication protocols for pumps and ATG
console. Monitoring system can connect to PC port of PTS-1 controller and get all data of fuel dispensers
sales and tanks real time, at this it can also provide control over the dispensers when required.
Scheme of connections:
PTS-1 controller can be applied for listening of communication exchange between POS system and
dispensers and sending of dispensers’ transactions to the ATG console for provision of tanks’ reconciliation
and automatic calibration. Installation of the PTS-1 controller between POS system and dispensers solves
this problem without any additional integration from the side of POS system.
Additionally, it is possible to apply PTS-1 controller inside the casing of the ATG console. At this a scheme of
connection specified on the above image is saved, but at some extra development of the console GUI it is
possible to make a completely new function of the console – provision of monitoring and control over
dispensers from the console in parallel with POS system. As a result, the console becomes a common
system of control, monitoring and account providing:
- connection of console to any POS system, OPT terminal for provision of control over dispensers
- possibility to connect various brands of probes, which communication protocols are not supported by
the console
- transmission from PTS-1 controller to console data on sales transaction of dispensers for formation of
reconciliation reports and automatic tanks calibration
- additional possibility to monitor and control fuel dispenser operation from the console display in
parallel to POS system already installed at petrol station (needs update of console software)
Scheme of connections:
NOTE! In order to enable PTS-1 controller interconnection interface of DISP port should be configured to
RS-485 in configuration parameters of PTS-1 controller and DISP port should not be configured for any ATG
system (see section “PTS-1 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-1 controller connected. PTS-1 controllers should be interconnected with
each other through a dispatcher PTS port (DISP port on RS-485 interface) and also connected with fuel
dispensers. Thus control over each fuel dispenser at petrol station can be made from every POS system and
each PTS-1 controller will know measurement data of every ATG probe connected to any of the
interconnected PTS-1 controllers. At authorization of a fuel dispenser from one POS system the fuel
dispenser becomes locked by PTS-1 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-1 controller of this POS
system unlocks the fuel dispenser and it becomes commonly available for all other PTS-1 controllers, which
makes it possible to be controlled (locked) by any of the PTS-1 controllers connected to other POS systems.
NOTE! In order to provide control over same fuel dispensers from several PTS-1 controllers locking and
unlocking of dispensers is required. For this reason in configuration of PTS-1 controller in parameters for
PTS-1 controller “Lock” and “Unlock” commands should be set to be used (see section “Configuration of
parameters for PTS-1 controller”).
NOTE! In order to provide correct exchange of ATG systems measurement data between interconnected
PTS-1 controllers logical addresses of connected ATG probes in configuration of interconnected PTS-1
controllers should not intersect (have various values in different PTS-1 controllers).
PTS-1 controller configuration and testing utility Pts_config.exe is a multipurpose utility for PTS-1 controller.
It provides the following possibilities:
- provision of control over the connected pumps and probes
- configuration of pumps (fuel dispensers) ports and probes (ATG systems) ports
- configuration of PTS-1 controller parameters
- update of the PTS-1 controller firmware
- logging of PTS-1 controller communication exchange with connected equipment
- self-diagnostics of PTS-1 controller communication ports and switches
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, Bluetooth-to-COM etc).
Tab “General”
NOTE! Pay attention that the PTS-1 controller is using latest version of the firmware. Latest version of
firmware can be received upon request from Technotrade LLC company or downloaded from Technotrade
LLC company website. Normally new firmware for PTS-1 controller is issued together with PTS configuration
utility update having latest features of PTS-1 controller, so updated version of the PTS-1 controller
configuration utility Pts_config.exe should be also requested and downloaded. Information on how to
update PTS-1 controller firmware please find below in section “Tab ‘Firmware update’”.
In case if firmware version used in PTS-1 controller is older than required for Pts_config.exe utility – then a
warning message about it will appear in Events review field.
A list of all supported communication protocols and baud rates by PTS-1 controller as well as description
and settings of all parameters are described in file pts_config_en.xml (file may have other name depending
on the used language).
www.technotrade.ua page 28 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Tab “Pumps configuration” is used for reading and writing of configuration of pump ports in PTS-1
controller.
Configuration of pump ports includes setting of communication protocol and baud rate for each of the
pump ports and also assigning of pumps to each of the pump ports. Each of the pumps can be assigned to
any of the pump ports and requires specification of the pump physical address.
Logical address of the pump means the address on which the control system (POS system, cash register,
OPT, etc) will see given fueling place. Physical address of the pump means address of the real fueling place,
which is programmed or set in configuration of the fuel dispenser fueling place.
For some pump protocols it is also necessary to configure parameters, which is to be done on tab
“Parameters” of the utility. Button “Param.” is used to transfer to “Parameters” tab to configure
parameters for the selected pump. Button “Configure pump parameters now” is used to transfer to
“Parameters” tab to configure parameters for all pumps.
After configuration is finished it is necessary to click a button “Set pumps configuration”, which will write
current pump ports 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 events review field on the form.
www.technotrade.ua page 29 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Tab “Probes configuration” is used for reading and writing of configuration of probe ports in PTS-1
controller.
Configuration of probe ports includes setting of communication protocol and baud rate for each of the
probe ports and also assigning of probes to each of the probe ports. Each of the probes can be assigned to
any of the probe ports and requires specification of the probe physical address.
Logical address of the probe means the address on which the control system (POS system, cash register,
OPT, etc) will see given probe. Physical address of the probe means address of the ATG system probe,
which is programmed or set in configuration of the ATG system console or probe.
For some probe protocols it is also necessary to configure parameters, which is to be done on tab
“Parameters” of the utility. Button “Param.” is used to transfer to “Parameters” tab to configure
parameters for the selected probe. Button “Configure pump parameters now” is used to transfer to
“Parameters” tab to configure parameters for all probes.
After configuration is finished it is necessary to click a button “Set probes configuration”, which will write
current probe ports 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 events review field on the form.
www.technotrade.ua page 30 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Tab “Parameters”
All parameters are listed in a table with detailed description. Default parameters values are specified in a
separate column. To get a current value of the parameter it is necessary to read them from PTS-1
controller.
Configuration of PTS-1 controller parameters includes various adjustments for PTS-1 controller operation.
Some of the pumps and probes communication protocols also require setting of parameters. These
parameters are set for the specified logical address of the pump (or probe) and do not refer to other pumps
(or probes) in the PTS-1 controller.
Description and settings of all parameters as well as a list of all supported communication protocols and
baud rates by PTS-1 controller are described in file pts_config_en.xml (file may have other name depending
on the used language).
Parameters for probe – Gilbarco Veeder Root communication protocol parameters for probe 1
www.technotrade.ua page 32 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Tab “Control”
Tab “Control” serves for provision of control over connected pumps and probes.
Section “Pumps” is used for displaying state of all 16 pumps of PTS-1 controller, current taken up nozzle,
state whether the pump is locked by PTS-1 controller, currently executed command and also volume,
money amount and price of dispensed fuel. Selection of the pump is made by selecting a pumps row in a
table.
Section “Pump order” is made for provision of control over the pumps:
- selection of pump
- field for setting a dose to be dispensed by selected pump
- selection of operation mode: volume preset, money amount preset, full tank
- commands to be given to selected pump: authorize, stop, suspend, resume, get total counters, get and
set price, get tag ID, turn lights on or off.
- fields for getting/setting prices of each nozzle of the selected pump
Section “Probes” is used for displaying measurement data of each of 16 probes of PTS-1 controller.
Tab “Logging”
Tab “Logging” serves for logging of communication exchange between the PTS-1 controller and connected
pumps or probes.
With a reason to quickly locate and remove possible bugs in PTS-1 controller communication with
connected equipment (fuel dispensers and ATG systems) PTS-1 controller has a possibility of logging of its
exchange with connected equipment. Use Pts_config.exe utility to save in a control system exchange logs of
PTS-1 controller with connected equipment.
In Pts_config utility go to tab “Parameters” and there set a parameter for PTS-1 controller named “Port to
log” for the PTS-1 controller port, from which a log should be taken (see below screenshot). Save this
configuration.
On the tab “Logging” it is necessary to select a folder, where the log-file is to be stored and press “Start
log” button. Log process will be displayed in the “Log verification” section and size of the log-file capture
will be displayed on the form.
“Log verification” section displays log process by indicating the direction of currently taken log:
1. Control system transfers data to PTS
2. PTS transfers data to Control system
3. PTS transfers data to Slave device
4. Slave device transfers data to PTS
In case if there is no data transferred – the “Log verification” section displays a message “Log is not taken,
please recheck log parameters in PTS-1 controller and connections!”. If you see this message – you need to
recheck all the configuration and connections to get a log.
Each of the boxes in “Log verification” section display a direction of messages sent in PTS-1 controller
communication.
NOTE! At taking a log make sure that the red boxes on the right side blink indicating exchange between the
PTS and Slave device. If they do not blink – it means that the log of exchange on selected port is not
written, at this you should recheck your logging port parameter in PTS-1 controller parameter or check
communication between the PTS-1 controller and connected device on the specified port.
Log is accumulated to a file, size of file should be growing during the logging process, if it does not grow –
then the log is not taken, you will probably see a message “Log is not taken, please recheck log parameters
in PTS-1 controller and connections!” in “Log verification” section as described above.
Log-file has a name with indication of the time of log taken, for example: log_2014_07_04_12_14_58.bin,
which means that the log was taken on 4th of July, 2014 at 12:14:58.
In case if log process is switched on – a new log-file with a new name is created each 30 minutes (old log-
file is saved). This allows to avoid log-file overfilling when its size comes to critical to the operating system.
Thus, you can switch on logging and wait until any problem happens. When it happens and you
approximately know time of this problem – you can take appropriate (by name) log-file and send to
Technotrade LLC for analysis.
Log in accumulated in the encrypted form. After a log of exchange is taken it is required to pass a
received bin file to Technotrade LLC company for examining and elimination of possible problems, for
reasons of which it was taken.
Tab “Firmware update” servers for updating of firmware of PTS-1 controller and other interface converters.
PTS-1 controller firmware is constantly being improved and new versions of firmware with new added
communication protocols and fixed bugs of the previous firmware versions are proposed to be applied.
New versions of PTS-1 controller's firmware are always available for downloading for customers.
2. Set a PTS-1 controller parameter “ALLOW FIRMWARE UPDATE” to enable firmware update of PTS-1
controller:
On tab “Firmware update” it is necessary select the COM-port number of the PC, check that connection is
not opened (COM-port is closed) and select the firmware file before starting the firmware update process.
Firmware update process will start upon clicking on button “Start update”. In case if the firmware is not
being updated – power off the PTS-1 controller, click to start firmware update and power on the PTS-1
controller. At this the firmware update process should start.
NOTE! In order to prevent PTS-1 controller firmware from accidental update it is strictly recommended to
keep 4th DIP-switch SA1 in OFF position and disable PTS-1 controller parameter “ALLOW FIRMWARE
UPDATE” in any moment of time except for firmware update needs.
NOTE! Pay attention that your PTS-1 controller is using latest version of the firmware. Latest version of
firmware can be received upon request from Technotrade LLC company or downloaded from Technotrade
LLC company website. Normally new firmware for PTS-1 controller is issued together with PTS configuration
utility update having latest features of PTS-1 controller, so updated version of the PTS-1 controller
configuration utility Pts_config.exe should be also requested and downloaded. Information on the present
firmware version of PTS-1 controller can be checked on tab “General” (mentioned above).
Due to a reason that some firmware versions may erase all configuration of the PTS-1 controller it
recommended to save all configuration of PTS-1 controller to file before making an update (see on tab
“General” section “Save current configuration to file”) and in case if after the update the PTS-1 controller
configuration turns out to be erased – restore all the configuration from the previously saved file (see on
tab “General” section “Restore configuration from file”).
www.technotrade.ua page 42 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
NOTE! In case if an error happened during the firmware update process and PTS-1 controller became
unresponsive please make the following procedure:
1. Power off the PTS-1 controller and wait until all the LEDs on the PTS-1 controller board stop blinking or
shining.
2. In PTS-1 controller board set DIP-4 switch to ON position.
3. Connect PTS-1 controller to PC with PTS configuration utility.
4. In PTS configuration utility select the firmware update file, COM-port number and click on “Start
update” button.
5. Power on the PTS-1 controller – at this firmware update process should start automatically.
6. After the firmware update process is completed set DIP-4 switch back to OFF position.
Tab “Diagnostics ”
Tab “Diagnostics” servers for self-diagnostics of PTS-1 controller ports and DIP-switches.
Lines “RS-485 A” in of each pump port and DISP port (RS-485) should be interconnected with each other,
also lines “RS-485 B” in of each pump port and DISP port (RS-485) should be interconnected with each
other as shown on the picture.
In LOG, USER and DISP (RS-232) ports pin TxD should be shortened with pin RxD as shown on the picture.
In section “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). In case if the error counter increases its value – then the errors are
taking place.
For PTS-1 controller of version PTS-U5 area RTS channel 1 – 4 should not be taken into account cause is
used with previous versions of PTS-1 controller (PTS-U, PTS-U2, PTS-U3).
PTS-1 controller firmware between its pump protocols has a protocol “37. PUMP SIMULATOR”, which
allows to simulate presence of connected pumps. Baud rate at this can be set to any possible.
It allows to make easy debugging of control over dispensers through PTS-1 controller without real fuel
dispensers connected.
Purpose of the pump simulator protocols is to help developers in debugging of the control system software
over PTS-1 controller at absence of real dispenser pumphead for connection or software simulators of fuel
dispenser.
When protocol “37. PUMP SIMULATOR” is selected – then it is possible to debug dispensing of the pumps
without any pumphead or simulator connected to PTS-1 controller. Using parameters for this pump
protocol it is possible to set the number of taken up nozzle for every pump and also set whether the
dispensing should be done immediately or in full process.
PTS-1 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
Product level, mm 100 120 150 160 200 222.5 250 300
Measurement parameter
For ATG probes with logical addresses 2-16 there are 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 + 0.8 deg. C (example - for address 12: 12.8 deg. C)
There are parameters for “7. ATG SIMULATOR” probes protocol allowing to simulate reception of automatic
in-tank deliveries reports from ATG systems.
PTS-1 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-1 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-1 controller for provision of control over dispensers and ATG systems and
configuration of PTS-1 controller
o open-source utility for testing and indication of all operations provided by the PTS-1
controller, allows to perform all operations with the PTS-1 controller
o open source fully-functional application for provision of control over up to 8 pumps and 4
ATG systems by the PTS-1 controller, allows to perform all operations with the PTS-1
controller
o open source PTS-1 controller configuration and testing utility
− Delphi: API for communication with a PTS-1 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-1 controller for provision of control over dispensers and ATG systems and
configuration of PTS-1 controller
o open-source utility for testing and indication of all operations provided by the PTS-1
controller, allows to perform all operations with the PTS-1 controller
− Python: API for communication with a PTS-1 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-1 controller for provision of control over dispensers and ATG systems and
configuration of PTS-1 controller
o open-source utility for testing and indication of all operations provided by the PTS-1
controller, allows to perform all operations with the PTS-1 controller
o open source fully-functional application for provision of control over up to 8 pumps and 4
ATG systems by the PTS-1 controller, allows to perform all operations with the PTS-1
controller
o open source PTS-1 controller configuration and testing utility
− COM-object for PTS-1 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-1 controller for
provision of control over dispensers and ATG systems and configuration of PTS-1 controller
o open-source application in Microsoft Visual Basic 6.0 for testing and indication of all
operations provided by the PTS-1 controller, allows to perform all operations with the PTS-
1 controller
− Description of communication protocol of PTS-1 controller: describes communication parameters,
messages structure, commands and responses of communication between POS management
system and PTS-1 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.
− PtsLib - project of PtsLib.dll library for operation with a PTS-1 controller. Includes classes, methods
and properties for communication with PTS-1 controller using requests and responses described in
UniPump communication protocol for communication with PTS-1 controller for provision of control
over dispensers and ATG systems and configuration of PTS-1 controller.
− Open source utility for configuration of PTS-1 controller, provision of control over pumps and
probes, logging of operation, firmware update, self-diagnostics, others (uses classes and methods
of PtsLib.dll library).
C# application
The application for PTS-1 controller is written in C# programming language in Visual Studio 2010 Express
and requires .NET Framework 2.0.
− PtsLib - project of PtsLib.dll library for operation with a PTS-1 controller. Includes classes, methods
and properties for communication with PTS-1 controller using requests and responses described in
UniPump communication protocol for communication with PTS-1 controller for provision of control
over dispensers and ATG systems and configuration of PTS-1 controller.
− Fully-functional open source application for provision of control over up to 8 pumps and 4 ATG
systems by the PTS-1 controller, allows to perform all operations with the PTS-1 controller (uses
classes and methods of PtsLib.dll library).
Form of PTS-1 controller configuration: allows to set configuration for pumps and ATG systems ports
and also set parameters
C# API
The API for PTS-1 controller is written in C# programming language in Visual Studio 2010 Express and
requires .NET Framework 2.0.
− PtsLib - project of PtsLib_CSharp.dll library for operation with a PTS-1 controller. Includes classes,
methods and properties for communication with PTS-1 controller using requests and responses
described in UniPump communication protocol for communication with PTS-1 controller for
provision of control over dispensers and ATG systems and configuration of PTS-1 controller.
− Open-source utility for testing and indication of all operations provided by the PTS-1 controller,
allows to perform all operations with the PTS-1 controller (uses classes and methods of
PtsLib_CSharp.dll library).
Form for testing and indication of all operations provided by the PTS-1 controller
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-1 controller written in Delphi
o pts_authorize
o pts_pts_authorize_by_amount
o pts_halt
o pts_lock
o pts_unlock
o pts_preset_prices
o pts_prices_request
o pts_status_request
o pts_total_request
o pts_trans_close
− Functions of reading measurements of Automatic Tank Gauge (ATG)
o pts_atg_measure_request
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-1 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-1 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-1 controller written in Python
The package was tested with python of versions 2.7 and 3.0
o pts_close
o pts_last_error
o pts_option_get
o pts_option_set
− Handle of a controller configuration
o pts_pump_config_get
o pts_atg_config_get
o pts_pump_config_set
o pts_atg_config_set
o pts_version_get
− Functions of a read and write parameters of the controller or filling places
o pts_param_get
o pts_param_set
− Functions of management by filling places
o pts_authorize
o pts_pts_authorize_by_amount
o pts_halt
o pts_lock
o pts_unlock
o pts_preset_prices
o pts_prices_request
o pts_status_request
o pts_total_request
o pts_trans_close
− Functions of reading measurements of Automatic Tank Gauge (ATG)
o pts_atg_measure_request
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.
− PtsLib - project of PtsLib.dll library for operation with a PTS-1 controller. Includes classes, methods
and properties for communication with PTS-1 controller using requests and responses described in
UniPump communication protocol for communication with PTS-1 controller for provision of control
over dispensers and ATG systems and configuration of PTS-1 controller.
− Open source utility for configuration of PTS-1 controller, provision of control over pumps and
probes, logging of operation, firmware update, self-diagnostics, others (uses classes and methods
of PtsLib.dll library).
The Visual Basic .NET application for PTS-1 controller is written in VB.NET programming language in Visual
Studio 2010 Express and requirs .NET Framework 2.0.
Form of PTS-1 controller configuration: allows to set configuration for pumps and ATG systems ports
and also set parameters
www.technotrade.ua page 68 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Form for testing and indication of all operations provided by the PTS-1 controller
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 folder
PTS_SDK\API TOOLS\COM_object_API_plus_VB6.0_appilcation.rar\PTSDriver\ReleaseMinDependency\
Form for testing and indication of all operations provided by the PTS-1 controller
PTS-1 controller is intended to be used in connection with control systems for petrol stations (POS systems,
cash registers, OPT terminals, etc) to provide simultaneous control over various types of electronic fuel
delivery dispensers and ATG systems of various manufactures using the single common communication
protocol UniPump. PTS-1 controller provides conversion of the common communication protocol UniPump
into various proprietary communication protocols of manufacturers.
UniPump communication protocol covers a list of commands and responses for communication with PTS-1
controller for provision of control over dispensers and ATG systems and configuration of PTS-1 controller.
PTS-1 controller SDK (Software Development Kit) is intended for developers of POS management software
for petrol stations that needs to provide control fuel dispensers and ATG systems.
PTS-1 controller SDK includes a PTS-1 controller and RS485-4 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-1 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.
SOFTWARE:
1. Software simulator of fuel dispensers
2. Software simulator of ATG systems (probes
3. API for developers in various programming languages
4. Useful utilities and applications for debugging of communication with PTS-1 controller
PTS-1 controller SDK box includes 2 boards mounted inside of a plastic case:
- PTS-1 controller board
- RS485-4 (RS-485/RS-232) interface converter board
Also, it includes cablings for communication and jack for connection to power supply.
Control systems software, which uses UniPump communication protocol, connects to the PTS-1 controller
PC port.
RS-232/RS-485 interface converter board is used in order to convert signals coming from PTS-1 controller
pump ports in RS-485 interface into signals of RS-232 interface for the fuel dispenser software simulator,
which runs on personal computer and communicates through a COM-port 2.
Connection to ATG software simulators is made through USER port of PTS-1 controller (RS-232 interface),
which is connected to personal computer through a COM-port 3.
Thus, it is possible to debug a correct operation of software, being developed, with the PTS-1 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.
More technical information regarding RS485-4 dispenser interface converter (RS-485 to RS-232) can be
found in technical guide on: http://www.technotrade.ua/rs485-to-rs232-converter.html.
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
In pumps simulator it is possible to add up to 99 pumps giving each a unique physical address. Each of the
pumps leads separately its total counters (volume and money amount) and prices for each of its 6 nozzles.
Total counter values as well as prices are stored in Windows system register. Each of the nozzles has a
trigger.
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).
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
− protocol type: selection between standard UniPump communication protocol and extended
UniPump communicatin protocol for PTS-1 controller
− setting quantity of digits in values of volume, money amount, price and total counters
− selection of graphical skin
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.
www.technotrade.ua page 80 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
For communication of PTS-1 controller with the UniPump pumps software simulator it is necessary to select
in PTS-1 controller configuration of the pump port 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-1 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-1 controller” in case if protocol
type is set to “Extended UniPump for PTS-1 controller” in pumps simulator.
Purpose
PTS-1 controller SDK includes a ATG probes software simulator with a purpose to enable debugging of PTS-
1 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-1 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)
− Water volume
− Product ullage
− Product temperature compensated volume
− Product density
− Product mass
Each of the ATG probes can be transferred to connected (responses to PTS-1 controller) or disconnected
(does not response to PTS-1 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
Probes simulator can simulate presence of liquids in tanks – change height and volume of fuel, temperature
mass 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 probes simulator enables to see all the requests and responses in communication and
their respective data.
For communication of the PTS-1 controller with UniProbe ATG probes software simulator it is necessary to
select in PTS-1 controller configuration of the probe port 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.
PTS-1 controller .NET application is provided on both C# and VB.NET languages and requires .NET
Framework 2.0 for operation.
Start
To launch PTS-1 controller .NET application run PtsApplication.exe, select from a dropdown list a COM port
name, to which PTS-1 controller is connected, and press a button to open a selected COM port.
Note: connection with PTS-1 controller is made through a 3-wire realization of RS-232 interface, an
asynchronous half-duplex port, baud rate 57600 baud without a parity check. This configuration is hardly
coded inside a program.
Configuration allows to set pump ports, probe ports, parameters in PTS-1 controller. It is quite convenient
to use and open source code helps to understand better how the PTS-1 controller works.
Pumps configuration tab allows to configure pumps ports of PTS-1 controller (like Pts_config.exe utility):
ATGs configuration tab allows to configure probe ports of PTS-1 controller (like Pts_config.exe utility):
Parameters tab allows to read/write parameters in PTS-1 controller (like Pts_config.exe utility):
Tab “Version information” allows to receive information about date and version of PTS-1 controller
firmware release and also a list of supported communication protocols of pumps and ATG systems (like
Pts_config.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 ports of the PTS-1 controller, selecting each of
which leads to displaying of all fuel points’ IDs and corresponding fuel points’ addresses configured to given
pump port for a PTS-1 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 port 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-1 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-1 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”.
PumpDemo utility
Configuration of the system is done by running a setup.bat file. Configuration is similar to configuration of
NaftaPOS software for operation with PTS-1 controller (see NaftaPOS software user manual):
Dispensing
progress bar
It is written for developers in order to give open source test application, which shows how to communicate
with PTS-1 controller using commands from UniPump communication protocol without a necessity to
implement this protocol from zero.
Utility provides all operations with a PTS-1 controller. Thus developers using one of the above languages
can view how control over PTS-1 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)
This utility can be useful during development of own control software, when developers can test sending of
commands to PTS-1 controller and receive its responses using this utility and in such a way compare then
with responses processed in own developed control software.
Purpose
This step-by-step instruction is provided in order to simplify understanding of PTS-1 controller SDK
operation and assembling. It describes basic steps to be made with PTS-1 controller SDK to assemble it
correctly and also to install and configure software coming in its structure.
PTS-1 controller SDK is generally supplied in a plastic box, in which the PTS-1 controller and RS-485/RS-232
interface converter boards are mounted. All cables inside the PTS-1 controller SDK are already connected.
In order to start operation it is necessary to connect interfaces to PC COM-ports and power on the PTS-1
controller SDK. So, it is necessary to make all the cablings connections correctly for the system to start
operation.
In this step-by-step instruction we will connect 1 pump simulator and 1 ATG probes simulator. Scheme of
connections should be the following:
1. Connection of PC with PTS-1 controller: connect cable coming from PC port of PTS-1 controller to COM-
port 1 of PC (where the control software is to be launched).
2. Connection of RS-485/RS-232 interface converter to PC: connect cable coming from PUMP PORT 1 of RS-
485/RS-232 interface converter to COM-port 2 of PC, on which the pump software simulator is to be
launched.
3. Make sure that PUMP PORT 1 of PTS-1 controller is connected to DATA PORT (RS-485) of RS-485/RS-232
interface converter.
4. Make sure that all switches of DIP-switch SA1 are set into position OFF.
5. Make sure that power supply cable is connected to POWER connector of PTS-1 controller and POWER
connector of RS-485/RS-232 interface converter.
6. (Optional, may be skipped) In order to use software simulator of ATG system connect USER port of PTS-1
controller to COM-port 3 of PC, on which the ATG system software simulator is to be launched.
7. Switch on (power on) the PTS-1 controller SDK (requires 12 V DC power supply source).
It is worth to mention that only 1 application can work with a specific COM-port at the time, 2 applications
can not share the same COM-port.
Click on button “Request firmware version” to get firmware information from PTS-1 controller.
Click the button “Set pumps configuration” to save configuration in PTS-1 controller.
Click the button “Set pumps configuration” to save configuration in PTS-1 controller.
Click on a button “Write default parameters” to write default values. Change the parameter with index 2
“Protocol type” to value “1. UniPump protocol for PTS” as it is shown on below screenshot.
Save current configuration for each of 4 pumps (select pumps one by one using field “Number”).
After properties are set click OK and on the main form select a COM-port, to which pump port of RS-
485/RS-232 interface converter board is connected, and click “Open” button:
After COM-port is opened in case if there is communication between the PTS-1 controller and pump
simulator – you should see blinking of red squares located in left top corner of pump icons in pump
simulator, and communication will be logged in log window of the simulator.
At this in PTS-1 controller on pump port 1 green and red LEDs will begin to blink. Blinking of the green LED
means that PTS-1 controller is sending requests to the pump, blinking of the red LED means that the PTS-1
controller receives responses from the pump.
In case if only green LED is blinking on pump port 1 – there is a mistake in wiring connection or
configuration of the equipment (PTS-1 controller or pump).
After properties are set click OK and on the main form select a COM-port, to which USER port of PTS-1
controller is connected, and click “Open” button.
After COM-port is opened in case if there is communication between the PTS-1 controller and ATG probes
simulator – you should see blinking of red squares located in left top corner of ATG probes icons in ATG
probes simulator, and communication will be logged in log window of the simulator.
At this in PTS-1 controller on USER port green and red LEDs will begin to blink once per second. Blinking of
the green LED means that PTS-1 controller is sending requests to the ATG, blinking of the red LED means
that the PTS-1 controller receives responses from the ATG.
In case if only green LED is blinking on USER port – there is a mistake in wiring connection or configuration
of the equipment (PTS-1 controller or ATG).
Step 10. Control over pumps and ATG probes in PTS-1 controller configuration and
testing utility
Go to tab “Control” in Pts_config.exe and click on the button “TURN ON”.
Now it is necessary to set initial values in the pump simulator and ATG probes simulator to display them in
the utility. Take up nozzles on the pumps and also set values for the ATGs (there is a possibility to emulate
presence in the simulators to make them work if there was really process going on). In the Pts_config.exe
utility you will see these changes.
Now you are able to provide full control over the pumps and read receive data from the ATG probes:
Try to make different operations with pumps: set/get prices, take up/down nozzles, get total counters,
authorize a dispenser, others. Plays with decimal digits number to make them equal to used at your petrol
stations (Note! Number of decimal digits should be also changed in pumps software simulator).
Try to change the measured values of fuel in tanks and see how soon they are updated in Pts_config.exe
utility.
Step 11. Configuration of PTS-1 controller .NET application for control over pumps
and ATG probes
The open-source application written in C# and VB.NET is a good place to start development of new control
software for petrol stations. In this section we will see how it is easy to configure and run it.
Compile “PTS application” project or simply run PtsApplication.exe (application is located in PTS SDK
software kit and is located in API TOOLS folder for C# and VB.NET languages):
Go to main menu item “Configuration” → “Settings” and set configuration as shown below:
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 port 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 #3 → FuelPoint ID = 3, Address = 3
− Fuel point icon #4 → FuelPoint ID = 4, Address = 4
Now the main form of the application allows to provide control over pumps in pump software simulator
(see configuration of the pumps simulator in step 7 above):
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:
www.technotrade.ua page 113 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Now PTS application is able to indicate current level measurement data from ATG system:
Now the PTS application correctly works with pumps and ATGs software simulators.
Below sections show examples of connection to various brands of fuel dispensers. This information is
provided as an example. For reception of detailed information on connection to various brands of fuel
dispensers, configuration of the fuel dispensers and configuration of PTS-1 controller please refer to our
support mailbox support_1a@technotrade.ua.
As it is seen from below connection examples some brands of fuel dispensers have RS-485 interface on
board and thus are directly connected to PTS-1 controller, others do not have RS-485 interface and thus
require additional interface converter for connection to PTS-1 controller. In some cases, various models of
same brand of fuel dispensers have RS-485 interface, others – no. In such a way the best way to check how
your fuel dispenser is connected is to take its mainboard photos and send to us on our support mailbox
support_1a@technotrade.ua. Mainboard is normally located inside the fuel dispenser pumphead behind
the displays.
Configuration of PTS-1 controller pump port: protocol “5. GILBARCO Two-Wire”, baud rate “3. 5787”.
- +
- +
+ -
+ -
Gilbarco Highline / Dimension Assy dispenser board Gilbarco Endeavor dispenser board
+ -
+ -
- +
- +
+ -
www.technotrade.ua page 119 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Configuration of PTS-1 controller pump port: protocol “3. WAYNE Dart”, baud rate “4. 9600”.
Line B
Line A
Line B
Line A
Line A
Line B
Line A
Line A Line B
Line B
Line A
Line B Line A
Line B
Configuration of PTS-1 controller pump port: protocol “23. WAYNE USCL”, baud rate “4. 9600”.
- +
Wayne Dresser dispenser iGEM board Wayne Dresser V387 dispenser board
Line A
Line B
Line A
Line B
Configuration of PTS-1 controller pump port: protocol “6. TOKHEIM”, baud rate “4. 9600”.
DCC
TTC
TTD
DCC
TTC
TTD
DCC
TTC
TTD
DCC
TTC
TTD
TTC
TTD
DCC
TTD
Configuration of PTS-1 controller pump port: protocol “6. TOKHEIM”, baud rate “4. 9600”.
Line B
Line A
Line A
Line B
Configuration of PTS-1 controller pump port: protocol “3. WAYNE Dart”, baud rate “4. 9600”.
Configuration of PTS-1 controller pump port: protocol “24. NUOVO PIGNONE CL”, baud rate “1. 2400”.
Rx+
Tx+
Rx-
Tx-
Rx+
Tx+
Rx-
Tx-
Configuration of PTS-1 controller pump port: protocol “19. PUMALAN Marconi”, baud rate “1. 4800”.
TxD
Gnd
RxD
Line B
Line A
Configuration of PTS-1 controller pump port: protocol “21. BENNETT”, baud rate “2.4800”.
+
-
Configuration of PTS-1 controller pump port: protocol “18. BATCHEN Electroline” (for single-product
dispensers) or “39. BATCHEN MPP” (for multi-product dispensers), baud rate “2. 4800”.
+ -
-
+
Configuration of PTS-1 controller pump port: protocol “2. UniPump”, baud rate “4. 9600”.
DIP-switch for
address setting
Line A
Line B
Line A
Line A
Line B
Line B
Coptron pumphead
Midco pumphead
Configuration of PTS-1 controller pump port: protocol “5. Gilbarco Two-Wire”, baud rate “3. 5787”.
- +
Configuration of PTS-1 controller pump port: protocol “10. GALILEO PumpControl”, baud rate “2. 4800”.
- +
+ -
Configuration of PTS-1 controller pump port: protocol “27. PROWALCO”, baud rate “2. 4800”.
Configuration of PTS-1 controller pump port: protocol “19. PUMALAN Marconi”, baud rate “2. 4800”.
RxD
TxD
Gnd
EsiWelma pumphead
Configuration of PTS-1 controller pump port: protocol “33. Dart Simplex”, baud rate “4. 9600”.
- +
S4 computer
- +
Line A
Line B
S4s computer
www.technotrade.ua page 146 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Configuration of PTS-1 controller pump port: protocol “33. Dart Simplex”, baud rate “4. 9600”.
IntBox
Petposan-Beta CPU
Configuration of PTS-1 controller pump port: protocol “33. Dart Simplex”, baud rate “4. 9600”.
+ -
www.technotrade.ua page 148 from 194
PTS-1 CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS (PTS-1, rev. PTS-U5-v7)
Revision: R07 Review date: 10 Februrary, 2022
Configuration of PTS-1 controller pump port: protocol “33. Dart Simplex”, baud rate “4. 9600”.
- +
Line A
Line B
Mepsan Unimep dispenser calculator
Line B
Line B
Line A
Line B
Line A
Line A
Line B
Line A
Line B
Line A
Line B
2A dispenser computer
Configuration of PTS-1 controller pump port: protocol “43. FALCON LPG”, baud rate “3. 5787”.
+
-
+
-
Line B
Line A
Line A
Line B
Line A
Line B
Configuration of PTS-1 controller pump port: protocol “25. GALLAGHER (PEC)”, baud rate “6. 1200”.
+
-
Configuration of PTS-1 controller pump port: protocol “25. GALLAGHER (PEC)”, baud rate “6. 1200”.
Line A
Line B
Line B
Line A
Line B
Line A
Line A
Line B
Rx+
Tx+
Rx-
Rx+
Tx-
Tx+
Rx-
Tx-
Rx+
Tx+
Rx-
Tx-
HongYang
dispenser boards
Tx-
Rx-
Tx+
Rx+
Configuration of PTS-1 controller pump port: protocol “30. LANFENG”, baud rate “4. 9600”.
Gnd
TxD
RxD
+5V
Line A
Line B
Line A
Lanfeng RS-485 dispenser board
Line B
Line A
Line B
Line A
Line B
Line A
Line B
Line A
Line B
Line B
Line A
Line B
Line A
Line A
Line B
Line A
Line B
Line A
Line B
Line A
Line B
Line B
Changlong dispenser
interface boardboard
Line A
Line B
Line A
Line B
Line A
Line B
Line A
Line B
Line B
Line A
Line B
Configuration of PTS-1 controller pump port: protocol “2. UniPump”, baud rate “4. 9600”.
Below sections show examples of connection to various brands of probes and ATG systems. This
information is provided as an example. For reception of detailed information on connection to various
brands of probes and ATG systems, configuration of the probes and ATG systems and configuration of PTS-
1 controller please refer to our support mailbox support_1a@technotrade.ua.
Gnd
TxD
RxD
RS-232 port
Gnd
TxD
RxD
RS-232 port
Line A
Line B
Gnd
TxD
RxD
RS-232 port
Line A
Line B
Line A
Line B
Alisonic wireless receiver
Gnd
TxD
RxD
RS-232 port
Gnd
TxD
RxD
RS-232 port
Gnd
TxD
RxD
RS-232 port
STRUNA ATG
calculation unit
Gnd
TxD
RxD
RS-232 port
Gnd
TxD
RxD
RS-232 port
Gnd
TxD
RxD
RS-232 port
VEGAMET signal
VEGAPULS
conditioning instrument
radar meter
Line A
Line B
Line A
Line B
Line A
Line B
North Falcon wireless receiver
Board dimensions
Pinout of cable used for connection RS-232 ports of PTS-1 controller to PC:
DB-9F connector
STRUNA ATG
calculation unit
To PTS RS-232 port To COM-port of PC
CERTIFICATES
PTS-1 controller over fuel dispensers and ATG systems for petrol stations complies with the essential
requirements of the European Directive:
- Electromagnetic Compatibility (EMC) Directive 2004/108/EC
We hereby declare that the apparatus named above has been designed to comply with the relevant
sections of the above referenced specifications. The unit complies with all applicable Essential
Requirements of the Directive.
The conducted tests are documented in the test reports No. 1047/1-5-2014 and 1047/2-5-2014 and are
maintained at the corporate headquarters of Technotrade LLC as an evidence of conformity.
ORDER INFORMATION
Examples of order:
- order of PTS-1 controller in a view of electric board: PTS1-PCB-001;
- order of PTS-1 controller installed in a plastic box: PTS1-BOX-001;
- order of PTS-1 controller SDK: PTS1-SDK-001