Building Automation Knowledge Base

Issue Creating Folder Structure to Organize Reports Environment SmartStruxure StruxureWare for Building Operation Report Server Cause A large number of reports may result in difficulty navigating the report tree.  The following processes allow you to sort the various created reports. Resolution Creating folders to store the saved reports.  Log into the SQL Report manager from the reports Server using the URL http://localhost/Reports   or  http://localhost/Reports_SQLEXPRESS     Open the folder you wish to add new folders to.  For this example I will use the Production reports folder.   Click "New Folder" Name the Folder and click OK NOTE: In order for the Folder to show up in the reports Server, it will have to have at least one object inside of it. You can move any report to the new folder by clicking on the drop down beside it and selecting "Move". Updating the StruxureWare reports Server to display the new folders  Connect to the StruxureWare Web Reports interface, using an account that is part of the Reports Administrators group. Click on Report Packs. At the bottom of the Screen click "Synchronize" This must be done to apply any changes made in the SQL Report Server Web interface to the StruxureWare Reports Server Saving a Reports parameters for quicker access.  You may wish to save a report to quickly run last months Trend Data. This type of saved report is referred to as a "Dashboard Report" Run the report you wish to save, using the desired parameters Above the report, click Save As In the Report name Field, type the Folder name and report name that you wish to use. NOTE you are limited to 30 characters for the report name. Be sure to check the "Dashboard report" option. Without this option checked you will be making a duplicate of the original report. The Dashboard Report option saves the parameters you have selected. Click "Save as"

Issue Energy Reports not working in 1.3 and earlier Product Line EcoStruxure Building Operation Environment StruxureWare Web Reports StruxureWare Reports Server Cause For 1.3 and earlier, in order for a log to be tracked as an energy report it must have a units type that indicates it is a metered signal. Resolution For any logs that do not have Units set.  Add one of the possible Unit types shown below. You should not change units on a log that is already running.  If you have entered the wrong type of units you will need to delete and re-create the logs. If this is not possible.  Use the following directions: In the System tree pane, browse to System>Report manager View the metering log filter property to see all unit types that will be interpreted as Energy logs.  The energy objects must all reside within a single Energy folder. In the event that you have already set unit on a log, you should be able to add the unit to the list in this field.  Note:  It is not necessary to include the prefix / suffix of the same unit.  That is if you are using MWh or kWh then this is covered by the unit Wh in the Meter log filter.  You must make sure that the units are defined in the monitor point (object), trend log and associated extended trend log for the values to be shown in the Energy Reports.

Issue Software Administrator shows red outline (box) on the Communication Ports (HTTP / HTTPS) Enterprise Server service is not starting - log displays ..The server has made to many unsuccessful attempts to start... Product Line EcoStruxure Building Operation Environment Building Operation Enterprise Server Cause The Enterprise Server service will not start if the ports assigned during installation are already in use by another software package. Resolution To rectify this the port numbers in the Software Administrator need to be changed from their current value. Open the Building Operation Software Administrator Under the Communication Ports change any port that is highlighted or surrounded by a red box After making these changes select the Apply button Attempt to start the service.

Issue Minimum display is 1024x768 which is too small for proper screen size Environment SmartStruxure up to release 1.3 Cause Release notes for 1.3 in 9.2.1 state the Minimum display is 1024x768 which is too small for proper screen size. In the screen capture below, a simple schedule is created, and then a New Schedule Event is selected which opens the window. the window is larger than the screen size, missing the top and bottom. Resolution Adjust the screen resolution to a larger size which is suitable. Size is dependent on hardware specifications.

Issue I/NET Controller in StruxureWare Building Operation has a blue circle with a white down arrow on top of it. Environment I/NET Integration StruxureWare Building Operation Cause Any change to the I/NET controller will result in this indication requesting an upload. Changing a configuration in a time schedule or updating a calc extension on a point are two examples of what might cause this. Please note that the Upload DOES NOT complete the same action as a Station Save in I/NET. Upload will sync the StruxureWare Database with the I/NET database. To perform a station save from StruxureWare, right click on the Controller and select "backup". Resolution Expand the I/NET Interface network object Right click on the offending controller Select Upload Wait a few seconds. A refresh of the System Tree may be required.

