
        NODEUTIL - LONWORKS(R) Node Configuration Utility
                           Release 1.42
                         +-+-+-+-+-+-+-+
                           hr 5 Aug 96

NODEUTIL is a simple DOS-based utility that can be used to
diagnose and configure LONWORKS network interface nodes
(such as the PCLTA, LMPA, PCNSS, and SLTA/2), LONWORKS
routers, and application nodes. It is not a network
management tool; it will not assign destination addresses
or bind network variables.

Requirements
============

You will need a LONWORKS network interface to use NODEUTIL.  You
can use a PCLTA PC LonTalk(R) Adapter, an SLTA/2 Serial LonTalk
Adapter, a serial LonTalk adapter based on the LTS-10 module, a
LonManager Protocol Analyzer card, a PCNSS PC network interface
card, or a custom network interface based on the NSS-10 module
or Microprocessor Interface Program (MIP) firmware.  A PCNSS
card, or other network interface based on the NSS-10 module
must be configured as a LonTalk adapter.

Before invoking NODEUTIL, make sure that the network driver
for the selected network interface is loaded in your CONFIG.SYS,
and is appropriately configured for your hardware.  See the
PC LonTalk Adapter User's Guide, the Serial LonTalk Adapter
and Serial Gateway User's Guide, the NSS-10 Developer's Guide,
the NodeBuilder User's Guide or the documentation for your
selected network interface for details.

Getting Started
===============

At the DOS prompt, type:

     NODEUTIL [-Dname] [-V] [-A] [-S]

The -D switch specifies the device name to use (the default is
-DLON1). You can also specify a network driver for a LonManager
Protocol Analyzer Card as -DLMPAn.

If an invalid option is specified, NODEUTIL will display a help
message.

The -V option causes NODEUTIL to start up in verbose mode.
In this mode, the software displays all network interface
messages in detail.

The -A option causes NODEUTIL to start up in application mode.
In this mode, NODEUTIL does not configure the network interface,
and does not accept service pin messages.  By default, NODEUTIL
assigns the network interface to a random subnet address in
the zero length domain with a node ID of 126, and sets the
network interface to the configured state.

The -S option causes NODEUTIL to use slower tranaction timers,
suitable for use with powerline.  By default, NODEUTIL uses
transaction timers that are suitable for twisted pair.

NODEUTIL will display a sign-on message, and a menu of commands.
If there is any problem in opening the network driver, error
messages will be displayed and NODEUTIL will exit back to DOS.
If this happens, check that the driver is loaded correctly, and
that your network interface hardware is correctly configured.

If NODEUTIL succeeds in opening the network driver, it will
display the message:

    Node Utility Release 1.42
    Copyright (c) 1996 Echelon Corporation.  All rights reserved.

    Successfully installed  network interface.
    Welcome to the LONWORKS Node Utility application.
    Activate the service pin on remote node to access it.

    Enter one of the following commands by typing the indicated letter:

This is followed by the NODEUTIL main menu.

The NODEUTIL MAIN Menu
======================

The main command menu for NODEUTIL is as follows:

        A -- (A)dd node to list.
        C -- Set (C)lock rates of the network interface
        D -- Set the (D)omain of the network interface.
        E -- (E)xit this application and return to DOS.
        F -- (F)ind nodes in the current domain.
        G -- (G)o to node menu.............
        H -- (H)elp with commands.
        L -- Display node (L)ist.
        M -- Change node (M)ode or state.
        O -- Redirect (O)utput to a file.
        P -- Send a service (P)in message from a PCLTA.
        R -- (R)eboot 3150 node.
        S -- Report node (S)tatus and statistics.
        V -- Control (V)erbose modes.
        W -- (W)ink a node.
        Z -- Shell out to DOS.

Type the indicated letter to invoke the corresponding command.

The G, M, R, S, and W commands will prompt you to enter an ID
for the node you wish to address with the command.  NODEUTIL
maintains a directory of nodes that it knows about, indexed by
ID number.  This directory initially contains only the network
interface itself, which has an ID of 0.  For most of these
commands, the default node is the last node in the directory.

