git.zerfleddert.de Git - proxmark3-svn/blob - client/COMPILING

   1 The client compiles on Linux, Mac OS X and Windows (MinGW/MSYS).
   2
   3 it requires:
   4 - gcc
   5 - libpthread
   6 - libreadline
   7 - libusb
   8
   9 and optionally libQT
  10
  11
  12 To compile, just run "make".
  13
  14 ==========
  15 = MingGW =
  16 ==========
  17 It is known to work using:
  18 - MingW 5.1.6
  19 - MSYS 1.0.11
  20 - libpthread 2.8.0 (from MinGW or directly from pthread-win32)
  21 - readline 5.0 from gnuwin32
  22 - libusb-win32-device-bin-0.1.12.2
  23   Be careful here, it is *NOT* working with the filter version!
  24   You have to use the device version and use the inf-wizard
  25   to create a driver for your proxmark and install it.
  26
  27 Setting up the Windows "client folder" compile environment.
  28
  29 Download MinGW-5.1.6.exe from http://sourceforge.net/projects/mingw/files/
  30
  31 Run it, click next, leave "Download and Install" selected, click next
  32 Agree to license, leave "Current" selected, click next
  33 Select "MinGW base" and "MinGW make", click next
  34 Select installation folder, click next, Install, click next and finish.
  35
  36 CAUTION! When extracting the downloaded archives further down in this guide,
  37 make sure that the contents of the archive directories go into the MinGW
  38 installation directories, eg archive bin goes to MinGW bin, archive lib to
  39 MinGW lib, etc, otherwise if the archive extracts into it's own subdirecory
  40 the paths to the files will be all wrong.
  41
  42 You should now have the base MinGW installed in whatever installation folder
  43 you selected earlier. By default it installs GCC 3.4.5 so if you want to
  44 go to GCC 4.4 go back to http://sourceforge.net/projects/mingw/files/ and
  45 download gcc-full-4.4.0-mingw32-bin-2.tar which includes the ADA, Fortran,
  46 Java, etc compilers as well, but it is by far the easiest for newbees to
  47 download and install as it already includes pthreads and a few other
  48 libraries/dlls required by the GCC compiler.
  49
  50 After download, extract it into the MinGW installation directory, see
  51 caution note above.
  52
  53 Download readline from http://sourceforge.net/projects/gnuwin32/files/readline/5.0-1/readline-5.0-1-bin.zip/download
  54 Extract it into the MinGW installation directory, see caution note above.
  55
  56 Download http://sourceforge.net/projects/libusb-win32/files/libusb-win32-releases/0.1.12.2/libusb-win32-device-bin-0.1.12.2.tar.gz/download
  57 Extract it into the MinGW installation directory, see caution note above.
  58
  59 By default, the installer should have set your system path to the MinGW
  60 installation \bin directory, verify this by opening a command prompt and
  61 typing "gcc -v". You should get some text output indicating the version of
  62 your GCC compiler (either 3.4.5 or 4.4 depending on what you installed).
  63 If you get "unrecognized command", you must set the path manually.
  64
  65 You can now run 0setpath.bat and 3makewin.bat in the cockpit and have the
  66 client compiled. During compilation you will see some CreateProcess failed
  67 and some "system cannot find the path specified" messages, however the
  68 compile will succeed and you will have some .exe files. The error messages
  69 relate to the fact that windows doesn't have the uname command, and possibly
  70 some other makefile related stuff following the recent changes.
  71
  72 ============
  73 = Mac OS X =
  74 ============
  75
  76 macport stuff should do ;)
  77
  78 ============
  79 =   Linux  =
  80 ============
  81
  82