Installing the emulator
The rosco_m68k toolchain includes a fully-featured fork of a popular Open Source emulator, with full support for rosco_m68k and a variety of other retro-style single-board computers.
With the emulator, you get full hardware debugging capabilities, and can run rosco_m68k software in a fully emulated virtual machine, right on your modern computer.
Once you've got the homebrew tap set up, installation is simple on macOS® and Linux®.
Follow the instructions here and you'll be up and running in no time!
Installing from Homebrew
This is the recommended option - the emulator can be tricky to build, and it can take a while.
Our homebrew tap contains a pre-configured build with binary bottles for various platforms and architectures.
Assuming you already installed Homebrew and the rosco_m68k tap, you can just do:
brew install mame-sbc
Depending on your platform this may take a little while (and if there isn't a pre-built binary available, you'll need your platform build tooling installed).
Once installed, there's an extra step you'll need to do to set up the default configuration:
mkdir -p ~/.mamesbc && ln -s /usr/local/share/mame-sbc/ini/mamesbc.ini ~/.mamesbc/mamesbc.ini
This will make a rosco_m68k-specific emulator directory under your home directory, and symlink the default configuration file into it.
Once that's done, you can run it with your favourite rosco_m68k binary:
sbc rosco_classicv2 -debug -quik /Users/rosco/Development/rosco-m68k/rosco_m68k/code/software/memcheck/memcheck.bin
Type 'g' (for "go") in the debug window that will pop up, and that's it! You should be good to go.
For more details on the emulator and some help using the debugger, refer to the official documentation: https://docs.mamedev.org/debugger/index.html
Installing from Source
Our emulator is a customised fork of a very popular Open Source emulation project.
You can grab the code from GitHub:
git clone https://github.com/roscopeco/mame.git
And then build:
cd mame make -j9
This includes the Open Source ROM files for rosco_m68k and various other single-board computers.