Echelon i.LON® Vision 2.0 ReadMe

Release 4.04, August 2010

Copyright © 1998 – 2010 Echelon® Corporation
All Rights Reserved

1       Introduction

This document describes i.LON Vision 2.0 Service Pack 1 (SP1).  See Upgrading to i.LON Vision 2.0 Release 4.04 for instructions on installing the service pack and verifying that it has been installed, and  Changes in i.LON Vision 2.0 Release 4.04 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 SP1 and the SmartServer 2.0 SP1 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 at the time of the SmartServer 2.0 SP1 release are included with the LNS Server included with the i.LON LNS Server Editions, are included on the SmartServer 2.0 SP1 DVD and DVD image, and are also 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 Release 4.04. 2

5        Changes in i.LON Vision 2.0 Release 4.04. 3

5.1         Custom Datapoint Selector 3

5.2         Fixes. 3

6        Known Problems and Workarounds. 3

6.1         No Fault Tolerance for Local Preset Values. 4

6.2         Inner Layers Cannot be Selected. 4

7        Documentation. 4

7.1         Custom Datapoint Selector 4

7.2         Pulse Counter Output Behavior 5

 

3       Release Identification

This document applies to i.LON Vision 2.0 with Service Pack 1 (Release 4.04).  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.  The version number of i.LON Vision 2.0 with SP1 is 4.04.088.

·       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 version number of i.LON Vision 2.0 with SP1 is 4.04.088.

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

Name

Number

Date

i.LON 100 e3 plus

3.03

April 2008

i.LON 100 e3 plus SP1

3.04

December 2009

i.LON SmartServer

4.00.136

January 2008

i.LON SmartServer SR1

4.01.012

March 2008

i.LON SmartServer SR2 and SP2

4.02.055

October 2008

i.LON SmartServer 2.0

4.03.123

October 2009

i.LON SmartServer 2.0 Update 1

4.03.123

January 2010

i.LON SmartServer 2.0 SP 1

4.04.088

August 2010

4       Upgrading to i.LON Vision 2.0 Release 4.04

You can upgrade i.LON Vision 2.0 Release 4.03 to Release 4.04 by installing SmartServer 2.0 SP1. SmartServer 2.0 SP1 is available as a free download at www.echelon.com/ilon.  To upgrade a Release 4.03 installation to Release 4.04, follow these steps:

1.     Mount the image as a virtual DVD using virtual DVD software such as CloneDrive or MagicDisc.  If the SmartServer 2.0 SP1 setup application does not launch immediately, open the setup.exe file on the root directory of the Echelon i.LON SmartServer 2.0 SP1 DVD.  The SmartServer 2.0 Service Pack 1 setup application main menu appears. 

2.     Click Install Products.  The Install Products dialog appears.

3.     Click Echelon i.LON Vision SmartServer 2.0 SP1.  The Echelon i.LON Vision SmartServer 2.0 SP1 installer appears.

4.     Follow the steps of the installation wizard.  The installation will automatically upgrade the existing Echelon i.LON Vision SmartServer 2.0 installation on your computer to Echelon i.LON Vision SmartServer 2.0 SP1 Software.

5       Changes in i.LON Vision 2.0 Release 4.04

5.1      Custom Datapoint Selector

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

5.2      Fixes

The following table summarizes problems fixed in this release.  The EPR column lists Echelon internal problem tracking numbers. 

EPR

Description

54529

Selecting a cell in a table sometimes caused a crash. 

54559

The navigation tree object sometimes did not function properly when it is was embedded in a layer.

54563

Programmatic data point names did not support presets.

54580

Repeated text formatting generated superfluous HTML code with superfluous nested styles.

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. 

54700

You could not apply a background color to a single row within a table.

54751

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

54774

SmartServer custom Web pages did not support relative paths.  As a result, they do not work behind someproxy servers.

56683

The Poll Rate property in the Page Properties dialog did not function.

56745

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

57101

The NV index for an NV sometimes became negative after some changes to a device.

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      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)

7       Documentation

This section describes updates to the documentation.

7.1      Custom Datapoint Selector

The datapoint selector for custom Javascript objects now 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      Pulse Counter Output Behavior

The NvoPcValue output of the Pulse Counter functional block is updated internally to the SmartServer every time a pulse is received, but it is not propagated on the LonWorks channel until the specified update time interval expires to the value of the NviPcTrigger data point changes from Off to On.  (56568)

 

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