4 The next screen provides some basic instructions concerning installation.

Press any key except Esc to continue.

5 Specify the hard drive on which the software should be installed. The default
is drive C. Use the arrow keys to select an alternate drive if desired. Press
(jj) when the proper drive is highlighted.

6 The programmer software is installed in the c : \LONWORKS directory. If you

wish to install to a different directory, enter the desired path. If you install the
programmer software in a different directory, manually add that directory to
the DOS search path.

7 After the files have been copied, the screen will clear and you will be asked:

May I create/modify your CONFIG.SYS file if needed? (Y/N)

Press Y to let the installation software automatically update your CONFIG. SYS
file. The modification consists of adding the following line to your
CONFIGSYSfile:

DEVICE=C:\LONWORKS\BIN\LDVSLTA.SYS /A

The correct directory name is substituted for oc : \LONWORKS\BIN" if you are

installing into a different directory. If you do not want your CONFIG. SYS file
to be updated automatically, press N.

8 The final screen contains information pertaining to starting the 3120

programmer software. It also notes that you should reboot prior to starting the
programmer software for the first time to ensure that the network driver is
loaded. Press any key to return to DOS.

9 If you elected not to have the install program update your CONFIG. SYS file,
update it manually at this time.

10 Verify that you have the correct options specified for the network driver as
described in the next section.

11 Reboot your PC to load the network driver.

Table 3.1 describes the files installed during the installation procedure.

3 120 Programmer User’s Guide 33

 Table 3.1 LonBuilder Neuron 3120 Programmer Files

File I Description
I NP.EXE 1 Programmer application program I
I LDVSLTA.SYS I Network driver I
READMENP.TXT Describes changes to the documentation
this manual was printed.

Loading the Network Driver

The network driver is installed with the following line in your CONFIG. SYS file:

DEVICE=C:\LONWORKS\BIN\LDVSLTA.SYS [options]

This line may be added automatically by the installation software as described in

the previous section. The [opt ions ] are described in the next section. The /A
option should be specified if the default hardware setting of Autobaud Enabled is
used. The /D2 option should be specified if the NodeBuilder software is used on the
same PC.

Following is the command line for the default hardware settings with the 3120
programmer installed on COMl:

DEVICE=C:\LONWORKS\BIN\LDVSLTA.SYS /A

Following is the command line for the default hardware settings with the 3120
programmer installed in COM2 as device LON2:

DEVICE=C:\LONWORKS\BIN\LDVSLTA.SYS /A /D2 /P2

Reboot the PC to load the driver after adding this line.

Installation
Network Driver Options
The following options are available for the network driver:

/A Enable the autobaud feature. The autobaud feature allows the 3120
programmer to automatically determine the serial link bit rate. If
the autobaud feature is enabled, the network driver sends an
initialization sequence that the programmer uses to match the baud
rate after the programmer is powered up. If you change the serial
link bit rate, you must cycle power on the programmer.

The default hardware setting is autobaud enabled. The default

driver setting is autobaud disabled. If the autobaud hardware
setting is enabled, /A must be specified.

/Bnnnnnn Set the serial link bit rate to uznnnnm. The available bit rates are
listed below. The default is 38400, which will work with most PCs
and serial cables. If you encounter any communications problems
with the 3120 programmer, try a slower bit rate.

Available bit rates:

33,1200,2400,9600,19200,38400,57600,115200.

If autobaud is not used; the bit rate specified by this driver option
must match that specified by the S3 jumper setting (see
Configuration Jumpers later in this chapter). To use autobaud, both
the /A option and the autobaud hardware setting must be enabled.

/c Enable communications interrupt chaining. Some PCs may

incorporate up to four serial ports. As shown in table 2.4, COMl and
COM3 share the same interrupt, as do COM2 and COM4. This option
allows the driver to share this interrupt by chaining to the interrupt
vector that was in place when the driver was loaded. This option is
not necessary if your system does not use COM3 or COM4.

When installing two network drivers on a system on COMl and

