Mac Installation Guide

For this class, you will need to install the following software:

  1. The arm-none-eabi toolchain, which includes a C x86 to ARM cross-compiler which compiles C code on your x86 machine to ARM machine code which can run on the Raspberry Pi.
  2. The driver and script for the CP2102 console cable which connects your computer and Pi, so you can load programs onto the Pi.

If you are on a Mac, follow all the instructions on this page.

arm-none-eabi installation

To ease the installation process for the arm-none-eabi tools on OS X, we have built and packaged them into a Homebrew formula for you. Homebrew is a popular package manager for OS X. It is good practice to install software using a package manager.

Install Homebrew

If you aren’t yet using Homebrew, use these instruction to get Homebrew up and running. If you are already using Homebrew, skip to the next section.

  1. Install the Xcode command line tools by running the command below. A dialog should pop up on your screen. Click “Install” when it appears.

    $ xcode-select --install
  2. Run Homebrew’s install script by using the command below. The script will guide you through the rest of the install process.

    $ ruby -e "$(curl -fsSL"

Install the arm-none-eabi formula

  1. “Tap” into the CS107e Homebrew packages repository using the command below. This allows you to use the Homebrew formulas we have provided.

    $ brew tap cs107e/cs107e
  2. Install the arm-none-eabi toolchain:

    $ brew install arm-none-eabi
  3. Ensure it works by running the following command and checking that its output is identical to what is displayed below:

    $ arm-none-eabi-gcc --version
    arm-none-eabi-gcc (GCC) 4.8.3
    Copyright (C) 2013 Free Software Foundation, Inc.
    This is free software; see the source for copying conditions.  There is NO

Console drivers and script installation

To use the console cable to send information from and to your Pi, you’ll need to install a few things. These instructions will guide you through those steps.

  1. Install the CP210x USB to UART Drivers

    Download Version 5 of the drivers. Clicking on the download link will download the file Opening this file will uncompress and you will see a new file, SiLabsUSBDriverDisk.dmg. Opening the dmg file, will mount the volume.

    You should see a volume named “Silicon Labs VCP Driver Install Disk” in the finder under devices. Going to that folder, you will see an installed named “Silicon Labs VCP Driver.” Opening that file will launch the installer. Follow the instructions to complete the installation. You will need to restart the computer after the installation.

    NOTE: Users of the latest macOS (known issue on High Sierra Version 10.13.1) may see a message saying “System Extension Blocked”. Open the Security & Privacy menu in Settings. Under the General tab, click the Allow button next to the message indicating the blocked system extension.

  2. If you are in lab and got your kit, plug the USB breakout board into a USB port on your laptop. Check whether the serial port exists by looking for the device file:

    $ ls /dev/tty.SLAB_USBtoUART

    USB breakout board

  3. Install Miniconda

    Download and run the current Miniconda distribution on the command line:

    $ wget
    $ bash

    Follow the prompts to install Miniconda and add Python to your PATH:

    Please, press ENTER to continue
    >>> [ENTER]
    <scroll down>
    Do you accept the license terms? [yes|no]
    [no] >>> yes
       - Press ENTER to confirm the location
       - Press CRTL-C to abort the installation
       - Or specify a different location below
    [/Users/yourusername/miniconda3] >>> [ENTER]
    Do you wish the installer to prepend the Miniconda3 install location
    to PATH in your /Users/yourusername/.bash_profile ? [yes|no]
    [yes] >>> yes

    Finally, restart your Terminal application.

  4. Install the following Python libraries:

    $ pip install pyserial xmodem

    If pip install xmodem complains OSError: [Errno 1] Operation not permitted: '/System/Library/Frameworks/Python.framework/Versions/2.7/doc' or similar, don’t worry, the library has still installed correctly.