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

FS-8700-86 Carrier DataPort 

 

 

 

 

 

 

Page 6 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] 

4.2. 

Client Side Connections 

Section Title 

Connections 

Column Title 

Function 

Legal Values 

Port 

Specify  which  port  the  device  is  connected  to  the 
FieldServer 

P1-P8,  (  R1,  R2  with 
converter)

1

 

Baud* 

Specify baud rate. 

600  ,  1200,  2400, 

9600

  

(Vendor limitation) 

Parity* 

Specify parity  

None 

(Vendor limitation) 

Data_Bits* 

Specify data bits  

(Vendor limitation) 

Stop_Bits* 

Specify stop bits. 

(Vendor limitation)

 

Protocol 

Specify protocol used 

CarrierDP 

Handshaking* 

Specify hardware handshaking 

None

 

Poll _Delay* 

Time between internal polls 

0-32000 

seconds,

 

second 

Timeout

2

 

Specifies  the  max  amount  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 returns (0x0D 0x0D) 
 
When  the  parameter  is  set  to  1,  the  first  carriage 
return  (0x0D)  will  be  considered  the  start  of  the 
message  (all  characters  before  the  first  carriage 
return  will  be  ignored).  and  the  end  as  two  carriage 
returns (0x0D 0x0D) 

1,

0

 

 

Example 

 

//    Client Side Connections 
 
Connections 
Port, 

Baud,   Parity, 

Data_Bits,  

Stop_Bits,  

Protocol ,  

Handshaking,  

Poll_Delay 

P8,     9600,  

None, 

 8        , 

1        ,  

CarrierDP,  

None       ,  

0.100s 

 

                                                 

1

  Not  all  ports  shown  are  necessarily  supported  by  the  hardware.  Consult  the  appropriate  Instruction 

manual for details of the ports available on specific hardware. 

2

 See Appendix B.1 for additional information 

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: