====== Hints for Windows users ======

Both compilers which are used for building firmware (sdcc for FX2 and gcc for FX3) come from the Unix-world. They have been ported to
Windows but unfortunately Windows is a quite unfriendly environment for such programs. Some SDK's hide this behind an IDE (e.g. the Cypress FX3 SDK is delivered with Eclipse). ZTEX does no go this way.

The building rules of the ZTEX SDK are described by platform and IDE independent Makfiles. This tutorial gives you some hints for setting up the development environment and describes how the SDK can be integrated into an IDE.
===== Hints =====
  * It is recommended to use the [[https://sourceforge.net/projects/msys2|MSYS/MINGW]] environment
  * make is not a part of the installation and has to be installed using the command <code>
pacman -S msys/make</code>
  * the Midnight Commander is strognly recommended in order to browse through the directories, edit files and create symlinks.
    * Installation command is <code>pacman -S msys/mc</code>
    * The program is started using command <code>mc</code>
    * On order to change drive, e.g. to to drive c:, enter <code>cd /c/</code>
    * Files can be edited by pressing F4
    * Symlinks can be created by Ctrl+x s
  * Some installation paths have to be set up in ''Makfile.conf'', see [[en:software:tutorial_compiling]]. Spaces and other odd signs in directory names cause a lot of trouble. In order to prevent this, create a few symlinks without spaces, e.g. link the installation directory of the Cypress FX3 SDK to ''/c/cypress'' (= ''c:\cypress'') 
  * MSYS/MinGW can also be used to build the C host software examples:
    * ''libusb-1.0'' and ''gcc'' are required: <code>pacman -S mingw64/mingw-w64-x86_64-gcc mingw64/mingw-w64-x86_64-libusb</code> for 64 Bit binaries or  <code>pacman -S mingw32/mingw-w64-i686-gcc mingw32/mingw-w64-i686-libusb</code> for 32 Bit binaries
    * Open MinGW64/MinGW32 environment (not just MSYS), got to the project directory and call ''make''


===== IDE integration =====
  - Follow the steps in [[tutorial_compiling]]
  - find ''sh.exe'' or ''bash.exe'' of your MSys(2) Installation. Both shells work. On the test system it is ''c:\mingw\msys\1.0\bin\bash.exe'' and the SDK is installed in ''s:\ztex''
  - In order to build a target using the Makefile rules: <code>c:\mingw\msys\1.0\bin\bash -l -c "make -C /s/ztex/examples/memfifo [<target>]"</code> This builds a target of the memfifo example in ''examples/memfifo''. Typical targets are ''all'', ''img'', ''ihx'', ''jar'', ''claen'' or ''distclean'', see  [[en:software:compilation:compilation#makefiles]]

Java host software can be compiled and executed without GNU tools. Just the class and JNI library location (in the example above: ''s:\ztex\java\java'' and ''s:\ztex\usb4java'') has to be added to the ''CLASSPATH'' environment variable.

{{indexmenu_n>6500}}