PTS-1 controller over fuel dispensers and ATG systems

Purpose

PTS 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. 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 controller the same way regardless the brand of fuel dispensers and ATG systems used, PTS 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 controller the POS becomes able to provide control over any of fuel dispensers and ATG systems supported by PTS controller. PTS 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.

fuel pump controller systemClick on image to enlarge

PTS 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 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 controller into control systems for petrol stations (POS system, cash register, OPT terminal, etc).


fuel dispenser controller for petrol stations

Fuel pump solutions: forecourt controller

Forecourt controller for gas stations

Forecourt controller manufactures
Click on image to enlarge

PTS fuel pump controller can simultaneously control up to 16 fuel dispenser sides (fueling places). PTS controller has 4 independent pump ports, each of them can be programmed to its own communication protocol and baud rate, thus PTS controller provides communication with connected dispensers simultaneously using up to 4 various communication protocols. Each PTS controller pump port can connect up to 16 fueling places maximum.

PTS controller can simultaneously control up to 16 ATG probes (gauges) (separate probes or probes connected to ATG systems / consoles) that use up to 3 various communication protocols and baud rates (each of the probe ports can be adjusted to a separate communication protocol and baud rate and connect up to 16 ATG probes maximum).

PTS controller allows a possibility to lead management over the same fuel dispensers from several POS systems and share ATG probes measurement values between several interconnected PTS controllers. Thus every interconnected PTS controller is able to provide control over any of the connected fuel dispensers and know ATG system measurement data of every other interconnected PTS controller.

PTS controller supports 90 types of fuel dispensers brands of various manufacturers, between which you can find: Wayne Dresser Europe, Wayne Dresser Brasil, Gilbarco Veeder Root, Tokheim, Nuovo Pignone, Wayne Pignone, Tatsuno Japan, Tatsuno Europe, Tatsuno Rus, Tokico, Bennett, Petrotec, Salzkotten, FAS, Adast, MM Petro ZAP, Emgaz Dragon, Galileo, Kraus, Welma, PEC (Gallagher), Develco, Logitron, Kalvacha, Safe, Wayne Meksan, Mekser, Mepsan, 2A, Petposan, Petrolmeccanica, Batchen, Email, EuroPump, Baransay, Sanki, Korea EnE, LG EnE, SOMO Petro, HongYang, Blue Sky, GreenField, Falcon, Dong Hwa Prime, EPCO, Slavutich, Shelf, UniCon, UniGaz and others.

PTS controller supports more than 25 types of automatic tank gauge (ATG) systems of various manufactures (Gilbarco Veeder Root, OPW, Hectronic, Struna, PetroVend, Start Italiana, Fafnir, Assytech, VEGA, Windbell and others).

PTS controller is CE approved and has all corresponding test reports.

Features and benefits

  • Supports over 70 communication protocols of fuel dispensers and ATG systems. List of supported communication protocols is constantly growing. A wide range of international protocols as Wayne DART, Gilbarco 2-wire, Tokheim, Tatsuno are included. Single firmware of PTS controller contains all available communication protocols for fuel dispensers and ATG systems.
  • Unified approach to management over any forecourt equipment - using PTS controller control over any supported fuel dispenser or ATG system is done in exactly the same way by the management system (POS system, cash register, OPT terminal, etc). PTS controller has a single common communication protocol. Thus having once implemented the protocol into the management system (or its API) the management system will be able to provide control over any of the supported fuel dispensers and ATG systems in exactly the same way.
  • Conversion between pumps protocols - 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.
  • Conversion between ATG consoles protocols - in case if POS system already knows some open communication protocol of ATG consoles - then it can use PTS controller for its conversion to any other ATG console or probe protocols.
  • Real-time control over fuel dispensers and ATG systems. PTS controller provides a hardware solution for stable and reliable operation of forecourt equipment.
  • Scalability - PTS controller provides control over up to 16 dispenser sides, in case of necessity several PTS controllers can work simutaneously.
  • Possibility to provide control over same fuel dispensers from several POS systems and receive data on ATG measurements from any interconnected PTS to each POS system - PTS controllers, installed near each of the POS systems, can be interconnected with each other allowing each of the POS systems to provide control over each of the connected fuel dispensers or monitor its state and to have data measurements of ATG systems connected to any of the interconnected PTS controllers.
  • Rich set of interface converters for connection to fuel dispensers - PTS controller has output pump ports in RS-485 interface so can be directly connected to fuel dispensers with this type of interface. Other dispensers having communication interface of 2-wire current loop, 3-wire current loop, 4-wire current loop, RS-232 interface are connected to PTS controller through special interface converters.
  • Rich software API for developers - PTS controller is supplied with full API (application programming interfaces) and open-source test applications for common programming languages and operation platforms: C, C++, C#, Delphi, Java, Python, Visual Basic, COM-object.
  • "All in one" configuration tool for PTS controller: one configuration utility provides configuration of its pump and probe ports, internal parameters, reads version, makes firmware updates, captures logging from any channel and makes self-diagnostics of the PTS controller.
  • Easy firmware updating - All new firmware updates are available for download to all existing customers. Firmware update process takes about 1 minute. Easy way to back up and restore PTS controller configuration between updates.
  • Logging of operation - in order to remove problematic situations of PTS controller communication with any forecourt equipment logging of communication exchange without interrupting PTS controller operation is available, which allows quick search and elimination of any found problems.
  • Self-diagnostics of operation - easy and quick built-in diagnostics of PTS controller operation: CPU, memory, RS-232 and RS-485 interfaces, DIP-switches.
  • Constant software updates - PTS controller firmware is constantly being improved, new protocols are being added and latest updates are always available for download to all customers.
  • Support by developers for developers - 24 hours support for all customers of PTS controller on any standing issues.
  • Credit-card size and suits to any dimension for installation inside master systems.