One way to add a node to the node directory is to attach the
node to the network and activate its service pin.  When
NODEUTIL receives the service pin message, it will display the
program ID of the node. Subsequent service pin messages from
the same node will be ignored.  If the service pin message is
received from a router, two entries will be made in the node
directory, the first entry will be for the router near side
(the side attached to the network interface), and the second
entry for the router far side.

A second way to add nodes to the node directory is to execute
the (F)ind Nodes command.  All unconfigured nodes, and nodes
configured in the domain of the network interface, will be
added to the node directory.

A third way to add nodes to the node directory is to execute
the (A)dd Node to List command.  You will be prompted to enter
the 6-byte Neuron ID of the node you wish to add to the
directory.

The G command will display a secondary menu of commands to
display various data structures within the Neuron Chip.  This
menu is modal - the G command will prompt you to enter an ID
for the node you wish to address, and the prompt will change
to NODE:x> , where x is the ID of the node for the NODE menu.
For descriptions of the information displayed by NODE menu
commands see the Neuron(R) Chip Data Book, Appendix A.

The NODEUTIL NODE Menu
======================

The node command menu for NODEUTIL is as follows:
        A -- Node (A)ddress table.
        B -- (B)uffer configuration.
        C -- Application (C)onfiguration structures.
        D -- Node (D)omain table.
        E -- (E)xit this menu and return to main menu.
        G -- (G)o to another node.
        H -- (H)elp with node commands.
        I -- Network variable al(I)as table.            **
        J -- (J)am network variable type.               **
        L -- (L)ist network variables.                  **
        M -- Change node (M)ode or state.
        N -- (N)etwork variable configuration table.    **
        O -- Redirect (O)utput to a file.
        P -- (P)oll network variable.                   **
        R -- (R)ead node memory.
        S -- Report node (S)tatus and statistics.
        T -- (T)ransceiver parameters.
        U -- (U)pdate input network variable.           **
        V -- Control (V)erbose modes.
        W -- (W)rite node memory.
        X -- Create e(X)ternal interface file.          **

** These commands are not available for the network interface node,
   or for router nodes.

Command Descriptions
====================

(A)dd node to list                          (MAIN menu)
------------------
Allows you to manually enter the Neuron ID of a node that
you wish to add to the node directory.  Enter the Neuron
ID as six hex values, separated by spaces.  If the node
can be reached over the network, it will be added to the
directory.

Node (A)ddress table                        (NODE menu)
--------------------
Displays a selected address table entry, or the whole address
table of the indicated node.  For example:

Index   Type    Domain  Mbr/Nod Rpt tmr Retries Rcv tmr Tx tmr  Grp/Sbnt
0       Unused  0       0       16      0       128     16      0
1       Unused  0       0       16      0       128     16      0
2       Unused  0       0       16      0       128     16      0

(B)uffer configuration                      (NODE menu)
----------------------
Displays the buffer configuration of the indicated node.
For example:

Type                    Count   Size    Bytes
Receive transaction     16      13      208
Transmit transaction    2       28      56
App buffer in           15      255     3825
App buffer out          31      255     7905
Net buffer in           63      255     16065
Net buffer out          2       255     510
App buff out priority   15      255     3825
Net buff out priority   2       255     510
==> Total bytes = 32904

See the Neuron Chip Data Book, Appendix A, and the Neuron C
Programmer's Guide, Chapter 6 for a description of these values.
You will then be given the opportunity to change this
configuration, one value at a time.  For each value, the
default value is the current setting.  If the value you enter
is not a legal value, you will either be prompted again, or the
next larger legal value will be substituted.  At the end of
this process, the new configuration will be displayed, and you
will be given an opportunity to cancel the command before the
new values are written into the node's EEPROM memory.

