FieldServer Carrier DataPort FS-8700-86 Driver Manual Download Page 29

FS-8700-86 Carrier DataPort 

 

 

 

 

 

 

Page 29 of 32 

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] 

Error Message 

Explanation 

works 

best 

with 

long 

timeouts. 

each  table  is  different.  The  driver  does  not  know  the  length  of  the 
responses. The Carrier devices take some time between receiving a poll 
and sending a response. The amount of time is proportional to the length 
of the response (and hence, to the size of the table.) If the device takes 
too long the driver may timeout as the default timeout is 2.0 seconds. It is 
strongly recommended that  you set the timeout to a  large  value (like 30 
seconds) to start with. The effect of having a large timeout is to  
1) allow the driver enough time to receive the response and  
2)  Increase  the  amount  of  time  before  the  driver  reports  the  timeout  if 
there is a genuine timeout event. 

CarrDP:#26  FYI.  No  data 
was stored for MD=%s 

This  message  is  printed  when  a  response  is  received  but  the  driver  did 
not  find  any  information  in  the  response  that  it  could  use  to  store.  If  the 
problem occurs repeatedly then take a log and call tech Support after you 
have  tried  the  following  diagnostic  steps.  1)  Check  connection  stats  –  If 
bytes received per message is < 100 then it is likely that the device  you 
are  polling  is  not  responding  properly  or  that  a  port  setting  is  invalid. 
Check the port settings. 

CarrDP:#27  Err.  Can’t  open 
slave.log 

This message should only be printed in simulation mode (QA testing).  If 
you see this message call Tech Support. 

CarrDP:#28  FYI.  Response 
was  sent  from  slave.log 
(Hex file) 

This message should only be printed in simulation mode (QA testing).  If 
you see this message call Tech Support. 

CarrDP:#29  Err.  The  input 
buffer has overflowed. 

This  message  could  be  produced  when  the  characters  which  signal  the 
end of a response are missing and the next response is appended to the 
1

st

 in the input buffer. In such cases the buffer may overflow.  

 
This message is printed once and then suppressed. However each time 
the event occurs, the STREAMING stat is incremented by one. 
 
If  the  stat  is  produced  rarely  then  you  could  assume  that  that  an 
occasional corrupt/incomplete message has produced the error. 
 
If it occurs all the time, then assume that the response is too large to fit in 
the input buffer. 
 
Most  FST  drivers  have  an  input  buffer  of  3080  bytes  This  driver  has  a 
buffer size of 16000 bytes. The buffer size is hard coded so you will need 
to capture a log and send an error report to FST. 

CarrDP: #30 

CarrDP:#31  Err.  Line  has 
missing  CR.  Some  data  not 
stored 

CarrDP:#32 

Err. 

Many 

missing 

CR's. 

Abandon 

store... MD=%s 

When parsing a response, the driver processes the response line by line.  
A  single  response  may  consist  of  a  number  of  lines.    Each  line  is 
terminated  with  a  Carriage  Return  (CR).    If  a  single  CR  is  missing  then 
the driver sees two lines as a single line. In versions prior to 1.03eA the 
driver used the line number as the offset, therefore values extracted from 
subsequent  lines  were  stored  at  the  incorrect  offset.    Now  the  driver 
ignores the corrupted line and advances the line counter by 2 continuing 
the parsing and storing of extracted values.  The values associated with 
the corrupted response line are not updated.  This is reflected in the line 
count stored at offset zero. The driver detects lines with missing CR's by 
checking the line length.  If the driver senses that more than two or more 
consecutive  CR's  are  missing  then  the  driver  abandons  the  parse  and 
store and prints error #32.  If different parts of the response have missing 
CR's message #31 will be printed more than once per response.  There 
is no direct corrective action you can take. The errors arise from dropped 
bytes  in  the  response.  If  the  error  occurs  frequently  you  will  need  to 
check that the data transmission is not being adversely affected by noise. 

Summary of Contents for Carrier DataPort FS-8700-86

Page 1: ...mpany APPLICABILITY EFFECTIVITY Effective for all systems manufactured after August 2008 Driver Manual Supplement to the FieldServer Instruction Manual FS 8700 86 Carrier DataPort Driver Version 1 03 Document Revision 11 ...

