FTXL Developer’s Kit ReadMe File
Release 1.0, January 2008

Copyright © 2008 Echelon Corporation
All Rights Reserved

1         Overview

This file contains important information for the Echelon FTXL Developer’s Kit that is not included in the FTXL Developer’s Kit documentation.

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      Requirements. 1

3.1       PC Hardware Requirements. 1

3.2       PC Software Requirements. 2

4      Documentation. 2

5      Repairing Software Installations. 2

6      Known Problems. 3

6.1       Example template projects fail to build in Release configuration. 3

 

3         Requirements

3.1      PC Hardware Requirements

The following are minimum requirements:

These requirements are derived from the Altera development software requirements, and should not be added to those requirements.

3.2      PC Software Requirements

The following are minimum requirements:

Before you can install the FTXL Developer’s Kit software, you must log on to your Windows system with a user ID that is a member of the Administrators group or have equivalent administrator privileges.

4         Documentation

The following documents are copied to the Echelon FTXL Developer’s Kit program folder when you install the FTXL Developer’s Kit software:  FTXL User’s Guide, FTXL Hardware Guide, Neuron C Programmer’s Guide, Neuron C Reference Guide, NodeBuilder Errors Guide, and the FTXL API online reference help.  These guides are the primary reference for all of the Developer’s Kit features.  After product release, you can always get the latest version of these documents at www.echelon.com/support/documentation.

5         Repairing Software Installations

The FTXL Developer’s Kit software 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 FTXL Developer’s Kit software may cause some files to revert to obsolete versions.

Workaround: If you experience software behavior changes as a result of another software installation, use the following procedure to repair the product installation:

  1. Open the Windows Control Panel.
  2. Double-click Add or Remove Programs.
  3. Click the program to be repaired in the program list.
  4. Click Click Here for Support Information.
  5. Click the Repair button.
  6. Repeat 3 – 5 for each program to be repaired in the Add or Remove Programs program list.

The programs that you may need to repair in the Add or Remove Programs program list include the following:

  1. Echelon FTXL Developer’s Kit
  2. Echelon NodeBuilder Resource Editor
  3. LonMark Resource Files 13.00

6         Known Problems

The FTXL Developer’s Kit has the following known problems.  Numbers in parentheses at the end of the descriptions are Echelon's internal problem tracking IDs.

6.1      Example template projects fail to build in Release configuration

The Example templates included with this product are set up to compile and build in the Debug configuration.  Projects derived from these templates will fail to compile in the Release configuration. (46770)

To create a project from one of the Example templates and modify it to support the Release configuration:

  1. Open the Properties window for the application project to the C/C++ Build page, Tool Settings tab.
  2. Select the Release configuration.
  3. Add the preprocessor definition GCC_NIOS as a defined symbol under the Nios II Compiler Preprocessor settings.
  4. Add the FTXL library, Ftxl100, to the Linker General settings.
  5. Specify the library path as “..” in the Library Path for the Linker General settings.
  6. Click OK.