ISI Library ReadMe File
Release 3.02A, April 2009
Copyright
© 2005 – 2009 Echelon Corporation
All Rights Reserved
This document contains important information for the ISI library that is not included in the ISI library documentation.
For the latest information about updates to the ISI library and examples, see the ISI Web page at www.echelon.com/isi.
5 Repairing Software Installations
10.1 Polling ISI Network Variables
The following are minimum requirements:
The following are minimum requirements:
The ISI Programmer’s Guide describes how you can use Interoperable Self-Installation (ISI) to create networks of control devices that interoperate, without requiring the use of an installation tool. This guide also describes how to use the ISI Library to develop devices that can be used in both self-installed as well as managed networks.
The ISI Protocol Specification describes the ISI protocol used by the ISI library.
Both of these documents are available after installing the ISI library or Mini EVK, and are available online at www.echelon.com/isi.
This software product is installed using Microsoft Windows Installer technology. Some components of this product were also present in earlier installations of Echelon products that did not follow the Windows Installer installation rules. As a result, installing some older Echelon products after installing this product may revert some files to obsolete versions. Workaround: If you experience unexpected software behavior changes as a result of another software installation, you can repair this product installation through the following procedure:
The IsiPl3170.lib library, supporting ISI development with the Echelon Model 15330R-1000 PL 3170-E4T10 Smart Transceiver, was mistakenly shipped as an empty library in the 3.02 release, resulting in link errors when it was used. As this library has not changed since the 3.01 release, the 3.02A release just inserts the correct version of this library from ISI 3.01 with the rest of the contents of 3.02.
You can determine whether you have ISI 3.02A instead of ISI 3.02 by the following method:
This release adds support for the Echelon ShortStack 2.1 release and ISI-enabled Micro Servers.
This release adds support for the Echelon Model 15330R-1000 PL 3170-E4T10 Smart Transceiver. The PL 3170 Smart Transceiver provides most of the ISI library contents in ROM, leaving more room in EEPROM for application code. The ISI Programmer’s Guide and the ISI Protocol Specification have been updated to describe ISI device development with the PL 3170 Smart Transceiver.
The NodeBuilder Development Tool can be used to develop ISI applications for the PL 3120, 3150, or 3170 Smart Transceiver. Release 3.1 or newer of the NodeBuilder Development Tool is required to develop applications for the PL 3120 or 3150 Smart Transceiver. NodeBuilder 3.14 (NodeBuilder 3.1 with Service Pack 4) or newer is required to develop applications for the PL 3170 Smart Transceiver. NodeBuilder 3.1 Service Pack 4 is available for free download from www.echelon.com/downloads.
The Mini EVK Evaluation Kit can be used to develop ISI applications for the PL 3120 or 3150 Smart Transceiver. Any release of the Mini EVK can be used to develop applications for the PL 3120 or 3150 Smart Transceiver, though Release 1.02 or newer is recommended. A free update to Release 1.02 is available for Mini EVK Release 1.00 and 1.01 at www.echelon.com/downloads. Release 1.02 cannot be used to develop applications for the PL 3170 Smart Transceiver. Check www.echelon.com/mini for updated information on PL 3170 Smart Transceiver support for the Mini EVK.
The ISI 3 changes are described in the ISI Programmer’s Guide and the ISI Protocol Specification for Release 3. This section describes additional information about the changes in this release.
The ISI Packet Monitor Application is a new tool included with the ISI 3 Developer’s Kit. You can use this tool to monitor and analyze ISI messages. The ISI Packet Monitor application requires Echelon OpenLDV 2.1 or above, and the Microsoft .NET Framework 1.1 Redistributable. If you currently do not have .NET Framework version 1.1 installed, you can download it from www.microsoft.com/downloads. If you do not currently have OpenLDV 2.1 or newer, you can download it from www.echelon.com/openldv. (41808)
ISI 3 fixes a problem where replacement selectors were sometimes calculated incorrectly by the ISI 1 and 2 engines. (40512)
The ISI Library has the following known problems. Numbers in parentheses at the end of the descriptions are Echelon's internal problem tracking IDs.
By default, ISI connections use open groups (groups without a specified size) which are incompatible with polling. Workaround: Do not poll input NVs that are members of ISI connections. (48760)