Echelon i.LON® SmartServer Programming Tools ReadMe
Release 4.02
(4.02.055), November 2008
Copyright © 1998 –
2008 Echelon® Corporation
All Rights Reserved
This document describes i.LON SmartServer Programming Tools Release 4.02 (4.02.055). This release (or newer) may be included with i.LON SmartServer Programming Tool DVDs manufactured after October 2008 and you can apply i.LON SmartServer Service Pack 2A to update Release 4 (4.00.136) and Release 4.01 (4.01.012) i.LON SmartServer Programming Tool installations to Release 4.02 (4.02.055). A demo version of the i.LON SmartServer Programming Tools is included with all i.LON SmartServers. See Release Identification to determine what release you have, and Problems Fixed in Release 4.02 for details on what is fixed in this release.
This document contains important information not included in the i.LON SmartServer Programming Tools documentation. Additional information and updates for the i.LON SmartServer 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 SmartServer Programming Tools DVD, and may not be loaded in your SmartServer hardware. This ReadMe document is included with i.LON SmartServer Programming Tools Service Release 4.02. See Echelon’s Knowledge Base at www.echelon.com/support for answers to frequently asked questions.
You can use the i.LON SmartServer Programming Tools to create freely programmable modules (FPMs) for your SmartServer. FPMs are custom embedded C/C++ applications and drivers that you can use to customize the functionally of the SmartServer to fit your specific needs. You can also use the i.LON SmartServer Programming Tools to translate the SmartServer Web interface into a number of different languages.
To provide full functionality, the i.LON SmartServer Programming Tools and i.LON SmartServer configuration software must be used with Microsoft Internet Explorer 7 or newer. Microsoft Internet Explorer 7 (IE7) is included on the SmartServer DVD and is also available from www.microsoft.com. If you are using the SmartServer 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 i.LON SmartServer release are included on the i.LON SmartServer DVD and are also available from www.echelon.com/downloads.
5 i.LON SmartServer Programming Tools Contents
6.3 i.LON SmartServer Requirements
7 Problems Fixed in Release 4.02
8 Limitations and Known Problems
8.1 Missing Data Points when Deploying Multiple FPM Drivers
8.2 SmartServer Reboots when Re-loading Multiple FPMs
This ReadMe document applies to the i.LON SmartServer Programming Tools Release 4.02 (SR2A and SP2A). 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 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 Release 4 Service Release 2A and Service Pack 2A is 4.02.055, the version number of Release 4 Service Release 1 was 4.01.012, and the original SmartServer release was version 4.00.136.
· For Windows XP, open Add or Remove Programs in Windows Control Panel, and then click Echelon i.LON SmartServer Programming Tools. Click the Click Here for Support Information link. The version number of Release 4 Service Release 2A and Service Pack 2A is 4.02.055, the version number of Release 4 Service Release 1 was 4.01.012, and the original SmartServer release was version 4.00.136.
Release 4.02 fixes the problems listed in Problems Fixed in Release 4.02. The following table summarizes the i.LON SmartServer release history:
|
Name |
Number |
Date |
|
i.LON SmartServer |
4.00.136 |
January 2008 |
|
i.LON SmartServer SR1 |
4.01.012 |
March 2008 |
|
i.LON SmartServer SR2A and SP2A |
4.02.055 |
November 2008 |
The i.LON SmartServer DVD includes a demo version of the i.LON SmartServer 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, you must order an i.LON SmartServer Programming Tools DVD (Echelon Model 72111-409), which includes the full version of the i.LON SmartServer Programming Tools. To order the i.LON SmartServer Programming Tools DVD, contact your Echelon sales representative.
You can install i.LON SmartServer Programming Tools Service Release 2A (Release 4.02) or you can upgrade i.LON SmartServer Programming Tools Release 4 or Release 4.01 to Release 4.02 by installing i.LON SmartServer Programming Tools Service Release 2A or Service Pack 2A. Service Pack 2A is available as a free download at www.echelon.com/ilon. To install Service Release 2A or upgrade an i.LON SmartServer Programming Tools Release 4 or Release 4.01 installation to Release 4.02, follow these steps:
1. If you are installing from the Echelon i.LON SmartServer Programming Tools SR2A DVD, insert the DVD into your DVD drive. If your computer does not have a DVD drive, insert the Echelon i.LON SmartServer Programming Tools SR2A DVD on a network accessible computer that has a DVD drive and copy the files on the DVD to shared network drive. If the i.LON SmartServer SR2A setup application does not launch immediately, open the setup.exe file on the root directory of the Echelon i.LON SmartServer SR2A DVD. The i.LON SmartServer SR2 setup application main menu appears.
2. To install i.LON SmartServer Service Pack 2A, download the service pack from www.echelon.com/ilon and store the service pack file in a local folder on your computer. Open the service pack file and then click the Unzip button in the next dialog. The i.LON SmartServer SP2A setup application main menu appears.
3. Click Install Products. The Install Products dialog appears.
4. Click Echelon i.LON SmartServer Programming Tools SR2. The Echelon i.LON SmartServer Programming Tools SR2 installer appears.
5. Follow the steps of the installation wizard. The installation will automatically upgrade the existing Echelon i.LON SmartServer Programming Tools Release 4 or Release 4.01 installation on your computer to Echelon i.LON SmartServer Programming Tools Service Release 2A (Release 4.02).
6. Modules built with Release 4 or Release 4.01 will run on Release 4.02 SmartServers, but you should rebuild and reload any FPMs that you built with Release 4.02 to take advantage of all the problem fixes.
Installing the demo or full version of the i.LON SmartServer Programming Tools adds the following programs to your computer:
· i.LON FPM Development Tool—a pre-configured Eclipse Development Kit that includes FPM template files, the FPM library, a tool for creating the C structures of user-defined network variable types (UNVTs), a C++ compiler, and a CYGWIN environment. You must have the full version of the i.LON SmartServer Programming Tools to compile and upload FPMs to your SmartServer.
· i.LON SmartServer LonWorks Interface Developer Tool—a command line interface that converts a Neuron C model file (.nc extension) to an FPM device interface (XIF) file. You must create a XIF file for your FPM in order to deploy it on your SmartServer. See Chapter 4 of the i.LON SmartServer Programming Tools User’s Guide for more information on creating XIF files with this tool.
· i.LON License Generator—a tool for creating licenses that help protect your FPM application from piracy or unauthorized use. The i.LON License Generator includes the following three components:
1. The main executable (iLONLicenseGen.exe) that provides a user interface for entering the values used to generate an FPM license.
2. A sample license generator configuration file (an XML file named iLONLicenseGenValuesSample.xml) that demonstrates the structure of the i.LON License Generator user interface and provides sample pre‑defined values.
3. A sample security DLL file (LicenseSecurityHMACMD5.dll) that takes the values entered in the i.LON License Generator user interface and creates an FPM license.
See Chapter 7 of the i.LON SmartServer Programming Tools User’s Guide for more information on creating FPM application licenses.
The following are minimum requirements for the computer running the i.LON SmartServer Programming Tools and the SmartServer Web pages:
· Pentium IV 1,5 GHz or faster
· 1 GB RAM minimum
· 500 MB free hard disk space
· DVD-ROM drive
· Super VGA (1024 × 768) or higher-resolution display with 256 colors
· Mouse or compatible pointing device
· RS-232 null modem cable. You use this cable to physically connect the computer running the i.LON SmartServer Programming Tools to the SmartServer console port. This enables you to use the SmartServer console port to debug your FPMs during runtime.
The following are minimum software requirements for computers running the i.LON SmartServer Programming Tools and the SmartServer Web pages:
· Microsoft Windows Vista or Windows XP. Install the latest service pack available from Microsoft for your version of Windows.
· Minimum screen resolution of 1024x768 with large or small fonts; or 800x600 with small fonts only.
· Microsoft Internet Explorer 6 or higher. The SmartServer Web pages support Internet Explorer 6; however, there may be a significant delay when loading the SmartServer Web pages if the navigation pane contains more than 2,000 entries. You can install Internet Explorer 7 from the i.LON SmartServer Programming Tools DVD to optimize the performance of the SmartServer Web pages.
· Terminal emulator such as Windows HyperTerminal. If you are using Windows Vista, you must install a terminal emulation application on your computer since 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 DVD and the i.LON SmartServer Programming Tools DVD; or download another free terminal emulator to your computer.
You can run FPMs on any SmartServer hardware. You cannot run an FPM on i.LON e3 Server, or earlier, hardware. To run an FPM on your SmartServer, your SmartServer must have an i.LON SmartServer Programmability Activation Key installed on it. If you do not have a SmartServer Model 7210xR-409 or 7210xR‑410, on which the i.LON SmartServer Programmability Activation Key is pre-installed, you can order an i.LON SmartServer Programmability Activation Key (Echelon Model 72161) from www.echelon.com/ilon/activate. Manufacturers may require a separate activation key to run their FPMs.
The following table summarizes problems fixed in i.LON SmartServer Programming Tools Release 4.02. The EPR column lists Echelon internal problem tracking numbers.
|
EPR |
Description |
|
45530 |
You cannot create a new FPM project with the i.LON SmartServer Programming Tools until you copy your user resource files to the SmartServer flash disk and then reboot the SmartServer. |
|
48617 |
The Initialize() function is not called if more data points are declared in the FPM than are defined in its associated user-defined function profile. |
|
48382 |
Building an FPM on a computer running Windows Vista may generate “bash.exe: warning: could not find /tmp, please create!” errors. |
|
49907 |
If you copy your user resource files to the SmartServer flash disk but then do not reboot the SmartServer, you cannot instantiate and run an FPM using a dynamic functional block. |
|
50191 |
If you create multiple instances of an FPM on the SmartServer, the first instance will stop running and will not run again until you reboot the SmartServer. |
|
50232 |
Generating include files will fail if cpp-defined types are used. |
|
50364 |
The FPM API does not provide a method for getting the current RS‑232 interface settings. |
|
49194 |
An FPM does not run if it does not have any data points declared in it. |
|
49265 |
Loading an FPM that uses the rs485_ioctl() method generates errors. |
|
49227 |
The FPM API does not provide raw_to_ascii() and ascii_to_raw() functions to support changeable types. |
|
49554 |
The SmartServer has a memory leak if there are many FPMs instantiated on it. |
|
50224 |
The Changed() method cannot evaluate whether data point properties have been updated. |
This section describes known limitations and problems for i.LON SmartServer Programming Tools Release 4.02. Numbers in parentheses at the end of the descriptions are Echelon's internal problem tracking IDs.
If you deploy multiple FPM drivers on the SmartServer that have 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. (50550)
If you switch the FPM being reloaded on the SmartServer with the i.LON SmartServer Programming Tool, the SmartServer may stop responding and then reboot. For example, you can successfully reload FPM A multiple times. However, if you reload FPM B, a failure and reboot may occur. After the reboot, you can successfully reload FPM B without any subsequent failures/reboots, but if you try to re-load FPM A, a failure or reboot may occur again.
This section describes the changes made to the i.LON SmartServer Programming Tools User’s Guide for Service Release 2A.
· Changed title from i.LON SmartServer Freely Programmable Modules User's Guide to i.LON SmartServer Programming Tools User’s Guide.
· Added new Checking for Data Point Property Updates section in Chapter 5 that describes how to call the NotifyOnAllUpdates() method in the constructor of your FPM so that the Changed() method checks whether data point properties have been updated, including value, status, time of last update, and priority.
· Updated code samples for using FPM driver methods in Chapter 5 and Appendix A.
· Updated Debugging FPMs section in Chapter 5 that describes new procedures for using System Mode debugging with WindRiver Workbench.
· Added new Deploying FPM Drivers section in Chapter 6 that describes how FPM drivers are displayed in the SmartServer Web interface.
· Updated Creating Custom FPM Configuration Web Pages section in Chapter 6 describing the NLS Text object, which is automatically added to custom FPM Web pages created with the i.LON SmartServer Programming Tool.
· Added new NotifyOnAllUpdates() section in Appendix A that describes the NotifyOnAllUpdates() method, which you can use to modify the Changed() method so that it checks whether any data point property has been updated.
· Added new RS-232 and RS-485 methods documented in Appendix A.
Echelon, LON, LonWorks, i.LON, LNS, and LonMaker are registered trademarks of Echelon Corporation in the U.S. and other countries.