background image

FS-8700-64 

ATMI 

ACM 

       Page 

of 

22 

 

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

: [email protected]

 

4.4.4  Map Descriptor Example 1- Gas Values, Alarms & Warnings for all slots/ports. 

This example illustrates the map descriptors required to complete store ACM data for 80 areas. Each map descriptor tells the ATMI ACM driver 
where to store each component of ACM data. The gas number & area number determine the position in the array. Read section 6.1 for more 
information 

 

Map_blocks 
Map_block_Name, Data_Array_Name, Data_Array_Offset, Function, node_name, Address, Length, protocol, atmi_data 
MAP1                  , DATA1_1              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  port-values 
MAP2                  , DATA1_2              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  port-alarm 
MAP3                  , DATA1_3              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  port-warning 
MAP4                  , DATA1_4              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  slot-alarm 
MAP5                  , DATA1_5              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  slot-warning

 

MAP6                  , DATA1_6              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  slot-combo 
MAP7                  , DATA1_7              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  port-combo

 

MAP8                  , DATA1_8              , 0                             , passive   , ACM1       , 0,       1280       , ATMI    ,  slot-values

 

A different array is 
used for each 

atmi_data

 

component being 
stored. 
 
The gas value array 
would typically be 
an array of FLOATs 
and the alarms and 
warnings could be 
any data type 
including bit arrays

 

This is a passive 
client driver so the 
function must be 
passive. 

 

 

This node name will 
connect this map 
descriptor to a node 
which in turn  is 
connected to a port. 
Hence the map 
descriptor is 
connected to a port.

These keywords tell the driver which component of the 
ACM data should be 

Stored using each map descriptor. 
 
If you were only interested in the current value then 
you would only use one map descriptor and set the 

atmi_data

 parameter equal to 

gas-value 

 
The “…-combo” types store a 1 for an alarm OR 
warning and a zero when neither conditionis present.

 

 

Summary of Contents for FS-8700-64

Page 1: ...A Sierra Monitor Company APPLICABILITY EFFECTIVITY Effective for all systems manufactured after May 1 2001 Driver Manual Supplement to the FieldServer Instruction Manual FS 8700 64 ATMI ACM ...

Page 2: ...meters 6 4 4 2 Driver Specific Map Descriptor Parameters 7 4 4 3 Timing Parameters 7 4 4 4 Map Descriptor Example 1 Gas Values Alarms Warnings for all slots ports 8 4 4 5 Map Descriptor Example2 Gas values for the current most recent port sample 9 4 4 6 Map Descriptor Example3 Storing Malfunction Data 10 4 4 7 Map Descriptor Example4 Gas values for the current most recent slot sample 11 5 CONFIGUR...

Page 3: ...otocol There are eight RS 232 and two RS 485 ports standard on the FieldServer The FieldServer can emulate a passive client A passive client is one that that consumes messages produced by an remote device 2 Driver Scope of Supply 2 1 Supplied by FieldServer for this driver FieldServer Technologies PART DESCRIPTION FS 8915 10 UTP cable 7 foot for RS 232 use FS 8915 10 UTP cable 7 foot for Ethernet ...

Page 4: ...manufacturer s instructions DATE 1 21 02 BY MN 40 8 262 22 99 BASE NAME FILE NAME FS T28700 64 VSD ATMI ACM CONNECTION DIAGRAM P4 P1 Rx P2 P3 Tx Rx Tx Tx Rx Rx P7 P5 P6 Tx Rx Tx Tx Rx Rx P8 R1 Tx Rx Tx Rx Tx R2 Net 1 Tx Rx Rx Tx Con Net 2 Sys Com Tx Rx Con Act Run Pwr RS485 RS232 10 Base T ETHERNET P1 P7 R1 P2 R2 P3 P4 P5 P6 P8 N1 N2 FieldServer RJ45 CAT 5 Cable Connect to RS232 port P1 P8 FIELDSE...

Page 5: ...for ATMI ACM 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 para...

Page 6: ...ecify hardware handshaking RTS RTS CTS None Poll Delay Time between internal polls 0 32000 seconds default 1 second Timeout Specifies the amount of time that may pass between complete data screens If this time expires a timeout error is produced but the processing of data is not affected The port is not cleared and gas data is not reset This value should provide a margin over the time configured b...

Page 7: ...do not have a node ID contained in the serial data This field s not used in the ATMI ACM driver Protocol Specify protocol used ATMI Port Specify which port the device is connected to the FieldServer P1 P8 R1 R2 Example Client Side Nodes Nodes Node_Name Protocol Port ACM 1 ATMI P8 4 4 Client Side Map Descriptors 4 4 1 FieldServer Specific Map Descriptor Parameters Column Title Function Legal Values...

Page 8: ...iptor The length is required to help the driver validate the CSV file Set the length to a multiple of 16 The multiple should be the maximum area number 1 1280 Address Starting address of read block 0 Driver specific keywords The following parameters apply only to the AMI ACM driver ATMI_Data Used to specify which component of the gas data structure to store You will need one map descriptor for eac...

