Ubuntu Linux

Table of Contents Setup and build for UBUNTU Compiling the proxmark3 source code Plug in the Proxmark3 HID device CDC device Flashing HID Flashing CDC Running the proxmark3 client

Setup and build for UBUNTU

This is the instructions to build easily on Ubuntu 14.04.2 LTS, 15.10, 16.04, 17.04 and 18.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 install p7zip git build-essential libreadline8 libreadline-dev libusb-0.1-4 libusb-dev qtbase5-dev perl pkg-config wget libncurses5-dev gcc-arm-none-eabi libstdc++-arm-none-eabi-newlib libpcsclite-dev pcscd

--- 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:

cd proxmark3

Get the latest commits :

git pull

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

Compiling the proxmark3 source code

Clean and complete compilation:

make clean && make all

Plug in the Proxmark3

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

HID device

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==.

CDC device

[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 device

Here 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==.

Flashing HID

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==.

Flashing CDC

Flash the BOOTROM, FULLIMAGE:

client/flasher /dev/ttyACM0 -b bootrom/obj/bootrom.elf armsrc/obj/fullimage.elf

Running the proxmark3 client

Change into the client folder:

  cd client

Run the client:

  ./proxmark3 /dev/ttyACM0

If all went well you should get some information about the firmware and memory usage as well as the following prompt:

  proxmark3>

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:

 proxmark3>quit