Note that if you configure the node to use more RAM than is
actually available, the node will most likely crash.  If the
node is based on the Neuron 3120 Chip, it may not be recoverable.
If it is based on the Neuron 3150 Chip, you may be able to
recover it with the (R)eboot command of NODEUTIL, or by using
the EEBLANK program.  See the LonBuilder User's Guide for
details on using EEBLANK.

The following table shows the maximum amount of RAM memory
available for buffers in Echelon products.

                    Product     Bytes
                    -------     -----
                    SLTA/2      1,394
                    LTS-10      3,400
                    Routers     1,455
                    PCLTA      32,904

Set (C)lock rates of the network interface  (MAIN menu)
------------------------------------------
Displays the input clock rate and the communications bit
rate of the network interface node. For example:

Current input clock             = 10 MHz
Current communications bit rate = 1.25 Mbps

If the network interface supports it, you will then be
given an opportunity to change the inputclock rate by
selecting from a menu.  The choices are:

        1. 625  kHz
        2. 1.25 MHz
        3. 2.5  MHz
        4. 5.0  MHz
        5. 10.0 MHz

You will then be given an opportunity to change the
communications bit rate by selecting from a menu.
The choices depend on the input clock rate.  For example,
for a 10MHz input clock rate, the choices are:

    0. 1.25 Mbps
    1. 625  kbps
    2. 312.5 kbps
    3. 156.3 kbps
    4. 78.1 kbps
    5. 39.1 kbps
    6. 19.5 kbps
    7. 9765 bps

At the end of this process, you will be given an opportunity
to cancel the command before the new clock and bit rates are
written into the network interface's EEPROM memory.

If the network interface device implements the Transceiver ID
(XID) pins, then you will normally not be able to change
the input clock rate or the communications bit rate.
This applies, for example, to the PCLTA, LTS-10, PCNSS and
NSS-10 modules.  To change these parameters for XID devices,
you must set the value read from the XID pins to 30 decimal,
or 1E hex.

Selecting incorrect input clock or communications bit rate
may make the network interface unable to communicate over
the network.  Use the Set (C)lock Rates command again, or the
(T)ransceiver Parameters command to restore the correct values.

Application (C)onfiguration structures      (NODE menu)
--------------------------------------
Displays data from the Read-only and Configuration data
structures of the indicated node.  For example:

Neuron ID       = 00 24 01 03 00 FD
Model number    = 0             Minor model num = 0
Program ID      = SNVTTST1
Channel ID      = 0x0001
Location string = 00 00 00 00 00 00
NV processing   = ON            Explicit addr   = OFF
Domain count    = 2             Address count   = 15
NV count        = 26            R/W protect     = OFF
Non-group receive timer = 24576 msec
Net mgmt authentication = OFF
Preemption timeout      = forever

Set the (D)omain of the network interface   (MAIN menu)
-----------------------------------------
Displays the first domain table entry of the network interface
node. You will then be given the opportunity to change this
data.  Enter the desired domain ID length (0, 1, 3 or 6 bytes),
followed by the ID values in hex, separated by spaces. The
default domain ID is all zeroes.

Following this, you will be asked to enter the subnet ID that
you wish to assign to the network interface.  The node ID in
that subnet is fixed at 126 decimal, or 7E hex. You will then
be asked to enter the authentication key to use for that domain
table entry.  Enter the key as hex bytes separated by spaces.
The default key is 0xFF for all bytes.

The second domain table entry of the network interface is always
set to the zero length domain for the purpose of receiving
service pin messages.

The (F)ind Nodes command broadcasts on the domain you assign to
the network interface.  Changing the domain and subnet is useful
if your network contains routers that are not configured as
repeaters.

Changing the authentication key is useful if you wish to update
network variables that have been configured as authenticated.
An update to an authenticated network variable must be sent
using a domain in which the target node is configured, using
the correct authentication key.

At the end of this process, you will be given an opportunity
to cancel the command before the new domain entry is written
into the node's EEPROM memory.

Node (D)omain table                         (NODE menu)
-------------------
Displays a selected domain table entry, or the whole domain
table of the indicated node.  For example:

