]> cvs.zerfleddert.de Git - proxmark3-svn/blobdiff - README.md
CHG: @Marshmellow42 's fixes. ref: https://github.com/marshmellow42/proxmark3/commi...
[proxmark3-svn] / README.md
index 5c323dace6eb2e927fe1e742803a6f5e2abb1cc4..d06cdf10492c64d97250881ac48b785ace15daae 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 The iceman fork
 ===============
-[![Build Status](https://travis-ci.org/iceman1001/proxmark3.svg?branch=master)](https://travis-ci.org/iceman1001/proxmark3)  [![Coverity Status](https://scan.coverity.com/projects/5117/badge.svg)](https://scan.coverity.com/projects/proxmark3_iceman_fork)  [![Latest release] (https://img.shields.io/github/release/iceman1001/proxmark3.svg)] (https://github.com/iceman1001/proxmark3/releases/latest)
+[![Build Status](https://travis-ci.org/iceman1001/proxmark3.svg?branch=master)](https://travis-ci.org/iceman1001/proxmark3)  [![Coverity Status](https://scan.coverity.com/projects/5117/badge.svg)](https://scan.coverity.com/projects/proxmark3_iceman_fork)  [![Latest release] (https://img.shields.io/github/release/iceman1001/proxmark3.svg)](https://github.com/iceman1001/proxmark3/releases/latest)
 
 ##This fork is HIGHLY experimental (or bleeding edge)
 
@@ -57,6 +57,22 @@ Among the stuff is
 
 ##Straight from the CHANGELOG
 =============================
+## [1.6.9][icemanfork] [2017-02-06]
+  - Serial speedup,  if possible 408600baud otherwise default to 115200baud (iceman)
+  - `hf emv` - Added Peter Fillmore's EMV branch now compiles on iceman fork.  See seperate issue. (iceman)
+  - `hf 14a reader` - Aztek detection. (iceman)
+  - `standalone mode` - added more detection of tags and refactored (iceman)
+  - `script run ufodump` - dumps an Aztek tag. (iceman)
+  - `script run hard_autopwn` - runs hardnested attack against all sectors on tag (iceman)
+  - Added lf cotag read, and added it to lf search (iceman)
+  - Added hitag2 read UID only and added that to lf search (marshmellow)
+  - `lf search` -  check for if signal is only noice (marshmellow)
+  - `hf 14a reader` - fixed a bug when card has sak 0x00 but still is not UL/NTAG etc. (iceman)
+  - `hf mf sim` / `hf 14a sim` - use random nonce. (micolous)
+  - `hw tune` - only prints out if voltage is detected from antenna. (iceman)
+  - `hf iclass decrypt` - only decrypt Application1 (iceman)
+  - `lf t55xx detect` - when finding multiple possible config blocks, see if a known configblock exists and select. (iceman)
+  
   -  Added `hf mf key_brute` - adds J-Runs 2nd phase bruteforce ref: https://github.com/J-Run/mf_key_brute   (iceman)
   -  Added `lf jablotron` - adds demod/clone/sim of Jablotron LF tags. (iceman)
   -  Added `lf t55xx recoverpw` - adds a new password recovery using bitflips and partial flips if password write went bad. (alexgrin)
@@ -100,9 +116,12 @@ Among the stuff is
   - Fixed the silent mode for 14b to be used inside `hf search` (iceman)
        
 ---    
-Give me a hint, and I'll see if I can't merge in the stuff you have. 
-
+##Why don't you merged with offical PM3 Master?
 I don't actually know how to make small pull-request to github :( and that is the number one reason for me not pushing a lot of things back to the PM3 master.
+Me fiddling with the code so much, there is a nightmare in merging a PR.  Luckily I have @marshmellow42 who takes some stuff and push PR's back.
+
+##Why don't you add nnnn or mmmm functionality?
+Give me a hint, and I'll see if I can't merge in the stuff you have. 
        
 ##PM3 GUI
 I do tend to rename and move stuff around, the official PM3-GUI from Gaucho will not work so well. *sorry*     
@@ -110,36 +129,18 @@ I do tend to rename and move stuff around, the official PM3-GUI from Gaucho will
 ##Development
 This fork now compiles just fine on 
    - Windows/mingw environment with Qt5.6.1 & GCC 4.8
-   - Ubuntuu 1404, 1510
-   - Mac OS X  (or before the hardnested BF solver at least)
+   - Ubuntu 1404, 1510, 1604
+   - Mac OS X
 
 ##Setup and build for UBUNTU
-GC made updates to allow this to build easily on Ubuntu 14.04.2 LTS or 15.10
+GC made updates to allow this to build easily on Ubuntu 14.04.2 LTS, 15.10 or 16.04
 See https://github.com/Proxmark/proxmark3/wiki/Ubuntu%20Linux
 
-- Run          
-`sudo apt-get install p7zip git build-essential libreadline5 libreadline-dev libusb-0.1-4 libusb-dev libqt4-dev perl pkg-config wget libncurses5-dev`
-       
-Follow these instructions
-Get devkitARM release 41 from SourceForge (choose either the 64/32 bit depending on your architecture, it is assumed you know how to check and recognize your architecture):
-
-(64-bit) http://sourceforge.net/projects/devkitpro/files/devkitARM/previous/devkitARM_r41-x86_64-linux.tar.bz2/download
-(32-bit) http://sourceforge.net/projects/devkitpro/files/devkitARM/previous/devkitARM_r41-i686-linux.tar.bz2/download
-
-- Extract the contents of the .tar.bz2 
-`tar jxvf devkitARM_r41-<arch>-linux.tar.bz2`
+A nice and cool install script made by @daveio is found here: 
+https://github.com/daveio/attacksurface/blob/master/proxmark3/pm3-setup.sh
 
-- Create a directory for the arm dev kit       
-`sudo mkdir -p /opt/devkitpro/`
-
-- Move the ARM developer kit to the newly created directory    
-`sudo mv devkitARM /opt/devkitpro/`
-
-- Add the appropriate environment variable             
-`export PATH=${PATH}:/opt/devkitpro/devkitARM/bin/`
-
-- Add the environment variable to your profile 
-`echo 'PATH=${PATH}:/opt/devkitpro/devkitARM/bin/ ' >> ~/.bashrc`
+- Run          
+`sudo apt-get install p7zip git build-essential libreadline5 libreadline-dev libusb-0.1-4 libusb-dev libqt4-dev perl pkg-config wget libncurses5-dev gcc-arm-none-eabi`
 
 - Clone iceman fork            
 `git clone https://github.com/iceman1001/proxmark3.git`
@@ -147,7 +148,13 @@ Get devkitARM release 41 from SourceForge (choose either the 64/32 bit depending
 - Get the latest commits       
 `git pull`
 
-- CLEAN COMPILE                
+- Install the blacklist rules  
+`make udev`
+
+- add user to dialout group (if you on a Linux/ubuntu/debian). If you do this one, you need to logout and login in again to make sure your rights got changed. 
+`sudo adduser $USER dialout`
+
+- Clean and complete compilation       
 `make clean && make all`
        
 - Flash the BOOTROM            
@@ -180,8 +187,7 @@ Follow those instructions to get it up and running.  No need for the old proxspa
 [1.6.0] How to connect: https://youtu.be/0ZS2t5C-caI
 [1.6.1] How to flash:   https://www.youtube.com/watch?v=WXouhuGYEiw
 
-Recommendations:
-Use only container tag [1.6.4]
+Recommendations:  Use only latest container.
 
 
 ## Building on Windows
@@ -205,15 +211,15 @@ Follow the installation procedure, you may want to install MSYS to `C:\Qt\msys`
 ### 3. Readline
 Download and unpack: https://sourceforge.net/projects/gnuwin32/files/readline/5.0-1/readline-5.0-1-bin.zip/download            
 
-`bin/*` to `C:\Qt\5.6\Tools\mingw49_32\bin`            
-`include/*` to `C:\Qt\5.6\Tools\mingw49_32\include`            
-`lib/*` to `C:\Qt\5.6\Tools\mingw49_32\lib`
+`bin/*` to `C:\Qt\5.6\Tools\mingw492_32\bin`           
+`include/*` to `C:\Qt\5.6\Tools\mingw492_32\include`           
+`lib/*` to `C:\Qt\5.6\Tools\mingw492_32\lib`
 
 ### 4. LibUSB
 Download and unpack: https://sourceforge.net/projects/libusb-win32/files/latest/download?source=files
 
-`include/lusb0_usb.h` to `C:\Qt\5.6\Tools\mingw49_32\include`          
-`lib/gcc/libusb.a` to `C:\Qt\5.6\Tools\mingw49_32\lib`
+`include/lusb0_usb.h` to `C:\Qt\5.6\Tools\mingw492_32\include`         
+`lib/gcc/libusb.a` to `C:\Qt\5.6\Tools\mingw492_32\lib`
 
 ### 5. DevkitPro
 Download and install: https://sourceforge.net/projects/devkitpro/files/latest/download?source=files
@@ -222,7 +228,10 @@ You only need devkitARM, nothing more (no extra lib or anything else) to compile
 `export DEVKITARM=/c/devkitPro/devkitARM`              
 `export PATH=$PATH:$DEVKITARM/bin`
 
-### 6. Build and run
+### 6. Install Strawberry Perl
+Download and install: https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/strawberry-perl/strawberry-perl-5.10.1.3.msi
+
+### 7. Build and run
 Download and install Git for Windows: https://git-scm.com/download/win
 
 - Run minimal system: `C:\Qt\msys\msys.bat`
Impressum, Datenschutz