Technical characteristics

PARAMETER VALUE
Power supply voltage 12 V DC
Current consumption 400 mA max
Temperature range from -40°C to +80°C
Weight 120 g
Overall dimensions 85 x 58 x 20 mm

Supported communication protocols

Fuel dispensers communication protocols

Baud rate is configured for each pump port in PTS controller independently on the used communication protocol.

Some dispensers may demand using interface converter boards to RS-485 interface (depends on electronics of used pumphead in dispenser).

## FUEL DISPENSER BRAND PROTOCOL NAME
1 2A S4-Dart
2 ACTRONIC PEC Pump Communication Protocol
3 ADAST (ADAMOV SYSTEMS) Adast EasyCall
4 AG WALKER SPDC-1,
MPDC-1
5 AGIRA PEC Pump Communication Protocol,
PumpControl,
Develco
6 ANGI International Gilbarco Two-Wire
7 ARIEL PumpControl
8 ASPRO PumpControl,
Develco,
Coritec
9 ASSYTECH Dart
10 ASTRON TiT UniPump
11 AZT AZS 2.0
12 BARANSAY Gilbarco Two-Wire
13 BATCHEN Gilbarco Electroline,
Gilbarco MPP,
PumpControl,
Maser,
PEC Pump Communication Protocol
14 BENNETT Bennett pump dispenser protocol (current loop),
Bennett pump dispenser protocol (RS-485 Fleet),
Bennett pump dispenser protocol (RS-485 Retail)
15 BLUE SKY Blue Sky 6-6-4 protocol,
Blue Sky 8-8-6 protocol,
LT protocol,
LY protocol,
JP protocol
16 CENSTAR Censtar protocol
17 CFT Clean Fuel Gilbarco Two-Wire
18 COMPAC PEC Pump Communication Protocol,
Gilbarco Australia
19 COPTRON Dart
20
CORITEC Coritec
21 DATIAN MACHINES WS 16 communication protocol
22 DEM G. SPYRIDES Wayne Dart
23 DEVELCO Develco
24 DONG HWA PRIME Prime pump interface
25 DURULSAN Dart,
Gilbarco Two-Wire
26 EAGLESTAR Eaglestar
27 EMGAZ DRAGON Marconi PumaLAN
28 EPCO Epco protocol specification
29 ESIWELMA Marconi PumaLAN
30
EUROPUMP S4-Dart
31
FALCON LPG Falcon
32
FORNOVO GAS Marconi PumaLAN
33 FUELQUIP PEC Pump Communication Protocol
34 FUELSIS S4-Dart
35 GALILEO PumpControl
36 GASLIN S4-Dart
37 GERKON TiT UniPump
38 GILBARCO Gilbarco Two-Wire,
Extended Two-Wire Appendix
39 GREENFIELD Gilbarco Two-wire
40
HITACHI SS-LAN protocol
41
HONG YANG HongYang FZ-protocol,
HongYang 886 communication protocol,
HongYang 886 MPD communication protocol
42
IMW PumpControl,
Tokheim UDC
43
INTERMECH PEC Pump Communication Protocol
44 KALVACHA Kalvacha
45 KIEVNIIGAZ TIT UniGaz
46 KOREA ENE EnE Dispenser POS protocol
47 KPG-2 TIT UniGaz
48 KRAUS MNET design specification,
Gilbarco Two-wire
49 KWANGSHIN KS-NET PROTOCOL
50
LANFENG RS–232 protocol,
RS–485 protocol,
SS-LAN protocol
51
LG ENE EnE Dispenser POS protocol
52
LOGITRON Marconi PumaLAN
53
MASER Maser,
Gilbarco Two-wire
54 MEKSAN / WAYNE SU86 Wayne Dart
55 MEKSER S4-Dart
56 MEPSAN S4-Dart
57 MIDCO Midco Proprietary Pump Protocol (versions 3.10, 3.11, 3.12)
58 MM PETRO (ZAP) MM PETRO ZAP RS-485
59 MOTOGAZ PumpControl
60
MS GAS SK protocol
61
NARA AZT 2.0
62
NUOVA MIGAS Dart
63
NUOVO PIGNONE Nuovo Pignone RS-485,
Nuovo Pignone Current Loop 4-wire,
Wayne Dart
64 PEC (GALLAGHER FUEL SYSTEMS) PEC Pump Communication Protocol,
Gilbarco Australia
65 PETPOSAN S4-Dart
66 PETROEQUIP Lanfeng protocol
67 PETROMECCANICA Wayne Dart
68 PETROTEC Petrotec HDX protocol
69 PROWALCO SPDC-1 / MPDC-1,
SPDC-2 / MPDC-2,
Salesmaker & ICON
70
PUMP CONTROL PumpControl
71
REAL-TECH Blue Sky,
SS-LAN
72
RIX PEC Pump Communication Protocol
73
SAFE Safe PMII Graf,
PumpControl
74 SALZKOTTEN ER3 Data interface,
Gilbarco Two-Wire,
Marconi Logitron PumaLAN
75 SANKI Sanki common communication protocol,
Sanki communication protocol for CIS countries
76 SEA BIRD Blue Sky
77 SHELF Shelf
78 SCHEIDT & BACHMANN T02,
V11
79 SHIBATA SS-LAN
80
SLAVUTICH Slavutich FD-Link
81
SOMO PETRO POS protocol
82
STAR HongYang 886 communication protocol,
HongYang 886 MPD communication protocol
83
TATSUNO (JAPAN) Tatsuno SS-LAN,
Extended Digits Number protocol
84 TATSUNO EUROPE (FORMER BENC) Tatsuno Benc PDE,
Logitron PumaLAN
85 TEKSER Wayne Dart,
Wayne US Current Loop
86 TOKHEIM Tokheim Controller-Dispenser Communication protocol (UDC),
Logitron PumaLAN
87 TOKHEIM INDIA TQCL serial communication protocol
88 TOKICO Tokico SS-LAN
89 TOMINAGA Tominaga SS-LAN
90
TOPAZ TOPAZ Electro,
Iskra ver. 1.72
91
TRANSPONDER PEC Pump Communication Protocol
92
UCAR ELEKTRIC S4-Dart
93
UNICON-TIT TIT UniPump
94 VANZETTI Logitron PumaLAN
95 WAYNE DRESSER Wayne Dart,
Wayne US Current Loop
96 WAYNE PIGNONE Wayne Dart
97 YENEN S4-Dart,
Maser
98 ZCHENG GENUINE MACHINES Zcheng communication protocol

