FieldServer FS-8700-60 User Manual

Page 1
A Sierra Monitor Company
Driver Manual
(Supplement to the FieldServer Instruction Manual)
ES/RS2000
APPLICABILITY & EFFECTIVITY
Effective for all systems manufactured after May 1, 2001
Page 2
FS-8700-60 Gardner Denver Manual Table of Contents
TABLE OF CONTENTS
1. Gardner Denver Auto Sentry ES/RS2000 Description.......................................1
2. Driver Scope of Supply........................................................................................ 2
1.01 Supplied by FieldServer Technologies for this driver ....................................... 2
1.02 Provided by the Supplier of 3rd Party Equipment.............................................. 2
2.1.1. Required 3rd Party Hardware.........................................................................2
2.1.2. Required 3rd Party Software..........................................................................2
2.1.3. Required 3rd Party Configuration...................................................................2
2.1.4. Optional Items...............................................................................................2
3. Hardware Connections ........................................................................................3
1.03 Hardware Connection Tips / Hints.................................................................... 3
4. Configuring the FieldServer as a Gardner Denver Auto Sentry ES/RS2000
Client..............................................................................................................................4
1.04 Data Arrays/Descriptors ................................................................................... 4
1.05 Client Side Connection Descriptions ................................................................ 5
1.06 Client Side Node Descriptors ...........................................................................6
1.07 Client Side Map Descriptors............................................................................. 6
4.1.1. FieldServer Related Map Descriptor Parameters..........................................6
4.1.2. Driver Related Map Descriptor Parameters................................................... 7
4.1.3. Timing Parameters........................................................................................7
4.1.4. Map Descriptor Example 1 – Polling all available Controller Data.................8
4.1.5. Map Descriptor Example 2 - Polling only specific data items ........................ 9
4.1.6. Map Descriptor Example 3 - Polling all data and isolating specific data items 9
Appendix 1. Advanced Topics.................................................................................10
Appendix 1.1. Can I use only Passive Client mapdescs ? ...................................... 10
Appendix 1.2. Data length of specific polls versus “All” data polls ........................... 10
Appendix 2. Revision History..................................................................................11
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 3
FS-8700-60 Gardner Denver Manual Page 1 of 11
1. Gardner Denver Auto Sentry ES/RS2000 Description
The Gardner Denver Auto Sentry ES/RS2000 driver allows the FieldServer to transfer data from devices over either RS-232 or RS-485 using Gardner Denver Auto Sentry ES/RS2000 protocol. The driver can be configured to communicate with ES Controllers with software versions V2.0X, V2.1X and RS2000 Controllers with software versions V4.0X
The client driver implements the following functionality:
Polls controllers for service and maintenance data.
Polls controllers for operating mode data.
Polls controllers for operating data.
The driver can poll up to 8 units connected to one ES/RS2000 Controller. It always sets the active unit on the ES/RS2000 Controller before polling for data even if consecutive polls are for the same unit. This is done to prevent synchronization problems.
Gardner Denver ES/RS2000 Controllers implements three message types for which the driver can poll. The driver does not validate the message data fields for correct values although it does validate data field lengths For example, shutdown codes reported by V2.1 ES Controllers range from 0 to 27. If a code of 28 is reported, the driver will not flag it as an error since codes have to be interpreted by the operator. However, a message length longer than 2 digits will be reported as an error.
Max Nodes Supported FieldServer Mode Nodes Comments
Client 1
A client node can communicate with up to 8 units
connected to a ES/RS2000 Controller
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 4
FS-8700-60 Gardner Denver Manual Page 2 of 11
2. Driver Scope of Supply
1.01 Supplied by FieldServer Technologies for this driver
FieldServer Technologies PART #
Description
FS-8915-10 UTP cable (7 foot) for RS-232 use FS-8917-03 RJ45 to DB9M connector adapter FS-8700-60 Driver Manual
1.02 Provided by the Supplier of 3rd Party Equipment
2.1.1. Required 3rd Party Hardware
Part # Description
- ES/RS2000 controller
2.1.2. Required 3rd Party Software
None.
2.1.3. Required 3rd Party Configuration
The ES/RS2000 Controller must be set up in the correct mode to support either RS-232 or RS-485 communications to an external monitoring system. Please refer to manufacturer’s setup instructions.
2.1.4. Optional Items PART # Vendor/Manufacturer Description
485LDRC B&B Electronics RS-232/RS-485 converter
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 5
FS-8700-60 Gardner Denver Manual Page 3 of 11
3. Hardware Connections
The FieldServer is connected to the ES/RS2000 Controller as shown in the connection drawing below:
Configure the ES/RS2000 Controller according to manufacturer’s instructions.
1.03 Hardware Connection Tips / Hints
If inter-controller communications are set up for the controller, connect to the RS-232 port only. If inter-controller communications are not used, connect to either the RS­232 or RS-485 port of the Controller.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 6
FS-8700-60 Gardner Denver Manual Page 4 of 11
4. Configuring the FieldServer as a Gardner Denver Auto Sentry ES/RS2000 Client
For a detailed discussion on FieldServer configuration, please refer to the FieldServer Configuration Manual. The information that follows describes how to expand upon the factory defaults provided in the configuration files included with the FieldServer (See “.csv” sample files provided with the FieldServer). This section documents and describes the parameters necessary for configuring the FieldServer to communicate with a Gardner Denver Auto Sentry ES/RS2000 Controller.
1.04 Data Arrays/Descriptors
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In order to enable the FieldServer for Gardner Denver Auto Sentry ES/RS2000 communications, the driver independent FieldServer buffers need to be declared in the “Data Arrays” section, the destination device addresses need to be declared in the “Client Side Nodes” section, and the data required from the servers needs to be mapped in the “Client Side Map Descriptors” section. Details on how to do this can be found below.
Note that in the tables, * indicates an optional parameter, with the bold legal value being the default.
Section Title
Data_Arrays
Column Title Function Legal Values
Data_Array_Name Provide name for Data Array
Provide data format. Each Data
Data_Array_Format
Array can only take on one format.
Up to 15 alphanumeric characters Float, UInt16, Uint32, Byte, Packed_Byte,
Swapped_Byte Number of Data Objects. Must be larger than the data storage
Data_Array_Length
area required by the Map
1-10,000 Descriptors for the data being placed in this array.
Example
// Data Arrays
Data_Arrays Data_Array_Name, Data_Format, Data_Array_Length, DA_Service_Data, Uint32, 38 DA_Oper_Mode, UInt16, 3 DA_Oper_Data, Uint16, 5
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 7
FS-8700-60 Gardner Denver Manual Page 5 of 11
1.05 Client Side Connection Descriptions
Section Title
Connections
Column Title Function Legal Values
Specify which port the device
Port
is connected to the
P1-P8, R1-R21
FieldServer
Protocol Specify protocol used Gardner_Denver
Baud* Specify baud rate 1200, 9600 (match to Controller)
Parity* Specify parity Data_Bits* Specify data bits Stop_Bits* Specify stop bits
Handshaking*
Specify hardware handshaking
None 7 1
None
Poll_Delay* Time between internal polls > = 0.2s Timeout* Time to wait for response > = 0.6s
Example
// Client Side Connections
Connections Port, Protocol
P1,
Gardner_Denv er
1
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction manual for
details of the ports available on specific hardware.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 8
FS-8700-60 Gardner Denver Manual Page 6 of 11
1.06 Client Side Node Descriptors
Section Title
Nodes
Column Title Function Legal Values
Node_Name Provide name for node
Node_ID
Unit number connected to an ES/RS2000 controller
Up to 32 alphanumeric characters
1-8
Protocol Specify protocol used Gardner_Denver
Connection
Node_Type*
Specify which port the device is connected to the FieldServer Sets the protocol to be used for different Controller software versions
P1-P8, R1-R21
ES V2.0X
ES V2.1X
RS2000 V4.0X
Example
// Client Side Nodes
Nodes Node_Name, Node_ID, Protocol, Connection Node_1, 1, Gardner_Denver, P1 Node_2, 2, Gardner_Denver, P1
1.07 Client Side Map Descriptors
4.1.1. FieldServer Related Map Descriptor Parameters Column Title Function Legal Values
Map_Descriptor_Name
Name of this Map Descriptor Name of Data Array
Data_Array_Name
where data is to be stored in the FieldServer
Data_Array_Offset
Function
Starting location in Data Array Function of Client Map Descriptor
Up to 32 alphanumeric characters One of the Data Array names from “Data Array” section above 0 to maximum specified in “Data Array” section above
RDBC, Passive_Client
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 9
FS-8700-60 Gardner Denver Manual Page 7 of 11
4.1.2. Driver Related Map Descriptor Parameters
Column
Title
Node_Name
Name of Node to fetch data from
Gar_cmd Data poll commands
Function Legal Values
One of the node names specified in “Client Node Descriptor” above Service_Data, Operating_Mode, Operating_Data Available with Service_Data: All, Advisories, Shutdown_codes, Hourmeter_shutdown, Hourmeter_total, Hourmeter_loaded, Hourmeter_temp, Hourmeter_tmp_st, Last_maint_A, Last_maint_B, Oilage
Available with Operating_Mode: All, Oper_mode, Seq_number, Oper_state
Gar_data
Data fields in a data poll command response message. Can be used to poll for all or specific data or just isolate specific items in a “All” poll.
Available with Operating_Data: All, System_pressure, Filter_pressure, Discharge_temp, Reservoir_temp, Motor_current
4.1.3. Timing Parameters
Column Title Function
Legal
Values
Rate at which data is polled. Note that the
Scan_Interval
Poll_Delay Connection parameter affects the
0.1s
effective scan interval.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 10
FS-8700-60 Gardner Denver Manual Page 8 of 11
4.1.4. Map Descriptor Example 1 – Polling all available Controller Data
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_Name, Gar_cmd, Gar_data, Scan_Interval GD_MBA1, DA_Service_Data, 0, RDBC, Node_1, Service_Data, All, 1.0s GD_MBA2, DA_Oper_Mode, 0, RDBC, Node_1, Operating_Mode, All, 1.0s GD_MBA3, DA_Oper_Data, 0, RDBC, Node_1, Operating_Data, All, 1.0s
Note the active Read Block Continuous map descriptor function responsible for polling the Controller.
The Gar_cmd field indicates the poll is for Operating Data.
The Gar_data field is set to “All” indicating that all available data is polled for.
Data will be stored as follows:
Offset Description Units
DA_Service_Data
0 Advisories see ES/RS2000 Controller spec 1-20 10x (Shutdown code / Hourmeter reading) pairs see ES/RS2000 Controller spec 21 Current total runtime hourmeter reading Hours 22 Current loaded runtime hourmeter reading Hours 23-28 6x Current temp hourmeters [H1] – [H6] Hours 29-34 6x Stored temp hourmeters [OH1] – [OH6] Hours 35 Last maintenance A Hours 36 Last maintenance B Hours 37 Oilage Unknown, see ES/RS2000 controller spec
Operating mode data
0 Operating mode indication see ES/RS2000 Controller spec 1 Sequence number2 see ES/RS2000 Controller spec 2 Unit operating state3 see ES/RS2000 Controller spec
Operating data
0 System pressure divide by 16 for pressure in psig 1 Filter pressure divide by 16 for pressure in psig 2 Discharge temperature divide by 16 for temperature in degrees F 3 Reservoir temperature divide by 16 for temperature in degrees F
2
ES V2.0X Controllers do not respond with this field
3
ES V2.0X Controllers do not respond with this field
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 11
FS-8700-60 Gardner Denver Manual Page 9 of 11
4 Motor current
4
amps
4.1.5. Map Descriptor Example 2 - Polling only specific data items
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_Name, Gar_cmd, Gar_data, Scan_Interval GD_MBA1, DA_Hourmeter, 0, RDBC, Node_1, Service_Data, Hourmeter_total, 1.0s GD_MBA2, DA_Oper_Mode, 0, RDBC, Node_1, Operating_Mode, Oper_mode, 1.0s GD_MBA3, DA_Motor_Amps, 0, RDBC, Node_1, Operating_Data, Motor_current, 1.0s
Note the active Read Block Continuous map descriptor function responsible for polling the Controller.
The Gar_cmd is set to indicate Operating Data must be polled for.
The Gar_data field is set to “Motor_current” indicating that only this data item will be stored.
4.1.6. Map Descriptor Example 3 - Polling all data and isolating specific data items
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_Name, Gar_cmd, Gar_data, Scan_Interval GD_MBA1, DA_Service_Data, 0, RDBC, Node_1, Service_Data, All, 1.0s GD_MBA2, DA_Oilage, 0, Passive_Client, Node_1, Service_Data, Oilage, ­GD_MBA3, DA_Hourmeter, 0, Passive_Client, Node_1, Service_Data, Hourmeter_total, -
GD_MBA4, DA_Oper_Mode, 0, RDBC, Node_1, Operating_Mode, All, 1.0s GD_MBA5, DA_Oper_State, 0, Passive_Client, Node_1, Operating_Mode, Oper_state, -
GD_MBA6, DA_Oper_Data, 0, RDBC, Node_1, Operating_Data, All, 1.0s GD_MBA7, DA_Disch_Temp, 0, Passive_Client, Node_1, Operating_Data, Discharge_temp, -
Note the use of the passive map descriptor function. This map descriptor does not poll but receives data from the active map descriptor since the Gar_cmd and Node_Name fields match.
Note, the Gar_cmd indicates polling for Operating data.
Note that a specific data item, “Discharge_temp” is isolated here by still using the same Gar_cmd as the active map descriptor.
4
RS2000 V4.0X Controllers set this field to zero
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 12
FS-8700-60 Gardner Denver Manual Page 10 of 11
Appendix 1. Advanced Topics
Appendix 1.1. Can I use only Passive Client mapdescs ?
No. A passive client map descriptor must be used after an active RDBC map descriptor. The driver uses the active map descriptors to poll the Controller and then searches for Passive Client map descriptors with matching Node_Name and Gar_Cmd fields. It then stores the data items as specified by the Gar_data field from the data collected by the preceding active map descriptor.
Appendix 1.2. Data length of specific polls versus “All” data polls
The length of the data packet retrieved from the Controller during a poll is always fixed for each of the three types of data polls. When specifying a specific Gar_data item on a RDBC active map descriptor, the driver still gets all data of Gar_cmd type from the controller in a single poll, but only stores the data item in question.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Page 13
FS-8700-60 Gardner Denver Manual Page 11 of 11
Appendix 2. Revision Histor y
Date Resp Format
Driver Ver.
Doc. Rev.
Comment
9/2/02 JDM 1.00a 1 Applying new template. 4/12/04 DR DR 1.02b 2 Updated 7/12/04 DR DR 1.03a 3 Updated connection diagram
7/16/04 Meg Meg 1.03a 4
8/24/04 Meg Meg 1.03a 5
Redrew connection diagram. Reformatted document. Replaced connection diagram with original created by Deon.
12/29/04 JD 1.03a 6 Releasing
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Loading...