Index   Size    Subnet  Node    Auth Key                Domn ID
0       0       142     1       FF FF FF FF FF FF
1       Unused

(E)xit this application and return to DOS   (MAIN menu)
-----------------------------------------
Exits from NODEUTIL. The node directory is not saved, and will
need to be rebuilt if you wish to invoke NODEUTIL again.

(E)xit this menu and return to main menu    (NODE menu)
----------------------------------------
Exits from the NODE menu, and returns to the MAIN menu.  The
prompt becomes NODEUTIL> again.

(F)ind nodes in the current domain          (MAIN menu)
----------------------------------
Issues a domain-wide broadcast to all nodes to respond to the
query message, and then queries all nodes for their
identification.  Each new node is added to the node directory.
This command is useful when the service pins of the remote nodes
are not accessible. It will discover unconfigured and
application-less nodes, as well as nodes that are configured in
the domain of the network interface.  To query for nodes
configured in a specific domain, use the Set (D)omain command
before the (F)ind Nodes command.

(G)o to node menu.............              (MAIN menu)
------------------------------
Displays the node list, and switches to the NODE menu.  Enter
the ID of the node you wish to address.  The prompt changes to
NODE:x> , where x is the ID of the node for the NODE menu.
To return to the MAIN menu, use the (E)xit command.

(G)o to another node                        (NODE menu)
--------------------
Displays the node list, and allows you to select another node
for NODE menu operations.  The prompt changes to NODE:x>, where
x is the ID of the selected node.

(H)elp with commands                        (MAIN menu)
--------------------
This command (or any other unrecognized command character)
displays the MAIN command menu again.

(H)elp with node commands                   (NODE menu)
-------------------------
This command (or any other unrecognized command character)
displays the NODE command menu again.

Network variable al(I)as table              (NODE menu)
------------------------------
Displays a selected network variable alias table entry,
or the whole network variable alias table of the
indicated node.

(J)am network variable type                 (NODE menu)
---------------------------
Reads the network variable self-documentation information
from the indicated node.  Enter the index of the network
variable whose type you wish to change, and the SNVT index
of the new type.  This command can only be used on Neuron
Chip-based nodes which have specified one of the Neuron C
pragmas snvt_si_eecode or snvt_si_ramcode.

Display node (L)ist                         (MAIN menu)
-------------------
Displays a list of the nodes in the directory.  For example:

Node ID    Neuron ID            Program ID
0          00 94 98 01 00 F0    SLTA                    *** network interface
1          00 E6 00 03 00 FD    DIMMER
2          00 2D 05 01 00 F0    80 00 01 01 01 01 01 01 *** router near side
3          00 E7 00 04 00 FD    80 00 01 01 01 01 01 01 *** router far side

(L)ist network variables                    (NODE menu)
------------------------
Displays the self-documentation and other network variable
information available on the selected node.  For example:

#pragma set_id_string "VARTEST"
#pragma set_node_sd_string "This is a test"
 0: network input Non_SNVT var_0;
 1: network output sd_string("Hello World") SNVT_temp var_1;
 2: network input sync SNVT_config_src var_2;
 3: network output polled SNVT_lev_cont var_3[20];
23: network input /*polled*/ SNVT_lev_disc var_23;
24: network input config Non_SNVT var_24;
25: network input bind_info( offline ) Non_SNVT var_25;
-------------------------------------------------------------
Self documentation structure length = 31, version number = 1
Number of declared NVs = 7, total NVs = 26, message tags = 0
-------------------------------------------------------------

Change node (M)ode and state.                (MAIN and NODE menus)
----------------------------
Allows you to change the node's mode or state.  If you invoke
this command from the main menu, you are prompted to enter a
node ID.  The default is [all] nodes, meaning that the change
mode or state message is sent as a broadcast to all nodes
configured in the current domain.

The choices for node mode are:

(R)eset, o(N)line, o(F)fline, or (S)tate change ?

Type the indicated letter to invoke the corresponding command.
For a description of these modes, see the Neuron Chip Data Book,
Appendix B.  If you select (R)eset, o(N)line, or o(F)fline, the
corresponding message will be sent to the node.  If you select
(S)tate change, you will be prompted to select the new state for
the node.  The choices are:

(A)ppl-less, (U)ncfg, (C)nfg, (H)ard offline ?

Type the indicated letter to invoke the corresponding command.
For a description of these states, see the Neuron Chip Data
Book, Appendix B.

If the node is a router, the node mode choices are:

(R)eset, o(N)line, o(F)fline, (S)tate change, or Routing (M)ode ?

If you invoke the Routing (M)ode command, you will be prompted
for the algorithm.  The choices are:

(C)onfigured, (L)earning, (B)ridge, (R)epeater ?

Type the indicated letter to invoke the corresponding command.
For a description of these choices, see the LONWORKS Router
User's Guide.

(N)etwork Variable configuration table      (NODE menu)
--------------------------------------
Displays a selected network variable configuration table entry,
or the whole network variable configuration table of the
indicated node.  For example:

Index   Selctr  Dir     Prio    Auth    Addridx Service TrnArnd
0       3FFF    out     no      no      Unused  Ackd    no
1       3FFE    out     no      no      Unused  Ackd    no
2       3FFD    out     no      no      Unused  Ackd    no
3       3FFC    out     no      no      Unused  Ackd    no

Redirect (O)utput to a file                 (MAIN and NODE menus)
---------------------------
Redirects all screen output from NODEUTIL to a file.  You will
be prompted for the name of a file. The default file extension
is .LOG.  If the file already exists, you will be asked if you
wish to (O)verwrite the file from the beginning, or (A)ppend
output to the end of the file.  To stop redirection, enter a
null file name.  This command is useful for saving the output
of any of the other commands.

Send a service (P)in message from a PCLTA   (MAIN menu)
-----------------------------------------
If the network interface is a PCLTA or PCNSS PC interface card,
this command will cause the network interface to send out a
service pin message. This avoids the necessity to physically
access the service pin connector on the network interface board.

(P)oll network variable                     (NODE menu)
-----------------------
Fetches the value of a selected network variable, or every
network variable on the indicated node.  Enter the index of the
network variable on the node, or <Enter> for all variables.
The data fetched from the network variable will be displayed in
hexadecimal bytes, and may be further interpreted depending on
its length.

(R)eboot 3150 node                          (MAIN menu)
------------------
Restores the contents of the on-chip EEPROM memory of the
indicated node to the state it had when the off-chip EPROM was
first installed.  This will restore the communications
parameters, node state, buffer configuration and on-chip EEPROM
variables, and re-initialize the domain, address, and network
variable configuration tables.  This command does not operate
on a Neuron 3120 Chip-based node, or on any node based on a
LonBuilder processor board.

If the (R)eboot command is executed on the network interface used
to run NODEUTIL, it will be reconfigured so that it can continue
to be used.

If you reboot an SLTA, it will re-execute the autobaud sequence
if the AB jumper is enabled.

If you reboot a node based on the NSS-10 module, it will become
a LonTalk adapter, and its database will be cleared.

(R)ead node memory                          (NODE menu)
------------------
Enter the starting address for the read operation in
hexadecimal, and then enter the number of bytes you wish to
read in hexadecimal.  The memory will be read from the node
and displayed in hexadecimal bytes.  If you wish to save the
output to a file, invoke the Redirect (O)utput command before
the (R)ead Memory command.