Page 2: ...rver Side Connections 11 5 3 Server Side Node Descriptors 11 5 4 Server Side Map Descriptors 12 5 4 1 FieldServer Specific Map Descriptor Parameters 12 5 4 2 Driver Specific Map Descriptor Parameters 12 5 4 3 Timing Parameters 13 5 4 4 Map Descriptor Example 14 APPENDIX A ADVANCED TOPICS 15 Appendix A 1 Field Status Field Engineering Units 15 Appendix A 2 Field Variable Names 16 Appendix A 3 Map D...

Page 3: ...rt device which is expected to provide responses Server functionality is provided by the driver too The driver is configured to allow a single Data Table usually the Display Table to be read from the CCN devices via the DataPort device As the table typically contains more than one data element the retrieved data is stored in a number of consecutive Data Array locations in the FieldServer The drive...

Page 4: ... Hardware Connections The FieldServer is connected to the Carrier DataPort device as shown below Configure the DataPort Device according to manufacturer s instructions This driver requires that the DataPort device s DTPCONFIG table has been configured prior to connection with a FieldServer In addition consult the manufacturer s information on connecting Carrier Device s to CCN network Note Typical...

Page 5: ...uded with the FieldServer See csv sample files provided with the FieldServer This section documents and describes the parameters necessary for configuring the FieldServer to communicate with a Carrier DataPort Server The configuration file tells the FieldServer about its interfaces and the routing of data required In order to enable the FieldServer for Carrier DataPort communications the driver in...

Page 6: ...t of time the driver must wait for a complete response If the Data Port table is long then increase the timeout above the default until timeout errors disappear 2 seconds Application Refer to notes in Appendix B 3 Print_storage_locations Start_Method If the parameter is not configured or set to 0 default the driver will identify the start of a message as FORMFEED 0x0C and the end as two carriage r...

Page 7: ... the devices configured in the DTPConfig Thus the Node_ID is not the address of the final CCN device The DataPort DTPConfig table maps a device number 1 15 to a bus number 0 239 Use the Node_ID to tell the driver which device to use 1 15 Protocol Specify protocol used CarrierDP Port Specify which port the device is connected to the FieldServer P1 P8 R1 R2 3 Example Client Side Nodes Nodes Node_Nam...

Page 8: ...ta from One of the node names specified in Client Node Descriptor above Data_Type This commonly used parameter is not required for this driver Length Length of Map Descriptor When reading a compete table set the length to the maximum number of data values you want stored Additional information on the length parameter is provided in Appendix A 3 1 1000 Address This commonly used parameter is not re...

Page 9: ...se will be stored in the array called DA_DISPLAY Ensure that it is suitable format for storing number FLOAT is suggested The driver stores the value of the 1 st element at offset 1 the 2 nd element at offset 2 and the driver stores the number of table elements whose values have been successfully stored at offset zero Client Side Map Descriptors Map Descriptors Map_Descriptor_Name Data_Array_Name D...

Page 10: ...ls the FieldServer about its interfaces and the routing of data required In order to enable the FieldServer for Carrier DataPort communications the driver independent FieldServer buffers need to be declared in the Data Arrays section the FieldServer virtual node s needs to be declared in the Server Side Nodes section and the data to be provided to the Clients needs to be mapped in the Server Side ...

Page 11: ...andshaking Poll_Delay P8 9600 None 8 1 CarrierDP None 0 100s 5 3 Server Side Node Descriptors Section Title Nodes Column Title Function Legal Values Node_Name Provide name for Node Up to 32 alphanumeric characters Node_ID DataPort station address of physical Server Node These correspond to the devices configured in the DTPConfig Thus the Node_ID is not the address of the final CCN device The DataP...

Page 12: ...lled e g DISPLAY This parameter is for display purposes only The driver does not use the value of this parameter Some system elements have multiple instances of the same table name For example the Terminal System Manager has 64 Temperature Zone configuration tables The individual tables are named TZONE1 though TZONE64 These tables are accessed by using both the primary secondary table names E g TZ...

