Building Automation Knowledge Base

Issue Extended logs are not retrieving new values after an automation server (AS) has been restored underneath the enterprise server (ES). The problem occurs when there is an enterprise server extended log referencing an automation server extended log that is referencing a Xenta log.  Environment Workstation Extended Logs StruxureWare Building Operation Cause If an AS extended log with historical data is restored (for example after the Xenta controller that contains the Xenta log comes back online) the AS extended log can become locked up and will not record new data. When the Xenta controller goes offline and then comes back online the following sequence of events occur (Note: some values in this scenario are entered for example purposes only like the Xenta LogSize): After a restart of any kind the Xenta log will set its LastSeqNo to LastSeqNo+LogSize. This is to tell the AS extended log to do a read since it doesn't know if there are any new records; it should assume everything is new. (A key problem here is that the Xenta log will not increase its LastSeqNo until something reads from it. Normally when there is just an AS extended log and a Xenta log, the AS extended log reads and gets 3 records back. This makes everything go back to normal). The ES extended log notices that the AS extended log has been restored. The ES extended log sends a command to the AS extended log to clear the entire log and set the Last WrittenSeqNo to 101. This changes the scenario in event one from allowing the AS extended log to begin working properly. The AS extended log is only interested in new records now so it requests the LastSeqNo from the Xenta log. This value is used as the Last TransferredSeqNo in the AS extended log. When the AS extended log requests new records from the Xenta log, it answers 150 which is actually the LastSeqNo+LogSize. The Xenta log will not perform a real read to the external log to find out the actual LastSeqNo until something reads it and will not move beyond 150 because of the restart state it is in. Summary: The AS extended log won't read until the Xenta log tells the AS extended log that it has a new record and the Xenta log won't check for a new record until something reads it. Resolution Use a Trend Chart with Live Update The Xenta log can be opened in a trend chart with live update on. The chart will read every few seconds from the Xenta log causing the Xenta log to set its LastSeqNo to the value it should be. Given enough time the Xenta log will have reached the LastSeqNo where the AS extended log will start logging again. To speed this process up, the interval on the Xenta log can be set to the fastest possible scan time (10 seconds). Once the AS extended log begins collecting values again, the Xenta log can be changed back to the original settings. Note: The Xenta log will be cleared when changing the interval.   Create a New Extended Log A new AS extended log that monitors the Xenta log can also be created to correct the problem (disconnecting the old extended log). The new extended log will start reading from the beginning and start working immediately.

Issue Straight S-Cable and angle (L-shaped) S-Cable difference Product Line EcoStruxure Building Operation Environment Automation Server Automation Server Power Supply Automation Server I/O Modules Cause The description in the datasheets / installation instructions may not be sufficient to understand the difference(s) between the two types of S-Cables. Resolution January 2013 Update - The straight connector S-Cable has been discontinued. Refer to Product Announcement PA-00238 for details. The straight S-Cable (part number SXWSCABLE10001) and the angle or L-shaped S-Cable (part number SXWSCABLE10002) works the same in terms of functionality. Both are 1.5 meters in length. The difference is whether the connectors is a straight out type or an angled type. This will probably affect the installation. See the images below Straight type Angle or L-shaped * Note: The straight S-Cable is currently not available and all existing and coming orders for straight S-cable (SXWSCABLE10001) will be replaced with the L-shaped S-cable (SXWSCABLE10002) until further notice. Refer to TPA-SBO-12-0004 01 for details.

Issue Looping script programs continuously loop around the code, but a fallthrough needs a trigger to start it running and will stop at the end. How is this configured. Environment Script programs set as Fallthrough in an AS or ES Up to Release 1.3 Cause Plain English used Triggers in points to start a program, these do not exist in an AS or ES Binary value, so what is used to start the program running? Resolution Once a script program has been written, checked and  saved as a Flow Type "Fallthru", you can then edit the bindings. In the bindings use the variable called "Restart" a binary value to bind to the triggering point/ value which should also be Binary. This object can then be triggered on the required event to start the program, which will then execute the code and stop at the end awaiting the next restart. When you Bind a Digital Value to a Scrip program, you may get an error message like the one here: By Default, a Digital Value has no Configuration Settings defined. Enter 0 and 1 for the binary states and then performing your binding to the Program alleviates the error message.  Note: This functionality operates for versions up to Release 1.3. From Release 1.4 the Restart attribute is read only showing the restart status from the program and does not allow a point / value to be bound to this flag. In Release 1.4 a looping program will need to be used checking the state of the trigger point and action accordingly.   Note: in newer releases e.g. 1.7, 1.8 and above, triggers are now supported and you can bind directly to the Trigger attribute of the program, each change of the bound point will trigger the script to run.

