Echelon SmartServer 2.2 SR5/SP5 Programming Tools ReadMe

Release 4.09.018, December 2, 2016

Copyright © 1998 – 2016 Echelon® Corporation
All Rights Reserved

1     Introduction

This document describes SmartServer 2.2 SR5/SP5 Programming Tools Release 4.09.018.  If you have licensed the SmartServer 2.0 Programming Tools, you can update an installation of the SmartServer 2.0 Programming Tools to Release 4.09.018.  A demo version of the SmartServer 2.2 SR5/SP5 Programming Tools is included with SmartServer 2.2 SR5/SP5.

Additional information and updates for the SmartServer 2.2 SR5/SP5 Programming Tools, including updates to this document and other SmartServer documentation, service packs, and critical software updates, may be available at www.echelon.com/smartserver.  The latest documentation, service packs, and updates may not be included with your SmartServer 2.2 Programming Tools DVD.  See Echelon’s Knowledge Base at www.echelon.com/support for answers to frequently asked questions.

SmartServer 2.2 SR5/SP5 is compatible with 64-bit and 32-bit versions of Windows 10, Windows 8.1, Windows 8, and Windows 7, and is also compatible with 32-bit versions of Windows XP.  To provide full functionality, the SmartServer software must be used with Microsoft Internet Explorer 8 or newer, Google Chrome 46 or newer, Mozilla Firefox 41 or newer, or iOS 9 Safari or newer.  If you are using a SmartServer with an LNS® Server, OpenLNS Server, IzoT® Net Server, the LonMaker® Integration Tool, the OpenLNS Commissioning Tool, or the IzoT Commissioning Tool, you must be using the latest releases of each.

2      Contents

1        Introduction. 1

2        Contents. 1

3        Release Identification. 1

4        Installing SmartServer 2.2 SR5/SP5 Programming Tools. 3

5        Improvements. 4

5.1         Improvements in SmartServer 2.2 SP3 Programming Tools. 4

6        Fixes. 4

 

3      Release Identification

This document applies to the SmartServer 2.2 SR5/SP5 Programming Tools (Release 4.08).  To verify that you have this release on your computer, follow one of the following procedures:

·        For Windows 10, type Apps & Features in the Search box, press ENTER to open Apps & Features, and then click Echelon SmartServer 2.2 SR5/SP5 Programming Tools.  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 8.1, Windows 8, and Windows 7, click the Start button, type Programs and Features in the Search box, press ENTER to open Programs and Features, and then click Echelon SmartServer 2.2 SR5/SP5 Programming Tools.  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 SmartServer 2.2 SR5/SP5 Programming Tools.  Click the Click Here for Support Information link. 

The following table summarizes the SmartServer and i.LON 100 e3 plus release history, with SmartServer 2.2 SR5/SP5 in bold:

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 SP1

4.04.088

August 2010

SmartServer 2.0 SR2 and SP 2

4.04.119

February 2011

SmartServer 2.0 SR2 and SP2 Update 1

4.04.119

July 2011

SmartServer 2.0 SP3

4.4.131

May 2013

SmartServer 2.1 Firmware (streetlight system use only)

4.05.094

October 2010

SmartServer 2.1 Firmware SR1 (streetlight system use only)

4.05.140

November 2012

SmartServer 2.0 SP4 / SmartServer 2.2

4.06.048

October 2013

SmartServer 2.0 SP4 / SmartServer 2.2 Update 1

4.06.048

December 2013

SmartServer 2.2 SR1/SP1

4.06.057

September 2014

SmartServer 2.2 SP2

4.07.003

March 2015

SmartServer 2.2 SP3

4.07.018

November 2015

SmartServer 2.2 SR4/SP4

4.08.012

March 2016

SmartServer 2.2 SR5/SP5

4.09.018

December 2016

The Echelon SmartServer 2.2 SR5/SP5 download includes a demo version of the SmartServer 2.2 SR5/SP5 Programming Tools.  You can use the demo version to write an unlimited number of SmartServer apps.  To compile your custom apps and deploy them on your SmartServer, you must order an Echelon SmartServer 2.2 Programming Tools DVD (Echelon Model 72111‑442), which includes the full version of the SmartServer Programming Tools.

4      Installing SmartServer 2.2 SR5/SP5 Programming Tools

