OpenLDV™ ReadMe File
Release 3.3C, November 2006
Copyright
© 2003 – 2006 Echelon Corporation
All Rights Reserved
The OpenLDV driver provides LONWORKS® tools and applications with a unified Windows software interface for sending and receiving LonTalk® messages through Echelon's family of network interfaces including:
· i.LON® 10 Ethernet Adapter;
· i.LON 100 Internet Server;
· PCLTA-20 and PCLTA-21 PCI Network Interfaces;
· PCC-10 PC Card Network Interface;
· SLTA-10 Serial Network Interface (with a separate driver); and
· U10 and U20 USB Network Interfaces.
The OpenLDV driver also works with Echelon’s legacy network interfaces such as the PCLTA, PCLTA-10, and SLTA/2.
When used in conjunction with the i.LON 10 and i.LON 100, the OpenLDV driver provides outstanding security including RC4 encryption, MD5 authentication, and protection from replay attacks, as well as transparent, fault-tolerant session recovery when the IP connection or power to the i.LON network interface is interrupted. Support is provided for uplink connections, wherein a remote network initiates a call, either dial-up or broadband, into a service center. Uplink connections are commonly used in large remote access systems in which hundreds or thousands of sites report back to a single service center.
The OpenLDV installer installs all required drivers needed to access the PCLTA-20, PCLTA-21, PCC-10, i.LON 10, i.LON 100, U10, and U20 network interfaces. To use an SLTA-10 or other legacy network interface, install the appropriate network interface driver in addition to the OpenLDV driver.
For Windows developers, the development of network tools and applications for Windows will be simpler and less time-consuming using Echelon's LNS® Network Operating System. In addition, network tools and applications that use LNS will have higher performance levels than those that use OpenLDV. Contact Echelon Sales at www.echelon.com/sales if you would like assistance in determining whether you should develop your network tools with LNS plus the OpenLDV driver or just with the OpenLDV driver.
Network tool installer programs normally incorporate the OpenLDV installer; however, if the network tool does not include the OpenLDV installer, the end-user can download and install the OpenLDV driver separately.
Network tool developers use the OpenLDV Developer's Kit to build support for the OpenLDV driver into their network tools. The OpenLDV Developer’s Kit may be downloaded from www.echelon.com/downloads.
The OpenLDV driver is licensed royalty-free for use exclusively with Echelon's family of network interface products.
This document contains important information about the OpenLDV driver. Numbers in parentheses at the end of the fix descriptions in the Changes sections are Echelon's internal problem tracking IDs. Additional information and updates, including critical updates, may be available in Echelon’s Downloads web page at www.echelon.com/downloads.
5 Repairing OpenLDV Installations
9.1 Certified PCLTA-20, PCLTA-21, and PCC-10 Drivers
10 Known Problems and Workarounds
10.1 Interaction with LNS 3, Service Pack 8, Update 1 (36682)
10.2 Interaction with LNS 3.08 (36258)
10.3 Some Installations Require Reboot (32205, 32177)
10.4 LonWorks Interfaces Missing from Control Panel (41439)
You must have Administrative Privileges in order to install this software.
If you are using the U10 or U20 USB Network Interface, install the OpenLDV driver before plugging the network interface into a USB port.
Double-click the OpenLDV installer (OpenLDV330C.exe) to begin the OpenLDV installation. OpenLDV330C.exe is available on CD-ROM or from www.echelon.com/downloads. The Welcome to the InstallShield Wizard for Echelon OpenLDV 3.3 window appears. Click Next to continue. This opens the License Agreement window.
Read the terms of the license agreement and, if you agree to the terms, click I Accept to continue. This opens the Installing Echelon OpenLDV 3.3 window. The installer completes the OpenLDV driver installation.
Normally, you are not required to reboot your computer after installing the OpenLDV driver and no completion dialog appears when the installation completes successfully. If the OpenLDV driver is not installed successfully, a dialog appears to notify you of the problem.
If you are using the i.LON 10 Ethernet Adapter or the i.LON 100 Internet Server, you may need to modify the configuration (such as the IP address) for those devices by opening LonWorks Interfaces in the Windows Control Panel. Consult the LonWorks Interfaces online help for more information. Advanced users may wish to create specialized connection profiles using the xDriver Profile Editor. For more information on the xDriver Profile Editor, see Chapter 2 of the OpenLDV Programmer’s Guide, xDriver Supplement.
To develop OpenLDV applications, install the OpenLDV Developer's Kit available from www.echelon.com/downloads.
The OpenLDV driver 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 the OpenLDV driver may revert some files to obsolete versions.
Workaround: If you experience software behavior changes as a result of another software installation, you can repair this product installation through the following procedure:
The PCC10L7 image has been added back to the available images for the PCC and PCLTA cards. This image is not used by LNS applications, but some legacy applications require it. (42584)
In some cases, OpenLDV 3.3 installation can cause PCLTA-10, PCLTA-20 and PCC-10 card device driver entries to disappear after reboot. (42583)
The PCLTA-20 driver does not recognize the new RoHS-compliant PCLTA-20/SMX network interface card. (42396)
This section lists the changes included in OpenLDV 3.3.
The Echelon network interface cards formerly supported by a separate driver installation have been incorporated into the OpenLDV installation. The driver for these cards has been certified by Microsoft for compatibility with the Windows 2000, Windows XP, and Windows 2003 operating systems. These interfaces are still defined and managed through the LonWorks® Plug n’ Play item in the Windows Control Panel.
The following problems have been fixed in OpenLDV 3.3:
The following are known OpenLDV problems and their workarounds. The numbers in parentheses at the end of the problem descriptions are Echelon's internal problem tracking IDs.
Echelon released a patch update to the LNS product in March 2003 named “LNS 3, Service Pack 8, Update 1” (LNS3SP8U1) that is not forward compatible with OpenLDV 3.3 and later releases.
This patch will cause problems for any computer with OpenLDV 3.3 installed, if it is installed after OpenLDV 3.3. It will overwrite the newer OpenLDV components, causing them to revert back to older versions. This will cause all functionality added in OpenLDV 3.3—such as USB network interface support—to be lost, and may cause programs that use new OpenLDV 3.3 API calls (see ldv32.h in the OpenLDV 3.3 Developer’s Kit) to completely fail to run.
The LNS3SP8U1 patch is included in some versions of the Echelon i.LON 10, i.LON 100 v1.1, and LonMaker® 3.13 product installations, and may also be embedded in installations from other companies that license and redistribute the LNS runtime. Although it is being phased out of product software, it may be encountered for some time to come. The OpenLDV 3.3 installation can be used as a replacement for LNS3SP8U1, as it corrects all of the problems corrected by that update, plus provides new USB functionality.
This problem will only manifest itself if LNS 3 is installed on the computer. If LNS Turbo or a later version is installed, this problem will not occur.
Workaround: If you suspect that you have encountered this problem, go through the procedure described in Repairing OpenLDV Installations. The OpenLDV 3.3 installation will then repair itself and function correctly. If this is not the problem, there is no harm in running the repair operation.
After installing OpenLDV 3.3 over LNS 3.08, uninstalling OpenLDV 3.3 will cause LNS 3.08 to become inoperable. OpenLDV 3.3 provides a partial upgrade to LNS 3.08 that may not be completely reversed by uninstalling. If your product installation embeds the OpenLDV 3.3 installation, do not attempt to uninstall it as part of your uninstallation process. Workaround: If LNS 3.08 has been inadvertently broken by uninstalling OpenLDV 3.3, reinstall OpenLDV 3.3.
On Windows 2000, the OpenLDV installation will require a reboot before LonWorks Interfaces appears in the Windows Control Panel or before the OpenLDV driver is accessible to all users.
On all Windows versions later than Windows 2000, if the OpenLDV driver is installed by one user, a reboot is necessary before logging onto another user and using OpenLDV. Logging off one user and onto another is not sufficient.
The installation does not always inform the user when a reboot is required.
Workaround: If some OpenLDV functionality is not working after installation, but before reboot, try again after rebooting your computer.
On a small number of Windows 2000 installations, LonWorks Interfaces may not appear in the Windows Control Panel, even after a reboot. This has been seen on a small number of computers that have been upgraded from earlier versions of Windows to Windows 2000. Workaround: On Windows 2000, follow these steps:
Since the OpenLDV driver is designed to be incorporated into third-party software products, the documentation required to use the OpenLDV driver is included with the third-party software product that includes the OpenLDV driver.
If you need to create Windows applications using the OpenLDV driver, download the OpenLDV Developer's Kit available from www.echelon.com/downloads.
The license that governs the use of the OpenLDV driver is agreed to before downloading the OpenLDV driver from the Echelon Web site, or is included as part of the license displayed by any software incorporating the OpenLDV driver. The license is also available from the LonWorks OpenLDV directory in license_OpenLDV.htm.
The company that writes an application that uses the OpenLDV driver is required to provide technical support for their product. For technical support purely in relation to the OpenLDV driver apart from use of the OpenLDV driver by a client application, contact Echelon Support as described at www.echelon.com/support.
Echelon welcomes your feedback on the OpenLDV driver. Please send non-technical support-related comments and feedback on the OpenLDV driver to OpenLDV@echelon.com.