X-Git-Url: https://git.zerfleddert.de/cgi-bin/gitweb.cgi/proxmark3-svn/blobdiff_plain/8691f5b7bbe9138e9a4aa421da9a374536a8b556..f1d7d574283f445310b136a3867f41cb0fde6d88:/COMPILING.txt diff --git a/COMPILING.txt b/COMPILING.txt new file mode 100644 index 00000000..21782e2f --- /dev/null +++ b/COMPILING.txt @@ -0,0 +1,88 @@ +The project compiles on Linux, Mac OS X and Windows (MinGW/MSYS). + +it requires: +- gcc >= 4.4 +- libpthread +- libreadline +- libusb +- perl +- an ARM cross-compiler to compile the firmware + +and optionally QT for the GUI + + +To compile, just run "make". + +=========== += Windows = +=========== +The 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). + +1 - Install QT SDK for Windows [1] + +In the following instructions, we'll assume you installed it to C:\QT + +2 - MSYS-1.0.11 [2] + +Just follow the installation procedure. +When asked if you have MinGW installed and for its path, provide: +C:/QT/mingw + +3 - readline-5.0-1-bin [5] + +From this archive, copy: +bin/* to C:\QT\mingw\bin +include/* to C:\QT\mingw\include +lib/*.a to C:\QT\mingw\lib + +4 - libusb-win32-device-bin-0.1.12.2 [6] + +Be careful here, it is *NOT* working with the filter version! +Likewise copy: +include/usb.h to C:\QT\mingw\include +lib/gcc/libusb.a to C:\QT\mingw\lib + + +5 - Install DevkitPro [5] + +You'll need it to compile the firmware (ARM) side. +You only need devkitARM, nothing more (no extra lib or anything else) +Assuming you installed it to C:\devkitpro, make sure you set +the DEVKITARM environment variable to /c/devkitPro/devkitARM : +export DEVKITARM=/c/devkitPro/devkitARM + +6 - Install Strawberry Perl [6] + +7 - Setup a few variables + +In your shell from MSYS, make sure you set QTDIR to your QT installation: +export QTDIR=/c/QT/qt +And add its bin to your path as well: +export PATH=$PATH:$QTDIR/bin + +Download links: + +[1] http://qt.nokia.com/downloads/sdk-windows-cpp +[2] http://downloads.sourceforge.net/mingw/MSYS-1.0.11.exe +[3] http://sourceforge.net/projects/gnuwin32/files/readline/5.0-1/readline-5.0-1-bin.zip/download +[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 +[5] http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/devkitProUpdater-1.5.0.exe/download +[6] http://strawberry-perl.googlecode.com/files/strawberry-perl-5.10.1.1.msi + +Rather than download and install every one of these packages, a new ProxSpace +environment archive file will be made available for download on the project +page at http://code.google.com/p/proxmark3/downloads/list + +Download the ProxSpace environment archive and extract it to C:\ + +============ += Mac OS X = +============ + +macport stuff should do ;) + +============ += Linux = +============ + +