mirror of
https://github.com/RfidResearchGroup/proxmark3.git
synced 2024-11-13 21:26:38 +08:00
345f936054
Reviewed install instructions for macOS and updated where necessary.
52 lines
2 KiB
Markdown
52 lines
2 KiB
Markdown
# Homebrew (Mac OS X)
|
|
These instructions comes from @Chrisfu, where we got the proxmark3.rb scriptfile from.
|
|
For further questions about Mac & Homebrew, contact @Chrisfu (https://github.com/chrisfu/)
|
|
|
|
1. Install homebrew if you haven't yet already done so: http://brew.sh/
|
|
|
|
2. Tap this repo: `brew tap RfidResearchGroup/proxmark3`
|
|
|
|
3. Install Proxmark3: `brew install proxmark3` for stable release or `brew install --HEAD proxmark3` for latest non-stable from GitHub.
|
|
|
|
## Upgrading HomeBrew tap formula
|
|
|
|
*This method is useful for those looking to run bleeding-edge versions of RRG/iceman's client. Keep this in mind when attempting to update your HomeBrew tap formula as this procedure could easily cause a build to break if an update is unstable on macOS.*
|
|
|
|
Tested on macOS Mojave 10.14.4
|
|
|
|
*Note: This assumes you have already installed RRG/iceman's fork from HomeBrew as mentioned above*
|
|
|
|
Force HomeBrew to pull the latest source from github
|
|
|
|
```sh
|
|
brew upgrade --fetch-HEAD proxmark3
|
|
```
|
|
|
|
## Flash the BOOTROM & FULLIMAGE
|
|
|
|
With your Proxmark3 unplugged from your machine, press and hold the button on your Proxmark3 as you plug it into a USB port. Continue to hold the button until after this step is complete and the `proxmark3-flasher` command outputs "Have a nice day!"
|
|
|
|
```sh
|
|
sudo proxmark3-flasher /dev/tty.usbmodemiceman1 -b /usr/local/Cellar/proxmark3/HEAD-<Commit-ID>/share/firmware/bootrom.elf /usr/local/Cellar/proxmark3/HEAD-<Commit-ID>/share/firmware/fullimage.elf
|
|
```
|
|
|
|
> Replace \<Commit-ID\> with the HEAD-XXXX ID displayed by brew.
|
|
> Depending on the firmware version your Proxmark3 can also appear as `/dev/tty.usbmodem881`
|
|
|
|
|
|
|
|
## Run the client
|
|
|
|
```sh
|
|
sudo proxmark3 /dev/tty.usbmodemiceman1
|
|
```
|
|
|
|
## Next steps
|
|
|
|
For the next steps, please read the following pages:
|
|
|
|
* [Validating proxmark client functionality](/doc/md/Use_of_Proxmark/1_Validation.md)
|
|
* [First Use and Verification](/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md)
|
|
* [Commands & Features](/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
|
|
|
|
|