Echelon i.LON® SmartServer 2.0 Programming Tools ReadMe

Release 4.03, October 2009

Copyright © 1998 – 2009 Echelon® Corporation
All Rights Reserved

1       Introduction

This document describes i.LON SmartServer 2.0 Programming Tools Release 4.03 (4.03.123).  This release (or newer) may be included with i.LON SmartServer 2.0 Programming Tool DVDs manufactured after October 2009.  If you have licensed the i.LON SmartServer 2.0 Programming Tools, you can upgrade an installation of the original SmartServer Programming Tools to Release 4.03.  A demo version of the i.LON SmartServer 2.0 Programming Tools is included with all i.LON SmartServers 2.0.  See Release Identification to determine what release you have, and Problems Fixed in Release 4.03 for details on what is fixed in this release.

This document contains important information not included in the i.LON SmartServer 2.0 Programming Tools documentation.  Additional information and updates for the i.LON SmartServer 2.0 Programming Tools, 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 i.LON SmartServer 2.0 Programming Tools DVD.  See Echelon’s Knowledge Base at www.echelon.com/support for answers to frequently asked questions.

You can use the i.LON SmartServer 2.0 Programming Tools to create freely programmable modules (FPMs) for your SmartServer 2.0.  FPMs are custom embedded C/C++ applications and drivers that you can use to customize the functionally of the SmartServer 2.0 to fit your specific needs.  You can also use the i.LON SmartServer 2.0 Programming Tools to translate the SmartServer 2.0 Web interface into different languages.

To provide full functionality, the i.LON SmartServer 2.0 Programming Tools and i.LON SmartServer 2.0 configuration software must be used with Microsoft Internet Explorer 7 or newer, or Mozilla Firefox 3.0 or newer.  If you are using the 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 LNS Server included with the i.LON LNS Server Editions is LNS Turbo Edition Release 3.25, which is the latest release as of October 2009.  The latest LNS and LonMaker service packs and updates at the time of the i.LON SmartServer 2.0 release are included on the i.LON SmartServer 2.0 DVD and are also available from www.echelon.com/downloads

2       Contents

1        Introduction. 1

2        Contents. 1

3        Release Identification. 2

4        Requirements. 2

5        Problems Fixed in Release 4.03. 3

 

3       Release Identification

This ReadMe document applies to the i.LON SmartServer 2.0 Programming Tools (Release 4.03).  To verify that you have this release on your computer, follow one of the following procedures:

·        For Windows 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 SmartServer 2.0 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.  The version number of i.LON SmartServer 2.0 Programming Tools is 4.03.123.

·        For Windows XP, open Add or Remove Programs in Windows Control Panel, and then click Echelon i.LON SmartServer 2.0 Programming Tools.  Click the Click Here for Support Information link.  The version number of i.LON SmartServer 2.0 Programming Tools is 4.03.123. 

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

The Echelon i.LON SmartServer 2.0 DVD includes a demo version of the i.LON SmartServer 2.0 Programming Tools.  You can use the demo version to write an unlimited number of FPMs.  To compile your FPMs and deploy them on your SmartServer 2.0, you must order an Echelon i.LON SmartServer 2.0 Programming Tools DVD (Echelon Model 72111‑439), which includes the full version of the i.LON SmartServer 2.0 Programming Tools.  To order the Echelon i.LON SmartServer Programming 2.0 Tools DVD, contact your Echelon sales representative.

4       Requirements

Requirements for the running the i.LON SmartServer 2.0 Programming Tools and the SmartServer Web pages are listed below:

·       Microsoft® Windows Vista® or Microsoft Windows® XP.  Echelon recommends that you install the latest service pack available from Microsoft for your version of Windows. 

·       Intel® Pentium® IV 1.5 GHz processor or faster, and meeting the minimum Windows requirements for the selected version of Windows.

·       1 GB RAM minimum. 

Note: Windows Vista testing for the i.LON SmartServer 2.0 products has been performed on computers that have a minimum of 2 GB of RAM.  For complete Windows Vista requirements, refer to www.microsoft.com/windows/windows‑vista/get/system‑requirements.aspx.  You can use Microsoft’s Vista Upgrade Advisor to determine upgrade requirements for a particular computer.  To download this tool, go to the Microsoft Web site at www.microsoft.com/windows/windows‑vista/get/upgrade‑advisor.aspx.

·       Up to 300 megabytes (MB) free hard‑disk space, plus the minimum Windows requirements for the selected version of Windows.

·       DVD‑ROM drive.

·       1024x768 or higher‑resolution display with at least 256 colors.

·       Mouse or compatible pointing device.

·       Microsoft Internet Explorer 7 or newer, or Mozilla Firefox 3.0 or newer.

·       Terminal emulator such as Windows HyperTerminal.  If you are using Windows Vista, you need to install a terminal emulation application on your computer (Windows HyperTerminal is not included with Windows Vista).  You can license Windows HyperTerminal from Hilgraeve; install PuTTY, which is included on the root directory of the i.LON SmartServer 2.0 DVD; or use any other terminal emulator.

·       RS-232 null modem cable.  You use this cable to physically connect the computer running the i.LON SmartServer 2.0 Programming Tools to the SmartServer 2.0 console port.  This enables you to use the SmartServer 2.0 console port to debug your FPMs during runtime..

5       Problems Fixed in Release 4.03

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

EPR

Description

50550

If you deploy multiple FPM drivers on a SmartServer that has data points with the same names, those data points are displayed in the SmartServer tree for the first FPM driver deployed, but not for any additional FPM drivers deployed thereafter. 

50759

Reloading an FPM application causes the SmartServer to fail if more than one FPM modules are deployed on the SmartServer.

51442

The rs232_read() function causes FPM driver to remain in an infinite loop until receive (Rx) data is received from the RS‑232 interface. 

53531

The GetDpPropertyAsPointStatus() function  returns an unsigned value instead of a signed value. 

53596

SmartServer FPMs that include signed quad SNVTs fail.

 

 

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