MacOS Quick Start

ATTENTION: This page is still a WIP. Usual disclaimers about not taking responsibility for your system disruption applies.

Before you begin

This procedure has been tested on OS X El Capitain 10.11. The Miosix toolchain has been successfully compiled using GCC 4.9.3, which can be installed using the Homebrew package manager.

Install Xcode

Install Xcode by downloading it from the Mac App Store here. This is needed for installing the XCode command line tools which in turn is needed by Homebrew.

Install Xcode command line tools

Install Command Line tools by running the following command in terminal.

xcode-select --install

It is recommended to run the command even if Xcode and the Command Line tools were already installed on your system, since the Command Line tools installation may have been messed up by upgrading to 10.11 from a previous release.

Install Homebrew

Grab a copy of Homebrew and run the install script in one step using this command in terminal:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

If it complains about permission issues, then you have to fix it before you can continue. In Mac OS X El Capitan 10.11, Apple introduced a new feature called System Integrity Protector (SIP), which prevents from writing to many system directories such as /usr, /System, /bin, regardless of whether or not you are root. Apple is leaving /usr/local open for developers to use, so Homebrew can still be used as expected; however, performing a few steps may be required depending on you system, as outlined in the official Homebrew documentation here.

GCC 4.9.3 installation

Install GCC 4.9.3

Running the Miosix toolchain compilation script using Apple GCC has proven unsuccessful. That's why we need to install GCC 4.9.3 from Homebrew. Perform the steps below:

Run this command in terminal to grab the most recent packages list:

brew update

Run this command in terminal to add the repository containing GCC 4.9.3 to Homebrew:

brew tap homebrew/versions

Run this command to install GCC 4.9.3:

brew install gcc49