Fix QT compilation for Windows/MinGW and update the compilation instructions accordingly.
[proxmark3-svn] / COMPILING
CommitLineData
9cc7c4b4 1The project compiles on Linux, Mac OS X and Windows (MinGW/MSYS).
4cd41f34 2
3it requires:
9cc7c4b4 4- gcc >= 4.4
4cd41f34 5- libpthread
6- libreadline
7- libusb
9cc7c4b4 8- perl
9- an ARM cross-compiler to compile the firmware
4cd41f34 10
9cc7c4b4 11and optionally QT for the GUI
4cd41f34 12
13
14To compile, just run "make".
15
13bb3b4b 16===========
17= Windows =
18===========
19The following is a complete list of packages required to setup the compile environment yourself. Alternatively you can download an archive of the full environment (see below).
20
211 - Install QT SDK for Windows [1]
22
23In the following instructions, we'll assume you installed it to C:\QT
24
252 - MSYS-1.0.11 [2]
26
27Just follow the installation procedure.
28When asked if you have MinGW installed and for its path, provide:
29C:/QT/mingw
30
313 - readline-5.0-1-bin [5]
32
33From this archive, copy:
34bin/* to C:\QT\mingw\bin
35include/* to C:\QT\mingw\include
36lib/*.a to C:\QT\mingw\lib
37
384 - libusb-win32-device-bin-0.1.12.2 [6]
39
40Be careful here, it is *NOT* working with the filter version!
41Likewise copy:
42include/usb.h to C:\QT\mingw\include
43lib/gcc/libusb.a to C:\QT\mingw\lib
44
9cc7c4b4 45
465 - Install DevkitPro [5]
47
48You'll need it to compile the firmware (ARM) side.
49You only need devkitARM, nothing more (no extra lib or anything else)
50Assuming you installed it to C:\devkitpro, make sure you set
51the DEVKITARM environment variable to /c/devkitPro/devkitARM :
52export DEVKITARM=/c/devkitPro/devkitARM
53
546 - Install Strawberry Perl [6]
55
8691f5b7 567 - Setup a few variables
57
58In your shell from MSYS, make sure you set QTDIR to your QT installation:
59export QTDIR=/c/QT/qt
60And add its bin to your path as well:
61export PATH=$PATH:$QTDIR/bin
62
13bb3b4b 63Download links:
64
65[1] http://qt.nokia.com/downloads/sdk-windows-cpp
66[2] http://downloads.sourceforge.net/mingw/MSYS-1.0.11.exe
67[3] http://sourceforge.net/projects/gnuwin32/files/readline/5.0-1/readline-5.0-1-bin.zip/download
68[4] 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
9cc7c4b4 69[5] http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/devkitProUpdater-1.5.0.exe/download
70[6] http://strawberry-perl.googlecode.com/files/strawberry-perl-5.10.1.1.msi
b97a3d99 71
72de52ee 72Rather than download and install every one of these packages, a new ProxSpace
73environment archive file will be made available for download on the project
74page at http://code.google.com/p/proxmark3/downloads/list
b97a3d99 75
13bb3b4b 76Download the ProxSpace environment archive and extract it to C:\
4cd41f34 77
78============
79= Mac OS X =
80============
81
82macport stuff should do ;)
83
84============
85= Linux =
86============
87
88
Impressum, Datenschutz