CStoreOffice® Support & Learning

Station Options: ATG

This page consists of the following sections:

About ATG

Automatic Tank Gauging (ATG) is a powerful tool that enables you to manage fuel inventory and delivery schedules effectively. ATG represents a class of devices, which perform the following functions:

  • Gather information on the tanks, pumps, and other equipment status, using various sensors placed on this equipment.
  • Share the gathered information through the specialized protocols.

In CStoreOffice®, the ATG functionality provides the fuel monitoring data and works via the following two types of devices:

  • Veeder-Root device of the Gilbarco company.
  • Pneumercator device of the Pneumercator Inc. company.

To check the gasoline inventory in CStoreOffice®, use the following forms and reports:

Enabling ATG for Current Station

By default, ATG is disabled in CStoreOffice®. To enable ATG and configure its settings, the Allow users to set up ATG permission is required for your user in CStoreOffice®. Otherwise, the ATG form is available only in the view mode. For details, see Granting Role Permissions to Roles and Users.

To enable ATG for your station, follow these steps:

  1. In the CStoreOffice® main menu, select Data Entry > Dashboard.
  2. In the Station Options grid, select Cash Register.
  3. Select the Enable CR data processing option and click Save.
  4. In the left menu, select ATG.
  5. Select your station in the stations list.

  6. Select the Enable ATG option.
    Result: You can configure the ATG connection settings. For details, see Configuring ATG Connection.

Configuring ATG Connection

You can configure connection with ATG using one of these modes:

  • DC Box–HTTP API. Use this mode when DC Box transfers data from the ATG device to CStoreOffice® by using HTTP API. This mode is default and recommended for all stations equipped with DC Box. To configure the connection using this mode, see DC Box–HTTP API mode.
  • DC Box–Router. DC Box operates as proxy transferring requests from CStoreOffice® to the ATG device. To configure the connection using this mode, see DC Box–Router mode.
  • CSO–External IP. CStoreOffice® requests data from the ATG device directly without DC Box. To configure the connection using this mode, see CSO–External IP mode.

DC Box–HTTP API mode

To configure the ATG connection using the DC Box–HTTP API mode, follow these steps:

  1. Switch to the Advanced view.

  2. In the Data Transfer list, select DC Box.
  3. In the Device list, select the ATG device used in your location.
  4. In the Transport list, select HTTP API.
  5. Depending on the interface used in DC Box to connect the ATG device, do the following: 
    Interface

    How to configure ATG connection

    Ethernet

  6. In the Connection Type list, select IP.
  7. In the LAN IP Address field, enter IP address of the device.
  8. In the Port list, select the port of the ATG device.
  9. In the Connection Mode list, select Gateway.
  10. Change the net mask in the Net Mask field if required.
  11. COM

    The COM interface is present only on the 400 series models of DC Box.

  12. In the Connection Type list, select Serial.

  13. In the Baud Rate list, select the baud rate.
  14. In the Data Bits list, select the data bits value.
  15. In the Parity Check list, select the parity check value.
  16. In the Stop Bits list, select the stop bits value.
  17. In the upper-right part of the page, click Save.
  18. Optionally, you can enable info messages to receive emails about the ATG connection status.

DC Box–Router mode

To configure the ATG connection using the DC Box–Router mode, follow these steps:

  1. Switch to the Advanced view.

  2. In the Data Transfer list, select DC Box.
  3. In the Device list, select the ATG device used in your location.
  4. In the Transport list, select Router.
  5. Depending on the interface used in DC Box to connect the ATG device, do the following: 
    Interface

    How to configure ATG connection

    Ethernet

  6. In the Connection Type list, select IP.
  7. In the LAN IP Address field, enter IP address of the device.
  8. In the Port list, select the port of the ATG device.
  9. In the Connection Mode list, select Gateway.
  10. Change the net mask in the Net Mask field if required.
  11. COM

    The COM interface is present only on the 400 series models of DC Box.

  12. In the Connection Type list, select Serial.

  13. In the Baud Rate list, select the baud rate.
  14. In the Data Bits list, select the data bits value.
  15. In the Parity Check list, select the parity check value.
  16. In the Stop Bits list, select the stop bits value.
  17. In the upper-right part of the page, click Save.
  18. Optionally, you can enable info messages to receive emails about the ATG connection status.

CSO–External IP mode

To configure the ATG connection using the CSO–External IP mode, follow these steps:

  1. In the Data Transfer list, select External IP.

  2. In the Device list, select the ATG device used in your location.
  3. In the IP or Domain Name field, enter IP address or domain name of the ATG device.
  4. In the Port list, select the port of the ATG device.
  5. In the upper-right part of the page, click Save.
  6. Optionally, you can enable info messages to receive emails about the ATG connection status.

Enabling info messages

To receive notifications about the ATG connection status from CStoreOffice® via email, follow these steps:

  1. Select the Enable Info Messages option.

  2. In the Inform every group of options, select 1, 2, 3, or 4 Hours to define the notifications sending interval.
  3. Enter an email address you want to send the notifications to in the Email list field and click Add New.
  4. To remove an email from the list, select it and click Remove Selected.
  5. In the upper-right part of the page, click Save.

Viewing ATG Connection Information

You can see the following information about the ATG connection below the stations drop-down list:

  • Last Monitoring: date and time when the ATG connection was monitored for the last time. CStoreOffice® monitors the connection every 10 minutes.
  • Green icon means the connection was successful.
  • Red icon means there were issues with the ATG connection.
  • Inventory: date and time of the last inventory data download.

Testing ATG Connection

To test the ATG connection, follow these steps:

  1. In the upper-right part of the page, click Test Connection.

  2. If the connection is successful, you can view the fuel inventory details in the appeared pop-up.

Requesting ATG Sensors Data Updates

You can request the ATG sensors data updates to update the fuel inventory data. To request the ATG sensors data updates, follow the steps:

  1. In the upper-right part of the page, click Request inventory reading.

  2. Wait the request to be processed.
  3. You can check the latest fuel inventory data on the Fuel Inventory page.