A Sierra Monitor Company
Driver Manual
(Supplement to the FieldServer Instruction Manual)
FS-8704-02 BACnet Ethernet
APPLICABILITY & EFFECTIVITY
Effective for all systems manufactured after May 1, 2001
Driver Version:
1.15
Document Revision: 17
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 3 of 20
1.
BACnet Ethernet Description
The BACnet Ethernet driver allows the FieldServer to transfer data to and from devices over
Ethernet using BACnet Ethernet 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.
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 4 of 20
2.
Driver Scope of Supply
2.1. Supplied by FieldServer Technologies for this driver
FieldServer Technologies
PART #
Description
FS-8915-10
FS-8704-02
UTP cable (7 foot) for Ethernet connection
Driver Manual
2.2.
2.2.1.
Provided by the Supplier of 3rd Party Equipment
Hardware
Part #
Trane Building Control Unit (BCU)
Description
Building control unit (BCU) with internal
Ethernet adapter.
Ethernet 10/100 BaseT hub∗
∗ Not all FieldServer models support 100BaseT. Consult the appropriate instruction manual for details of
the Ethernet speed supported by specific hardware.
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 5 of 20
3.
Hardware Connections
It is possible to connect a BACnet Ethernet device using the N1 or the N2 network ports. These
ports just need to be configured for BACnet Ethernet in the configuration file.
Configure the Controller according to manufacturer’s instructions
Controller
Ethernet Interface
SITE
FS-8915-10
ETHERNET
FS-8915-10
(408)-262-2299
FIELDSERVER
BACNET ETHERNET
CONNECTION DIAGRAM
BASE NAME:
FILE NAME:
DATE: 6/29/04
BY: MC
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 6 of 20
4.
Configuring the FieldServer as a BACnet Ethernet 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 Ethernet Server.
4.1.
Data Arrays
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
Up to 15 alphanumeric
characters
Data_Array_Name
Provide name for Data Array
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
the data being placed in this array.
Data_Array_Format
Data_Array_Length
FLOAT, BIT
1-10,000
Example
// Data Arrays
Data_Arrays
Data_Array_Name,
DA_AI_01,
DA_AO_01,
DA_DI_01,
Data_Format,
Float,
Float,
Bit,
Bit,
Data_Array_Length
200
200
200
200
DA_DO_01,
4.2.
Client Side Connection Descriptions
Section Title
Adapter
Column Title
Function
Legal Values
Adapter
Adapter Name
N1, N21
Protocol
Poll Delay*
Specify protocol used
Time between internal polls
Bacnet_Eth
0-32000s; 0.500s
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.
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 7 of 20
Example
// Client Side Connections
Connections
Adapter,
N1,
Protocol,
Bacnet_Eth,
Poll_Delay
0.500s
4.3.
Client Side Node Descriptors
Section Title
Nodes
Column Title
Function
Legal Values
Up to 32 alphanumeric
characters
Node_Name
Node_ID
Provide name for node
BACnet station address of physical
Server node
1-16777215
Protocol
Adapter
Specify protocol used
Specify port Adapter used
Bacnet_Eth
N1
Example
// Client Side Nodes
Nodes
Node_Name,
BCU_01,
Node_ID,
1,
Protocol,
Bacnet_Eth,
Adapter
N1
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 8 of 20
4.4.
4.4.1.
Client Side Map Descriptors
FieldServer Related Map Descriptor Parameters
Column Title
Function
Name of this Map
Descriptor
Legal Values
Up to 32 alphanumeric
characters
Map_Descriptor_Name
Name of Data Array where
data is to be stored in the
FieldServer
One of the Data Array names
from “Data Array” section
above
Data_Array_Name
Starting location in Data
Array
Function of Client Map
Descriptor
0 to maximum specified in
“Data Array” section above
Data_Array_Offset
Function
RDBC
4.4.2.
Driver Related Map Descriptor Parameters
Column Title
Function
Name of Node to
fetch data from
Data type
The BACnet
property to be read
Legal Values
One of the node names specified in
“Client Node Descriptor” above
Note 2
Node_Name
Data_Type
Property
Present_Value
Scaling zero in
Data Array
Data_Array_Low_Scale*
Data_Array_High_Scale*
-32767 to 32767, 0
-32767 to 32767, 10000
Scaling max in Data
Array
Scaling zero in
Connected Node
Scaling max in
Connected Node
Node_Low_Scale*
Node_High_Scale*
-32767 to 32767, 0
-32767 to 32767, 100
4.4.3.
Timing Parameters
Column Title
Scan_Interval
Function
Legal Values
Rate at which data is polled 0-32000s, 20s
Note 2
AI
- ANALOG INPUT
BV - BINARY_VALUE
AO - ANALOG_OUTPUT
AV - ANALOG_VALUE
MI
- MULTI_STATE_INPUT
MO - MULTI_STATE_OUTPUT
BI
- BINARY_INPUT
MV - MULTI_STATE_VALUE
BO - BINARY_OUTPUT
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 9 of 20
4.4.4.
Map Descriptor Examples
// Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_Name, Data_Type, Object_ID, Property,
Scan_Interval
CMD_AI_01,
CMD_AI_02,
CMD_AI_03,
CMD_AO_01,
CMD_AO_02,
CMD_AO_03,
Map_Descriptors
DA_AI_01,
DA_AI_01,
DA_AI_01,
DA_AO_01,
DA_AO_01,
DA_AO_01,
0,
1,
2,
0,
1,
2,
RDBC,
RDBC,
RDBC,
RDBC,
RDBC,
RDBC,
BCU_01,
BCU_01,
BCU_01,
BCU_01,
BCU_01,
BCU_01,
AI,
AI,
AI,
AO,
AO,
AO,
1,
2,
3,
1,
2,
3,
Present_Value, 20.000s
Present_Value, 20.000s
Present_Value, 20.000s
Present_Value, 30.000s
Present_Value, 30.000s
Present_Value, 30.000s
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_Name, Data_Type, Object_ID,
Property,
Scan_Interval
CMD_DI_01,
CMD_DI_02,
CMD_DI_03,
CMD_DO_01,
CMD_DO_02,
CMD_DO_03,
DA_DI_01,
DA_DI_01,
DA_DI_01,
DA_DO_01,
DA_DO_01,
DA_DO_01,
0,
1,
2,
0,
1,
2,
RDBC,
RDBC,
RDBC,
RDBC,
RDBC,
RDBC,
BCU_01,
BCU_01,
BCU_01,
BCU_01,
BCU_01,
BCU_01,
DI,
DI,
DI,
DO,
DO,
DO,
1,
2,
3,
1,
2,
3,
Present_Value, 15.000s
Present_Value, 15.000s
Present_Value, 15.000s
Present_Value, 30.000s
Present_Value, 30.000s
Present_Value, 30.000s
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 10 of 20
5.
Configuring the FieldServer as a BACnet Ethernet Server
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” files on the
driver CD).
This section documents and describes the parameters necessary for configuring the FieldServer
to communicate with a BACnet Ethernet Client
The configuration file tells the FieldServer about its interfaces, and the routing of data required.
In order to enable the FieldServer for BACnet Ethernet 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 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.
Data Arrays
Section Title
Data_Arrays
Column Title
Data_Array_Name
Data_Format
Function
Provide name for Data Array
Provides data format
Legal Values
Up to 15 alphanumeric characters
FLOAT, BIT
Data_Array_Length Number of Data Objects
1-10,000
Example
// Data Arrays
Data_Arrays
Data_Array_Name,
DA_AI_01,
DA_AO_01,
DA_DI_01,
Data_Format,
Float,
Float,
Bit,
Bit,
Data_Array_Length
200
200
200
200
DA_DO_01,
5.2.
Server Side Connection Descriptors
Section Title
Connections
Column Title
Adapter
Protocol
Function
Adapter Name
Specify protocol used
Legal Values
N1
Bacnet_Eth
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 11 of 20
Example
// Server Side Connections
Connections
Adapter,
N1,
∗
Protocol
Bacnet_Eth
5.3.
Server Side Node Descriptors
Section Title
Nodes
Column Title
Function
Provide name for node
Legal Values
Up to 32 alphanumeric
characters
Node_Name
BACnet station address of physical
Server node
Specify protocol used
Node_ID
Protocol
1-16777215
Bacnet_Eth
Example
// Server Side Nodes
Nodes
Node_Name,
Virtual_BCU_11,
Node_ID,
11,
Protocol
Bacnet_Eth
∗ Note that no connection information is necessary on Server side.
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 12 of 20
5.4.
5.4.1.
Server Side Map Descriptors
FieldServer Specific Map Descriptor Parameters
Column Title
Function
Name of this Map
Descriptor
Legal Values
Up to 32 alphanumeric
characters
Map_Descriptor_Name
Name of Data Array where
data is to be stored in the
FieldServer
One of the Data Array
names from “Data Array”
section above
Data_Array_Name
Starting location in Data
Array
Function of Server Map
Descriptor
0 to maximum specified in
“Data Array” section above
Data_Array_Offset
Function
Server
5.4.2.
Driver Specific Map Descriptor Parameters
Column Title
Function
Legal Values
One of the node names
specified in “Server Node
Descriptor” above
Note 2
Name of Node to fetch
data from
Node_Name
Data_Type
Object_ID
Data type in PLC
Address of the object
The object property to
read
0, 1, 2, 3, …
Property
Present value
See Error! Reference source
not found.
Units
The object units
Scaling zero in Data
Array
Scaling max in Data
Array
Scaling zero in
Connected Node
Data_Array_Low_Scale*
Data_Array_High_Scale*
Node_Low_Scale*
Node_High_Scale*
Active_Text2
-32767 to 32767, 0
-32767 to 32767, 100
-32767 to 32767, 0
Scaling max in
-32767 to 32767, 100
Any legal BACnet ASCII string
Any legal BACnet ASCII string
Connected Node
Specify the Active Text
property of the Object
Specify the Inactive Text
property of the Object
Specify the startup
Relinquish_Default
Property value for this
Inactive_Text1
Relinquish_Default1
Any legal BACnet ASCII string
Note 2
AI
- ANALOG INPUT
BV - BINARY_VALUE
AO - ANALOG_OUTPUT
MI
- MULTI_STATE_INPUT
AV - ANALOG_VALUE
MO - MULTI_STATE_OUTPUT
BI
- BINARY_INPUT
MV - MULTI_STATE_VALUE
BO - BINARY_OUTPUT
DI
- DIGITAL_INPUT
DO - DIGITAL_OUTPUT
2 See the BACnet DFS to determine if a particular object supports this property
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 13 of 20
Object
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 14 of 20
5.4.3.
Map Descriptor Example
// Server Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
SMD_AI_01,
SMD_AI_02,
Data_Array_Name,
Data_Array_Offset,
Function,
Node_Name,
Object_Type,
AI,
AI,
AI,
AO,
AO,
AO,
Object_Instance
Property,
Units,
Relinquish_Default
-
-
-
0
0
0
DA_AI_01,
DA_AI_01,
DA_AI_01,
DA_AO_01,
DA_AO_01,
DA_AO_01,
0,
1,
2,
0,
1,
2,
Server,
Server,
Server,
Server,
Server,
Server,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
1,
2,
3,
1,
2,
3
Present_Value,
Present_Value,
Present_Value,
Present_Value,
Present_Value,
Present_Value,
Degrees-Fahrenheit,
Degrees-Fahrenheit,
Degrees-Fahrenheit,
percent-relative-humidity,
percent-relative-humidity,
percent-relative-humidity,
SMD_AI_03,
SMD_AO_01,
SMD_AO_02,
SMD_AO_03,
// Server Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
SMD_DI_01,
SMD_DI_02,
Data_Array_Name,
Data_Array_Offset,
Function,
Server,
Server,
Server,
Server,
Server,
Server,
Node_Name,
Object_Type,
DI,
DI,
DI,
DO,
DO,
DO,
Object_Instance,
Property
Relinquish_Default
-
-
-
0
0
0
DA_DI_01,
DA_DI_01,
DA_DI_01,
DA_DO_01,
DA_DO_01,
DA_DO_01,
0,
1,
2,
0,
1,
2,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
Virtual_BCU_11,
1,
2,
3,
1,
2,
3,
Present_Value
Present_Value
Present_Value
Present_Value
Present_Value
Present_Value
SMD_DI_03,
SMD_DO_01,
SMD_DO_02,
SMD_DO_03,
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 15 of 20
Appendix A. Advanced Topics
Appendix A.1. BACnet Object Names
When an external BACnet Client builds a list of Object Names, the BACnet Server Map
Descriptor name determines the BACnet Object Name. If the Map Descriptor length is
greater than 1, then the Object Name will be suffixed with the index into the Map Descriptor.
For example, if the Map Descriptor name is SMD_AI_01 and the length 3, then the Object
Names will be SMD_AI_01[0], SMD_AI_01[1] and SMD_AI_01[2].
Appendix A.2. FieldServer implementation of BACnet priority Arrays
When writing to a BACnet Output Object, a write priority value must be specified. When the
FieldServer receives the write value, it will be stored 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.
Appendix A.3. Accessing Priority Array information from other protocol
drivers
The Priority Array table and its “In_Use” (or Not Relinquished) state are stored internally to
every Map Descriptor, and cannot be accessed directly. If the following data arrays are
specified, however, they will maintain an exact copy of the Priority Array Table for the Map
Descriptor. Thus the Priority Array Table can be accessed.
Section Title
Map_Descriptors
Column Title
Function
Legal Values
Name of Data Array where the Priority 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.
Starting location in Data Array.
Name of Data Array that indicates if a
particular Priority Values is in use. Location 0
indicate if the Relinquish Default has been set
and locations 1 to 16 indicate if the index is in
use (1), or if it has been Relinquished (0).
Up to 16
alphanumeric
characters
DA_Pri_Array
DA_Pri_Array_Offset
DA_Pri_In_Use
1-65535 (17)
Up to 16
alphanumeric
characters
DA_Pri_In_Use_Offset Starting location in Data Array.
1-65535 (17)
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 16 of 20
Appendix B. Troubleshooting
Appendix B.1. Debugging a BACnet connection: Hints and tips
•
Disconnect the FieldServer from the BACnet network when transferring BCU images to the
BCU.
•
Should duplicate object instances be accidentally configured in the FieldServer, the second
call of the instance will overwrite the first one. This may result in a BACnet Object being
“lost.”
•
If “Virtual_BCU_…” is not being indicated as the device description for the FieldServer on the
BACnet SCADA system, then the FieldServer is not communicating to the SCADA system.
If the present value’s name is being indicated, but the present value shows question marks,
then it is most likely that the Client side of the FieldServer is not communicating.
If new points are added to the FieldServer it is important to restart the Summit Workstation or
BCU, otherwise these new points might not be seen by the FieldServer.
Poll only the BACnet addresses that exist in the device when communicating with
Liebert systems. Polling addresses that are not configured in these systems will cause
the connection to fail. The newer versions of Lieberts do not suffer from this problem.
Please contact your Lieberts supplier for more information.
•
•
•
•
Extra memory is required to store Map Descriptors that have the active/inactive text
parameters specified. If the defaults are appropriate, do not specify these parameters.
This will save memory and allow more Map Descriptors to be created
Appendix B.2. BACnet Specific Statistics
Stat
Description
Resolution
It is normal to receive a few link control
messages. If the number is higher than the
transmit/receive messages, however, there
may be a problem with lost
A “who-is” link control message
was sent or received.
Link Control
communications..
This is not an error. BACnet clients often
poll all properties of a particular object to
determine which properties are supported.
Unsupported
Properties
A request for an unsupported
property was received.
Data was requested but the
response would have exceeded the This is not an error - the BACnet client will
Segmentation
Not Supported
maximum size of the APDU and
could not be sent using an un-
segmented message.
use a different method to read data from
the FieldServer.
Invoke ID of a reply did not match
the Invoke ID of the poll.
You should not see this message. It
normally indicates a configuration error.
This typically happens when trying to write
to an Input Object that is not Out-Of-
Service. It is not possible to write to Input
Objects.
Sequence Error
Write Access
Denied
A write to an object was denied.
This may be a problem on the Client
system. Consult the PIC statement to
determine what services are supported.
Exception
Errors
A BACnet Service was denied
because it is not supported
FS-8704-02_BacnetEthernet.doc Driver Manual
Appendix C. Units
Page 17 of 20
Variation 3
Unit
Variation 1
Variation 2
Amperes
Amps
A
Bars
BTUs
BTUs-per-hour
btus-per-pound
btus-per-pound-dry-air
centimeters
centimeters-of-mercury
centimeters-of-water
cubic-feet
cubic-feet-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
degrees-celsius-per-hour
degrees-celsius-per-minute
Degrees-days-Celsius
Degrees-days-Fahrenheit
Degrees-Fahrenheit
degrees-fahrenheit-per-hour
degrees-fahrenheit-per-minute
Degrees-Kelvin
degrees-phase
delta-degrees-fahrenheit
delta-degrees-kelvin
feet
Deg-C
Deg_C
Deg-F
Deg-K
Deg_F
Deg_K
feet-per-minute
feet-per-second
foot-candles
grams-water-per-kg-dry-air
hectopascals
Hertz
Hz
Horsepower
HP
hours
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 18 of 20
Variation 3
Unit
Variation 1
Variation 2
imperial-gallons
imperial-gallons-per-min
inches
inches-of-mercury
inches-of-water
Joules
joules-per-degree-kelvin
joules-per-kilogram-degree-kelvin
joules-per-kilogram-dry-air
Kilograms
Kg
kilograms-per-hour
kilograms-per-minute
kilograms-per-second
Kilohertz
KHz
kilohms
Kilojoules
kilojoules-per-kilogram
kilometers-per-hour
Kilopascals
kilovolt-amperes
kilovolt-amperes-reactive
kilovolts
kilovolt-amps
KVAR
KVA
kilowatt-hour-per-square-foot
kilowatt-hour-per-square-meter
kilowatt-hours
kilowatts
KWh
KWh
liters
liters-per-hour
liters-per-minute
liters-per-second
lumens
luxes
Megahertz
MHz
megajoules
megajoules-per-square-foot
megajoules-per-square-meter
megavolt-amperes
Megavolt-amperes-reactive
megavolts
megavolt-amps
MVAR
megawatts
MW
megohms
meters
meters-per-second
miles-per-hour
milliamperes
milliamps
millibars
millimeters
millimeters-of-mercury
Millivolts
Milliwatts
minutes
months
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 19 of 20
Unit
Variation 1
Variation 2
Variation 3
No-Units
No Units
No_Units
None
ohms
parts-per-billion
parts-per-million
Pascals
Percent
percent-obscuration-per-foot
percent-obscuration-per-meter
percent-per-second
percent-relative-humidity
Per-hour
per-minute
per-second
pounds-force-per-square-inch
Pounds-mass
% RH
PSI
Percent RH
Percent RH
pounds-force-per-sq-inch
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
ton-hours
Tons
Tons-refrigeration
US-gallons
us-gallons-per-minute
Volt-Amperes
volt-amperes-reactive
Volts
watt-hours
Gallons
GPM
Volt-Amps
VAR
Voltage
Wh
VA
Watts
W
watts-per-square-foot
watts-per-square-meter
watts-per-square-meter-degrees-kelvin
weeks
years
FS-8704-02_BacnetEthernet.doc Driver Manual
Page 20 of 20
THIS PAGE INTENTIONALLY LEFT BLANK
|