Toolchain Installation

No toolchain? No problem! Get coding in no time with our simple toolchain installation.

Before you can build any software for the rosco_m68k, you'll need a toolchain. Specifically, we use VASM and GCC, both of which are free and open-source.

If you already have GCC built as a cross-compiler for m68k, then as long as it's reasonably recent (i.e. supports C11) you can go ahead and jump right in to the code. If not, it's easier than ever to get started with a cross-compiling toolchain for m68k thanks to our Homebrew tap.

Step One - Install Homebrew

Homebrew, billed as The Missing Package Manager for macOS (or Linux), makes it really easy to install a complete, locally-built-from-official-sources VASM/GCC/Binutils cross-compiling toolchain, and it's our recommended way to get started with coding for the rosco_m68k.

If you don't already have Homebrew installed, visit https://brew.sh for a one-line install.

In a nutshell, it involves running the following command in a terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

And if, like us, you're a bit wary about running arbitrary scripts downloaded straight from the web, take a look at their alternative installation instructions for more options.

Step Two - Install the Toolchain

Now that you have Homebrew installed, installing the toolchain is a breeze.

You can install the toolchain with the following commands:

brew tap rosco-m68k/toolchain
brew install gcc-cross-m68k@7 vasm-all srecord minipro

This will automatically download, build and install all the dependencies that you would normally have to build manually. Homebrew will also keep a record of what's installed, enabling you to easily remove everything if you need to later, and allowing you to receive updates when we update the formulae (this should be pretty rare as we're not using the latest versions of anything to ensure the best m68k development experience).

Specifically, this adds the rosco_m68k tap to Homebrew, and then grabs our custom formulae from that tap. If you're curious about how we're building the cross toolchain or just want to see what it's going to do before you run it on your machine, check out the formulae at https://github.com/rosco-m68k/homebrew-toolchain

Grab a coffee because this'll take a few minutes - as it builds VASM, binutils and GCC from source. Once it's done, you're ready to rock.