FieldServer Dart FS-8700-78 Driver Manual Download Page 3

Driver Manual

 

FieldServer Technologies 1991 Tarob Court, Milpitas, California 95035 (408) 262-2299 fax: (408) 262-9042 

Visit our website: www.fieldserver.com          E-mail:  

[email protected]

 

Page 1

 

 Dart Driver Description  

 
The Dart Driver is designed for connection to a Data Air Coporation Dart Device.  
 
The Dart device is a active element on a network of Data Air devices such as DAP panels. It 
manages the devices and provides co-ordination and supervision. In performing these duties the 
Dart device polls all the devices on the network for all the data. The Dart is capable of ‘echoing’ 
the responses from these devices on one of its RS232 ports. This driver is designed to listen 
passively to these echoes and store device data. In addition the driver can send messages 
(containing set point data, for example,) directly to individual devices on the network. 
 
The FieldServer is connected to the RS232 serial port of the Dart. The Fieldserver can read and 
write but active polling must be minimized as in reduces the amount of time that the DART 
spends controlling the networked devices. The driver operates primarily as a passive client 
listening to echoes of the data being polled by the DART. The DART must be set to ‘Echo’ mode 
on the front panel of the Dart for the driver to operate correctly. There is no alternative to this 
essential but manual setup-step. 
 
The driver may be configured very simply (See example 1 in section 4 of the manual). In addition 
a number of advanced configurations are possible. The manual is divided to separate the basic 
and advanced topics. 
 
The driver supports the common message formats for common Data Aire devices. A list of the 
supported messages is provided in the manual. The driver cannot be used to configure or read the 
status of a DART device itself.  
 
The information that follows describes how to expand upon the factory defaults provided in the 
configuration files included with the FieldServer. 

 

 

1.1 

Performance Issues 

 
Several factors outside FieldServer’s control make for slow communications with Data Aire 
devices. The Data Aire communications is based on a very low baud rate. In addition inter-
message timing constraints and overhead requirements for active messages in a Dart 
configuration add significant time to each transaction. 
 
When a used with a DART device, writing to a set point (or other variable) may take up to 8 
seconds to complete the transaction. The results of the write will not be seen until the DART has 
timed-out back into control mode and echoes the new data to the Fieldserver. This could take 
several minutes if there are many devices on the loop and will take at least 30 seconds. 
 
 
When writing continuously, with DART configurations, the minimum time interval between 
successive writes is 2 minutes and with non-DART configurations is 1.8 seconds.

 

 

 

Summary of Contents for Dart FS-8700-78

Page 1: ...IVITY Effective for all systems manufactured after January 18 1999 Driver Manual Supplement to the FieldServer Instruction Manual FS 8700 78 Dart Instruction Manual Part Number FS 8700 78 2 20 2003 A Sierra Monitor Company ...

Page 2: ... 4 5 Map of How Data Aire Device Data is stored in a Data Array 12 4 4 6 Unit Types 17 4 4 7 Map Descriptor Example 2 Writing a Set Point 19 4 4 8 Map Descriptor Example 3 Writing multiple points using one message 20 5 Chapter 5 21 6 Advanced Topics 23 6 1 Additional Driver Specific Map Descriptor Parameters 23 6 1 1 DA_Func Parameter Permitted values 24 6 1 2 DA_Field Parameter Permitted values 2...

Page 3: ...alternative to this essential but manual setup step The driver may be configured very simply See example 1 in section 4 of the manual In addition a number of advanced configurations are possible The manual is divided to separate the basic and advanced topics The driver supports the common message formats for common Data Aire devices A list of the supported messages is provided in the manual The dr...

Page 4: ...99 fax 408 262 9042 Visit our website www fieldserver com E mail support fieldserver com Page 2 2 Driver Scope of Supply 2 1 Supplied by Sierra Monitor for this driver RS485 connection adapter Driver Manual 2 2 Provided by user Data Aire Dart and documentation RS232 cable for the loop network ...

Page 5: ...nual FieldServer Technologies 1991 Tarob Court Milpitas California 95035 408 262 2299 fax 408 262 9042 Visit our website www fieldserver com E mail support fieldserver com Page 3 3 Hardware Connections Hardware ...

Page 6: ...t our website www fieldserver com E mail support fieldserver com Page 4 3 1 Hardware Configuration Dart Present When a DART device is connected to the Data Aire field devices then the Fieldserver is connected to the serial port of the DART The DART must be set to Echo mode This is done on the front panel of the DART ...

Page 7: ...nation device addresses need to be declared in the Client Side Nodes section and the data required from the servers needs to be mapped in the Client Side Map Descriptors section Details on how to do this can be found below The Dart Serial Driver cannot be configured as a data server Note that in the tables indicates an optional parameter with the bold legal value being the default 4 1 Data Arrays ...

Page 8: ...P1 P8 requires 232 485 converter Secondary_Port Using a Dart Do not specify this parameter P1 P8 R1 R2 R1 R2 requires 232 485 converter Baud Specify baud rate 2400 Others available but Daire only operates at 2400 baud Parity Specify parity None Data_Bits Specify data bits 8 Stop_Bits Specify stop bits 1 Protocol Specify protocol used Either keyword may be used Dart Handshaking Specify hardware han...

Page 9: ...s Column Title Function Legal Values Node_Name Provide name for node Up to 32 alphanumeric characters Node_ID This is not the node address of the Dart device Specify the node address of the DAP device whose data you wish to monitor 1 259 Protocol Specify protocol used Dart Port Specify which port the Dart is connected to the FieldServer P1 P8 R1 R2 Example Client Side Nodes Nodes Node_Name Node_ID...

Page 10: ...rations as communications are minimized RDBC WRBC WRBX Passive 4 4 2 Timing Parameters Column Title Function Legal Values Scan_Interval Rate at which data is polled 0 1s 4 4 3 Driver Specific Map Descriptor Parameters Column Title Function Legal Values Node_Name Name of Node to fetch data from One of the node names specified in Client Node Descriptor above Length Length of Map Descriptor 1 The len...

Page 11: ..._Assoc parameter value This is the name of the data field whose value you wish to set in the device Other uses of this parameter are permitted These uses are discussed in the Advanced Topics section of this manual See Table 4 4 3 3 for a list of permitted values DA_Assoc Use to associate passive map descriptors with an active map descriptor Using this parameter you associate multiple fields with o...

Page 12: ...Driver Manual FieldServer Technologies 1991 Tarob Court Milpitas California 95035 408 262 2299 fax 408 262 9042 Visit our website www fieldserver com E mail support fieldserver com Page 10 ...

Page 13: ...dserver com Page 11 4 4 4 Map Descriptor Example 1 Read all possible data Map_Descriptor_Name Data_Array_Name Data_Array_Offset Function node_name Address Length DA_Func Read_Node_01 DA_01 0 passive Unit1 0 1300 Everything The driver waits passively for the Dart to echo data from the devices No Scan Interval The driver will process data as fast as the Dart can serve it ...

Page 14: ...s for which the data fields are available For example The field d_temp can be read from unit types 2 5 6 7 9 but not from any of the other unit types It is beyond the scope of this manual to describe each field and to indicate valid ranges Such information should be obtained from the Data Aire Corporation x Indicates Read only X Indicates a point that can be read written w Indicates a write only p...

Page 15: ...x x Dap Xtra 190 1 1 runtime_ht2 x x x x x Dap Xtra 191 1 1 runtime_ht3 x x x x x Dap Xtra 192 1 1 runtime_hum x x x x x Dap Xtra 193 1 1 runtime_evap x x x x x Dap Xtra 194 1 1 runtime_cond x x x x x Dap Xtra 195 1 1 runtime_dehum x x x x x Dap Xtra 196 1 1 runtime_esc x x x x x Dap Xtra 197 1 1 runtime_cwc x x x x x Dap Xtra 198 4 20 errors x x x x x Dap Xtra 218 6 10 errage x x x x x Dap Xtra 2...

Page 16: ... X X Dap Menu 504 2 1 lo_t_lim X X X Dap Menu 505 1 1 main_int X X X Dap Menu 506 1 1 passwd_a X X X Dap Menu 507 1 1 passwd_b X X X Dap Menu 508 1 1 rst_mode X X X Dap Menu 509 1 1 s_delay X X X Dap Menu 510 2 1 t_calib X X X Dap Menu 511 1 1 voice X X X Dap Menu 512 1 1 vvrg X X X Dap Menu 513 1 1 cat1 X X X Dap Menu 514 1 1 cat2 X X X Dap Menu 515 1 1 cat3 X X X Dap Menu 516 2 1 d_calib X X X D...