Page 9: ...80 ATMI port warning MAP4 DATA1_4 0 passive ACM1 0 1280 ATMI slot alarm MAP5 DATA1_5 0 passive ACM1 0 1280 ATMI slot warning MAP6 DATA1_6 0 passive ACM1 0 1280 ATMI slot combo MAP7 DATA1_7 0 passive ACM1 0 1280 ATMI port combo MAP8 DATA1_8 0 passive ACM1 0 1280 ATMI slot values A different array is used for each atmi_data component being stored The gas value array would typically be an array of FL...

Page 10: ...CM1 ATMI 120 0s current port DA_PORT DA_PORT_ALA The current port number and up to 16 gas values are stored in this data array The 1st element stored is the port number The next 16 values stored are the gas values multiplied by 100 The location is based on the Gas Number and not the row number If x is the number of the current port port most recently sampled then the data array position correspond...

Page 11: ...s of the array are set to zero When a Malfunction is present the 1st element contains the malfunction s major type the 2nd element contains the minor type and element x x major 10 minor is set to a value of 1 Additional information is provided in section 6 7 Map_blocks Map_block_Name Data_Array_Name Data_Array_Offset Function node_name timeout atmi_data length Malfucntion_MD DA_MALFNS 0 passive AC...

Page 12: ...ACM1 ATMI 120 0s current slot DA_SLOT DA_SLOT_ALA The current slot number and up to 16 gas values are stored in this data array The 1st element stored is the slot number The next 16 values stored are the gas values multiplied by 100 The location is based on the Gas Number and not the row number This keyword tells the driver to use this map descriptor to store the current slot s sample data If x is...

Page 13: ...ith map descriptor example 3 as the following notes do not apply For each component stored the values are stored as a one dimensional array Data storage is zero referenced This means that the first area or first gas is stored in the first location which has an index of zero To find the element of interest use the following formula Port Alarm Warnings Gas Values Data Array locations Port_Index Gas_...

Page 14: ... data then the MSG IGNORED statistic will be incremented by one 6 3 Exposing Driver Stats IN addition to the normal FieldServer statistics this driver can expose some statistics and diagnotic information in a data rray so that it may be read or reset by a remote device A special map descriptor is required The driver recognizes the map descriptor by its name which must be ATMI stats The following e...

Page 15: ...creen identifier was found before whilst processing screen data 7 ATMI_STAT_ERRORLIGHT Equivalent to the error light on the ATMI ZD80 processor 8 ATMI_STAT_START A start of screen identifier has been found 9 ATMI_STAT_LF A new line of screen data has been identified 10 ATMI_STAT_ERRORLIGHT1 FieldServer Tech Support diagnostic The collection function returned an error Row was inconsistent 11 ATMI_S...

Page 16: ...lfunction is not stored 6 4 Driver Error Messages The following error messages should be reported to FieldServer Technologies ATMI 4 Error atmi_chan_init Init with null chan The following errors indicate a driver connection or remote device problem if they occur frequently ATMI 8 Error Discard because area d max d Incoming data has been discarded because the driver could not resolve a valid area n...

Page 17: ...desc s data array s too short The data array defined by the DA_Bit_Name parameter associated with the map descriptor being used to store current port data is too short Increase the length of the data array not the length of the map descriptor to at least 90 Edit the CSV file make the change and then reset the bridge ATMI 11 Err Mapdesc s data array s too short The data array defined by the DA_Byte...

Page 18: ...red then the driver sets all 1st 100 of the malfunction data array elements to zero A malfunction is considered cleared when a normal scan is processed When a malfunction is recognized the driver stores data in the following locations 1st Element Major type of the malfunction as a number 2nd Element Minor type of the malfunction as a number And Element x Value set to 1 X major 10 minor This additi...

Page 19: ...ng The driver stores all gas values after multiplying them by 100 This allows the driver to store values in arrays with formats other than floats without losing the precision provided by the ACM unit This is done because some downstream devices and protocols cannot handle floating point numbers This may not suite you in which case you will need to use scaling These parameter keywords should be add...

Page 20: ...t Slot Current slot information is the same as current port information On a Normal Scan a single slot is referenced The gas values warnings alarms will be stored to the current slot data arrays every time slot information is stored Note this only occurs once during any Normal Slot Scan image 6 11 Composite Validation Scan vs Normal Slot Scan On a Normal Slot Scan Image gas data is stored to the s...

Page 21: ...ously described as client server Section 4 4 2 New keyword Section 4 4 4 Title Changed Section 4 4 5 New example Section 6 1 Amended Section 6 4 Error messages 9 10 11 added 1 01b Rev 0 Section 4 4 2 New keyword Section 4 4 6 New example Section 6 1 Amended Section 6 3 New stats 20 22 Section 6 4 Amended notes for msg 9 Section 6 7 New Section 101c Rev0 Section 4 4 5 Corrections and additional not...

Page 22: ...pdated Table of Contents 9Apr03 1 04aRev 0 DNC Section 4 4 2 Added new key word Current Slot Section 4 4 7 Added Current Slot example Section 6 10 Added section discussing current slot information Section 6 11 Added section discussing Composite Validation Scan handling and Normal Scan Driver Enhancement 1 On normal scan driver will save values warns alarms for up to 4 ports per screen 2 On a decom...

Reviews: