FieldServer FS-8700-64 User Manual

A Sierra Monitor Company

Driver Manual

(Supplement to the FieldServer Instruction Manual)

FS-8700-64 ATMI ACM

APPLICABILITY & EFFECTIVITY

Effective for all systems manufactured after May 1, 2001

FS-8700-64 ATMI ACM Table of Contents

Table of Contents

1. ATMI ACM DESCRIPTION................................................................................................................... 2

2. DRIVER SCOPE OF SUPPLY..............................................................................................................2

2.1 SUPPLIED BY FIELDSERVER FOR THIS DRIVER ................................................................................... 2

2.2 PROVIDED BY USER ......................................................................................................................... 2

3. HARDWARE CONNECTIONS ............................................................................................................. 3

4. CONFIGURING THE FIELDSERVER AS A ATMI ACM CLIENT ....................................................... 4

4.1 DATA ARRAYS ................................................................................................................................. 4

4.2 CLIENT SIDE CONNECTIONS ............................................................................................................. 5

4.3 CLIENT SIDE NODES ........................................................................................................................ 6

4.4 CLIENT SIDE MAP DESCRIPTORS...................................................................................................... 6

4.4.1 FieldServer Specific Map Descriptor Parameters ..................................................................... 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. CONFIGURING THE FIELDSERVER AS A ATMI ACM SERVER ...................................................12

6. DRIVER NOTES .................................................................................................................................12

6.1 DATA POSITION IN THE DATA ARRAYS .............................................................................................12

6.2 DRIVER STATS .............................................................................................................................. 13

6.3 EXPOSING DRIVER STATS ..............................................................................................................13

6.4 DRIVER ERROR MESSAGES............................................................................................................ 15

6.5 TIMEOUTS .....................................................................................................................................17

6.6 DEMAND & LOCK SCAN.................................................................................................................. 17

6.7 MALFUNCTIONS ............................................................................................................................. 17

6.8 GAS VALUES & SCALING................................................................................................................ 18

6.9 ALARMS AND/OR WARNINGS .......................................................................................................... 18

6.10 CURRENT SLOT .............................................................................................................................19

6.11 COMPOSITE VALIDATION SCAN VS NORMAL SLOT SCAN ..................................................................19

7. REVISION CONTROL ........................................................................................................................ 20

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-64 ATMI ACM Page 2 of 22

1. ATMI ACM Description

The ATMI ACM driver allows the FieldServer to transfer data to and from devices over
either RS-232 or RS-485 using ATMI ACM protocol. 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 #

FS-8915-10 UTP cable (7 foot) for RS-232 use
FS-8915-10 UTP cable (7 foot) for Ethernet connection
FS-8917-02 RJ45 to DB9F Connector adapter
FS-8917-01 RJ45 to DB25M connection adapter

SPA59132 RS-485 connection adapter

Driver Manual.

DESCRIPTION

2.2 Provided by user

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-64 ATMI ACM Page 3 of 22

3. Hardware Connections

The FieldServer is connected to the ATMI ACM Panel as shown below.

Configure the ATMI ACM Panel according to manufacturer’s instructions

ATMI ACM PAN EL

COM 2

8917-02

RJ45 CAT 5 Cable

Connect to

RS232 port P1-P8

P1 P7 R1P2 R2

P3 P4 P5 P6 P8 N1 N2

Tx Rx Tx

P4P1RxP2 P3

TxRx Rx

RS232

Tx Rx Tx TxRx R x

P7P5 P6

P8 R1

Tx Rx Tx Rx Tx

R2 Net 1

TxRx RxTx Con

RS485

Net 2

Tx Rx Con

FieldServer

8917-02 WIRE LIST

FIELDSERVER
FUNCTION FROM TO COLOR

RX RJ45-01 DB9F -03 WHITE
GND RJ45-04 DB9F-05 GREEN
TX RJ45-08 DB9F-02 BLUE

Sys

Com

10 Base T

ETHERNET

Act

Run

Pwr

ATMI - ACM

CONNECTION DIAGRAM

BASE NAME:
FILE NAME: FS-T28700-64 .VSD

