ShortStack® FX Developer’s Kit ReadMe
Release 4.0, October 2009
Copyright
© 2001 – 2009 Echelon Corporation
All Rights Reserved
This document contains important information for the Echelon® ShortStack FX Developer’s Kit release that is not included in the ShortStack FX documentation.
For the latest information about updates to the ShortStack Developer’s Kit product and example ports, see the ShortStack Web page at www.echelon.com/shortstack. Example ports include ports for an Atmel® ARM7 microprocessor and an Altera Nios® II embedded processor.
5 Repairing Software Installations
6.1 Device-specific Configuration Properties
6.2 ISI API Files Always Included
6.3 Uninstallation of Other Products
6.4 Uninstallation of ShortStack Developer’s Kit
The following are minimum requirements:
The following are minimum requirements:
The following documents are copied to the Echelon ShortStack FX Developer’s Kit program folder when you install the ShortStack software: ShortStack User’s Guide, Neuron® C Programmer’s Guide, Neuron C Reference Guide, Neuron Tools Errors Guide, and the ShortStack LonTalk Compact API online documentation. These guides are the primary reference for all of the ShortStack Developer’s Kit features. You can get the latest versions of these documents at www.echelon.com/shortstack.
The programs that you may need to repair in the Add or Remove Programs program list include the following:
This ShortStack release has the following known problems. Numbers in parentheses at the end of the descriptions are Echelon's internal problem tracking IDs.
A device-specific configuration property can be declared with the device_specific attribute and without the const attribute in a Neuron C model file. This construct works correctly with the ShortStack FX LonTalk Interface Developer, and allows a device-specific configuration property to be modified by either a ShortStack application on the same device, or by a network tool. This construct is also works correctly with the NodeBuilder FX Development Tool and the Mini FX Evaluation Kit, but is not compatible with the NodeBuilder 3.1 or Mini EVK 1.02 Neuron C Compiler and Neuron C Code Wizard—these tools require device-specific configuration properties to be declared with the const attribute. Workaround: If you are using the NodeBuilder 3.1 or Mini EVK tool, use conditional compilation to share a CP declaration in a single file that is used as both a Neuron C model file and a NodeBuilder 3.1 or Mini EVK 1.01 Neuron C application. If you use the NodeBuilder 3.1 Code Wizard to generate a Neuron C model file, specify the device-specific CP as both constant and device-specific in the code wizard, then hand edit the Neuron C file generated by the code wizard to remove the const attribute, or to add conditional compilation that removes the const attribute for a Neuron C model file. The NodeBuilder FX and Mini FX tools do not require this workaround.
The ISI files of the API are copied by the LonTalk Interface Developer to the project directory even if ISI functions are not used. Workaround: If you are not using the ISI functions and need to reclaim some disk space, you can manually remove the ISI files from the project directory. (48115)
The ShortStack FX Developer’s Kit shares some components with the NodeBuilder FX and Mini FX tools. If one of those tools is installed on the same computer as the ShortStack tool, and the other tool is uninstalled, it may cause the LonTalk Interface Developer included with the ShortStack tool to fail with a “System error in Device Resource Files access [NCC#388]” error. The cause of the failure is the removal of LonMark® resource files without refreshing the resource catalog. This error can also be caused by other installations which install and remove resource files. Workaround: If your computer is exhibiting this error, shut down the LonTalk Interface Developer, and then open and close the NodeBuilder Resource Editor included with the ShortStack tool. This will cause the resource catalog to be refreshed, and the resource file access error will be eliminated. (54383)
The ShortStack FX Developer’s Kit shares some components with the LonWorks Interface Developer tools in the FTXL Developer’s Kit 1.0 and the i.LON SmartServer (1.0 and 2.0) products. Because of the dependencies between these components, installing and then uninstalling ShortStack FX Developer’s Kit on the same PC as one of these other tools may cause that other tool to stop functioning. Workaround: Re-install ShortStack FX on the PC and leave it there. (54777, 54789)