FieldServer FS-8700-82 Appendix A.4.2. Extending the List of Discrete State Words

FS-8700-82 Carrier DataLinkPage 24 of 31

State Word	Value	State Word	Value
OFF	0	OFF-CCN	2
OPEN	1	OFF-time	3
CLOSE	0	Emergency	4
CLOSED	0	ON-local	5
ABNORMAL	1	ON-CCN	6
NORMAL	0	ON-time	7
ALARM	1	Redline	1
STOP	0	Shed	2
START	1	DSABLE	0
YES	1	LOCAL	0
NO	0	REMOTE	1

If the driver doesn’t recognize the state word it stores the characters of the state word as decimal values based on their ASCII value. The number of characters stored is dependent on the length parameter.

For example, say the driver responds, reporting a variable to be a state ‘INCREDIBLE’. If the length parameter of the polling map descriptor is 1 then the driver stores a value of 73 (An uppercase ‘I’ is the seventy third character in the ASCII alphabet.). If the length was 2 then the driver would also store the value 78 in the next array. The driver will store a maximum of 100 characters. The driver recognizes discrete state words by checking the 1st character of the value field. If it is a non-digit then it is regarded as a state word.

Appendix A.4.2. Extending the List of Discrete State Words

You can extend the list of state words the driver recognizes by modifying the configuration file.

The following example adds three state words. If a device reports the state of the variable as LIGHT then the driver will store the value of 1, if on the other hand the state is reported as DARK then the driver will store the value zero.

	State Words. The
	name will be
Keyword	stripped of all
	spaces between
starts a new
	the last character
section of
	and the comma.
the CSV file.

Normally the values will be 1 or zero for the on/off states but the driver does not restrict the value.

Protocol must be defined on every line.

Driver_Table
Carrier_Attr_State_Name,		Carrier_Attr_State_Value,		Protocol
LIGHT	,	1	,	CarrierDL
DARK	,	0	,	CarrierDL

You can use this method to change the values of any of the driver’s default state words by duplicating the word and specifying a new value in the configuration file.

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