Automatic tank gauge (ATG) systems communication protocols

Communication parameters (baud rate, parity control, data and stop bits) are configured for each probe port in PTS controller independently on the used communication protocol.

## ATG SYSTEM BRAND PROTOCOL NAME
1 ACCU PD-300 Communication Protocol
2 ALISONIC Alisonic,
Gilbarco Veeder Root
3
ASSYTECH Assytech
4
BLUE SKY Gilbarco Veeder Root
5
DUT-E COM protocol
6
EAGLESTAR Modbus RTU,
Smart-probe communication protocol
7
EBW Gilbarco Veeder Root
8
ENRAF Enraf Height protocol,
Enraf Volume protocol
9
FAFNIR Fafnir VISY-Quick,
Gilbarco Veeder Root
10
FRANKLIN FUELING Gilbarco Veeder Root
11
GAMICOS GLT622 console communication protocol
12 GILBARCO VEEDER ROOT Gilbarco Veeder Root,
Gilbarco Dispenser Interface Protocol (DIM)
13 HECTRONIC Hectronic HLS,
VR-Dip
14
HONG YANG Gilbarco Veeder Root
15 HUMANENTEC 520S Communication Protocol
16 INCON Gilbarco Veeder Root
17 LABKO Labkotec POS interface protocol
18 MTS ATG SENSORS MTS USTD
19
NORTH FALCON North Falcon,
Gilbarco Veeder Root
20
OMNICOMM COM protocol
21
OMNTEC Gilbarco Veeder Root
22
OPW Petrovend4,
Petrovend4 ACR,
Gilbarco Veeder Root
23 QINGDAO GUIHE Gilbarco Veeder Root,
Qingdao Guihe MODBUS RTU
24 START ITALIANA Start Italiana SMT/XMT,
Gilbarco Veeder Root
25 STRUNA Struna Kedr spec. 1.4
26 UNIPROBE Uniprobe
27 VEGA Vega ASCII protocol
28 WINDBELL Windbell smart-probe communication protocol

