These are the instructions for installing the development tools on macOS. We peppered the installation instructions with Check steps that confirm your progress through the steps. Use each to validate a step before moving on. If you hit a snag, stop and reach out (forum, office hours) and we can help you out!
Install Homebrew/Xcode
To ease the installation process, we are using Homebrew. Homebrew is a popular package manager for OS X.
If you already use Homebrew, skip to the next section; otherwise follow these steps.
- Homebrew requires the Xcode command line tools which can be installed by running the command below.
$ xcode-select --install - Install Homebrew by running this command.
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Check: confirm Homebrew installation
$ brew -v
Homebrew 4.2.0
Fine if your version number is newer!
Install riscv-unknown-elf toolchain and xfel
We prepared a brew package containing the cross-compile toolchain and xfel utility need to compile and run programs on the Mango Pi.
Use homebrew to install our custom brew package.
$ brew install cs107e/cs107e/riscv-gnu-toolchain-13
Check: confirm compiler
$ brew info riscv-gnu-toolchain-13
==> cs107e/cs107e/riscv-gnu-toolchain-13: stable 13-2024q1-cs107e
Pre-built RISC-V GNU toolchain for CS107e
https://cs107e.github.io/guides/install/
Installed
... blah blah blah ....
$ riscv64-unknown-elf-gcc --version
riscv64-unknown-elf-gcc (gc891d8dc2-dirty) 13.2.0
Copyright (C) 2023 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Check: confirm xfel
$ xfel
xfel(v1.3.2) - https://github.com/xboot/xfel
usage:
xfel version - Show chip version
xfel hexdump <address> <length> - Dumps memory region in hex
xfel dump <address> <length> - Binary memory dump to stdout
... blah blah blah ...
Installation complete
Nice job! Head back to the main installation guide to do one last set of checks.