Issue BASEDON keyword and Plain English Programming BASEDON key word fail Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation site with up to release 1.3 Cause Below is a sample program which uses the BASEDON keyword. Also, here are the steps to use that program: Create script program using keyword BASEDON (Below) Create an input and output for the program (below program that is EntreeBase and SortieBase) Set the input Entreebase to 1,2,3,4,5 and program errors out. Set input to 6 and program runs   Numeric Input EntreeBase Numeric Output SortieBase Line Debut basedon Entreebase goto 1,2,3,4,5 goto 6 Line 1 SortieBase=1 goto Suite Line 2 SortieBase=2 goto Suite Line 3 SortieBase=3 goto Suite Line 4 SortieBase=4 goto Suite Line 5 SortieBase=5 goto Suite Line 6 Sortiebase=6 goto suite Line suite if sortiebase<1 then Sortiebase=20 if ts<5 then goto suite else goto Debut Line E Sortiebase=10 goto Suite  Resolution BASEDON keyword has been submitted as an issue and expected to be corrected in a future release.

Issue How to connect and configure current inputs to a UI module? Product Line EcoStruxure Building Operation Environment Building Operation I/O Module 16 Ch UI (UI-16) Building Operation I/O Module 8 Ch UI/4 Ch DO (Form C) (UI8-DO-FC-4) Building Operation I/O Module 8 Ch UI/4 Ch AO (UI8-AO-4, UI-8/AO-V-4) Building Operation MP-C, MP-V, RP-C, IP-IO Cause How are Current inputs connected and configured? Resolution To connect and configure a current input to a SmartX device no additional external resistors are required, the internal resistor in the SmartX device is automatically put into the circuit by selecting "Current Input" when creating the input object, there are no DIP switches to change as in some other products. An external Power supply will be required to provide the current in the circuit through the sensor and into the UI input. 24V DC supplies are usually used to power the sensor & provide the current drive. Further information regarding the SmartX device's internal resistor can be found in the Hardware Reference Guide. Example Circuit: The input point configuration allows you to define the top and bottom or the current scale (usually 4-20mA or 0-20mA) and the engineering units this corresponds to i.e. 0-100% or 0 - 400 DegC. The following screen shot example shows the configuration for a 4-20mA input signal represented as 0-100%

Issue A specification for a power meter states that it provides KYZ pulse outputs. What is a KYZ pulse output? Product Line All Product Lines Environment Utility Meter with KYZ pulse outputs Cause Some meter specification sheets may state that the device outputs KYZ pulses. Resolution KYZ is a designation given to a relay used to create pulses for electrical metering applications. It is commonly a Form C relay (SPDT). The term KYZ refers to the contact designations: K for common, Y for Normally Open, and Z for Normally Closed.

Issue StruxureWare Building Operation WorkStation crashes randomly while working in it. The following error message is displayed. Environment Building Operation WorkStation Cause The "Value cannot be null. Parameter name: d" crash is caused by a Windows Presentation Foundation (WPF) application defect. Resolution To resolve the issue: Go to the following link http://support.microsoft.com/kb/2461678. This link will provide additional information on the defect and how to fix the problem.   Apply the hotfix that is provided underneath the section titled "Resolution".

Issue Metric vs. Imperial Units as displayed Using Webstation Regional Settings Any device, will by default, show configured units. Regional settings must be applied to normalize all devices. Product Line EcoStruxure Building Operation Environment Webstation TGML Graphics SNVT values Cause Incorrect Units will appear in webstation if webstation regional settings are not configured correctly. Resolution Log into Webstation Select Settings > Change Regional Settings   Select the desired Language Select the desired Measurement system Click Ok NOTE: Settings are preserved via a cookie stored on the local PC. Any time cookies are deleted this will return to its default setting.

Issue Windows Application logs may be requested by Technical Support to assist with a reported issue. Product Line All Product Lines Environment All Microsoft Windows Operating Systems Cause Unspecified cause. Resolution Press WINDOWS + R on keyboard of the Windows system that the report is to be from. The Windows key is usually located between the CTRL and ALT keys and has a picture of a flag on it. Type Eventvwr.exe and click OK Event Viewer will now start. Expand Windows Logs and then right click on Application. Click on Save All Events As... When prompted save the file as an *.evtx file to an accessible location. Email the *.evtx file to your support representative.

Issue When selecting a list view, last column is always on next page Environment Release 1.2 and 1.3 Beta 3 Cause When Printing a list view, last column is always on next page.  Resolution At the moment only workaround: to add 4th "dummy" column. Then the 3 necessary columns are on the first page and the dummy is on the second.