Issue How to put in multiple email addresses for emailing from Email Notification Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation Site with at least one ES or AS Cause A good example of when multiple email addresses are required for alarm notifications is a facilities staff. You may need critical alarms to go to several people at once to make sure they are handled in a timely fashion. Note: Consider configuring Building Operation to email a distribution list as opposed to several email addresses. That way the IT department can handle making changes without having to access the building control system. Resolution in the email address field of the Email Notification, addresses should be separated with only a semicolon. No space is permitted between the addresses. Note: This will not work from Webstation, only from Workstation. Example: user1@gmail.com;user2@gmail.com;user3@gmail.com

Issue How to install a language pack on Enterprise Server (ES) Webstation. Environment StruxureWare Building Operations Enterprise Server Webstation 1.1.0.362 Cause This functionality needs to be activated via StruxureWare Building Operation Workstation. In the Automation server (AS) webstation an "Add Language" menu item is used but this needs to be activated in ES webstation. AS Add or Remove language settings. ES (default) Add or Remove language settings. Settings for the default administrator group that don't allow a language pack to be added in ES webstation Resolution Create a new StruxureWare Building Operation User group 1. In ES workstation go to the Control Panel and select User Accounts -> Account Management. 2. Select the appropriate domain and then select User Account Groups -> Add. 3. The settings can then either be set via the Create Object wizard or can be done later. Choose the preferred method and add the users/Groups that are to be granted authority to add language packs. Set the policies for the new user group 1. Go to .../Domains/Local/Groups/Your new group in the menu tree and select the tab Policies. 2. Select the check box AS web configuration - May access web user interface. 3. Save the changes. Add the language pack in webstation 1. Go to ES webstation and log in. 2. Click on the settings menu and then select Add or Remove Language. 3. Click on add and browse in the language pack zip-file. Click on OK. Check that the installation was successful 1. Click on Settings -> Change language. 2. The newly installed Language pack should appear in the drop-down menu. 3. Select the language and click on OK. The language should change straight away.     

Issue Are DDC Controllers Leadership in Energy and Environmental Design Certified? Environment Site wanting Green Building Council Certification Cause Are DDC Controllers Leadership in Energy and Environmental Design Certified? Resolution The USGBC does not certify particular devices or controls systems such as I/NET, Continuum, or Xentas. LEED focuses on the design of the building and not on its actual energy consumption, and therefore it has suggested that LEED buildings should be tracked to discover whether the potential energy savings from the design are being used in practice. Five basic categories make up the design points system. Totaled together, these points determine your certification level. The level of certification depends upon the total number of points. As you can see, energy and atmosphere along with indoor environmental quality factors make up half of the available basic points. Five categories for accumulating points 1. Sustainable sites.... 26 Points 2. Water efficiency ....14 Points 3. Energy and atmosphere ....35 Points 4. Materials and resources.... 10 Points 5. Indoor environmental quality.... 15 Points 6. Innovation and Operations.... 6 Points 7. Regional Priority.... 4 Points Subtotal: 100 Points LEED 2009 for Existing Buildings: Operations & Maintenance 100 base points; 6 possible Innovation in Operations and 4 Regional Priority points Certified 40–49 points Silver 50–59 points Gold 60–79 points Platinum 80 points and above The U.S. Green Building Council is a national, non-profit organization that works to “promote the design and construction of buildings that are environmentally responsible, profitable and healthy places to live and work” (USGBC Mission Statement). The USGBC created the Leadership in Energy & Environmental Design® (LEED) Green Building Rating System. LEED was fashioned to provide a standard of measurement for defining a “green” building. It takes a whole building approach that encourages and guides a collaborative, integrated design and construction process. The program evaluates and recognizes performance of your buildings in accepted green design categories—Energy & Atmosphere, Water Efficiency, Materials & Resources, Indoor Environmental Quality and Sustainable Sites. Buildings are given a certification rating based on the number of points they receive in their evaluation. The four levels of LEED certification include: Certified Level, Silver Level, Gold Level, and Platinum Level. By becoming certified, building owners are given third-party validation of their contribution environment; qualify for various state and local government incentives; contribute to the growing knowledge base; receive a LEED certification plaque and official certificate; and receive marketing exposure through the USGBC website, case studies, and media  

