git.zerfleddert.de Git - proxmark3-svn/blame_incremental

... / ...

Commit	Line	Data
	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	Download MSYS from http://downloads.sourceforge.net/mingw/MSYS-1.0.11.exe
	66	Run it and just follow the defaults. A post install configuration screen
	67	will come up asking you some questions, answer yes to continue, then yes
	68	to having MinGW installed then enter the path to the MinGW installation.
	69	I believe it needs unix slashes so use c:/blah/
	70
	71	Manually add the MSYS bin directory to you system path.
	72
	73	You can now run 0setpath.bat and 3makewin.bat in the cockpit and have the
	74	client compiled.
	75
	76	============
	77	= Mac OS X =
	78	============
	79
	80	macport stuff should do ;)
	81
	82	============
	83	= Linux =
	84	============
	85
	86