Issue When creating a FB program and use WDAY, change the date on the AS or ES to Sunday, the WDAY changes the day to 0 (zero). Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation and all compatible operating systems including Windows XP, Windows 7, Windows Server 2008, and virtual machine environments. Cause Create a FB program and use WDAY, then change the date on the AS or ES to Sunday, the WDAY changes the day to 0 zero. Steps to reproduce problem: Create FB Program in AS or ES Use the WDAY While using the Graphics Viewer in the AS or ES, WDAY shows correct weekday (today is 2) Change the date on the AS or ES to a Sunday i.e. 12-09-16 which is Sunday,September 16, 2012 View FB program in Graphics Viewer, which now shows 0 as if today were now 0  The WDAY FB program should show 7 which is Sunday. Monday=1 Tuesday=2 Wednesday=3 Thursday=4 Friday=5 Saturday=6 Sunday=7 Resolution This will be resolved in a future release. Currently, there is a alternative: with an XPI block, make WDAY 0 = 7.A second alternative would be to add an if-statement: if(output = 0){output = 7}  

Issue When a DELR or DELI block is used with a comparison operator to detect a change of value in the output of a function block, the output of the comparison operator should go ON for one scan when the source output value changes. If the source function block is a PVR or PVI this does not occur. For example: This code does not work This code works Product Line EcoStruxure Building Operation Environment StruxureWare Building Operation version 1.3.0 or earlier Function Block Editor Cause There is a defect in StruxureWare Building Operation version 1.3.0 or earlier that causes this behaviour when writing to a public PVR or PVI block in a Function Block Program in the ES or AS directly from the Workstation. Resolution This defect has been logged with Quality Center and will be fixed in SmartStruxure version 1.4.0 Meanwhile, the workaround is to insert any compatible block immediately after the PVR or PVI.  For example: The inserted block could be an operator, an expression block or even another DELR. Although the workaround works, the preferred practice for new applications would be to replace the PVR with a RI and bind the RI to an Analog Value in the ES or AS. This defect does not occur in Menta programs in Xenta controllers, including those written in the SmartStruxure Menta Editor.

Issue Can the Execution Precedence determine the priority of a program binding to a value? Environment SBO Function Block and Script programs Cause Clarification on the function of Execution Precedence is required. Resolution In both Function Block and Script programs there is an attribute called Execution Precedence, this can be set in the program "Properties", Basic tab. For a Function Block program:    For a Script Program: Execution Precedence determines the order that the programs will be run, the lowest numbers will be run first. In the 2 screenshots above the Function block program (Value 1) will be run before the Script program (Value 20). This can be used for applications where a calculation is done to generate a value, that is then used in a second program e.g. Calculation of a compensated setpoint, that is then used in a PID control program as the reference value. The PID program must have a higher Execution Precedence than the setpoint calculation. Execution Precedence does not affect priority. If the outputs of 2 programs are bound to a single value, both programs will be trying to control the value and give an indeterminate result.   To combine the outputs of 2 programs the programmer must use the appropriate logic to determine how the 2 signals should be combined for the application. So for Binary values use one of the logical operators: AND, OR, XOR etc, For Analog values combine the 2 results with Max, Min, Average etc as required.

Issue The ES crashes during startup   SE.EnterpriseServer.exe - Application Error occurs, and the Building Operation Enterprise Server service cannot be started.  Error contains "The memory could not "written"".   The port fields in software administrator shows a red indication on one or more of the ports Environment Enterprise Server Software Administrator IP ports Cause A program is already using the ports defined for the Enterprise Server     In general   You can check which program it is, by entering the following command in a command prompt, replacing ":port number" with the number you want to check, e.g. "0.0.0.0:80" for port 80: netstat -aonb | find "0.0.0.0:port number"     Now in the task manager, enable the coloumn "PID (Process Identifier)", and look for the process ID you get to the far right when running the command above. That will show what program is taking the port.       Skype   If you are running Skype on the Enterprise Server PC there could be a conflict between the default IP port settings and the IP port settings in Software Administrator. The default ports for SmartStruxure Enterprise Server are 80 and 443. By default, Skype will "use port 80 and 443 as alternatives for incoming connections" if the configured port is unavailable. When Skype is launched it appears to search for an open IP port. If it cannot find an open port within a period of time it may default to ports 80 and 443 as a backup. This behaviour appears to be intermittent.    TeamViewer In newer versions of TeamViewer this is no longer an issue, but it's good practice to select "Use UDP" in the advanced settings of TeamViewer Resolution In general, you can change the ports used by the Enterprise Server in the Building Operation Software Administrator.   If the issue is Skype do the following: In the Skype tools menu go to “Options…” Expand the “Advanced” settings on the left hand side. Click “Connection” in the Advanced section. Uncheck the setting that says "Use port 80 and 443 as alternatives for incoming connections"