Need more protocols?

We are constantly expanding a list of supported communication protocols and forecourt equipment.

Please contact us if you are interested in other pumps or probes brands, communication protocols or control equipment not listed here.

Connection to fuel dispensers

PTS controller can simultaneously control up to 16 fuel dispenser sides (fueling places). PTS controller has 4 independent pump ports and each of them can be programmed to its own communication protocol and baud rate, thus PTS controller provides communication with connected dispensers, simultaneously using up to 4 various communication protocols. Each PTS controller pump port can connect up to 16 fueling places maximum.


Pumps (fuel dispensers) connection schemeClick on image to enlarge

Connection to ATG systems

PTS controller can simultaneously control up to 16 ATG probes (gauges) (separate probes or probes connected to ATG systems/consoles) that use up to 3 various communication protocols and baud rates (each of the probe ports can be adjusted to a separate communication protocol and baud rate and connect up to 16 ATG probes maximum.


ATG systems (probes, gauges) connection schemeClick on image to enlarge

At communication to ATG consoles PTS 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:


Tanks reconciliation reports and automatic tank calibrationClick on image to enlarge

Conversion between pumps protocols

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.


Conversion between pumps protocolsClick on image to enlarge

At this control over pumps can be done in parallel from control systems connected through pump port and PC port, PTS controller internally tracks which control system locks control over dispensers:


Conversion between pumps protocolsClick on image to enlarge

Conversion between ATG consoles protocols

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.


Conversion between ATG consoles protocolsClick on image to enlarge

Monitoring over fuel dispensers and tanks

In case if there is an existing POS system already installed on the station PTS 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 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 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.


Monitoring over fuel dispensers and tanksClick on image to enlarge

Fuel dispensers sales data for ATG consoles for tanks reconciliation and autocalibration

Possibilities of the PTS controller allow to apply it in various ways for provision of control over forecourt equipment at petrol stations and allow its easy integration with existing POS systems and OPT terminals at petrol stations.

One of the applications is 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. Most of the petrol stations with installed ATG consoles do not have this option due to POS system can not provide sending of dispensers’ transactions to the console. Installation of the PTS controller between POS system and dispensers solves this problem and 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)

Fuel dispensers sales data for ATG consoles for tanks reconciliation and autocalibrationClick on image to enlarge

Multi POS systems operation

PTS controller allows a possibility to lead management over the same fuel dispensers from several POS systems and share ATG probes measurement values between several interconnected PTS controllers. Thus every interconnected PTS controller is able to provide control over any of the connected fuel dispensers and know ATG system measurement data of every other interconnected PTS controller.

If a necessity arises to organize several working places at petrol station (several POS systems) each of the POS systems should have its own PTS controller connected. PTS controllers should be interconnected with each other through a dispatcher PTS port (DISP channel on RS-485 interface) and with fuel dispensers. Thus control over each fuel dispenser at petrol station can be made from every POS system and each PTS controller will know measurement data of every ATG probe connected to any of the interconnected PTS controllers. During authorization of a fuel dispenser from one POS system the fuel dispenser becomes locked by PTS controller of this POS system and while it is locked all other POS systems cannot control given fuel dispenser, they can only monitor its current state. When operation of given POS system is finished with given fuel dispenser, PTS controller of this POS system unlocks the fuel dispenser and it becomes commonly available to all other PTS controllers, which makes it possible to be controlled (locked) by any of the PTS controllers connected to other POS systems.


PTS controller interconnectionClick on image to enlarge

PTS controller configuration utility

PTS controller pump port configuration

PTS controller firmware update

PTS controller log capturing

PTS controller diagnostics
Click on image to enlarge

PTS controller configuration utility is an open source application, which provides the following operations with PTS controller:

  1. Configuration of pump port and probe port of PTS controller
  2. Configuration of pump protocol, ATG, and PTS controller parameters
  3. Provision of control over the pumps and monitoring measurement values of ATG systems like real POS system
  4. Saving of all PTS controller configuration to file and restoring of all configuration from file
  5. Updating of PTS controller firmware
  6. Logging of PTS controller communication on selected channel
  7. Self-diagnostics of PTS controller:CPU, memory, RS-232 and RS-485 interfaces, DIP-switches
  8. Reading of current PTS controller firmware version: display of firmware date, number and supported communication protocols
  9. Direct connection of PTS to POS system or connection through fiscal module: possibility to configure PTS controller via direct connection of PTS controller to POS or connection through fiscal module
  10. Multilanguage support: easy addition of new languages to the utility, all languages are stored in XML-file, which is easy to edit

Developers' API, source codes and examples

PTS controller for developers is supplied together with a rich set of API (application programming interfaces) for commonly used programming languages and operation platforms:

  • C and C++ - API for communication with a PTS controller through a COM-port, documentation and examples of application in source codes under Windows OS and Linux operating systems
  • C#:
    • open source library, which includes classes, methods and properties for communication with PTS controller for provision of control over dispensers and ATG systems and configuration of PTS controller
    • open source PTS controller configuration and testing utility
    • open-source utility for testing and indication of all operations provided by the PTS controller, allows to perform all operations with the PTS controller
    • open source fully-functional application for provision of control over up to 8 pumps and 4 ATG systems by the PTS controller, allows to perform all operations with the PTS controller
  • Delphi - API for communication with a PTS controller through a COM-port, documentation and examples of application in source codes
  • Java:
    • open source library, which includes classes, methods and properties for communication with PTS controller for provision of control over dispensers and ATG systems and configuration of PTS controller
    • open-source utility for testing and indication of all operations provided by the PTS controller, allows to perform all operations with the PTS controller
  • Python - API for communication with a PTS controller through a COM-port, documentation and examples of application in source codes
  • Visual Basic .NET:
    • open source library, which includes classes, methods and properties for communication with PTS controller for provision of control over dispensers and ATG systems and configuration of PTS controller
    • open source PTS controller configuration and testing utility
    • open-source utility for testing and indication of all operations provided by the PTS controller, allows to perform all operations with the PTS controller
    • open source fully-functional application for provision of control over up to 8 pumps and 4 ATG systems by the PTS controller, allows to perform all operations with the PTS controller
  • COM-object for PTS controller:
    • open-source COM-object (written in Microsoft Visual C++ 6.0 IDE in C++ programming language) with methods and properties for communication with PTS controller for provision of control over dispensers and ATG systems and configuration of PTS controller
    • open-source application in Microsoft Visual Basic 6.0 for testing and indication of all operations provided by the PTS controller, allows to perform all operations with the PTS controller
  • Description of communication protocol of PTS controller - describes communication parameters, message structure, commands and responses between POS management system and PTS controller, typical flowchart and a diagram of interaction 

PTS controller SDK (Software Development Kit)

PTS controller SDK (Software Development Kit) is intended for developers of POS management software for petrol stations that want to control fuel dispensers and ATG systems from their software.

PTS controller software development kit

PTS controller SDK includes:

Hardware:

  1. PTS controller over fuel dispensers and ATG systems for petrol stations - 1 pcs
  2. Interface converter RS-485 / RS-232 - 1 pcs
  3. Cabling

Software:

  1. Software simulators of prevalent fuel dispensers
  2. Software simulators of ATG systems (probes)
  3. API for developers in various programming languages:
    • C and C++
    • C#
    • COM-object
    • Delphi
    • Java
    • Python
    • Visual Basic 6.0
    • Visual Basic .NET
    • Description of communication protocol with PTS controller
  4. "All in one" configuration utility for configuration, firmware update, logging and diagnostics of the PTS controller
  5. PumpDemo - free contracted version of NaftaPOS software for petrol stations
  6. Useful utilities for debugging of communication with PTS controller
PTS controller Software Development Kit structure Click on the scheme to enlarge

Open source fully-functional application for petrol stations in C# language and also in VB.NET language

PTS controller Software Development Kit

PTS controller Software Development Kit

PTS controller Software Development Kit
Click on image to enlarge

Open-source utility for testing and indication of all operations provided by the PTS controller in C# language and also in VB.NET language

PTS controller Software Development Kit

PTS controller Software Development Kit

PTS controller Software Development Kit
Click on image to enlarge

Open-source utility for testing and indication of all operations provided by the PTS controller in Java language (compiled in NetBeans IDE)

PTS controller Software Development Kit

PTS controller Software Development Kit

PTS controller Software Development Kit
Click on image to enlarge

Open-source utility for testing and indication of all operations provided by the PTS controller on the basis of COM-object, application written in VB6.0 language

PTS controller Software Development Kit

PTS controller Software Development Kit

PTS controller Software Development Kit
Click on image to enlarge

Open source utility for testing control over pumps and ATG systems provided by the PTS cotroller in Delphi 7

PTS controller Software Development Kit
Click on image to enlarge

Open source utility for testing control over pumps and ATG systems provided by the PTS cotroller in Python

PTS controller Software Development Kit
Click on image to enlarge

PumpDemo - free contracted version of NaftaPOS software for petrol stations

PTS controller Software Development Kit

PTS controller Software Development Kit
Click on image to enlarge

PTS Terminal - tool for debugging communication with PTS controller

PTS controller Software Development Kit
Click on image to enlarge

Pumps software simulator

PTS controller Software Development Kit

PTS controller Software Development Kit
Click on image to enlarge

ATG systems software simulator

PTS controller Software Development Kit
Click on image to enlarge

