Updated README

README.md

@@ -1,46 +1,43 @@
+# Proxmark III develoment environment for Windows
+ProxSpace is a collection of tools that are required to compile the firmware and client of the Proxmark III. At its core ProxSpace uses msys2. MSYS2 is a software distro and building platform for Windows, it provides a bash shell, Autotools, revision control systems and the like for building native Windows applications using MinGW-w64 toolchains. ProxSpace uses the GNU Arm Embedded Toolchain for compiling the Proxmark III firmware.
 
-	#######################################
+## Files
-	Proxmark III Develoment Kit for Windows
+ProxSpace comes with 3 different executables .bat files. 
-	#######################################
-## Different runme ##
-    The runme.bat is designed for development, when 'runme.bat' is started a terminal opens that allows to run make.
-    The runme_autobuild.bat runs a script (msys/scrip.sh) at startup that updates all git repositories in the pm3 folder and then wants to compile them, it was not designed for development, just for compiling.
 
-## What's installed ##
+ - `runme.bat` will start ProxSpace in x86 mode.
+ - `runme64.bat`will start ProxSpace in x64 mode.
+ - `autobuild.bat` runs a script (msys2/autobuild.sh) in x86 mode as well as in x64 mode at startup. The script will update all git repositories in the pm3 folder and then compile them and move a zip file with the just compiled firmware and client into the build folder. It is not designed for development, just for compiling.
 
-	This cut down development environment has been created specifically for Windows users.
+## What's installed
-	* msys2
+ProxSpace comes with already installed tools, but most of the required tools will be automatically downloaded. All tools will be contained within the ProxSpace folder which means ProxSpace can be moved into a different directory or even a different Windows machine without the need to reinstall anything.
-	* GNU Arm Embedded Toolchain 7-2018-q2
+Following tools are already installed with the current ProxSpace version:
-	After starting for the first time it will automatically download following packages:
+ - msys2
-	* gcc
+ - GNU Arm Embedded Toolchain 7-2018-q2
-	* Qt5
-	* readline
-	* git
-	* perl
-	* make
-	* pkg-config
-## Updating packages  ##
-    msys2 comes with a package manager, all installed packages can be updated with "pacman -Syuu"
  
-## Usage ##
+ Following tools will be automatically download:
+ - gcc
+ - Qt5
+ - readline
+ - git
+ - perl
+ - pkg-config
 
-	Extract 'ProxSpace' to a location on drive without spaces.
+## Package management system
-		For example C:\Proxspace or D:\projects\public\proxmark\proxspace are ok whereas C:\My Documents\My Projects\proxspace is not.
+MSYS2 features a package management system to provide easy installation of packages, Pacman. It brings many powerful features such as dependency resolution and simple complete system upgrades (excluding the GNU Arm Embedded Toolchain), as well as straight-forward package building. All installed packages can be updated with `pacman -Syuu`
 
-	Run 'runme.bat'
+## Usage
-	To get the Proxmark III repository you wish to compile.
+ 1. Extract 'ProxSpace' to a location on drive without spaces. For example `C:\Proxspace` or `D:\projects\public\proxmark\proxspace` are ok whereas `C:\My Documents\My Projects\proxspace` is not.
-	To build the project type 'make clean && make all'.
+ 2. Run `runme.bat` or `runme64.bat` depending on your Windows architecture.
-	To run the Proxmark III client type './client/proxmark3.exe COM1' where COM1 is the USB port of the Proxmark III.
+ 3. Get the Proxmark III repository you wish to compile. This can be done with git. For example `git clone https://github.com/Proxmark/proxmark3.git`.
-	To check your firmware revision on the Proxmark III type 'hw ver'.
+ 4. Go into the root directory of the repository you wish to compile. For example `cd proxmark3`.
-	To get basic help type 'help'. Or for help on a set of sub commands type the command followed by help. eg. 'hf mf help'
+ 5. To build the project type `make clean && make all`. 
-	To exit type 'exit'.
+ 6. In most cases the Proxmark III needs to be flashed with the just compiled firmware for details see **Firmware upgrading the Proxmark III**.
+ 7. To run the Proxmark III client type `./client/proxmark3.exe COM1` where COM1 is the USB port of the Proxmark III.
+ 8. Check your firmware revision on the Proxmark III with `hw ver`
+ 9. For basic help type `help`. Or for help on a set of sub commands type the command followed by help. For example `hf mf help`.
  
-## Firmware upgrading the Proxmark III ##
+## Firmware upgrading the Proxmark III
-
+Please note that more detail is available on the wiki: https://github.com/Proxmark/proxmark3/wiki
-	To upgrade the firmware on the Proxmark III:
+ 1. Attach the Proxmark III to a USB port on your computer.
-	Please note that more detail is available on the wiki: https://github.com/Proxmark/proxmark3/wiki
+ 2. Flash the bootrom and fullimage with `./client/flasher COM1 -b ./bootrom/obj/bootrom.elf ./armsrc/obj/fullimage.elf`where COM1 is the USB port of the Proxmark III.
-
+ 3. Wait for the process to complete.
-	1. Attach the Proxmark III to a USB port on your computer.
-	2. To flash the BOOTROM run './client/flasher COM1 -b ./bootrom/obj/bootrom.elf'
-	3. To flash the FULLIMAGE run './client/flasher COM1 ./armsrc/obj/fullimage.elf'
-	4. Wait for the process to complete.

autobuild.bat

@@ -3,7 +3,6 @@ REM *******************************************
 REM CHANGE THIS PATH TO MATCH YOUR INSTALLATION
 REM *******************************************
 set MYPATH=%~dp0
-set autobuild=true
 
 echo # For a description of the file format, see the Users Guide >msys2/etc/fstab 
 echo # http://cygwin.com/cygwin-ug-net/using.html#mount-table >>msys2/etc/fstab 

runme.bat

@@ -3,7 +3,6 @@ REM *******************************************
 REM CHANGE THIS PATH TO MATCH YOUR INSTALLATION
 REM *******************************************
 set MYPATH=%~dp0
-set autobuild=false
 
 echo # For a description of the file format, see the Users Guide >msys2/etc/fstab 
 echo # http://cygwin.com/cygwin-ug-net/using.html#mount-table >>msys2/etc/fstab 

runme64.bat

@@ -3,7 +3,6 @@ REM *******************************************
 REM CHANGE THIS PATH TO MATCH YOUR INSTALLATION
 REM *******************************************
 set MYPATH=%~dp0
-set autobuild=false
 
 echo # For a description of the file format, see the Users Guide >msys2/etc/fstab 
 echo # http://cygwin.com/cygwin-ug-net/using.html#mount-table >>msys2/etc/fstab