COM3 (or COM2 and COM4), the last installation of the driver
should use this option. Here is an example of a CONFIG. SYS file
entry for such a system.

DEVICE=LDVSLTA.SYS /B57600 /A /Dl /PI

DEVICE=LDVSLTA.SYS /B57600 /A /D2 /P3 /C

3 120 Programmer User’s Guide 35

 /Dn Defines the device number as <n> for LONl through LON9. The
default is 1 for LONl. This option can be used to support multiple
network interfaces on a single PC. For example, the 3120
programmer may be installed as LON2 and a NodeBuilder PCNSS
may be installed as LONl.

/Pn Set the serial port to <n> where <n> is 1-4 for COMl - COM4. The
default is COMl. Table 2.4 lists the hardware configuration used
for the four serial ports.

Configuring the Programmer Hardware

The 3120 programmer hardware includes configuration jumpers that are set to the
following factory defaults:

Jumper Default I
1 EIA-232 Interface Configuration 1 DCE
1 EIA-232 Physical Interface I 3-wire
I-- EIA-232
~~~~~~ Baud Rate I Autbbaud Enabled I
I Initial FLUSHState I Enabled I

These options are suitable for most applications. These options and how to change
them are described in Configuration Jumpers, later in the chapter.

ESD Warning
The 3120 programmer contains devices which are sensitive to static electricity.
Before opening the enclosure or installing the serial cable, touch earth ground with
your hand to discharge static electricity. ,

Opening the Enclosure

Disconnect the serial cable and power supply, if connected. Using a small
Phillips-head screwdriver, remove the four flathead screws (two on each end).
Remove the cover.

Installation
Closing the Enclosure
To close the enclosure, reinstall the top cover. It may be necessary to pull out
slightly on the top housing to clear the end of the chassis. Reinstall the four flat-
head screws. Reconnect the serial cable and power supply.

Configuration Jumpers

s2
EIA-232 devices are configured as either Data Circuit-terminating Equipment,
DCE, or as Data Terminal Equipment, DTE. A DCE always connects to a DTE. A
DCE cannot be directly connected to another DCE with an EIA-232 cable. A DTE
cannot be directly connected to another DTE.

S2 is used to configure the 3120 programmer as either DTE or DCE. With the 9-
position shunt S2 installed toward the network connector, the programmer is a
DCE. With the S2 shunt away from the network connector, the programmer is a
DTE. The programmer is shipped from the factory configured as DCE. This
setting is compatible with standard PC serial ports.

More information on cabling to EIA-232 devices is provided in Connecting to the

Host PC, later in this chapter.

s3
Eight jumpers make up S3. The programmer firmware reads the jumper positions
to configure or enable features.

The first (lowest) group of three jumpers sets the programmer serial link bit rate
and is labeled ‘BAUD.’ There are eight available bit rates. The bit rate setting is
only used if autobaud operation is disabled. The programmer is shipped from the
factory configured for 38,400bps and autobaud enabled. This setting is compatible
with standard PC serial ports and generally does not need to be changed.

3 120 Programmer User’s Guide 37

 pqa mjci I-EECI p7qcl
~lcl I pqcl l3’pa-l qloOI
clclcl qlopml lojo 0~1
300 Baud 1200 Baud 2400 Baud 9600 Baud

q q qm-j
~10 fmqci 0~1 q‘~l
‘000 nfiTq lolo qm1
19200 Baud 38400 Baud 57600 Baud 11500 Baud

The next jumper, labeled ‘AB’, selects the autobaud feature. The autobaud feature
enables the 3120 programmer to ‘automatically match the serial bit rate of the host
PC. If you choose to use the autobaud feature, be sure to specify the /A option when
loading the network driver. The default is Autobaud Enabled.

AB

Autobaud Autobaud
Disabled Enabled

The next group of jumpers, labeled ‘CFG 34, is used to select a full eight-wire
interface (CFG 0) and to enable the post reset flush state (CFG 1). The default is ‘3
Wire Interface’ for CFG 0 and ‘Init Flush Enabled’ for CFG 1. These jumpers
should be left in their factory default positions of three-wire interface and post reset
flush state enabled.

