Reference Manual
×
Menu

Tank Transactions

 
Use the settings in this group to configure the settings for a Tank. It's possible to enable creating transactions automatically, by monitoring changes in the tank's volume, or manually, via a control parameter, or to disable all transactions and just calculate volume from the fluid level.
 
Tank Transactions - Configuration Parameters
Tank Transactions
 
 
1

Enable Tank

1. Enable Tank
Use this setting to enable the tank. When a tank is disabled all data will be cleared and no registers will be read, although status registers will still be written.
2

Tank Dimensions

2. Tank Dimensions
Use this setting to choose a Tank Geometry group that describes the tank. This sets the dimensions for this tank.
3

Tank Level Register

3. Tank Level Register
Enter the Modbus register that holds the fluid level in the tank as a floating point value here. The next register will also be read. The fluid level must be in the same units as the dimensions in the Tank Geometry group.
4

Volume Units

4. Volume Units
Select the units for volume here. Any status parameter or diagnostic log entry that refers to volume will be in the units that are configured here.
5

Contract Hour

5. Contract Hour
The Tank Volume application tracks the total daily increase and total daily decrease for the volume of fluid in the tank. The increase or decrease can be found in the Volume Increase and Volume Decrease status parameters. Use the Contract Hour setting to choose the hour at which these values roll over daily. To roll over at midnight, select 0 for the Contract Hour.
6

Enable Manual Transactions

6. Enable Manual Transactions
Select this setting to enable tank transactions manually using tank's associated Stop Start Trans control parameter. If this setting is not selected then the control parameter will be ignored and cannot be used to start or stop a transaction.
 
If this setting is selected, and automatic transactions are also enabled, then it is possible to start a transaction automatically but end it manually. The Start Stop Trans control parameter will be set to the start value even when a transaction is started automatically, due to change in tank volume. It's also possible for a transaction to be started manually but stopped automatically, so take care when setting the Load Complete Threshold and the Unload Complete Thresholds, so that transactions are not stopped automatically by mistake.
 
When transaction is started manually, the Current Trans status parameter will indicate a manual transaction type, because it could be a load or unload transaction. When the Current Trans status values are moved to the Last Trans status values, at the end of the transaction, the Current Trans status parameter will be updated to show a load or unload transaction, depending on whether the volume in the tank increased or decreased.
7

Load Transactions

7. Load Transactions
Use settings in this group to configure the Tank Volume application to automatically determine when a load transaction has started or stopped. A load transaction results in an increase in fluid in the tank.
 
Use the Enable Load Transactions setting to allow a transaction to be started automatically when the volume of fluid in the tank increases. When this setting is not selected load transactions will not be started automatically.
 
Use the Load Start Threshold value to configure when to start a transaction. When the average volume of fluid in the tank over the last minute increases by more than the value of the Load Start Threshold, a new load transaction will be started.
 
Use the Load Complete Threshold to determine when a transaction is complete. When the average volume of fluid in the tank over the last minute increases by less than the value of Load Complete Threshold the transaction will be complete.
 
If the Enable Manual Transactions option is selected then it is possible to manually end a transaction that was started automatically. It's also possible to automatically end an transaction that was started manually.
 
8

Unload Transactions

8. Unload Transactions
Use settings in this group to configure the Tank Volume application to automatically determine when an unload transaction has started or stopped. An unload transaction results in a decrease of fluid in the tank.
 
Use the Enable Unload Transactions setting to allow a transaction to be started automatically when the volume of fluid in the tank decreases. When this setting is not selected unload transactions will not be started automatically.
 
Use the Unload Start Threshold value to configure when to start a transaction. When the average volume of fluid in the tank over the last minute decreases by more than the value of the Unload Start Threshold, a new unload transaction will be started.
 
Use the Unload Complete Threshold to determine when a transaction is complete. When the average volume of fluid in the tank over the last minute decreases by less than the value of the Unload Complete Threshold the transaction will be complete.
 
If the Enable Manual Transactions option is selected then it is possible to manually end a transaction that was started automatically. It's also possible to automatically end an transaction that was started manually.
9

Transaction Max Time

9. Transaction Max Time
Any transaction in progress will be completed automatically when the Transaction Max Time expires. This applies to transactions that are started automatically or manually.
10

Transaction Complete

10. Transaction Complete
Use these settings to configure what happens when a transaction is complete. Select the En Transaction Register option to allow the application to set the Transaction Register when a transaction is complete. This can be used to trigger user logic or to trigger the Datalogs application to log a set of registers.
 
This register will not be cleared by the Tank Volume application. It must be cleared in user logic. The Datalogs application will clear the register if the register is used to trigger logging. 
 
The status values in the Last Trans registers will be stable when the coil is set. If logging is desired, log the Last Trans values.