Windows (Precompiled)
This method is reccomended as the fastest and easiest way to get up and running in classs (no local admin rights required)
1. If you don't already have a Zip archive tool, download and install 7-ZIP from here: http://www.7-zip.org/download.html
2. Download this pre-compiled and pre-packaged Proxmark software package... https://enterthecore.net/proxspace/precompiled.zip
3. Extract the precompiled archive to a folder of your choosing. The archive will contain three sub-directories: firmware_win, win32, and Windows Driver
4. Plug your Proxmark3 unit into your computer. The system should automatically detect it and see it as a USB Serial Device. In your Windows Device Manager, look under Ports (COM & LPT) and see if a new USB Serial Device has appeared. If there are any errors installing this new device, the Windows Driver directory (mentioned above) contains a proxmark3.inf driver file that can be used to address said problems.
5. Once the new USB Serial Device has appeared in your Device Manager under "Ports", there should be a COM port number listed next to it. Note this COM Port number down, as it will be the COM port that you use to interact with your Proxmark.
6. In the Proxmark folder that you extracted, enter the win32 sub-directory. There are a series of batch files in here that will be used to update your Proxmark firmware and to launch the Proxmark client software. These batch files must be edited to reflect the COM port that your computer has assigned to the Proxmark's USB Serial Device.
7. Right-click on FLASH - Bootrom.bat and choose "Edit" and look for the line flasher.exe COM5 -b ..\firmware_win\bootrom\bootrom.elf ... edit the "COM5" entry to reflect the COM port that your computer has assigned to the Proxmark's USB Serial Device. So if your Device Manager showed, say, COM8 for the newly discovered device, you would edit that line to now read flasher.exe COM8 -b ..\firmware_win\bootrom\bootrom.elf
8. Right-click on FLASH - fullimage.bat and choose "Edit" and look for the line flasher.exe COM13 -b ..\firmware_win\fullimage.elf ... edit the "COM5" entry to reflect the COM port that your computer has assigned to the Proxmark's USB Serial Device. So if your Device Manager showed, say, COM8 for the newly discovered device, you would edit that line to now read flasher.exe COM8 -b ..\firmware_win\fullimage.elf
9. Right-click on Go.bat and choose "Edit" ... this file contains only one line. Specify the COM port that your computer has assigned to the Proxmark's USB Serial Device. So, if your Device Manager shows, say, COM8 for the newly discovered device, you would edit the single line within the Go.bat file to simply read proxmark3 COM8
(Windows has a habit of occasionally assigning new COM port numbers to devices when configuration changes are detected. If at any time your COM port number migrates, you will be able to see this change reflected in the Windows Device Manager. You can perform steps 7 through 9 again if that happens, editing your three batch files as necessary to keep the COM port information current in them)
10. Run the FLASH - Bootrom.bat script, pressing any key to continue, and the flash process should hopefully execute with no errors. Once the operation concludes, you may press Enter a couple times and then type exit to close the window.
11. Run the FLASH - fullimage.bat script, pressing any key to continue, and the flash process should hopefully execute with no errors. A long line of dots will progress across the screen as the firmware flash operation takes place. Once the operation concludes, you may press Enter a couple times and then type exit to close the window.
(it is at this time, after a Proxmark has been flashed with new firmware, that Windows sometimes will assign a new COM port number to the Proxmark. Feel free to check your Device Manager if you are concerned that this may have happened.)
12. Run the Go.bat script to launch the Proxmark client software. You should hopefully see a scroll of configuration details concerning your Proxmark and then be presented a [usb] pm3 --> prompt where you can execute Proxmark commands.
Windows (Full Environment)
This method is tested on Windows 10 (with local admin rights)
1. If you don't already have a Zip archive tool, download and install 7-ZIP from here: http://www.7-zip.org/download.html
2. Download this pre-compiled and pre-packaged Proxmark environment which we have prepared for you: proxspace-trio.zip
3. This zip file consists of one directory named ProxSpace with many sub-folders. Extract the ProxSpace folder to a location on your local machine that does NOT have spaces in the path name. (Extraction may may take a considerable amount of time, given the volume of small files involved.)
4. Within the ProxSpace folder, there should be five sub-folders and a runme.bat script file. As much as it may feel like a security risk, go ahead and use the runme.bat file to launch the proxmark environment.
5. You should see a Minimalist GNU terminal window. At the pm3 ~$ prompt, you can run basic UNIX commands. If you run the ls command to show a directory list, there should be three sub-folders: iceman, master, rrg. These are the Iceman fork, the Master branch, and the RfidResearchGroup release, respectively.
6. At various times during the class, we may make use of these various releases. For much of the work we will do, we will try to focus on using the RRG release. Change to that directory by entering the following command at the pm3 ~$ prompt: cd rrg
7. At the pm3 ~/rrg$ prompt, you can then launch the proxmark executable and specify your COM port in the process: ./client/proxmark3.exe COM#
8. When running that above command, remember that you have to specify your own computer's COM port number that the proxmark is using. So, if your Device Manger shows your proxmark's virtual COM port to be COM4, then your command to launch the proxmark environment would be ./client/proxmark3.exe COM4
MacOS
This method is recommended and tested on MacOS Sierra 10.12.3 (with local admin rights)
1. Install homebrew if you haven't yet already done so: http://brew.sh/
2. $git clone https://github.com/RfidResearchGroup/proxmark3.git to wherever in your filesystem you prefer.
3. cd proxmark3
4. Tap the RfidResearchGroup repo:
brew tap rfidresearchgroup/proxmark3
5. Install Proxmark3:
brew install --HEAD rfidresearchgroup/proxmark3/proxmark3
Kali Linux
1. Open a terminal: Download and install the essentials to build Proxmark3 from source:
sudo apt-get install git build-essential libreadline5 libreadline-dev gcc-arm-none-eabi libusb-0.1-4 libusb-dev libqt4-dev ncurses-dev perl pkg-config
2. Check out the latest revision of the Proxmark project:
git clone https://github.com/RfidResearchGroup/proxmark3.git
3. Open the recently cloned Proxmark3 repository
cd proxmark3
4. Now compile the bootrom, OS and software.
make clean && make all