This commit is contained in:
iceman1001 2021-12-31 11:36:43 +01:00
commit 3450439b7b
7 changed files with 195 additions and 10 deletions

View file

@ -1,4 +1,27 @@
<a id="Top"></a>
# Linux Installation Instructions
# Table of Contents
- [Linux Installation Instructions](#linux-installation-instructions)
- [Table of Contents](#table-of-contents)
- [External resources](#external-resources)
- [Install the required dependencies](#install-the-required-dependencies)
- [On Debian / Ubuntu / Kali / ParrotOS / Raspbian](#on-debian--ubuntu--kali--parrotos--raspbian)
- [On ArchLinux](#on-archlinux)
- [On Fedora](#on-fedora)
- [On openSUSE](#on-opensuse)
- [Clone the RRG/Iceman repository](#clone-the-rrgiceman-repository)
- [Check ModemManager](#check-modemmanager)
- [⚠️ Very important ⚠️](#-very-important-)
- [Check connection](#check-connection)
- [Get permissions to use /dev/ttyACM0](#get-permissions-to-use-devttyacm0)
- [Compile and use the project](#compile-and-use-the-project)
# External resources
^[Top](#top)
You might want to follow one of these external resources to get an overview, but please still read carefully this page as some instructions may have evolved.
@ -12,8 +35,10 @@ You might want to follow one of these external resources to get an overview, but
# Install the required dependencies
^[Top](#top)
## On Debian / Ubuntu / Kali / ParrotOS / Raspbian
^[Top](#top)
First what we want to do is get an update for the system. If you need to upgrade do this **before** the install. An upgrade was carried out prior to following these instructions.
@ -37,6 +62,7 @@ If you don't need support for Python3 scripts in the Proxmark3 client, you can s
If you get some (non blocking) error at runtime such as _Gtk-Message: Failed to load module "canberra-gtk-module"_ you may have to install `libcanberra-gtk-module`.
## On ArchLinux
^[Top](#top)
```sh
sudo pacman -Sy git base-devel readline bzip2 arm-none-eabi-gcc arm-none-eabi-newlib qt5-base bluez python --needed
@ -49,6 +75,7 @@ If you don't need the graphical components of the Proxmark3 client (such as in `
If you don't need support for Python3 scripts in the Proxmark3 client, you can skip the installation of `python`.
## On Fedora
^[Top](#top)
```sh
sudo dnf install git make gcc gcc-c++ arm-none-eabi-gcc-cs arm-none-eabi-newlib readline-devel bzip2-devel qt5-qtbase-devel bluez-libs-devel python3-devel libatomic
@ -61,6 +88,7 @@ If you don't need the graphical components of the Proxmark3 client (such as in `
If you don't need support for Python3 scripts in the Proxmark3 client, you can skip the installation of `python3-devel`.
## On openSUSE
^[Top](#top)
```sh
sudo zypper install git patterns-devel-base-devel_basis gcc-c++ readline-devel libbz2-devel cross-arm-none-gcc9 cross-arm-none-newlib-devel python3-devel libqt5-qtbase-devel
@ -73,18 +101,23 @@ If you don't need the graphical components of the Proxmark3 client (such as in `
If you don't need support for Python3 scripts in the Proxmark3 client, you can skip the installation of `python3-devel`.
# Clone the RRG/Iceman repository
^[Top](#top)
```sh
git clone https://github.com/RfidResearchGroup/proxmark3.git
```
# Check ModemManager
^[Top](#top)
### ⚠️ Very important ⚠️
^[Top](#top)
make sure ModemManager will not interfere, otherwise it could brick your Proxmark3!
Read carefully [this page about ModemManager](ModemManager-Must-Be-Discarded.md) and follow its instructions.
# Check connection
^[Top](#top)
Check the proxmark is being picked up by your computer. Plug it in, then:
@ -100,6 +133,7 @@ cdc_acm 2-1.2:1.0: ttyACM0: USB ACM device
And a new `/dev/ttyACM0` should have appeared.
# Get permissions to use /dev/ttyACM0
^[Top](#top)
Add current user to the proper group to get permission to use `/dev/ttyACM0`.
@ -118,5 +152,6 @@ To test you have the proper read & write rights, plug the Proxmark3 and execute:
It must return `ok`. Otherwise this means you've got a permission problem to fix.
# Compile and use the project
^[Top](#top)
Now you're ready to follow the [compilation instructions](/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md).