Page 17: ...im X X X Chiller Menu 864 4 1 LL_policy X X X Chiller Menu 865 2 1 lo_r_lim X X X Chiller Menu 866 2 1 lo_s_lim X X X Chiller Menu 867 1 1 main_int X X X Chiller Menu 868 4 1 mods_configd X X X Chiller Menu 869 1 1 network_ID X X X Chiller Menu 870 1 1 op_1_delay X X X Chiller Menu 871 1 1 op_2_delay X X X Chiller Menu 872 4 1 op_1_message X X X Chiller Menu 873 4 1 op_2_message X X X Chiller Menu...

Page 18: ... X X X X Dap80 Menu 918 2 1 fire_lim X X X X Dap80 Menu 919 4 1 heater_config X X X X Dap80 Menu 920 1 1 hi_h_lim X X X X Dap80 Menu 921 2 1 hi_t_lim X X X X Dap80 Menu 922 4 1 humid_config X X X X Dap80 Menu 923 2 1 h_calib X X X X Dap80 Menu 924 1 1 h_dband X X X X Dap80 Menu 925 4 1 lead_lag X X X X Dap80 Menu 926 2 1 lo_d_lim X X X X Dap80 Menu 927 1 1 lo_h_lim X X X X Dap80 Menu 928 2 1 lo_t_...

Page 19: ...sor_2_type x x Dap80 Analog 1109 1 1 sensor_2_min_val x x Dap80 Analog 1110 1 1 sensor_2_max_val x x Dap80 Analog 1111 1 1 sensor_2_cal x x Dap80 Analog 1112 1 1 sensor_1_input x x Dap80 Channels 1113 1 1 sensor_2_input x x Dap80 Channels 1114 1 1 sensor_3_input x x Dap80 Channels 4 4 6 Unit Types When the driver reads everything from a device it must first obtain the device s unit type so that it...

Page 20: ...2 Visit our website www fieldserver com E mail support fieldserver com Page 18 7 7 080 DAP II no relay expansion 8 8 080 Chiller II 9 9 080 DAP II with relay expansion 10 10 Not Defined 11 11 Not Defined 12 12 Not Defined 13 13 Not Defined E 14 080 DAP II with analog module F 15 080 DAP II with relay and analog ...

Page 21: ...setpt 120 0s Reccomendation Use wrbx instead of wrbc This causes the driver to generate the command message only when the setpoint changes which in turn minimizes communications Using this method the DART s control mode is interrupted the least The setpoint is obtained from this data array Always leave the address set to zero and the length as one Specify the data field you wish to write Pick from...

Page 22: ... This write will update two fields the nom_h_setpt and the t_setpt The write MapDesc Must precede the passive This method is only appropriate if you plan to continuosly write to the devices If you intend to write on change using the wrbx function then use multiple map descriptors that are not associated and give each one a wrbx Associate the passive map descriptor to the active wrbc map descriptor...

Page 23: ...l FieldServer Technologies 1991 Tarob Court Milpitas California 95035 408 262 6611 fax 408 262 9042 Visit our website www sierramonitor com E mail sierra sierramonitor com Page 21 5 Chapter 5 This Chapter is blank ...

Page 24: ......

Page 25: ...to be used Use a function appropriate to the type of slave DAP Chiller DAP80 and the type of data required Numeric Text See section 6 1 1 for a list of possible values DA_Field Specifies the data field to be retrieved from the slave device Salves are only capable of responding with a data composite consisting of many data fields You use this parameter to specify which parameter is you wish to have...

Page 26: ...or a list of possible values DA_BytcntΨ Specifies the number of bytes that are to be processed by the method specified above For method 6 which processes an array of elements the DA_Bytcnt specifies the number of bytes that constitute each element of the array 1 DA_OffsetΨ An offset into the data composite that is returned when the slave is polled The offset is the number of bytes from the first d...

Page 27: ...P Channels Query DA_Func dap80_channles 72 Each of the above queries returns a complex set of data consisting of many sub fields Contact Data Aire for a complete listing of the data composite returned The following special diagnostic functions are also implemented Driver Parameter Protocol Id DA_Func All Listen 11 DA_Func Ack 6 DA_Func Dart Transparant 2 DA_Func Dart Opaque 3 DA_Func Test Echo 16 ...

