Echelon Neuron C - Manual (Page 229)

Neuron C Programmer’s Guide 217
EEPROM, respectively. The -Z switch is used to specify the last page of ROM
(there is no corresponding switch for the first page of ROM, because ROM must
start at 0x0000). Do not use the switches for any area that has no external
memory. Memory mapped I/O areas should not be specified, and should be
outside the range of any external memory areas which are specified.
For example, a link that has external ROM from 0x0000 to 0x7FFF, no external
EEPROM, external memory-mapped I/O devices from 0x8000 to 0x97FF, and
external RAM from 0x9800 to 0x9FFF, uses the switches shown below:
C:\>nld –Z=7F –r=98 –R=9F ....
The linker must input a symbol table corresponding to the system image for
which the application is being linked. This is done using the -p switch, followed
by a space, then the pathname of the image's symbol file.
For example, if linking for a 3150 custom device, the image name is SYS3150.
Assume that the Neuron C software is installed in the C:\LonWorks directory.
This main directory contains a number of subdirectories. The IMAGES
subdirectory contains one or more further subdirectories named VER nnn , where
nnn is a number from 2-255 (no leading zeros).
The standard image files are contained in the various VER nnn subdirectories.
For example, if the software is installed in C:\LonWorks (the default), then the
switch that links to firmware version 7 would be the following:
C:\>NLD -p C:\LonWorks\IMAGES\VER7\SYS3150.SYM ....
The above switches are the minimum set of required switches for the Neuron
Linker.
You can specify an output file different from the default with the -o switch. The
default output file name is the name (without extension) of the first object file in
the link command line.
You can use the -A switch to specify that EEPROM is to be implemented using
flash memory as an alternative to EEPROM. The sector size (64 or 128) of the
flash memory device must follow the -A switch.
You can include libraries in the link by specifying one or more instances of the -l
switch, with a library name following. You can link to multiple libraries by
specifying an -l switch for each library.
If you are using the NodeBuilder Development Tool, refer to the
NodeBuilder FX
User's Guide for details about the use of libraries within a NodeBuilder project.
The NodeBuilder tool does not support the construction of custom libraries except
through the stand-alone tools as documented in Appendix B, but it does allow for
their use.
See
Neuron Librarian on page 219, as well as Appendix B, Neuron C Function
Libraries , on page 221, for more about the construction of custom libraries.
Neuron Exporter
The Neuron exporter is named nex.exe. The exporter takes input from the
compiler and the linker and produces the device file set. The device file set
contains the device interface files (.xif and .xfb extensions) as well as image files
(.nri, .nfi, .nxe, .nei, .nme, .nmf, and .apb extensions, as needed).