Getting Started with version 2.2.0 of the Proxmark3

October 04, 2015

Before beginning please download version 2.2.0 of the client software here. If you intend to use the Proxmark with a Windows PC, please install the necessary drivers before proceeding. Driver instructions are available for Windows XPWindows 8.1 and 10.

NOTE: These instructions may not work inside a Virtual Machine.

If you have any issues along the way please email us at support@ryscc.com.

Windows

Step 1: Connect your Proxmark3 to the PC using the 1' long Mini USB cable. 

Proxmark3 connecting to computer

Step 2: Open Device Manger by entering Control + R followed by "devmgnt.msc".

Step 3: Note the COM Port number assigned to the Proxmark3, COM3 is assigned in the  screenshot below. Note that the Proxmark3 requires driver software to be installed on Windows. Driver installation instructions are available for Windows XP and Windows 8.1 and 10

Proxmark3 COM Port

Step 4: Open up a command prompt by entering Control + R followed by "cmd".

command run cmd

Step 5: Navigate to version 2.2.0 of the unzipped software distribution, then "cd" into the "Windows\client" folder.

Step 6: Enter "proxmark3 COM#" with # being the COM port number assigned to your Proxmark.

Proxmark3\pm3-bin-v2_2\Windows\client>Proxmark3 COM4
proxmark3>

Linux

Step 1: Connect your Proxmark3 to the PC using the 1' long Mini USB cable. 

Connecting Proxmark3
Step 2: Open up a terminal application.

Step 3: Enter in "dmesg | grep ttyACM" and note the port that Proxmark3 is on.

dmesg | grep ttyACM
[  157.597236] cdc_acm 2-2.2:1.0: ttyACM0: USB ACM device

Step 4: Navigate to version 2.2 of the unzipped software distribution and change the current directory to "Ubuntu_x64/client".

Step 5: Disable modem-manager by running the following commands as root.

# pkill modem-manager
# apt-get purge modemmanager 

Alternatively, you can edit '/lib/udev/rules.d/77-mm-usb-device-blacklist.rules' and add the following lines.

# proxmark3
ATTRS{idVendor}=="2d2d" ATTRS{idProduct}=="504d", ENV{ID_MM_DEVICE_IGNORE}="1"

You will then need to run:

sudo udevadm control --reload-rules

Step 6: Enter "sudo ./proxmark3 /dev/ttyACM#" replacing # with the number you noted earlier. Enter your admin password. Your Proxmark3 should now be connected.

 sudo ./proxmark3 /dev/ttyACM0

    Mac OS X

    Step 1: Connect your Proxmark3 to the PC using the 1' long Mini USB cable. 

    Connecting Proxmark3

    Step 2: Open up a terminal application

    Step 3: Enter in "ls /dev/cu*" to figure out which usbmodem the Proxmark3 is on. Note the usbModem# that your Proxmark3 is on.

    ls /dev/cu*
    /dev/cu.usbmodem411

    Step 4: Navigate to version 2.2.0 of the unzipped software distribution, then "cd" into the "Mac OS X\client" folder.

    Step 5: Connect to Proxmark3 client by entering in "sudo ./proxmark3 /dev/cu.usbmodem#". Replace # with the usbmodem that you noted. Enter your admin password. Your Proxmark3 should now be connected.

    $ sudo ./proxmark3 /dev/cu.usbmodem411

    Smoke Test

    Enter the commands below to ensure your Proxmark is functioning correctly. Make sure antennas are not near any metal objects as the metal will interfere with readings. 

    Enter "hw ver" to obtain the version of firmware running on your Proxmark. The version reported should be v2.2.

    proxmark3> hw ver 
    Prox/RFID mark3 RFID instrument
    bootrom: master/v2.2 2015-07-31 11:28:11
    os: master/v2.2 2015-07-31 11:28:12
    LF FPGA image built for 2s30vq100 on 2015/03/06 at 07:38:04
    HF FPGA image built for 2s30vq100 on 2015/06/22 at 21:47:54

    uC: AT91SAM7S512 Rev B
    Embedded Processor: ARM7TDMI
    Nonvolatile Program Memory Size: 512K bytes. Used: 162219 bytes (31). Free: 362069 bytes (69).
    Second Nonvolatile Program Memory Size: None
    Internal SRAM Size: 64K bytes
    Architecture Identifier: AT91SAM7Sxx Series
    Nonvolatile Program Memory Type: Embedded Flash Memory

    Connect your LF or HF antenna using the 4-pin 3' long antenna cable. Enter the "hw tune" command, you should receive results approximating those shown below.

    LF Antenna

    proxmark3> hw tune
    
    Measuring antenna characteristics, please wait...#db# DownloadFPGA(len: 42096)                 
    #db# DownloadFPGA(len: 42096)                 
              
    # LF antenna: 13.89 V @   125.00 kHz          
    # LF antenna: 28.74 V @   134.00 kHz          
    # LF optimal: 29.01 V @   131.87 kHz          
    # HF antenna:  0.99 V @    13.56 MHz          
    # Your HF antenna is unusable.          
    Displaying LF tuning graph. Divisor 89 is 134khz, 95 is 125khz.

    HF Antenna

    proxmark3> hw tune
    
    Measuring antenna characteristics, please wait...#db# DownloadFPGA(len: 42096)                 
    .....#db# DownloadFPGA(len: 42096)                 
    .          
    # LF antenna:  0.00 V @   125.00 kHz          
    # LF antenna:  0.00 V @   134.00 kHz          
    # LF optimal:  0.28 V @   169.01 kHz          
    # HF antenna: 13.36 V @    13.56 MHz          
    # Your LF antenna is unusable. 
    

    If everything looks good, your Proxmark3 is ready for use.

    For more commands see the command dump over at github.

    Related Blog Entries:






    Also in Blog

    MagSpoof V2 - Now Available for Pre-Order
    MagSpoof V2 - Now Available for Pre-Order

    February 13, 2017

    We are pleased to announce that the MagSpoof V2 is now available for pre-order. Orders yours today.

    View full article →

    Identifying unknown tags using the ChameleonMini Rev.G
    Identifying unknown tags using the ChameleonMini Rev.G

    January 06, 2017

    Follow these steps to identify an unknown HF tag (13.56 MHz) with the ChameleonMini Rev.G.

    View full article →

    Reading Tags with the ChameleonMini Rev.G
    Reading Tags with the ChameleonMini Rev.G

    January 06, 2017

    Follow these steps to read a HF tag (13.56 MHz) with the ChameleonMini Rev.G.

    View full article →