Report node (S)tatus and statistics         (MAIN and NODE menus)
-----------------------------------
Sends a message to query the status of the indicated node, and
displays the results.  For example:

    Node status:
    Packet errors detected      = 0
    Transaction timeouts        = 0
    Receive trans full errors   = 0
    Lost msgs (no app buff)     = 0
    Missed msgs (no net buff)   = 0
    Packets received by node    = 0
    Packets addressed to node   = 0
    Messages sent to MAC layer  = 0
    Retries                     = 0
    Backlog overflows           = 0
    Late acks or responses      = 0
    Collisions detected         = 0
    EEPROM lock                 = Clear
    Last reset cause            = Software
    Node state                  = Configured, On-line
    Firmware version number     = 6
    Neuron Chip model           = 3150
    Last error logged           = None

For a description of the meanings of these values, see the
Neuron Chip Data Book, Appendix B.  If the node is a router,
additional information will be displayed.  For example:

    Router algorithm            = Repeater
    Router mode                 = Normal

For a description of the meanings of these values, see the
LONWORKS Router User's Guide.  You will then be given an
opportunity to clear the status of the node, which clears the
error counters, the reset cause and the last error logged.

(T)ransceiver parameters                    (NODE menu)
------------------------
Displays the transceiver (communications) parameters of the
indicated node.  For example:

    Transceiver mode        Differential
    Transceiver type        Differential
    Input Clock             = 10 MHz
    Network bit rate        = 1250 kbps
    Preamble length         = 144.6 - 153 microsec
    Packet cycle            = 4020 microsec
    Beta 2 control          = 24 microsec
    Transmit interpacket    = 0 microsec
    Receive interpacket     = 0 microsec
    Node priority           = 0
    Channel priorities      = 0
    Hysteresis              = 0.027 * Vdd
    Filter                  = 6 nsec
    Bit sync threshold      = 7 bits
    Collision detect          disabled
    CDetect during preamble   disabled
    CDetect at end packet     disabled
    CDetect to end packet   = 13.2 microsec

This display will depend on the transceiver type.  For a
description of the meanings of these values, see the Neuron
Chip Data Book, Appendix B. You will then be given an
opportunity to change the transceiver parameters by selecting
from a menu.  The choices depend on the Neuron Chip input clock
rate.

For a 10 MHz input clock, the choices are:
     1.   TP/XF-78
     2.   TP/XF-1250
     3.   TP/FT-10
     4.   PL-10
     5.   PL-20C
     6.   PL-20N
     7.   PL-30
     8.   TP/RS485-39
     9.   TP/RS485-78
    10.   TP/RS485-625
    11.   TP/RS485-1250
    12.   DC-78
    13.   DC-625
    14.   DC-1250

For a 5 MHz input clock, the choices are:
     1.   TP/XF-78
     2.   TP/FT-10
     3.   PL-10
     4.   PL-20C
     5.   PL-20N
     6.   PL-30
     7.   TP/RS485-39
     8.   TP/RS485-78
     9.   TP/RS485-625
    10.   RF-10

NODEUTIL does not support changing the transceiver parameters
for nodes with input clocks less than 5 MHz. To change the
input clock rate and the communications bit rate for the network
interface node only, see the Set (C)lock Rates command.

The transceiver types are:

TP/XF-xx    Transformer-coupled twisted pair.  Bit rate is in kbps.
TP/RS485-xx EIA-RS485 twisted pair.  Bit rate is in kbps.
RF-10       49MHz radio frequency.  Bit rate is 4.9 kbps.
PL-10       Power line in 100-450kHz band.  Bit rate is 10kbps.
PL-20       Power line for CENELEC C band.  Bit rate is 4kbps.  PL-20C
            enables the CENELEC access protocol. PL-20N disables it.
            You may also specify the power management mode for PLT-21.
PL-30       Power line for CENELEC A band.  Bit rate is 2kbps.
FT-10       Free topology twisted pair. Bit rate is 78kbps.
            FT-10 is used with the FTT-10 and LPT-10 transceivers.
DC-xx       Direct connect twisted pair.  Bit rate is in kbps.

If the destination device implements the Transceiver ID (XID)
pins, then you will normally not be able to change the interface
bit rate or the transceiver type (differential, single-ended or
special-purpose).  This applies, for example, to the PCLTA, PCNSS,
PCNSI, LTS-10, RTR-10, LTM-10 and NSS-10 modules.  To change these
parameters for XID devices, you must set the value read from the
XID pins to 30 decimal, or 1E hex.

