Professional Documents
Culture Documents
8130 RTU Interface Appendix
8130 RTU Interface Appendix
Overview ..............................................................................................................3
General.................................................................................................................4
Installation ...........................................................................................................6
Installing the 8130 RTU Driver ................................................................................................6
Dialog Descriptions.............................................................................................7
Communication Interface Configuration ............................................................................ 8
Communication Port Configuration.................................................................................. 10
RTU Interface Configuration............................................................................................ 13
RTU Device Configuration............................................................................................... 16
I/O Point Connection........................................................................................................ 20
RTU I/O Point Connection ............................................................................................... 23
Communication Interface Maintenance........................................................................... 25
Device Maintenance ........................................................................................................ 28
Communication Monitor................................................................................................... 31
Port Error Statistics.......................................................................................................... 34
Adding A New Interface .........................................................................................................36
Defining a Model 8130 RTU ..................................................................................................38
Making I/O Point Connections................................................................................................39
Editing I/O Point Connections ................................................................................................41
Creating New I/O Point Connections ......................................................................................43
Editing................................................................................................................45
Maintenance and Troubleshooting ..................................................................48
Mode buttons................................................................................................................ 49
Device button ............................................................................................................... 49
Device Maintenance................................................................................................................50
Troubleshooting ......................................................................................................................51
Alarms.....................................................................................................................................52
2 FuelsManager User’s Manual
8130 RTU Interface 3
Overview
The FuelsManager CommunicationsManager (CM) subsystem is responsible for
exchanging data between the DatabaseManager (DM) and external field devices
such as tank gauges and programmable logic controllers. In this application, the
CM uses the Coggins Model 8130 Remote Terminal Unit (RTU).
The configuration of the Model 8130 is accomplished through dialogs available
from the Whessoe Coggins 8130 RTU device driver. Configuration involves adding
an interface, entering data matching the field devices, and creating connections to
the FuelsManager DataManager database.
In this appendix, you learn how to configure, maintain, and edit the Model 8130
interface.
4 FuelsManager User’s Manual
General
The Model 8130 RTU has a variety of interface modules to connect with field
devices. These include discrete I/O, analog I/O, pulse accumulator, and intelligent
communications types. The firmware of the RTU inter-operates with the installed
interface modules to effect data acquisition and control required by the application.
Logical points in the RTU provide storage for configuration data needed by the
firmware to inter-operate with the interfaces and provide storage of input data
acquired from and output data issued to the device through the interface. The RTU
firmware revision defines the complement of points supported and their
functionality. Consult the applicable RTU documentation to become more familiar
with the RTU, available point functionality, and the configuration process.
An RTU configuration program, named ViewRTU, accompanies the 8130 RTU
Device Driver. This program is used to configure the RTU(s) prior to configuring
the RTU 8130 Device Driver. ViewRTU uses disk files to store the RTU
configuration. A file with extension DVR is a Device Version file and defines the
point data structure of the RTU firmware version. DVR files for all supported RTU
Versions are supplied with the installation. Normally there will be a single RTU
firmware version for the application. A file with extension RCF is an RTU
Configuration File, defines the points that have been created for the RTU, and stores
the data for each point. An RCF must exist for each RTU in the application. With
ViewRTU, the contents of the RCF file may be uploaded from the RTU or
downloaded to the RTU. A file with extension HEX is an image of the RTU
firmware and may be downloaded to the RTU using ViewRTU. Directories for the
RTU files are specified in the file Viewrtu.ini.
The 8130 RTU Device Driver interrogates the RTU to acquire data and sends it to
DataManager. DataManager sends command data to the 8130 RTU Device Driver
that is sent to the RTU. For data acquisition, the Device Driver and the RTU
support a Change-Of-State (COS) and a Scan method. With the COS method, the
RTU signals that new data is available and the driver requests the new data. With
the scan method, the driver periodically requests the data. The method used
depends upon the application. The driver is also capable of downloading the RTU
firmware and the RTU configuration. The driver is also capable of providing
communications for ViewRTU while concurrently communicating for
DataManager.
The 8130 RTU device driver provides configuration and maintenance made
available through a series of dialogs. These dialogs are found in the fmUSER
program under the Communications menu. The fmUSER menu bar is shown below:
8130 RTU Interface 5
The configuration process includes defining the 8130 RTU interface, the RTUs, and
associated devices of RTU. Configuration also includes assigning a
communications port and assigning I/O database points. These configuration
components are described in the Components of Communication section of the
Configuring Communications chapter.
Device Maintenance dialogs can be used to offer information for troubleshooting if
any errors occur. These dialogs can be used in accordance with the Model 8130
troubleshooting methods.
Before you start, make sure that the CommunicationsManager is not in SHUTDOWN
mode. Otherwise, the user will not be able to access the configuration and
maintenance dialogs. Refer to the System Menu section of the fmUSER Program
chapter for instructions on setting the CM mode.
6 FuelsManager User’s Manual
Installation
Installing the 8130 RTU Driver
To install the 8130 RTU driver
1. Insert Disk 1 into your floppy drive or CD in your CD-ROM drive.
2. Follow one of the two steps listed below:
a. From the Windows NT desktop, click the Start menu and select Run.
Type “a:\setup.exe” if installing from disk. If installing from a CD,
substitute “a” with your CD drive letter.
b. Under Windows Explorer, double-click SETUP.EXE located in your
floppy or CD drive.
3. Follow the on-screen instructions.
4. Once you complete installation, you return to your initial screen.
8130 RTU Interface 7
Dialog Descriptions
8 FuelsManager User’s Manual
If a CM has not been selected, the Communications Manager dialog box appears.
The selected system becomes the default.
• This dialog box allows the selection of a CM system, which is in ACTIVE or
STANDBY mode. CMs that are in SHUTDOWN status are not accessible (see
Startup Options under the System menu to change CM status).
• If the desired system is not displayed in the list, type in “\\” and then the system
name.
used to select a
Communications
Manager
creates a new
used to edit the interface
selected interface
makes deletes an
connections to existing
the interface
FuelsManager
database
This dialog box lists all the existing interfaces found in the FuelsManager system.
The user can configure new interfaces by selecting New, modify existing interfaces
and associated devices by selecting Device and delete interfaces and associated
devices by selecting Delete.
8130 RTU Interface 9
Field Explanations
SYSTEM NAME (DISPLAY ONLY)
This field displays the CommunicationsManager selected in the setup
CommunicationsManager Subsystem.
DEVICE
This button is used to edit the selected interface.
I/O POINTS
This button is used to make connections to the DataManager database.
NEW
This button is used to create a new interface.
DELETE
This button is used to delete an existing interface.
10 FuelsManager User’s Manual
This dialog box allows the user to choose and set up the communications port
associated with the new interface.
Field Explanations
This dialog box is used to set the specifications of the 8130 interface. From
this dialog box, the user is able to access the port configuration dialog, enter
poll data, and configure RTUs.
Field Explanations
SYSTEM NAME (DISPLAY ONLY)
This field displays the name of the selected CommunicationsManager.
DELAYS
In the Between Polls field, the user can type in the time between polls (resting
time before scanning the next device) and the time between poll cycles (resting
time before scanning devices in the next cycle).
PORT (BUTTON)
In the Port frame, the user can add, change, or unassign the port type
associated with the RTU.
CONFIGURED RTUs
The associated RTUs appears in the Configured RTUs list box. Next to each,
RTU Name is the corresponding Address and Configuration file of the RTU.
The Address should correspond to the address of the Model 8130 in the field.
New RTUs can be added by clicking the New RTU button. Highlighted RTUs
can be edited or deleted by clicking the Edit RTU or Delete RTU buttons,
respectively.
The Run VIEWRTU button displays the main VIEWRTU window allowing the
user to view or perform the commands necessary to configure the RTU. For
further information on VIEWRTU, refer to the RTU 8130 User Manual.
8130 RTU Interface 15
16 FuelsManager User’s Manual
From this dialog box, the user can set the individual RTU communication
specifications.
Field Explanations
NOTE: The database file must be created prior to adding a new RTU.
CM system
name, 8130
RTU device
interface name,
scroll list
and Model 8130
name
point listbox
to make a
database
connection to delete a
single I/O
to delete a Point
database
connections This dialog allows the user to assign and edit the I/O connections between the
Model 8130 RTU and the FuelsManager database. This dialog box displays
the configuration of all devices connected to a Model 8130.
Field Explanations
Field Explanations
SYSTEM NAME (DISPLAY ONLY)
The System Name appears in this field from the previous dialog box.
•= Output points are used to transmit data from the database to field
equipment.
NOTE: The validity is always the PntStatus parameter and cannot be changed.
Click to change
the
Communications
Manager
Click to change
run mode status Click to view
of selected the device
interface dialogs of the
selected
interface
This dialog box lists all the interfaces found in your system.
Field Explanations
SYSTEM NAME (DISPLAY ONLY)
The System Name field displays the selected CommunicationsManager.
Interface Status
INTERFACE DESCRIPTION (DISPLAY ONLY)
A list of all communication devices configured in the selected system. The list
is sorted alphabetically by Interface Description.
NOTE: If the CM Run Mode is in STANDBY, all interfaces are forced to STANDBY
regardless of the Interface Run Mode setting displayed in this column.
8130 RTU Interface 27
28 FuelsManager User’s Manual
Device Maintenance
Field Explanations
SYSTEM NAME (DISPLAY ONLY)
The System Name field displays the selected CommunicationsManager.
Commands
RTU NAME (LIST BOX)
The selected RTU appears in the RTU Name list box. The user is able to select
the desired Model 8130 from the scroll list.
Displays
COMMUNICATIONS (BUTTON)
The Communications button displays the Communications Monitor dialog box.
For further information on this dialog box, refer to the Communication Monitor
section.
Communication Monitor
This section shows the communication between the RTU and FuelsManager for the
current database. Depending on your setting in the Device Maintenance dialog box
this screen may display all RTUs or selected RTU.
Field Explanations
Field Explanations
Attempts Description
Polls # of times data was retrieved from device.
Retries # of requests that had to be repeated.
8130 RTU Interface 35
Response Description
Valid Data received from device was good.
Partial Data received was less than the # of characters expected.
Invalid Data received was invalid (e.g. noise in the line).
None No data was received.
Errors Description
Comm Communication failure detected by port.
Framing 1 or more bytes surrounding message are missing.
CRC Checksum at end of message does not agree with message.
RTU Device has returned an error.
36 FuelsManager User’s Manual
NOTE: If Cancel is chosen from any of these dialogs in this procedure, the New
operation is canceled.
This dialog box lists all the available interface types found in the system.
2. Select the Whessoe 8130 RTU type.
3. Click OK, the Port Type dialog box appears.
6. Assign a port to the interface and click OK. Clicking Cancel aborts the edit
without changing any configuration and reset the configuration lock. The RTU
Interface Configuration dialog box appears.
7. Enter the interface specifications. Follow the procedure below to add the
Model 8130 RTU.
NOTE: Model 8130s can also be added to existing interfaces by selecting Devices from
the Communications Interface Configuration dialog box.
38 FuelsManager User’s Manual
a. Select Communications from the fmUSER menu bar and click Configuration.
The Communications Interface Configuration dialog box appears.
b. Select the Interface Description and Type and click Device. The RTU Device
Configuration dialog box appears.
c. Select the RTU and click Edit RTU. The RTU Device Configuration dialog box
appears.
To add an RTU
1. Click New RTU in the RTU Interface Configuration dialog box. The RTU
Device Configuration dialog box appears.
2. Type in the RTU description and set the specifications. Follow the next
section for the remaining procedure.
8130 RTU Interface 39
NOTE: When the I/O Point button is pressed, the interface will be locked as described
in the Lock Status section of the Configuring Communications chapter.
2. Click I/O Points. The I/O Point Connections dialog box appears.
CM system
name, 8130
interface name,
and Model 8130 RTU device
name scroll list
point listbox
to make a database
connection to delete a
single I/O
to delete a database Point
connections
3. Click on a device data type and then click Assign. The Select Database System
dialog box appears if no database has been selected. Otherwise, the Database
Edit dialog box appears.
4. Select a database point and associated variable. Database points and variables
are filtered so that only the variable format and engineering unit type relating
to the selected device I/O point are displayed. Refer to the Configuring the
Database chapter for instruction on maneuvering through a database.
An example of a filtered point is if a tank gauge I/O point was selected. When
Assign is selected, the corresponding database variable must be a floating-point
type with engineering units of level (length).
NOTE: The user is able to define new database points by clicking New in the Database
Edit dialog box. The system only accepts a newly created database point with
the attributes of the selected data point.
40 FuelsManager User’s Manual
NOTE: This operation cannot be canceled, but it can be undone by using the Clear
button.
NOTE: When the I/O Point button is pressed, the interface will be locked as described
in the Lock Status section of the Configuring Communications chapter.
2. Click I/O Points. The I/O Point Connections dialog box appears.
to edit a
single I/O
Point
3. Click Edit. The RTU I/O Point Configuration dialog box appears.
42 FuelsManager User’s Manual
4. Click OK when you have completed all entry selections. You are returned to
the I/O Point Connections dialog box.
8130 RTU Interface 43
NOTE: When the I/O Point button is pressed, the interface will be locked as described
in the Lock Status section of the Configuring Communications chapter.
2. Click I/O Points. The I/O Point Connections dialog box appears.
to create a
new I/O
Point
3. Click New. The RTU I/O Point Configuration dialog box appears.
44 FuelsManager User’s Manual
4. Click OK when you have completed all entry selections. You are returned to
the I/O Point Connections dialog box.
8130 RTU Interface 45
Editing
This section describes how to edit an existing interface, the Model 8130
specifications, the device specifications of the Model 8130, and the I/O point
connections. The procedures are illustrated below.
•= Select Communications from the fmUSER menu bar and click
Configuration.
to edit the
interface and
corresponding
8130 RTU and
devices
to delete
existing
interface
to edit I/O
connections
NOTE: If another user locks the interface, a message will be displayed as described in
the Lock Status section. The Delete operation will not be carried through.
The RTU Interface Configuration dialog box contains all the 8130 RTUs
defined for the selected interface. Refer to page 37 for a description of the
RTU Interface Configuration dialog box.
3. Make the necessary changes and click OK.
To edit an interface
1. Select the appropriate interface in the Communication Interface Configuration
dialog box.
2. Click Device to display the Device Configuration dialog box.
In this dialog box, the user is able to edit interface specifications, the
communication port, and associated 8130 RTUs.
1. Select Communications from the FuelsManager User Interface menu bar and
select Maintenance. The Select CommManager Subsystem dialog box
appears if a CM has not been selected.
Otherwise, the Communication Interface Maintenance dialog box appears.
Once you have chosen a CM system, it becomes the default.
2. Click Select. Once selected, this communications system becomes the default.
The Communication Interface Maintenance dialog box appears.
Displays mode of
the
Communications
Click to change
Manager
the
Communications
Manager
Click to change
run mode status Click to view
of selected the device
interface dialogs of the
selected
interface
8130 RTU Interface 49
NOTE: If the CM Run Mode is in STANDBY, all interfaces are forced to STANDBY
regardless of the Interface Run Mode setting displayed in this column.
3. Select the desired interface from the list in the Communication Interface
Maintenance dialog box. Once an interface is selected, the Mode and Device
buttons become enabled.
4. When maintenance is completed, choose the Done button to return to the
Communication Interface Maintenance dialog box.
Mode buttons
These two buttons allow the interface run mode to be changed. If the CM run mode
is STANDBY, these buttons are disabled. An Interface Run Mode cannot be
changed when the CM is in STANDBY.
When the CM is ACTIVE, and the user selects an interface from the list, these
buttons may be used to change the Interface Run Mode. After confirming the
operation, the interface changes mode, and its new status will be displayed in the
list box. Refer to the Run Mode section in the Configuring Communications
chapter for more information.
Device button
This button displays diagnostic information about the selected device. Refer to the
Device Maintenance section for instructions.
50 FuelsManager User’s Manual
Device Maintenance
The Device Maintenance dialog allows the user to view diagnostic information
about preconfigured devices of the interface.
1. Select the desired interface in the list box from the Communication Interface
Maintenance dialog box.
2. Choose Device to display the Device Maintenance dialog box.
Troubleshooting
In general, Model 8130 communication problems may be checked by using both the
auto-configuration routine (refer to your Model 8130 manual) and FuelsManager.
As mentioned in the above section, the Device Maintenance dialog for an 8130
RTU is helpful in diagnosing a problem. A table listed below can also be used in
this procedure:
Alarms
Alarms related to the Model 8130 and associated devices are first viewed in the
FuelsManager Operate program. These alarms include the following:
•= Device failure alarm
•= Model 8130 Translator failure alarm
•= Tank Alarms
Refer to the Configuring Alarms section in your FuelsManager User Manual for
more information.