Manual FieldServer Gamewell FCI E3 Series
Manual FieldServer Gamewell FCI E3 Series
Manual FieldServer Gamewell FCI E3 Series
Driver Manual
(Supplement to the FieldServer Instruction Manual)
TABLE OF CONTENTS
1. Gamewell FCI-E3 Series Serial Driver Description...................................................... 3
2. Driver Scope of Supply ................................................................................................. 4
2.1. Supplied by FieldServer Technologies for this driver.................................................. 4
2.2. Provided by the Supplier of 3rd Party Equipment ........................................................ 4
2.2.1. Required 3rd Party Hardware .................................................................................. 4
3. Hardware Connections ................................................................................................. 5
4. Configuring the FieldServer as a Gamewell FCI-E3 Series Serial Driver Client ........ 6
4.1. Data Arrays/Descriptors ............................................................................................. 6
4.2. Client Side Connection Descriptions .......................................................................... 7
4.3. Client Side Node Descriptors ..................................................................................... 8
4.4. Client Side Map Descriptors....................................................................................... 8
4.4.1. FieldServer Related Map Descriptor Parameters .................................................... 8
4.4.2. Driver Related Map Descriptor Parameters............................................................. 9
4.5. Map Descriptor Example 1 – Sensor / Module Events...............................................10
4.6. Map Descriptor Example 2 – Bit Storage ..................................................................11
5. Configuring the FieldServer as a Gamewell FCI-E3 Series Serial Driver Server......12
Appendix A. Advanced Topics..........................................................................................13
Appendix A.1. Events and Event Categories.......................................................................13
Appendix A.2. Extending the Event Table ...........................................................................14
Appendix A.3. How Data is stored.......................................................................................14
Appendix A.4. Panel Synchronization .................................................................................16
Appendix A.5. What happens when the panel sends a Reset Message ..............................16
Appendix A.5.1. Networked Panels..................................................................................16
Appendix B. Driver Error Messages. ................................................................................17
Appendix B.1. Driver Stats Exposed. ..................................................................................19
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
The Gamewell FCI-E3 Series System Control Units are manufactured by Fire Control Instruments. An E3
Panel with an enabled serial port can transmit data to a FieldServer which can, in turn, make the data
available to other devices including those which communicate using different protocols (e.g. BACnet)
This passive Client driver does not poll for data, nor does it send data or commands to the E3. Messages
received from the E3 are analyzed and are then either discarded or used to update the FieldServer’s
internal Data Arrays. The action depends on which types of events, the type of device generating the
event and device address the FieldServer has been configured to process. Once stored in the
FieldServer the data is available to be read or written using other protocols such as BACnet.
No automatic panel data synchronization technique exists. The data in the FieldServer and the panel
status have to be synchronized manually. This typically requires a panel reset.
Since the driver cannot send data or commands to the E3 it cannot be used to acknowledge, silence or
reset alarms and other events.
The driver can process messages from networked panels. The driver connects to the main panel.
Subsidiary panels are configured to send event data to the main panel which then sends messages to the
FieldServer. Node information is sent in the line preceding the event and the driver uses this to
determine the panel at which the event originated and to store data appropriately.
The driver provides both Client and Server emulation. The Server side of the driver is intended to support
FieldServer’s Quality Assurance program and is not intended to provide complete emulation of an E3 and
is thus not fully documented. Should you require the Server side functionality to be documented and
enhanced, please contact FieldServer’s sales group.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
3. Hardware Connections
The FieldServer is connected to the FCI-E3 panel as shown in the connection drawing.
1 2 3 4
TB6
Blue/white
Orange/White
Brown
FieldServer Part #
FS-8917-16
Pigtail for RJ45
Port
8 1
FieldServer P1
Connector Pinouts
RJ-45 FCI-E3
Wire Color
Pin Signal Signal Pin
Brown 1 Rx +ve 2
White/Orange 8 Tx -ve 1
Blue/white 5 GND Signal Common Reference 4
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
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 FCI Series E3.
Example
// Data Arrays
Data_Arrays
Data_Array_Name, Data_Array_Format, Data_Array_Length
DA_AI_01, UInt16, 200
DA_AO_01, UInt16, 200
DA_DI_01, Bit, 200
DA_DO_01, Bit, 200
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Example
Connections
Port, Protocol, Baud, Parity
P1, FCI_E3, 9600, None
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 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Example
Nodes
Node_Name, Protocol, Connection
Panel-01, FCI_E3, P8
2
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 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Example:
F.S.E.C. :[CR][LF]
FIRST ALARM: UP STAIRS N. ENT Manual Station L1M21 00:37:28 01/01/99[CR][LF]
Map_Descriptors
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_Name, Event Type, Point Type, Relay/Loop/Zone Number, Address, Length, Clear_on_Reset
ModuleData1, DA_MODULE, 0, Passive_Client, Panel-01, Alarm, Module, 1, 1, 99, Yes
Unique Map The Data Array The driver The name of Only Alarm The address
Descriptor name and listens the Node Change this to
events will be ‘Sensor’ for specifies the
Names are starting location passively for defined in the stored. starting Module
recommended. that data should messages from Node sensors.
number and the
be stored. the Panel. It Descriptor Length tells the
cannot poll for driver the range
data. of Modules.
In this example:
Module 1 to 99
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
FS-8700-132 Gamewell FCI-E3 Driver Manual Page 11 of 20
Map_Descriptors
Event Point Relay/Loop/Zone
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, DA_Bit_Name, Function, Node_Name, Address, Length, Clear_on_Reset
Type, Type, Number,
RelayData, DA_RELAY, 0, DB_Relay, Passive_Client, Panel-01, Any, Relay, 1, -, 4, Yes
Data_Array_Name is where the DA_Bit_Name is where secondary storage is Map Descriptors for
primary DA is specified. Index defined. Events are stored by setting storing Relay, Loop,
values are stored here appropriate bits. Zone and Panel do not
need the address
Remember that 2 elements per Relay, Module, specified.
Sensor, Loop are used.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
FS-8700-132 Gamewell FCI-E3 Driver Manual Page 12 of 20
The server side of the driver is intended to support FieldServer’s Quality Assurance program and is not
intended to provide complete emulation of an E3 and is thus not fully documented. Should you require
the Server side functionality to be documented and enhanced, please contact FieldServer’s sales group.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
The message category must match the ‘Event Type’ parameter specified on a Map Descriptor before
that Map Descriptor can be considered for storage of the message data.
Index Category Event
1 FCI_EVENT_TYPE_FAULT "Fault"
2 FCI_EVENT_TYPE_OTHER "Short"
3 FCI_EVENT_TYPE_OTHER "Disconnect"3
4 FCI_EVENT_TYPE_OTHER "Comm Fault"
5 FCI_EVENT_TYPE_OTHER "Config Err"
6 FCI_EVENT_TYPE_OTHER "Eeprom Bad"
7 FCI_EVENT_TYPE_OTHER "Reset"
8 FCI_EVENT_TYPE_OTHER "Silence"
9 FCI_EVENT_TYPE_OTHER "Cross Zone"3
10 FCI_EVENT_TYPE_OTHER "Acknwldgd"
11 FCI_EVENT_TYPE_OTHER "Walk Test"
12 FCI_EVENT_TYPE_OTHER "Alarm Test"
13 FCI_EVENT_TYPE_OTHER "SPVSN Test"
14 FCI_EVENT_TYPE_OTHER "Fault Test"
15 FCI_EVENT_TYPE_OTHER "Fire Drill"
16 FCI_EVENT_TYPE_OTHER "Batt Test"
17 FCI_EVENT_TYPE_OTHER "PRGM Mode"
18 FCI_EVENT_TYPE_OTHER "Action"
19 FCI_EVENT_TYPE_OTHER "Loop Break"
20 FCI_EVENT_TYPE_ALARM "Alarm"
21 FCI_EVENT_TYPE_OTHER "P.A.S."
22 FCI_EVENT_TYPE_OTHER "Off-Normal"
23 FCI_EVENT_TYPE_OTHER "RZA Fault"3
24 FCI_EVENT_TYPE_OTHER "Verify"3
25 FCI_EVENT_TYPE_OTHER "CM Short"3
26 FCI_EVENT_TYPE_OTHER "Test Fail"
27 FCI_EVENT_TYPE_OTHER "Alert"
28 FCI_EVENT_TYPE_OTHER "Dirty"
29 FCI_EVENT_TYPE_OTHER "Very Dirty"
30 FCI_EVENT_TYPE_OTHER "Missing"
31 FCI_EVENT_TYPE_OTHER "Wrong Type"
32 FCI_EVENT_TYPE_OTHER "Extra Addr"
33 FCI_EVENT_TYPE_OTHER "Clock Err"3
34 FCI_EVENT_TYPE_TRBLE "Trouble"3
35 FCI_EVENT_TYPE_OTHER "MLT Events"3
36 FCI_EVENT_TYPE_OTHER "Alrm Ackd"
37 FCI_EVENT_TYPE_OTHER "Outpt Fail"
38 FCI_EVENT_TYPE_OTHER "Tally Flt"
39 FCI_EVENT_TYPE_OTHER "AC Flt To"
40 FCI_EVENT_TYPE_OTHER "Trbl Ackd"
41 FCI_EVENT_TYPE_OTHER "Access"
42 FCI_EVENT_TYPE_OTHER "Netwrk Flt"
43 FCI_EVENT_TYPE_OTHER "NetGndFlt"
44 FCI_EVENT_TYPE_OTHER "Dact Fault"
45 FCI_EVENT_TYPE_OTHER "Node Msng"
46 FCI_EVENT_TYPE_OTHER "Node Xtra"
47 FCI_EVENT_TYPE_OTHER "Fans Off"
48 FCI_EVENT_TYPE_OTHER "Xzone Alrm"
3
Not defined in the spec
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Driver_Table
Event_Type_Description, Event_Type_Index_Value, Event_Type_Category , Protocol
TROUBLE, 100, 4, FCI_E3
Since it has been added as category=3, only Map Descriptors with 'Event Type' set to “Alarm” or
“Any” will capture messages with this event description
Driver_Table
Event_Type_Description, Event_Type_Index_Value, Event_Type_Category, Protocol
DESTROYED, 51, 3, FCI_E3
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Example:
The following fragment is part of a Map Descriptor definition; some parameters have been omitted for the purposes of clarity.
Message = “TROUBLE: QZUb L1M22 << Chief's Office >> 5:24:00 3/03/93”
• This message reports status for Loop 1 Module 22. Since all the MD’s in the example have a ‘Point Type’=‘Module’, they are all considered
for storage.
• The driver looks in the Event Table and finds it has an index value of 34 and a category of 4 (Trouble). Only the MD’s with “Event Type” set to
“Any” and “Trouble” are now considered.
• Since the value of the ‘Relay/Loop/Zone’ parameter matches the Loop number in the message, these MD’s remain in contention.
• The Module number of 22 is compared with the MD’s Address and Length Parameters. The Address is the starting number and the length
defines the range. Both Map Descriptors have addresses of 1 and length of 99 and thus both are still selected because the Module of 22 falls
in this range.
• The driver calculates an offset based on the offset specified in the Map Descriptor and the Module number relative to the Map Descriptor
address:
Map Descriptor Offset = 0
Map Descriptor Address = 1
Message Module = 22
Module 1’s data is stored at offset 0 and hence Module 22’s data will be stored at offset 21. The driver stores the value 34 at offset 21
overwriting any data previously stored at that location. This is ‘Index Value’ Storage.
• Secondary storage has been defined using the ‘DA_Bit_Name’ Data Array. The driver doubles the offset as two locations are used for each
address. The driver then reads the value found in the Data_Array, modifies it and writes it back. Since the index value is 34 the driver
th nd
modifies the 34 bit – or expressed another way, the driver modifies the 2 bit (34-32) at offset+1.
nd
• Thus, the driver calculates the offset for Bit Storage as 2 x 21 = 42. The driver sees that bit 34 is 2 2 bit in the next offset and so the driver
reads DB_MODU:43, modifies the value by setting the 2nd bit on and then writing the modified value back. During the modification all other
bits are left intact. Thus using the Bit Storage method, a single Module (or sensor…) can keep track of multiple events.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
FS-8700-132 Gamewell FCI-E3 Driver Manual Page 16 of 20
Appendix A.5. What happens when the panel sends a Reset Message
When a panel sends a reset message the driver processes every single Map Descriptor, looking at
the ‘Clear on Reset’ parameter (See section 4.4.2). If the parameter is set to yes, then the driver sets
all the Data Array elements referenced by the Map Descriptor to zero by looking up the Data Array
Name, the Data Array offset and the length. The driver also clears the relevant sections of a Data
Array specified with the DA_Bit_Name parameter.
The process can take some time. For this reason, it is suggested that you take care not to set the
Map Descriptor length to a value larger than necessary.
Example of message sent by a panel that is networked. The driver is dependent on seeing the
node of event origin included in parenthesis before each event message.
Node02:
MISSING Acclimate L1S041 00:17:06
01/01/06
Local:
FIRST ALARM Photo Detector L1S001 09:24:52
12/01/06
The main panel is identified as ‘Local’. The driver interprets this as Node_ID=0.
To capture events from multiple networked panels a Node Descriptor is required for each panel
with the appropriate Node_ID. Each Node requires a set of Map Descriptors.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Message Description
FCI_E3:#1 FYI. Use a DA called <%s> to expose
Refer to Appendix B.1
diagnostic info., FCI_E3_STATS_DA )
FCI_E3:#2 FYI. Added Event Desc=<%s> Index=%d
Printed for information only. No action
Categ=%d , new_event_desc ,
required if it confirms your expectations.
new_event_desc_index_value , new_event_desc_categ ) ;
FCI_E3:#3 Err. No space. Reject Event Desc=<%s>
4
Index=%d , new_event_desc , There is only space for 60 event types.
new_event_desc_index_value ) ;
FCI_E3:#4 FYI. Duplicate Event Desc=<%s>. , The Event type being added already
new_event_desc ) ; exists. If you are updating the category,
FCI_E3:#5 FYI. Duplicate Event Desc=<%s>. , ignore the message. Otherwise correct the
4
new_event_desc ) ; configuration file.
If the event index is greater than 64 then
FCI_E3:#6 Err. Event Index=%d. Too big to set bit.,
the data cannot be stored as bits - only 64
drv_bd->event_index )
bits are reserved for events.
FCI_E3:#7a Err. DA=%s too short. Rqd=%d, dt- The MD in question has a length and
>buffer_name , offset ); offset which makes it run past the end of
FCI_E3:#7b Err. DA=%s too short. Rqd=%d, possible_md- the Data Array. Message 7b is printed
4
>data->buffer_name , offset ); when data is being stored as bits.
FCI_E3:#8 FYI. Reset was rcvd and processed! Stamped Printed for information only. No action
%s %s , drv_bd->time , drv_bd->date ) required.
A reset was received but the driver could
FCI_E3:#9 Err. Reset was ignored. not reset any data. 'Clear_on_Reset'
possibly set to 'no' on all Map Descriptors?
FCI_E3:#10 FYI. Reset of DA=%s Off=%d Len=%d,
Printed for information only. No action
possible_md->data->buffer_name , possible_md-
required.
>bxi_data_buffer_offset , possible_md->data_length );
FCI_E3:#11 Err. Cant reset DA=%s len=%d rqd=%d,
possible_md->data->buffer_name , The Map Descriptor in question has a
da_get_length_in_items ( (DAH_TYP) possible_md->data ) length and offset which makes it run past
4
, possible_md->data_length+possible_md- the end of the Data Array.
>bxi_data_buffer_offset );
FCI_E3:#12a Err. No MD's to store message data. The Driver could not find a place to store
data from a message received. If the data
FCI_E3:#12b Err. No MD's to store message data." is not required then the message may be
ignored. Otherwise update the
FCI_E3:#13 Err. Msg was ignored. MD Required for 4
configuration file .
Storage.
FCI_E3:#13a Err. Diagnostic 1); Take a log. Try and repeat the event that
FCI_E3:#13b Err. Diagnostic 2); caused the message to be printed. Then
FCI_E3:#13c Err. Diagnostic 3); contact tech support.
FCI_E3:#14 Err. <%s> file not found., md-
>mapdesc_name ) ; If this error is repeated often it is possible
FCI_E3:#15 Err. Event Type=<%s> Not recognized." , that a FCI firmware update has made the
drv_bd->event_desc ) driver unusable. Take a log and contact
FCI_E3:#16 Err. Point Type='%c'(%#x) Not recognized. , tech support.
drv_bd->point_identifier[0] , drv_bd->point_identifier[0] ) ;
4
Correct the configuration file, download to the FieldServer and restart the FieldServer for the changes to
take effect.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Message Description
This message should only be printed if a
byte in a message has been corrupted. If
FCI_E3:#17 Err. Loop=%d < 1. Rejected. , drv_bd->loop )
you notice it more than once then take a
log and contact tech support.
If this error is repeated often it is possible
FCI_E3:#18 Err. Loop Type='%c'(%#x) Not recognized. , that a FCI firmware update has made the
drv_bd->point_identifier[2] , drv_bd->point_identifier[2] ) driver unusable. Take a log and contact
tech support.
This message should only be printed if a
FCI_E3:#19 Err. Relay=%d < 1. Rejected. , drv_bd->relay
byte in a message has been corrupted. If
you notice it more than once then take a
FCI_E3:#20 Err. Zone=%d < 1. Rejected. , drv_bd->zone"
log and contact tech support.
FCI_E3:#21 Err. Point Type not recognized Valid Point Types are listed in section
5
FCI_E3:#22 Err. Undefined Point Type" 4.4.2
FCI_E3:#23 Err. Event Type not recognized Valid Event Types are listed in section
5
FCI_E3:#24 Err. Undefined Event Type 4.4.2
FCI_E3:#25a Err. Address+Length>99. Length Truncated The maximum value for a sensor/module
is 99. The combination of address and
FCI_E3:#25b Err. Address+Length>99. Length Truncated 5
length specified produce a number > 99
FCI_E3:#26 Err. Invalid Module number. Expected 1..99
FCI_E3:#27a Err. Invalid Loop number. Expected 1..10
FCI_E3:#27b Err. Invalid Loop number. Expected 1..10
5
FCI_E3:#27c Err. Invalid Loop number. Expected 1..10 Correct the configuration file
FCI_E3:#28 Err. Invalid Sensor number. Expected 1..99
FCI_E3:#29 Err. Invalid Zone number. Expected 1..255
FCI_E3:#30 Err. Invalid Relay number. Expected 1..255
Valid Point Types are listed in Section
FCI_E3:#31 Err. Point Type Invalid. 5
4.4.2
The length of each Map Descriptor should
FCI_E3:#32 Err. No MD Length. Default to 1 5
be specified. Refer to Section 4.4.2
The driver can only listen passively for
FCI_E3:#33 Err. Driver can’t poll or write. message from the panel. Map Descriptors
5
may not be configured as active.
An event message is less than 80 bytes
long. If this error is repeated often it is
FCI_E3:#36 Err. Too Short. Bytes=%d , conn->ux_iptr" possible that a FCI firmware update has
made the driver unusable. Take a log and
contact tech support.
5
Correct the configuration file, download to the FieldServer and restart the FieldServer for the changes to
take effect.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
Data_Arrays
Data_Array_Name, Data_Format, Data_Array_Length
fci-e3-stats, UINT32, 200
The driver exposes stats based on a port handle. The offset specified in the table below must be
added to the handle number multiplied by 100. i.e. for port whose handle is 1 then the driver will store
st
the 1 stat at 1+100*1=101.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com