3-8 Installation
 lnit Flush lnit Flush
Disabled Enabled

3-Wire 8-Wire
Interface Interface

Note= C~3andCFG2amnotd

Connecting to a Host PC
Use a shieLded serial interface cable with a male DB-9 connector to connect the 3120
programmer to a serial port. Most PC serial I/O ports have a g-pin male connector.
Some have a 25.pin male connector. For g-pin connectors, use a straight-through
cable with both a DB-9 male end and a DB-9 female end. Plug the male end into the
3120 programmer and the female end into the serial I/O connector on the PC. Table
3.2 summarizes the DB-9 to DB-9 serial cable connections.

Table 3.2 PC g-Pin Serial Connector

Signal Name PC Connector Cable 3120

Programmer
DB9 Male DB9 Female DB9 Male DB9 Female
RXD PIN 2 PIN 2 PIN 2 PIN 2
TXD PIN 3 PIN 3 PIN 3 PIN 3
Signal Ground PIN 5 PIN 5 PIN 5 PIN 5

3 120 Programmer User’s Guide 39

 For 25.pin connectors, use a cable wired as shown in table 3.3. Plug the DB-9 into
the 3120 programmer and the DB-25 into the PC.
Table 3.3 PC 25.Pin Serial Connector

Signal Name PC Connecfor Cable 3120

Programmer
DB9 Male DB9 Female DB9 Male DB9 Female
RXD I PIN 3 PIN 3 1 PIN 2 1 PIN 2
TXD PIN 2 PIN 2 I PIN 3 I PIN 3 I
1 Signal Ground 1 PIN 7 PIN 7 I PIN 5 I PIN 5 I
Table 3.4 illustrates the serial connector pinout.
Table 3.4 Programmer EIA-232 Connector Pinout

Progmmmer Pin Mnemonic Name DCE DTE

Number
I 2 I RXD 1 Received Data 1 output 1 Input I
3 TXD 1Transmitted Data I Input I output
5 GND I Signal Ground I n/a 1 n/a

Connecting Power
Four power supply options, summarized in table 3.5, are available for the 3120
programmer, depending on the country for which the programmer is intended.
The output voltage is a nominal 9 VDC at 5OOmA. The connector is a standard
female DC power plug, negative tip, outer barrel positive, with a 2.lmm inside
diameter and 5.5mm outside diameter.

310 Installation
 To connect to the 3120 programmer, plug the barrel connector of the wall-mount
power supply into the power input connector on the side of the programmer.
Table 3.5 Power Supply Characteristics

Frequency Input Connector Echelon

Model
Number
United States, 120 VAC 108 - 132 VAC 60Hz 2-prong, NEMA, l-l 5p 78010
Canada I
I Japan 1 IOOVAC 190-IIOVAC 50/6OHz 2-prong, NEMA, l-l 5p 78040 I
IUK .. 1 240 VAC I216 - 264 VAC 50Hz 3-prong, U.K. Plug 78030 I
Continental 220 VAC 198 - 242 VAC 50Hz ~2-prong, Euro Plug 78020
Europe

Verifying Correct Operation

The 3120 programmer runs a self-test when powered-up. The Pass and Fad LEDs
will flash briefly and then remain off.
If the Pass and Fail LEDs do not flash when the programmer is powered-up, check
that the unit has power. Make sure the external power supply is plugged in and turn
the power switch off and on. If the LEDs turn on, the power supply is working.
If the Pass and Fail LEDs do not stop flashing, or if they remain on and the
programmer socket is empty, the unit is damaged. There are no user-serviceable
parts or fuses inside. Return the programmer for repair.

3 120 Programmer User’s Guide 311

312 Installation
 4
Operation

This chapter describes how to use the LONWORKS

Neuron 3120
Programmer to program Neuron 3120 Chips. Before
programming, the programmer hardware and software must
be installed as described in Chapter 3.

3 120 Programmer User’s Guide 4-l