DATE: 1/21/02
BY: MN

(408)-262-2299

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-64 ATMI ACM Page 4 of 22

4. Configuring the FieldServer as a ATMI ACM Client

The ATMI ACM driver is a passive client driver. This means that it processes unsolicited
incoming data. It cannot poll for data.

For a detailed discussion on FieldServer configuration, please refer to the instruction manual for
the FieldServer. The information that follows describes how to expand upon the factory defaults
provided in the configuration files included with the FieldServer (See “.csv” files on the driver
diskette).

This section documents and describes the parameters necessary for configuring the FieldServer
to communicate with a ATMI ACM Server.

The configuration file tells the FieldServer about its interfaces, and the routing of data required.
In order to enable the FieldServer 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 parameter, with the bold legal value being the
default.

4.1 Data Arrays

Section Title

Data_Arrays

Column Title Function Legal Values

Data_Array_Name Provide name for Data Array Up to 15 alphanumeric

characters

Data_Format Provide data format. Each data

array can only take on one format.

Data_Array_Length Number of Data Objects. Must be

larger than the data storage area
required for the data being placed
in this array.

Data from one ACM can be stored
in multiple data arrays. Position in
the array is dependent on gas
number area number. Further
details are provided in section 6.1

FLOAT, BIT, UInt16, SInt16,
Packed_Bit, Byte, INT32
Packed_Byte, Swapped_Byte

Gas values should only be
stored in INT32 or FLOAT
arrays.
1-10,000

Ensure that the arrays are 16 *
81 elements big.

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-64 ATMI ACM Page 5 of 22

Example

// Data Arrays
//
Data_Arrays
Data_Array_Name, Data_Format, Data_Array_Length
DA_AI_01, UInt16, 200
DA_AO_01, UInt16, 200
DA_DI_01, Bit, 200
DA_DO_01, Bit, 200

4.2 Client Side Connections

Section Title

Connections

Column Title Function Legal Values

Port Specify which port the device is

connected to the FieldServer

Baud* Specify baud rate 110 – 115200, standard baud

Parity* Specify parity Even, Odd, None, Mark, Space
Data_Bits* Specify data bits 7, 8

Stop_Bits* Specify stop bits

Protocol Specify protocol used ATMI

Handshaking* Specify hardware handshaking RTS, RTS/CTS, None
Poll Delay* Time between internal polls 0-32000 seconds

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.

IC_Timeout This parameter is used in a way

that is different to most
FieldServer driver applications.
In this case of this driver it
specifies the maximum amount
of time that may pass between
the driver receiving an incoming
character. If the time is
exceeded then an error is
produced but note that the error
has no other effect on the driver.
The port is not cleared and gas
data is not reset.

P1-P8, R1-R2

rates only

1

default 1 second

This value should provide a
margin over the time configured
between samples in the
CONFIG.DAT profile of the
ACM unit.

This value (specified in
seconds) should be set allow a
margin between time stamp
messages from the ACM unit.

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-64 ATMI ACM Page 6 of 22

Example

The following FieldServer settings are suitable for default ACM settings.

// Client Side Connections

Connections
Port, Baud, Parity, Protocol, Handshaking, Poll_Delay
P8, 9600, None, ATMI , None, 0.100s

4.3 Client Side Nodes

Section Title

Nodes

Column Title Function Legal Values

Node_Name Provide name for node Up to 32 alphanumeric

characters

Node_ID ACM units 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

Example

// Client Side Nodes

Nodes
Node_Name, Protocol, Port
ACM-1 , ATMI , P8

P1-P8, R1-R2

4.4 Client Side Map Descriptors

4.4.1 FieldServer Specific Map Descriptor Parameters

Column Title Function Legal Values

Map_Descriptor_Name Name of this Map Descriptor Up to 32 alphanumeric

characters

Data_Array_Name Name of Data Array where

data is to be stored in the

FieldServer
Data_Array_Location Starting location in Data

Array
Function Function of Client Map

Descriptor

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

One of the Data Array
names from “Data Array”
section above
0 to maximum specified in
“Data Array” section above
PASSIVE