Echelon i.LON® Vision 2.0 SR2 and SP2 ReadMe

Release 4.04.119, February 2011

Copyright © 1998 – 2011 Echelon® Corporation
All Rights Reserved

1       Introduction

This document describes i.LON Vision 2.0 Service Release 2 (SR2) and Service Pack 2 (SP2). i.LON Vision 2.0 SR2 is shipped with SmartServer 2.0 SR2 Energy Managers, and you can apply SmartServer 2.0 Service Pack 2 (SP2) to update previous SmartServer 2.0 installations of i.LON Vision to the same version of the i.LON Vision software that is included with SmartServer 2.0 SR2.  See Upgrading to i.LON Vision 2.0 SR2 or SP2 for instructions on installing the service release and verifying that it has been installed, and Fixes for details on what is fixed in this release.

Additional information and updates, including service packs and critical updates, may be available at www.echelon.com/ilon.  The latest service packs and updates may not be included with your SmartServer.  See Echelon’s Knowledge Base at www.echelon.com/support for answers to frequently asked questions.

To provide full functionality, i.LON Vision 2.0 SR2 and the SmartServer 2.0 SR2 configuration software must be used with Microsoft Internet Explorer 7 or newer, or Mozilla Firefox 3.0 or newer.  If you are using SmartServer 2.0 with an LNS® Server or the LonMaker® Integration Tool, you must be using the latest Echelon LNS Turbo and LonMaker service packs and updates.  The latest LNS and LonMaker service packs and updates are available from www.echelon.com/downloads

2       Contents

1        Introduction. 1

2        Contents. 1

3        Release Identification. 2

4        Upgrading to i.LON Vision 2.0 SR2 or SP2. 3

5 Changes in i.LON Vision Release 4.04. 3

5.1 Custom Datapoint Selector 3

5.2 Hiding and Showing Datapoints. 3

5.3 Moving Layers with Arrow Keys. 4

5.4 Chinese, Japanese, and Korean Language Support 4

5.5 Fixes. 4

6 Known Problems and Workarounds. 6

6.1 No Fault Tolerance for Local Preset Values. 6

6.2 Presets Not De-selected After Move. 6

6.3 Navigation Trees Without Layers Do Not Display Correctly. 6

6.4 Inner Layers Cannot be Selected. 6

6.5 Table Properties Cannot be Set for Rows or Columns. 6

7 Documentation. 6

7.1 Custom Datapoint Selector 6

7.2 Hiding and Showing Datapoint Names. 7

7.3 Moving Layers with Arrow Keys. 7

 

3       Release Identification

This document applies to i.LON Vision 2.0 with Service Release 2 or Service Pack 2 software (Release 4.04.119).  To verify that you have this release on your computer, follow one of the following procedures:

·       For Windows Windows 7 and Vista, click the Start button, type Programs and Features in the Search box, press ENTER to open Programs and Features, and then click Echelon i.LON Vision SmartServer 2.0.  If the Version column is not displayed, right click the list header, select More, and then select Version to add the Version column.

·       For Windows XP, open Add or Remove Programs in Windows Control Panel, and then click Echelon i.LON Vision SmartServer 2.0.  Click the Click Here for Support Information link.

The following table summarizes the SmartServer and i.LON 100 e3 plus release history:

Name

Number

Date

i.LON 100 e3 plus

3.03

April 2008

i.LON 100 e3 plus SP1

3.04

December 2009

SmartServer

4.00.136

January 2008

SmartServer SR1

4.01.012

March 2008

SmartServer SR2 and SP2

4.02.055

October 2008

SmartServer 2.0

4.03.123

October 2009

SmartServer 2.0 Update 1

4.03.123

January 2010

SmartServer 2.0 SP 1

4.04.088

August 2010

SmartServer 2.0 SR2 and SP2

4.04.119

February 2011

SmartServer 2.1 (streetlight system use only)

4.05.093

October 2010

4       Upgrading to i.LON Vision 2.0 SR2 or SP2

You can upgrade previous versions of i.LON Vision 2.0 to i.LON Vision 2.0 SR2 by installing SmartServer 2.0 SR2 software from a SmartServer 2.0 SR2 DVD or from a downloaded provided by Echelon Corporation.  You can update a prior version of the SmartServer 2.0 software to SR2 by downloading and installing SmartServer 2.0 SP2. SmartServer 2.0 SP2 is available as a free download at www.echelon.com/smartserver but can only be installed on a computer with a prior release of the SmartServer 2.0 software.  To upgrade the i.LON 100 e3 Plus or SmartServer 1.0 software, you can purchase a license for the SmartServer 2.0 Software and the software will be provided to you as a software download.  To upgrade to SmartServer 2.0 SR2 or SP2, follow these steps:

