FieldServer FS-8700-41 - Manual (Page 39)

FS-8700-41 Simplex 4100 Driver Manual Page 39 of 48
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: [email protected]
Appendix C.3.2. Driver Exposed Stats
The driver is capable of exposing statistics about its behavior in a Data Array. It is necessary to create a Data Array
with name sim4100-stats as per the example below and it will be updated by the driver. Note that the stat
number corresponds to the offset.
Take care not to poke any values into the 1st 10 elements of this Data Array (offsets 0 to 9). Doing so will trigger
internal diagnostics and may interfere with normal operation.
A different set of stats is maintained for each connection. Each connection uses 100 elements of the data array.
Ensure the array length is large enough if the port number is large.
Data_Arrays
Data_Array_Name , Data_Format , Data_Array_Length
sim4100-stats , UINT16 , 1000
At revision 1.07a of the driver and earlier, no stats had been exposed.
Stat # Stats Description
10 SIM4100_STAT_XPOINT_CARD The Card in c-p-s from most recent xpoint store
11 SIM4100_STAT_XPOINT_POINT The Point in c-p-s from most recent xpoint store
12 SIM4100_STAT_XPOINT_SUB The SubPoint in c-p-s from most recent xpoint store
13 SIM4100_STAT_XPOINT_QUALIFIER The Qualifier from most recent xpoint store
14 SIM4100_STAT_XPOINT_QUALIFIER_AS_ENUM
The Qualifier from most recent xpoint store, stored as an
enumeration – See Note1 for bit states
15 SIM4100_STAT_XPOINT_STATE
The reported state from most recent xpoint store. State
value: 0 FALSE/Normal 1 TRUE/Abnormal
16 SIM4100_STAT_XPOINT_ACK_STATE
The reported ack state from most recent xpoint store. Ack
state: *=needs ack, -=acked (always "-" for U or C states)
17 SIM4100_STAT_XPOINT_HOUR The Time from most recent xpoint store
18 SIM4100_STAT_XPOINT_MIN The Time from most recent xpoint store
19 SIM4100_STAT_XPOINT_SEC The Time from most recent xpoint store
20 SIM4100_STAT_XPOINT_DOW The Date from most recent xpoint store
21 SIM4100_STAT_XPOINT_DAY The Date from most recent xpoint store
22 SIM4100_STAT_XPOINT_MONTH The Date from most recent xpoint store
23 SIM4100_STAT_XPOINT_YEAR The Date from most recent xpoint store
24 SIM4100_STAT_XPOINT_COMBO_STATE_OLD
A single point could potentially be active in more than one
state simultaneously. The driver tracks the combine state by
building a UINT whose bits indicate the state. This is the
combo state before the update. See Note 1 for bit states.
25 SIM4100_STAT_XPOINT_COMBO_STATE_NEW
A single point could potentially be active in more than one
state simultaneously. The driver tracks the combine state by
building a UINT whose bits indicate the state. This is the
combo state after the update. See Note 1 for bit states.