FieldServer FS-8700-82 Appendix C. Driver Notes Appendix C.1. Driver Stats, Dacarrierstats

Page 27

FS-8700-82 Carrier DataLink

Page 27 of 31

Appendix C. Driver Notes

Appendix C.1. Driver Stats

The driver reports statistics according to the FieldServer standards. The following notes describe some aspects of standard statistic reporting which are peculiar to this driver.

All errors responses from the Carrier DataLink device are recorded as a PROCOL ERROR,

In addition to the standard FieldServer communication statistics described above and in the FieldServer User’s Manual, this driver can also expose some driver statistics by writing data to a data array. A special Map Descriptor is required. The driver recognizes the Map Descriptor by its name which must be "Carrier-stats”.

The following example shows how this special Map Descriptor can be configured. You can copy this section of text directly into your CSV file.

Nodes

 

 

Node_Name ,

Station ,

Protocol

Carr_stats ,

1 ,

CarrierDL

 

 

 

Data_Arrays

 

 

Data_Array_Name ,

Data_Format,

Data_Array_Length

DA_CARRIER_STATS ,

UINT32 ,

2000

 

 

 

Map_Descriptors

 

 

 

 

 

Map_Descriptor_Name,

Data_Array_Name ,

Data_Array_Offset

Function

Node_Name ,

Length

Carrier-Stats,

DA_CARRIER_STATS

0,

passive,

Carr_stats,

500

When the driver sees this Map Descriptor it uses the data array DA_CARRIER_STATS (in this example) to store driver specific statistics. Only one of these Map Descriptors may be specified per FieldServer.

The driver stores the following data. The location in the data array is obtained by multiplying the port number by 50 and then using the location offset indicated in the table below.

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: support@fieldserver.com

Page 26 Page 28
Image 27
Page 26 Page 28
Contents FS-8700-82 Carrier DataLink Table of Contents FS-8700-82 Carrier DataLink Carrier DataLink DescriptionFieldServer Technologies Provided by Suppler of 3 rd Party EquipmentHardware Connections Column Title Function Legal Values Configuring the FieldServer as a Carrier DataLink ClientData Arrays/Descriptors Section TitleSecond Client Side Connection DescriptionsFS-8700-82 Carrier DataLink Example NoneClient Side Node Descriptors Column Function Legal Values TitleRDBC, WRBC, Wrbx ‘EVERYTHING’ Driver Related Map Descriptor ParametersTiming Parameters TZONE1’Map Descriptor Example 1 Read a Table Map Descriptor Example 3 Write a Variable Map Descriptor Example 2 Read a VariableMap Descriptor Example 4 Write Day of Week DOW or Time Server Side Connection Descriptors Configuring the FieldServer as a Carrier DataLink ServerServer Side Nodes Driver Specific Map Descriptor Parameters Timing Parameters Map Descriptor Example General Driver Limitations and ExclusionsAs a client As a serverEquipment Type Table Name Appendix A. Advanced Topics Appendix A.1. Table NamesFS-8700-82 Carrier DataLink Equipment Type Table Name Dadump DEV 02 Display Appendix A.3.3. Client writes a variable Appendix A.3. Map Descriptor Length ExplainedAppendix A.3.1. Client Reads a Table Appendix A.3.2. Client reads a variableFS-8700-82 Carrier DataLinkPage 24 Appendix A.4.2. Extending the List of Discrete State WordsAppendix A.5. Timing Considerations Appendix A.4.3. Time ValuesAppendix A.4.4. Numeric Values Appendix A.4.5. Occupancy Strings / ValuesAppendix B. Carrier DataLink Device Error Response Message Explanation ActionNack Dacarrierstats Appendix C. Driver Notes Appendix C.1. Driver StatsOffset Description Appendix D. Driver Error Messages Error Message ExplanationEverything FS-8700-82 Carrier DataLink Error Message Explanation This page Intentionally Left Blank
Top Page Image Contents