WEBfactory 2010
Contents
1. 08 00 REAL DATA_TYPE_REAL DATA_TYPE_REAL DATA_TYPE_REAL DATA_TYPE_REAL 09 00 07 00 00 000 1 07 00 00 000 07 00 00 000 07 00 00 000 07 00 00 000 10 00 11 00 12 00 13 00 14 00 15 00 16 00 17 00 18 00 19 00 20 00 21 00 10 0 1 To j Jo 22 00 DATA_TYPE_REAL DATA TYPE REAL DATA_TYPE_REAL MDATA TYPE REAL DATA REAL 23 00 21 00 00 000 21 00 00 000 21 00 00 000 21 00 00 000 21 00 00 000 BACnet Configuration panel To name the schedule input the name in the Name textbox To set the period of repetition for a weekly schedule use the Effective Period drop down menu and enter the Start Date and the End Date Use the Save changes button from the bottom of the panel to save any modifications or Reset changes to reset to the default configurations Any change in the BACnet Scheduler must be saved in order to be preserved The Save changes buiton is located at the bottom of the configuration panel The main area of the configuration panel is represented by a tabbed grid The three tabs are ZNEl Microsoft bilib 36 WWW WE bfactory world de GOLD CERTIFIED ra Sol banana Yendar 154 Partner WEBfactory Weekly Schedule allows the user to plan schedule over the week days the weekly schedule repeats over the Effective Period To create a new event right click in the grid2. Independent Solbware 154 12 www webfactory world de GOLD CERTIFIED Partner WEBfactory If object COV should be used than COV parameter Object section should be 1 otherwise it should be 0 If property COV should be used that COV parameter in Property section should be 1 otherwise it should be 0 Both COV and COV P device generated messages with new property values could be of a type that requires or not confirmation from the connector hence confirmed or not confirmed COV Confirmed COV is more immune to loss of packets If confirmed COV COV P is used the COVConfirmed parameter in Object section should be 1 otherwise it should be 0 When a COV COV P operation is ordered from the device some devices immediately send current value of relevant properties at the moment the order was made However other devices don t send property value until later when it changes If device does not send property value in the time when COV COV P was ordered this value must be read though just once In the configuration file parameter COV1Read inside Device section should be 1 if such reading of property value is necessary otherwise it should be O COVPeriod parameter inside Device section specifies period in milliseconds after which COV COV P operation order would be considered to be expired by the device The connector will use this time period information to re
3. 1 vts Time Value List Time Value 00 00 00 000 Add Time Value Delete Time Value Single Date exception Date Range exceptions specify range of time over which the value of the signal will be altered 39 www webfactory world de GOLD Partner 7 Independent Solbware verdar 154 WEBfactory Start date End date Seit Date Month Unspecified Month Unspecified ver Day Of Week Unspecified Day Of Week Unspecified gt Event Priority 1 Time Value List Time Value Add Time Value Delete Time Value in Date Range exception Week and Day specifies a certain month week day when the value of the signal will be altered Month February Ka Week Of Month Week i5 To 21 Day Of Week Thursday 2 1 Event Enonty 7 b 1 l l 1 I I 1 l 1 Time Value List Add Time Value Delete Time Value Week and Day exception Calendar Reference exception specify exception dates imported from an existing calendar object Calendar HOLIDAY C96 Event Priority 14 4 1 I l I l 1 l I 1 I aL l 1 Time Value List Time Value 00 00 00 000 15 5 Add Time Value Delete Time Value Calendar Reference exception Device Object Property References displays a grid of property for the discovered devices ZVEl Mobility Indepe
4. 2 copy CU sers Aderurestestars ape Documents WERtactory 2010 Smart Editor Projects netScheduier BAC uer Web Budd cheer C Usert Admrenstrator w epc Dooemerts WE factory 2010 Smart Ed or Projects 1 Alejo copied succeeded 2 Warrengts O Time Haosed 00000355 BACnet Scheduler in Smart Editor In the Property Inspector panel under the Configuration category there are two properties of the WFBacnetScheduler control ZVEl Mobility Independent Soelbaare Yendar 154 Microsoft 33 www webfactory world de GOLD CERTIFIED WEBfactory SearchDeviceMinimumTime e SearchDeviceTimeout The project is ready to be run now Pres F5 or click on the Run button from the top bar to run the project The BACnet scheduler will open in the browser window Discovered devices Schedule configuration modified 4 ER 1 Set Point Winter 2 Writsble 5 27 1 Houpay cos 9 2 Wrtable C Set Powt Winter Schedule Schedule Effect ve AHO 20 4 Present Value Sunday 15 5 11 15 5 01 00 DATA_TYPE_REAL DATA TYPE REAL 02 00 00 00 00 000 00 00 00 000 03 00 04 00 05 00 06 00 07 00 715 5 15 5 1935 5 15 5 15 5 08 00 DATA_TYPE_REAL DATA TYPE REAL DATA TYPE REAL DATA REAL DATA REAL 09 00 07 00 00000 07 0
5. OBJ MULTISTATE VALUE PROP PRESENT VALUE COV PROP NUMBER OF STATES PROP RELINQUISH DEFAULT PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE OBJ NOTIFICATION CLASS PROP NOTIFICATION CLASS 17 www webfactory world de GOLD CERTIFIED Partner 7 Independent Solbware verdar 154 WEBfactory OBJ PROGRAM PROP OUT OF SERVICE OBJ PULSE CONVERTER PROP PRESENT VALUE PROP SCALE FACTOR PROP ADJUST VALUE PROP COV INCREMENT PROP HIGH LIMIT PROP LOW LIMIT PROP DEADBAND PROP COUNT PROP COUNT BEFORE CHANGE PROP COV PERIOD PROP NOTIFICATION CLASS PROP TIME DELAY PROP OUT OF SERVICE OBJ SCHEDULE PROP OUT OF SERVICE OBJ TRENDLOG PROP LOG INTERVAL PROP COV RESUBSCRIBE INTERVAL PROP NOTIFICATION CLASS PROP LOG ENABLE PROP STOP WHEN FULL PROP BUFFER SIZE PROP RECORD COUNT PROP TOTAL RECORD COUNT PROP NOTIFICATION THRESHOLD PROP RECORDS SINCE NOTIFY PROP LAST NOTIFY RECORD Microsoft 18 www webfactory world de GOLD CERTIFIED Partner 7 Independent Solbware verdar 154 WEBfeactory 4 Adding a BACnet Connector to WEBfactory Studio In WEBfactory Studio right click on the server under the Server List Signals tab Custom connector Beckhoff ADS Connector Bree BACnet Connector Browse remote server Modbus Connector Signal list SNMP Connector Refresh Adding a BACnet connector to the Studio Select New Connector gt
6. After adding a device to the BACnet Connector the device will appear in the left tree navigation Click on it to view its details 7 Mobility Independent Yendor 154 Microsoft 22 www webfactory world de GOLD CERTIFIED Partner WEBfactory 5 Connector Configuration EBfactory Connector J New Delete 927 Import ce bangla Filter BACnet device The Device details panel contains a main view and the detail view panel When a device is selected the main view will list the objects defined for the device When selecting an object from the main view the details will be listed in the details view To add a new object the user can either create a new one and define it or import it via the import menu The desired object type can be selected from the Type drop down menu in the property grid Like the BACnet devices BACnet objects must have an unique instance number Then name does not have to be unique The same properties for the BACnet object can be found in the Object details panel When an object is selected in the tree structure on the right panel the list of properties will be displayed in the main view and the details of the properties in the details view New properties can be added for this selected objects if they are not available already by clicking the New button Independent Solbware 154 23 www web
7. NOTE The BACnetObjectTypes xml file will be loaded when the WEBfactory Studio is launched If the Studio is opened close it and re open it Any change in the BACnetObjectT ypes xml file will require WEBfactory Studio to be restarted WEBfactory BACnet Connector New X Delete o c Device 2000 DYNASERV analog input 1 Writable Al Name Type Read continuously analog output 1 Writable A analog value 1 Writable AV averaging 1 Anln Average calendar 1 HOLIDAY C96 calendar 2 Writable C E command 21 to Change device 2000 DYNASERV fd event enrollment 1 Damper If event enrollment 2 Change E event enrollment 3 Change _ event enrollment 4 Change event enrollment 5 Comma E0 event enrollment 6 Floating event enrollment 7 Out of E event enrollment 8 Writable Only the selected object type has been imported 5 Import object identifier object identifier Ir The BACnet objects that have not been selected may be displayed in the navigation tree but they are not imported As we have selected for import only the analog output object identifier only this object type is available after the import Microsoft 30 www webfactory world de GOLD CERTIFIED Partner 7 Independent Solbware verdar 154 WEBfactory 7 Using BACnet Scheduler Expression Blend The BACnet Scheduler control handles signal values following a predefined schedul
8. TIP Use the Find and Replace functionality of the editor for easier replacement Microsoft 29 www webfactory world de GOLD CERTIFIED ZVEl Independent Soelbaare Vendar 154 lt Object Name analog input Property Tybe 75 Name object identifier Required 1 ReadContinuously 0 Writeable 1 DataConversation 0 gt Property Type 77 Name object name Required ReadContinuously 0 Writeable 1 DataConversation Property Type 79 Name object type Required ReadContinuously 0e Writeable 1 DataConversation 0e Property 85 Name present value Required 0 ReadContinuously 1 Writeable 1 DataConversation 0 gt Property 28 Name description Required ReadContinuouslyz 0 Writeable 1 DataConversation gt Property Type 31 Name device type Required ReadContinuously 0e Writeable 1 DataConversation Property Type 111 Name status flags 9 ReadContinuously 1 Writeable 1 DataConversation 0 Replacing the value of Require with 1 for the desired object types Like in the picture above replace the value of Require with 1 for the desired object types The object types not desired for importing should have the value of Required set to 0 Save the XML document Open WEBfactory Studio and import the BACnet configuration You will notice that only the selected object types have been imported
9. 08 00 DATA_TYPE_REAL DATA_TYPE_REAL DATA TYPE REAL OATA TYPE REAL 05 00 07 00 00000 07 00 00 000 97 00 00 000 07 00 00 000 07 00 00 000 10 00 11 00 12 00 13 00 14 00 15 00 15 00 17 00 18 00 19 00 20 00 21 00 o 0 0 0 22 00 REAL DATA TYPE REAL DATA TYPE REAL DATA TYPE REAL 21 00 00 000 21 00 00 000 21 00 00 000 21 00 00 000 BACnet Scheduler control web browser ZVEl Microsoft ssu 32 www webfactory world de GOLD CERTIFIED independent Software Vendar ISV Partner WEBfactory 8 Using BACnet Scheduler Smart Editor The BACnet Scheduler control handles signal values following a predefined schedule The main utility of BACnet Scheduler is implementing calendar based schedules and exceptions To use the BACnet Scheduler in Smart Editor create a new project and set the size of the project page to 1600x900 BACnet Scheduler requires more canvas space in order to be easily operated From the Toolbox panel drag the WFBACnet Scheduler control from the BACnet category on the page Also place a Language Selector in order to translate the texts from German to English German is the default language ang terose pepe 7 m ELI HEN Rosa tay min n EU EET EES INT 1 WFEAChetSchedulerview WF Language Selector Target
10. BACnetToolbox executes any command built into it It is assumed that range of supported data types and operations would be extended over time BACnetToolbox exposes single method which takes as input xml string containing command specification and outputs in addition to the return code xml string containing result of the operation plus optional data Current range of supported operations involves reading and writing complex property data in addition to inserting and deleting list elements 3 4 BACnetDiscovery BACnetDiscovery detects devices on network using Whols IAm broadcast messages Discovery process always involves listing of devices with optional information about device objects and optional information about object properties Discovery process is complete when no previously known device is detected for the specified timespan Microsoft 10 www webfactory world de GOLD CERTIFIED Partner 7 Independent Solbware verdar 154 WEBfactory 3 5 Cimetrics BACstac BACnet communication layer from Cimetrics current version is 6 2 3 6 BACnet connector operation 3 6 1 Device object property The BACnet Device is used in 2 different contexts as piece of electronic equipment and as part of BACnet networking model Each device has several objects each object is of certain type like analog input or binary output and because certain type of object can be present multiple times in a device
11. PROP ALL WRITES SUCCESSFUL OBJ DEVICE PROP PROT VERSION PROP PROTOCOL REVISION PROP MAX APDU LENGTH ACCEPTED PROP MAX SEGMENTS ACCEPTED PROP APDU SEGMENT TIMEOUT PROP APDU TIMEOUT PROP NUMBER OF APDU RETRIES PROP MAX INFO FRAMES PROP DATABASE REVISION PROP DAYLIGHT SAVINGS STATUS OBJ EVENT ENROLLMENT PROP NOTIFICATION CLASS OBJ FILE PROP FILE SIZE PROP RECORD COUNT PROP ARCHIVE PROP READ ONLY OBJ LIFE SAFETY POINT 16 www webfactory world de GOLD m Partner 7 Independent Solbware verdar 154 WEBfactory PROP DIRECT READING PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE OBJ LIFE SAFETY ZONE PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE PROP MAINTENANCE REQUIRED OBJ LOOP PROP PRESENT VALUE COV PROP CONTROLLED VAR VALUE COV PROP SETPOINT COV PROP PROPORTIONAL CONST PROP INTEGRAL CONSTANT PROP DERIVATIVE CONSTANT PROP BIAS PROP MAXIMUM OUTPUT PROP MINIMUM OUTPUT PROP COV INCREMENT PROP ERROR LIMIT PROP UPDATE INTERVAL PROP PRIORITY FOR WRITING PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE OBJ MULTISTATE INPUT PROP PRESENT VALUE COV PROP NUMBER OF STATES PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE OBJ MULTISTATE OUTPUT PROP PRESENT VALUE COV PROP NUMBER OF STATES PROP RELINQUISH DEFAULT PROP TIME DELAY PROP NOTIFICATION CLASS PROP FEEDBACK VALUE PROP OUT OF SERVICE
12. on the desired day and hour and select Insert new event Weekly Schedule Exception Schedule Device Objects Property Monday Tuesday Insert new event _ 00 00 01 00 02 00 Paste selection 03 00 04 00 05 00 5 Time Value Editor Tine 00 00 00 000 OK Cancel Inserting a new event in the weekly schedule An event will expand itself from the beginning hour to the end of the day To stop an event at a specific hour insert a new event with the value 0 An event sets the value of a signal on a specific time Stopping an event means setting the value of the signal to the initial state before the first event occurred This can be done only by creating another event and altering the value of the one which is currently executing An event can be copied and pasted over an entire week or just on specific days It also supports cutting deleting or editing To access this functions select an event and right click on it The options will be available in the contextual menu Not only the events support copy cut and paste options The calendar days can be edited the same Right click on a day to open the contextual menu GOLD CERTIFIED Partner 7 Independent Solbware verdar 154 37 www webfactory world de WEBfactory Paste day Delete day Editing entire days These options allow the user to duplicate days in the schedule cut day
13. each object has got its instance number This instance number must be unique for given object type inside the device There is one special object type device object Each device has exactly one object of type device object Though a device object must exist only once inside device it still has an instance number The instance number of the device object becomes instance number of the whole device On a BACnet network each device must have unique instance number which is the instance number of its single instance object Each object in a device has several properties A property is of certain type like present value or status flags Each object type property type combination determines what data type the property will contain These data types might be simple like floating point values or very complex ones BACnet connector s goal is to facilitate the retrieving of values from the properties and setting values for the properties Microsoft 11 www webfactory world de GOLD CERTIFIED Partner Independent Solbware verdar 154 WEBfactory 3 6 2 Retrieving the values of the properties There are two basic ways how to retrieve values of the properties e Reading value of the properties sending request to the device asking for a property value and receiving answer from device containing that value e Setting device to send a value of the property whenever property value changes 3 6 2 1 Property
14. names that end with X X will filter the names beginning with X X will filter the names that have X anywhere in the name To add the selected properties to the Studio the properties need to be assigned to a Destination group This destination group can be created inside the connector browser window by typing the desired name of the new group in the Destination group text field The new created group will be listed under the BACnet connector entry in the Server List Inside the group the imported properties will have signals assigned automatically This way the BACnet object can be monitored 7 Mobility Independent Yendor 154 25 www webfactory world de GOLD d Partner WEBfactory Signal Name OPC Item Name V DYNASERV Writable Al name1 DYNASERV Writable Al name1 DYNASERV Writable Al object identifier DYNASERV Writable Al object identifier DYNASERV Writable Al object identifier5 DYNASERV Writable Al object identifier Destination group view Validate Signals The contextual menu of the BACnet connector allows the user to Validate Signals Signal validation ZVEl Independent Selbaare Vendar 15V Microsoft 26 www webfactory world de GOLD CERTIFIED WEBfactory The Signal Validation window displays a list of used invalid items and list of unused items The invalid items can be removed from the Studio and the unused items can be
15. properties window Here the user will be able to select the connected BACnet devices and import the desired ones 7 Independent Solbware verdar 154 21 www webfactory world de GOLD CERTIFIED Partner WEBfactory 33 Import BACnet device properties E E WEBfactory BACnet Connector 5 ean Device 2000 DYNASERV analog input 1 Writable Al 2000 DYNASERV device E analog output 1 Writable A0 1 Set Point Winter Schedule schedule analog value 1 Writable AV 2 Writable S schedule averaging 1 Anin Average calendar 1 HOLIDAY C96 1 E calendar 2 Writable C 1 Writable AO analog output command 21 Change State 1 Writable AV analog value device 2000 DYNASERV 1 PRESS event enrollment 1 Damper Actuator Fault I raga event enrollment 2 Change of State EE 21 to Change a State command event enrollment 3 Change of BitString Value EE 1 HOLIDAY C96 calendar event enrollment 4 Change of Real Value EE 2 Writable C lenda event enrollment 5 Command Failure EE E event enrollment 6 Floating Limit 1701 Hardware Notification Class notification class event enrollment 7 Out of Range EE 1702 Writable NC notification class amp event enrollment 8 Writable EE Sj 1 Damper Actuator Fault event enrollment E notification class 1701 Hardware Notification Clas KO notifica
16. set to be used Signal Name OPC item name Description Group DYNASERV Writable Al object identifi DYNASERV Writa Group Invalid items panel To make an unused item to be used the item must be selected from the Unused Items and assigned to a Destination group Unused Items panel ZVEl Mobility Independent Selbaare Vendar 15V 2 www webfactory world de GOLD CERTIFIED Partner WEBfactory The signals created for the BACnet object properties be exported and imported by selecting the appropriate options in the contextual menu Server List JYNASERV Writable Al object identifier aR Al Edit El Re WEBfactory BACnet Connector ia ES Write Groups Move Signals cn Discrete Values New Signal 21 Discrete Value Types 9 4 Delete 95 Import Signals Signal Details Refresh Importing and exporting signals from the BACnet destination group The format used for importing exporting is xml ZVEl Microsoft ssu 28 www webfactory world de GOLD CERTIFIED independent Software Vendar ISV Partner WEBfactory 6 Filtering BACnet objects when importing a BACnet configuration in WEBfactory Studio WEBfactory Studio only imports object types that have the value of Required as 1 In order to import only the desired BACnet object types the BACnetObjectT ypes xml file must be edited and all the desired BACnet object types must have the value
17. 0 00 000 07 00 00 000 07 00 00 000 07 00 00 000 10 00 11 00 12 00 13 00 14 00 15 00 16 00 17 00 0 9 DATA TYPE REAL DATA REAL DATA TYPE REAL 21 00 00 000 21 00 00 21 00 00 000 21 00 00 000 BACnet Scheduler control web browser ZVEl Independent Soelbaare Vendar 154 Microsoft GOLD CERTIFIED Partner 34 www webfactory world de WEBfactory 9 The BACnet Scheduler control at runtime The BACnet Scheduler control is divided in two panels e Discovered Devices panel left side lists the BACnet devices and all the objects schedules and calendars e Configuration panel right side the configuration options for the BACnet objects When an object schedule or calendar is selected in the left panel the configuration options are displayed in the configuration panel The Discovered devices panel features a Refresh button that allows the user to manually reload the devices and objects if any configuration had changed 9 1 BACnet Scheduler workflow e Aget devices query is executed when the control starts or on any click of the refresh button The get devices query has a configurable timeout 1 means wait indefinitely This will in turn query the devices from the WF2010WebService and subsequently from WFBacNetService If the cache is populated with devices or gets populated until the timeout expires the control will get them Otherwise it wi
18. BACnet Connector The BACnet Connector will appear under the selected server ZVEl Mobility Independent Soelbaare Yendar 154 19 www webfactory world de ener WEBfactory 5 BACnet Connector parameterization WEBfactory Studio WEBfactory Studio offers the possibility of custom configuration for the BACnet Connector To access the configuration panel select the server and select the desired BACnet connector The Connector Configuration panel will appear on screen Name Timestamps WEB factory Sim DA 1 System timestamps optimiz NWEBfaciory BACnet Connector 5 WEBiactory 1 Write Groups wi Discrete Values 2 Discrete Value Types New X Delete 33 Import Instan Name Poll period RPM support COV support Confirmed COV COV P supp synchro Write priority Save Cancel 2 2 1 selected E The BACnet Connector inside WEBfactory Studio The configuration panel is an overview of the connector and the devices attached It allows the parameterization of the devices by using an attributes grid panel The left side of the panel consists in a tree structure of the connector and its devices and a filtering option dialog The root of the tree structure is always the connector and it contains all the devices and their imported objects The right side of the configuration panel contains a menu bar the attributes grid and the device details panel
19. UTION PROP RELINQUISH DEFAULT PROP COV INCREMENT PROP HIGH LIMIT PROP LOW LIMIT PROP DEADBAND PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE OBJ ANALOG VALUE PROP PRESENT VALUE COV PROP RELINQUISH DEFAULT PROP COV INCREMENT PROP HIGH LIMIT PROP LOW LIMIT PROP DEADBAND PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE OBJ AVERAGING PROP MINIMUM VALUE PROP AVERAGE VALUE PROP VARIANCE VALUE PROP MAXIMUM VALUE PROP ATTEMPTED SAMPLES PROP VALID SAMPLES PROP WINDOW INTERVAL PROP WINDOW SAMPLES OBJ BINARY INPUT PROP CHANGE OF STATE COUNT PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE PROP PRESENT VALUE COV PROP ALARM VALUE PROP ELAPSED ACTIVE TIME 15 www webfactory world de GOLD m Partner 7 Independent Solbware verdar 154 WEBfactory OBJ BINARY OUTPUT PROP CHANGE OF STATE COUNT PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE PROP PRESENT VALUE COV PROP RELINQUISH DEFAULT PROP FEEDBACK VALUE PROP ELAPSED ACTIVE TIME PROP MINIMUM OFF TIME PROP MINIMUM ON TIME OBJ BINARY VALUE PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE PROP PRESENT VALUE COV PROP RELINQUISH DEFAULT PROP ALARM VALUE PROP CHANGE OF STATE COUNT PROP ELAPSED ACTIVE TIME PROP MINIMUM OFF TIME PROP MINIMUM ON TIME OBJ CALENDAR PROP PRESENT VALUE OBJ COMMAND PROP PRESENT VALUE PROP IN PROCESS
20. WEBfactory WEBfactory 2010 WHEL LL BACnet WhitePaper Version 1 0 February 2012 798 E d 1 EE E I _ ln D A A LT Ng ae CC n 5 yen mmHKyhyhas r m H Hy rfyqy xa airyryQ QAa wg a WEBfactory ZVEl Mobility Independent Selbaare Vendar 15V 2 www webfactory world de GOLD CERTIFIED WEBfactory This whitepaper is a product of the company WEBfactory GmbH WEBfactory GmbH Hollergasse 15 74722 Buchen Germany Tel 49 6281 5233 0 Fax 49 6281 5233 333 http www webfactory world de Copyright 2012 WEBfactory GmbH All rights reserved No part of this user manual may be copied or forwarded in any other way without the explicit written approval of WEBfactory GmbH All information and descriptions were selected with special care following careful investigations However application errors or changes leading to a series of changed commands or other results may not be entirely excluded WEBfactory GmbH cannot undertake any legal or other liability for such changes or any errors deriving from them Microsoft and MS Internet Explorer are registered trademarks property of the Microsoft Corporation All other logos and product names are registered logos or trademarks of their respective owners WE Bfactory GmbH denies any liability for in
21. creased costs of phone calls as a consequence of using the respective communications modules even in the case of accidental connections WEBfactory GmbH has drawn up this user manual according to the most advanced knowledge but it does not undetake any responsibility for the programs systems generating the results expected by the user WEBfactory GmbH reserves the right to make changes to the user manual without undertaking the responsibility of informing third parties as to such changes We reserve the right to make technical changes Independent Solbware 154 3 www webfactory world de GOLD CERTIFIED Partner WEBfactory AA 5 2 E 6 245 BACSI IN taaie 6 2 2 Starting BACnet nnns na 7 5 8 3 1 2010 9 3 2 9 23 CONDO CERERI TET AA 10 3 4 10 35 11 3 6 BACnet connector operation 11 9 0 1 DEVICE object 010 0 AA 11 3 6 2 Retrieving the values of the 12 3 6 3 Setting value of the properties 13 3 6 4 Device disconne
22. ct 14 3 6 5 Supported objects and 14 4 Adding a BACnet Connector to WEBfactory 19 5 BACnet Connector parameterization in WEBfactory Studio 20 6 Filtering BACnet objects when importing a BACnet configuration in WEBfactory Studio 29 7 Using BACnet Scheduler in Expression 31 8 Using BACnet Scheduler in Smart 33 9 The BACnet Scheduler control at runtime sese 35 9 1 BACnet Scheduler workflow nnn 35 9 2 Schedule Configuration nennen enne nnne 36 9 3 Calendar 41 7 4 www webfactory world de sees P WEBfactory 1 Introduction This whitepaper is intended for all the users of WEBfactory 2010 software and is designed to facilitate the understanding of WEBfactory 2010 s approach on BACnet The document will presenta WEBfactory BACnet toolkit overview as well as a guide through the processes of installing configuring and using the WEBfactory BACnet toolkit For a correct understanding of the following information WEBfactory 2010 software and additional modules must be installed on the operating mac
23. dardized API that can be used for communicating with lower level components in an easier manner Basically this is the component that is used by the scheduler control for all its functionality The methods exposed by this API cover the following functionalities o Discovering BACnet devices o Reading device object properties o Writing device object properties e The WF2010WebService component resides on the server side and is hosted in IIS 3 2 WFBacNetService e This is a windows service that offers lower level BACnet functionality It basically acts as a wrapper on top of several COM components and is used by the WF2010WebService component for executing low level commands e The windows service offers on one side functionality for executing BACnet commands read write operations The read write functionality offered by this service is in the form of a low level XML based API that covers actions such as writing the value of a property or of a set of properties and querying the value of a property The other functionality exposed by the service is discovering BACnet devices The windows service acts as a caching system for minimizing the time required for discovering devices When started it will try to discover all BACnet devices in the network along with their objects and the object names When the WF2010WebServices query the available devices they will always get a cached list The discovery and caching is affected by two parameters c
24. e The main utility of BACnet Scheduler is implementing calendar based schedules and exceptions To create a BACnet Scheduler visualization in Expression Blend create a new WEBfactory Silverlight Application Website project Select the UserControl and expand it to 1600x800 Add the dll files from the folder WEBfactory 2010 Silverlight 4 Standard as references to this project After the references are loaded drag the WFBacnetScheduler control on the project page Optional WFLanguageSelector control can be added in order to translate de BACnet Scheduler from German to English BACnet Scheduler visualization project in Expression Blend In the Properties panel under the WEBfactory category there are two properties of the WFBacnetScheduler control Microsoft 31 www webfactory world de GOLD CERTIFIED Partner 7 Independent Solbware verdar 154 WEBfactory SearchDeviceMinimumTime SearchDeviceTimeout The project is ready to be executed so press F5 to run The BACnet scheduler will open in the browser window Discovered devices Schedule configuration modified SINE T rm 1 Set Point Winter Schedule EN 2 Writsble 5 5 1 HouIDAY C96 27 2 Writable c 41 Set Point Winter Schedule DATA REAL Saturday Sunday 15 5 15 5 DATA TYFE REAL DATA REAL 00 00 00 000 00 00 00 000 07 00 5 5 15 5 15 5 15 5
25. er lists the WEBfactory services including the WEBfactory 2010 BACnet Service mi es CI GIO PWET JA D n O Sep d iro nas a gt Restat Refresh Service name Status Observed 7 Version Tg ene EL AE EE O WEBfactory 2010 SchedulerPro Stopped x 3 0 5 0 WEBfactory 2010 ScenarioManagerPro Stopped x 3 1 9 0 O WEBfactory 2010 M260 Server Stopped 2 0 4 0 WEBfactory 2010 BACnet Service Running x 1 0 0 30 Service name WEBfactory 2010 Server Status Running Observed No Version 3 2 8 0 Description WEBfactory 2010 Service Manager WEBfactory 2010 Service Manager is located WEBfactory 2010 Tools VXService Manager Make sure that the WEBfactory 2010 BACnet Service is started ZVEl Microsoft ss 7 WWW WE bfactory world GOLD CERTIFIED Sol banana Yendar 154 Partner 3 BACnet Overview BACnet Connector 8 www webfactory world de WEBfactory SL4 Scheduler Control HTTP WF 2010 Web Services Named Pipes BACnet Service BACnet BACnet Discovery Toolbox Cimetrics BACstac BACnet diagram ZVEl Mobility Independent Sollware Yendar 1541 GOLD CERTIFIED Partner WEBfactory 3 1 WF2010WebService e This is the standard WEBfactory web service interface Its role is to provide a stan
26. factory world de GOLD CERTIFIED Partner WEBfactory Browsing BACnet Connector WEBfactory Studio allows the user browse the BACnet connector and select the desired properties to assign signals to them Ai nd gt 2 4 4 Ty NG NT 2 o sober i _ lt 71 A OLULIIL 4 SIN C SANG PA 1 Project Edit Help ABR 16 All Servers Collapse Write Groups L New Group fn Discrete Values 9 Discrete Value Types Browse Connector Validate Signals amp Refresh Browsing the BACnet connector The Browse Connector option available in the contextual menu of the connector entry in the Server List will open a browser window The user has the options to browse for properties and select the desired ones ZVEl Mobility Independent Soelbaare Yendar 154 Microsoft 24 www webfactory world de GOLD CERTIFIED Partner WEBfactoryu 212773 eles E E WEBfactory BACnet Co 5 88 DYNASERV c Name Alias DYNASERV Wrtable Al obiect identifier object identifier Destination group Total number of items 1 Connector Browser window One important part of the connector browser is the Filtering option It allows the user to filter the properties by name The filtering options uses wildcards for easier input X will filter the
27. hine For more information about installing WEBfactory 2010 system requirements licensing and release notes please visit the WEBfactory Knowledge Base at http webfactory support de assets documentation Default htm Independent Solbware 154 5 www webfactory world de GOLD CERTIFIED Partner WEBfactory 2 BACnet Setup 2 1 BACstac Installation The BACstac installer can be found in the 3rd Party folder of the WEBfactory 2010 installation kit E O DEL F Pas Cor gt CD327 3rdParty BACstac Organize B Install Share with New folder She Date modified Type Desktop BACstac Installation Guide 4 16 2011 4 21 PM Adobe Acrobat D Downloads i9 bacstac 4 15 201111 46 PM Windows Installer 22 Recent Places Thumbs 4 8 2010 10 07 AM Data Base File 1 WEBfactory 2010 ow Libraries Documents Music i Pictures Videos BACstac setup The BACstac provides you with the ability to create client and server application programs which use BACnet protocol for communication Run the BACstac installer before proceeding ZVEl Mobility Independent Selbaare Vendar 15V Microsoft 6 www webfactory world de GOLD CERTIFIED Partner WEBfactory 2 2 Starting BACnet Service The BACnet Service needs to be started before proceeding with further setup or work WEBfactory Service Manag
28. iod specified in WholsReplyWait for broadcast from connected devices Both WholsPeriod and WholsReplyWait parameters are in milliseconds Any device listed in connector configuration that did not respond with message is consider to be disconnected for the time being At the beginning or when device is reconnected list of objects is retrieved from device and existence of each object in the configuration is verified Polling for property values in one device is independent of polling for property values of any other device Offline device will not cause delays in communication with other devices 3 6 5 Supported objects and properties Following objects and properties are supported OBJ ACCUMULATOR PROP PRESENT VALUE PROP MAX PRES VALUE PROP VALUE BEFORE CHANGE PROP VALUE SET PROP PULSE RATE PROP HIGH LIMIT PROP LOW LIMIT PROP LIMIT MONITORING INTERVAL PROP NOTIFICATION CLASS PROP TIME DELAY PROP OUT OF SERVICE Independent Solbware verdar 154 14 www webfactory world de GOLD CERTIFIED Partner WEBfactory OBJ ANALOG INPUT PROP PRESENT VALUE COV PROP MIN PRES VALUE PROP MAX PRES VALUE PROP RESOLUTION PROP COV INCREMENT PROP HIGH LIMIT PROP LOW LIMIT PROP DEADBAND PROP UPDATE INTERVAL PROP TIME DELAY PROP NOTIFICATION CLASS PROP OUT OF SERVICE OBJ ANALOG OUTPUT PROP PRESENT VALUE COV PROP MIN PRES VALUE PROP MAX PRES VALUE PROP RESOL
29. ll get an empty list and a new refresh should be executed After the first initialization of the cache the control should always get a list The get devices query will return the list of devices and the list of scheduler and calendar objects for each device e When the user accesses any of the device objects one or more queries depending on the object type are made for reading each of the object properties or property groups e When writing values the scheduler tries to write each property one by one As noted above this will trigger a rescheduling of the discovery so that the objects are updated useful for example when the name of an object is changed Independent Solbware 154 35 www webfactory world de GOLD CERTIFIED Partner WEBfactory 9 2 Schedule Configuration The Schedule Configuration allows the user to configure a weekly schedule for an event The weekly scheduler can be repeated over a period of time It also allows the user to name the schedule and it displays the current value Schedule configuration Name Set Point Winter Schedule Effective Period 1 10 0 20 4 0 Present Value DATA_TYPE_REAL Weekly Schedule Exception Schedule Device Objects Property References Monday Prid seturday 00 00 15 5 15 5 01 00 DATA_TYPE_REAL DATA_TYPE_REAL 02 00 00 00 00 000 00 00 00 000 03 00 04 00 05 00 06 00 07 00 15 5 15 5 33 iss
30. ndent Verdar 154 40 www webfactory world de GOLD CERTIFIED WEBfactory 9 3 Calendar Configuration The Calendar Configuration view allows the customization of a calendar object Calendar objects can be used in Exception Schedules under Schedules Configuration Calendar configuration Name HOLIDAY C96 Descnpbon Canadian Civic Holidays for 1996 Present Value Date List Toggle selection j 1 1 0 0 8 4 0 0 20 5 1996 0 24 6 0 0 Add Delete checked entries importcalendar entries Calendar Configuration view The Calendar Configuration features e Name text field where the calendar can be named e Description field where description of the calendar can be entered e Present Value displays the present value e Date List the list of dates that the calendar holds By using the Add button from the bottom of the Date List new entries can be added to the calendar ZNEl Mobility Independent Yendor 154 41 www webfactory world de GOLD CERTIFIED Partner WEBfactoru e Single Date e Date Range e Week and Day Using these calendar entries the Scheduler can execute exceptions when programmed to The Calendar also features an Import calendar entries button which allows the user to import 168 calendar files Microsoft 42 www webfactory world de GOLD CERTIFIED Partner 7 Independent Solbware verdar 154
31. new COV COV P orders before expiry could occur 3 6 3 Setting value of the properties The connector always uses single property write service to set new value of the property in the device some of the properties are commendable Commendable properties make use of priority of writing operation to resolve conflict when multiple BACnet clients write values into the very same property Implicit priority used for writing is BACSTAC PRI MANUAL OPERATOR This value can be overridden by the WritePriorityLevel parameter in Device section Resetting value of commendable property is accomplished when variant value is being requested by the connector client to be written to the property Independent Solbware 154 13 www webfactory world de GOLD CERTIFIED Partner WEBfactory 3 6 4 Device disconnect reconnect Device re discovery process is invoked by connector using Whols broadcast on network with network number specified by parameter Network in Devices section If 1 is used for network number than global broadcast is used in case of 0 local broadcast is used In case of value of Network parameter other than 0 or 1 remote broadcast is utilized At the connector startup device re discovery process happens immediate afterwards it is repeated with period specified by WholsPeriod parameter in Devices section This re discovery process than waits for per
32. of Required set to 1 The objects that will have the value of Required set to 0 will not be imported Navigate to the WEBfactory 2010 installation folder Studio Name Date modified Type 1 DBUpdates 1 25 2012 10 15 AM File folder 12 de DE 1 25 2012 10 15 AM File folder 1 UserManager 1 25 2012 10 15 AM Filefolder gt AxInterop SHDocVw dll 1 17 2012 4 55 PM Application extens 40 KB gt BACnetConnector dll 1 17 2012 4 54 Application extens 216 KB S BACnetDiscovery dil 10 31 2011 3 10 PM Application extens 337 KB BACnetObjectTypes 2 7 2012 4 24PM Document 135 KB 5 BeckhoffConnector dll 1 17 2012 4 54 PM Application extens 161 KB gt CassiniDev4 lib dll 1 17 2012 4 55 PM Application extens 116 KB DemoProject bak 11 25 201111 40 File 8 853 gt hasp net windows dil 1 17 2012 4 55 PM Application extens 268 KB gt hasp_windows_demo dll 1 17 2012 4 55 PM Application extens 522 KB 5 Infragistics2 Shared v10 2 dll 1 17 2012 4 55PM Application extens 300 KB Infragistics2 Win Misc v10 2 dll 1 17 2012 4 55PM Application extens 1 132 KB 5 Infragistics2 Win UltraWinDataSource v10 1 17 2012 4 55 PM Application extens 104 KB gt Infraaisti traWinEdito 2 0 17 20 1 Application extens 476 KE Vin The BACnetObject Types xml is located in the Studio folder inside the WEBfactory installation folder Open the BACnetObjectTypes xml in an editor and search the string Required
33. onfigurable from WEBfactory Studio o SearchDeviceMinimumTime the minimum time that the discovery will wait for a new device to send an AM response before the discovery is ended The default value here is 6000ms but depending on the speed of the devices and network conditions this value can be increased to allow for more time for the devices to send an answer ob Independent Soller verdar 154 9 www webfactory world de GOLD CERTIFIED Partner WEBfactory DeviceScanlnterval this is the time interval between two subsequent discoveries After the service runs its first discovery process and places the devices in the cache it will wait for a period of time equal to the value of this setting and then it will start another discovery process This flow is repeated after each discovery is completed The default value is 10 minutes When configuring the network this value can be decreased to a smaller value When the network is configured and the chances that the topology changes are smaller the value can be increased in order to decrease network traffic e order to prevent stale data the service also schedules a new discovery as soon as a write operation is performed Asecondary role for the Windows Service is to provide the correct apartment and threading context for the BACnet Toolbox and BACnet Discovery COM components and a stable lifetime for the device cache 3 3 BACnetToolbox
34. s or even delete days from the schedule The Weekly Schedule tab has a Zoom option at the bottom This is useful when working with detailed time units Exception Schedule allows the user to create exceptions from the Weekly Schedule Weekly Schedule Exception Schedule Device Objects Property References Toggle selection HOLIDAY C96 pre Delete entries import exception entnes Exception Schedule GOLD CERTIFIED Fartner ZVEl Independent Soelbaare Vendar 154 38 www webfactory world de WEBfactoryu The Exception Schedule can be used to create exceptions in the predefined weekly schedule Using the Add button from the bottom of the panel the user can add Single Date exceptions Date Range exceptions Week and Day exceptions or Calendar References The user can also import exception entries from other calendar applications using the file format ics Single Date Date Range Week and Day Calendar Reference Add Delete checked entries Adding and importing exceptions Import exception entries To delete exceptions mark the checkbox corresponding with the desired exception and use the Delete checked entries button Single Date exceptions specify a day in which the schedule will be altered the value of the signal being different for that day Select Date Day Month Unspecified a Year 0 Day Of Week Unspecified Event Priority 1
35. the root of the tree left is selected the grid panel will display the imported devices lfadevice is selected in the tree the grid panel will display the list of imported objects for that device 7 Independent Solbware verdar 154 20 www webfactory world de GOLD CERTIFIED Partner WEBfactory object is selected in the tree structure the grid panel will list the imported properties for the selected object 1 New X Delete 7 Import Instan Poll period RPM support COV support Confirmed COV COV Psupp COV synchro a It 817 4418 Device 1 Example RPM support Example COV support COV P support Poll period 10 V Confirmed COV notifications Write priority COV synchronization BACnet Connector Configuration The BACnet Connector Configuration allows two methods of adding devices to a connector create a new connector by pressing the New button on the connector configuration menu bar while the root of the tree is selected Ifthe New button is pressed while having a device selected in the tree structure a new object will be created by default an accumulator object o Ifthe New button is pressed while an object is selected in the tree structure a property selection dialog will pop up importing devices by clicking on the Import button on the connector configuration menu bar Importing a BACnet device will open the import
36. tion class 1702 Writable NC 2 Change of State EE event enrollment schedule 1 Set Point Winter Schedule 3 Change of BitString Value EE event enrollment schedule 2 Writable S 4 Change of Real Value EE event enrollment 5 Command Failure EE event enrollment 6 Floating Limit EE event enrollment 7 of Ranne FF event enrallment Import BACnet device properties When a device is added it appears in the property grid The same properties also appear in the Device details panel The devices properties can be customized as necessary Instance Any device must have an unique instance number e Name Any device must have a name the name doesn t have to be unique e Poll period The period of time between interrogations RPM support Read Property Multiple is supported Several property values can be read in a RPM query e COV support Change Of Value notifications are supported The device sends property value changes on its own e Confirmed COV Confirmed change of values notifications are supported Confirmed COV is more immune to loss of packets e support Change of value for a property e COV synchronization Change of Values synchronization is supported e Write priority Sets the level of priority for a commendable property Write operation to an object property has a priority attribute in this way a device resolves the conflict when several BACnet clients write different value to a property
37. value reading This process must be executed periodically with period of PollPeriod parameter inside Device section inside XML configuration There are two types of reading requests requesting value of single property or requesting value of multiple properties If reading request type asking value of several properties should be used than parameter inside Device section should be 1 in opposite case that parameter should be 0 There are some properties that typically do not change their value If it is the case than ReadRepeat parameter inside Property section should be O otherwise that parameter should be 1 3 6 2 2 Setting device to send value of properties in case of change There are 2 types of BACnet protocol services that facilitate sending property values whenever value changes object COV and property COV COV P Object COV makes device send changes of value of most important properties for given object tyoe Changes of values of some of the remaining properties can be sent via COV P service Connector starts COV COV P by making order for COV COV P operation to the device Than processing of value sent by device during normal operation follows Such order for COV COV P operation is not generally valid forever after some period of time COV COV P expires and connector must reissue order for COV to the device Such new order is issued before existing order for COV COV P expires 7
Download Pdf Manuals
Related Search