Page 13: ...alue of the associated array elements NUMERIC a number TIME a time value formatted as hh mm STRING a string of bytes DOW occupancy string When using the string keyword the driver reads x consecutive array elements and treats them as ASCII character values in forming the response X is defined by the length parameter NUMERIC TIME STRING DOW Or any other Ascii string which may not contain spaces Off_...

Page 14: ...t Status ALARM NORMAL TABLE_DISPLAY 02 1 Display_MD03 passive Node_1 DISPLAY CSPT Controlling Setp dF NUMERIC TABLE_DISPLAY 03 1 Display_MD04 passive Node_1 DISPLAY SPT Controlling Temp dF NUMERIC TABLE_DISPLAY 04 1 Display_MD05 passive Node_1 DISPLAY RAT Space Temp dF NUMERIC TABLE_DISPLAY 05 1 Display_MD06 passive Node_1 DISPLAY SAT Supply Air Temp dF NUMERIC TABLE_DISPLAY 06 1 Display_MD07 pass...

Page 15: ...4 inches of water 067 input pulses off 290 cubic meters per minute 015 milliamps 068 seconds 291 cubic meters per hour 016 delta degrees F 069 normal alarm 292 kiloPascals 017 degrees F 070 Hz 293 kilograms per hour 018 delta degrees F 080 minutes 295 kilowatt hours 020 pounds per square inch 081 hours 296 kilowatts 032 gallons per minute 082 revolutions per minute 297 millimeters of water 033 gal...

Page 16: ...ilding Supervisor Monitor forced by remote Building Supervisor Minimum off forced by minimum off time requirement Control forced by System Software Option BEST forced by BEST program Temp Override forced by temperature override Loadshed forced by Loadshed System Software Option Appendix A 2 Field Variable Names A list of variable names vs table names vs equipment types is not provided in this manu...

Page 17: ...lity provided with the FieldServer can be used to browse and read the results Data_Arrays Data_Array_Name Data_Format Data_Array_Length DA_DUMP BYTE 2000 Map Descriptors Map_Descriptor_Name Data_Array_Name Data_Array_Offset Function Node_Name Length Scan_Interval Storet_As Md1 DA_DUMP 0 rdbc FAN01 1000 5 0s ASCII This is what tells the driver to dump the table its variables names and variable desc...

Page 18: ...criptors Map_Descriptor_Name Data_Array_Name Data_Array_Offset Function Node_Name Length Scan_Interval Storet_As Md1 Da_Dump 0 rdbc FAN01 1000 5 0s AsciiLog The following fragment from the error log is typical of the response to a Map Descriptor like the one above T01 ASCII Dump Requested for MD MapDesc1 T01 Field1 99 0 000 000 Desc1 1 1 T01 Field2 98 0 000 000 Desc2222222 T01 Field3 on 000 000 33...

Page 19: ...is programmed to recognize the keywords listed below The user can add keywords by specifying additional information in the configuration file State Word Value State Word Value State Word Value CLEAN 1 ABNORMAL 1 OPEN 1 DIRTY 0 NORMAL 0 CLOSE 0 HEAT 1 LOCAL 0 CLOSED 0 COOL 0 REMOTE 1 ALARM 1 ON 1 LOCAL R 0 OFF 0 RUNNING 1 If the driver doesn t recognize the state word it stores the characters of th...

Page 20: ...tion CSV 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 Driver_Table Carrier_Attr_State_Name Carrier_Attr_State_Value Protocol LIGHT 1 CarrierDP DARK 0 CarrierDP This method may be used to change the values ...

Page 21: ...ic Values The driver recognizes numeric values by checking the first character of the value field If it is a digit then the field is treated as a number Appendix A 4 4 Occupancy Strings Values If the value returned for a variable is 8 characters long and each of the characters is a one or a zero then the driver regards this as an occupancy string an converts it to a binary coded decimal value and ...

Page 22: ...nt from the data port to the FieldServer The default timeout is insufficient in such cases In resolving one customer s connection problems a timeout of 4 s on a table of 134 entries was found to produce good results Please read the notes provided with Error message 25 in section Appendix D of this manual Appendix B 3 Determining Storage Locations Set the Application parameter to Print_storage_loca...

