Update Mac-OS-X-MacPorts-Installation-Instructions.md

This commit is contained in:
İlteriş Eroğlu 2021-11-26 14:47:12 +03:00 committed by GitHub
parent 0bcaf5b47a
commit f940da8615
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -1,10 +1,8 @@
# MacPorts (Mac OS X), developer installation, ***experimental***
# MacPorts (Mac OS X)
<b><h3>These insturctions are not tested on Apple Silicon!</h3></b>
<b><h3>These insturctions won't work on Apple Silicon yet!</h3> An arm64 native build of arm-none-eabi-gcc is still not available (as of 2021-11-26).</b>
## Prerequisites
These instructions will show how to setup the environment on OSX to the point where you'll be able to clone and compile the repo by yourself, as on Linux, Windows, etc.
## Main prerequisite
1. Have MacPorts installed. Visit https://www.macports.org/ for more information.
@ -14,7 +12,7 @@ These instructions will show how to setup the environment on OSX to the point wh
export "/opt/local/bin:/opt/local/sbin:/usr/local/bin:/usr/local/sbin:$PATH"
```
Although it is optional for proxmark3 repository, you can also set include variables:
For a somewhat seamless development environment:
```bash
export C_INCLUDE_PATH="/opt/local/include"
@ -25,6 +23,18 @@ These instructions will show how to setup the environment on OSX to the point wh
export CPPFLAGS="-isystem/opt/local/include -I/opt/local/include"
```
## Installing latest releases
Packaging for latest releases are available on MacPorts with the port name `proxmark3-iceman`, with a variant for PM3GENERIC firmwares available as `+pm3generic`.
Installing is as simple as `sudo port install proxmark3-iceman` and if you want to install for PM3GENERIC, you can run `sudo port install proxmark3-iceman +pm3generic` instead.
## Build from source
These instructions will show how to setup the environment on OSX to the point where you'll be able to clone and compile the repo by yourself, as on Linux, Windows, etc.
1. Have MacPorts installed. See above for details.
2. Install dependencies:
```
@ -63,10 +73,12 @@ These instructions will show how to setup the environment on OSX to the point wh
## Compile and use the project
To use the compiled client, you can use `pm3` script, it is a wrapper of the proxmark3 client that handles automatic detection of your proxmark.
Now you're ready to follow the [compilation instructions](/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md).
To use the compiled client, you can use `pm3` script, it is a wrapper of the proxmark3 client that handles automatic detection of your proxmark.
To flash on OS X, better to enter the bootloader mode manually, else you may experience errors.
With your Proxmark3 unplugged from your machine, press and hold the button on your Proxmark3 as you plug it into a USB port. You can release the button, two of the four LEDs should stay on. You're in bootloader mode, ready for the next step. In case the two LEDs don't stay on when you're releasing the button, you've an old bootloader, start over and keep the button pressed during the whole flashing procedure.
From there, you can follow the original compilation instructions.
From there, you can follow the original instructions.