Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Table of Contents
This is the instructions to build easily on Ubuntu 14.04.2 LTS, 15.10, 16.04 or 17.04
A nice and cool install script made by @daveio is found here: https://github.com/daveio/attacksurface/blob/master/proxmark3/pm3-setup.sh
Open a terminal: Download (and install) p7zip, and components essential to build the Proxmark from source:
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 libstdc++-arm-none-eabi-newlib
--- Note: if you get an error make sure you're linux is up to date - sudo apt update + sudo apt upgrade ---
Check out the latest revision of the Proxmark project:
git clone https://github.com/proxmark/proxmark3.git
Enter the repository:
Get the latest commits :
Install the blacklist rules:
sudo cp -rf driver/77-mm-usb-device-blacklist.rules /etc/udev/rules.d/77-mm-usb-device-blacklist.rules sudo udevadm control --reload-rules
Add user to dialout group. 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
Insert the Proxmark and check “dmesg”, you will get one of the following outputs that will affect the next few steps.
dmesg | grep -i usb
Remember this is very rare today, to find a device with HID firmware installed.
[ 5414.961137] usb 2-2.2: new full speed USB device number 11 using uhci_hcd May 3 15:53:43 proxtest mtp-probe: checking bus 2, device 11: "/sys/devices/pci0000:00/0000:00:11.0/0000:02:00.0/usb2/2-2/2-2.2" [ 5422.297626] generic-usb 0003:9AC4:4B8F.0008: hiddev0,hidraw2: USB HID v1.00 Device [ProxMark-3 RFID Instrument] on usb-0000:02:00.0-2.2/input0
Jump to ==Flashing HID==.
[10416.461687] usb 2-1.2: new full-speed USB device number 12 using ehci_hcd [10416.555093] usb 2-1.2: New USB device found, idVendor=9ac4, idProduct=4b8f [10416.555105] usb 2-1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=0 [10416.555108] usb 2-1.2: Product: PM3 [10416.555111] usb 2-1.2: Manufacturer: proxmark.org [10416.555871] cdc_acm 2-1.2:1.0: ttyACM0: USB ACM deviceHere look at the last row above and remember which tty your device got connected to. In this sample we got ttyACM0
Jump to ==Flashing CDC==.
Use the older version of the flasher to update the proxmark:
cd client/hid-flasher make ./flasher -b ../../bootrom/obj/bootrom.elf ./flasher ../../armsrc/obj/fullimage.elf cd ../..Once you have updated here, your proxmark should be using CDC. So futher flashing should follow that section of instructions. It is very rare today that your device has HID version installed. You must have version r765 or earlier. This is the old verisoning system based on the old SVN repo. Totally outdated since you are reading this on GitHub. (2017-08-07) the latest release is v3.0.1, its just for reference.
Jump to ==Running the proxmark3 client==.
Flash the BOOTROM, FULLIMAGE:
client/flasher /dev/ttyACM0 -b bootrom/obj/bootrom.elf armsrc/obj/fullimage.elf
Change into the client folder:
Run the client:
If all went well you should get some information about the firmware and memory usage as well as the following prompt:
Now run the following commands to verfiy functionality
proxmark3>hw status proxmark3>hw version proxmark3>hw tune
You are now ready to use your newly upgraded Proxmark3!
Quit Proxmark Program: