Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Driver Manual
(Supplement to the FieldServer Instruction Manual)
APPLICABILITY & EFFECTIVITY Effective for all systems manufactured after December 2009
1.03 1
Table of Contents
TABLE OF CONTENTS
1 2 3 4 5 EST QuickStart Description ....................................................................................................................... 3 Driver Scope of Supply ............................................................................................................................. 3 2.1 Supplied by FieldServer Technologies for this driver ........................................................................................ 3 Hardware Connections ............................................................................................................................. 4 3.1 Hardware Connection Tips / Hints ..................................................................................................................... 5 Data Array Parameters ............................................................................................................................. 6 Configuring the FieldServer as an EST QuickStart Client ............................................................................. 7 5.1 Client Side Connection Parameters .................................................................................................................... 7 5.2 Client Side Node Parameters .............................................................................................................................. 7 5.3 Client Side Map DescriptorParameters .............................................................................................................. 8 5.3.1 FieldServer Related Map Descriptor Parameters ...................................................................................... 8 5.3.2 Driver Related Map Descriptor Parameters............................................................................................... 8 5.4 Map Descriptor Example..................................................................................................................................... 9
Appendix A. Useful Features ........................................................................................................................... 10 Appendix A.1. FieldServer Synchronization ................................................................................................................. 10 Appendix A.2. Clear All Data Arrays - Map Descriptor Example. ................................................................................ 11 Appendix B. Reference ................................................................................................................................... 12 Appendix B.1. Device States .......................................................................................................................................... 12 Appendix B.2. Data Array Memory Allocation by Card ............................................................................................... 12 Appendix B.3. Device Addressing.................................................................................................................................. 14 Appendix B.4. Message Types Supported .................................................................................................................... 14 Appendix B.5. Error Messages ...................................................................................................................................... 16 Appendix B.6. Driver Statistics ...................................................................................................................................... 16
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
Page 3 of 16
The EST QuickStart Serial driver allows the FieldServer to record data from Edwards Systems Technology QS1-2/4-8 and QSC Fire Panels over the RS-232 printer port. The FieldServer acts as a Passive Client receiving messages and recording the status of Fire Alarm System points connected to the EST QuickStart fire alarm control panel in bit oriented Data Arrays. The EST QuickStart panels do not support duplexed communications; therefore this driver has not been designed to respond or to generate polls. The Driver is limited by the information that the EST QuickStart control panels broadcasts in the form of text messages through its RS-232 printer port. The types of EST messages supported by this driver are listed in Appendix B.1. Device status to Data Array mapping is also provided. Since there are a variety of optional cards that can be selected for each EST QuickStart installation, each FieldServer application must be specifically configured before use. FieldServer data storage arrays for panel status will be allocated according to the number and type of cards implemented. Message information will also be stored according to card and panel addressing. This driver is connection oriented; therefore, only one EST Panel may be connected to any single RS-232 FieldServer port. The driver currently accommodates European and American Conventional/Intelligent panels using the American English protocol with provisions for using the British English protocol at a later date.
2 2.1
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
Page 4 of 16
HARDWARE CONNECTIONS
The FieldServer is connected to the EST QuickStart power supply card as shown below. Configure the EST QuickStart panel according to manufacturers instructions.
QUICKSTART PANEL
FS-Rx/+
Tx FS-
/-
FS-COM
RJ45-01 BROWN
RJ45-04 BLUE/WHITE
RJ45-08 ORANGE/WHITE
P1
P2
P3
P4
P5
P6
P7
P8
R1 RS485
R2
N1
N2
RS232
10 Base T ETHERNET
(408)-262-2299
Com
Rx Tx
Rx Tx
Rx Tx
Rx Tx
Rx Tx
Tx Rx Con
Tx Rx Con
Pwr
Sys
Act
P1
P2
P3 Rx Tx
P4 Rx Tx
P5 Rx Tx
P6 Rx Tx
P7 Rx Tx
P8
R1
R2
Net 1
Net 2
Run
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
Page 5 of 16
3.1
The QuickStart panels must be pre-configured using their own proprietary configuration tool to send messages to the RS-232 printer port. Ensure that this is done before attempting to connect to the FieldServer and verify that messages are being sent using an appropriate utility e.g. Hyperterminal.
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
Page 6 of 16
Data Arrays are protocol neutral data buffers for storage of data to be passed between protocols. It is necessary to declare the data format of each of the Data Arrays to facilitate correct storage of the relevant data. Section Title Data_Arrays Column Title Data_Array_Name
Function Provide name for Data Array Provide data format. Each Data Array can only take on one format. Number of Data Objects. Must be larger than the data storage area required by the Map Descriptors for the data being placed in this array.
Data_Array_Format
Data_Array_Length
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
Page 7 of 16
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 EST QuickStart Server. It is possible to connect the Edward QuickStart panel to any RS-232 or RS-485 (with adapter) port on a FieldServer. These ports need to be configured for Protocol="qstart" in the configuration files.
5.1
Section Title Connections Column Title Port Protocol Baud* Parity* Data_Bits* Stop_Bits* Handshaking* Ic_timeout Example //
Function Specify which port the device is connected to the FieldServer Specify protocol used Specify baud rate Specify parity Specify data bits Specify stop bits Specify hardware handshaking Specify intercharacter timeout
Legal Values 1 P1-P8, R1-R2 qstart 9600 (vendor limitation) None (vendor limitation) 8 (vendor limitation) 1 (vendor limitation) None (vendor limitation) 2.0s
, Baud , 9600
, Parity , None
, Ic_Timeout , 2.0s
5.2
Function Provide name for node Address of physical Server node Specify protocol used Specify which port the device is connected to the FieldServer
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
FS-8700-93 EST Quickstart Driver Manual Example // Client Side Nodes Nodes Node_Name Node_A
Page 8 of 16
, Node_ID ,1
, Protocol , qstart
, Connection , P1
5.3
5.3.1
Section Title Map Descriptors Column Title Map_Descriptor_Name Data_Array_Name Data_Array_Offset Function
Function Name of this Map Descriptor Name of Data Array where data is to be stored in the FieldServer Starting location in Data Array Function of Client Map Descriptor
Legal Values Up to 32 alphanumeric characters One of the Data Array names from Section 4 0 to maximum specified in Section 4 Passive
5.3.2
Section Title Map Descriptors Column Title Node_Name Msg_Type Panel* Card* Length* Address*
Function Name of Node to fetch data from Identifies the message type of the Map Descriptor. Id of QuickStart panel Id of Card Length of Map Descriptor Starting address of read block
Legal Values One of the Node names specified in Section 5.2. Trouble, Other 0-22, 0 0-9, 0 Permissible range of addresses based on Data Array size 0 for passive Clients
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
Page 9 of 16
5.4
All messages will be recorded into the Data Arrays designated to this port as described in Section 4. The Message Type, Panel, Card, and Address fields are used to match the appropriate Map Descriptor for updating data. // Client Side Map Descriptors Map Descriptors Map_Descriptor_Name SLV_PSEUDO SLV_PSEUDO_TR SLV_ZONE SLV_ZONE_TR SLV_AND_GRP SLV_AND_GRP_TR SLV_MTRX_GRP SLV_MTRX_GRP_TR SLV_SVC_GRP SLV_SVC_GRP_TR SLV_TIME_CTRL SLV_TIME_CTRL_TR SLV_OP_GRP SLV_OP_GRP_TR SLV_CPU_RSRV SLV_CPU_RSRV_TR The driver internally calculates the correct offset for each message type. Refer to Section Appendix B.2.
, Data_Array_Name , DA_PSEUDO , DA_PSEUDO_TR , DA_ZONE , DA_ZONE_TR , DA_AND_GRP , DA_AND_GRP_TR , DA_MTRX_GRP , DA_MTRX_GRP_TR , DA_SVC_GRP , DA_SVC_GRP_TR , DA_TIME_CTRL , DA_TIME_CTRL_TR , DA_OP_GRP , DA_OP_GRP_TR , DA_CPU_RSRV DA_CPU_RSRV_TR
, Data_Array_Offset ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0
, Function , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive , Passive
, Node_name , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A , Node_A
, Msg_type , Other , Trouble , Other , Trouble , Other , Trouble , Other , Trouble , Other , Trouble , Other , Trouble , Other , Trouble , Other , Trouble
, Panel ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,1 ,1
, Card ,0 ,0 , 17 , 17 , 18 , 18 , 19 , 19 , 20 , 20 , 21 , 21 , 22 , 22 ,0 ,0
, Address ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0 ,0
, Length , 50 , 50 , 500 , 500 , 100 , 100 , 100 , 100 , 200 , 200 , 50 , 50 , 500 , 500 , 50 , 50
There can only be one node per port. This field indirectly links the FieldServer port to a data storage array. Refer to Section 5.2
For this driver, address should always be zero. It defines the lowest possible expected address value.
Acceptable ranges for address are determined by the card type. Each card has an expected maximum address which this field defines.
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
Page 10 of 16
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
Page 11 of 16
, Data_Format , Bit
, Data_Array_Length , 16
Map_Descriptor_Name CLEAR_CHK
, Data_Array_Name , CLEAR_FLAG
, Data_Array_Offset ,0 ,
, Function , Wrbx
, Node_Name , Node_A
, Panel ,0
, Card ,0
, Address ,0
, Length , 16
This array needs to be declared in order to manually reset all Data Arrays
QuickStart is a passive Client and neither reads or writes to another device. WRBX monitors the identified Data Array for changes, and invokes the clear function when this occurs.
Use these default panel id, card id, and device address as dummy values
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
Page 12 of 16
Appendix B. Reference
TBL OPEN RST TBL SHRT RST LCL TRBL RST DTY HEAD RST COMM FLT RST GND FLT RST INTR TRBL RS BAD TYPE RST BAD PRSTY RS UNEC DEV RST TROUBLE RST TEST RST DEV COMP RST SERVICE G RS DISABLED RST DISSOUND RST
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
Page 13 of 16
Troubles are recorded in a separate array of UINT16 or Packed_Bit elements. Each element represents a uniquely addressable point, and each bit within the element represents a different type of trouble condition which is described by the specific trouble message. The following table lists the BIT and UINT16/Packed_Bit Data Array sizes that should be configured for every panel by default, and arrays for each optionally installed card. The Data Arrays configured for all QuickStart panels are for cards (real and pseudo) which always have fixed card addresses. Not all of these default Data Arrays will be utilized for every installation. Optionally installed cards can have variable card id #'s depending on the sequence the cards are installed. Data Arrays are referenced relatively according to their declared size. Therefore, care must be taken to ensure that the array sizes are configured as below. Card/Array Descriptions Pseudo points Pseudo point troubles Zones Zone troubles AND group AND group troubles Matrix group Matrix group troubles Service group Service group troubles Time control Time control troubles Output group Output group troubles CPU reserved CPU reserved troubles Power card Power card troubles Optional Cards ADC (dual loop) ADC (dual loop) troubles SLIC SLIC troubles Class A card Class A card troubles Class B card Class B card troubles Relay card Relay card troubles Annunciator (per card) Annunciator troubles (per card) Dialer Dialer troubles Array Size 200 50 2000 500 400 100 400 100 800 200 200 50 2000 500 200 50 200 50 2000 500 2000 500 200 50 200 50 200 50 200 50 200 50 Data Type BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit BIT UINT16/Packed_Bit
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
Page 14 of 16
Point Addressing
A A A A A
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-93 EST Quickstart Driver Manual Event Description Text Strings SUPERVISORY SUP RST TAMPER TAMPER RST SECURITY SECURITY RST FIREPHONE PHONE RST MONITOR MONITOR RST LATCH SUPV LAT SUPV RST LATCH TAMPER LAT TAMP RST UNKNOWN UNKNOWN RST ALARM VERIFY ALM VFY RST PREALARM PREALARM RST TROUBLE OPEN TBL OPEN RST TROUBLE SHRT TBL SHRT RST LCL TROUBLE LCL TRBL RST MAINT ALERT MAT ALERT RS DIRTY HEAD DTY HEAD RST COMMN FAULT COMM FLT RST GROUND FAULT GND FLT RST INTERNAL TBL INTR TRBL RS BAD TYPE BAD TYPE RST BAD PRSONATY BAD PRSTY RS UNEPECT DEV UNEC DEV RST TROUBLE TROUBLE RST RELAY CONFIR RLY CFRM RST LCL MONITOR LCL MNTR RST SWITCH SWITCH RST TEST TEST RST DEV COMPATBL DEV COMP RST AND GROUP AND GRP RST MATRIX GROUP MATRIX G RST SERVICE GRP SERVICE G RS TIME CONTROL TIME CNTL RS ACK ACK RST DISABLED DISABLED RST DISAB SOUND DISSOUND RST OBJECT RUN OBJETRUN RST ZONE ALARM ZONE ALM RST ZONE SUPER ZONE SUP RST ZONE MONITOR ZONE MON RST OUTPUT GROUP OUTPUT G RST AUDIBLE AUDIBLE RST VISUAL VISUAL RST SUPER OUTPUT SUPER OUT RT NONSUPER OUT NONSUP OUT R COMM ALM OUT COMMALOUTRST LED OUTPUT LEDOUTPU RST State S S O M M S S O M M T T T M T T T T T T T T M M M T T A A T M M T T M A S M M M M M M M M Comments
Page 15 of 16
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
Page 16 of 16
Check that a valid Map Descriptor exists in the configuration files for message. Call Technical Support
Writes are not possible; avoid writes from SCADA system or from Ruinet.
Message ignored
Protocol
Modify the configuration CSV file, transfer the modified file to the FieldServer and reset the FieldServer for the modifications 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