Issue How to change the IP address in the EC/ES software when it is grayed out. Product Line EcoStruxure Building Operation Environment Building Operation Enterprise Central (EC) and Enterprise Server (ES) Building Operation WorkStation Cause The EC/ES IP address is grayed out in the Network Tab of the Server Properties and cannot be changed.  This setting is only used to view the IP address that the server is currently using - typically the IP of the network interface card of the PC running this.  To change this setting it must be done through the Communications TAB of the server as detailed in the resolution.  Resolution EcoStruxure Building Operation 2.0 and above EBO 2.0 and above now supports multiple NIC configurations, see 2.0.1 Release Notes for details, in particular, the following note.   Note: That from 2.0 the server will still listen for incoming requests on all network adapters so this setting is only used for choosing which communication settings that the server will use to communicate with child servers. This allows other IP protocols on different networks, e.g. BACnet, Modbus, etc. to communicate with the Server.    It is now possible to select which network adapter the Enterprise Central and the Enterprise Server use.  See the following WebHelp Topic Configuring Network Interface Card for an Enterprise Server or for an Enterprise Central StruxureWare Building Operation 1.9 and below  When the IP address of the computer changes the ES will automatically update the "IP/DNS Address" in the Properties, Network tab. If your computer has multiple network connections, ensure that the Network Interface Card (NIC) to be used for the SmartStruxure network is set to be at the top of the list in the Adapters and Bindings. Go to the computer's Control Panel > Network Connections Select "Advanced, Advanced Settings... " from the menu. In the "Connections:" section, select the Network Connection to be used and press the up arrow to move it to the top of the list. For Windows 7 / Server 2008 See the following link on how to change the order of protocol bindings: How to change the network connection priority in Windows 7 For Windows 8 and beyond, please refer to Adapter priority setting unavailable in Windows 10 In addition to the ES Network Properties, there is also the Communication tab in the ES that lists all of the Server IP addresses in the system. If these need to be changed this can be done by selecting the server and clicking on the "Show/ Hide Communication settings" button circled in red below.

Issue Various webstation or TGML issues Environment StruxureWare Web Station Vista Web Station Cause Java script may be causing problems with Webstation.  Resolution   How to turn on Java Debugging: Open Control Panel Select Java Chose the advanced tab Expand Debugging and check all boxes Expand Java console and select Show console When future errors occur you can capture the errors from the java console If you do not wish to have the console pop up, you can change the Java console back to Hide console and access the logs at this location:  C:\Users\CURRENTUSER\AppData\LocalLow\Sun\Java\Deployment\log

Issue When binding using templates at Release 1.1 the user is presented with the number of objects that were found, this count was missing in Release 1.2 and 1.3 Environment Site with official release 1.2 and 1.3 versions Cause When binding using templates at Release 1.1 the user is presented with the number of objects that were found:      this count was missing in Release 1.2: Resolution The Count feature will be available in upcoming release.   

Issue The values from a script program are not showing up in Workstation in the correct format. For example, the values are Integers instead of a floating format that provides numbers down to the decimal. A second issue is that the data type icons are incorrect. The values used by the script program are not functioning because they are being calculated using the wrong units. The screen shot below shows a section of a binding page where the "Blr 1Failed" icon shows the correct data type (digital), but "Blr 2Failed and Blr 3Failed" do not. Environment Workstation Script Editor Cause The type of point and the units can be set inside the script program. This may cause a different format to be displayed in Workstation other than what is expected. When comparing values in a script program it may be required to set units to ensure that proper comparison is done. Resolution Check the settings of the points within the Script program.   Open up the Script program by right clicking on it in Workstation and going to Edit. With the script program open, look at the point and unit types in the Variables window at the bottom. Make sure that these are the desired settings and save the program.