####################################################################################### ## Native WIN32 setup and build instructions (on mingw32/Windows): ## #######################################################################################

*************************************************************************************** Introduction ***************************************************************************************The following instructions have been tested on both Windows 7 and Windows XP.Most of what is described below (copying files, downloading files, etc.) can be donedirectly in the MinGW MSYS shell; these instructions do not do so because packageversions and links change over time. The best way is to use your browser, go to thelinks directly, and see for yourself which versions you want to install.Winrar was used to do the extracting of archive files in the making of this guide.

If you think that this documentation was helpful and you wish to donate, you cando so at the following address. 12KaKtrK52iQjPdtsJq7fJ7smC32tXWbWr

*************************************************************************************** A tip that might help you along the way ***************************************************************************************Enable "QuickEdit Mode" in your Command Prompt Window or MinGW Command PromptWindow (No need to go into the context menu to choose edit-mark/copy/paste):Right-click on the title bar and click Properties. Under the Options tab, checkthe box for "QuickEdit Mode". Alternately, if you want this change to bepermanent on all of your Command Prompt Windows; you can click Defaults insteadof Properties as described above. Now you can drag and select text you want tocopy, right-click to copy the text to the clipboard and right-click once again topaste it at the desired location. You could for example, copy some text from thisdocument to the clipboard and right click in your Command Prompt Window to pastewhat you copied.

*************************************************************************************** Install mingw32 ***************************************************************************************Go to this url ==> http://www.mingw.org/wiki/Getting_StartedClick the link that says "Download and run the latest mingw-get-inst version."Download and run the latest file. Install MinGW in the default directory.(I downloaded the one labeled "mingw-get-inst-20120426" - note that this could

be a different version later.)Make sure to check the option for "Download latest repository catalogs".I just selected all the check boxes (excluding "Fortran Compiler") so that everythingwas installed.

*************************************************************************************** Run the MSYS shell for the first time to create your user directory ***************************************************************************************(Start Icon/keyboard key ==> All Programs ==> MinGW ==> MinGW Shell).This will create your user directory for you.

*************************************************************************************** Install libpdcurses ***************************************************************************************Type the lines below to install libpdcurses.mingw-get install mingw32-libpdcursesmingw-get install mingw32-pdcursesCtrl-D or typing "logout" and pressing the enter key should get you out of thewindow.

*************************************************************************************** Copy CGMiner source to your MSYS working directory ***************************************************************************************Copy CGMiner source code directory into:\MinGW\msys\1.0\home\(folder with your user name)

*************************************************************************************** Install AMD APP SDK, latest version (only if you want GPU mining) ***************************************************************************************Note: You do not need to install the AMD APP SDK if you are only using Nvidia GPU'sGo to this url for the latest AMD APP SDK: http://developer.amd.com/tools/heterogeneous-computing/amd-accelerated-parallel-processing-app-sdk/downloads/Go to this url for legacy AMD APP SDK's: http://developer.amd.com/tools/heterogeneous-computing/amd-accelerated-parallel-processing-app-sdk/downloads/download-archive/Download and install whichever version you like best.Copy the folders in \Program Files (x86)\AMD APP\include to \MinGW\includeCopy \Program Files (x86)\AMD APP\lib\x86\libOpenCL.a to \MinGW\libNote: If you are on a 32 bit version of windows "Program Files (x86)" will be"Program Files".Note2: If you update your APP SDK later you might want to recopy the above files

*************************************************************************************** Install AMD ADL SDK, latest version (only if you want GPU monitoring)

***************************************************************************************Note: You do not need to install the AMD ADL SDK if you are only using Nvidia GPU'sGo to this url ==> http://developer.amd.com/tools/graphics-development/display-library-adl-sdk/Download and unzip the file you downloaded.Pull adl_defines.h, adl_sdk.h, and adl_structures.h out of the include folderPut those files into the ADL_SDK folder in your source tree as shown below.\MinGW\msys\1.0\home\(folder with your user name)\cgminer-x.x.x\ADL_SDK

*************************************************************************************** Install GTK-WIN, required for Pkg-config in the next step ***************************************************************************************Go to this url ==> http://sourceforge.net/projects/gtk-win/Download the file.After you have downloaded the file Double click/run it and this will install GTK+I chose all the selection boxes when I installed.Copy libglib-2.0-0.dll and intl.dll from \Program Files (x86)\gtk2-runtime\bin to\MinGW\binNote: If you are on a 32 bit version of windows "Program Files (x86)" will be"Program Files".

*************************************************************************************** Install pkg-config ***************************************************************************************Go to this url ==> http://www.gtk.org/download/win32.phpScroll down to where it shows pkg-cfg.Download the file from the tool link. Extract "pkg-config.exe" from bin and place inyour \MinGW\bin directory.Download the file from the "Dev" link. Extract "pkg.m4" from share\aclocal and placein your \MingW\share\aclocal directory.

*************************************************************************************** Install libcurl ***************************************************************************************Go to this url ==> http://curl.haxx.se/download.html#Win32At the section where it says "Win32 - Generic", Click on the link that indicatesWin32 2000.XP 7.27.0 libcurl SSL and download it.The one I downloaded may not be current for you. Choose the latest.Extract the files that are in the zip (bin, include, and lib) to their respectivelocations in MinGW (\MinGW\bin, \MinGW\include, and \MinGW\lib).Edit the file \MinGW\lib\pkgconfig\libcurl.pc and change "-lcurl" to"-lcurl -lcurldll".Ref. http://old.nabble.com/gcc-working-with-libcurl-td20506927.html