Page 23: ...ide an INI file Make the following changes Replace NP with FF Replace SP with a space Replace NULL with a space Use the following files as a guide Client csv Data_Arrays Data_Array_Name Data_Format Data_Array_Length DA_D1_01 Float 500 Connections Port Parity Baud Data_Bits Stop_Bits Handshaking Protocol Timeout Print_storage_locations P1 None 9600 8 1 None CarrierDP 60s Yes Nodes Node_Name Node Pr...

Page 24: ...nt Comp 2 CR EXV_A 0 0 003 000 EXV Position CR hd_pos_a 0 0 003 000 Head Press Actuator Pos CR PINCH_A 0 3 006 000 Cooler Exchange Delta T CR MTQ_RESA 8 7 000 000 Motor Cool TQ in Kohms CR CPA1_PUL 30 000 000 Motor Cooling Puls Cycle CR 0 000 000 CIRCUIT A DISCRETE CR 0 000 000 CR CP_A1 0 000 000 Compressor 1 Output CR cpa1_mc1 0 000 000 Cp1 Mtr Cool Solenoid 1 CR cpa1_mc2 0 000 000 Cp1 Mtr Cool S...

Page 25: ...OND_SP 104 0 001 000 Current Cond Setpoint CR tot_curr 0 047 000 Chiller Total Current CR 0 000 000 RECLAIM ANALOG PARAM CR HR_EWT 0 0 001 000 Reclaim Entering Fluid CR HR_LWT 0 0 001 000 Reclaim Leaving Fluid CR hr_sp 104 0 001 000 Reclaim Fluid Setpoint CR sct_a_sp 118 4 001 000 Cir A SCT Control Point CR sct_b_sp 118 4 001 000 Cir B SCT Control Point CR pmpd_p_a 0 0 020 000 Cir A Pumpdown Press...

Page 26: ...e following functions Send Data Periodically Stop Sending Xoff Xon Omit 24 Character description Include 24 Character description Read Configuration The Carrier DataPort driver is not capable of configuring the DataPort device Software provided by the Carrier Corporation is required to do this The DataPort device requires configuration so that it connects to the appropriate CCN devices on the CCN ...

Page 27: ... 6 Err Fieldname max length 8 MapDesc s CarrDP 7 Err Field Desc max length d MapDesc s You can use no more than 8 characters to define a field name and no more than 24 to define the field description CarrierDP 8 Err Length required MapDesc s The length parameter must be set in the configuration file and it must be set to a value greater than zero Appendix A 3 provides additional information Carrie...

Page 28: ...us values are ignored More information on status values is provided in Appendix A 1 CarrDP 18 FYI Use DA_Float_Name for units value storage MD s This message may be safely ignored It is provided for your information only It reminds you that you can use a secondary Data Array connected to the Client side Map Descriptor to have the driver store engineering units values when a poll response is obtain...

Page 29: ... characters which signal the end of a response are missing and the next response is appended to the 1 st in the input buffer In such cases the buffer may overflow This message is printed once and then suppressed However each time the event occurs the STREAMING stat is incremented by one If the stat is produced rarely then you could assume that that an occasional corrupt incomplete message has prod...

Page 30: ... cannot transmit data from the requested controller because a communication error occurred while the DATAPORT was acquiring data from that controller 4 Database Full The digit 4 returned as an error code means that the off network device has commanded the DATAPORT to transmit data from a controller that is properly configured in the DATAPORT but the controller is beyond the 900 point limit For exa...

Page 31: ...p Descriptor is required The driver recognizes the Map Descriptor by its name which must be CarrierDP 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 CarrDP_stats 1 CarrierDP Data_Arrays Data_Array_Name Data_Format Data_Array_Length DA_CARRIERDP_STATS UINT32 2000 Map_D...

Page 32: ...error 8 59 109 159 210 260 310 360 Number of times Client receives an error response 10 60 110 160 210 260 310 360 Error 1 Invalid Command 11 61 111 161 211 261 311 361 Error 2 No Display Table 12 62 112 162 212 262 312 362 Error 3 CCN Bus Communication Error 13 63 113 163 213 263 313 363 Error 4 Database Full 14 64 114 164 214 264 314 364 Error 5 DATAPORT Busy 15 65 115 165 215 265 315 365 Error ...

Reviews: