FieldServer FS-8704-06 User Manual

Driver Version:
1.16
A Sierra Monitor Company
Driver Manual
(Supplement to the FieldServer Instruction Manual)
APPLICABILITY & EFFECTIVITY
Effective for all systems manufactured after September 2008
Document Revision: 0
FS-8704-06 BACnet IP Driver Manual Table of Contents
TABLE OF CONTENTS
1.
BACNET IP DESCRIPTION ..............................................................................................................3
2.
DRIVER SCOPE OF SUPPLY........................................................................................................... 3
2.1.
Supplied by FieldServer Technologies for this driver .................................................................. 3
2.2.
Provided by the Supplier of 3rd Party Equipment......................................................................... 3
2.2.1. Hardware .................................................................................................................................3
3.
HARDWARE CONNECTIONS ..........................................................................................................4
4.
CONFIGURING THE FIELDSERVER AS A BACNET IP CLIENT ................................................... 5
4.1.
Data Arrays/Descriptors...............................................................................................................5
4.2.
Client Side Connection Descriptions ........................................................................................... 6
4.3.
Client Side Node Descriptors.......................................................................................................6
4.4.
Client Side Map Descriptors ........................................................................................................ 7
4.4.1. FieldServer Related Map Descriptor Parameters ................................................................... 7
4.4.2. Driver Related Map Descriptor Parameters ............................................................................7
4.4.3. Timing Parameters .................................................................................................................. 7
4.4.4. Map Descriptor Example ......................................................................................................... 8
5.
CONFIGURING THE FIELDSERVER AS A BACNET IP SERVER ................................................. 9
5.1.
Driver Specific FieldServer Parameters ......................................................................................9
5.2.
Server Side Connection Descriptors ...........................................................................................9
5.3.
Server Side Node Descriptors ................................................................................................... 10
5.4.
Server Side Map Descriptors..................................................................................................... 10
5.4.1. FieldServer Specific Map Descriptor Parameters .................................................................10
5.4.2. Driver Specific Map Descriptor Parameters .......................................................................... 11
5.5.
Map Descriptor Example ........................................................................................................... 12
APPENDIX A.
Appendix A.1.
APPENDIX B.
Appendix B.1. Appendix B.2. Appendix B.3. Appendix B.4. Appendix B.5. Appendix B.6. Appendix B.7.
APPENDIX C.
Appendix C.1. Appendix C.2.
APPENDIX D.
DRIVER NOTES ........................................................................................................... 13
Data_Type Legal Values – Abbreviation Descriptions ............................................. 13
ADVANCED TOPICS ................................................................................................... 14
BACnet object names...............................................................................................14
BACnet Priority Arrays ............................................................................................. 14
Limitations of the BACnet Read_Property_Multiple service. ...................................14
IP Address Issues related to BACnet IP ..................................................................15
Network number ....................................................................................................... 15
Using BBMD .............................................................................................................15
BACnet State Text Preload ......................................................................................20
TROUBLESHOOTING TIPS ........................................................................................ 21
Debugging a BACnet connection ............................................................................. 21
BACnet Specific Statistics ........................................................................................ 21
UNITS ........................................................................................................................... 22
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: support@fieldserver.com
FS-8704-06 BACnet IP Driver Manual Page 3 of 24
1. BACnet IP Description
The BACnet/IP driver allows the FieldServer to transfer data to and from devices over Ethernet using BACnet/IP protocol. The FieldServer can emulate either a Server or Client.
The information that follows describes how to expand upon the factory defaults provided in the configuration files included with the FieldServer.
2. Driver Scope of Supply
2.1. Supplied by FieldServer Technologies for this driver
FieldServer Technologies PART #
FS-8915-10 UTP cable (7 foot) for Ethernet connection1
Description
2.2. Provided by the Supplier of 3rd Party Equipment
2.2.1. Hardware
Part # Description
Ethernet 10/100 BaseT hub2
1
This cable is necessary for connection to the driver. It is shipped with the FieldServer and not
separately with the driver.
2
Not all FieldServer models support 100BaseT. Consult the appropriate instruction manual for details of
the Ethernet speed supported by specific hardware.
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: support@fieldserver.com
FS-8704-06 BACnet IP Driver Manual Page 4 of 24
04
3. Hardware Connections
It is possible to connect a BACnet/IP device using the N1 or the N23 network ports. These ports need to be configured for BACnet/IP in the configuration file.
Configure the Controller according to manufacturer’s instructions
Controller
Ethernet Interface
SITE
ETHERNET
FS-8915-10
FS-8915-10
(408)-262-2299
FIELDSERVER
BACNET IP
CONNECTION DIAGRAM
BASE NAME: FILE NAME:
3
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction
DATE: 12/28/ BY: MC
manual for details of the ports available on specific hardware.
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: support@fieldserver.com
FS-8704-06 BACnet IP Driver Manual Page 5 of 24
4. Configuring the FieldServer as a BACnet IP Client
For a detailed discussion on FieldServer configuration, please refer to the FieldServer Configuration Manual. The information that follows describes how to expand upon the factory defaults provided in the configuration files included 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 BACnet/IP Server.
4.1. Data Arrays/Descriptors
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In order to enable the FieldServer for BACnet/IP communications, 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.
Note that in the tables, * indicates an optional parameter, with the bold legal value being the default.
Section Title
Data_Arrays
Column Title Function Legal Values
Data_Array_Name Provide name for Data Array
Data_Array_Format
Data_Array_Length
Example
// Data Arrays
Provide data format. Each Data Array can only take on one format.
Number of Data Objects. Must be larger than the data storage area required by the Map Descriptors for data placed in this array.
Up to 15 alphanumeric characters Float, Bit, Uint16, Uint32, Sint16, Sint32, Packed_Bit, Byte, Packed_Byte, Swapped_Byte
1-10,000
Data_Arrays Data_Array_Name, Data_Array_Format, Data_Array_Length DA_AI_01, Float, 200 DA_AO_01, Float, 200 DA_DI_01, Bit, 200 DA_DO_01, Bit, 200
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: support@fieldserver.com
FS-8704-06 BACnet IP Driver Manual Page 6 of 24
4.2. Client Side Connection Descriptions
Section Title
Adapter
Column Title Function Legal Values
Adapter Adapter Name N1, N24 Protocol Specify protocol used BACnet_IP Poll_Delay* Time between internal polls
IP_Port*
Example
// Client Side Connections
Specify the UDP port that will be used to communicate with other BACnet Client devices.
0-32000s; 0.25s Any legal IP port value (1 - 65535); 47808
Connections Adapter, Protocol, Poll_Delay N1, Bacnet_IP, 0.500s
4.3. Client Side Node Descriptors
Section Title
Nodes
Column Title
Node_Name Provide name for Node
Node_ID
Protocol Specify protocol used BACnet_IP Adapter Specify port Adapter used
Example
// Client Side Nodes
BACnet station address of physical Server node
Function Legal Values
Up to 32 alphanumeric characters
1 - 4194303
N1, N24
Nodes Node_Name, Node_ID, Protocol, Adapter BCU_01, 1, Bacnet_IP, N1
4
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction
manual for details of the ports available on specific hardware.
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: support@fieldserver.com
FS-8704-06 BACnet IP Driver Manual Page 7 of 24
4.4. Client Side Map Descriptors
4.4.1. FieldServer Related Map Descriptor Parameters
Section Title
Map Descriptors
Column Title Function Legal Values
Map_Descriptor_Name Name of this Map Descriptor
Name of Data Array where
Data_Array_Name
Data_Array_Offset Starting location in Data Array 0 to (“Data_Array_Length” -1)
Function
data is to be stored in the FieldServer
Function of Client Map Descriptor
Up to 32 alphanumeric characters
One of the Data Array names from “Data Array” section above
Rdbc, Wrbc, Wrbx, Ars
4.4.2. Driver Related Map Descriptor Parameters
Section Title
Map Descriptors
Column Title Function Legal Values
One of the Node_Names
Node_Name Name of remote Server Node.
Data_Type Data type
Object_ID Address of the object 0, 1, 2, 3, …4194303 Property* The BACnet property to be read
Data_Array_Low_Scale* Scaling zero in Data Array
Data_Array_High_Scale* Scaling max in Data Array
Node_Low_Scale* Scaling zero in Connected Node Node_High_Scale* Scaling max in Connected Node
Allows the driver to specify the
Write_Priority*
Custom Type
Custom_Prop
write priority used to write an output. See also Appendix B.2 This over-writes the Data_Type with a numerical value for the Data_Type. e.g. Analog Value = 2 This over-writes the Property with a numerical value for the property. e.g. Present Value = 85
specified in “Client Side Node Descriptors” above AI, AO, AV, BI, BO, BV, MI, MO, MV5
Present_Value
-32767 to 32767, 0
-32767 to 32767, 100
-32767 to 32767, 0
-32767 to 32767, 100
1..16, 16
1..1023
1..4194303
4.4.3. Timing Parameters
Section Title
Map Descriptors
Column Title Function Legal Values
Scan_Interval* Rate at which data is polled
5
Refer to Appendix A.1 for further information.
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: support@fieldserver.com
0-32000s, 2s
20.000s
20.000s
20.000s
30.000s
30.000s
30.000s
15.000s
15.000s
15.000s
30.000s
30.000s
30.000s
Property, Scan_Interval
Object_ID,
Data_Type,
Node_Name,
Property, Scan_Interval
Object_ID,
Data_Type,
Node_Name,
Data_Array_Offset, Function,
Data_Array_Name,
Data_Array_Offset, Function,
Data_Array_Name,
Tel: (408) 262 2299 Fax: (408) 262 2269 Toll Free: (888) 509 1970 email: support@fieldserver.com
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
4.4.4. Map Descriptor Example
FS-8704-06 BACnet IP Driver Manual Page 8 of 24
// Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
CMD_AI_01, DA_AI_01, 0, Rdbc, BCU_01, AI, 1, Present_Value,
CMD_AI_02, DA_AI_01, 1, Rdbc, BCU_01, AI, 2, Present_Value,
CMD_AI_03, DA_AI_01, 2, Rdbc, BCU_01, AI, 3, Present_Value,
CMD_AO_01, DA_AO_01, 0, Rdbc, BCU_01, AO, 1, Present_Value,
CMD_AO_02, DA_AO_01, 1, Rdbc, BCU_01, AO, 2, Present_Value,
CMD_AO_03, DA_AO_01, 2, Rdbc, BCU_01, AO, 3, Present_Value,
Map_Descriptors
Map_Descriptor_Name,
CMD_DI_01, DA_DI_01, 0, Rdbc, BCU_01, DI, 1, Present_Value,
CMD_DI_02, DA_DI_01, 1, Rdbc, BCU_01, DI, 2, Present_Value,
CMD_DI_03, DA_DI_01, 2, Rdbc, BCU_01, DI, 3, Present_Value,
CMD_DO_01, DA_DO_01, 0, Rdbc, BCU_01, DO, 1, Present_Value,
CMD_DO_02, DA_DO_01, 1, Rdbc, BCU_01, DO, 2, Present_Value,
CMD_DO_03, DA_DO_01, 2, Rdbc, BCU_01, DO, 3, Present_Value,
Loading...
+ 16 hidden pages