Issue Microsoft Visual Studio causes Just-In-Time Debugging Environment Windows Operating System Cause Visual Studio is installed on the PC and when attempting to perform a task, an error appears claiming Just-In-Time Debugging.  Resolution To disable Just-In-Time debugging: On the Tools menu, click Options. In the Options dialog box, select the Debugging folder. In the Debugging folder, select the Just-In-Time page. In the Enable Just-In-Time debugging of these types of code box, select or clear the relevant program types: Managed, Native, or Script. To disable Just-In-Time debugging, once it has been enabled, you must be running with Administrator privileges. Enabling Just-In-Time debugging sets a registry key, and Administrator privileges are required to change that key. Click OK.

Issue How to find the MAC address / Physical Address of a computer. Product Line Andover Continuum, EcoStruxure Building Operation, Other, Satchwell MicroNet, Satchwell Sigma, TAC IA Series, TAC INET, TAC Vista Environment All computers Cause The MAC address of a computer may be required when working on licensing issues. MAC stands for Media Access Control and is a unique identifier assigned to network interfaces for communications on the physical network segment. Resolution Go to the Start > Run.   Type "cmd" into the Open field. In the CMD window, type the command "ipconfig /all". Locate the connection that the computer is currently using (For this example it is the Ethernet adapter Local Area Connection). You will find the Physical Address (MAC address).

Issue Need to perform autosensing on an ethernet port but do not have a cross over cable. Product Line Andover Continuum, EcoStruxure Building Operation, TAC INET, TAC Vista Environment Ethernet connection to an Automation Server Xenta device ACX BCX Auto-Sensing, Auto Sensing direct connect Auto uplink and trade Universal Cable Recognition Cause Need to direct connect with a straight through or normal patch cable from a computer or laptop to the AS, Xenta, BCX, ACX  Resolution Since 1998, the distinction between uplink and normal ports and manual selector switches on older hubs and switches are obsolete. If one or both of two connected devices has the automatic MDI/MDI-X configuration feature there is no need for crossover cables. Now you can plug your laptop right into the Ethernet port of the device with just a regular patch cable. 

Issue Problems with the speed a script was appearing to run. How to adjust the Variable Connector. Environment StruxureWare Building Operation site with BACnet or LON  Cause Definition of a variable connector Problems with the speed a script was appearing to run Resolution Definition Variable connectors The SmartStruxure system has a base philosophy where different objects and properties are connected using bindings. Bindings do not usually cause any significant load to the system, but in some cases the bindings need to be driven by an external object called a variable connector. The user does not create variable connectors. The system creates variable connectors either when there is no obvious direction of the binding (analog value to analog value, for example) or when passing data between protocols (LonWorks to BACnet or LonWorks to Modbus). Due to load caused by the variable connectors, limit the number of variable connectors according to the variable connectors table above. It is possible to increase this number, but close monitoring of CPU load and memory consumption is needed. Release 1.4 Anticipated removal of Variable Connectors and replaced with a Binding Table. Variable Connectors cannot be removed. The maximum number of variable connectors is (Used when the binding has no obvious direction or when passing data between protocols) Enterprise Server: No practical limit known Automation Server:500 There are 'variable connector' objects in the system folder underneath the server that have a polling time associated with them and these are applied to both incoming and outgoing script variables. They default to 10 seconds polling time so regardless of the setting of a script cycle time it is subject to these polling times. Note: The default value of 10 seconds polling time for values regardless of BACnet, LON or otherwise.  Variable Connectors are automatically created when the bound values themselves are of a kind that lack the logic needed for polling. Editing the binding (by clicking the pencil icon next to the binding list path) indicates that there is a variable connector associated with the binding.   Below is a screen capture for Variable Connector Settings. Transfer Value Click the Force value button and enter the value that you want to force onto the binding. Type Select how the binding is updated. Periodic polling updates the destination value at regular intervals. Change of value updates the destination value only when the source value changes, and only when the change is significant enough. Interval Select the number of seconds between updates. Propagation delta for value changes Enter how much the source value must change to trigger an update of the destination value. Retransmit interval(s) Enter the number of seconds between forced updates. In most cases, you bind a source value to a destination property that is an input variable in a program. The binding is direct, and the input variable actively reads the source value during every execution cycle of the program.However, not all bindings have a destination property that is an input variable in a program. When you create a binding, with a destination property that cannot read or poll the source value, StruxureWare creates a variable connector. Most bindings do not need variable connectors, but when they do, StruxureWare creates them automatically. There are basically three things you can do with a variable connector: Configure polling method Configure polling rate Force the bound value In a direct binding, you do not need to concern yourself with the polling of a bound value. There will be a program execution cycle involved that manages polling. With a variable connector you can configure the default polling settings in the properties of the variable connector. For more information, see Configuring a Variable Connector . Also, in a direct binding, you may be able to force the bound value in the destination property. With a variable connector, you force the bound value in the properties of the variable connector. Variable connectors and their properties are accessible from the Control Panel. There is a Variable Connectors list in the System folder of each server. Variable connectors are also accessible from the Binding point list. LonWorks network variables and configuration properties can be bound to each other in LonWorks bindings. They can also be bound to most points in StruxureWare, such as programs, graphics, alarms, and trend logs, but then StruxureWare bindings is used, not LonWorks bindings.

Issue Changing a value from a WebStation. Environment Web Changing a value Changed value returns to its original value Cause The value appears to have been changed correctly, but when the page is refreshed, or changed and returned to, the original value is shown. Resolution There are two ways to change a value as shown below; 1 - Using the edit option. -  Select "Edit" which is located on the right-hand side of the current value.   The "Edit" box is displayed.     Enter the required value and select "OK". Now go to the lower right-hand side of the window and select "Apply".   2 - Typing over the current value -  Wipe over the current value to highlight it, and enter required value. Now go to the lower right-hand side of the window and select "Apply".  

Issue Telnet does not come enabled on Windows 7 PCs Product Line Andover Continuum, EcoStruxure Building Operation, Field Devices, Other, Pelco, Satchwell MicroNet, Satchwell Sigma, TAC IA Series, TAC INET, TAC Vista Environment Windows 7 OS Cause This feature does not come enabled in Windows 7. Resolution Click on the Start Icon and type Programs in the Search Window Click on Programs and Features Click on Turn Windows features on or off When the window becomes populated, check the box for Telnet Client   Click on Ok to apply change, exit Programs and Features window Type Telnet at the prompt and start your session

Issue Binding a PVR module in the Function Block Program directly to a "Value" object? Environment Function Block Program FBP PVR module Cause The PVR module is not available to bind in the binding window. Resolution To enable the PVR module to be bound, it must first be made "Public", this is selected when editing the module.     Having saved the Function Block Program, the PVR module can now be bound in the normal way.  

Issue While attempting to activate a purchased license, the entitlement ID shows that it is valid, but there is no available licenses that can be activated, or less available than listed on the entitlement certificate. The entitlement ID or certificate is lost. Unable to return the license in order to activate it on another PC Getting "This Operation is not applicable for Trusted Fulfillments" Product Line EcoStruxure Building Operation Environment Building Operation License Administrator Cause In order to activate a SmartStruxure license, it must be available and unused. If a license is already in use, it needs to be returned before it can be activated. Note that all handling of licenses are to be carried out using the License Administrator. Licenses are not returned or rehosted as it was done for TAC Vista. Resolution Refer to WebHelp article #6687 for instructions on how to return a license If you are unable activate a license because you don't have the entitlement ID or certificate, note the activation ID before you return the license, and send that to Product Support Services in order to get the associated entitlement ID Launch the License Administrator Go to the Diagnostics tab and click the refresh icon in the top left corner. The entry in the list that is labeled Entitlement ID is actually the Activation ID. In the case that the computer has crashed or you are unable to successfully return the license on your own, contact Product Support Services providing the following details: A copy of the entitlement certificate The site name An elaborate explanation of why you are not able to return the license yourself

