Series 5000 Tools Update 1 ReadMe
May 2010
Copyright
© 2010 Echelon Corporation
All Rights Reserved
If you are using the Echelon series 5000 chips in production devices, and plan to use the device NME file for programming external EEPROM chips, you should apply this update to your development tools. Affected tools include:
1. NodeBuilder FX Development Tool – versions through Service Release 1 (4.01)
2. Mini FX Evaluation Kit – versions through Service Release 1 (4.01)
3. ShortStack FX Developer’s Kit – versions through FX (4.00)
The NodeBuilder/Mini Update allows the exported NME files to properly set the “Run While Unconfigured” attribute in the runtime code image. This attribute is used by many application images that implement self-configuration, including Interoperable Self-Installation (ISI), and also by the ShortStack MicroServer images.
The ShortStack Update includes updated versions of the two NME file ShortStack MicroServer images for the series 5000 chips.
You should first determine the version number of your NodeBuilder or Mini product. This can be determined by looking at the About box for either product, accessible from the Help menu item on the main product menu.
The NodeBuilder version number should be 4.01.07. If it is 4.00.32, you should contact Echelon customer support to get a free upgrade to 4.01 (also known as NodeBuilder FX, SR1) before applying this update. If it is less than 4.00, this update may not be applied, as Echelon “FX” level development tools are required in order to work with series 5000 chips. If the version number is higher than 4.01.07, this update should not be applied either, as it will be incorporated in later versions of the product.
After confirming that you have the correct version of the product to apply the update, you should determine the location of your LonWorks directory. This directory is used as a central location for installing all Echelon LonWorks software. Depending on when you first installed Echelon LonWorks software, this directory would default to either C:\LonWorks or C:\Program Files\LonWorks, but could also be set to another value by the user. If NodeBuilder or Mini is installed, you will see sub-directories under the LonWorks directory entitled NodeBuilder and MiniKit, respectively. You can also find the location of the LonWorks directory in the Windows Registry at HKEY_LOCAL_MACHINE\Software\LonWorks\LonWorks Path.
After finding the LonWorks directory, navigate to the bin directory one level below it. In that directory, you will find a file named LonNex32.dll. It should display a file version of 5.1.7.0. Copy it to a safe place, then replace it with the copy of this file found in the Series5000ToolsUpdate1.zip file – the file version in the bin directory should now be 5.1.8.0.
You are now ready to generate NME images with your series 5000 development tool. To avoid confusion, be sure to delete any NME images that you generated before the update was applied.
You should first determine the version number of your ShortStack product. This can be determined by looking at the About box for either product, accessible from the main product menu.
After confirming that you have the correct version of the product to apply the update, you should determine the location of your LonWorks directory. This directory is used as a central location for installing all Echelon LonWorks software. Depending on when you first installed Echelon LonWorks software, this directory would default to either C:\LonWorks or C:\Program Files\LonWorks, but could also be set to another value by the user. If ShortStack is installed, you will see a sub-directory under the LonWorks directory entitled ShortStack. You can also find the location of the LonWorks directory in the Windows Registry at HKEY_LOCAL_MACHINE\Software\LonWorks\LonWorks Path.
After finding the LonWorks directory, navigate to the ShortStack\MicroServers directory two levels below it. In that directory, you will find two files named SS400_FT5000ISI_ES_SYS20000kHz.nme and SS400_FT5000ISI_SYS20000kHz.nme. Copy these to a safe place, and replace them with the files of the same name found in the Series5000ToolsUpdate1.zip file. These new files should be used when programming external EEPROM for ShortStack MicroServers for the series 5000 chips.