You can install SmartServer 2.2 SR5/SP5 Programming Tools from a SmartServer 2.2 SR5/SP5 DVD or SmartServer 2.2 SR5/SP5 download image, or update any prior release of SmartServer 2.2 Programming Tools, i.LON SmartServer 2.1 Programming Tools, or i.LON SmartServer 2.0 Programming Tools to SmartServer 2.2 SR5/SP5 Programming Tools by installing SmartServer 2.2 SR5/SP5.  Prior SmartServer 2.2 and SmartServer 2.0 Programming Tools releases were included with SmartServer 2.0 with no service packs, SmartServer 2.0 SP1, SmartServer 2.0 SR2/SP2, SmartServer 2.0 SP3, SmartServer 2.1, SmartServer 2.2, SmartServer 2.2 SR1/SP1, SmartServer 2.2 SP2, SmartServer 2.2 SP3, and SmartServer 2.2 SR4/SP4. 

SmartServer 2.2 SR5/SP5 is available on a DVD or as a free download at www.echelon.com/smartserver.  To install the service pack you must have a prior release of the SmartServer 2.2, SmartServer 2.1, or SmartServer 2.0 software installed on your computer.  To upgrade the i.LON 100 e3 Plus or SmartServer 1.0 software, you can purchase a license for the SmartServer 2.2 Software and the software will be provided to you as a software download.  The SmartServer 2.2 software will not run on hardware releases prior to the i.LON 100 e3 Plus due to the smaller memories of the prior hardware releases.

To install SmartServer 2.2 SR5/SP5 Programming Tools, follow these steps:

·        If you are installing the SmartServer 2.2 SR5/SP5 software from a SmartServer 2.2 SR5/SP5 DVD, insert the DVD into your DVD drive.  If your computer does not have a DVD drive, insert the Echelon SmartServer 2.2 SR5/SP5 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.2 SR5/SP5 setup application does not start immediately, open the setup.exe file on the root directory of the Echelon SmartServer 2.2 SR5/SP5 DVD.

If you are installing SmartServer
2.2 SR5/SP5 Programming Tools Demo from a file that you downloaded from the Echelon website, double-click the downloaded file in Windows Explorer to extract all the files.  Click OK when all the files are extracted.  The SmartServer 2.2 SR5/SP5 setup application will start automatically.

·           The Echelon SmartServer 2.2 SR5/SP5 setup application main menu appears.

·           Click Install Products.  The Install Products dialog appears.

·           Click Echelon SmartServer 2.2 SR5/SP5 Programming Tools (or Demo).  The Echelon SmartServer 2.2 SR5/SP5 Programming Tools installer appears.

·           Follow the steps of the installation wizard.  If you have an existing installation of SmartServer 2.2 Programming Tools or prior, the installation will automatically update it to SmartServer 2.2 SR5/SP5 Programming Tools.  See Chapter 2 of the Programmability Tools User’s Guide for more information on installing the SmartServer Programming Tools 2.2 software.

5      Improvements

5.1    Improvements in SmartServer 2.2 SP3 Programming Tools

5.1.1     Windows 10 Support

The SmartServer Programming Tools can now be installed on 64-bit and 32-bit versions of Microsoft Windows 10.

5.1.2     New Default SmartServer Installation Path

The default SmartServer Programming Tools installation path is now under C:\program files (x86)\lonworks on 64-bit versions of Microsoft Windows and C:\program files\lonworks on 32-bit versions of Microsoft Windows. (ILC-2814)

6      Fixes

The following table summarizes the issues fixed in this release.  The Issue column lists Echelon internal problem tracking numbers.

Issue

Description

50550

Fixed an issue with deploying multiple drivers on a SmartServer that has data points with the same names. The data points were displayed in the SmartServer tree for the first driver deployed, but not for any additional drivers deployed thereafter. 

50759

Fixed an issue with reloading a custom app causing the SmartServer to fail if more than one custom app module was deployed on the SmartServer.

51442

Fixed an issue with the rs232_read() function causing a driver to remain in an infinite loop until receive (Rx) data was received from the RS‑232 interface. 

53531

Changed the GetDpPropertyAsPointStatus() function  to return an unsigned value instead of a signed value. 

53596

Fixed an issue that caused custom apps that included signed quad network variables to fail.

 

 

Echelon, LON, the Echelon logo, LonWorks, NodeBuilder, LonTalk, LonPoint, Neuron, 3120, 3150, LNS, i.LON, IzoT, LonLink, LonResponse, LonSupport, OpenLDV, LonScanner, and LonBridge are trademarks of Echelon Corporation that may be registered in the United States and other countries.  For a complete list of registered trademarks see the Echelon Web  site at www.echelon.com.  All Rights Reserved.

 

Other trademarks belong to their respective holders.