#

This guide will explain step by step, how to add aTotalflow Device in OnPing using a Totalflow G5 as an example device. This guide will also explain how to configure the driver for this device in OnPing.

Step 1: Connect the Totalflow Device (via Ethernet) #

There are a few ways to connect this specific device. In this example, the Totalflow G5 will be connected and configured via Ethernet.

The connected Ethernet cable is then routed to a Switch (shown below). From there the PC is connected to the Switch and internally routed to connect with the device.

Step 2: Ping the Totalflow Device #

In order to confirm that the device is online, the device needs to be ‘pinged’. Open the command terminal and ping the device by typing:

‘ ping 192.168.x.x ‘

In this example the IP address is ‘ 192.168.4.6 ‘. This will vary with different devices and systems. Confirm that the correct IP address for the device is being used.

Notice that after the ‘ping’ command was sent the device was replying. This usually means that communication between the device and the PC will be successfully established. 

Step 3: Download and Install Totalflow PCCU Software #

Now that the connection has been established, navigate to the web browser and download the Totalflow PCCU Software from ABB.com. 

Now that the software has been installed, open TotalFlow PCCU to communicate with the Totalflow device. Navigate to the top left of the software window and click ‘Operate’ on the toolbar. A dropdown window will appear. Hover over ‘Setup’ on the list. Move the cursor to the right and click ‘System Setup’.

In the System Setup window, navigate to the ‘Setup’ tab. Ensure that the PCCU Connection Method is correct. In this example, ‘TCP/IP’ will be used for connection. The IP should be the same as in Step 2. In this specific example, the IP for the Totalflow Device is ‘ 192.168.4.6 ’. No changes are needed in this example as the default settings are appropriate for successful setup.

In the middle of the window, locate the ‘Level 1-2 Security Code’. The default Security Code is 0000

After everything is confirmed correct, click the gray ‘Close’ button at the bottom right of the System Setup window.

Step 4: Establish Connection through Totalflow PCCU #

Navigate to the toolbar in PCCU and click the first icon to connect with the Totalflow device. When hovering over an icon, a small description about that icon will appear. Click the ‘Connect to Totalflow’ Icon.

If connection is established, a summary window will appear displaying the Station ID, Location and Device. There are options to collect Historical Data, Calibrate the Device, Monitor the Device, Perform Entry Setups and view Registry.

Locate and click the gray button at the bottom of the first row of options labeled ‘Monitor’.

A monitor window will appear for Monitor 1. Now that the device is being monitored, create a new data entry.

Navigate to the PCCU toolbar. Click the second icon labeled ‘Entry’ to create a New Entry.

A window will appear displaying the data for the connected Totalflow Device. These readings are from a demonstration unit so specific values may vary. 

Notice a small window appears when hovering over a specific value in this window. In this example, a number appears when hovering over the value of the Volume Flow Rate ‘17.35 MCF/Day’. That number is ‘11.7.19’ and will be useful in OnPing.

Now that the device has been configured and communicating properly with the PC, the IP address has been confirmed, and obtained knowledge about which registers to ‘pull’, navigate back to OnPing.

Step 5: Update tflow Driver on Lumberjack #

Ensure that the Totalflow driver is installed on selected Lumberjack. Navigate to the ‘Lumberjacks Application Systems’ panel on the OnPing dashboard. 

Select the Lumberjack. In this example, Lumberjack ‘6’ is selected. This is a demonstration, lab localized, lumberjack.

Once the blue checkbox next to the Lumberjack Serial number has been selected, a dropdown window displaying the Lumberjack’s information summary below. 

Navigate to the List icon on the top right corner of the Lumberjack summary window. Click the icon to enable a dropdown menu. Select ‘Date / Time’. In order to manually confirm that the Lumberjack is properly connected and communicating, ensure that the date and time are correct.

Now that the date and time have been confirmed correct, navigate back to the Lumberjack list and click ‘Apps’ at the bottom.

In the ‘Apps’ dropdown window, locate the ‘Installed Apps’ list.

If the driver ‘single-well-tflow’ is installed, this step next can be skipped. 

Navigate to the ‘Available Apps’ list and type into the search bar ‘single-well-tflow’ or simply ‘tflow’ to locate the application. 

Locate the drive file ‘single-well-tflow’ and click the green down arrow on the right to download.

A browser pop up window may appear asking to install the driver. Click the ‘OK’ button to download and install.

An OnPing notification will appear stating that the install is successfully queued. 

Once the driver has been installed, another OnPing notification will appear stating that the package set has been successfully updated.

Now that the packset is updated, the ‘Installed Apps’ list should refresh automatically and display the ‘single-well-tflow’ driver.

Step 6: Locate Lumberjack IP Address #

The Lumberjack IP Address is usually found on the site of the enclosure but if it is not accessible, here is a way to find the IP:

In the OnPing toolbar, select this bookmark icon to display a dropdown menu with additional actions. Under ‘Parameters’, select ‘Control Parameters’. 

On the Control Parameters window, the IP Address is shown just to the right of the Serial number for the Lumberjack:

In this example, the Lumberjack in use is ‘6’ and the IP Address is ‘10.7.5.11’.

Highlight and Copy the IP Address for use in the next step.

Step 7: Create and Assign a New Location #

