ReadMe File
August 2009

1 Overview

This file contains important information about the patch 1 update to the Echelon FTXL Developer’s Kit 1.0. It describes the problem fixed, as well as how to install the patch files to update an FTXL Developer’s Kit 1.0 installation, including any existing projects.

For the latest information about updates to the FTXL Developer’s Kit product and examples that it contains, see the FTXL Web page at www.echelon.com/ftxl.

2 Contents

1 Overview.. 1

2 Contents. 1

3 Problem Fixed. 1

4 Contents of the Patch. 2

5 Installation Instructions. 2

6 Modifying Existing Projects. 3

3 Problem Fixed

This patch fixes a memory leak in the FTXL 1.0 LonTalk protocol stack. Each time an FTXL device receives an application message that was sent using the acknowledged, unacknowledged or unacknowledged but repeated service, the device will leak 416 bytes of memory. Over time, the stack may consume all available memory and crash.

Note that application messages sent using the request service do not result in a memory leak, as long as the application either sends a response by calling LonSendResponse or releases the message correlator by calling LonReleaseCorrelator.

4 Contents of the Patch

This zip-format patch includes the following files:

1. libFtxl101.a
Version 1.01 of the FTXL library. It replaces version 1.00 (libFtxl100.a)

2. FTXL_Simple_template.xml
An updated version of the template file used to create the “simple” example project.

3. FTXL_DynamicInterface_template.xml
An updated version of the template file used to create the “Dynamic Interface” example project

5 Installation Instructions

To install this patch, uncompress the zip file to get the three update files. They should be copied on the computer where you originally installed the FTXL Developer’s Kit 1.0 software, as follows:

1. Copy “libFtxl101.a” to <LonWorks>\FTXL\Core directory (typically c:\lonworks\FTXL\Core, but you can find it by searching for the libFtxl100.a file installed by the FTXL Developer’s Kit 1.0).

2. Delete or move your <LonWorks>\FTXL\Core\libFtxl100.a file in order to avoid using it in future projects.

3. Replace the “template.xml” file used to create the FTXL_Simple example:

a. Delete the “template.xml” file in the folder <Altera>\nios2eds\examples\software\FTXL_Simple, where <Altera> is your Altera installation folder (C:\altera\72, for example).

b. Copy “FTXL_Simple_template.xml” to the folder <Altera>\nios2eds\examples\software\FTXL_Simple.

c. Rename “FTXL_Simple_template.xml” in <Altera>\nios2eds\examples\software\FTXL_Simple to “template.xml”.

4. Replace the “template.xml” file used to create the FTXL_DynamicInterface example:

a. Delete the “template.xml” file in the folder <Altera>\nios2eds\examples\software\FTXL_DynamicInterface.

b. Copy “FTXL_DynamicInterface_template.xml” to the folder <Altera>\nios2eds\examples\software\FTXL_DynamicInterface.

c. Rename FTXL_DynamicInterface_template.xml in <Altera>\nios2eds\examples\software\FTXL_DynamicInterface to “template.xml”.

6 Modifying Existing Projects

If you have created a project that uses the libFtxl100.a library, you will need to copy libFtxl101.a into each project directory and update your project settings to use the updated libFtxl101.a library. If you are using a make file, edit the make file to include Ftxl101 instead of Ftxl100.

If you are using the Nios II IDE:

1. Right click on your project and select Properties.

2. In the properties window, select C/C++ Build.

3. On the tool settings tab, under Linker, select General.

4. In the libraries pane, select Edit, and rename the library Ftxl100 to Ftxl101 and click OK: