User`s guide

108
K
A
DAK
KwikNet System Construction
Creating the KwikNet Library
The KwikNet Library must be constructed from within directory MAKE in the KwikNet
installation directory. Your Network Parameter File, say NETCFG.UP, and your Library
Make File, say NETCFG.MAK, must be present in the KwikNet MAKE directory.
All of the compilers and librarians used at KADAK were tested on a Windows
®
workstation running Windows NT, 2000 and XP. However, you can build the library
using any recent version of Windows, provided that your software development tools
operate on that platform.
To create the
KwikNet Library, proceed as follows. From the Windows Start menu,
choose the MS-DOS Command Prompt from the Programs folder. Make the KwikNet
installation KNTnnn\MAKE directory the current directory.
To use Microsoft's NMAKE utility, issue the following command.
NMAKE -fNETCFG.MAK "TOOLSET=XXX" "TRKPATH=treckpath"
"OSPATH=yourospath" "KPF=NETCFG.UP" "AMX4ARM=ARM"
The make symbol TOOLSET is defined to be the toolset mnemonic XXX used by KADAK
to identify the software tools which you are using.
The symbol TRKPATH is defined to be the string treckpath, the full path (or the path
relative to directory KNTnnn\MAKE) to your Turbo Treck TCP/IP installation directory.
The symbol OSPATH is defined to be the string yourospath, the full path (or the path
relative to directory KNTnnn\MAKE) to the directory containing your RT/OS components
(header files, libraries and/or object modules). When using AMX, string yourospath is
the path to your AMX installation directory.
The make symbol KPF is defined to identify the name of the Network Parameter File
NETCFG.UP from which the KwikNet Library Make File NETCFG.MAK was generated. Both
of these files must be present in the KwikNet MAKE directory.
For example, assume that the Turbo Treck TCP/IP release from Treck Inc. has been
installed in directory C:\TRECK and that AMX 4-Thumb (part number PN422-1) has been
installed in directory
C:\KADAK\AMX422. Then, to build the KwikNet Library using
Microsoft's NMAKE utility and Metrowerks tools, issue the following command.
NMAKE -fNETCFG.MAK "TOOLSET=ME" "TRKPATH=C:\TRECK"
"OSPATH=C:\KADAK\AMX422" "KPF=NETCFG.UP"
Note that the extra make symbol definition string "AMX4ARM=ARM" is only appended to the
make command line if you are using AMX 4-ARM (PN402-1).
By default, the KwikNet Library will be created in toolset dependent directory
TOOLXXX\LIB. You can force the libraries to be created elsewhere by defining symbol
NETLIB=libpath on the make command line. The string libpath is the full path (or the
path relative to directory KNTnnn\MAKE) to the directory in which you wish the library to
be created. You must copy the library specification file
KNnnnIP.LBM from toolset XXX
directory TOOLXXX\LIB to your alternate library directory libpath.