Installing Khepera cross compiler under Win98/NT ================================================ (this has *not* been tested under Win95) You can build the system from source code, or from pre-built binaries. For source-code instructions look in the ./BuildFromSource subdirectory. Required files: ------------------------ - the Cygwin Beta 20.1 full binary executable a download site can be found at http://sourceware.cygnus.com/cygwin/ look under the /latest/ subdirectory and download "full.exe" This is also available for download from K-Team under the name "cygwin_b201.exe" - an updated cygwin DLL (at the time of writing it was cygwin1-19990115.dll) from the most recent snapshot directory on the Cygnus site This is also available for download from K-Team. - one of the K-Team libraries available for download from K-team: - Khepera khepack5 libraries (khepack5.tar.gz) - Koala koapack2 libraries (koapack2.tar.gz) - Kameleon kampack1 libraries (kampack1.tar.gz) - Cross compiler pre-built binaries available for download from K-Team. There are three packages available: - Kcross_minimal.tar.gz contains the essential compiler files - Kcross_with-more-stuff.tar.gz adds two useful utilites: m68k-none-aout-ar.exe and m68k-none-aout-objcopy.exe - Kcross_with-all-compiler-tools.tar.gz includes all the compiler utilities NOTE on extraction: although WinZip does extract .tar.gz files fine, it will *not* create empty directories that exist in the archive. This can cause problems if a program is expecting an empty directory to exist. To be safe, once cygwin is installed, you can move the .tar.gz file to the desired directory, and then run: % tar -xzf file.tar.gz NOTE on editing files. All distribution files are in UNIX format. Do *not* use Notepad to edit, because it doesn't recognize this and the formatting will be all bizarre. Use Wordpad or another editor. Saving the files in DOS format (as WordPad does) does not seem to harm anything. Installation using pre-built binaries: ------------------------------------------------------------------------- - create C:\tmp and C:\bin directories (required by Cygwin) - run Cygwin package (.exe file), and install it under the default C:\cygnus (if you try another directory name you may have problems later) - back up existing C:\Cygnus\cygwin-b20\H-i586-cygwin32\bin\cygwin1.dll and replace it with the new cygwin DLL (renamed to cygwin1.dll) - in the same directory: back up sh.exe to sh.backup.exe, for example copy bash.exe to sh.exe, so that bash.exe and sh.exe are identical copy both bash.exe and the new sh.exe to the c:\bin directory This is necessary due to a bug in the "light Bourne shell" - run Cygwin using the "Cygwin B20" Start menu shortcut under "Cygnus Solutions" If you get an "insufficient environment space" message, add the following to your config.sys and reboot: shell=c:\command.com /e:4096 /p - make the final directory for the cross-compiler. Here we assume C:\gcc - extract Kcross.tar.gz to the C:\gcc directory - now add /gcc/bin to the path. Either: at the command line in Cygwin: export PATH=$PATH:/gcc/bin or (better) edit C:\cygnus\cygwin-b20\cygnus.bat and add the line: SET PATH=c:\gcc\bin;%PATH% then exit the bash shell and restart it. Now test to see if this works: - extract khepack5 or kampack1 tarfile into any directory (here we assume c:\k-team) - go into C:\k-team\khepack5\examples or C:\k-team\kampack1\examples edit the Makefile to set your path (cross_gnu_prefix=/k-team), then % make all - the compiler should run without problems, creating a series of .s37 binary files in the bin/ subdirectory. If you get an error "could not open output file bin/test.s37", you may have used WinZip to extract the khepack archive, which will not create empty directories. Simply create the subdirectory bin/ from the commandline (e.g. % mkdir bin) and then run "make all" again.