Overview
The 3120 programmer is used to program Neuron 3120 Chips using EEPROM image
files created by a LonBuilder or NodeBuilder system. These tools are used to create
and debug Neuron Chip application programs. Follow these steps to create Neuron
3120 Chip-based custom nodes using the 3120 programmer:

1 Develop and debug the application program using a LonBuilder or NodeBuilder

system. Refer to the LonBuilder User’s Guide or the NodeBuilder User’s Guide
and the NodeBuilder online help.

2 Create an EEPROM image for a Neuron 3120 Chip-based custom node. This
step is described later in this chapter under Creating an EEPROM Image File.

3 Program the EEPROM image into one or more Neuron 3120 Chips. This step
is described later in this chapter under Programming Neuron 3120 Chips.

4 Build custom nodes using the programmed Neuron 3120 Chips. This step is
described in the LONWORKS Custom Node Development engineering bulletin.

5 Install the custom nodes on a LONWORKS network. This step is described in

the LONWORKS Installation Overview engineering bulletin.

6 Load the application image over the network. This step is optional and is only
required if the application image must be loaded or modified after installation.
A network tool is used for this step, not the 3120 programmer.

Creating an EEPROM Image File

The Neuron EEPROM image file contains a copy of the memory image to be loaded
into the EEPROM of a Neuron 3120 Chip. Depending to the development tool used,
refer to the appropriate section below to create this file .

NocieBuiider Development Tool

1 Define a custom node as described in the NodeBuilder User’s Guide. Be sure

to specify the correct chip type (3120,3120El, or 3l20E2) in the Neuron model
field in the Device Template screen. Set the Firmware Version field to
match the firmware version number of the Neuron 3120 Chip to be
programmed. The NodeBuilder release 1.5 software defaults to version 4
firmware for the 3120 and version 6 firmware for the 3 120El and E2 chips.
Also select the appropriate export state option. The export state option permits
the selection of the state of the node upon initial power-up. Depending on this
selection, a Neuron 3120 Chip-based node with a newly imported EEPROM
image will come up, unconfigured, or configured (domain only).

4-2 Operation
 2 Build the application image as described in the NodeBuilder User’s Guide.
The Build process generates all the pertinent project files for the device
specified, including the Neuron EEPROM image (.NEI extension) file used
by the LONWORKS Neuron 3120 Programmer.

Refer to the LONWORKS Custom Node Development engineering bulletin (005-

0024-01) for more detailed information on the procedure for developing custom
nodes.

LonBuiicier Development Tool

1 Define and install a custom node as described in the LonBuiZder User’s
Guide. Be sure to specify the correct chip type (3120,3120El, or 312032) in the
Neuron Chip field of the Hardware Properties window. Set the Firmware
Version field to match the firmware version number of the Neuron 3120 Chip
to be programmed. The LonBuilder release 3.0 software defaults to version 4
firmware for the 3120 and version 6 firmware for the 3120 El and E2 chips. Set
the HW Type field in the Target Hardware window to Custom.

2 Build the application and network image as described in the LonBuiZder

User’s Guide. Use the Automatic Build command in the Project pull-
down menu to build the image. Be sure to disable the Load after Build
option in the Project Configuration window as described under Configuring
LonBuilder Project Parameters in Chapter 4 of the LonBuilder User’s Guide.
This will prevent the LonBuilder Network Manager from attempting to load
the non-existent Neuron 3120 Chip-based node.

3 Export the Neuron EEPROM image file as described under Exporting and
Importing in the LonBuilder User’s Guide, with additional information in
the Target Network Types and Firmware State Selection section. The image
file will have an extension of . NEI. The Export command permits the
selection of the state of the node upon initial power-up. Depending on this
selection, a Neuron 3120 Chip-based node with a newly imported EEPROM
image will come up applicationless, unconfigured, or configured.

4 Exit the LonBuilder software before invoking the 3120 programmer software.
If you have sufficient memory, you can also escape to the DOS shell by
pressing Ctrl 2.

Refer to the LONWORKS Custom Node Development engineering bulletin (005

0024-01) for more detailed information on the procedure for developing custom
nodes.

