]>
Commit | Line | Data |
---|---|---|
02b6f355 | 1 | The iceman fork |
2 | --------------- | |
6063655a | 3 | ##::THIS FORK IS HIGHLY EXPERIMENTAL:: |
02b6f355 | 4 | |
6063655a | 5 | ##NOTICE: |
02b6f355 | 6 | |
6063655a | 7 | There is so much in this fork, with all fixes and additions its basically the most enhanced fork to this day for the Proxmark3 device. |
c0bab227 | 8 | |
6063655a | 9 | |
10 | ##OFFICAL | |
02b6f355 | 11 | The official Proxmark repository is found here: https://github.com/Proxmark/proxmark3 |
12 | ||
6063655a | 13 | ##NEWS: |
02b6f355 | 14 | |
02b6f355 | 15 | ## Build Status Travis CI |
16 | [![Build Status](https://travis-ci.org/iceman1001/proxmark3.svg?branch=master)](https://travis-ci.org/iceman1001/proxmark3) | |
17 | ||
18 | ## Build Status Coverity Scan | |
19 | [![Coverity Scan Build Status](https://scan.coverity.com/projects/5117/badge.svg)](https://scan.coverity.com/projects/proxmark3-iceman-fork) | |
20 | ||
21 | ||
b112787d | 22 | ## Coverity Scan Config && Run |
23 | ||
24 | Download the Coverity Scan Self-buld and install it. | |
25 | You will need to configure ARM-NON-EABI- Compiler for it to use: | |
26 | ||
27 | :: Configure | |
28 | cov-configure --comptype gcc --compiler /opt/devkitpro/devkitARM/bin/arm-none-eabi-gcc | |
29 | ||
30 | ::run it (I'm running on Ubuntu) | |
c0bab227 | 31 | cov-build --dir cov-int make all |
b112787d | 32 | |
33 | :: make a tarball | |
34 | tar czvf proxmark3.tgz cov-int | |
35 | ||
36 | :: upload it to coverity.com | |
37 | ||
38 | ## Whats changed? | |
39 | ||
6063655a | 40 | Whats so special with this fork? I have scraped the web for different enhancements to the PM3 source code and not all of them ever found their way to the master branch. |
02b6f355 | 41 | Among the stuff is |
42 | ||
43 | * Jonor's hf 14a raw timing patch | |
44 | * Piwi's updates. (usually gets into the master) | |
45 | * Piwi's "topaz" branch | |
46 | * Piwi's "hardnested" branch | |
47 | * Holiman's iclass, (usually gets into the master) | |
48 | * Marshmellow's fixes (usually gets into the master) | |
49 | * Midnitesnake's Ultralight, Ultralight-c enhancements | |
50 | * Izsh's lf peak modification / iir-filtering | |
51 | * Aspers's tips and tricks from inside the PM3-gui-tool, settings.xml and other stuff. | |
52 | * My own desfire, Ultralight extras, LF T55xx enhancements, bugs fixes (filelength, hf mf commands ), TNP3xxx lua scripts, Awid26, skidata scripts (will come) | |
53 | * other obscure patches like for the sammy-mode, (offline you know), tagidentifications, defaultkeys. | |
54 | * Minor textual changes here and there. | |
55 | * Simulation of Ultralight/Ntag. | |
6063655a | 56 | * Marshmellow's and my "RevEng" addon for the client. Ref: http://reveng.sourceforge.net/ Now using reveng1.31 |
02b6f355 | 57 | * Someone's alternative bruteforce Mifare changes.. (you need the two other exe to make it work) |
58 | ||
59 | * A Bruteforce for T55XX passwords against tag. | |
60 | * A Bruteforce for AWID 26, starting w a facilitycode then trying all 0xFFFF cardnumbers via simulation. To be used against a AWID Reader. | |
c0bab227 | 61 | * A Bruteforce for HID, starting w a facilitycode then trying all 0xFFFF cardnumbers via simulation. To be used against a HID Reader. |
b112787d | 62 | * Blaposts Crapto1 v3.3 |
fdefe5cb | 63 | * Icsom's legic script and legic enhancements |
735a11ed | 64 | * Aczid's bitsliced bruteforce solver in 'hf mf hardnested' |
fdefe5cb | 65 | |
6063655a | 66 | |
67 | --- | |
68 | Straight from the CHANGELOG | |
69 | --- | |
735a11ed | 70 | - 'lf viking clone' - fixed a bug. (iceman) |
71 | - Added bitsliced bruteforce solver in 'hf mf hardnested' (aczid) | |
92243fcb | 72 | - 'hf mf chk' speedup (iceman) |
73 | - 'hf 14a/mf sim x" attack mode, now uses also moebius version of mfkey32 to try finding the key. (iceman) | |
74 | - 'hf 14a sim' Added emulation of Mifare cards with 10byte UID length. (iceman) | |
75 | - 'hf mf sim' Added emulation of Mifare cards with 10byte UID length. (iceman) | |
6063655a | 76 | - Added `lf guard clone/sim` (iceman) |
77 | - Added `lf pyramd clone/sim` (iceman) | |
78 | - trying to fix "hf 14b" command to be able to read CALYPSO card. (iceman) | |
79 | - `hf legic load`, it now loads faster and a casting bug is gone. (iceman) | |
80 | - Added `hf legic calccrc8` added a method to calculate the legic crc-8 value (iceman) | |
81 | - `hf legic decode` fixed the output overflow bugs, better printing (iceman) | |
82 | - Coverity Scan fixes a lot of resource leaks, etc (iceman) | |
83 | - Added `lf presco *` commands started (iceman) | |
84 | - Added `lf hid wiegand` added a method to calculate WIEGAND in different formats, (iceman) | |
85 | - `hf mf chkkeys` better printing, same table output as nested, faster execution and added Adam Lauries "try to read Key B if Key A is found" (iceman) | |
86 | - `hf mf nested` better printing and added Adam Lauries "try to read Key B if Key A is found" (iceman) | |
87 | - `hf mf mifare` fixing the zero parity path, which doesn't got called. (iceman) | |
88 | - Updated the @blapost's Crapto1 implementation to v3.3 (blapost) | |
89 | - `hf mf c*` updated the calling structure and refactored of the chinese magic commands (iceman, marshmellow) | |
90 | - Started to add Peter Fillmore's EMV fork into Iceman fork. ref: https://github.com/peterfillmore/proxmark3 (peter fillmore, iceman) | |
91 | - Added Travis-CI automatic build integration with GitHub fork. (iceman) | |
92 | - Updated the Reveng 1.30 sourcecode to 1.31 from Reveng projecthomepage (iceman) | |
93 | ||
94 | - Added possibility to write direct to a Legic Prime Tag (MIM256/1024) without using values from the 'BigBuffer' -> 'hf legic writeRaw <addr> <value>' (icsom) | |
95 | - Added possibility to decrease DCF values at address 0x05 & 0x06 on a Legic Prime Tag | |
96 | DCF-value will be pulled from the BigBuffer (address 0x05 & 0x06) so you have to | |
97 | load the data into the BigBuffer before with 'hf legic load <path/to/legic.dump>' & then | |
98 | write the DCF-Values (both at once) with 'hf legic write 0x05 0x02' (icsom) | |
99 | - Added script `legic.lua` for display and edit Data of Legic-Prime Tags (icsom) | |
100 | - Added the experimental HITAG_S support (spenneb) | |
101 | - Added topaz detection to `hf search` (iceman) | |
102 | - Fixed the silent mode for 14b to be used inside 'hf search' (iceman) | |
103 | ||
104 | --- | |
02b6f355 | 105 | |
106 | Give me a hint, and I'll see if I can't merge in the stuff you have. | |
107 | ||
108 | 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. | |
109 | ||
110 | PM3 GUI: | |
c0bab227 | 111 | -------- |
02b6f355 | 112 | I do tend to rename and move stuff around, the official PM3-GUI from Gaucho will not work so well. *sorry* |
113 | ||
114 | ||
115 | ||
116 | DEVELOPMENT: | |
c0bab227 | 117 | ------------ |
118 | This fork now compiles just fine on | |
119 | windows/mingw environment with Qt5.3.1 & GCC 4.8 | |
120 | Ubuntuu 1404, 1510 | |
121 | Mac OS X | |
122 | ||
123 | SETUP AND BUILD FOR UBUNTU | |
124 | -------------------------- | |
02b6f355 | 125 | |
c0bab227 | 126 | GC made updates to allow this to build easily on Ubuntu 14.04.2 LTS or 15.10 |
127 | See https://github.com/Proxmark/proxmark3/wiki/Ubuntu%20Linux | |
02b6f355 | 128 | |
c0bab227 | 129 | Run |
28d47dc9 | 130 | -> sudo apt-get install p7zip git build-essential libreadline5 libreadline-dev libusb-0.1-4 libusb-dev libqt4-dev perl pkg-config wget |
c0bab227 | 131 | |
132 | Follow these instructions | |
28d47dc9 | 133 | 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): |
02b6f355 | 134 | |
135 | (64-bit) http://sourceforge.net/projects/devkitpro/files/devkitARM/previous/devkitARM_r41-x86_64-linux.tar.bz2/download | |
136 | (32-bit) http://sourceforge.net/projects/devkitpro/files/devkitARM/previous/devkitARM_r41-i686-linux.tar.bz2/download | |
c0bab227 | 137 | |
02b6f355 | 138 | Extract the contents of the .tar.bz2: |
c0bab227 | 139 | -> tar jxvf devkitARM_r41-<arch>-linux.tar.bz2 |
140 | ||
02b6f355 | 141 | Create a directory for the arm dev kit: |
c0bab227 | 142 | -> sudo mkdir -p /opt/devkitpro/ |
143 | ||
02b6f355 | 144 | Move the ARM developer kit to the newly created directory: |
c0bab227 | 145 | -> sudo mv devkitARM /opt/devkitpro/ |
146 | ||
02b6f355 | 147 | Add the appropriate environment variable: |
c0bab227 | 148 | -> export PATH=${PATH}:/opt/devkitpro/devkitARM/bin/ |
149 | ||
02b6f355 | 150 | Add the environment variable to your profile: |
c0bab227 | 151 | -> echo 'PATH=${PATH}:/opt/devkitpro/devkitARM/bin/ ' >> ~/.bashrc |
152 | ||
153 | Clone iceman fork | |
154 | -> git clone https://github.com/iceman1001/proxmark3.git | |
02b6f355 | 155 | |
c0bab227 | 156 | Get the latest commits |
157 | -> git pull | |
158 | ||
159 | CLEAN COMPILE | |
160 | -> make clean && make all | |
02b6f355 | 161 | |
c0bab227 | 162 | Flash the BOOTROM |
163 | -> client/flasher -b /dev/ttyACM0 bootrom/obj/bootrom.elf | |
164 | ||
165 | Flash the FULLIMAGE | |
166 | -> client/flasher /dev/ttyACM0 armsrc/obj/fullimage.elf | |
02b6f355 | 167 | |
c0bab227 | 168 | Change into the client folder. |
169 | -> cd client | |
02b6f355 | 170 | |
c0bab227 | 171 | Run the client |
172 | -> ./proxmark3 /dev/ttyACM0 | |
173 | ||
02b6f355 | 174 | |
175 | January 2015, Sweden | |
176 | iceman at host iuse.se | |
177 | ||
c0bab227 | 178 | BUYING A PROXMARK 3 |
179 | ------------------- | |
180 | ||
181 | The Proxmark 3 device is available for purchase (assembled and tested) from the following locations: | |
182 | ||
183 | * http://www.elechouse.com (new and revised hardware package 2015) | |
02b6f355 | 184 | |
c0bab227 | 185 | I recommend you to buy this version. |
02b6f355 | 186 | |
c0bab227 | 187 | -------------------------------------------------------------------------- |
02b6f355 | 188 | |
189 | Most of the ultra-low-volume contract assemblers could put | |
190 | something like this together with a reasonable yield. A run of around | |
191 | a dozen units is probably cost-effective. The BOM includes (possibly- | |
192 | outdated) component pricing, and everything is available from Digikey | |
193 | and the usual distributors. | |
194 | ||
195 | If you've never assembled a modern circuit board by hand, then this is | |
196 | not a good place to start. Some of the components (e.g. the crystals) | |
197 | must not be assembled with a soldering iron, and require hot air. | |
198 | ||
199 | The schematics are included; the component values given are not | |
200 | necessarily correct for all situations, but it should be possible to do | |
201 | nearly anything you would want with appropriate population options. | |
202 | ||
203 | The printed circuit board artwork is also available, as Gerbers and an | |
204 | Excellon drill file. | |
205 | ||
206 | ||
207 | LICENSING: | |
208 | ||
209 | This program is free software; you can redistribute it and/or modify | |
210 | it under the terms of the GNU General Public License as published by | |
211 | the Free Software Foundation; either version 2 of the License, or | |
212 | (at your option) any later version. | |
213 | ||
214 | This program is distributed in the hope that it will be useful, | |
215 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
216 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
217 | GNU General Public License for more details. | |
218 | ||
219 | You should have received a copy of the GNU General Public License | |
220 | along with this program; if not, write to the Free Software | |
221 | Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA | |
222 | ||
223 | ||
224 | Jonathan Westhues | |
225 | user jwesthues, at host cq.cx | |
226 | ||
227 | May 2007, Cambridge MA |