Issue COVNotification messages in BACnet captures. Product Line EcoStruxure Building Operation Environment BACnet IP network BACnet MSTP network BACnet networks with controllers that support COV (Change of Value) Cause COV increment is an attribute that is available in several BACnet points that is settable and when this attribute COV Increment is left at a setting of zero can cause COVNotification messages appearing as broadcast storms creating un-necessary network traffic. Resolution It is suggested to set the value of the COV increment attribute to something other than the default zero or to a value that is pertinent to the point in question. The COVNotification services are uni-cast messages and can have a many to one relationship depending on how may clients are subscribing to the point. Example: Jobsite has a BACnet OAT (outside air temp) input point with the COV increment of zero. The OAT point is added to the watch window or a binding to a graphic or program. The OAT is changing ridiculously fast due to wind and intermittent clouds. The value is changing by 1/1000 of a degree and each COV (change of value) message is delivered out to any object that is referencing the point. But does the value need to display or do we care if the point changes by 1/1000 of a degree. Let's say that the sites requirement only needs value changes of 2 degrees or more. The COV increment can be set to 2.0 and now the UnconfirmedCOVnotification message would only be sent if the OAT changed by 2 degrees or greater. This alone would reduce 100's if not 1000's of network packets. Imagine a jobsite with the above scenario and 100 different points all with the COV increment of zero. Setting the COV increment to something other than the default of zero is one of many ways to improve BACnet communications and reduce what may appear as broadcast storms on the network.

Issue LonPort is discovered and shows as online but no Service Pin is received Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation ES 1.1 LConfig Cause Since StruxureWare Building Operation ES is running as a service, the legacy driver also has to be. Resolution Open LConfig Click advanced Change Legacy Driver to run as service

Issue Description in List View editing causes error Environment StruxureWare Building Operation 1.1.xxx Cause 1. Enter a description in the List View. This can be for anything, I selected a folder in the following two screenshots. 2. Boiler1 Folder: Description is Boiler 3. Boiler2 Folder: Description is Chiller 4. Graphics Folder: Description is Chiller 5. When I cut Ctrl-X the Graphics description and them on down the list, (imagine I have a lot of folders or devices I am putting descriptions in) if I save when not in that field, the error below occurs.  Resolution Upgrade to StruxureWare Building Operation Workstation release 1.2.0.659 or higher.

Issue Unable to select extended trend logs in Trend Log Comparison Report. Environment StruxureWare Enterprise Server Cause Extended Trend Log property " Include in reports? " defaults to false. Resolution Extended Trend Log property " Include in reports? " must be set to true.  

Issue When VisiSat 2.1 Build 185 on some Windows XP pro / Visio 2003 computers the following error is displayed. Internal error 0x86DB08A9 VisiSat 2.1 Build 185 Cannot find VisiSat "CustomiseUI" add-on to Visio. Some or all the files required by VisiSat are missing. You may need to re-install Visio and/or VisiSat to clear the problem. Environment CustomiseUI Add on to Microsoft Visio 2003 VisiSat 2.1 Build 185 Cause Visio 2003 does not recognise or register VisiSat 2.1 Build 185 installation CustomiseUI Resolution Open Visio 2003 (Not VisiSat) On the menu bar, under tools select options.   Select the advance tab.   Select file paths.   Delete all entries. Then select OK   Select OK.   OK the next window Visio 2003 should now close.   Run up VisiSat VisiSat should run up OK now.   If you close VisiSat and open Visio 2003 the paths should now show.   VisiSat should open correctly now. Option: If you are running on Windows 7 you could consider upgrading the Visio 2003 software to Visio 2007 or Visio 2010. If you require further assistance, please contact Product Support.

Issue Values of Units change when viewing English OS from Metric OS Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation Site Cause Changes in Unit Value English OS example of Pressure Unit of Bar: Metric of same exact unit from a Metric OS: Resolution This behavior of different Units being displayed on OS systems with metric units. In the State the English units for measurement are on the OS and StruxureWare Building Operation. The issue described is Functions as Design in StruxureWare Building Operation. Not just IO, but all the functions are like this. The localization follows the regional settings of the PC’s operating system, out of the control of users. To change your PC's measurement System, complete the following steps: Open the Control Panel on your PC and browse to "Region and Language" In the Region and Language editor, click on the "Additional Settings" button found at the bottom of the "Formats" tab. Change the measurement system to the desired system                                                                  Click OK to close all Windows Restart all applications for changes to take effect.