From 0555b69b689d00c2848d1523d70504ec06227a3f Mon Sep 17 00:00:00 2001 From: iceman1001 Date: Wed, 20 Jan 2021 11:58:43 +0100 Subject: [PATCH 1/5] update docs --- client/cmdscripts/rdv4_init_extflash.cmd | 2 +- client/luascripts/init_rdv4.lua | 10 +++++----- doc/cheatsheet.md | 6 +++--- doc/cliparser_todo.txt | 2 -- .../2_Configuration-and-Verification.md | 16 ++++++++-------- 5 files changed, 17 insertions(+), 19 deletions(-) diff --git a/client/cmdscripts/rdv4_init_extflash.cmd b/client/cmdscripts/rdv4_init_extflash.cmd index 6fe6de3ba..da0447ce4 100755 --- a/client/cmdscripts/rdv4_init_extflash.cmd +++ b/client/cmdscripts/rdv4_init_extflash.cmd @@ -3,4 +3,4 @@ mem load -f mfc_default_keys --mfc mem load -f t55xx_default_pwds --t55xx mem load -f iclass_default_keys --iclass -lf t55xx deviceconfig z p +lf t55xx deviceconfig -z -p diff --git a/client/luascripts/init_rdv4.lua b/client/luascripts/init_rdv4.lua index a724ed189..8e429e67d 100644 --- a/client/luascripts/init_rdv4.lua +++ b/client/luascripts/init_rdv4.lua @@ -3,7 +3,7 @@ local ansicolors = require('ansicolors') copyright = 'Copyright (c) 2019 IceSQL AB. All rights reserved.' author = 'Christian Herrmann' -version = 'v1.0.1' +version = 'v1.0.2' desc = [[ This script initialize a Proxmark3 RDV4.0 with - uploading dictionary files to flashmem @@ -82,10 +82,10 @@ function main(args) -- T55x7 Device configuration print('Configure T55XX device side to match RDV4') print(dash) - core.console('lf t55xx deviceconfig r 0 a 29 b 17 c 15 d 47 e 15 p') - core.console('lf t55xx deviceconfig r 1 a 29 b 17 c 18 d 50 e 15 p') - core.console('lf t55xx deviceconfig r 2 a 29 b 17 c 18 d 40 e 15 p') - core.console('lf t55xx deviceconfig r 3 a 29 b 17 c 15 d 31 e 15 f 47 g 63 p') + core.console('lf t55xx deviceconfig -r 0 -a 29 -b 17 -c 15 -d 47 -e 15 -p') + core.console('lf t55xx deviceconfig -r 1 -a 29 -b 17 -c 18 -d 50 -e 15 -p') + core.console('lf t55xx deviceconfig -r 2 -a 29 -b 17 -c 18 -d 40 -e 15 -p') + core.console('lf t55xx deviceconfig -r 3 -a 29 -b 17 -c 15 -d 31 -e 15 -f 47 -g 63 -p') print('') print('') diff --git a/doc/cheatsheet.md b/doc/cheatsheet.md index b4b536053..1220bf173 100644 --- a/doc/cheatsheet.md +++ b/doc/cheatsheet.md @@ -544,10 +544,10 @@ Set timings to default ``` Options --- -p : persist to flashmemory -z : Set default t55x7 timings (use p to save if required) +-p : persist to flash memory (RDV4) +-z : Set default t55x7 timings (use `-p` to save if required) -pm3 --> lf t55xx deviceconfig z p +pm3 --> lf t55xx deviceconfig -z -p ``` Write to T55xx block diff --git a/doc/cliparser_todo.txt b/doc/cliparser_todo.txt index dbe4e53a7..335c6491f 100644 --- a/doc/cliparser_todo.txt +++ b/doc/cliparser_todo.txt @@ -122,7 +122,5 @@ lf t55xx restore lf t55xx trace lf t55xx wakeup lf t55xx write -lf t55xx bruteforce -lf t55xx chk lf t55xx special script run diff --git a/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md b/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md index 17b22f6c6..ad76ecd9a 100644 --- a/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md +++ b/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md @@ -8,16 +8,16 @@ You will need to run these commands to make sure your rdv4 is prepared The lua script actually executes the following commands below. These are here because of documentation, you can jump down to *Verify sim module firmware version* part. ``` -[usb] pm3 --> mem load f mfc_default_keys m -[usb] pm3 --> mem load f t55xx_default_pwds t -[usb] pm3 --> mem load f iclass_default_keys i -[usb] pm3 --> lf t55xx deviceconfig a 29 b 17 c 15 d 47 e 15 p -[usb] pm3 --> lf t55xx deviceconfig r 1 a 31 b 20 c 18 d 50 e 15 p -[usb] pm3 --> lf t55xx deviceconfig r 2 a 31 b 20 c 18 d 40 e 15 p -[usb] pm3 --> lf t55xx deviceconfig r 3 a 29 b 17 c 15 d 31 e 15 f 47 g 63 p +[usb] pm3 --> mem load -f mfc_default_keys -m +[usb] pm3 --> mem load -f t55xx_default_pwds -t +[usb] pm3 --> mem load -f iclass_default_keys -i +[usb] pm3 --> lf t55xx deviceconfig -a 29 -b 17 -c 15 -d 47 -e 15 -p +[usb] pm3 --> lf t55xx deviceconfig -r 1 -a 31 -b 20 -c 18 -d 50 -e 15 -p +[usb] pm3 --> lf t55xx deviceconfig -r 2 -a 31 -b 20 -c 18 -d 40 -e 15 -p +[usb] pm3 --> lf t55xx deviceconfig -r 3 -a 29 -b 17 -c 15 -d 31 -e 15 -f 47 -g 63 -p Set all t55xx settings to defaults (will set all 4 at once) -[usb] pm3 --> lf t55xx deviceconfig z p +[usb] pm3 --> lf t55xx deviceconfig -z -p ``` From abb0d1c437440ffe0a2ecb774584991eae0979d6 Mon Sep 17 00:00:00 2001 From: iceman1001 Date: Wed, 20 Jan 2021 12:22:52 +0100 Subject: [PATCH 2/5] forgot the 'r' change became long param '--r0' --- client/luascripts/init_rdv4.lua | 8 ++++---- .../Use_of_Proxmark/2_Configuration-and-Verification.md | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/client/luascripts/init_rdv4.lua b/client/luascripts/init_rdv4.lua index 8e429e67d..69a76852d 100644 --- a/client/luascripts/init_rdv4.lua +++ b/client/luascripts/init_rdv4.lua @@ -82,10 +82,10 @@ function main(args) -- T55x7 Device configuration print('Configure T55XX device side to match RDV4') print(dash) - core.console('lf t55xx deviceconfig -r 0 -a 29 -b 17 -c 15 -d 47 -e 15 -p') - core.console('lf t55xx deviceconfig -r 1 -a 29 -b 17 -c 18 -d 50 -e 15 -p') - core.console('lf t55xx deviceconfig -r 2 -a 29 -b 17 -c 18 -d 40 -e 15 -p') - core.console('lf t55xx deviceconfig -r 3 -a 29 -b 17 -c 15 -d 31 -e 15 -f 47 -g 63 -p') + core.console('lf t55xx deviceconfig --r0 -a 29 -b 17 -c 15 -d 47 -e 15 -p') + core.console('lf t55xx deviceconfig --r1 -a 29 -b 17 -c 18 -d 50 -e 15 -p') + core.console('lf t55xx deviceconfig --r2 -a 29 -b 17 -c 18 -d 40 -e 15 -p') + core.console('lf t55xx deviceconfig --r3 -a 29 -b 17 -c 15 -d 31 -e 15 -f 47 -g 63 -p') print('') print('') diff --git a/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md b/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md index ad76ecd9a..55e05af92 100644 --- a/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md +++ b/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md @@ -11,10 +11,10 @@ The lua script actually executes the following commands below. These are here b [usb] pm3 --> mem load -f mfc_default_keys -m [usb] pm3 --> mem load -f t55xx_default_pwds -t [usb] pm3 --> mem load -f iclass_default_keys -i -[usb] pm3 --> lf t55xx deviceconfig -a 29 -b 17 -c 15 -d 47 -e 15 -p -[usb] pm3 --> lf t55xx deviceconfig -r 1 -a 31 -b 20 -c 18 -d 50 -e 15 -p -[usb] pm3 --> lf t55xx deviceconfig -r 2 -a 31 -b 20 -c 18 -d 40 -e 15 -p -[usb] pm3 --> lf t55xx deviceconfig -r 3 -a 29 -b 17 -c 15 -d 31 -e 15 -f 47 -g 63 -p +[usb] pm3 --> lf t55xx deviceconfig --r0 -a 29 -b 17 -c 15 -d 47 -e 15 -p +[usb] pm3 --> lf t55xx deviceconfig --r1 -a 31 -b 20 -c 18 -d 50 -e 15 -p +[usb] pm3 --> lf t55xx deviceconfig --r2 -a 31 -b 20 -c 18 -d 40 -e 15 -p +[usb] pm3 --> lf t55xx deviceconfig --r3 -a 29 -b 17 -c 15 -d 31 -e 15 -f 47 -g 63 -p Set all t55xx settings to defaults (will set all 4 at once) [usb] pm3 --> lf t55xx deviceconfig -z -p From 0b37e2a06238227a3e678790533959393c1f590c Mon Sep 17 00:00:00 2001 From: iceman1001 Date: Wed, 20 Jan 2021 14:15:43 +0100 Subject: [PATCH 3/5] text updates --- .../Troubleshooting.md | 2 ++ .../Windows-Installation-Instructions.md | 24 +++++++++++++++++-- 2 files changed, 24 insertions(+), 2 deletions(-) diff --git a/doc/md/Installation_Instructions/Troubleshooting.md b/doc/md/Installation_Instructions/Troubleshooting.md index 85a45f852..273bab50d 100644 --- a/doc/md/Installation_Instructions/Troubleshooting.md +++ b/doc/md/Installation_Instructions/Troubleshooting.md @@ -123,11 +123,13 @@ proxmark3 and you must adapt accordingly the file path of some commands, e.g. +using the executable direct: ``` proxmark3 --flash --image /usr/local/share/proxmark3/firmware/fullimage.elf <> proxmark3 --flash --image /usr/share/proxmark3/firmware/fullimage.elf +using the script: pm3 --> smart upgrade -f /usr/local/share/proxmark3/firmware/sim011.bin <> pm3 --> smart upgrade -f /usr/share/proxmark3/firmware/sim011.bin diff --git a/doc/md/Installation_Instructions/Windows-Installation-Instructions.md b/doc/md/Installation_Instructions/Windows-Installation-Instructions.md index 6000f42f2..842fa3773 100644 --- a/doc/md/Installation_Instructions/Windows-Installation-Instructions.md +++ b/doc/md/Installation_Instructions/Windows-Installation-Instructions.md @@ -1,15 +1,26 @@ # Installing on Windows + + +## Table of Contents + + * [Installing dev-environment with ProxSpace](#installing-dev-environment-with-proxspace) + * [Installing pre-compiled binaries with ProxSpace](#installing-pre-compiled-binaries-with-proxspace) + * [Installing dev-environment with WSL 1](#installing-dev-environment-with-wsl-1) There are two ways to install, build and use Proxmark3 on Windows: * Using Gator96100 **ProxSpace**, a package to assist in your Windows installation of MinGW * Using native **WSL 1**, if you're running a Windows 10 version recent enough (FCU 1709 or later) +We have listed three ways to use these two setups (dev environment vs pre-compiled binaries) + --- -# Installing on Windows with ProxSpace +## Installing dev-environment with ProxSpace +^[Top](#top) ## Video Installation guide +_note: this video is a bit out-of-date but still informative_ [![Windows Installation tutorial](https://github.com/5w0rdfish/Proxmark3-RDV4-ParrotOS/blob/master/screenshot-www.youtube.com-2019.03.17-20-44-33.png)](https://youtu.be/zzF0NCMJnYU "Windows Installation Tutorial") ## Driver Installation @@ -64,7 +75,15 @@ To use the compiled client, the only differences are that executables end with ` Now you're ready to follow the [compilation instructions](/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md). -# Installing on Windows with WSL 1 +# Installing pre-compiled binaries with ProxSpace +^[Top](#top) + +to be done (tcprst) + + + +# Installing dev-environment with WSL 1 +^[Top](#top) WSL 1 requires to run on Windows 10 version 1709 or above. Previous windows versions didn't have support for COM ports. @@ -82,6 +101,7 @@ Make sure your WSL can launch Windows processes to get the `pm3` scripts working If you want to run the graphical components of the Proxmark3 client, you need to install a X Server such as [VcXsrv](https://sourceforge.net/projects/vcxsrv/) or [Xming](https://sourceforge.net/projects/xming/) and launch it, e.g. by executing XLaunch. + ## Window terminal Installation Microsoft has recent released a new terminal for their OS. It is much better experience than old `cmd.exe` so we strongly recommend installing it. It is also open sourced, ref [terminal](https://github.com/microsoft/terminal). You can download and install from here: [windows terminal](https://aka.ms/terminal) From 9945e1b358178665d9da8ee7432924c3b65b997f Mon Sep 17 00:00:00 2001 From: iceman1001 Date: Wed, 20 Jan 2021 14:28:49 +0100 Subject: [PATCH 4/5] added some sleeps --- client/luascripts/init_rdv4.lua | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/client/luascripts/init_rdv4.lua b/client/luascripts/init_rdv4.lua index 69a76852d..08574a2fe 100644 --- a/client/luascripts/init_rdv4.lua +++ b/client/luascripts/init_rdv4.lua @@ -1,9 +1,10 @@ local getopt = require('getopt') local ansicolors = require('ansicolors') +local utils = require('utils') copyright = 'Copyright (c) 2019 IceSQL AB. All rights reserved.' author = 'Christian Herrmann' -version = 'v1.0.2' +version = 'v1.0.3' desc = [[ This script initialize a Proxmark3 RDV4.0 with - uploading dictionary files to flashmem @@ -83,9 +84,13 @@ function main(args) print('Configure T55XX device side to match RDV4') print(dash) core.console('lf t55xx deviceconfig --r0 -a 29 -b 17 -c 15 -d 47 -e 15 -p') + utils.Sleep(1) core.console('lf t55xx deviceconfig --r1 -a 29 -b 17 -c 18 -d 50 -e 15 -p') + utils.Sleep(1) core.console('lf t55xx deviceconfig --r2 -a 29 -b 17 -c 18 -d 40 -e 15 -p') + utils.Sleep(1) core.console('lf t55xx deviceconfig --r3 -a 29 -b 17 -c 15 -d 31 -e 15 -f 47 -g 63 -p') + utils.Sleep(1) print('') print('') From f91249c2a4bf7f0fe72cb6f6f0dcdfc103270d62 Mon Sep 17 00:00:00 2001 From: iceman1001 Date: Wed, 20 Jan 2021 14:32:16 +0100 Subject: [PATCH 5/5] text --- .../Windows-Installation-Instructions.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/doc/md/Installation_Instructions/Windows-Installation-Instructions.md b/doc/md/Installation_Instructions/Windows-Installation-Instructions.md index 842fa3773..d9f708a47 100644 --- a/doc/md/Installation_Instructions/Windows-Installation-Instructions.md +++ b/doc/md/Installation_Instructions/Windows-Installation-Instructions.md @@ -23,7 +23,9 @@ We have listed three ways to use these two setups (dev environment vs pre-compi _note: this video is a bit out-of-date but still informative_ [![Windows Installation tutorial](https://github.com/5w0rdfish/Proxmark3-RDV4-ParrotOS/blob/master/screenshot-www.youtube.com-2019.03.17-20-44-33.png)](https://youtu.be/zzF0NCMJnYU "Windows Installation Tutorial") -## Driver Installation +## Driver Installation ( Windows 7 ) + +_note: for Windows 7 you will this step. On a later Windows edition skip this._ Install required drivers for your Windows installation. You may need admin privileges to do this. Step by step guides are online such as [RyscCorps](https://store.ryscc.com/blogs/news/how-to-install-a-proxmark3-driver-on-windows-10). @@ -73,8 +75,11 @@ pacman -S mingw-w64-x86_64-astyle To use the compiled client, the only differences are that executables end with `.exe` (e.g. `proxmark3.exe`) and that the Proxmark3 port is one of your `comX` ports where "X" is the com port number assigned to proxmark3 under Windows, so commands like `proxmark3 /dev/ttyACMX` become `proxmark3.exe comX`. +## Done! + Now you're ready to follow the [compilation instructions](/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md). + # Installing pre-compiled binaries with ProxSpace ^[Top](#top) @@ -167,5 +172,7 @@ echo "export DISPLAY=:0" >> ~/.bashrc Note that it may take a quite long time for a freshly plugged Proxmark3 to be visible on a WSL /dev/ttySX port. +## Done! + Now you're ready to follow the [compilation instructions](/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md).