background image

FS-8700-16 BACnet PTP Serial Driver Manual 

 

 

 

 

 

Page 18 of 32 

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

: [email protected] 

Appendix A.3.

 

Accessing Data from BACnet Properties comprising Arrays of Values 

Some BACnet Object properties (e.g. Priority_Array) are arrays of values (the Priority_Array property is an array of 16 values).  In order to read a specific array entry, the 
Array_Index must be specified in the Map Descriptor.  Array_Index is a Client Side Map Descriptor function 

The following example shows a configuration that will read the Priority_Array value at Array_Index 7, belonging to Analog Output 1. 

Map_Descriptors                                 

 

 

 

 

 

 

 

 

Map_Descriptor_Name   , Data_Array_Name   , Data_Array_Offset   , Function   , Node_Name   , Data_Type   , Object_ID   , Property        

, Array_Index 

CMD_AI_01            

, DA_AI_01         

, 0                  

, Rdbc      

, DEV_01     

, AO         

, 1          

, Priority_Array   , 7 

 
Details of the relevant BACnet properties and their associated arrays can be found in the BACnet Protocol Spec. 

Appendix A.4.

 

FieldServer implementation of BACnet priority Arrays 

When BACnet Output objects are written to the Server side of the FieldServer, an associated write priority is given to each write value.  When the FieldServer receives the 
write value, it stores it to the Map Descriptor Priority Array Table at the specified priority.  The Priority Array Table is then scanned and the value with the highest priority 
is stored to the Data Array location specified by the Map Descriptor. 

When a Write “Relinquished” command is received, the value is removed from the Priority Array Table and the next highest value from the Priority Array Table is stored 
to the Data Array. 

If all values have been “Relinquished” from the Priority Array Table, then the Map Descriptors “Relinquish Default” value will be stored to the Data Array. 

Summary of Contents for FS-8700-16

Page 1: ...7 Document Revision 1 A Sierra Monitor Company Driver Manual Supplement to the FieldServer Instruction Manual FS 8700 16 Bacnet PTP Serial APPLICABILITY EFFECTIVITY Effective for all systems manufactured after June 2009 ...

Page 2: ... 13 5 4 Server Side Node Descriptors 13 5 5 Server Side Map Descriptors 14 5 5 1 FieldServer Specific Map Descriptor Parameters 14 5 5 2 Driver Specific Map Descriptor Parameters 15 5 5 3 Map Descriptor Example 16 Appendix A Useful Features 17 Appendix A 1 BACnet object names 17 Appendix A 2 Network number 17 Appendix A 3 Accessing Data from BACnet Properties comprising Arrays of Values 18 Appendi...

Page 3: ...2 Toll Free 888 509 1970 email support fieldserver com Appendix C 1 McQuay 26 Appendix C 2 Trane 26 Appendix C 3 Liebert 26 Appendix C 4 Automated Logic Corporation 26 Appendix C 5 Honeywell EBI 26 Appendix D Reference 27 Appendix D 1 Object_Type Legal Values Abbreviation Descriptions 27 Appendix D 2 Property Legal Values 27 Appendix D 3 Units 29 Appendix D 4 BACnet Specific Statistics 32 ...

Page 4: ...setup BACnet requires one Device Object to be present in every BACnet device The Device Object makes information about the device and its capabilities available to other devices on the networks Before one BACnet device starts control related communications with another it needs to obtain some of the information presented by the other device s Device Object Unlike other Objects the Device Object s ...

Page 5: ...m Tel 408 262 2299 Fax 408 262 9042 Toll Free 888 509 1970 email support fieldserver com 2 DRIVER SCOPE OF SUPPLY 2 1 Supplied by FieldServer Technologies for this Driver FieldServer Technologies PART Description FS 8917 03 Connector adapter DB9M to DCE RTS CTS DSR DTR 2 2 Provided by supplier of 3rd party equipment PART Description BACnet Controller ...

Page 6: ...t in the configuration file Configure the Device according to manufacturer s instructions FUNCTION FROM TO COLOUR RX RJ45 01 DB9M 02 GREY CTS RJ45 02 DB9M08 BROWN DSR RJ45 03 DB9M 06 YELLOW GND RJ45 04 DB9M 05 GREEN GND RJ45 05 RED TX RJ45 08 DB9M 03 BLUE RTS RJ45 07 DB9M 07 ORANGE DTR RJ45 06 DB9M 04 BLACK 8917 03 WIRE LIST 8917 03 8917 03 FieldServer Connect to one of the RS 232 Ports on the Fie...

Page 7: ...ommunications the driver independent FieldServer buffers need to be declared in the Data Arrays section the destination 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 4 1 Data Arrays Descriptors Note that in the tables indicates an...

Page 8: ...D BACnet_PTP 11 4 3 Client Side Connection Descriptions Section Title Connections Column Title Function Legal Values Port Port Name P1 P8 2 Baud Specify baud rate 110 300 600 1200 2400 4800 9600 19200 38400 57600 115000 Parity Specify parity Odd Even None Data_Bits Specify data bits 7 8 Stop_Bits Specify stop bits 1 2 Protocol Specify Protocol Used BACnet_PTP Example Client Side Connections Connec...

Page 9: ...09 1970 email support fieldserver com 4 4 Client Side Node Descriptors Section Title Nodes Column Title Function Legal Values Node_Name Provide name for Node Up to 32 alphanumeric characters Node_ID Specify the BACnet Device object instance 1 16777215 Protocol Specify protocol used BACnet_PTP Port Specify port P1 P8 Example Client Side Nodes Nodes Node_Name Node_ID Protocol Port DEV_1 1 BACnet_PTP...

Page 10: ...pendix D 1 for more information AI AO AV BI BO BV MI MO MV NC Object_Instance Alias Address Instance of the object on the device 0 1 2 3 4194303 Property The BACnet property to be read Refer to Appendix D 2 Data_Array_Low_Scale Scaling zero in Data Array 32767 to 32767 0 Data_Array_High_Scale Scaling max in Data Array 32767 to 32767 100 Node_Low_Scale Scaling zero in Connected Node 32767 to 32767 ...

Page 11: ...Value 20 000s CMD_AI_03 DA_AI_01 2 Rdbc DEV_1 AI 3 Present_Value 20 000s CMD_AO_01 DA_AO_01 0 Rdbc DEV_1 AO 1 Present_Value 30 000s CMD_AO_02 DA_AO_01 1 Rdbc DEV_1 AO 2 Present_Value 30 000s CMD_AO_03 DA_AO_01 2 Rdbc DEV_1 AO 3 Present_Value 30 000s Map_Descriptors Map_Descriptor_Name Data_Array_Name Data_Array_Offset Function Node_Name Data_Type Object_Instance Property Scan_Interval CMD_DI_01 DA...

Page 12: ...e 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 Map Descriptors section Details on how to do this can be found below Note that in the tables indicates an optional parameter with the bold legal value being the default 5 1 Driver Specific FieldServer Parameters Section Title Bridge Column Title Function Legal ...

Page 13: ... Baud Specify baud rate 110 300 600 1200 2400 4800 9600 19200 38400 57600 115000 Parity Specify parity None Odd Even Data_Bits Specify data bits 7 8 Stop_Bits Specify stop bits 1 2 Protocol Specify protocol used BACnet_PTP Example Server Side Connections Connections Port Baud Parity Data_Bits Stop_Bits Protocol P1 9600 Even 7 1 BACnet_PTP 5 4 Server Side Node Descriptors Section Title Nodes Column...

Page 14: ...criptors 5 5 1 FieldServer Specific Map Descriptor Parameters Column Title Function Legal Values Map_Descriptor_Name Name of this Map Descriptor This is used for Object_Name Property Refer to Appendix A 1 Up to 32 alphanumeric characters Data_Array_Name Name of Data Array where data is to be stored in the FieldServer One of the Data Array names from Data Arrays section Data_Array_Offset Starting l...

Page 15: ...bject Any text string of length up to 40 characters Inactive Relinquish_Default 5 Specify the value to be returned as Present_Value on startup or when control is relinquished Must be specified for outputs Refer to Appendix D 2 Any Float value Length Used to create an array of sequential Object_Instances on an Object_Type 1 to max point count of the FieldServer 1 Notification_Class Specify the Mapd...

Page 16: ...11 AI 2 Degrees Fahrenheit SMD_AI_03 DA_AI_01 2 Passive Virtual_DEV_11 AI 3 Degrees Fahrenheit SMD_AO_01 DA_AO_01 0 Passive Virtual_DEV_11 AO 1 percent relative humidity SMD_AO_02 DA_AO_01 1 Passive Virtual_DEV_11 AO 2 percent relative humidity SMD_AO_03 DA_AO_01 2 Passive Virtual_DEV_11 AO 3 percent relative humidity Map_Descriptors Map_Descriptor_Name Data_Array_Name Data_Array_Offset Function N...

Page 17: ...g a combination of it s network number and IP MAC address The default Network number of a FieldServer is 5 If there is more than one FieldServer on a BACnet intranet with multiple nodes the default network number of the additional FieldServers will need to be changed and a unique number allocated to each A unique network number will need to be assigned if both of the following conditions are true ...

Page 18: ...a_Type Object_ID Property Array_Index CMD_AI_01 DA_AI_01 0 Rdbc DEV_01 AO 1 Priority_Array 7 Details of the relevant BACnet properties and their associated arrays can be found in the BACnet Protocol Spec Appendix A 4 FieldServer implementation of BACnet priority Arrays When BACnet Output objects are written to the Server side of the FieldServer an associated write priority is given to each write v...

Page 19: ...riority Array Table will be stored Location 0 is the Relinquish Default value and locations 1 to 16 the different entries of the Priority Array Table Up to 16 alphanumeric characters DA_Pri_Array_Offset Starting location in Data Array 1 65535 0 DA_Pri_In_Use Name of Data Array that indicates if a particular Priority Value is in use Location 0 indicates whether the Relinquish Default has been set a...

Page 20: ... a BACnet Server it is necessary to define the State_Text property This section illustrates how to define the State_Text character strings and how to associate these definitions with Multistate Server Map Descriptors The maximum permitted length of any State_Text string is 50 characters Appendix A 5 1 Method 1 Using an Offset User Table set up a look up table Offset_Table Offset_Table_Name Table_S...

Page 21: ...thod 2 Using a Single Data Array Data_Arrays Data_Array_Name Data_Format Data_Array_Length DA_MI_01 UINT16 100 DA_STATE_TXT BYTE 200 Preloads Data_Array_Name Preload_Data_Value Preload_Data_Format Preload_Data_Index DA_STATE_TXT MyState1 MyState2 MyState3 MyState4 MyState5 MyState6 String 0 Map_Descriptors Map_Descriptor_Name Data_Type Object_ID Function Data_Array_Name Node_Name Length State_Text...

Page 22: ...er will treat a value of zero as a normal value i e not as an alarm or fault value Appendix A 6 COV and Intrinsic Reporting The COV Change of Value and Intrinsic Reporting services are two distinct ways in which point values can be reported to a client workstation as they change i e in an event driven opposed to a polling method This can increase performance dramatically compared to polling method...

Page 23: ...If it is not set the COV_Increment defaults to zero COV Notifications are generated for all data objects for which a remote client has issued a SubscribeCOV Request The SubscribeCOV Request regulates whether Notifications are Confirmed or Unconfirmed The remote Client may also write the COV_Increment property in order to control the deadband for changes in analog values The COV_Increment property ...

Page 24: ... 10 Yes 1 0 Appendix A 6 4 Map Descriptor Example Intrinsic Reporting Notification class Objects Map_Descriptors Map_Descriptor_Name Data_Array_Name Data_Array_Offset Function Node_Name Object_Type Object_Instance Ack_Required SMC_NC_01 DA_NC_01 0 Passive Virtual_DEV_11 NC 1 Yes SMC_NC_02 DA_NC_01 1 Passive Virtual_DEV_11 NC 2 No Map_Descriptors Map_Descriptor_Name Data_Array_Name Data_Array_Offse...

Page 25: ... Name on the BACnet SCADA system then the FieldServer is not communicating with the SCADA system If the Device Object s name is being indicated but the Present_Value shows question marks then it is likely that the Client side of the FieldServer is not communicating Extra memory is required to store Map Descriptors that have the active inactive text parameters specified If the defaults are appropri...

Page 26: ...of a RTS to DB9M convertor This is available form FST Part FS 8917 02 Appendix C 3 Liebert Polling BACnet addresses that are not configured for Liebert systems may cause the connection to fail in older versions of Liebert Please contact your Liebert supplier for more information Appendix C 4 Automated Logic Corporation When an ALC module is powered up and it does not detect valid BACnet MSTP traff...

Page 27: ... string describing a BACnet object This can be defined by the user to give additional detail about the Object Out_of_service The Out_Of_Service property of type BOOLEAN is an indication whether TRUE or not FALSE the physical input that the object represents is not in service This means that the Present_Value property is decoupled from the physical input and will not track changes to the physical i...

Page 28: ...an MS TP network The value of Max_Master specifies the highest possible address for master nodes and shall be less than or equal to 127 If the Max_Master property is not writeable via BACnet services its value shall be 127 Max_Info_Frames Relevant to BACnet MS TP Device Object Type The Max_Info_Frames property of type Unsigned shall be present if the device is a node on an MS TP network The value ...

Page 29: ...eet per minute cubic feet per seconds cubic meters cubic meters per hour cubic meters per seconds Currency1 Currency2 Currency3 Currency4 Currency5 Currency6 Currency7 Currency8 Currency9 Currency10 cycles per hour cycles per minute days degrees angular Degrees Celsius Deg C Deg_C degrees Celsius per hour degrees Celsius per minute Degrees days Celsius Degrees days Fahrenheit Degrees Fahrenheit De...

Page 30: ...grams Kg kilograms per hour kilograms per minute kilograms per second Kilohertz KHz kilohms Kilojoules kilojoules per kilogram kilometers per hour Kilopascals KPa kilovolt amperes kilovolt amps KVA kilovolt amperes reactive KVAR kilovolts kilowatt hour per square foot kilowatt hour per square meter kilowatt hours KWh kilowatts KW liters liters per hour liters per minute liters per second lumens lu...

Page 31: ...meter percent per second percent relative humidity RH RH Percent RH PercentRH Per hour per minute per second pounds force per square inch PSI pounds force per sq inch Pounds mass pounds mass per hour pounds mass per minute pounds mass per second Power Factor PF psi per degrees fahrenheit radians revolutions per minute seconds Secs S square centimeters square feet square inches square meters Therms...

Page 32: ... properties of a particular object to determine which properties are supported Segmentation Not Supported Data was requested but the response would have exceeded the maximum size of the APDU and could not be sent using an un segmented message This is not an error the BACnet client will use a different method to read data from the FieldServer Sequence Error Invoke ID of a reply did not match the In...

Reviews: