Mac Setup

Jacob Alexander edited this page Feb 19, 2018 · 20 revisions

There are two main package managers for Mac command line programs - ports, and homebrew. Depending on what you have done you may already have one installed and can simply follow that section. If you have neither then I advise you use Homebrew.

General Requirements

  • Install Xcode.

  • Install the Xcode command line tools.

  • Install git, or brew install git.

  • Install Python 3 (NOT 2), or brew install python3.

  • Install the ARM Embedded Toolchain, or follow instructions below.

  • Accept the Xcode license by opening it, or running xcodebuild -license.

  • Open a terminal for the following steps. Choose either the macports or homebrew section below - not both.

OR

  • Install Docker and follow these instructions after cloning the controller git repository.

Homebrew

Install homebrew - http://brew.sh/

In general, install the following packages

brew install cmake libusb ctags ninja

If you want to build for Teensy 1, Teensy 2, or other AVR based chip, install the following

brew tap osx-cross/homebrew-avr
brew update
brew install avr-binutils avr-gcc avr-libc

If you want to build for Teensy 3, the Infinity Keyboard, or another ARM based chip, install the following

brew tap PX4/homebrew-px4
brew update
brew install gcc-arm-none-eabi dfu-util

or

brew tap Caskroom/cask
brew update
brew install Caskroom/cask/gcc-arm-embedded dfu-util

Macports (Not Recommended)

Install macports - https://guide.macports.org/#installing.xcode

Run sudo port selfupdate to update the list of port packages.

In general, install the following packages

sudo port install cmake libusb ninja

If you want to build for Teensy 1, Teensy 2, or other AVR based chip, install the following

sudo port install avr-binutils avr-gcc avr-libc

If you want to build for Teensy 3, the Infinity Keyboard, or another ARM based chip, install the following

sudo port install arm-none-eabi-binutils arm-none-eabi-gcc dfu-util

If you don't know what to install, then install everything above. It won't hurt! :D

What's next

Please see Configuration to setup your keyboard.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.