IzoT™ NodeBuilder®
Software ReadMe
Release
4.3 SR2, October 2014
Copyright
© 1998 – 2014 Echelon Corporation
All Rights Reserved
This document describes IzoT NodeBuilder Software Release 4.3 SR2. This file contains important information not included in the IzoT NodeBuilder User's Guide, Neuron® C documentation, or the IzoT NodeBuilder help files. Additional information and updates, including critical updates, may be available on the NodeBuilder product page at www.echelon.com/nodebuilder. See Echelon’s Technical Knowledge Base at www.echelon.com/support for answers to frequently asked questions.
5 Updating from IzoT Nodebuilder 4.3
6 Changes in IzoT NodeBuilder 4.3 SR1
7 Known Problems and Workarounds
7.1 Testing an IzoT Router from IzoT CT Fails
7.2 FT 5000 Examples do not Compile
7.3 Changes in Default ISI Domain
7.4 IzoT CT Browser Fails after Installation
7.5 FT Termination is required for an FT 6000 EVK Network
7.6 ShortStack FX Compatibility
7.7 Locating the Neuron C Example Project Sources
Hardware and software requirements for computers running the IzoT NodeBuilder tool are listed in the IzoT NodeBuilder User’s Guide.
This ReadMe document applies to the IzoT NodeBuilder 4.3 SR2 software. You can verify that you have the IzoT NodeBuilder 4.3 SR2 software by starting the NodeBuilder project manager, opening the Help menu, and then clicking About NodeBuilder. The About NodeBuilder dialog appears. This dialog displays the version number of your NodeBuilder software. For the IzoT NodeBuilder 4.3 SR2 release, the version number is 4.30.53, where 30 is the minor version and 53 is the build number of the software.
The following table summarizes the IzoT NodeBuilder software release history:
|
Name |
Number |
Date |
|
IzoT NodeBuilder 4.3 |
4.30.47 |
July 2014 |
|
IzoT NodeBuilder 4.3 SR1 |
4.30.52 |
September 2014 |
|
IzoT NodeBuilder 4.3 SR2 |
4.30.53 |
October 2014 |
To update an IzoT NodeBuilder 4.3 or IzoT NodeBuilder 4.3 SR1 installation to IzoT NodeBuilder 4.3 SR2, download and install IzoT NodeBuilder 4.3 SR2 on the same computer where you installed IzoT NodeBuilder 4.3. You do not have to uninstall the original NodeBuilder software— the SR2 installer will take care of the update. The installation will use your same NodeBuilder serial number, so you will not have to enter the serial number again.
If you are using the IzoT WireShark Plug-in, update your WireShark software to version 1.12 or newer. The version of the IzoT WireShark plug-in included with SR2 will not work with versions of WireShark prior to 1.12.
If you created any custom devices with Neuron firmware 21.03.07 included with the original NodeBuilder 4.3 software, or with Neuron firmware 21.03.09 included with the NodeBuilder 4.30 SR1 software, or if you have an FT 6000 EVBs shipped prior to October 2014 that are running Neuron firmware version 21.03.09 or earlier versions, update the firmware in your devices or EVBs to match the new Neuron firmware 21.03.10 firmware included with SR2. To update the firmware in your devices or EVBs, follow these steps:
1. If you do not already have a current version of NodeLoad or NodeUtil, download and install one of the utilities from www.echelon.com/downloads. If you are downloading NodeUtil, also download the latest NodeUtil Node Utility User’s Guide. NodeLoad is easier to use for just downloading images to device, whereas NodeUtil provides other useful tools for device developers, including tools for verifying Neuron firmware version numbers.
2. Download
the following boot loader file with NodeLoad or NodeUtil:
<LonWorks>\images\ver21\bla6000.ndl
Enter your LonWorks directory for <LonWorks>. By default , the
LonWorks directory is C:\Program Files (x86)\LonWorks or C:\LonWorks
depending on which Echelon software you previously installed on your computer.
To download with NodeLoad, enter NodeLoad /? to display help. To
download with NodeUtil, see the NodeUtil documentation for the Y
command.
3. Download
the following Neuron firmware image file with NodeLoad or NodeUtil:
<LonWorks>\images\ver21\b6050v4.ndl
4. If you are using NodeUtil, you can verify the firmware version number with the S command.
5. Rebuild any applications you created for your custom devices or FT 6000 EVBs using Neuron firmware version 21.03.10.
The following problems were fixed in IzoT NodeBuilder 4.3 SR2.
This section lists the major changes implemented in IzoT NodeBuilder 4.3 SR1.
· Power failure recovery has been improved when downloading an NDL file. (NDB-5409)
The following problems were fixed in IzoT NodeBuilder 4.3 SR1:
· Network variables bound using the alias table (such as can occur with fan out connections) were not always updated properly. (NRNFW-509)
· Memory was sometimes corrupted when loading large applications. (NRNFW-500)
· Memory allocated for sending a message was sometimes not freed if application_restart() was called while sending a message. (NRNFW-498)
· If an application contained eeprom far data and all of it was declared as unitialized (uninit without any explicit initializers), the exporter sometimes crashed when creating the NEI or NDL files. Variables declared with the uninit eeprom far attributes variables and not explicitly initialized are now initialized to zero in the NMF file. (NDB-5466)
· The NME file generated by the NodeBuilder software for programming serial EEPROM memory parts for a Series 5000 Smart Transceiver or Neuron Chip was sometimes corrupted, preventing the device from operating correctly. (NDB-5462)
· Open Media Authentication (OMA) could be enabled for targets with version of Neuron firmware prior to version 14 that do not support OMA. (NDB-5462)
· Linker errors were reported by the retrieve_stat() function for the _stats_unlock and _stats_lock symbols. (NDB-5460)
· An incorrect offset out-of-range error was sometimes reported when compiling an application. (NDB-5423)
This section lists known problems and their workarounds for this release. Numbers in parentheses at the end of the problem/workaround descriptions are Echelon's internal problem tracking IDs.
If you use the Test command from the IzoT CT Manage window to test an IzoT Router, you may see the following error message: "OpenLNS CT was able to communicate with the device using Neuron ID addressing, but could not communicate with the device using subnet/node addressing. However, through the use of Neuron ID addressed messages, OpenLNS CT has verified that the device contains the expected subnet/node address." Workaround: Add an IP route to the IzoT Router using the following steps:
1. Determine the domain ID of the IzoT Router by clicking Add-Ins -> OpenLNS CT ‑> Network Properties, then select LonWorks Networks -> Network Properties, and then click the Domain tab.
2. Determine the subnet and node ID assigned to the router by right-clicking the IzoT Router shape in the IzoT CT drawing, and then clicking Properties in the shortcut menu. Click the Identifiers tab and note the Subnet/Node ID of the Near Side.
3. Use the LonTalkIpAddressCalculator application to translate domain ID, subnet, and node ID assigned to the near side of your IzoT Router into a LonTalk/IP address using the following steps:
a. Click the Windows Start menu, and then type LonTalkIpAddressCalculator and press Enter to start the LonTalkIpAddressCalculator application.
b. Select LonTalk -> IP Address to translate a LonTalk address to a LonTalk/IP address.
c. Select Subnet/Node to translate a LonTalk domain/subnet/node address to a LonTalk/IP address.
d. Enter the domain ID (in hexadecimal) and the subnet and node IDs (in decimal).
e. Click the Translate button.
f. The derived LonTalk/IP address will be shown in the IP Address text box
g. Close the LonTalkIpAddressCalculator application.
4. Find the host IP address of your IzoT Router as described in step 6 of the FT 6000 EVK Quick Start Guide.
5. To add an IP route for your IzoT Router, open a Windows command prompt and enter the following command:
route –p add <LonTalk/IP address> mask 255.255.255.255 <IzoT Router host IP address>
(IZTR-82)
The NcMultiSensorExample, NcSimpleIsiExample, and NcSimpleExample examples for the FT 5000 Smart Transceiver fail to compile—the examples for the FT 6000 Smart Transceivers compile correctly. Workaround: No workaround is required if you are building the FT 6000 examples for an FT 6000 Smart Transceiver. To rebuild the FT 5000 examples for an FT 5000 Smart Transceiver, replace all include directive backslashes with a single backslash. (NDB-5384)
The LonTalk/IP default domain for ISI is 0x49.53.00 ("IS\0"). This is a change from the original ISI default domain of 0x49.53.49 ("ISI"). Workaround: To use the LonTalk/IP default ISI domain, no workaround is required. To create ISI devices operating on the original ISI default domain of 0x49.53.49 (“ISI”), assign the 0x49.53.49 primary domain ID by overriding the IsiGetPrimaryDid() callback function.
If DHCP is enabled and an IP address is assigned by a DHCP server, the Neuron firmware will use the IP address assigned by the DHCP server, and will not use the default ISI domain. Workaround: To use the default ISI domain, use the #pragma dhcp disabled directive to disable the DHCP client for your devices when using ISI. (NDB-5337)
The IzoT CT Browser sometimes displays a system error when started after installation. Workaround: Restart Windows to complete the installation. (LMWIN-1930)
An FT terminator is required for the FT 6000 EVK network. The IzoT Router includes a built in terminator for the FT network that is enabled by default. Workaround: Do not use a standalone FT network terminator if you enable the IzoT Router built-in terminator. (IZTR-77)
The ShortStack FX EVK is not compatible with Series 6000 processors. Workaround: Use a Series 5000 processor with the ShortStack FX Micro Server. (SS-808)
After restoring the IzoT NcMultiSensor example network, you must specify the NodeBuilder project. When prompted whether to create a new or open an existing project, select Open an Existing Project and browse to the NcExamples.NbPrj project located in your local C:\Users\Public\Documents\LonWorks\OpenLnsCt\Source\FT 6000 EVB folder. (NDB-5374)
Echelon, LON, the Echelon logo, LonWorks, NodeBuilder, LonTalk, LonPoint, Neuron, 3120, 3150, LNS, i.LON, ShortStack, Pyxos, LonMaker, IzoT, LonLink, LonResponse, LonSupport, OpenLDV, LonScanner, and LonBridge are trademarks of Echelon Corporation that may be registered in the United States and other countries. For a complete list of registered trademarks see the Echelon Web site at www.echelon.com. All rights reserved.
Other trademarks belong to their respective holders.