3 120 Programmer User’s Guide 4-3

Programming Neuron 3120 Chips
Once you have created a Neuron EEPROM image file, follow these steps to program
the file into one or more Neuron 3120 Chips:

1 Invoke the programmer sofiware from the DOS prompt with the following
command:

NP [/LONn] fiZezzme [.NEI]

The /LONn parameter specifies the network driver name. The default is
LONl, but may be changed using the /D option when loading the network
driver. LON2 is typically used if a NodeBuilder PCNSS is installed as
LONl. See Loading the Network Driver in Chapter 3.

The f il enme parameter is the path name of the Neuron EEPROM image file
created as described in the previous section. An extension of .NEI is
assumed.

For example, to program the MOTOR JEI Neuron EEPROM image file into a
Neuron 3120 Chip using a 3120 programmer installed as the default LONl
device, enter the following command:

NP MOTOR

In the previous example, if the network driver had been loaded with the /D2
option, invoke the programmer sofiware with the following command:

NP /LONZ MOTOR

2 Load a blank Neuron 3120 Chip into the 3120 programmer socket and close the
lid. See Reprogramming Neuron 3120 Chips, later in this chapter, if you are
reprogramming a previously programmed Neuron 3120 Chip.

3 Press the Start button on the 3120 programmer or press (ii) on the PC. The
Pass and Fail LEDs will both turn off.

4 After approximately 15 seconds, the green Pass LED will come on, signaling
that the Neuron 3120 Chip was programmed correctly. If the red Fail LED
comes on, the Neuron 3120 Chip is not operating properly. Ensure that the
Neuron 3120 Chip is inserted correctly in the programmer and the lid is
closed. If the chip is inserted correctly, and the Fail LED still comes on, the
chip is defective or has been programmed with incompatible parameters as
described in the next section.

5 Remove and label the programmed Neuron 3120 Chip.

6 Repeat steps 2 through 5 to program additional parts.

Operation
Reprogramming Neuron 3 120 Chips
Once a Neuron 3120 Chip has been programmed, it can be reprogrammed with the
LONWORKS Neuron 3120 Programmer only if the Neuron 3120 Chip was
programmed with the following parameters:
l
The transceiver type was set to differential or twisted pair.
l
The input clock rate was set to 1OMHz and the transceiver bit rate was set to
1.25Mbps; or the input clock rate was set to 5MHz and the transceiver bit rate
was set to 625kbps. The 3120 programmer uses an input clock rate of 5MHz
which is compatible with Neuron 3120 Chips programmed for 1OMHz or 5MHz
operation.

0
ReadAiVrite protect was not enabled.
0
Network management authentication was not enabled.

These parameters are the factory default settings for the Neuron 3120 Chips. These
parameters ensure that the Neuron 3120 Chip being programmed can communicate
with the programmer node within the 3120 programmer. A network tool can force a
Neuron 3120 Chip to return to the default parameters by writing a zero to the
comm-type field in the configuration data structure (see Neuron Data Book) using
the Write Memory network management message.

Note: If the node’s transceiver does not match the default parameters, writing this
value will prevent the Neuron 3120 Chip from communicating with its transceiver
until after it has been programmed.

3 120 Programmer User’s Guide 4-5

46 Operation
 5
Errors

This chapter describes the error messages reported by the

Neuron 3120 programmer software and provides suggestions
for corrective action.

3 120 Programmer User’s Guide 51

Programmer Errors
Cannot open file: >#ilenamdw

The NP program could not find the file displayed. Check that the file exists in
the path specified on the command line.

Error reading Neumn EPROM image file. E&it.

This error indicates a problem was encountered while reading the Neuron
EEPROM image file. Check that the node hardware type exported from the
LonBuilder or NodeBuilder so&ware is for a Neuron 3120 Chip, and that the
file type was a Neuron EEPROM image file (.NEI extension).

Failure to open device LON)>n<<. Exit.

The NP program could not communicate with the network driver. Check that
the network driver was installed correctly and that the device name (the /D
option) matches the name being used by the NP program. See Loading the
Network Driver in Chapter 3.

