BACnet Integration Guide for for LGR, ME-LGR, ME812u-LGR-BETA

BACnet Integration GuideFor an LGR line, ME-LGR line, or ME812u-LGR controller Rev. 9/28/2010 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. BE TA 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 © 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. BE TA Overview You can integrate BACnet devices into a WebCTRL system using one of the ALC controllers listed below that provide third-party points*. Ethernet. © 2010 Automated Logic Corporation . • 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. Then use Appendix A (page 17) to write correct BACnet address strings in your microblocks.  Verification that all communication settings have been set on the third-party device. The ALC controller serves as a master device. 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. 38400. 9/28/2010 BE  The third-party device's: 1 You need the following items. and downloading memory to the ALC controller TA * The point allowance of a controller (the number after the letter R) applies only to that controller. Before-you-begin checklist BACnet Integration Guide • Rev. or 76800 kbps). MS/TP (9600.  Experience creating control programs with EIKON LogicBuilder  Experience installing. ARCNET. information. wiring. ALC Controllers LGR25 LGR250 LGR-1000 ME-LGR25 ME-LGR200 ME812u-LGR (200 points) Read/write capability Third party Supported equipment Supported media Can read from and write to the third-party equipment Any device that supports the BACnet protocol IP. and PTP If you have legacy ALC controllers that use point packs. ask the third-party vendor for this information. you cannot apply the unused 500 points to a different controller. and skills for the integration process:  The system's SiteBuilder database.  The baud rate of the third-party device if running MS/TP. see Appendix D (page 21). setting up. For example.  The ALC controler's Technical Instructions. 19200. and objects WebCTRL’s BACnet Discovery locates all accessible BACnet networks. select Connections. TIP Run a commstat manual command to determine which device routes to each network. then click Go. close the status dialog box. 12 To discover BACnet objects on a device. After all devices are found. 9/28/2010 BE 2 On the BACnet Discovery tab. see the controller’s Technical Instructions. The BACnet Bind Show Network section of the Commstat window shows the IP address of the router to each network. close the status dialog box. select System Settings. 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. An item called Discovered Networks appears in the tree. close the status dialog box. click Go to discover BACnet sites for the system. A list of all BACnet networks appears in the NET tree. enter or verify the server's IP Address and Subnet Mask for the BACnet/IP connection. select Discovered Networks. select a network on the NET tree. TA © 2010 Automated Logic Corporation . 3 4 5 6 7 8 9 BACnet Integration Guide • Rev. While the connection is stopped. A list of all BACnet objects in this device appears on the NET tree. On the Communications tab. devices. See "To build a Network tree" in SiteBuilder Help. 11 To discover BACnet devices on a network. BACnet devices. stop the BACnet/IP connection. 10 To discover BACnet networks. To use BACnet Discovery: 1 2 On the WebCTRL CFG tree. On the Configure tab. 1 Discover BACnet networks. Click Devices. Restart the connection. and BACnet objects (including devices in your WebCTRL system) on a BACnet network. ○ Using NAT routing. After all networks are found. then click Go. clear the Use Static BACnet Bindings checkbox so that bindings are dynamic. select the device in the NET tree.The integration process Follow the steps in this document to integrate one or more third-party BACnet devices into a WebCTRL system using an ALC controller. select the system level. then click Go. close the status dialog box. After all objects are found. To install and network the ALC controller. After all sites are found. On WebCTRL's CFG tree. Click the plus sign beside an item to expand the list of devices. On the NET tree. such as multiple points with similar names. • 2 Create a control program • • • BACnet Integration Guide • Rev. Device configuration or network load can prevent WebCTRL from showing all BACnet devices. Both Network I/O and Display microblocks count against the 500-point limitation of WebCTRL 500. you must get the device's address and point list information from the third-party vendor. try the discovery process again. TA © 2010 Automated Logic Corporation . 14 Click the Export button to export the BACnet information.discovery file in any folder. If the configurations are correct. select a discovered network with devices or a single device. 13 On the NET tree. You want to display third-party values that require unit conversion or other math processing. If you do not see a BACnet device that you expect to see. including the logic that a thermographic floorplan requires. 9/28/2010 BE NOTES • • • • 3 Use Network I/O microblocks and Display microblocks to read from or write to BACnet objects in a third-party BACnet device. NOTES • • • Some third-party BACnet devices may not be discovered because they do not support the BACnet methods required for auto discovery. Display microblocks cannot use logic. 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. 15 Name and save the . You want to trend values from a third-party device that does not support BACnet trends. It may take some time to discover objects in devices with more than 100 objects. If the discovery process returns ambiguous information. Then use Appendix A (page 17) to write correct BACnet address strings for your microblocks. contact the third-party manufacturer's representative for clarification. Each Network I/O microblock that is addressed to a third-party object property counts against the point limit of an ALC controller.TIP Make sure you are discovering objects in the correct device. Display microblocks do not count against the point limits of ALC controllers. If a third-party device is not discoverable. check the system's BBMD configurations. then click OK.To create a control program: 1 2 3 4 5 6 7 Go to Start > All Programs > WebCTRL 5.3pbu file in any folder.discovery file that you exported from WebCTRL's BACnet Discovery tool. In the Name field. NOTE You can use the Check All and Uncheck All buttons to the far right. Select File > Save as. © 2010 Automated Logic Corporation .3pbu file. 13 Select the checkbox by each control program that you want to generate. Name and save the . type the name of the . Select File > Import. 12 Browse to the control programs Destination Directory.equipment file that you want to create. TIPS BACnet Integration Guide • Rev. Browse to the . NOTE You can repeat steps 6 and 7 to add multiple control programs to the .2 > Third-Party BACnet Utility. Keyboard shortcuts are shown beside their corresponding commands in the dropdown menus. Shift+click. Select Control Program > Add Control Program. 8 9 Click to highlight one or more control programs in the Control Programs to Generate list. TA 10 Click . or Ctrl+click to select the point(s) you want to add to the control program(s). 11 Select Control Program > Generate Control Programs. Click. 9/28/2010 BE • • 4 Move the divider bar to adjust the size of the size of the panes. To prioritize sorting by multiple columns. Then Ctrl+click Object Instance to sort each section of object types by instance numbers. but will not delete microblocks that you deleted in the Third-Party BACnet Utility. hold down Ctrl as you click headings. Then Ctrl+click Object Type to sort each Device ID’s object types. • Make the Discovered BACnet Objects list easier to view by selecting BACnet Objects > Filter Properties. then selecting Move to or Copy to. select File > Open. Select Control Program > Generate Control Programs. TA © 2010 Automated Logic Corporation . • • • 3 Edit a control program BACnet Integration Guide • Rev. 9/28/2010 BE 1 2 3 Make changes as needed. To edit a control program in the Third-Party BACnet Utility In the Third-Party BACnet Utility. NOTE The Generate Control Programs command will add microblocks that you added. The size of the triangles indicate the sorting priority. the utility will add a new microblock when you generate the control program. To find an object in the opposite pane. then select the Show hidden objects checkbox. To edit a control program in EIKON LogicBuilder In EIKON LogicBuilder. Rearrange the columns by dragging and dropping a heading cell. Select the .equipment file that you want to edit. For example: Click Device ID to sort the rows by third-party devices. select File > Open. Hide selected objects by right-clicking one of the selected objects then selecting Hide object. go to BACnet Objects > Filter Properties.3pbu file that contains the control program(s) you want to edit. Move or copy objects from one control program to another by right-clicking the selected object(s). then select Find Usages. 4 5 Save the control program(s). To reveal the hidden objects. Click a column heading to sort the rows by the information in that column. right-click the object. Then select or clear checkboxes to show only the information you need. NOTE If you change a microblock's reference name. Or. you can edit an existing control program to integrate with a third-party BACnet device. Select the . 1 2 5 You can edit a control program created with the Third-Party BACnet Utility in the utility itself or in EIKON LogicBuilder.• • • • Change the width of a column by dragging the bar between column headings. in EIKON LogicBuilder. c. See COV increment in the example below. Add a Network I/O or Display microblock. and Write to field checkboxes. Click Set Address to assign object properties to the microblock. Editable. f. 4 Configure Display microblocks BACnet Integration Guide • Rev. Select an object in the Discovered BACnet Objects list. TA © 2010 Automated Logic Corporation . In EIKON LogicBuilder. e. 7 Save the file. Do one of the following: Change an existing microblock a. In the Third Party Addresses window. Click Change Microblock. b. b. in the Property Editor of a microblock. the desired property must be present and be editable (not marked "Read only") in the third-party object. select the Only show objects that match selected microblock checkbox. Click OK. Optional: Choose Change Type Only or Change Type And Set Address.discovery file that contains the BACnet object you want to add or change. Select a different microblock type from the drop-down list. Select an existing microblock. c.3 4 5 6 Select Edit > Third Party BACnet Addresses. select Present (if the optional property exists in the third-party device). 9/28/2010 BE 6 To allow an operator to change a third-party object's property from the WebCTRL interface through a Display microblock. Browse to the . Select a point in the Discovered BACnet Objects list. d. OR Add a new microblock a. your graphic will display 0 or 1 even if you select the Present checkboxes.The Display microblocks in the table below require special configuration. BACnet Integration Guide • Rev. clear the Array Resize Write Index and Array Resize Write Past End checkboxes. NOTE A third-party device may not retain alarm recipient information through a power loss or memory download. select the Schedule Category of the WebCTRL schedule that will write to the third-party object. 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. In the Event Enrollment or Notification Class microblock. do the following: 1 2 In EIKON LogicBuilder. In the BACnet Modeled Event Enrollment microblock. Schedule If you want a WebCTRL schedule to write to a third-party BACnet-schedule object through a BACnet modeled schedule object. © 2010 Automated Logic Corporation . select the Editable and Write to field checkboxes for Recipient List. select the Present. you must configure the third-party device to send alarms to WebCTRL. select the Present checkboxes. You can use a BACnet Modeled Event Enrollment microblock to view the status of a third-party BACnet Event Object. and Write to field checkboxes for Weekly Schedule and Exception Schedule. select the Standard Template for the best results on your WebCTRL Alarms View tab. In the Property Editor. Editable. 9/28/2010 BE Event Notification 1 2 7 TA NOTES • • Only ALC-manufactured devices support ALC Dated Weekly schedules. If you want the third-party device to deliver its alarms to the WebCTRL Alarms View tab. NOTE If the third-party device does not support this feature. If you get an error in WebCTRL. Binary Output 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 Binary Value 0 and 1. Define the recipient. 4 5 Field Recipient Type Time section Device Object Identifier Process Identifier Issue Confirmed Notification Trend 5 Configure Network I/O microblocks Setting up network inputs Polling or BACnet COV BACnet Integration Guide • Rev. Enter your WebCTRL system's BACnet Alarm Recipient instance number. Polling—The microblock reads the property at the Refresh Time interval using the BACnet ReadProperty or ReadPropertyMultiple service (see "Method 1: Polling" below). Type 1. To set up TA 8 If the third-party trend does not display correctly. Generate an alarm at the third-party device to verify that you see the alarm delivered to your WebCTRL Alarms View tab. Set the microblock's Refresh Time to 30 seconds or less. the microblock reads the property's value using one of the following methods. Select this checkbox. change the Trend Conformance Level to Default. on the Properties page Details tab for a device's BACnet Modeled Notification Class microblock or an event's BACnet Modeled Event Enrollment microblock. See field descriptions below. click Add. © 2010 Automated Logic Corporation .3 In WebCTRL. Method 1: Polling Benefits Drawbacks • • • • • Allows rapid detection of a dead device or of network problems Does not require additional memory 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). BACnet COV (Change of Value) subscription—The microblock subscribes with the target BACnet object. 9/28/2010 BE • • If a network input or totalizer microblock's Address field references a BACnet object property. A binary target notifies the microblock when it changes state (see "Method 2: BACnet COV subscriptions" below). An analog target notifies the microblock if the target's value changes by more than the target's BACnet COV_Increment. The BACnet object must send the value to each microblock that polls for that data. Notes Select Device. Select the days and define the hours that the third-party device should send alarms to WebCTRL. the target sends COV notifications directly to that subscriber. WebCTRL shows the time remaining until the input's next subscription in the Next Subscription field on the input's WebCTRL Properties page. 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. it broadcasts its COV notifications to optimize network traffic. TA If the microblock's Address field references an analog property. See step 2 in "To set up" below. the ALC target maintains and responds to the third-party subscription separately with its own Lifetime timer. 9/28/2010 BE COV subscription details 9 NOTE If COV subscription fails. See "Method 1: Polling" above. Otherwise. and the remote controller supports the service. If the ALC target has more than one subscriber. The target responds with a COV notification that includes the target's value and time remaining from the original subscription Lifetime (TimeRemaining). the input sets a 21-minute subscription Lifetime in the target. Method 2: BACnet COV subscriptions Benefits Drawbacks To set up • • • 1 2 Can decrease network traffic by preventing unnecessary updates if the target's COV_Increment is set appropriately. the Refresh Time in two or more microblocks expires at the same time. BACnet ReadProperty and ReadPropertyMultiple services See the BACnet specification for details on the ReadProperty and ReadPropertyMultiple services. When an input (network input or totalizer microblock) subscribes with a BACnet target (object property). If the ALC target has one subscriber. Can generate excessive network traffic if the target's COV_Increment property is too small. set the target's COV_Increment property to the smallest amount by which the value must change for the target to notify its subscribers. ReadPropertyMultiple occurs if: • • • two or more microblocks in a controller read more than one target in the same remote controller. Can delay detection of a dead device or of network problems Set the microblock's Refresh Time to 31 seconds or more. BACnet Integration Guide • Rev. See step 2 in "To set up" below. the microblock reads the value at the Refresh Time interval using the BACnet ReadProperty or ReadPropertyMultiple service. A third-party subscriber can participate in this broadcast scheme by subscribing for Unconfirmed COV notifications with a Process ID of 0.NOTE The ALC microblock will not poll at a Refresh Time interval smaller than 1 second. © 2010 Automated Logic Corporation . The input resubscribes with the target every 10 minutes to keep the target's BACnet subscription service active. 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. which could happen if the last subscribing input loses communication with the target.2 = 8 21 > 8 + 11.3 = 7 18 ≤ 7 + 11 so keep current value of 7 7-7=0 resubscribe 10 21 ≤ 10 + 11. the input resubscribes immediately. so keep current value of 10 18 ≤ 15 + 11 so keep current value of 15 15 . This allows the COV Subscription request from the last subscribing input to keep the subscription service active for all subscribers to the same data. When the absolute value of the difference between the property's TA 21 21 . NOTE If an input receives COV notification with a target TimeRemaining < 11. EXAMPLE Elapsed Action time (minutes) 0 0 Input 1 subscribes to target Target broadcasts COV notification because Input 1 subscribed Input 2 subscribes to target Target broadcasts COV notification because Input 2 subscribed Target Lifetime TimeRemaining (minutes) 21 (Input 1) 21 Input 1 Next Subscription (minutes) 10 21 ≤ 10 + 11. so add 10 to current value of 8 8 + 10 = 18 10 . the input adds 10 minutes to its Next Subscription time. so keep current value of 10 10 . If another input has subscribed more recently. so keep current value of 10 Input 2 Next Subscription (minutes) 0 3 0 BACnet Integration Guide • Rev.7 = 8 8 21 > 8 + 11.7 = 11 21 (Input 2) 21 10 2 21 (Input 2) 18 .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.3 = 15 © 2010 Automated Logic Corporation . 9/28/2010 BE Target broadcasts COV notification because value changed 7 0 0 Input 2 resubscribes Target broadcasts COV notification because Input 2 subscribed Input 2 keeps the subscription service active at the target with a minimum of network traffic.3 = 18 18 18 . so add 10 to current value 8 + 10 = 18 10 21 ≤ 10 + 11. COV notification rate COV notifications from a BACnet object property are controlled by that property's BACnet COV_Increment. 5. The logic in the network input's control program that receives the changing value. To use the benefits of BACnet COV subscription. 1 2 The control program's execution rate determines how often the check against COV_Increment is performed.Present_Value and the value sent in the last COV notification is greater than the COV_Increment. or © 2010 Automated Logic Corporation . and the network input's Refresh Time is 31 seconds. 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. • the Refresh Time expires. The SIGNAL analog network input's Address field contains the address of the BACnet Analog Value microblock sending the changing signal. Once the entire list of pending notifications is serviced. the rate of notifications is further limited by two internal processes. TA To speed detection of a dead device If a BACnet object's device loses network communication. the controller inserts another 50 millisecond delay. the object broadcasts a COV notification. send a constantly changing value from the BACnet object's control program to a network input using BACnet COV subscription. The BACnet Analog Value microblock has a COV Increment of 0. 9/28/2010 BE 11 The logic in the BACnet object's control program that sends the value. The controller's pending COV Notification task has built-in delays to prevent COV notifications from consuming the controller's CPU processing time. if polling You can use a small Refresh Time to poll more often. the controller inserts a 50 millisecond delay after each set of 15 notifications. the network input's control program generates an alarm. EXAMPLE BACnet Integration Guide • Rev. but this can generate unnecessary network traffic under normal conditions. For ALC controllers. The built-in delays are as follows: If more than 15 COV notifications are pending delivery. This results in a maximum COV notification rate of 300 COV notifications per second per ALC controller. If the value stops changing. but overcome the potential delay in detection of a dead device. If connecting to an ME812u-LGR. NOTE Use the same baud rate for all devices on the network segment. Connect the third-party device's communications wiring to the controller. Net -. 9/28/2010 TA BACnet Mode jumper to MSTP © 2010 Automated Logic Corporation . set the BACnet Mode jumper to ARC156. NOTE Use the same polarity throughout the network segment. Turn on the controller's power.6 Connect the third-party device to the ALC controller To wire a BACnet/ARC156 device 1 2 3 Turn off the controller's power.. and Shield. To change the port's baud rate.. BACnet Integration Guide • Rev.. Port S1 terminals labeled Net + and Net Set... see "To set a port's baud rate using HyperTerminal" in the controller's Technical Instructions. Connect the third-party device's communications wiring to the controller's screw terminals labeled Net +. • • BACnet port terminals labeled Net +. LGR25 LGR250 LGR-1000 ME-LGR25 ME-LGR200 ME812u-LGR 4 5 Turn on the controller's power. 4 5 To wire a BACnet MS/TP device BE 1 Turn off the controller's power. Check the communications wiring for shorts and grounds. Net -. 12 Check the communications wiring for shorts and grounds. 2 3 For a. and Shield MSTP on S1 DIP switch to Enable (ON) Port S1 jumpers to EIA485 and 485-2w NOTE Use the same polarity throughout the network segment.. Connect wiring to. 7 Download the BACnet driver BACnet Integration Guide • Rev.automatedlogic. Select drv_melgr_vanilla_<latest version> in the Driver Definition drop-down list. see "To set a port's baud rate using HyperTerminal" in the controller's Technical Instructions. On SiteBuilder's Network tree. 9/28/2010 BE Get the latest BACnet driver 1 2 3 4 5 13 If you do not have the latest version of your ALC controller's driver. Go to Support > Download > Drivers > ExecB > LGR and ME-LGR line. that driver will also allow you to integrate with BACnet points. On the Network tree.. 4 5 Turn on the controller's power. Get the latest module driver drv_melgr_vanilla_<latest version>. follow the steps below. For a.. Check the communications wiring for shorts and grounds. LGR25 LGR250 LGR-1000 ME-LGR25 ME-LGR200 ME812u-LGR Connect wiring to. saving it in WebCTRLx. and Signal Ground • • • NOTES ○ ○ PTP on S2 DIP switch to Enable (ON) Port S2 jumper to EIA-232 PTP on S1 DIP switch to Enable (ON) Enhanced Access Port DIP switch to Off Port S1 jumpers to EIA-232 and Full Duplex Jumper the DTR and DCD terminals. Use the same polarity throughout the network segment.. Download the driver. open the Device Properties dialog box for the ALC controller. then click OK. NOTE Use the same baud rate for all devices on the network segment. • • Port S1 terminals labeled Tx. Select the ALC controller in the Device Definition drop-down list. then click OK.driver from the ALC website (http://accounts.x\webroot\<system_name>\drivers.com). TA © 2010 Automated Logic Corporation .. NOTE If your ALC controller is using a driver for another protocol.To wire a BACnet PTP device 1 2 3 Turn off the controller's power.. Rx. then double-click Driver. Rx. Port S2 terminals labeled Tx.. Connect the third-party device's communications wiring to the controller. and Signal Ground Set. To change the port's baud rate. expand the controller. TIP If only display microblocks show question marks. You see the point value you expect with no errors in the Error column BACnet Integration Guide • Rev. or correct the Address field in the microblock. select the control program for the ALC controller.. 3 .Download the driver and control programs 1 2 In SiteBuilder. You have successfully established communication with the third-party device. or in EIKON LogicBuilder.automatedlogic.. See the ALC website (http://accounts.. set the DIP switches correctly on the controller. Troubleshoot the controller's communications. assign the equipment to the controller by dragging the equipment from the Geographic tree and dropping it on the controller in the Network tree. See the controller's Technical Instructions. Look in the Error column for one of the following error codes and descriptions. 8 Verify the controller is set up correctly 1 2 If. © 2010 Automated Logic Corporation . 1 .. On WebCTRL's GEO tree.Unknown Protocol Specified Select the correct port on the driver page in WebCTRL.Communications Disabled for this Microblock Enable the microblock's Communications Enabled field on WebCTRL's Network Points tab.Address Error . In WebCTRL. 9/28/2010 BE The point name is red • • 14 A point shows question marks WebCTRL is not communicating with the ALC controller instead of values or the control program. verify that BBMD's are configured appropriately for communication. on the microblock's Properties page > Details tab. verify that the Use Static Bindings checkbox on WebCTRL's System Settings > Communications tab is cleared. NOTE If the third-party device is on a different IP network than the ALC controller. Select the Properties page > Network Points tab. TA Then. download memory to the ALC controller.com) for more information on BBMD's. exe.automatedlogic. then open Notepad and paste the information into a text file. Unzip the files into a folder on your hard drive. and Protocol pages A screenshot of the Properties page > Network Points tab and Display Points tab showing addresses and errors BACnet Integration Guide • Rev. gather the following information for technical support: • • • • A diagnostic capture.. If running Windows 2000. IP Addressing.. Get the latest version of BACScope from the ALC website (http://accounts. TA All information from a Modstat copied into a text file.exe. For example. 9/28/2010 BE 1 2 3 4 5 6 7 8 9 Double-click WinPcap_*_*. Follow the instructions in the installation wizard. Right-click the Modstat. reboot the computer. Press Ctrl+C to copy the information. Verify that: • • The Address in the microblock is correct. scaled from Celsius to Fahrenheit. if necessary. to capture the communication between the controller and the third-party device into a text file. then select Select All. © 2010 Automated Logic Corporation . See next topic. Select the Connection Type of the network you are connected to and troubleshooting. The retrieved value is scaled properly. Select Configure > Setup Adapters.. 15 To get a diagnostic capture Use BACScope. Refer to the third-party manufacturer's documentation or the controller's Technical Instructions for scaling information. Double-click BACScope. Select Support > Download > Engineering and Startup Tools > Utilities > BACScope.com). A screenshot of the driver Properties. A value is incorrect Then.. Click Add. an ALC diagnostic tool.If. If the above solutions do not resolve the problem. 16 14 While BACScope is recording communications. The default. 16 Name the file with a . For example. Field Connection Name Read from file Capture Filter Adapter Baud Rate Port Capture Poll for Master Messages Port Number Passthrough Notes The name that will appear in the Configure > Adapter list. The COM port on your computer that you use for the capture. is the most commonly used UDP port number. reboot your computer. See WinPCap documentation. then repeat steps 6 and 12. Select this checkbox to capture BACnet MSTP token traffic. Your Connection Type determines which of the fields you will see. NOTE Record communications for about 5 times the longest refresh rate set in any microblock.10 Enter appropriate values in each field. then save it to any folder. Do not select this checkbox. Select the NIC (network interface card) that is connecting your computer to the problem device's network. systemname_excessive_traffic. 47808.CBL file ○ Device instance number of the problem device ○ Description of the problem TA © 2010 Automated Logic Corporation . BACnet Integration Guide • Rev. do the following: ○ Get a modstat. Do not select this checkbox.CBL extension. 13 If you do not see BACnet traffic on your BACscope screen after a few seconds. or systemname_slow_network. 9/28/2010 BE 15 Select File > Save As. systemname_binding_conflicts. That matches your network. correlate your troubleshooting actions with particular lines in the BACScope capture. If possible. TIP Include a brief description of the problem in the file name. 11 Click OK in the Setup Adapters dialog box. 17 Attach the following to your on-line case: ○ . 12 Select Configure > Adapter > (adapter you created in steps 8–11). ○ Try to recreate the problem you are troubleshooting. For proprietary BACnet objects.Use one of the following: For object type. the full name.05 or later controller driver. you may type the abbreviation (not case sensitive). CAUTION When integrating third-party devices in a WebCTRL system. TA EXAMPLES EXAMPLES bacnet://2010/… bacnet://MyDevice/… bacnet://1234:35/… bacnet://1234:0x23/… bacnet://this/… bacnet://…/ai:2 bacnet://…/MyObject © 2010 Automated Logic Corporation . or the object type number. NOTE Numeric values in a BACnet address can be entered using decimal or hexadecimal notation. Object . Device . Requires v2. most communication problems are caused by incorrect data or typing errors in the microblock's Address field. Some are shown below. 9/28/2010 17 The word "this" if a network point requests a value from another control program in the same ALC controller.Appendix A: BACnet addresses 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. Avoids network traffic. See the BACnet standard for a complete list. Some standard BACnet object type numbers are listed below.Use one of the following: Device instance number BACnet device name Network number: MAC address (of third-party device) BE Object type: Instance number (See NOTES below) BACnet object name NOTES • BACnet Integration Guide • Rev. Type 0x before a hexadecimal value. see the object's manufacturer. see the BACnet standard for property identifiers and property identifier numbers.36:47806/0:2 TA bacnet://…/…/cov_increment bacnet://…/…/22 bacnet://…/…/priorityarray(12) bacnet://…/…/87(12) © 2010 Automated Logic Corporation ... 0 1 2 3 4 5 8 13 14 19 Every object in a controller has a unique instance number. Priority (optional) If you want to write at a EXAMPLE priority other than 16. For proprietary BACnet objects. For more information on reserved priority levels see the BACnet standard. 9/28/2010 18 TIP For standard BACnet objects. regardless of its control program. see the object's manufacturer. bacnet://…/…/…@9 NOTE Priority levels 1 and 2 are reserved for manual and automatic life safety commands. analog-input analog-output analog-value binary-input binary-output binary-value device multistate-input multistate-output multistate-value Or..47. type one of the following: BACnet property identifier EXAMPLES BACnet property identifier # Property identifier (with index) Property identifier # (with index) BE Number (1–16) Examples of BACnet addresses: bacnet://MyDevice/ai:2 BACnet Integration Guide • Rev. bacnet://1234:0x23/analog-input:2/priority-array(12)@8 bacnet://2499:0x00E0C90047CA/bi:3 bacnet://2436:192..168. Property (optional) If you want to read or write a property other than present_value. type @ followed by a priority number.Use. ai ao av bi bo bv dev msi mso msv • Or... type a meaningful character string such as the model number or name of the third-party device in the Device Alias field. In SiteBuilder.Appendix B: To reuse a control program You can reuse a control program for multiple pieces of identical third-party equipment. assign this reusable control program to each instance of the third-party device. 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. 9/28/2010 BE 19 © 2010 Automated Logic Corporation TA . Add a Device Alias microblock. BACnet Integration Guide • Rev. To reuse a control program for identical pieces of equipment: 1 2 3 4 5 6 7 8 In EIKON LogicBuilder. In the Property Editor. change the Device Alias microblock's Device Instance number to match each specific device. In WebCTRL. Select Control Program > Edit Common Properties > Display Points tab. for each instance of the third-party equipment. open the control program you want to reuse. Select the All radio button. you must select the Use Static BACnet Bindings field on WebCTRL's System Settings > Communications tab. add the third-party equipment to the Geographic tree. General tab: ○ ○ Type the Address and Device Instance information from the third-party vendor.Appendix C: Third-party points behind NAT routers For WebCTRL to retrieve third-party data into a display microblock that must pass through one or more NAT routers. © 2010 Automated Logic Corporation . In the Device Definition field. In the Equipment Properties dialog box. 1 2 3 In SiteBuilder. select the control program you created in EIKON LogicBuilder. BACnet Integration Guide • Rev. See the ALC website (http://accounts. 9/28/2010 BE 20 NOTE To use NAT routing. select Third Party Device or Third Party Device Router. 4 On the SiteBuilder Network tree. add (model) the third-party device. If the third-party device is under a third-party router. On the SiteBuilder Network tree. you must also add the third-party network. TA 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. in each third-party device’s Device Properties dialog box. you must create a model of the third-party network on SiteBuilder’s Network tree.com) for more information on BBMD's. you must add the third-party router and its network before adding the third-party device. NOTES ○ ○ If the third-party device is on a different BACnet network than your ALC equipment.automatedlogic. MS/TP. if the control programs will be downloaded to the UNI or M4106. Any of these controllers can have control programs with Network I/O microblocks that reference third-party points. The LGR1000 for the first 1000 third-party points. or PTP). if the control programs will be downloaded to the M8102.. Point packs. They can reference a third-party BACnet point on any network type if a BACnet route to the point exists.. Point packs. 9/28/2010 BE LGR25 SE6104 UNI M4106 • • ME-LGR200 SE6104 ZN551 LGR1000 SE6104 ZN551 M8102 • • 21 TA Use. • EXAMPLES For third-party BACnet integration in a system with this hardware. and WebPRTL can communicate on any BACnet network type (IP. and UNI controllers can communicate using BACnet on ARC156 or MS/TP networks. The LGR25 for the first 25 third-party points. You can add third-party points with: Additional controllers that provide third-party points. • A controller that provides third-party points does not use point packs.. You can add third-party points with: Additional controllers that provide third-party points.Appendix D: Point packs The following controllers use point packs (100 points per pack): • • • • • • LGE LGRM-E S line M line UNI WebPRTL NOTES • • The LGE. S line. M line. Ethernet. The ME-LGR200 for the first 200 third-party points. Point packs. You can add third-party points with additional controllers that provide third-party points.. See the router's Technical Instructions for details. LGRM-E. LGE S6104 UNI M4106 BACnet Integration Guide • Rev. A system can use both controllers that provide third-party points and controllers that use point packs. © 2010 Automated Logic Corporation . ARCNET.