*************************************************************************************** Build cgminer.exe ***************************************************************************************Run the MinGW MSYS shell(Start Icon/keyboard key ==> All Programs ==> MinGW ==> MinGW Shell).Change the working directory to your CGMiner project folder.Example: cd cgminer-2.1.2 [Enter Key] if you are unsure then type "ls -la"Another way is to type "cd cg" and then press the tab key; It will auto fill.Type the lines below one at a time. Look for problems after each one before going onto the next.

adl.sh (optional - see below) autoreconf -fvi CFLAGS="-O2 -msse2" ./configure (additional config options, see below) make strip cgminer.exe <== only do this if you are not compiling for debugging

*************************************************************************************** Copy files to a build directory/folder ***************************************************************************************Make a directory and copy the following files into it. This will be your CGMinerFolder that you use for mining. Remember the .cl filenames could change on laterreleases. If you installed a different version of libcurl then some of those dll'smay be different as well. cgminer.exe from \MinGW\msys\1.0\home\(username)\cgminer-x.x.x *.cl from \MinGW\msys\1.0\home\(username)\cgminer-x.x.x README from \MinGW\msys\1.0\home\(username)\cgminer-x.x.x libcurl.dll from \MinGW\bin libidn-11.dll from \MinGW\bin libeay32.dll from \MinGW\bin ssleay32.dll from \MinGW\bin libpdcurses.dll from \MinGW\bin pthreadGC2.dll from \MinGW\bin

*************************************************************************************** Optional - Install Git into MinGW/MSYS ***************************************************************************************Go to this url ==> http://code.google.com/p/msysgit/Click on the Downloads tab.Download the latest "Portable" git archive.Extract the git*.exe files from the bin folder and put them into \MinGW\bin.Extract the share\git-core folder and place it into \MinGW\share.After the previous step you should have a folder called \MinGW\share\git-core.To test if it is working, open a MinGW shell and type the following: git config -�global core.autocrlf false (note: one time run only) git clone git://github.com/ckolivas/cgminer.git

If you simply just want to update the source after you have already cloned, type

: git pull"git pull" did not work for me. Try the following which does the same thing: git fetch && git merge FETCH_HEAD

Now you can get the latest source directly from github.

*************************************************************************************** Optional - Make a .sh file to automate copying over ADL files ***************************************************************************************Make a folder/directory in your home folder and name it ADL_SDK. (ref: \MinGW\msys\1.0\home\(folder with your user name)\ADL_SDK)Copy the ADL .h files into that folder/directory.Open your favorite text editor and type the following into it. cp -av ../ADL_SDK/*.h ADL_SDKSave the file as "adl.sh" and then place the file into "\MinGW\msys\1.0\bin".From now on when your current working directory is the cgminer source directoryYou can simply type "adl.sh" and it will place the ADL header files into placeFor you. Make sure you never remove the ADL_SDK folder from your home folder.

*************************************************************************************** Optional - Install libusb if you need auto USB device detection; required for Ztex ***************************************************************************************Go to this url ==> http://git.libusb.org/?p=libusb.git;a=snapshot;h=master;sf=zipsave the file to your local storage. Open the file and copy the libusb* folder to\MinGW\msys\1.0\home\(your user directory/folder).Or if you do not want to download the file directly and would like to use git thenType the following from the MSYS shell in your home folder.git clone git://git.libusb.org/libusb.git

Run the MinGW MSYS shell(Start Icon/keyboard key ==> All Programs ==> MinGW ==> MinGW Shell).Change the working directory to your libusb project folder.Example: cd libusb-something [Enter Key] if you are unsure then type "ls -la"Another way is to type "cd libusb" and then press the tab key; It will auto fill.Type the lines below one at a time. Look for problems after each one before going onto the next.

./autogen.sh --disable-debug-log --prefix=/MinGWmakemake install

You may now exit the MSYS shell.Ctrl-D or typing "logout" and pressing the enter key should get you out of thewindow.

You will have to copy "libusb-1.0.dll" to your working cgminer binary directory.You will find "libusb-1.0.dll" in the \MinGW\bin directory/folder.

Use this method if libusb does not work for you on Ztex. Once someone lets us knowLibusb works instead of libusbx then we will remove the section below this line.Run the MSYS shell and change into the libusb folder as above.Type ==> make uninstallGo to this url ==> http://libusbx.org/Click on the "Downloads" tab.Click on "releases".Click on the latest version. I downloaded 1.0.14; yours may be newer.Do not download from the link that says "Looking for the latest version?".Click on "Windows"Click on the file and download it. I downloaded libusbx-1.0.12-win.7z.Extract the the following from the file and place in where directed.Copy libusb.h from include\libusbx-1.0 to \MinGW\include\libusb-1.0\libusb.hCopy contents of MinGW32\static \MinGW\libCopy contents of MinGW32\dll to \MinGW\libYou will have to copy "libusb-1.0.dll" to your working cgminer binary directory.

*************************************************************************************** Some ./configure options ***************************************************************************************--enable-cpumining Build with cpu mining support(default disabled)--disable-opencl Override detection and disable building with opencl--disable-adl Override detection and disable building with adl--enable-bitforce Compile support for BitForce FPGAs(default disabled)--enable-icarus Compile support for Icarus Board(default disabled)--enable-modminer Compile support for ModMiner FPGAs(default disabled)--enable-ztex Compile support for Ztex Board(default disabled)--enable-scrypt Compile support for scrypt litecoin mining (default disabled)--without-curses Compile support for curses TUI (default enabled)--without-libudev Autodetect FPGAs using libudev (default enabled)

####################################################################################### ## Native WIN32 setup and build instructions (on mingw32/Windows) complete ## #######################################################################################