Image version number (‘w++) c&E&s with device version number (k<).

Ime d number 6m) conflicts with device model number (&D..).

The file has been exported for either another Neuron Chip model (e.g., a
Neuron 3150 Chip instead of a Neuron 3120 Chip) or firmware version number
and cannot be used with the Neuron 3120 Chip being programmed. Check that
the Neuron model and firmware version number defined in the node’s
hardware properties or hardware template is correct for the device being
programmed.

Invalid file addresses.

Invalid file format: fimt mcord.

Invalid file type.

These errors indicate a problem encountered while reading the Neuron

EEPROM image file. Check that the node hardware type exported from the
LonBuilder or NodeBuilder software is for a Neuron 3120 Chip, and that the
file type was a Neuron EEPROM image file (.NEI extension).

52 Errors
 Neumn Chip mod&Z number in image file is not supported. Exit.

The model number embedded in the file does not correspond to any known
Neuron Chip model numbers.

Neuron 3120 Chip memory write failure,

The Neuron EEPROM has failed, the Neuron 3120 Chip is read/write
protected, or the device required excessive current while writing to EEPROM.
That particular Neuron 3120 Chip should not be used.

Narvn 312oChb socketpower off@&.

The programmer could not turn off power to the Neuron 3120 Chip socket. If
this occurs, remove the Neuron 3120 Chip and press Start again. The
programming step will fail, but the programmer should recover from this
error. Power cycle the programmer with the programmer socket empty. If the
Fail LED remains on, the programmer hardware has failed.

N;etlron 3120 Chip socketpr&ection fdt. Is the chip ins&&d correctly?

The programmer’s internal circuit breaker has shut off power to the socket.
Check that the Neuron 3120 Chip is installed correctly. Pin 1 should be up and
to the left.

Neuvvn 3120 Chip was not appZicatiunZess and failed to change state,

If the Neuron 3120 Chip is not in the applicationless state, the programmer
will attempt to change its state. This message reflects a failure to do so and
may indicate a defective Neuron 3120 Chip.

Noprognunmable Neon 3120 C7iip detected

The programmer could not establish communications with the Neuron 3120
Chip in the socket. Either a Neuron 3120 Chip is not installed or it has failed to
operate correctly.

Programmer command response timeout.

The programmer had established communications with the Neuron 3120

Chip, but subsequent communications have failed. This may indicate a
defective Neuron 3120 Chip.

3 120 Programmer User’s Guide 53

PwP- ammer does not respond.
The NP program is unable to communicate with the 3120 programmer. Check
that all serial link interfaces are correct (cabling, serial bit rate); and that
the programmer is powered up and has passed its self-test. In addition, if the
autobaud hardware setting is enabled (the default), check that the /A flag has
been specified for the network driver as described in Chapter 3.

Promammer has logged an internal error= mu

This is usually due to a self-test failure by the programmer. The

programmer error will be cleared after displaying this message. If the error
reappears, there is a hardware problem with the programmer.

Record read checksum emor.

This error indicates a problem encountered while reading the Neuron

EEPROM image file. Check that the node hardware type exported from the
LonBuilder or NodeBuilder software is for a Neuron 3120 Chip, and that the
file type was a Neuron EEPROM image file (. NEI extension).

13tis Neumn 3210 Chip has a NULL device lD.

The Neuron 3120 Chip being programmed has zeroes in its first five
locations. Do not use this chip.

This Neumn 3120 Chip has a system emr logged= NW

This Neuron 3210 Chip has an application error Zoggedz>,)tcc

The Neuron 3120 Chip being programmed has an internal error logged. This
does not affect the programming of the chip. System errors on a factory
delivered (previously unused) Neuron 3120 Chip may indicate a defective
device. System errors on a used Neuron 3120 Chip are most likely the result of
some prior misuse. Correctly programming the part may clear the error.

Unknown file format.

The file is neither a Motorola ‘S’ nor an Intel Hex format file. Check that the
filename is correct.

Errors