Dispenser Connection Schemes
Dispenser Connection Schemes
TECHNICAL GUIDE
(PCB board modification: PTS-2, revision: PTS-U5-v21)
CONTENT
REVISION HISTORY ................................................................................................................................................ 5
PURPOSE OF THE DOCUMENT .............................................................................................................................. 6
TECHNICAL FEATURES ........................................................................................................................................... 7
Appointment ................................................................................................................................................. 7
General specification ..................................................................................................................................... 8
Peripheral hardware ...................................................................................................................................... 8
Communication ............................................................................................................................................. 8
Configuration ................................................................................................................................................. 8
COMPLETE SET ...................................................................................................................................................... 9
SUPPORTED FUEL DISPENSERS COMMUNICATION PROTOCOLS........................................................................10
SUPPORTED ATG SYSTEMS COMMUNICATION PROTOCOLS ..............................................................................14
INSTALLATION REQUIREMENTS FOR PETROL STATION ......................................................................................16
BOARD CONNECTORS AND INTERFACES.............................................................................................................18
COMMUNICATION PORTS ...................................................................................................................................19
CONNECTION TO CONTROL SYSTEM USING ETHERNET INTERFACE...................................................................20
CONNECTION TO CONTROL SYSTEM USING RS-232 INTERFACE ........................................................................21
CONNECTION TO DISPENSERS ............................................................................................................................22
CONNECTION TO ATG SYSTEMS AND PROBES ....................................................................................................23
REPORTS ON PUMPS SALES DATA AND TANKS MEASUREMENTS ......................................................................24
SENDING OF PUMPS SALES DATA AND TANKS MEASUREMENTS TO REMOTE SERVER .....................................25
SENDING OF PUMPS SALES DATA TO CONSOLES FOR RECONCILIATION ...........................................................27
CONVERSION BETWEEN PUMPS PROTOCOLS ....................................................................................................28
CONVERSION BETWEEN ATG CONSOLES PROTOCOLS .......................................................................................30
MONITORING OVER FUEL DISPENSERS AND TANKS ...........................................................................................31
DISPENSERS SALES DATA FOR ATG CONSOLES FOR RECONCILIATION ...............................................................32
CONFIGURATION DIP-switch...............................................................................................................................33
SD flash card ........................................................................................................................................................34
WEB-SERVER .......................................................................................................................................................35
General information .................................................................................................................................... 35
Scheme of connections ............................................................................................................................... 36
Login ............................................................................................................................................................ 37
Device information page ............................................................................................................................. 37
Configuration page ...................................................................................................................................... 39
Pumps control page ..................................................................................................................................... 56
Tanks monitoring page ................................................................................................................................ 57
Reporting page ............................................................................................................................................ 58
Logging......................................................................................................................................................... 62
Self-diagnostics page ................................................................................................................................... 63
Firmware update page ................................................................................................................................ 65
BUILT-IN PUMPs SIMULATOR .............................................................................................................................66
BUILT-IN ATG PROBEs SIMULATOR .....................................................................................................................68
FILES STORED ON SD FLASH DISK ........................................................................................................................70
PTS-2 CONTROLLER SOFTWARE DEVELOPMENT KIT (SDK).................................................................................73
PTS-2 controller SDK appointment .............................................................................................................. 73
PTS-2 controller SDK structure .................................................................................................................... 74
PTS-2 controller SDK technical features ...................................................................................................... 74
Specification ............................................................................................................................................ 74
www.technotrade.ua page 2 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
Emgaz Dragon / Fornovo LPG dispenser with EsiWelma pumphead connection scheme........................ 130
Maser dispenser connection scheme ........................................................................................................ 131
Petposan-S4 / Meksan-S4 / Europump-S4 / Yenen dispensers connection scheme ................................ 132
Yenen dispensers connection scheme ...................................................................................................... 133
Petposan-Beta / Europump-Beta dispensers connection scheme ............................................................ 134
EuroPump dispenser connection scheme ................................................................................................. 135
Mekser dispenser connection scheme ...................................................................................................... 136
Fuelsis dispenser connection scheme ....................................................................................................... 137
Mepsan Unimep dispenser connection scheme ....................................................................................... 138
Meksan / Wayne SU86 dispenser connection scheme ............................................................................. 139
Baransay dispenser connection scheme ................................................................................................... 140
2A LPG dispenser connection scheme....................................................................................................... 141
Falcon dispenser connection scheme........................................................................................................ 142
Korea EnE (LG EnE) dispenser connection scheme ................................................................................... 143
Dong Hwa Prime dispenser connection scheme ....................................................................................... 144
Gallagher (PEC) dispenser connection scheme ......................................................................................... 145
Compac dispenser connection scheme ..................................................................................................... 146
Safe dispenser connection scheme ........................................................................................................... 147
MS Gas dispenser connection scheme ...................................................................................................... 148
Shibata dispenser connection scheme ...................................................................................................... 149
Aspro Develco dispenser connection scheme ........................................................................................... 150
HongYang dispenser connection scheme.................................................................................................. 151
Lanfeng dispenser connection scheme ..................................................................................................... 152
Sanki dispenser connection scheme ......................................................................................................... 153
Datian Machines dispenser connection scheme ....................................................................................... 155
Eaglestar dispenser connection scheme ................................................................................................... 156
Blue Sky dispenser connection scheme..................................................................................................... 157
Topaz dispenser connection scheme ........................................................................................................ 158
Shelf dispenser connection scheme .......................................................................................................... 159
UniCon dispenser connection scheme ...................................................................................................... 160
EXAMPLES OF ATG SYSTEMS CONNECTION SCHEMES .....................................................................................161
Gilbarco Veeder Root TLS consoles connection scheme ........................................................................... 162
Start Italiana console connection scheme................................................................................................. 162
Start Italiana wired probes connection scheme........................................................................................ 163
Start Italiana wireless probes connection scheme .................................................................................... 163
Alisonic wired probes connection scheme ................................................................................................ 164
Alisonic wireless probes connection scheme ............................................................................................ 164
Struna ATG system connection scheme .................................................................................................... 165
OPW Site Sentinel ATG system connection scheme ................................................................................. 165
Colibri ATG system connection scheme .................................................................................................... 166
Fafnir ATG system connection scheme ..................................................................................................... 166
Hectronic ATG probes connection scheme ............................................................................................... 167
Vega radar level meters............................................................................................................................. 167
Windbell magnetostrictive probes connection scheme............................................................................ 168
North Falcon wired probes connection scheme ....................................................................................... 169
North Falcon wireless probes connection scheme.................................................................................... 169
CONFIGURATION FILE pts_config_en.js ............................................................................................................170
RS-232 PORT CABLE CONNECTOR .....................................................................................................................173
ORDER INFORMATION ......................................................................................................................................174
www.technotrade.ua page 4 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
REVISION HISTORY
R02 2020.03.03 Evgeniy All sections reviewed and added Added new sections for upload of data to remote
Vasyliev server and tanks calibration charts, all existing
sections reviewed.
R03 2020.10.21 Evgeniy Configuration sections updates Updates related to new configuration options
Vasyliev added.
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: [email protected]
TECHNICAL FEATURES
Appointment
PTS-2 forecourt controller for petrol stations serves for control over petroleum, LPG and CNG dispensers
and automatic tank gauge systems and probes. It knows communication protocols of a great variety of
dispensers and ATG systems and allows control over any of them in exactly the same way using its own
input communication protocols or popular pumps and ATG systems communication protocols. Thus, POS
systems, cash registers, payment terminals and mobile applications can provide control over any of the
dispensers on the forecourt and should not matter what are the brands of dispensers and ATG systems
used – using PTS-2 controller they can provide control over all of them in the same way, PTS-2 controller
undertakes all work on communication with dispensers and ATG systems using their native communication
protocols and takes into account all their peculiarities.
This completely simplifies work for a developer of control system: by having implemented communication
protocol of PTS-2 controller you gain ability to provide control over any of dispensers and ATG systems
supported by PTS-2 controller in a single way. Thus, the time required for development of POS system, cash
register, payment terminal or mobile applications is significantly reduced.
PTS-2 controller is a full functional forecourt controller and can be used standalone for provision of 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. Using a built-in web-server it is
possible to provide full control over forecourt equipment and receive reports on operation from any mobile
device.
PTS-2 controller is able to constantly communicate with remote server being a client and let the remote
server get/set any data from PTS-2 controller, it allows to provide control over PTS-2 controller from
remote server without a need to have a static IP-address. Also, PTS-2 controller can automatically upload
pump sales and tank measurements to the remote server online for reporting and analysis.
General specification
## PARAMETER VALUE
1 Power supply voltage 12 V DC
2 Maximal current consumption 700 mA max
3 Temperature range -40°C … +80°C
4 Weight 200 g
5 Overall dimensions 85 x 58 x 30 mm
Peripheral hardware
## PARAMETER VALUE
1 Battery type CR2032 3V DC
microSD of types SC (standard capacity) and HC (high
2 SD card
capacity), class 10, up to 32 GB
Communication
## PARAMETER VALUE
1 Input protocol for Ethernet port jsonPTS
Input protocol for PC port (RS-232
2 UniPump
interface)
3 Security SSL/TLS 1.2
Configuration
## PARAMETER VALUE
1 Number of pump ports 4
2 Number of pumps 50
3 Number of probe ports 3
4 Number of probes 50
5 Number of fuel grades 10
6 Number of tanks 50
7 Number of users 10
8 Number of pump transaction records 100000
9 Number of tank measurements records 100000
COMPLETE SET
Depending on the order code (see section “Order information”) PTS-2 controller can be supplied either in a
view of electrical board (variant of controller supply PTS2-PCB-z), or installed in a mounting box with cables
inputs and a power switching button (variant of controller supply PTS2-BOX-z).
Variant of controller supply installed in a plastic box with cables inputs and a power switching button
(variant of controller supply PTS2-BOX-z)
(UDC)
26 DONG HWA PRIME Prime pump interface
27 DURULSAN Dart,
Gilbarco Two-Wire
28 EAGLESTAR Eaglestar
29 EKOSIS Gilbarco Two-Wire
30 EMGAZ DRAGON Marconi PumaLAN
31 EPCO Epco protocol specification
32 ESIWELMA Marconi PumaLAN
33 EUROPUMP S4-Dart
34 FALCON LPG Falcon
35 FLOW Easycall
36 FORNOVO GAS Marconi PumaLAN
37 FUELQUIP PEC Pump Communication Protocol
38 FUELSIS S4-Dart
39 FUREN HIGHTECH Fu Ren Ho Sheng
40 GALILEO PumpControl
41 GASLIN S4-Dart
42 GERKON TIT UniPump
43 GILBARCO Gilbarco Two-Wire,
Extended Two-Wire Appendix,
OBC Serial Commands Protocol
44 GREENFIELD Gilbarco Two-wire
45 HAKO TIT UniPump
46 HITACHI SS-LAN protocol
47 HONG YANG HongYang FZ-protocol,
HongYang 886 communication protocol,
HongYang 886 MPD communication protocol
48 IMW PumpControl,
Tokheim UDC
49 INTERMECH PEC Pump Communication Protocol
50 KALVACHA Kalvacha
51 KIEVNIIGAZ TIT UniGaz
52 KOREA ENE EnE Dispenser POS protocol
53 KPG-2 TIT UniGaz
54 KRAUS MNET design specification,
Gilbarco Two-wire
55 KWANGSHIN KS-NET protocol
56 LANFENG RS–232 protocol,
RS–485 protocol,
SS-LAN protocol
57 LG ENE EnE Dispenser POS protocol
58 LOGITRON Marconi PumaLAN
59 MAIDE Changlong pump protocol
60 MASER Maser,
Gilbarco Two-wire
61 MEKSAN / WAYNE SU86 Wayne Dart
62 MEKSER S4-Dart
63 MEPSAN S4-Dart
64 MIDCO Midco Proprietary Pump Protocol (versions 3.10, 3.11,
3.12)
65 MM PETRO (ZAP) MM Petro ZAP RS-485
66 MOTOGAZ PumpControl
67 MS GAS SK protocol
68 NARA AZT 2.0
69 NUOVA MIGAS Dart
70 NUOVO PIGNONE Nuovo Pignone RS-485,
Nuovo Pignone Current Loop 4-wire,
Wayne Dart
71 ORCA SS-LAN
72 PEC (GALLAGHER FUEL SYSTEMS) PEC Pump Communication Protocol,
Gilbarco Australia
73 PECO SS-LAN
74 PEGASUS Arion1 OpenProtocol
75 PETPOSAN S4-Dart
76 PETROEQUIP Lanfeng protocol
77 PETROMECCANICA Wayne Dart
78 PETROTEC Petrotec HDX protocol
79 PROWALCO SPDC-1 / MPDC-1,
SPDC-2 / MPDC-2,
Salesmaker & ICON
80 PUMP CONTROL PumpControl
81 PUMPTRONICS Gilbarco Two-Wire
82 REAL-TECH Blue Sky,
SS-LAN
83 RIX PEC Pump Communication Protocol
84 SAFE SAFE PMII Graf,
PumpControl
85 SALZKOTTEN ER3 Data interface,
Gilbarco Two-Wire,
Marconi Logitron PumaLAN
86 SANKI Sanki Comm.,
Sanki Russia 664,
Sanki Russia 765,
AZT 2.0,
Sanki General,
Sanki Australia,
Sanki Global
87 SATAM EQUALIS S Modbus RTU
88 SEA BIRD Blue Sky
89 SHELF Shelf
90 SCHEIDT & BACHMANN T02,
V11
91 SHIBATA SS-LAN
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.
Connection of ATG probes installed inside the tanks should be done only with provision of required safety
measures: in case if probes have explosion-proof protection – then armored cables should be used, in case
if probes have intrinsic safety – then connection should be performed through suitable safety barriers.
PTS-2 controller is supplied together with terminal blocks for each of the connectors for screwing of
connection wires.
NOTE! Operation status LED is yellow LED, blinking during operation. In case if the system loaded correctly
and there are no errors found – then it blinks with toggling its state (on/off) each second. However, if it is
blinking fast (toggling its state each 100 ms) – then there is a problem at system load and it can not work.
COMMUNICATION PORTS
(3 wires: TxD, RxD, Gnd) Connection with ATG systems (probes) using
RS-232 configurable proprietary com. protocol (up to 50 ATG
USER port
(3 wires: TxD, RxD, Gnd) probes).
DISP port RS-485
(RS-485) (2 wires: line A, line B) Connection with POS systems using popular probes
DISP port RS-232 communication protocol.
(RS-232) (3 wires: TxD, RxD, Gnd)
RS-232
DEBUG PORT (2 wires: TxD, Gnd)
Debugging of operation.
For connection to ESP-07/ESP-12 modules equipped
RS-232
WF PORT (3 wires: TxD, RxD, Gnd)
with ESP8266 chip for communication using Wi-Fi
(reserved to future implementation).
NOTE!
It is strictly prohibited to connect any of the cables’ shields to ports of PTS controller.
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.
Scheme of connections:
Communication with PTS-2 controller is made using commands and responses described in jsonPTS
communication protocol (own proprietary protocol of Technotrade LLC) – see document “jsonPTS
communication protocol specification for PTS-2 controller” for more information.
Connection to the control system (POS system, cash register, OPT terminal, etc) can be done through 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 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 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.
Configuration and control over PTS-2 controller in this case is done same way as with PTS-1 controller
(http://www.technotrade.ua/fuel-pump-controller.html). This mode is left intentionally for backward
compatibility. The only difference in this mode is that PTS-2 controller supports control over up to 50
dispensers and up to 50 probes using same UniPump protocol unlike PTS-1 controller, which is limited to 16
pumps and 16 probes maximum.
CONNECTION TO DISPENSERS
PTS controller can simultaneously control up to 50 fueling places (50 single-sided dispensers or 25 double-
sided dispensers or mixture of single-sided and double-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) (see section “Examples of connection to fuel dispensers”).
So, you can distribute all the 50 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 pump ports in
approximately equal quantities in order to minimize delays between fuel dispensers querying in the same
pump port.
PTS-2 controller can simultaneously control up to 50 automatic tank gauges (probes) (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, baud rate and communication
settings: number of data bits and stop bits, parity) (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-2 controller.
PTS-2 controller can record on its SD flash card all the pumps sales and changes of petroleum products
parameters in tanks (automatic registration of in-tank deliveries and discharges). Users can connect to PTS-
2 controller’s web-server remotely anytime and view the reports generated.
PTS-2 controller can automatically send pumps sales and tanks measurements of petroleum products
parameters to a remote server. This feature provides following possibilities:
− independent reporting on sales of dispensers and movement of petroleum products in tanks
− analysis of data with formation of tanks reconciliation reports, detection of tank leakages, etc.
− remote supervision over petrol station or petroleum depot operation
− definition of frauds and stealing at petrol station and hidden control over actions of personal
− generation of consolidated reporting from network of petrol stations and tank depots
NOTE! Communication protocol used between PTS-2 controller and remote server for automatic data
upload is described in jsonPTS communication protocol (own proprietary protocol of Technotrade LLC) –
see document “jsonPTS communication protocol specification for PTS-2 controller” for more information.
PTS-2 controller can be set in automatic mode of operation. At this PTS-2 controller automatically
authorizes pumps and stores all sales to database. Also, PTS-2 controller tracks all changes of product
measurements inside tanks with storing of all changes in database and automatic registration of in-tank
deliveries and discharges from tanks.
Having information on measured product level and temperature from ATG probes PTS-2 controller
automatically calculates:
− product volume
− water volume
− tank ullage
− product temperature-compensated volume
− product mass (in case if probe provides measurements of product density)
All database records are automatically uploaded to remote server for subsequent analysis: reconciliation,
automatic tanks calibration, detection of leakages and thefts.
At communication to ATG consoles PTS-2 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
controller for its conversion to any other pump protocols without any additional integration.
Communication of PTS-2 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.
In this case the control system should know pump communication protocol. PTS controller in this case
serves as a protocol’s converter: converts input pump protocol into any other supported pump protocols.
Also, at this control over pumps can be done in parallel from control systems connected through pump
port, Ethernet port and PC port, PTS-2 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 controller for its conversion to any other ATG console or probe protocols without any additional
integration.
Communication of PTS-2 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.
In this case the control system should know communication protocol of ATG console. PTS 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-2 controller allows to monitor
operation of the fuel dispensers and tanks (and optionally to make sales when required). At this PTS
controller is connected between existing POS system and fuel dispensers and ATG console (tank probes),
PTS-2 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 ports of PTS-2 controller and get all data of fuel dispensers sales
and tanks measurements real time, at this it can also provide control over the dispensers when required.
PTS 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 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 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 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)
CONFIGURATION DIP-SWITCH
PTS-2 controller has a 4-position configuration DIP-switch, located on top of the PCB board. Appointment of
the switches is the following:
- switch 1:
o OFF position: communication through Ethernet using HTTPS protocol (by defaults port is 443)
o ON position: communication through Ethernet using HTTP protocol (by defaults port is 80)
- switch 2:
o OFF position: digest authentication
o ON position: basic authentication
- switch 3:
o OFF position: normal startup
o ON position: format of SD flash card on startup
- switch 4:
o OFF position: normal startup
o ON position: reset of all configuration to default factory settings on startup
In case if switches 3 and 4 are set to ON position same time – then PTS-2 controller will not format SD-flash
card, but will reset all the configurations to default factory settings on startup. After that PTS-2 controller
will check SD flash disk for a file Config.js containing backup configuration and if such file exists – then PTS-2
controller will restore the configuration it automatically. Thus, PTS-2 controller memory can be cleared and
configuration can be restored by placing the Config.js file to root of SD flash card.
SD FLASH CARD
PTS-2 controller has SD flash card for leading system files. It has FAT32 file system.
SD flash disk is used for storing files with pumps sales and tanks measurements, tank calibration chards,
system log, configuration, others. List of files and their structure are described in section “Files stored on SD
flash disk”.
NOTE! Operation status LED on PTS-2 controller board will show error, blinking fast and toggling its state
each 100 ms in case if:
- SD flash disk is inserted incorrectly
- SD flash disk is not formatted to FAT32 file system or its file system is damaged
In this case it is necessary to recheck that SD flash disk is inserted correctly and has a valid FAT32 file
system. Also, it is possible to format the SD flash disk using switch3 of the configuration DIP-switch (see
section Configuration DIP-switch).
NOTE! PTS-2 controller can operate without SD card inserted. In this case PTS-2 controller ignores any
operations with SD card if any are configured in it.
WEB-SERVER
General information
PTS-2 controller comes with a built-in web-server, which allows following possibilities:
- check of firmware information (firmware version and communication protocols included)
- check of system state (battery, SD flash card, unique identification number)
- configurations (pumps and ATG probes ports, fuel grades, tanks and calibration charts, linking of
pumps’ nozzles to fuel grades and tanks)
- configuration of specific PTS controller parameters and parameters for pumps and probes protocols,
system datetime and communication parameters
- configuration of users and their corresponding remote server connection parameters
- pumps control and monitoring over the pumps
- tanks monitoring
- generation of reports on pumps sales and changes of petroleum products in tanks
- logging of PTS controller communication exchange with connected equipment
- self-diagnostics of peripheral hardware
- update of firmware
Web-server has adoptive interface and was developed to suit to various types of mobile devices: PCs,
laptops, tablets, smartphones.
Built-in web-server uses requests and responses described in jsonPTS communication protocol (own
proprietary protocol of Technotrade LLC).
Communication to web-server is done using HTTP or HTTPS protocols depending on the position of switch 1
of configuration DIP-switch on the PTS-2 controller board (please check section Configuration DIP-switch
www.technotrade.ua page 35 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
Communication settings can be modified on Configuration page System settings tab of web-server. Also,
you can anytime reset the parameters to default using switch 4 of configuration DIP-switch on the PTS-2
controller board (please check section Configuration DIP-switch for more information).
In order to initially connect to PTS-2 controller web-server it is needed to set Ethernet IPv4 settings of PC to
be in same network, for example:
- IP-address: 192.168.1.10
- Network mask: 255.255.255.0
- Gateway: 192.168.1.13
Recommended web-browsers for application with PTS-2 controller web-server are Google Chrome and
Mozilla Firefox.
After opening a web-browser in order to get to the web-server of PTS-2 controller type in the address line
http://192.168.1.117 or https://192.168.1.117 depending where usage of HTTP or HTTPS is configured by
position of switch 1 of configuration DIP-switch on the PTS-2 controller board (please check section
Configuration DIP-switch for more information).
NOTE! PTS-2 controller is using self-signed certificate, so at connection in web-browser using HTTPS
protocol it may ask whether you trust the web-site or not.
Scheme of connections
Login
PTS-2 controller leads users and their permissions. For login into the web-server you should know the user
credentials.
NOTE! Pay attention that the PTS 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.
NOTE! In case if battery voltage is lowered than required (lower than 3 V DC) – then it is strictly required to
replace the battery with a new one, otherwise PTS-2 controller may not keep the system date and time
correctly.
NOTE! PTS-2 controller may work without SD flash disk inserted, but at this all operations concerning
saving of data to SD flash disk will not be performed by PTS-2 controller. It is recommended to always use
SD flash disk.
Configuration page
Configuration page contains all the settings of PTS-2 controller, which are divided in tabs.
Settings tab
On Settings tab you can configure following settings:
- system date and time for PTS controller (used for recording pumps sales and tanks measurements to
SD flash and logging)
- communication settings of PTS controller (IP-address, network mask, gateway, ports for HTTP and
HTTPS, DNS servers)
- backup and restore configuration with a possibility to download and upload the configuration file
Config.js
- restart button for instant PTS-2 controller restart
NOTE! As default port for HTTP is 80 and default port for HTTPS is 443 it allows not to enter any port in
web-browser at addressing to PTS controller when these ports are configured, for example address
http://192.168.1.117 automatically equals http://192.168.1.117:80 and https://192.168.1.117
automatically equals https://192.168.1.117:443.
NOTE! DNS server is necessary when automatic upload of data to remote server is configured in
configuration of users for conversion of domain name to IP-address. At this in case if DNS server is not to
be used – you can fill the field with 0.0.0.0 value.
Pumps tab
On this tab you can configure each pump port to separate communication protocol and baud rate. Also,
you can configure all the pumps (up to 50) to a pump port and assign it a physical address (communication
address set in dispenser).
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. Physical address of the
pump means communication address (also named as ID or pump number) of the real fueling place, which is
programmed or set in configuration of the fuel dispenser fueling place.
After configuration is finished it is necessary to click a button “Set”, which writes current pump ports
configuration to PTS-2 controller.
Probes tab
On this tab you can configure each probe port to separate communication protocol and baud rate. Also,
you can configure all the probes (up to 50) to a probe port and assign it a physical address (communication
address set in probe or in ATG console).
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. 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 in probe (in some models of probes address mean serial number stated on the probe
label).
After configuration is finished it is necessary to click a button “Set”, which will write current probe ports
configuration to PTS-2 controller.
Parameters tab
On this tab you can configure parameters for
- PTS controller
- pumps specific protocol parameters
- probes specific protocol parameters
All parameters are listed in a table with detailed description. Default parameters values are specified in a
separate column.
After configuration is finished it is necessary to click a button “Set”, which will write current parameters
configuration to PTS-2 controller.
General parameters group includes parameters for saving pumps sales (and total counters) and tanks
measurements to SD flash disk and some other parameters.
Port flexible communication settings group includes parameters for setting communication parameters for
each of the probe interfaces:
- number of data bits
- number of stop bits
- parity
Decimal digits group set number of decimal digits for system account and saving to SD for:
- price
- volume
www.technotrade.ua page 44 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
- amount
- volume total counters
- amount total counters
Non-addressable interface converters group is used for configuration of PTS-2 controller for operation with
non-addressable interface converters NA (https://technotrade.ua/non-addressable-interface-
converter.html), used for connection to the same pump port of PTS-2 controller of many dispensers, which
do not have a communication address in their communication protocol.
Pump parameters
PTS-2 controller foresees specific configuration parameters for each type of pump communication
protocols. They are to be set for each of the pumps individually. Parameters are protocol specific.
Also, there are some parameters common for each type of dispensers regardless the communication
protocol used:
- authorization settings: these settings include if the pump should be authorized automatically or not, if
the transaction should be closed automatically or not, if the totals should be read automatically, if the
pump should be authorized only on nozzle up, if the pump should be stopped automatically at
detection of overfilling, others,
- multipliers: these settings are used to adjust the values sent/received to/from dispensers during
communication to make PTS-2 controller display same values as displayed on the dispenser display.
Probe parameters
Similar to pumps, protocols parameters PTS-2 controller foresees specific configuration parameters for
each type of probe communication protocols. They are to be set for each of the probes individually.
Parameters are protocol specific. Also, there are some parameters common for each type of dispensers
regardless the communication protocol used.
Grades tab
On this tab you can configure fuel grades used in PTS-2 controller. This includes settings of fuel grade name,
price per liter/gallon and setting of temperature-expansion coefficient.
After configuration is finished it is necessary to click a button “Set”, which will write current configuration
to PTS-2 controller.
For general liquids, a linear correction factor can be applied, to give volumetric flow at base condition. The
thermal expansion coefficient for liquids is determined empirically and can be found in chemical
engineering texts.
Tanks tab
On this tab you can configure tanks: used fuel grades and heights. Also, you can assign a calibration chart.
After configuration is finished it is necessary to click a button “Set”, which will write current configuration
to PTS-2 controller.
NOTE! It is assumed that tanks’ IDs completely correspond to probes’ IDs in meaning tank with ID 1
corresponds probe with ID 1, tank with ID 2 corresponds to probe with ID 2 and so on.
For assigning a tank calibration chart it is necessary to select a raw in a table for specific tank and in field
under a tanks table to select a path to the tank calibration chart file.
Button “Calculate volume” allows to check tank’s cabliration chart by checking volume for any level
entered.
NOTE! It is possible to set a calibration chart for the tank after configuration of tanks is saved.
NOTE! Structure of tank calibration chart files is described in section “Files stored on SD flash disk”.
Nozzles tab
On this tab you can configure linkage of pump nozzles to fuel grades and to tanks (optional). used in PTS-2
controller.
After configuration is finished it is necessary to click a button “Set”, which will write current configuration
to PTS-2 controller.
Users tab
On this tab you can configure list of users and their permissions and also individual remote server
parameters for upload of data for each user.
As a user it is understood not obligatory a human being, but also it means credentials, under which remote
system (POS, cash register, payment system server, mobile application, OPT, servers of data analysis, etc.)
can communicate with PTS-2 controller. It user is set permissions for access to system:
- configuration
- control
- monitoring
- reports view
Settings for each user include parameters of remote server for automatic upload of data (pumps
transactions and tanks measurements). For each user it is possible to set its own remote server for
automatic data upload and also set what data to upload:
- pumps transactions with specification whether all of the transaction should be uploaded, or only made
by this user or none
- tanks measurements (all or none)
Configuration on the image above means that all pumps transactions are to be sent to server address
technotrade.ua/jsonPTS on port 80.
After configuration is finished it is necessary to click a button “Set”, which will write current configuration
to PTS-2 controller.
NOTE! Communication protocol used between PTS-2 controller and remote server for automatic data
upload is described in jsonPTS communication protocol (own proprietary protocol of Technotrade LLC) –
see document “jsonPTS communication protocol specification for PTS-2 controller” for more information.
Reporting page
Reporting pages allows to generate reports for pumps sales and tanks measurements in case if they were
recorded to SD flask disk (PTS controller parameter should be set for this in configuration page on tab
Parameters).
Filters:
- pump or tank number
- date and time of period start
- date and time of period end
- fuel grade (for pumps only)
- user, which made the pump transaction (for pumps only)
Also, you can export generated report data to CSV and Excel files, copy or print.
Pumps tab
On this tab you can generate reports for pumps transactions.
Tanks tab
On this tab you can generate reports for tanks measurements with generation of chart.
Tanks report allows to generate a reconciliation report in case if configuration of PTS-2 controller has
configured tanks and nozzles of the pumps are linked to the same product, as configured to the tank.
Tanks report also allows to generate a chart of product movement inside the tank.
Logging
Logging page allows to record a log of communication with connected device to one of its ports.
For logging you need to select a port and set date/time for log to stop. If the port is selected and selected
date/time is more that system date/time – then the log will start and will be working until date/time
reaches the configured one to stop.
During logging a file named PortLog.bin is generated in root of SD flash disk. The log is accumulated in
encrypted form, so once the log is recorded – it is required to pass obtained PortLog.bin file to Technotrade
LLC company for examining and elimination of possible problems, for reasons of which it was taken.
Self-diagnostics page
Self-diagnostics page allows to check state of peripheral equipment of the PTS-2 controller board:
- ports with RS-485 interface: pump ports and DISP (RS-485) port
- ports with RS-232 interface: DISP (RS-232), LOG, USER and PC ports
- configuration DIP-switch
- SD flash disk
In order to perform self-diagnostics scheme of connections of the PTS-2 controller should be the following:
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 PC, LOG, USER and DISP (RS-232) ports pin TxD should be shortened with pin RxD as shown on the
picture.
Results of diagnostics will be shown by color of labels. Green color means that correspondent port is
working correctly (OK), red color – correspondent port is working incorrectly (Error).
Firmware update page allows to update firmware of PTS controller. For this you should select path to
c_pts2.bin file. At this firmware is saved to SD flash disk and will be automatically when upload of file is
finished, after firmware update web-server will be automatically switch to Device information page to
display currently installed firmware version.
In case if it is needed to update the PTS-2 controller firmware and there is no access to the web-server –
then it is needed to place c_pts2.bin firmware file to root of the SD flash disk and power on the PTS
controller. Firmware will be updated on start-up.
In case if the firmware file got corrupted – then this file will not be applied and will be automatically erased
on startup.
PTS-2 controller firmware between its pump protocols has a protocol “37. Pump Simulator”, which allows
to simulate presence of connected pumps. Baud rate for the pump port at this can be set to any possible.
It allows to make easy debugging of control over dispensers without real fuel dispensers connected.
Purpose of the pump simulator protocols is to help developers in debugging of the control system software
with PTS controller at absence of real dispenser or its pumphead. 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 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 controller firmware between its ATG probes protocols has a protocol “7. ATG Simulator”, which allows
to simulate presence of connected ATG probe. Baud rate for the probe port 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:
www.technotrade.ua page 68 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
- 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.
Files PumpTrn.csv, TankMsr.csv are classical CSV (comma separated values) files with column names in a
first row.
Note!
CR and LF characters shown on examples below mean special control characters used for bringing text to
a new line. They are used to mark a line break in a text file, they are not to be typed manually. Yu can use a
text editor as Notepad++ (https://notepad-plus-plus.org/) in order to inspect the files format you have.
DateTime,Pump,Nozzle,Transaction,UserId,Volume,Amount,Price,VolumeTotal,AmountTotal,DateTimeStart,TCVolume CR LF
20.09.30 13:49:29,01,1,00001,01,0000001.00,0000001.23,0000001.23,0000000000000001.00,0000000000000001.23,20.09.30 13:49:27,0000000.89 CR LF
20.09.30 13:49:34,02,1,00001,01,0000002.00,0000002.22,0000001.11,0000000000000002.00,0000000000000002.22,20.09.30 13:49:31,0000001.86 CR LF
20.09.30 13:49:39,01,1,00002,01,0000003.00,0000003.69,0000001.23,0000000000000004.00,0000000000000004.92,20.09.30 13:49:35,0000002.67 CR LF
20.09.30 16:16:02,02,1,00003,01,0000002.00,0000002.22,0000001.11,0000000000000002.00,0000000000000002.22,20.09.30 16:16:00,0000001.98 CR LF
20.09.30 16:16:12,01,1,00003,01,0000003.00,0000003.69,0000001.23,0000000000000003.00,0000000000000003.69,20.09.30 16:16:08,0000002.96 CR LF
20.09.30 17:29:04,02,1,00004,01,0000002.00,0000002.22,0000001.11,0000000000000002.00,0000000000000002.22,20.09.30 17:29:01,0000000.01 CR LF
20.09.30 17:37:23,02,1,00006,01,0000002.00,0000002.22,0000001.11,0000000000000002.00,0000000000000002.22,20.09.30 17:37:20,0000001.99 CR LF
DateTime,Probe,Status,Alarms,ProductHeight,WaterHeight,Temperature,ProductVolume,WaterVolume,Ullage,ProductTCVolume,Density,Mass CR LF
19.10.25 12:00:00,01,0,00,00001000.0,00000000.0,+00000025.0,0000001000,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:01:00,01,0,00,00000990.0,00000000.0,+00000025.0,0000000990,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:02:30,01,0,00,00000995.0,00000000.0,+00000025.0,0000000995,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:06:00,01,0,00,00000955.0,00000000.0,+00000025.0,0000000955,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:08:30,01,0,00,00000975.0,00000000.0,+00000025.0,0000000975,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:11:00,01,0,00,00000955.0,00000000.0,+00000025.0,0000000955,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:13:30,01,0,00,00000965.0,00000000.0,+00000025.0,0000000965,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:16:00,01,0,00,00000915.0,00000000.0,+00000025.0,0000000915,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:18:30,01,0,00,00000940.0,00000000.0,+00000025.0,0000000940,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:21:00,01,0,00,00000910.0,00000000.0,+00000025.0,0000000910,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:23:30,01,0,00,00000925.0,00000000.0,+00000025.0,0000000925,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:26:00,01,0,00,00000865.0,00000000.0,+00000025.0,0000000865,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
19.10.25 12:28:30,01,0,00,00000895.0,00000000.0,+00000025.0,0000000895,0000000000,0000000000,0000000000,00000000.0,00000000.0 CR LF
Tank calibration chart file NNCalib.csv is CSV file without header in a first row (where NN – number of the
tank (with leading zeroes, for example 01Calib.csv file is used for tank 1)). First value in each row is tank
level in 0.1 mm, second value is volume in volume units (liters, gallons, other depending on the units used
for account) corresponding to given level. Each value should be 9 digits width (filled with leading zeroes).
000000000,000000000 CR LF
000000010,000000010 CR LF
000000030,000000020 CR LF
000000040,000000030 CR LF
000000050,000000040 CR LF
000000060,000000050 CR LF
000000080,000000060 CR LF
000000090,000000070 CR LF
000000100,000000080 CR LF
000000110,000000090 CR LF
000000130,000000100 CR LF
So, for example 9 mm level corresponds to 70 volume (liters, gallons, other depending on the units used for
account).
In order to prepare a tank calibration chart file with correct format you can use Microsoft Excel or any
similar software. There are 3 things you should take care about:
1. Prepare the data in file: first value in each row is tank level in 0.1 mm, second value is volume in
volume units (liters, gallons, other) corresponding to given level, for example:
2. Format cells to add leading zeros, so that totally you have 9 digits in each cell. This is possible to
make if you set format type to 000000000 for each cell:
3. Save the created file in CSV format (comma separated values) for MS-DOS. Here MS-DOS format is
needed in order to prevent putting a byte order mark in start of the document (please read about
byte order mark preambula here: https://en.wikipedia.org/wiki/Byte_order_mark).
PTS-2 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-2 controller SDK includes a PTS-2 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-2 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
PTS-2 controller SDK box includes 2 boards mounted inside of a plastic case:
- PTS-2 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, which uses jsonPTS communication protocol, connects to Ethernet port of PTS-2
controller.
RS-232/RS-485 interface converter board is used in order to convert signals coming from PTS-2 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 1.
Connection to ATG software simulators is made through USER port of PTS-2 controller (RS-232 interface),
which is connected to personal computer through a COM-port 2.
Thus, it is possible to debug a correct operation of software, being developed, with the PTS-2 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 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 77 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
For communication of PTS controller with the UniPump pumps software simulator it is necessary to select
in PTS 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.
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)
− 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 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
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 controller with UniProbe ATG probes software simulator it is necessary to
select in PTS 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.
Purpose
This step-by-step instruction is provided in order to simplify understanding of PTS-2 controller SDK
operation and assembling. It describes basic steps to be made with PTS-2 controller SDK to assemble it
correctly and also to install and configure software coming in its structure.
PTS-2 controller SDK is generally supplied in a mounting box, in which the PTS controller and RS485-4
interface converter boards are mounted. All cables inside the PTS controller SDK are already connected. In
order to start operation, it is necessary to connect interfaces to Ethernet port and COM-ports and power on
the PTS-2 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 controller: connect cable coming from Ethernet port of PTS controller to
Ethernet port of PC.
2. Connection of RS485-4 interface converter to PC: connect cable coming from PUMP PORT 1 of RS485-4
interface converter to COM-port 1 of PC, on which the pump software simulator is to be launched.
3. Make sure that PUMP PORT 1 of PTS controller is connected to DATA PORT (RS-485) of RS485-4
interface converter.
4. Make sure that all switches of configuration DIP-switch of PTS-2 controller are set into position OFF.
5. Make sure that power supply cable is connected to POWER connector of PTS controller and POWER
connector of RS485-4 interface converter.
6. (Optional, may be skipped) In order to use software simulator of ATG system connect USER port of PTS
controller to COM-port 2 of PC, on which the ATG system software simulator is to be launched.
7. Switch on (power on) the PTS-2 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.
After that open some standard web-browser (recommended web-browsers are Google Chrome and Mozilla
Firefox) and type in the address line http://192.168.1.117 (for HTTP if configuration DIP-switch 1 is set to
ON position) or https://192.168.1.117 (for HTTPS if configuration DIP-switch 1 is set to OFF position).
Click on a button Default to write default values. Change the parameter with index 2. “Protocol type” to
value “UniPump 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”).
Save current configuration for each of 4 probes (select probes 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 RS485-4
interface converter board is connected, and click “Open” button:
After COM-port is opened in case if there is communication between the PTS-2 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-2 controller on pump port 1 green and red LEDs will begin to blink. Blinking of the green LED
means that PTS controller is sending requests to the pump, blinking of the red LED means that the PTS
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-2 controller or pump).
After properties are set click OK and on the main form select a COM-port, to which USER port of PTS-2
controller is connected, and click “Open” button.
After COM-port is opened in case if there is communication between the PTS-2 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-2 controller on USER port green and red LEDs will begin to blink once per second. Blinking of
the green LED means that PTS-2 controller is sending requests to the ATG, blinking of the red LED means
that the PTS-2 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-2 controller or ATG).
Set initial values in the pump simulator to display them in the web-browser. Take up nozzles on some
pumps. In the web-browser you will see these changes. Now you are able to provide full control over the
pumps:
Go to Tanks monitoring page in web-browser, you should see all the tanks.
Set initial values in the ATG probes simulator to display them in the web-browser. Set values for the ATG
probes (there is a possibility to emulate presence in the simulator to make them work if there was really
process going on). In the web-browser you should see these changes. Now you are able to receive data
from the ATG probes:
Try to change the measured values of fuel in tanks and see how soon they are updated in web-browser.
At this stage we can provide control over pumps and monitor tanks, in web-browser we can open Web
Developer Tools and see on tab Network the requests sent to PTS-2 controller and responses received.
Step 14. Saving of pumps sales and tank measurements to database with reports
generation
Go to Configuration page and there to Parameters tab, select Device as PTS controller and select
checkboxes to save pumps sales to SD and also to save tanks measurements to SD as shown on screenshot
below. Click Set button to save the changes.
Now PTS-2 controller will save all the pumps sales and tanks measurements to SD flash disk and it will allow
us to view the saved records in reports.
Try to make same sales and change levels of products in tanks and review them in reports.
Also, on the same tab select Device as pump and set for each pump a parameter to read pump totals
automatically as shown on the image below. Click Set button to save the changes.
After these options are set PTS-2 controller should be reading totals automatically after each sale and save
them to database. So, at generation of reports we should see the transactions reports together with totals.
Now, the pump automatically gets authorized by PTS-2 controller once a nozzle is taken up. At this each
transaction is saved to SD flash disk and is seen in reports. The dispenser now works as in manual mode and
preset can be entered from dispenser keyboard.
In this scheme we can additionally enable automatic upload of pumps sales to remote server to make
operation of the dispensers be completely automatic with reception of reports in remote server.
Step 17. Testing of operation with PTS-2 controller from Postman utility
Postman utility provided by Postman, Inc (https://www.postman.com/) is a great tool to test
communication with PTS-2 controller. Please refer to document “jsonPTS communication protocol
specification for PTS-2 controller” for information on how to configure Postman utility and use it for testing
of communication with PTS-2 controller.
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 controller please refer to our
support mailbox [email protected].
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 controller, others do not have RS-485 interface and thus
require additional interface converter for connection to PTS 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
[email protected]. Mainboard is normally located inside the fuel dispenser pumphead behind
the displays.
Configuration of PTS controller pump port: protocol “5. GILBARCO Two-Wire”, baud rate “3. 5787”.
- +
- +
+ -
+ -
Gilbarco Highline / Dimension Assy dispenser board Gilbarco Endeavor dispenser board
+ -
+ -
- +
- +
+ -
Configuration of PTS 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 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 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 controller pump port: protocol “6. TOKHEIM”, baud rate “4. 9600”.
Line B
Line A
Line A
Line B
Configuration of PTS controller pump port: protocol “3. WAYNE Dart”, baud rate “4. 9600”.
Configuration of PTS controller pump port: protocol “24. NUOVO PIGNONE CL”, baud rate “1. 2400”.
Rx+
Tx+
Rx-
Tx-
Rx+
Tx+
Rx-
Tx-
Configuration of PTS controller pump port: protocol “19. PUMALAN Marconi”, baud rate “1. 4800”.
TxD
Gnd
RxD
Line B
Line A
Configuration of PTS controller pump port: protocol “21. BENNETT”, baud rate “2.4800”.
+
-
Configuration of PTS 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 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
www.technotrade.ua page 125 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
Midco pumphead
Configuration of PTS controller pump port: protocol “5. Gilbarco Two-Wire”, baud rate “3. 5787”.
- +
Configuration of PTS controller pump port: protocol “10. GALILEO PumpControl”, baud rate “2. 4800”.
- +
+ -
Configuration of PTS controller pump port: protocol “27. PROWALCO”, baud rate “2. 4800”.
Configuration of PTS controller pump port: protocol “19. PUMALAN Marconi”, baud rate “2. 4800”.
RxD
TxD
Gnd
EsiWelma pumphead
Configuration of PTS controller pump port: protocol “33. Dart Simplex”, baud rate “4. 9600”.
- +
S4 computer
- +
Line A
Line B
S4s computer
www.technotrade.ua page 133 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
Configuration of PTS controller pump port: protocol “33. Dart Simplex”, baud rate “4. 9600”.
IntBox
Petposan-Beta CPU
Configuration of PTS controller pump port: protocol “33. Dart Simplex”, baud rate “4. 9600”.
+ -
www.technotrade.ua page 135 from 174
PTS-2 FORECOURT CONTROLLER OVER FUEL DISPENSERS AND ATG SYSTEMS FOR PETROL STATIONS
Revision: R04 Review date: 23 March, 2021
Configuration of PTS 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 controller pump port: protocol “43. FALCON LPG”, baud rate “3. 5787”.
+
-
+
-
Line A
Line B
Line A
Line B
Configuration of PTS controller pump port: protocol “25. GALLAGHER (PEC)”, baud rate “6. 1200”.
+
-
Configuration of PTS 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 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 B
Line A
Line B
Line A
Line B
Line A
Line B
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
controller please refer to our support mailbox [email protected].
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
PTS-2 controller has a built-In configuration file named pts_config_en.js, which can be requested by
addressing to this file (for example https://192.168.1.117/pts_config_en.js in case if usage of HTTPS is
selected on DIP-1 switch and IP-address is set to 192.168.1.117). The configuration file contains:
- list of pump communication protocols supported
- list of probe communication protocols supported
- list of baud rates supported
- list of parameters supported
Section “protocols” contains a list of all supported pumps and probes communication protocols, where
each “protocol” element contains properties:
- element “name” states communication protocol name
- element “index” states communication protocol index used for configuration
- element “type” states communication protocol type, possible variants are:
o 0 – pump protocol type
o 1 – probe protocol
Section “bauds” contains a list of all supported baud rates, where each “baud” element contains
properties:
- element “baud” states baud rate value
- element “index” states baud rate index used for configuration
Section “params” contains a list of all supported parameters. PTS-2 controller uses parameters internally as
configurable fields for storing different configuration settings, parameters are united in sets of 4-byte
sections, so the maximal value of a parameter section in hexadecimal format can be 0xFFFFFFFF. Thus, each
such section can be divided in one or several parameters, for example some of parameters can take only 1
bit, others can be longer up to the size of a whole 4 bytes section. Each “param” element describes a
separate parameter and contains the following properties:
- element “short_name” states parameter short name to be displayed in case of small display
- element “name” states parameter name
- element “description” states parameter description
- element “type” states parameter type, possible variants are:
o 0 – parameter for PTS-1 controller
o 1 – parameter for PTS-2 controller
o 2 – parameter for pump specific protocol
o 3 – parameter for probe specific protocol
o 4 – parameter common for all pump protocols
o 5 – parameter common for all probe protocols
- element “index” states parameter index used for configuration
- element “input” states parameter range of values and meaning and contains the following possible
elements:
o element “type” states parameter input type, possible values are:
▪ 0 – Boolean value taking 1 bit with possible values: 0 for unset, 1 for set
This parameter relates to pump protocol 15 (Tatsuno SS-LAN), its index is 1, GUI of
software can display this parameter as a checkbox.
Default value is 0 (meaning unchecked state).
Shift of this parameter is 16, so that if the option is checked – then the parameter value
is shifted 16 bits from start of the parameter section making the value to be
10000000000000000 in binary format.
▪ 1 – enumeration with list of values to be stated, in case of this input type the following
elements for element “input” are possible:
• element “enum” with description of the parameter with property “value”
stating the parameter value
Example:
This parameter relates to pump protocol 16 (Shelf), its index is 1, GUI of software can
display this parameter as a dropdown list with possible options:
• No (value 0)
• Yes (value 1)
• In automatic mode (value 2)
Default value is 0 (meaning first option ‘No’).
▪ 2 – integer value with range of values to be stated, in case of this input type the
following elements for element “input” are possible:
• element “min” with minimal value of the parameter value
• element “max” with minimal value of the parameter value
Example:
This parameter relates to pump protocol 16 (Shelf), its index is 2, GUI of software can
display this parameter as updown list with values in range from 1 to 4 and default
value 2.
▪ 3 – float value with range of values to be stated, in case of this input type the following
elements for element “input” are possible:
Example:
This parameter relates to pump protocol 16 (Shelf), its index is 3, GUI of software
should display this parameter as float value in format “03.02f” meaning 3 integer digits
and 2 decimal digits, default value is 700.00. After entering the value, the system
should multiply it on 100 making the decimal digit from it. For example, if the entered
value is 123.45 – then the value to be saved should be 12345 = 0x3039.
o element “mask” states how many bits the parameter takes in memory, the values are given in
a format of maximal bits value the parameter can take. For example, if the parameter can have
a value from 1 to 5 – then its values can take 3 bits maximum, so the maximal bits value is 111
in binary and the mask should equals to 7.
o element “shift” states what is the parameter offset in bits from the 4-bits parameter section
value.
o element “default” states what is the parameter default value.
Parameters are saved in memory in hexadecimal format. In case if there are several parameters taking the
same parameter section – then all of them should be accounted when writing new parameter value to
parameter section.
Pinout of cable used for connection RS-232 ports of PTS controller to PC:
DB-9F connector
STRUNA ATG
calculation unit
To PTS RS-232 port To COM-port of PC
ORDER INFORMATION
Examples of order:
- order of PTS-2 controller in a view of electric board: PTS2-PCB-001
- order of PTS-2 controller installed in a mounting box: PTS2-BOX-001
- order of PTS-2 controller SDK: PTS2-SDK-001