·         If you are installing SmartServer 2.0 SR2 from a SmartServer 2.0 SR2 DVD, insert the DVD into your DVD drive.  If your computer does not have a DVD drive, insert the Echelon SmartServer 2.0 SR2 DVD on a network accessible computer that has a DVD drive and copy the files on the DVD to a shared network drive.  If the SmartServer 2.0 SR2 setup application does not start immediately, open the setup.exe file on the root directory of the Echelon SmartServer 2.0 SR2 DVD.

If you are installing SmartServer 2.0 SR2 or SP2 from a file that you downloaded from the Echelon website, extract all the files from the download file to a C:\SmartServer directory using a zip utility, and then open the setup.exe file in the SmartServer directory.

WARNING: On some computers, the setup application will not start if you extract the files to your user directory.  Workaround: Extract the files to a C:\SmartServer directory, and then run the setup application. (58181)

1.       The Echelon i.LON SmartServer 2.0 SR2 setup application main menu appears.

·         Click Install Products.  The Install Products dialog appears.

·         Click Echelon i.LON Vision SmartServer 2.0 SR2The Echelon i.LON Vision SmartServer 2.0 SR2 installer appears.

·         Follow the steps of the installation wizard.  The installation will automatically upgrade the existing i.LON Vision software installation on your computer to Echelon i.LON Vision SmartServer 2.0 SR2.  See Chapter 1 of the i.LON Vision 2.0 User’s Guide for more information on installing the i.LON Vision 2.0 SR2 software.

5 Changes in i.LON Vision 2.0 SR2 or SP2

5.1 Custom Datapoint Selector

The datapoint selector has been enhanced for custom Javascript objects.  See 7.1 Custom Datapoint Selector for documentation.  (53258)

5.2 Hiding and Showing Datapoints

You can now hide or show datapoint names globally within i.LON Vision.  See 7.2 Hiding and Showing Datapoint Names for documentation. (57418)

5.3 Moving Layers with Arrow Keys

You can move a layer by clicking the moving icon for the layer, and then use the arrow keys move the selected layer. (57196, 59262)

5.4 Chinese, Japanese, and Korean Language Support

i.LON Vision Web pages are now available in Chinese, Japanese, and Korean language versions, in addition to the previous English and German versions. (57186)

5.5 Fixes

The following table summarizes problems fixed in the i.LON Vision 2.0 releases and service packs.  The EPR column lists Echelon internal problem tracking numbers.  The release or service pack that first included the fix is listed in parentheses.

EPR

Description

54529

Selecting a cell in a table sometimes caused a crash.  (2.0 SP1)

54559

The navigation tree object sometimes did not function properly when it was embedded in a layer. (2.0 SP1)

54563

Programmatic data point names did not support presets. (2.0 SP1)

54580

Repeated text formatting generated superfluous HTML code with superfluous nested styles. (2.0 SP1)

54585

If you made changes to a frameset and published the Web page containing it, the changes did not always appear in your Web page.  (2.0 SP1)

54700

You could not apply a background color to a single row within a table. (2.0 SP1)

54751

You could not create a Navigation Tree object that has three or more nested Navigation Subtree items.   (2.0 SP1)

54774

SmartServer custom Web pages did not support relative paths.  As a result, they do not work behind some proxy servers. (2.0 SP1)

56683

The Poll Rate property in the Page Properties dialog did not function. (2.0 SP1)

56745

The Data Point Name Substitution Values dialog did not list Web pages that have the appropriate placeholders in them.  (2.0 SP1)

56983

A JavaScript exception sometimes occurred if a Scheduler object and SVG Slider object were placed on the same page. (2.0 SP1)

57005

Navigation objects did not work correctly if they were located in a different directory from the frameset. (2.0 SP1)

57010

Hyperlinks for ShowValue objects were not formatted correctly after the first visit. (2.0 SP1)

57018

Absolute to relative path conversions were sometimes incorrect. (2.0 SP1)

57046

Navigation Tree objects were limited to two levels. (2.0 SP1)

57101

The NV index for an NV sometimes became negative after some changes to a device. (2.0 SP1)

57188

Custom Web pages were sometimes deleted when upgrading Web pages from SmartServer 1.0 to SmartServer 2.0. (2.0 SP1)

57532

HTML anchors were not handled correctly. (2.0 SR2/SP2)

57632

HTML objects were permanently disabled if a specified feedback data point was not updated. (2.0 SR2/SP2)

57725

If you added a table to a layer, you could not select the layer. (2.0 SR2/SP2)

58045

The custom JavaScript Object did not show the keys defined in the JavaScript file and did not allow new ones to be added. (2.0 SR2/SP2)

58602

SVG objects could not be used to update data point values on an iPad. (2.0 SR2/SP2)

58799

The Data Log View object did not follow the poll rates specified in the Frameset or Page Properties dialogs. (2.0 SR2/SP2)

58816

The Data Log View and Data Point View objects did not display the correct data points when Day was selected in the Time Range property. (2.0 SR2/SP2)

58861

The slider in the Data Log View object was hidden when a fixed-time interval was specified in the Time Range property. (2.0 SR2/SP2)

58993

The Scheduler object could not be created or configured. (2.0 SR2/SP2)

59058

Clicking an i.LON Vision link (Link object or Show Value object with link specified) caused an "#" symbol to be appended to the URL; therefore, objects stopped working after <F5> was pressed.  (2.0 SR2/SP2)

59197

The LNS Text object sometimes failed on FPM Web pages. (2.0 SR2/SP2)

59350

You could not move a layer with an image if the image was bigger than the layer.  (2.0 SR2/SP2)

59522

When converting Web pages created using the original SmartServer i.LON Vision tool, the pages were sometimes corrupted by the upgrade process. (2.0 SR2/SP2)

6 Known Problems and Workarounds

This section describes known problems and their workarounds for this release.  Numbers in parentheses at the end of the descriptions are Echelon's internal problem tracking IDs.

6.1 No Fault Tolerance for Local Preset Values

The value of a local preset must match the format of the data point (for example, 100.0 for a SNVT_switch.value data point) or the local preset will not work.  Workaround: Specify a valid value for the data point or data point field when you create a local preset.  (54530)

6.2 Presets Not De-selected After Move

If you move a preset up or down the list in the Image Swapper, you cannot correctly change images.  Workaround: Close and reopen the dialog after you move a preset. (57593)

6.3 Navigation Trees Without Layers Do Not Display Correctly

If you add a navigation tree to a page that is not on a layer, it does not display correctly.  Workaround: Always use a layer when inserting a navigation tree. (57091)

6.4 Inner Layers Cannot be Selected

If you add an i.LON Vision object to a custom Web page, leave it in the default position in the upper left-hand corner of the Web page, publish the Web page, edit the Web page, and immediately add a new i.LON Vision object, the new object’s layer will be placed within the first object’s layer, and you cannot select the inner layer. Workaround:  Deselect the new object by clicking anywhere in the Web page, re-select the new object, and then move the layer to the desired location.  (54631)

6.5 Table Properties Cannot be Set for Rows or Columns

You cannot set size, alignment, cell style, or text wrap properties for entire table rows or columns.  Workaround: Select properties for each cell individually. (57594)

7 Documentation

This section describes updates to the documentation.

7.1 Custom Datapoint Selector

The datapoint selector for custom JavaScript objects parses the JavaScript code and assigns datapoints to keys and assigns custom arguments.  To assign a datapoint to a key, include an ELON_DP_KEY:<keyName> expression in your JavaScript code.  For example, “ELON_DP_KEY:Background” means the Background key is available as a datapoint key.  To create a custom argument, include an ELON_CUSTOM_ARGS=[“<argName>”,”<argName>”,] statement in your JavaScript code.  For example “ELON_CUSTOM_ARGS=[“BackgroundColor_ON”,”BackgroundColor_OFF”]” means that BackgroundColor_ON and BackgroundColor_OFF are available as arguments for customization. (53258)

// Demonstrate how to implement a Custom Javascript Object subscribed to several DPs

// that trigger distinct, distinguishable functions

 

// The string in square brackets must be identical to the file name

Echelon.CustomJavascript["EchelonMultiDpExample"] = function(argObj){

                    this.update = {

                                        // This function gets handed in the DP that was assigned to the key "Background" in i.LON Vision

                                        // and toggles the background color depending on the value of this DP

                                        "ELON_DP_KEY:Background": function(type, item){

                                                            if(item.UCPTvalue.length<2) m_span.innerHTML="Use DP with ValueDefs ON and OFF";

                                                            val = item.UCPTvalue[1].get();

                                                            m_span.style.backgroundColor = m_argObj.customArgs["BackgroundColor_"+val];

                                        },

                                        // This function gets handed in the DP that was assigned to the key "Value" in i.LON Vision

                                        // and displays the value of this DP

                                        "ELON_DP_KEY:Value": function(type, item){

                                                            if(item.UCPTvalue.length<2) m_span.innerHTML="Use DP with ValueDefs ON and OFF";

                                                            m_span.innerHTML=item.UCPTvalue[1].get();

                                        }

                    }

                    var m_span = argObj.domObj.appendChild(document.createElement("span"));

                    var m_argObj = argObj;

                    // this line of code tells i.LON Vision about the available customization parameters

                    this.ELON_CUSTOM_ARGS=["BackgroundColor_ON", "BackgroundColor_OFF"];

};

7.2 Hiding and Showing Datapoint Names

You can hide or show datapoint names globally within i.LON Vision.  To control datapoint name display, open the i.LON Vision View menu and set or clear the Show Object Names checkbox. (57418)

7.3 Moving Layers with Arrow Keys

You can move a layer by clicking the moving icon for the layer, and then use the arrow keys move the selected layer. (57196)

 

Echelon, LON, LonWorks, i.LON, LNS, and LonMaker are registered trademarks of Echelon Corporation in the U.S. and other countries.