NodeLoad Utility User’s Guide @ ® ® ECHELON Corporation 078-0286-01F
Echelon, LON, LONWORKS, i.LON, LonTalk, LNS, Neuron, 3120, 3150, and the Echelon logo are trademarks of Echelon Corporation registered in the United States and other countries. OpenLDV and 3170 are trademarks of Echelon Corporation. Other brand and product names are trademarks or registered trademarks of their respective holders.
Contents The NodeLoad Utility Using the NodeLoad Utility Getting Started Command Line Options Example NodeLoad Commands Result Strings and Codes Passing Result Failing Result Error Code Reference Contents 1 2 2 2 5 5 6 6 6 iii
The NodeLoad Utility The NodeLoad Utility lets you download transceiver parameters or application software into Echelon’s Free Topology Smart Transceivers (FT 3120®, FT 3150®, and FT 5000 Smart Transceivers), Echelon’s Power Line Smart Transceivers (PL 3120, PL 3150, and PL 3170™ Smart Transceivers), and Echelon’s Neuron® 5000 Processor, even after they have been soldered into a device.
Using the NodeLoad Utility The NodeLoad utility is a Microsoft® Windows® console application that you can call from your functional test software. The NodeLoad utility is compatible with most LONWORKS® network interface adapters, including the following devices: • i.LON® 10 Ethernet Adapter • i.
Argument -D Description Specify the LONWORKS network interface. For example: -DLON2 -D\\.\xlonusb0 To specify an i.LON 10 or i.LON 100 as the network interface, use the form X.Profile.iLONname. For example: -DX.Default.iLONatHQ LON1 is the default (no interface specified). -E Redirect the NodeLoad output string to another Windows application. The application uses the WM_COPYDATA message to send the output string to another application.
Argument Description -O Redirect the NodeLoad output string to the file specified. -Ofilename.txt -Q Send a query for unconfigured devices on the network and program the first device found. This argument is the default if none of –N, -W, and –Q are specified. Note: This method is not recommended when building power line-based devices unless the NodeLoad station has a good power line communications isolator.
Example NodeLoad Commands Here are five examples that use the NodeLoad commands. 1. This example command opens LON1, finds a device, downloads an application named “test”, and sets the transceiver parameters: nodeload –Ltest.ndl –Xtest.ndl 2. This example command opens LON2, waits 3 seconds for a service pin message, and downloads the transceiver parameters. nodeload –DLON2 –W3 –Xtest.ndl 3.
Passing Result This result message indicates passing results and returns the NID of the loaded node. Nodeload Result: Success; NID=050001020300 Failing Result This result message indicates failing results and includes a code that specifies the failure. Nodeload Result: Failed (error - #x) Error Code Reference Error codes for the NodeLoad utility (error - #x) are defined in the following table.
NodeLoad Utility User’s Guide 7
