ProSoft Technology 5201-DFNT-BACNET User Manual
BACnet
ProLinx Gateway
BACnet/IP Client Edition 2
November 24, 2010
PROTOCOL MANUAL
Your Feedback Please
We always want you to feel that you made the right decision to use our products. If you have suggestions, comments,
compliments or complaints about our products, documentation, or support, please write or call us.
How to Contact Us
ProSoft Technology
5201 Truxtun Ave., 3rd Floor
Bakersfield, CA 93309
+1 (661) 716-5100
+1 (661) 716-5101 (Fax)
www.prosoft-technology.com
support@prosoft-technology.com
Copyright © 2010 ProSoft Technology, Inc., all rights reserved.
BACnet Protocol Manual
November 24, 2010
ProSoft Technology ®, ProLinx ®, inRAx ®, ProTalk ®, and RadioLinx ® are Registered Trademarks of ProSoft
Technology, Inc. All other brand or product names are or may be trademarks of, and are used to identify products
and services of, their respective owners.
ProSoft Technology® Product Documentation
In an effort to conserve paper, ProSoft Technology no longer includes printed manuals with our product shipments.
User Manuals, Datasheets, Sample Ladder Files, and Configuration Files are provided on the enclosed CD-ROM,
and are available at no charge from our web site: www.prosoft-technology.com
Printed documentation is available for purchase. Contact ProSoft Technology for pricing and availability.
North America: +1.661.716.5100
Asia Pacific: +603.7724.2080
Europe, Middle East, Africa: +33 (0) 5.3436.87.20
Latin America: +1.281.298.9109
Important Installation Instructions
Power, Input, and Output (I/O) wiring must be in accordance with Class I, Division 2 wiring methods, Article 501-4 (b)
of the National Electrical Code, NFPA 70 for installation in the U.S., or as specified in Section 18-1J2 of the Canadian
Electrical Code for installations in Canada, and in accordance with the authority having jurisdiction. The following
warnings must be heeded:
A WARNING - EXPLOSION HAZARD - SUBSTITUTION OF COMPONENTS MAY IMPAIR SUITABILITY FOR
CLASS I, DIV. 2;
B WARNING - EXPLOSION HAZARD - WHEN IN HAZARDOUS LOCATIONS, TURN OFF POWER BEFORE
REPLACING OR WIRING MODULES
C WARNING - EXPLOSION HAZARD - DO NOT DISCONNECT EQUIPMENT UNLESS POWER HAS BEEN
SWITCHED OFF OR THE AREA IS KNOWN TO BE NON-HAZARDOUS.
D THIS DEVICE SHALL BE POWERED BY CLASS 2 OUTPUTS ONLY.
ProLinx® Products Warnings
WARNING – EXPLOSION HAZARD – DO NOT DISCONNECT EQUIPMENT UNLESS POWER HAS BEEN
SWITCHED OFF OR THE AREA IS KNOWN TO BE NON-HAZARDOUS.
AVERTISSEMENT – RISQUE D'EXPLOSION – AVANT DE DÉCONNECTER L'EQUIPMENT, COUPER LE
COURANT OU S'ASSURER QUE L'EMPLACEMENT EST DÉSIGNÉ NON DANGEREUX.
ProLinx Gateways with Ethernet Ports
Series C ProLinx™ Gateways with Ethernet ports do NOT include the HTML Web Server. The HTML Web Server
must be ordered as an option. This option requires a factory-installed hardware addition. The HTML Web Server now
supports:
8 MB file storage for HTML files and associated graphics files (previously limited to 384K)
32K maximum HTML page size (previously limited to 16K)
To upgrade a previously purchased Series C model:
Contact your ProSoft Technology distributor to order the upgrade and obtain a Returned Merchandise Authorization
(RMA) to return the unit to ProSoft Technology.
To order a ProLinx Plus gateway with the -WEB option
Add -WEB to the standard ProLinx part number. For example, 5201-MNET-MCM-WEB.
Markings
Electrical Specifications
Label Markings
CL I Div 2 GPs A, B, C, D
II 3 G
Ex nA nL IIC X
0°C <= Ta <= 60°C
II – Equipment intended for above ground use (not for use in mines).
3 – Category 3 equipment, investigated for normal operation only.
G – Equipment protected against explosive gasses.
Agency Approvals and Certifications
cULus ISA 12.12.01 Class I, Div 2 Groups A, B, C, D
cULus C22.2 No. 213-M1987
183151
BACnet ♦ ProLinx Gateway Contents
BACnet/IP Client Edition 2 Protocol Manual
Contents
Your Feedback Please ........................................................................................................................ 2
How to Contact Us .............................................................................................................................. 2
ProSoft Technology® Product Documentation .................................................................................... 2
Important Installation Instructions ....................................................................................................... 3
ProLinx® Products Warnings ............................................................................................................... 3
ProLinx Gateways with Ethernet Ports ............................................................................................... 3
To upgrade a previously purchased Series C model: .................................................................... 3
To order a ProLinx Plus gateway with the -WEB option ................................................................ 3
Markings .............................................................................................................................................. 4
1 Start Here 7
1.1
1.2
1.3
1.4
1.5
1.6
1.7
1.7.1
System Requirements ............................................................................................... 8
Package Contents ..................................................................................................... 9
Setting Port 0 Configuration Jumpers ..................................................................... 10
Mounting the Module on the DIN-rail ...................................................................... 11
Connecting Power to the Unit ................................................................................. 12
RS-232 Configuration Port Serial Connection ........................................................ 13
Installing ProSoft Configuration Builder Software ................................................... 14
Using the Online Help ............................................................................................. 14
2 Functional Overview 15
2.1
2.1.1
2.1.2
BACnet/IP Client ..................................................................................................... 16
Module Internal Database ....................................................................................... 16
BACnet/IP Client Access to Database .................................................................... 17
3 BACnet Protocol Configuration 19
3.1
3.2
3.3
3.4
3.1.1
3.1.2
3.1.3
3.1.4
3.1.5
3.2.1
3.2.2
3.2.3
3.3.1
3.3.2
3.3.3
Configuring the Module ........................................................................................... 20
Adding a Module ..................................................................................................... 20
Module Entries ........................................................................................................ 21
Creating Optional Comment Entries ....................................................................... 23
Printing a Configuration File .................................................................................... 23
Downloading a File from PC to the Module ............................................................. 24
BACnet Client 0 ....................................................................................................... 25
Minimum Command Delay ...................................................................................... 25
Response Timeout .................................................................................................. 25
Retry Count ............................................................................................................. 25
BACnet Client 0 Commands ................................................................................... 26
Command List Overview ......................................................................................... 26
Commands Supported by the Gateway .................................................................. 27
Command Entry Formats ........................................................................................ 28
Ethernet Port Configuration - wattcp.cfg ................................................................. 33
4 Client Error/Status Data 35
4.1
Client Error/Status Data .......................................................................................... 36
ProSoft Technology, Inc. Page 5 of 52
November 24, 2010
Contents BACnet ♦ ProLinx Gateway
Protocol Manual BACnet/IP Client Edition 2
4.1.1
4.2
4.3
4.2.1
4.3.1
4.3.2
BACnet Client 0 Status ........................................................................................... 36
BACnet Client Command List Error Data ............................................................... 37
BACnet Client 0 (Command List Error Data) .......................................................... 37
Error Codes ............................................................................................................. 38
BACnet Client Protocol Error Codes ...................................................................... 38
Gateway-specific Error Codes ................................................................................ 39
5 Reference 41
5.1
Command Configuration Form ............................................................................... 42
6 Support, Service & Warranty 43
Contacting Technical Support .......................................................................................................... 43
6.1
6.2
6.1.1
6.1.2
6.1.3
6.2.1
6.2.2
6.2.3
6.2.4
6.2.5
6.2.6
6.2.7
6.2.8
6.2.9
6.2.10
Return Material Authorization (RMA) Policies and Conditions ............................... 45
Returning Any Product ............................................................................................ 45
Returning Units Under Warranty ............................................................................. 46
Returning Units Out of Warranty ............................................................................. 46
LIMITED WARRANTY ............................................................................................ 47
What Is Covered By This Warranty ........................................................................ 47
What Is Not Covered By This Warranty .................................................................. 48
Disclaimer Regarding High Risk Activities .............................................................. 48
Intellectual Property Indemnity ............................................................................... 49
Disclaimer of all Other Warranties .......................................................................... 49
Limitation of Remedies ** ....................................................................................... 50
Time Limit for Bringing Suit ..................................................................................... 50
No Other Warranties ............................................................................................... 50
Allocation of Risks .................................................................................................. 50
Controlling Law and Severability ............................................................................ 50
Index 51
Page 6 of 52 ProSoft Technology, Inc.
November 24, 2010
BACnet ♦ ProLinx Gateway Start Here
BACnet/IP Client Edition 2 Protocol Manual
1 Start Here
In This Chapter
System Requirements ............................................................................. 8
Package Contents ................................................................................... 9
Setting Port 0 Configuration Jumpers .................................................... 10
Mounting the Module on the DIN-rail ..................................................... 11
Connecting Power to the Unit ................................................................ 12
RS-232 Configuration Port Serial Connection ....................................... 13
Installing ProSoft Configuration Builder Software .................................. 14
ProSoft Technology, Inc. Page 7 of 52
November 24, 2010
Start Here BACnet ♦ ProLinx Gateway
Protocol Manual BACnet/IP Client Edition 2
1.1 System Requirements
The ProSoft Configuration Builder configuration software for the BACnet gateway
requires the following minimum hardware and software components:
Pentium® II 450 MHz minimum. Pentium III 733 MHz (or better)
recommended
Supported operating systems:
o
Microsoft Windows Vista
o
Microsoft Windows XP Professional with Service Pack 1 or 2
o
Microsoft Windows 2000 Professional with Service Pack 1, 2, or 3
o
Microsoft Windows Server 2003
128 Mbytes of RAM minimum, 256 Mbytes of RAM recommended
100 Mbytes of free hard disk space (or more based on application
requirements)
256-color VGA graphics adapter, 800 x 600 minimum resolution (True Color
1024 × 768 recommended)
CD-ROM drive
Page 8 of 52 ProSoft Technology, Inc.
November 24, 2010
BACnet ♦ ProLinx Gateway Start Here
BACnet/IP Client Edition 2 Protocol Manual
1.2 Package Contents
The following components are included with your BACnet gateway, and are all
required for installation and configuration.
Important: Before beginning the installation, please verify that all of the following items are
present.
Qty. Part Name Part Number Part Description
1 BACnet gateway PLX-#### ProLinx communication gateway
1 Cable Cable #15, RS232
Varies Cable Cable #9, Mini-
Varies Adapter 1454-9F Adapters, DB9 Female to Screw Terminal.
1 ProSoft Solutions CD Contains sample programs, utilities and
Null Modem
DIN8 to DB9 Male
Adapter
For RS232 Connection from a PC to the
CFG Port of the gateway
For DB9 Connection to gateway’s Port. One
DIN to DB-9M cable included per
configurable serial port, plus one for
gateway configuration
For RS422 or RS485 Connections to each
serial application port of the gateway
documentation for the BACnet gateway.
If any of these components are missing, please contact ProSoft Technology
Support for replacements.
ProSoft Technology, Inc. Page 9 of 52
November 24, 2010
Start Here BACnet ♦ ProLinx Gateway
Protocol Manual BACnet/IP Client Edition 2
1.3 Setting Port 0 Configuration Jumpers
Before installing the module on the DIN-rail, you must set the jumpers for the
Port 0 application port.
Note: Ethernet-only ProLinx modules do not use the serial port jumper settings. The serial
configuration jumper settings on an Ethernet-only module have no effect.
Note: The presence of Port 0 depends on the specific combination of protocols in your ProLinx
module. If your module does not have a Port 0, the following jumper settings do not apply.
Port 0 is preconfigured for RS-232. You can move the port configuration jumper
on the back of the module to select RS-485 or RS-422.
Note: Some ProLinx modules do not correctly report the position of the port 0 jumper to the Port
Configuration page on the Config/Debug menu. In cases where the reported configuration differs
from the known jumper configuration, the physical configuration of the jumper is correct.
The following illustration shows the jumper positions for Port 0:
ProLinx 5000/6000 Series Module
Page 10 of 52 ProSoft Technology, Inc.
November 24, 2010
BACnet ♦ ProLinx Gateway Start Here
BACnet/IP Client Edition 2 Protocol Manual
1.4 Mounting the Module on the DIN-rail
ProLinx 5000/6000 Series gateway
ProSoft Technology, Inc. Page 11 of 52
November 24, 2010
Start Here BACnet ♦ ProLinx Gateway
Protocol Manual BACnet/IP Client Edition 2
1.5 Connecting Power to the Unit
WARNING: Ensure that you do not reverse polarity when applying power to the gateway. This will
cause damage to the gateway’s power supply.
Page 12 of 52 ProSoft Technology, Inc.
November 24, 2010
BACnet ♦ ProLinx Gateway Start Here
BACnet/IP Client Edition 2 Protocol Manual
1.6 RS-232 Configuration Port Serial Connection
This port is physically a Mini-DIN connection. A Mini-DIN to DB-9 adapter cable
is included with the module. This port permits ProSoft Configuration Builder to
view configuration and status data in the module and to control the module. The
following illustration shows the pinout for communications on this port.
ProSoft Technology, Inc. Page 13 of 52
November 24, 2010
Start Here BACnet ♦ ProLinx Gateway
Protocol Manual BACnet/IP Client Edition 2
1.7 Installing ProSoft Configuration Builder Software
You must install the ProSoft Configuration Builder (PCB) software to configure
the gateway. You can always get the newest version of ProSoft Configuration
Builder from the ProSoft Technology website.
Installing ProSoft Configuration Builder from the ProSoft website
1 Open your web browser and navigate to http://www.prosoft-
technology.com/pcb
2 Click the D
Configuration Builder.
3 Choose S
4 Save the file to your Windows Desktop, so that you can find it easily when
you have finished downloading.
5 When the download is complete, locate and open the file, and then follow the
instructions on your screen to install the program.
If you do not have access to the Internet, you can install ProSoft Configuration
Builder from the ProSoft Solutions Product CD-ROM, included in the package
with your gateway.
Installing ProSoft Configuration Builder from the Product CD-ROM
1 Insert the ProSoft Solutions Product CD-ROM into the CD-ROM drive of your
PC. Wait for the startup screen to appear.
2 On the startup screen, click P
Windows Explorer file tree window.
3 Click to open the U
and files you will need to set up and configure your gateway.
4 Double-click the S
PCB_*.
software on your PC. The information represented by the "*" character in the
file name is the PCB version number and, therefore, subject to change as
new versions of PCB are released.
OWNLOAD HERE
AVE
or S
AVE FILE
TILITIES
ETUP CONFIGURATION TOOL
EXE
file and follow the instructions on your screen to install the
link to download the latest version of ProSoft
when prompted.
RODUCT DOCUMENTATION
folder. This folder contains all of the applications
folder, double-click the
. This action opens a
Note: Many of the configuration and maintenance procedures use files and other utilities on the
CD-ROM. You may wish to copy the files from the Utilities folder on the CD-ROM to a convenient
location on your hard drive.
1.7.1 Using the Online Help
Most of the information needed to help you use ProSoft Configuration Builder is
provided in a Help System that is always available whenever you are running
ProSoft Configuration Builder. The Help System does not require an Internet
connection.
To view the help pages, start ProSoft Configuration Builder, open the H
menu, and then choose C
ONTENTS
.
Page 14 of 52 ProSoft Technology, Inc.
November 24, 2010
ELP
BACnet ♦ ProLinx Gateway Functional Overview
BACnet/IP Client Edition 2 Protocol Manual
2 Functional Overview
In This Chapter
BACnet/IP Client ................................................................................... 16
The ProLinx BACnet Client driver can be used to interface many different
protocols with Ethernet-enabled BACnet devices. The BACnet driver supports a
single UDP Client to interface with one or more devices that contain a BACnet
server.
The driver interfaces with a common internal database in the gateway. This
permits the sharing of data across many different networks. The following
illustration shows the functionality of the BACnet Client driver when interfaced
with serial communication based networks.
ProSoft Technology, Inc. Page 15 of 52
November 24, 2010
Functional Overview BACnet ♦ ProLinx Gateway
Protocol Manual BACnet/IP Client Edition 2
2.1 BACnet/IP Client
General One UDP Client
Command List Support for 100 commands, each configurable for
Service Port
Function Code
Data Type
Point Count
The gateway supports a single independent Client on the IP network using the
UDP protocol to interface with processors or devices using a user constructed
command list of up to 100 entries. The gateway's internal database is used as
the source for write commands to the remote units. Data collected from the
remote units using read commands is placed in the gateway's database.
command, IP address, register to/from addressing
and word/bit count.
1 to 65535
12=Read Single Property
14=Read Multiple Properties
15=Write Single Property
16=Write Multiple Properties
0=Analog Input
1=Analog Output
2=Analog Value
3=Binary Input
4=Binary Output
5=Binary Value
1 to 25
2.1.1 Module Internal Database
The internal database is central to the functionality of the gateway. This database
is shared between all the drivers in the gateway and is used as a conduit to pass
information from one device on one network to one or more devices on another
network. This permits data from devices on one communication port to be viewed
and controlled by devices on another port.
In addition to data from the Client, status and error information generated by the
gateway can also be mapped into the internal database. Use this data to
determine the "health" of the gateway and to determine if commands are being
processed successfully.
Page 16 of 52 ProSoft Technology, Inc.
November 24, 2010
Loading...