Selecting incorrect communications parameters may make it
impossible to communicate with the node over the network.
If the node is based on the Neuron 3120 Chip, it may not be
recoverable.  If it is based on the Neuron 3150 Chip, you will
be able to recover it using the EEBLANK program.  See the
LonBuilder User's Guide for details on using EEBLANK.

(U)pdate input network variable             (NODE menu)
-------------------------------
Allows you to update an input network variable on the indicated
node. Enter the index of the network variable on the node.
The current data in the network variable is displayed.  At the
prompt, enter the data to be sent to the network variable in
hexadecimal bytes.  Separate each pair of hex digits with a
space, and enter all the required data on one line. The data
values default to zero.

If the network variable has been configured as authenticated,
you should use the Set (D)omain command to configure the network
interface with a domain and authentication key to match those
of the destination node.

Control (V)erbose modes                     (MAIN and NODE menus)
-----------------------
Enables or disables two verbose modes in the NODEUTIL application.
These are useful for debugging network problems.  Display network
interface messages - this mode displays the contents of all
application buffers going to and coming from the network
interface.  By default, it is off.

Display traffic summary - this mode reports any incoming
message addressed to the application processor on the network
interface node.  By default, it is on.

(W)ink a node                               (MAIN menu)
-------------
Sends the wink message to a node.  If the node has been
programmed to respond to this message, it will activate the
wink task.  When you are prompted to enter a node ID for this
command, the default is [all] nodes, meaning that the wink
message is sent as a broadcast to all nodes configured in the
current domain.

(W)rite node memory                         (NODE menu)
-------------------
You will be prompted to enter the starting address for the
write operation in hexadecimal.  The contents of each memory
address will be first read and displayed in hexadecimal.
If you do not wish to change the data, press <Enter>, and the
next byte will be displayed. If you wish to change the data for
that address, enter the new data byte in hexadecimal, followed
by <Enter>. To terminate the process, enter some non-hexadecimal
character, for example a period (.) before pressing <Enter>.

If you have changed any of the data in memory, you will be
given the opportunity to update both the application and
configuration checksums, or just the configuration checksum.
For a description of which data structures are part of each of
these checksums, see the Neuron Chip Data Book, Appendix A.

The node should be in the applicationless state before you
change any of the application image memory, otherwise the node
will report an application checksum error.  Similarly, the node
should be in the applicationless or unconfigured state before
you change any of the network image memory, otherwise the node
will report a configuration checksum error.

Create e(X)ternal interface file            (NODE menu)
--------------------------------
Creates a version 3 external interface file (.XIF extension)
for the indicated node.  You will be prompted to enter a name
for the external interface file to be created.  If the node has
an alphanumeric program ID, this ID becomes the default file
name.  The default extension is .XIF.  If output redirection is
in effect, the current output file is closed before creating
the external interface file.  The generated external interface
file can be used as input to LonBuilder, LonManager API,
Profiler, and XIF2BIN for the NSS-10 module and LNS for Windows.

Shell out to DOS                            (Z command, MAIN menu)
----------------
Allows you to temporarily return to DOS without losing the node
directory.  Type EXIT at the DOS prompt to return to NODEUTIL.

Disclaimer
==========

Echelon Corporation assumes no responsibility for any errors
contained herein.

Notices
=======

Copyright (c) 1994,1996  Echelon Corporation.  ECHELON, LON,
LonBuilder, LonManager, LonTalk, LONWORKS, Neuron, 3120, and
3150 are U.S. registered trademarks of Echelon Corporation.
LonLink is a trademark of Echelon Corporation.  Other names
may be trademarks of their respective companies.  Some of the
LONWORKS tools are subject to certain Terms and Conditions.
For a complete explanation of these Terms and Conditions,
please call 1-800-258-4LON or +1-415-855-7400.