Navigate to the ‘Admin Links’ panel on the dashboard. If the ‘Admin Links’ panel does not appear on the dashboard, contact the administrator or OnPing support for additional information.

On the ‘Admin Link’s panel, locate and click the link titled ‘Add a totalflow’ from the list.

On the ‘Admin Link’s panel, locate and click the link titled ‘Add a totalflow’ from the list.

Select the Company the totalflow will be assigned to. In this example, the company name is ‘Demo’.

Once the company is selected, select the Site for that company. In this example, the site is named ‘Demo Site (TotalFlow)’.

Create a New Location for the TotalFlow Device. Navigate to the top left corder of the TotalFlow Locations window and click the blue ‘+ New Location’ button to add a new location.

A new window containing information about the new location will appear prompting for a name and URL.

In this example, the location name is ‘Video Demo (TotalFlow)’.

Type the URL from Step 2 into the text bar below ‘TotalFlow Url’. 

In this example, the TotalFlow URL is ‘192.168.4.6’. Note that this URL is local. 

Navigate to the ‘Lumberjack Url’ text bar and type the Lumberjack URL from Step 6. 

In this example, the Lumberjack URL is ‘10.7.5.11’.

In the next column in the TotalFlow Locations window, navigate to the ‘Device ID’ text bar. (This is sometimes referred to as a ‘Station ID’ in the TotalFlow software.)

In this example, the ‘Device ID’ is ‘PLOW TEST’. Type the ‘Device ID’ into the text bar.

Note the Poll Time, Retry Limit, and Response Time. The ‘Poll Time (in seconds)’ is the value of the interval at which the device will capture data. In this example, the device will capture data every 60 seconds. In the event the device fails to communicate, automatic reconnection will execute up to the ‘Retry Limit’, in this case 5 attempts. The ‘Response Time (in seconds)’ is the value of the interval between retry attempts. In this example, the ‘Response Time’ is set to 5 second intervals. In other words, it will attempt to re-establish communication 5 times with 5 seconds in between retry attempts.

In the next column, select the Company from the dropdown menu that will be assigned to this new location. In this example, the company ‘Demo’ is selected.

Now that the company is selected, select the Site. In this example, the site ‘Demo Site 4 (TotalFlow)’ is selected.

Lastly, select the group with the lowest permissions granted to have access to this new location. In this example, the group ‘demoUsers’ is selected and has read-only permissions. 

Note: all groups above this group will have additional permissions.

Navigate to the green ‘Add’ button at the bottom of the column to add save the new location.

A notification in OnPing will appear stating the ‘Location saved successfully’.

Step 8: Create a New Panel and add a Totalflow Widget #

Navigate to the OnPing Dashboard and click the ‘OnPing’ logo at the top left corner of the browser window.

Navigate to the right side of the browser window and click the gray ‘Edit Dashboard’ button on the OnPing toolbar.

Navigate back to the left side of the browser window to add a new panel to place the new Totalflow Widget. Click the first panel in the column labeled ‘+ Add Panel’.

A window will appear prompting about more information for the new panel. Title the panel by typing into the text bar below ‘Title’. In this example, the title of the new panel is ‘Total Flow’. Select an appropriate icon for this panel. In this example, the ‘cog’ icon is selected.

An OnPing notification will appear stating that the ‘Dashboard has been saved’.

Notice on the dashboard, there is the new panel at the bottom labeled ‘Total Flow’.

Navigate to the newly created ‘Total Flow’ panel and click the blue ‘+ Widget’ button at the top right corner of the panel window.

Locate the ‘Controllers’ list from the available widgets. Click the blue ‘Add’ button to the right of ‘Total Flow’ to add the widget to the panel.

Select the company the widget will be assigned to. In this example company ‘Demo’ is selected.

Select the Site for the Company. In this example, the site selected is ‘Demo Site 4 (TotalFlow)’.

Select the Location. In this example the location selected is ‘Video Demo (TotalFlow)’.

Add Registers. First create a new register for time. Click the gray ‘+New Register’ button under the ‘Edit Register’ button.

A dropdown window will appear below requesting more information about the new register. In this example the ‘Application ID’ is ‘0’ the ‘Array ID’ is ‘9’.

Change the ‘Data Type’ to ‘Word32’.

Click the green ‘Add New Register’ button at the bottom of the new register additional information window to save the register.

Change the ‘Register ID’ from ‘1’ to ‘0’

Add a description for the new register. In this example the description is ‘Time in Seconds (Epoch)’

Now that the new register has been configured, click the green ‘Update’ button at the bottom of the ‘New Register’ window. 

An OnPing notification will appear stating that the ‘TotalFlow location updated successfully’

On the top right corner, click the ‘refresh’ icon. This will perform a ‘demand pull’ and force a data capture and update the values for the new register. 

Notice the value has updated to ‘1673602123.000000’

Once data capture has been manually confirmed, click the blue ‘Save’ button at the top right of the New Widget window. 

An OnPing notification will appear stating that the ‘Dashboard has been saved’

Now that the widget has been saved, click the gray ‘Exit Edit Dashboard’ button.

This completes this step-by-step guide on Adding a Totalflow Device in OnPing. The data from the Totalflow Device can now be represented on the HMI.