PTS controller SDK is required and designed for software developers for:

  1. Improve understanding of operating the PTS controller.
  2. Implement the PTS controller into own developed POS management system or software application for control over fuel dispensers and ATG level measurement systems for petrol stations.
  3. Debug own software application to correctly provide control over fuel dispensers and probes locally (on the workplace) without need to connect to real fuel dispensers and probes using software simulators of pumps and probes supplied in structure of SDK.

Firmware updates

PTS controller firmware is constantly being improved and new communication protocols are added. New versions of PTS controller firmware are available for download to customers.

Technical support

Support team provides 24 hour help and customer assistance on any questions which may arise with PTS controller. Questions are answered by experienced developers and programmers, who have sufficient knowledge and can assist with any questions regarding software development.

Order information

PTS PCB board with terminal blocks
PTS PCB board with terminal blocks
Order code: PTS-U5-PCB-001

PTS controller box
PTS controller box (RS-232 input interface)
Order code: PTS-U5-BOX-001


PTS Software Development Kit
PTS Software Development Kit (SDK)
Order code: PTS-SDK-001



 Downloads


What are the installation requirements for the petrol station?

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.

1. Requirements to power supply

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.

3. Requirements to laying of cable communications

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.


Wiring connections diagram

How many dispensers can PTS controller provide control over?

PTS controller can simultaneously control up to 16 fuel dispenser sides (fueling places). PTS controller has 4 independent pump ports and each of them can be programmed to its own communication protocol and baud rate, thus PTS controller provides communication with connected dispensers, simultaneously using up to 4 various communication protocols. Each PTS controller pump port can connect up to 16 fueling places maximum.


Pumps (fuel dispensers) connection scheme

What wires are used for connection of the PTS controller with dispensers? Are wires supplied together with the PTS controller?

PTS controller is supplied without cables for connection to dispensers and ATG systems. For connection to dispensers and ATG systems you will have to prepare the cablings yourself. You can use any standard FTP cable with twisted pair and aliminium foil for screening (like FTP CAT 5E) for connection.

When PTS controller is to be connected directly to ATG probes installed in fuel tanks (without ATG console) - then connection should be obligatory done through the safety barrier (intrinsic safety barrier), which prevent any sparks coming from the cable in explosion dangerous area of tanks, where the ATG probes are installed.

If there are totally 4 pump ports in PTS controller - does it mean that only 4 pumps can be connected to it?

Total quantity of pumps to be connected to PTS controller is 16. Each of the pump ports can be configured to its own communication protocol and baud rate, so you can connect dispensers of 4 various brands to the same PTS controller. You can connect up to 16 pumps to the same pump port or you can distribute all the maximum 16 pumps between the any or all pump ports. As the pump ports are working independently from each other it is recommended to distribute the connected dispensers between all the pump ports in approximately equal quantities in order to make polling of connected pumps be the fastest.

What is the difference between the pump and fuel dispenser?

Under pump we mean a fueling place, which is a dispenser side (in case if dispenser has 2 sides) or a whole dispenser (in case if dispenser has 1 side).

Where is the PTS controller installed: near the POS or inside the fuel dispenser?

The PTS controller has RS-232 interface for communication with a control system (e.g. POS system, cash register, payment terminal, etc). RS-232 interface specification allows connection with maximum distance up to 15 meters between devices using this interface. It means that the PTS controller should be used close to the control system. Interfaces normally used in dispensers allow much longer distances for communication (for example RS-485 or current loop interface normally allows distances up to 1200 meters for communication).

How are the fuel dispensers connected to the PTS controller: directly or through an interface converter?

This depends on the type of interface used in the dispensers.

Dispensers, which use RS-485 interface, are directly connected to the PTS controller. Examples of such dispensers are: Wayne Dresser Europe, Nuovo Pignone, Wayne Pignone, Tatsuno Japan, Tatsuno Europe, Tatsuno Rus, Tokico, Bennett, Adast, MM Petro ZAP, Galileo, Develco, Safe, Wayne Meksan, Mekser, Mepsan, 2A, Petrolmeccanica, EuroPump, Sanki, Korea EnE, LG EnE, SOMO Petro, Blue Sky, Dong Hwa Prime, EPCO, Slavutich, Shelf, UniCon, UniGaz, others.

Electronic dispensers, which use 2-wire current loop interface are connected to the PTS controller through the GB interface converter. Examples of such dispensers are: Gilbarco, Tankanlagen Salzkotten, Batchen Email, Kraus, Prowalco, Wayne Dresser (USCL communication protocol), PetroTec, EuroPump, Mekser, Meksan, Petposan, PEC (Gallagher Fuel Systems), Bennett, Falcon LPG, Greenfield, others.