Page 28: ...rt config Bytes 41 DA_Func dap config Bytes 4 DA_Func dap log Bytes 240 DA_Func dap unit Bytes 1 DA_Func dap stat Bytes 68 DA_Func dap xtra Bytes 124 DA_Func dap menu Bytes 103 DA_Func chiller stat Bytes 54 DA_Func chiller xtra Bytes 104 DA_Func chiller menu Bytes 89 DA_Func dap80 menu Bytes 138 DA_Func dart status Bytes 9 DA_Func dap80 analog Bytes 36 DA_Func dap80 channels Bytes 12 Bytes Special...

Page 29: ... s and temperatures which are transmitted as the number of tenths of a unit Thus in the example of method 1 The 4 bytes yield the decimal number 29 1 F Method 3 Each byte is regarded as containing a hexadecimal digit in ASCII format Example incoming byte contains 41 hex regard as the hexadecimal digit A in ASCII format The method then converts the hex digit to a series of 8 bits In this example th...

Page 30: ... stat cs_on 5 A7 DA_AI2 1 passive Node_A 0 1 dap stat hs_on 5 All these map descriptors address Node_a therefore only one map descriptor needs to read rdbc the node The remaining map descriptors can be passive thus optimizing communications The scan time is only important for the active map descriptor It would be sensible for DA_AI3 to be an array of FLOATs because the temps and humidity s return ...

Page 31: ...DA_Func DA_Field Scan_Interval A1 DA_AI1 0 rdbc Node_A 0 1 dap stat errors 5 A2 DA_DI1 1 passive Node_A 0 1 dap stat bitErrors 5 The errors key word returns 14 bytes thus we DA_AI1 should be a BYTE array Each byte will have values 0 15 to represent the value of the bits in each byte The bitErrors extracts the same data from the DAP but presents it as a series of 14x8 bits Thus make Slave is a DAP ...

Page 32: ...set DA_Elecnt Scan_Interval A1 DA_AI3 0 rdbc Node_A 0 1 dap stat special 1 4 10 1 5 You can use specials as rdbc and passive map descriptors See table 6 3 for descriptions on how these extraction methods work It would be sensible for DA_AI3 to be an array of FLOATs because extraction method 1 returns a floating point number Performs a DAP status query From the data bytes returned by the slave extr...

Page 33: ...c Node_A 0 1 dap80 menu nom_h_setpt 2 5 A9 DA_AI4 1 passive Node_A 0 1 dap80 menu t_setpt 2 5 A Read and some passive map descriptors to extract other data fields from the same read optimizes communications Read must precede the passive s A Write and a passive to the same node This write will update two fields the nom_h_setpt and the t_setpt The write map desc Must precede the passive DA_Assoc ass...

Page 34: ...rray_Offset Function node_name Address Length DA_Func A1 1 0s UNUSED_ARRAY 0 wrb No_node 0 1 All Listen This command is sent only once If you need to do this periodically then change this to a wrbc A data array must be associated with the map descriptor even though it will not be used It may be any data type Must connect this map descriptor to a node whose node_id is zero For example Nodes Node_Na...

Page 35: ...Driver Manual FieldServer Technologies 1991 Tarob Court Milpitas California 95035 408 262 6611 fax 408 262 9042 Visit our website www sierramonitor com E mail sierra sierramonitor com Page 33 ...

Page 36: ...his type of problem Example Valid ASCII digits are 0 9 A F If a byte is being parsed and an hex digit is expected but not found then the driver considers this an errors and writes the bad value indication OR produces an error message when the bad value indication cannot be used 6 3 2 Dead Nodes When a node is absent or dies it is possible that the Dart may go idle and stop communicating with all o...

Page 37: ...ully we must first read the device successfully If the read has not been completed then the write operation will be abandoned The driver prints messages to the error logs and records a NODE_OFFLINE stat each time that it attempts to write but is unable to The DAP Config command is an exception to the above notes A read is not required The Dap Config command is used to turn off on DAP units The Com...

Page 38: ...mber Format Explained 1 05a Rev0 7 1 Rev1 06a Rev0 Changes from previous releases This is the first release of this driver since its separation from a combined Dart Dap driver Previously this manual was identified as the Data Aire user Manual Rev1 05a Rev2 Indicates Driver release this release of the manual corresponds to Revisions to the manual Each time that the driver release number changes the...

Reviews: