Top Banner
Verify that you have the most current version of this document. Go to http://accounts.automatedlogic.com, then select Support > Download > Third-party Interfaces > Third-party Integration Guides. BACnet Integration Guide For an LGR line, ME-LGR line, or ME812u-LGR controller Rev. 9/28/2010 BETA
23

QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

Jul 28, 2015

Download

Documents

pransatish
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

Verify that you have the most current version of this document. Go to http://accounts.automatedlogic.com, then select Support > Download > Third-party Interfaces > Third-party Integration Guides.

BACnet Integration Guide For an LGR line, ME-LGR line, or ME812u-LGR controller

Rev. 9/28/2010

BETA

Page 2: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

© 2010 Automated Logic Corporation. All rights reserved throughout the world. Automated Logic Corporation, the Automated Logic logo, WebCTRL, EIKON, BACview, SuperVision, and InterOp are registered trademarks, and Alert is a trademark of Automated Logic Corporation. BACnet® is a registered trademark of ASHRAE. All other brand and product names are trademarked by their respective companies.

Contents Overview .................................................................................................................................. 1 Before-you-begin checklist ........................................................................................................ 1 The integration process ............................................................................................................. 2 1 Discover BACnet networks, devices, and objects ...................................................................... 2 2 Create a control program ....................................................................................................... 3 3 Edit a control program ........................................................................................................... 5 4 Configure Display microblocks ................................................................................................ 6 5 Configure Network I/O microblocks......................................................................................... 8

Setting up network inputs ............................................................................................. 8 To speed detection of a dead device ........................................................................... 11

6 Connect the third-party device to the ALC controller ................................................................ 12 To wire a BACnet/ARC156 device ............................................................................... 12 To wire a BACnet MS/TP device .................................................................................. 12 To wire a BACnet PTP device ....................................................................................... 13

7 Download the BACnet driver ................................................................................................. 13 8 Verify the controller is set up correctly.................................................................................... 14

To get a diagnostic capture ......................................................................................... 15 Appendix A: BACnet addresses ............................................................................................... 17 Appendix B: To reuse a control program ................................................................................... 19 Appendix C: Third-party points behind NAT routers .................................................................... 20 Appendix D: Point packs ........................................................................................................ 21

BETA

Page 3: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 1 © 2010 Automated Logic Corporation

You can integrate BACnet devices into a WebCTRL system using one of the ALC controllers listed below that provide third-party points*. The ALC controller serves as a master device.

ALC

Controllers LGR25 LGR250 LGR-1000

ME-LGR25 ME-LGR200 ME812u-LGR (200 points)

Read/write capability Can read from and write to the third-party equipment

Third party

Supported equipment Any device that supports the BACnet protocol

Supported media IP, Ethernet, ARCNET, MS/TP (9600, 19200, 38400, or 76800 kbps), and PTP

* The point allowance of a controller (the number after the letter R) applies only to that controller.

For example, if you purchase an LGR-1000 that provides 1000 third-party points and you download control programs that use 500 third-party Network I/O points, you cannot apply the unused 500 points to a different controller. If you have legacy ALC controllers that use point packs, see Appendix D (page 21).

You need the following items, information, and skills for the integration process:

� The system's SiteBuilder database.

� The ALC controler's Technical Instructions.

� The third-party device's: • BACnet network number and MAC address or the Device instance • Points list including BACnet Object ID's (object type plus object instance) If the third party device is not installed or commissioned yet, ask the third-party vendor for this information. Then use Appendix A (page 17) to write correct BACnet address strings in your microblocks.

� The baud rate of the third-party device if running MS/TP.

� Verification that all communication settings have been set on the third-party device.

� Experience creating control programs with EIKON LogicBuilder

� Experience installing, wiring, setting up, and downloading memory to the ALC controller

Overview

Before-you-begin checklist

BETA

Page 4: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 2 © 2010 Automated Logic Corporation

Follow the steps in this document to integrate one or more third-party BACnet devices into a WebCTRL system using an ALC controller. To install and network the ALC controller, see the controller’s Technical Instructions.

WebCTRL’s BACnet Discovery locates all accessible BACnet networks, BACnet devices, and BACnet objects (including devices in your WebCTRL system) on a BACnet network.

To use BACnet Discovery:

1 On the WebCTRL CFG tree, select System Settings.

2 On the Communications tab, clear the Use Static BACnet Bindings checkbox so that bindings are dynamic.

NOTE Always run your system with dynamic bindings (clear the Use Static BACnet Bindings checkbox) unless you are: ○ Troubleshooting BBMD's. See "Setting up BBMD's" in WebCTRL Help. ○ Using NAT routing. See "To build a Network tree" in SiteBuilder Help.

3 On WebCTRL's CFG tree, select Connections.

4 On the Configure tab, stop the BACnet/IP connection.

5 While the connection is stopped, enter or verify the server's IP Address and Subnet Mask for the BACnet/IP connection.

6 Restart the connection.

7 On the NET tree, select the system level.

8 Click Devices.

9 On the BACnet Discovery tab, click Go to discover BACnet sites for the system. An item called Discovered Networks appears in the tree. After all sites are found, close the status dialog box.

10 To discover BACnet networks, select Discovered Networks, then click Go. A list of all BACnet networks appears in the NET tree. After all networks are found, close the status dialog box.

TIP Run a commstat manual command to determine which device routes to each network. The BACnet Bind Show Network section of the Commstat window shows the IP address of the router to each network.

11 To discover BACnet devices on a network, select a network on the NET tree, then click Go. After all devices are found, close the status dialog box. Click the plus sign beside an item to expand the list of devices.

12 To discover BACnet objects on a device, select the device in the NET tree, then click Go. After all objects are found, close the status dialog box. A list of all BACnet objects in this device appears on the NET tree.

The integration process

1 Discover BACnet networks, devices, and objects

BETA

Page 5: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 3 © 2010 Automated Logic Corporation

TIP Make sure you are discovering objects in the correct device. It may take some time to discover objects in devices with more than 100 objects.

13 On the NET tree, select a discovered network with devices or a single device.

14 Click the Export button to export the BACnet information.

15 Name and save the .discovery file in any folder.

NOTES

• Some third-party BACnet devices may not be discovered because they do not support the BACnet methods required for auto discovery.

• If the discovery process returns ambiguous information, such as multiple points with similar names, contact the third-party manufacturer's representative for clarification.

• Device configuration or network load can prevent WebCTRL from showing all BACnet devices. If you do not see a BACnet device that you expect to see, check the system's BBMD configurations. If the configurations are correct, try the discovery process again.

• If a third-party device is not discoverable, you must get the device's address and point list information from the third-party vendor. Then use Appendix A (page 17) to write correct BACnet address strings for your microblocks.

Use Network I/O microblocks and Display microblocks to read from or write to BACnet objects in a third-party BACnet device.

Use Network I/O microblocks if any of the following is true:

• An ALC control program must read from or write to third-party BACnet points for automatic control.

• You want to trend values from a third-party device that does not support BACnet trends.

• You want to display third-party values that require unit conversion or other math processing.

NOTES

• Each Network I/O microblock that is addressed to a third-party object property counts against the point limit of an ALC controller.

• Display microblocks do not count against the point limits of ALC controllers.

• Both Network I/O and Display microblocks count against the 500-point limitation of WebCTRL 500.

• Display microblocks cannot use logic, including the logic that a thermographic floorplan requires.

2 Create a control program

BETA

Page 6: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 4 © 2010 Automated Logic Corporation

To create a control program:

1 Go to Start > All Programs > WebCTRL 5.2 > Third-Party BACnet Utility.

2 Select File > Save as.

3 Name and save the .3pbu file in any folder.

4 Select File > Import.

5 Browse to the .discovery file that you exported from WebCTRL's BACnet Discovery tool.

6 Select Control Program > Add Control Program.

7 In the Name field, type the name of the .equipment file that you want to create, then click OK.

NOTE You can repeat steps 6 and 7 to add multiple control programs to the .3pbu file.

8 Click to highlight one or more control programs in the Control Programs to Generate list.

9 Click, Shift+click, or Ctrl+click to select the point(s) you want to add to the control program(s).

10 Click .

11 Select Control Program > Generate Control Programs.

12 Browse to the control programs Destination Directory.

13 Select the checkbox by each control program that you want to generate.

NOTE You can use the Check All and Uncheck All buttons to the far right.

TIPS

• Move the divider bar to adjust the size of the size of the panes.

• Keyboard shortcuts are shown beside their corresponding commands in the drop-

down menus.

BETA

Page 7: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 5 © 2010 Automated Logic Corporation

• Change the width of a column by dragging the bar between column headings.

• Rearrange the columns by dragging and dropping a heading cell.

• Click a column heading to sort the rows by the information in that column.

• To prioritize sorting by multiple columns, hold down Ctrl as you click headings. The size of the triangles indicate the sorting priority.

For example: Click Device ID to sort the rows by third-party devices. Then Ctrl+click Object Type to sort each Device ID’s object types. Then Ctrl+click Object Instance to sort each section of object types by instance numbers.

• Make the Discovered BACnet Objects list easier to view by selecting BACnet Objects > Filter Properties. Then select or clear checkboxes to show only the information you need.

• Hide selected objects by right-clicking one of the selected objects then selecting Hide object. To reveal the hidden objects, go to BACnet Objects > Filter Properties, then select the Show hidden objects checkbox.

• To find an object in the opposite pane, right-click the object, then select Find Usages.

• Move or copy objects from one control program to another by right-clicking the selected object(s), then selecting Move to or Copy to.

You can edit a control program created with the Third-Party BACnet Utility in the utility itself or in EIKON LogicBuilder. Or, in EIKON LogicBuilder, you can edit an existing control program to integrate with a third-party BACnet device.

To edit a control program in the Third-Party BACnet Utility

1 In the Third-Party BACnet Utility, select File > Open.

2 Select the .3pbu file that contains the control program(s) you want to edit.

3 Make changes as needed.

NOTE If you change a microblock's reference name, the utility will add a new microblock when you generate the control program.

4 Select Control Program > Generate Control Programs.

NOTE The Generate Control Programs command will add microblocks that you added, but will not delete microblocks that you deleted in the Third-Party BACnet Utility.

5 Save the control program(s).

To edit a control program in EIKON LogicBuilder

1 In EIKON LogicBuilder, select File > Open.

2 Select the .equipment file that you want to edit.

3 Edit a control program

BETA

Page 8: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 6 © 2010 Automated Logic Corporation

3 Select Edit > Third Party BACnet Addresses.

4 Browse to the .discovery file that contains the BACnet object you want to add or change.

5 In the Third Party Addresses window, select the Only show objects that match selected microblock checkbox.

6 Do one of the following: Change an existing microblock

a. Select an existing microblock.

b. Select an object in the Discovered BACnet Objects list.

c. Click Change Microblock.

d. Select a different microblock type from the drop-down list.

e. Optional: Choose Change Type Only or Change Type And Set Address.

f. Click OK. OR Add a new microblock

a. Add a Network I/O or Display microblock.

b. Select a point in the Discovered BACnet Objects list.

c. Click Set Address to assign object properties to the microblock.

7 Save the file.

To allow an operator to change a third-party object's property from the WebCTRL interface through a Display microblock, the desired property must be present and be editable (not marked "Read only") in the third-party object.

In EIKON LogicBuilder, in the Property Editor of a microblock, select Present (if the optional property exists in the third-party device), Editable, and Write to field checkboxes. See COV increment in the example below.

4 Configure Display microblocks BETA

Page 9: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 7 © 2010 Automated Logic Corporation

The Display microblocks in the table below require special configuration.

Binary Output

Binary Value

If you want the text of a BACnet Modeled Binary Output or BACnet Modeled Binary Value on a graphic to display the inactive and active text instead of 0 and 1, select the Present checkboxes.

NOTE If the third-party device does not support this feature, your graphic will display 0 or 1 even if you select the Present checkboxes.

Schedule If you want a WebCTRL schedule to write to a third-party BACnet-schedule object through a BACnet modeled schedule object, do the following:

1 In EIKON LogicBuilder, select the Schedule Category of the WebCTRL schedule that will write to the third-party object.

2 In the Property Editor, select the Present, Editable, and Write to field checkboxes for Weekly Schedule and Exception Schedule.

NOTES

• Only ALC-manufactured devices support ALC Dated Weekly schedules.

• If you get an error in WebCTRL, clear the Array Resize Write Index and Array Resize Write Past End checkboxes.

Event Notification

You can use a BACnet Modeled Event Enrollment microblock to view the status of a third-party BACnet Event Object. If you want the third-party device to deliver its alarms to the WebCTRL Alarms View tab, you must configure the third-party device to send alarms to WebCTRL. You can add WebCTRL to the Recipient List for each alarm or set up a BACnet Modeled Notification Class microblock to add WebCTRL to the Recipient List for every alarm generated by the third-party device.

NOTE A third-party device may not retain alarm recipient information through a power loss or memory download.

1 In the BACnet Modeled Event Enrollment microblock, select the Standard Template for the best results on your WebCTRL Alarms View tab.

2 In the Event Enrollment or Notification Class microblock, select the Editable and Write to field checkboxes for Recipient List.

BETA

Page 10: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 8 © 2010 Automated Logic Corporation

3 In WebCTRL, on the Properties page Details tab for a device's BACnet Modeled Notification Class microblock or an event's BACnet Modeled Event Enrollment microblock, click Add.

4 Define the recipient. See field descriptions below.

5 Generate an alarm at the third-party device to verify that you see the alarm delivered to your WebCTRL Alarms View tab.

Field Notes

Recipient Type Select Device.

Time section Select the days and define the hours that the third-party device should send alarms to WebCTRL.

Device Object Identifier Enter your WebCTRL system's BACnet Alarm Recipient instance number.

Process Identifier Type 1.

Issue Confirmed Notification Select this checkbox.

Trend If the third-party trend does not display correctly, change the Trend Conformance Level to Default.

Polling or BACnet COV If a network input or totalizer microblock's Address field references a BACnet object property, the microblock reads the property's value using one of the following methods.

• Polling—The microblock reads the property at the Refresh Time interval using the BACnet ReadProperty or ReadPropertyMultiple service (see "Method 1: Polling" below).

• BACnet COV (Change of Value) subscription—The microblock subscribes with the target BACnet object. An analog target notifies the microblock if the target's value changes by more than the target's BACnet COV_Increment. A binary target notifies the microblock when it changes state (see "Method 2: BACnet COV subscriptions" below).

Method 1: Polling Benefits • Allows rapid detection of a dead device or of network problems

• Does not require additional memory Drawbacks • Generates unnecessary network traffic if a value does not change frequently

• Misses value changes that occur between pollings • Can overwhelm the target's controller if many microblocks request the same

property value (such as outside air temperature). The BACnet object must send the value to each microblock that polls for that data.

To set up Set the microblock's Refresh Time to 30 seconds or less.

5 Configure Network I/O microblocks

Setting up network inputs BETA

Page 11: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 9 © 2010 Automated Logic Corporation

NOTE The ALC microblock will not poll at a Refresh Time interval smaller than 1 second.

BACnet ReadProperty and ReadPropertyMultiple services

See the BACnet specification for details on the ReadProperty and ReadPropertyMultiple services.

ReadPropertyMultiple occurs if: • two or more microblocks in a controller read more than one target in the same

remote controller, • the Refresh Time in two or more microblocks expires at the same time, and • the remote controller supports the service.

Method 2: BACnet COV subscriptions Benefits • Can decrease network traffic by preventing unnecessary updates if the target's

COV_Increment is set appropriately. See step 2 in "To set up" below. Drawbacks • Can generate excessive network traffic if the target's COV_Increment property

is too small. See step 2 in "To set up" below. • Can delay detection of a dead device or of network problems

To set up 1 Set the microblock's Refresh Time to 31 seconds or more.

2 If the microblock's Address field references an analog property, set the target's COV_Increment property to the smallest amount by which the value must change for the target to notify its subscribers. The optimal COV_Increment is large enough to prevent unnecessary updates but small enough to be useful to the control program(s) receiving the updates.

NOTE If COV subscription fails, the microblock reads the value at the Refresh Time interval using the BACnet ReadProperty or ReadPropertyMultiple service. See "Method 1: Polling" above.

COV subscription details When an input (network input or totalizer microblock) subscribes with a BACnet target (object property), the input sets a 21-minute subscription Lifetime in the target. The target responds with a COV notification that includes the target's value and time remaining from the original subscription Lifetime (TimeRemaining). The input resubscribes with the target every 10 minutes to keep the target's BACnet subscription service active. WebCTRL shows the time remaining until the input's next subscription in the Next Subscription field on the input's WebCTRL Properties page.

The target also sends a COV notification that includes the target's value and subscription Lifetime TimeRemaining when the target's value changes by more than the target's COV_Increment.

If the ALC target has one subscriber, the target sends COV notifications directly to that subscriber. If the ALC target has more than one subscriber, it broadcasts its COV notifications to optimize network traffic. A third-party subscriber can participate in this broadcast scheme by subscribing for Unconfirmed COV notifications with a Process ID of 0. Otherwise, the ALC target maintains and responds to the third-party subscription separately with its own Lifetime timer.

BETA

Page 12: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 10 © 2010 Automated Logic Corporation

The ALC input compares the TimeRemaining value in each COV notification broadcast the target sends to its (Next Subscription time + 11) to determine whether another input has subscribed since it did. If another input has subscribed more recently, the input adds 10 minutes to its Next Subscription time. This allows the COV Subscription request from the last subscribing input to keep the subscription service active for all subscribers to the same data.

EXAMPLE

Elapsed time (minutes)

Action Target Lifetime TimeRemaining (minutes)

Input 1 Next Subscription (minutes)

Input 2 Next Subscription (minutes)

0 Input 1 subscribes to target

21 (Input 1) 10

0 Target broadcasts COV notification because Input 1 subscribed

21 21 ≤ 10 + 11, so keep current value of 10

2 Input 2 subscribes to target

21 (Input 2) 10 - 2 = 8 10

0 Target broadcasts COV notification because Input 2 subscribed

21 21 > 8 + 11, so add 10 to current value of 8

8 + 10 = 18

21 ≤ 10 + 11, so keep current value of 10

3 21 - 3 = 18 18 - 3 = 15 10 - 3 = 7

0 Target broadcasts COV notification because value changed

18 18 ≤ 15 + 11 so keep current value of 15

18 ≤ 7 + 11 so keep current value of 7

7 18 - 7 = 11 15 - 7 = 8 7 - 7 = 0 resubscribe

0 Input 2 resubscribes 21 (Input 2) 8 10

0 Target broadcasts COV notification because Input 2 subscribed

21 21 > 8 + 11, so add 10 to current value

8 + 10 = 18

21 ≤ 10 + 11, so keep current value of 10

Input 2 keeps the subscription service active at the target with a minimum of network traffic.

NOTE If an input receives COV notification with a target TimeRemaining < 11, which could happen if the last subscribing input loses communication with the target, the input resubscribes immediately.

COV notification rate COV notifications from a BACnet object property are controlled by that property's BACnet COV_Increment. When the absolute value of the difference between the property's

BETA

Page 13: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 11 © 2010 Automated Logic Corporation

Present_Value and the value sent in the last COV notification is greater than the COV_Increment, the object broadcasts a COV notification. For ALC controllers, the rate of notifications is further limited by two internal processes.

1 The control program's execution rate determines how often the check against COV_Increment is performed.

2 The controller's pending COV Notification task has built-in delays to prevent COV notifications from consuming the controller's CPU processing time.

The built-in delays are as follows:

If more than 15 COV notifications are pending delivery, the controller inserts a 50 millisecond delay after each set of 15 notifications. Once the entire list of pending notifications is serviced, the controller inserts another 50 millisecond delay. This results in a maximum COV notification rate of 300 COV notifications per second per ALC controller.

If a BACnet object's device loses network communication, a network input reading the object's value does not detect the failure until

• the network input's next subscription (up to 10 minutes) if using BACnet COV subscription, or

• the Refresh Time expires, if polling

You can use a small Refresh Time to poll more often, but this can generate unnecessary network traffic under normal conditions.

To use the benefits of BACnet COV subscription, but overcome the potential delay in detection of a dead device, send a constantly changing value from the BACnet object's control program to a network input using BACnet COV subscription. If the value stops changing, the network input's control program generates an alarm.

EXAMPLE

The logic in the BACnet object's control program that sends the value. The BACnet Analog Value microblock has a COV Increment of 0.5.

The logic in the network input's control program that receives the changing value. The SIGNAL analog network input's Address field contains the address of the BACnet Analog Value microblock sending the changing signal, and the network input's Refresh Time is 31 seconds.

To speed detection of a dead device

BETA

Page 14: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 12 © 2010 Automated Logic Corporation

1 Turn off the controller's power.

2 Check the communications wiring for shorts and grounds.

3 Connect the third-party device's communications wiring to the controller's screw terminals labeled Net +, Net -, and Shield.

NOTE Use the same polarity throughout the network segment.

4 If connecting to an ME812u-LGR, set the BACnet Mode jumper to ARC156.

5 Turn on the controller's power.

1 Turn off the controller's power.

2 Check the communications wiring for shorts and grounds.

3 Connect the third-party device's communications wiring to the controller.

For a... Connect wiring to... Set...

LGR25 LGR250 LGR-1000 ME-LGR25 ME-LGR200

Port S1 terminals labeled Net + and Net -

• MSTP on S1 DIP switch to Enable (ON)

• Port S1 jumpers to EIA-485 and 485-2w

ME812u-LGR BACnet port terminals labeled Net +, Net -, and Shield

BACnet Mode jumper to MSTP

NOTE Use the same polarity throughout the network segment.

4 Turn on the controller's power.

5 To change the port's baud rate, see "To set a port's baud rate using HyperTerminal" in the controller's Technical Instructions.

NOTE Use the same baud rate for all devices on the network segment.

6 Connect the third-party device to the ALC controller

To wire a BACnet/ARC156 device

To wire a BACnet MS/TP device BETA

Page 15: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 13 © 2010 Automated Logic Corporation

1 Turn off the controller's power.

2 Check the communications wiring for shorts and grounds.

3 Connect the third-party device's communications wiring to the controller.

For a... Connect wiring to... Set...

LGR25 LGR250 LGR-1000 ME-LGR25 ME-LGR200

Port S2 terminals labeled Tx, Rx, and Signal Ground

• PTP on S2 DIP switch to Enable (ON)

• Port S2 jumper to EIA-232

ME812u-LGR Port S1 terminals labeled Tx, Rx, and Signal Ground

• PTP on S1 DIP switch to Enable (ON)

• Enhanced Access Port DIP switch to Off

• Port S1 jumpers to EIA-232 and Full Duplex

NOTES

○ Jumper the DTR and DCD terminals.

○ Use the same polarity throughout the network segment.

4 Turn on the controller's power.

5 To change the port's baud rate, see "To set a port's baud rate using HyperTerminal" in the controller's Technical Instructions.

NOTE Use the same baud rate for all devices on the network segment.

Get the latest BACnet driver If you do not have the latest version of your ALC controller's driver, follow the steps below.

NOTE If your ALC controller is using a driver for another protocol, that driver will also allow you to integrate with BACnet points.

1 Get the latest module driver drv_melgr_vanilla_<latest version>.driver from the ALC website (http://accounts.automatedlogic.com). Go to Support > Download > Drivers > ExecB > LGR and ME-LGR line. Download the driver, saving it in WebCTRLx.x\webroot\<system_name>\drivers.

2 On SiteBuilder's Network tree, open the Device Properties dialog box for the ALC controller.

3 Select the ALC controller in the Device Definition drop-down list, then click OK.

4 On the Network tree, expand the controller, then double-click Driver.

5 Select drv_melgr_vanilla_<latest version> in the Driver Definition drop-down list, then click OK.

To wire a BACnet PTP device

7 Download the BACnet driver BETA

Page 16: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 14 © 2010 Automated Logic Corporation

Download the driver and control programs

1 In SiteBuilder, assign the equipment to the controller by dragging the equipment from the Geographic tree and dropping it on the controller in the Network tree.

2 In WebCTRL, download memory to the ALC controller.

NOTE If the third-party device is on a different IP network than the ALC controller, verify that BBMD's are configured appropriately for communication. See the ALC website (http://accounts.automatedlogic.com) for more information on BBMD's.

1 On WebCTRL's GEO tree, select the control program for the ALC controller.

2 Select the Properties page > Network Points tab.

If... Then...

You see the point value you expect with no errors in the Error column

You have successfully established communication with the third-party device.

A point shows question marks instead of values

WebCTRL is not communicating with the ALC controller or the control program. Troubleshoot the controller's communications. See the controller's Technical Instructions.

TIP If only display microblocks show question marks, verify that the Use Static Bindings checkbox on WebCTRL's System Settings > Communications tab is cleared.

The point name is red Look in the Error column for one of the following error codes and descriptions.

• 1 - Communications Disabled for this Microblock Enable the microblock's Communications Enabled field on WebCTRL's Network Points tab, on the microblock's Properties page > Details tab, or in EIKON LogicBuilder.

• 3 - Address Error - Unknown Protocol Specified Select the correct port on the driver page in WebCTRL, set the DIP switches correctly on the controller, or correct the Address field in the microblock.

8 Verify the controller is set up correctly

BETA

Page 17: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 15 © 2010 Automated Logic Corporation

If... Then...

A value is incorrect Verify that:

• The Address in the microblock is correct.

• The retrieved value is scaled properly, if necessary. For example, scaled from Celsius to Fahrenheit. Refer to the third-party manufacturer's documentation or the controller's Technical Instructions for scaling information.

If the above solutions do not resolve the problem, gather the following information for technical support:

• A diagnostic capture. See next topic.

• A screenshot of the driver Properties, IP Addressing, and Protocol pages

• A screenshot of the Properties page > Network Points tab and Display Points tab showing addresses and errors

• All information from a Modstat copied into a text file. Right-click the Modstat, then select Select All. Press Ctrl+C to copy the information, then open Notepad and paste the information into a text file.

Use BACScope, an ALC diagnostic tool, to capture the communication between the controller and the third-party device into a text file.

1 Get the latest version of BACScope from the ALC website (http://accounts.automatedlogic.com). Select Support > Download > Engineering and Startup Tools > Utilities > BACScope.

2 Unzip the files into a folder on your hard drive.

3 Double-click WinPcap_*_*.exe.

4 Follow the instructions in the installation wizard.

5 If running Windows 2000, reboot the computer.

6 Double-click BACScope.exe.

7 Select Configure > Setup Adapters.

8 Click Add.

9 Select the Connection Type of the network you are connected to and troubleshooting.

To get a diagnostic capture

BETA

Page 18: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 16 © 2010 Automated Logic Corporation

10 Enter appropriate values in each field. Your Connection Type determines which of the fields you will see.

Field Notes

Connection Name The name that will appear in the Configure > Adapter list.

Read from file Do not select this checkbox.

Capture Filter See WinPCap documentation.

Adapter Select the NIC (network interface card) that is connecting your computer to the problem device's network.

Baud Rate That matches your network.

Port The COM port on your computer that you use for the capture.

Capture Poll for Master Messages

Select this checkbox to capture BACnet MSTP token traffic.

Port Number The default, 47808, is the most commonly used UDP port number.

Passthrough Do not select this checkbox.

11 Click OK in the Setup Adapters dialog box.

12 Select Configure > Adapter > (adapter you created in steps 8–11).

13 If you do not see BACnet traffic on your BACscope screen after a few seconds, reboot your computer, then repeat steps 6 and 12.

14 While BACScope is recording communications, do the following: ○ Get a modstat. ○ Try to recreate the problem you are troubleshooting. If possible, correlate your

troubleshooting actions with particular lines in the BACScope capture. NOTE Record communications for about 5 times the longest refresh rate set in any microblock.

15 Select File > Save As.

16 Name the file with a .CBL extension, then save it to any folder.

TIP Include a brief description of the problem in the file name. For example, systemname_excessive_traffic, systemname_binding_conflicts, or systemname_slow_network.

17 Attach the following to your on-line case: ○ .CBL file ○ Device instance number of the problem device ○ Description of the problem

BETA

Page 19: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 17 © 2010 Automated Logic Corporation

The BACnet standard allows multiple formats for creating a valid address in each microblock that you use to read from or write to a third-party BACnet point. Some are shown below.

CAUTION When integrating third-party devices in a WebCTRL system, most communication problems are caused by incorrect data or typing errors in the microblock's Address field.

NOTE Numeric values in a BACnet address can be entered using decimal or hexadecimal notation. Type 0x before a hexadecimal value.

Device - Use one of the following: EXAMPLES

Device instance number bacnet://2010/…

BACnet device name bacnet://MyDevice/…

Network number: MAC address (of third-party device)

bacnet://1234:35/… bacnet://1234:0x23/…

The word "this" if a network point requests a value from another control program in the same ALC controller. Avoids network traffic. Requires v2.05 or later controller driver.

bacnet://this/…

Object - Use one of the following: EXAMPLES

Object type: Instance number (See NOTES below) BACnet object name

bacnet://…/ai:2 bacnet://…/MyObject

NOTES

• For object type, you may type the abbreviation (not case sensitive), the full name, or the object type number. Some standard BACnet object type numbers are listed below. See the BACnet standard for a complete list. For proprietary BACnet objects, see the object's manufacturer.

Appendix A: BACnet addresses

BETA

Page 20: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 18 © 2010 Automated Logic Corporation

Use... ai ao av bi bo bv dev msi mso msv

Or... analog-input analog-output analog-value binary-input binary-output binary-value device multistate-input multistate-output multistate-value

Or... 0 1 2 3 4 5 8 13 14 19

• Every object in a controller has a unique instance number, regardless of its control program.

Property (optional) If you want to read or write a property other than present_value, type one of the following:

EXAMPLES

BACnet property identifier BACnet property identifier # Property identifier (with index)

bacnet://…/…/cov_increment bacnet://…/…/22 bacnet://…/…/priority-array(12)

Property identifier # (with index) bacnet://…/…/87(12)

TIP For standard BACnet objects, see the BACnet standard for property identifiers and property identifier numbers. For proprietary BACnet objects, see the object's manufacturer.

Priority (optional) If you want to write at a priority other than 16, type @ followed by a priority number.

EXAMPLE

Number (1–16) bacnet://…/…/…@9

NOTE Priority levels 1 and 2 are reserved for manual and automatic life safety commands. For more information on reserved priority levels see the BACnet standard.

Examples of BACnet addresses:

bacnet://MyDevice/ai:2

bacnet://1234:0x23/analog-input:2/priority-array(12)@8

bacnet://2499:0x00E0C90047CA/bi:3

bacnet://2436:192.168.47.36:47806/0:2

BETA

Page 21: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 19 © 2010 Automated Logic Corporation

You can reuse a control program for multiple pieces of identical third-party equipment.

To reuse a control program for identical pieces of equipment:

1 In EIKON LogicBuilder, open the control program you want to reuse.

2 Add a Device Alias microblock.

3 In the Property Editor, type a meaningful character string such as the model number or name of the third-party device in the Device Alias field.

4 Select Control Program > Edit Common Properties > Display Points tab.

5 Select the All radio button.

6 Replace the numbers in the Device Alias column with the model number or name of the third-party device exactly as you typed it in step 3.

7 In SiteBuilder, assign this reusable control program to each instance of the third-party device.

8 In WebCTRL, for each instance of the third-party equipment, change the Device Alias microblock's Device Instance number to match each specific device.

Appendix B: To reuse a control program

BETA

Page 22: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 20 © 2010 Automated Logic Corporation

For WebCTRL to retrieve third-party data into a display microblock that must pass through one or more NAT routers, you must create a model of the third-party network on SiteBuilder’s Network tree.

1 In SiteBuilder, add the third-party equipment to the Geographic tree.

2 In the Equipment Properties dialog box, select the control program you created in EIKON LogicBuilder.

3 On the SiteBuilder Network tree, add (model) the third-party device.

NOTES

○ If the third-party device is on a different BACnet network than your ALC equipment, you must also add the third-party network.

○ If the third-party device is under a third-party router, you must add the third-party router and its network before adding the third-party device.

TIP For a third-party device on a different BACnet/IP network than any ALC devices, use BBMD's to communicate across an IP router. See the ALC website (http://accounts.automatedlogic.com) for more information on BBMD's.

4 On the SiteBuilder Network tree, in each third-party device’s Device Properties dialog box, General tab:

○ Type the Address and Device Instance information from the third-party vendor.

○ In the Device Definition field, select Third Party Device or Third Party Device Router.

NOTE To use NAT routing, you must select the Use Static BACnet Bindings field on WebCTRL's System Settings > Communications tab.

Appendix C: Third-party points behind NAT routers

BETA

Page 23: QURHRUVTaHNVeXN4Rm9HTHdqOEFUTzBLYjJHXzd5ZFk3LTRHemZ0UUtKS3Z1OTJuXzZ3cHd5aUlOb3FpUWR6cDFLZDRxUnk0TW9LZGExVE1ZRDJQcDMzZDdDTVVZZ1FtNDl4WXF3bFJTVTBkNGprb2JtQ3FQN1p0aEFHUldfS0dxSHVRbXVMZGZSVG0=

BACnet Integration Guide • Rev. 9/28/2010 21 © 2010 Automated Logic Corporation

The following controllers use point packs (100 points per pack): • LGE • LGRM-E • S line • M line • UNI • WebPRTL

NOTES

• The LGE, LGRM-E, and WebPRTL can communicate on any BACnet network type (IP, Ethernet, ARCNET, MS/TP, or PTP). See the router's Technical Instructions for details.

• S line, M line, and UNI controllers can communicate using BACnet on ARC156 or MS/TP networks. They can reference a third-party BACnet point on any network type if a BACnet route to the point exists.

• A controller that provides third-party points does not use point packs.

• A system can use both controllers that provide third-party points and controllers that use point packs.

EXAMPLES

For third-party BACnet integration in a system with this hardware...

Use...

LGE S6104 UNI M4106

Point packs. Any of these controllers can have control programs with Network I/O microblocks that reference third-party points.

LGR25 SE6104 UNI M4106

The LGR25 for the first 25 third-party points. You can add third-party points with:

• Additional controllers that provide third-party points.

• Point packs, if the control programs will be downloaded to the UNI or M4106.

ME-LGR200 SE6104 ZN551

The ME-LGR200 for the first 200 third-party points. You can add third-party points with additional controllers that provide third-party points.

LGR1000 SE6104 ZN551 M8102

The LGR1000 for the first 1000 third-party points. You can add third-party points with:

• Additional controllers that provide third-party points.

• Point packs, if the control programs will be downloaded to the M8102.

Appendix D: Point packs

BETA