Electronic dispensers, which use 3-wire passive current loop interface are connected to the PTS controller through the TH interface converter. Examples of such dispensers are: Tokheim, Satam, Emgaz Dragon, Kalvacha, others.

Electronic dispensers, which use 3-wire active current loop interface are connected to the PTS controller through the LP interface converter. Examples of such dispensers are: Logitron, Emgaz Dragon, Gilbarco Marconi, others.

Electronic dispensers, which use 4-wire active current loop interface are connected to the PTS controller through the HY interface converter. Examples of such dispensers is Hong Yang, others.

Electronic dispensers, which use 4-wire active current loop interface are connected to the PTS controller through the NP interface converter. Examples of such dispensers is Nuovo Pignone, others.

Electronic dispensers, which use RS-232 interface are connected to the PTS controller through the RS-485/RS-232 interface converter. Examples of such dispensers is Lanfeng, others.

Mechanical dispensers, which do not have electronic pumphead or interface for communication, can be connected to the PTS controller through the use RS-232 interface are connected to the PTS controller through the controller over mechanical fuel dispensers. Controller over mechanical fuel dispensers is intended to be used in connection with a control system for petrol station (POS system, cash register, OPT terminal, etc) to provide direct control over operation of electronic and mechanical fuel dispensers by controlling dispenser’s internal resources: motor, pulse sensor, nozzle, slowdown valve.

Is there any difference in provision of control over diferent fuel dispensers brands through the PTS controller?

PTS controller converts a proprietary dispensers and ATG systems communication protocols into a single communication protocol, which is called UniPump. Thus using a single communication protocol UniPump a control system (POS system, cash register, payment terminal) is able to provide control over any of the supported dispensers and ATG systems in exactly the same way. For a developer it does not matter which brand or model of the dispenser or a POS system is connected - control over it through the PTS controller is done in exactly the same way.

How to power supply the PTS controller? Is the power supply source supplied together with PTS controller?

PTS controller uses 12 V DC for feeding. Maximum current consumption is 400 mA.

Power supply source is not supplied together with a PTS controller. The power supply should be selected locally. This is connected with a reason that differennt countries may have different electricity network specifics: frequency and voltage.

At selection of the power supply you need to pay attention to the following 2 factors:

  • output voltage of power supply should be 12 V DC
  • maximum allowed current consumption of power supply should be more that maximum current consumption of PTS controller. If several devices are connected to the same power suource - then their total current consumption should be less than maximum allowed current consumption of power supply.

How to connect PTS controller to personal computer and what to do if there is no COM-port?

Connection of PTS controller to the control system (POS system, cash register, OPT terminal, etc) is made through a PC port of PTS controller, which has RS-232 interface (3 wires: TxD, RxD, Gnd). 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).

NOTE! Some of the proposed USB-to-COM converter cables can bring problems when communicating with PTS controller. Reason of these problems is that since PTS controller uses quite high baud rate for communication (57600 baud), so some USB-to-COM interface converter an "eat" some of the transferred bytes in the communication exchange, so that the transferred messages will be incorrect and communication will be stopped or made incorrectly. That is why it is recommended to use USB-to-COM interface converters on the basis of FTDI chip (www.ftdichip.com), these converters are tested to have stable and correct communication with the PTS controller. Normally the COM-port adjustments window for this USB-to-COM interface converter looks as follows (screenshot is made in Russian language version of Windows OS):

Also a double-channel USB-to-COM interface converter on the basis of FTDI chip can be ordered directly from us, please see the product order code "USB-to-COM interface converter (2-channels)" here

Communication with PTS controller is made using commands and responses described in UniPump communication protocol. Thus PTS controller provides conversion of the common communication protocol UniPump into various proprietary communication protocols of fuel dispensers and ATG systems.

Is it possible to use PTS controller in order just to listen to the dispenser to collect data on sales and not to provide control over it?

Yes, this is possible and PTS controller works on many petrol stations in exactly such a way.

This way of operation requires a control system to keep constant track over the dispenser state. Once the nozzle is taken up - the control system should authorize it with some volume, which is bigger than normal dispensing volume. After the dispensing is done - the control system should read transaction information from PTS controller and store its in its memory. As an example of such mode of operation please read how this is done in NaftaPOS software.

What is a set of instructions PTS controller allows to make with fuel dispensers and ATG systems?

Communication with PTS controller is made using commands and responses described in UniPump communication protocol. Thus PTS controller provides conversion of the common communication protocol UniPump into various proprietary communication protocols of fuel dispensers and ATG systems. The set of instructions includes commands:

  • Request status
  • Authorize
  • Suspend/resume dispensing
  • Stop
  • Get transaction information
  • Get total counters
  • Set/get prices
  • Switch on/off the lights (present in some models)
  • Get tag identifier (present in some models)
  • Get ATG measurement data

What API is available for development of own POS system on the basis of PTS controller?

PTS controller is supplied with full API (application programming interfaces) and open-source test applications for mostly used programming languages and operation platforms: C (for Windows and Linux OS), C++, C#, Delphi, Java, Python, Visual Basic, VB.NET, COM-object.

Are there any open source applications supplied together with PTS controller SDK and what is their license?

Yes, for each of the popular programming language we supply API and an open source applications for provision of control over dispensers and getting data from ATG systems. All software is given for free. You can use these application as a startup for your own POS system appilications and/or modify their source code to what is required by you.

PTS CONTROLLER CONFIGURATION AND TESTING UTILITY ONLINE VIDEO



PTS controller configuration and testing utility
(online video)


PTS controller SDK (software development kit) online video



PTS controller SDK hardware connections
(online video)



PTS controller SDK software configuration
(online video)

  Ask YOUR questions about
"PTS-1 controller over fuel dispensers and ATG systems"


CAPTCHA
Reload imageSound image
 

Result is successfull! Result is error!
Loading  Message is being sent... Please wait.
Write directly to us on: mail@technotrade.ua.
We will gladly answer all of your questions!


Other products of section:


PTS-2 forecourt controller   PTS-2 forecourt controller
PTS-2 forecourt controller for petrol stations serves for control over petroleum, LPG and CNG dispensers and automatic tank gauge systems and probes.
GB dispenser interface converter   GB dispenser interface converter
GB 2-wire interface converters (RS-485/RS-232 to 2-wire current loop and backwards) are intended for communication with dispensers (Gilbarco, Tankanlagen Salzkotten, Batchen Email, Kraus, Prowalco, Bennett and others) using 2-wire current loop interface through interfaces RS-232, RS-485 (2 wires).
TH dispenser interface converter   TH dispenser interface converter
TH 3-wire interface converters (RS-485/RS-232 to 3-wire current loop and backwards) are intended for communication with dispensers (Tokheim, Satam, Emgaz Dragon, Kalvacha, Kraus, others) using 3-wire current loop interface through interfaces RS-232, RS-485 (2 wires).
HY dispenser interface converter   HY dispenser interface converter
HY 4-wire interface converters (RS-485/RS-232 to 4-wire current loop and backwards) are intended for communication with dispensers (HongYang, Star) using 4-wire current loop interface through interfaces RS-232, RS-485 (2 wires).
NP dispenser interface converter   NP dispenser interface converter
NP 4-wire interface converters (RS-485/RS-232 to 4-wire current loop and backwards) are intended for communication with dispensers Nuovo Pignone using 4-wire current loop interface through interfaces RS-232, RS-485 (2 wires).
LP dispenser interface converter   LP dispenser interface converter
LP 3-wire interface converter (RS-485/RS-232 to 3-wire current loop and backwards) is intended for communication with fuel dispensers ( Logitron, Emgaz Dragon, Gilbarco Marconi, Fornovo LPG, others), which use 3-wire current loop interface, through interfaces RS-232, RS-485 (half-duplex).
NZ dispenser interface converter   NZ dispenser interface converter
NZ 2-wire interface converters (RS-485/RS-232 to 2-wire current loop and backwards) are intended for communication with dispensers (Actronic, Agira, Batchen, Compac, Intermech, PEC (Gallagher Fuel Systems), others) using 2-wire current loop interface through interfaces RS-232, RS-485 (2 wires).
NA dispenser interface converter   NA dispenser interface converter
Dispenser interface converter NA (RS-485/RS-232 to non-addressable RS-422/RS-485/RS-232 and backwards) are intended for communication with fuel dispensers Censtar, which do not have a communication address in communication protocol and use one of the following interfaces (RS-422, RS-232, RS-485).
RS-485 to RS-232 dispenser interface converter   RS-485 to RS-232 dispenser interface converter
RS-485 to RS-232 dispenser interface converter (RS-485 to RS-232 interface and backwards) is used for communication with fuel dispensers, which use RS-232 interface, through interfaces RS-232, RS-485 (half-duplex).
Wireless interface converter RFC   Wireless interface converter RFC
RFC converter is appointed for establishing of wireless communication between devices having interfaces RS-232 and RS-485.
Controller over mechanical fuel dispensers   Controller over mechanical fuel dispensers
Mechanical fuel dispenser controller is used in conjunction with a control system for petrol station to provide direct control over operation of electronic and mechanical fuel dispensers by controlling dispenser’s internal resources: motor, pulse sensor, nozzle, slowdown valve.
USB to RS-232 interface converter   USB to RS-232 interface converter
USB to RS-232 interface converter is intended for conversion from USB interface (USB 1.1, USB 2.0) into two independent RS-232 interfaces in duplex and half-duplex modes of data exchange.

Back to top