Skip to content

Latest commit

 

History

History
70 lines (41 loc) · 3.18 KB

installing-the-emulator.md

File metadata and controls

70 lines (41 loc) · 3.18 KB

Home | Getting Started | Connecting | Running the Examples | Toolchain Installation | Building the Software | Installing the Emulator | Debugging with MAME | Using SD Cards

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®.

Note: These instructions apply to macOS® and Linux® only. We recommend that Windows® users use Windows® Subsystem for Linux® or a Linux VM for development.

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 $(brew --prefix)/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 <path to rosco_m68k repository>/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: MAME Debugger Docs

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
cd mame
make -j9

This includes the Open Source ROM files for rosco_m68k and various other single-board computers.

Home | Getting Started | Connecting | Running the Examples | Toolchain Installation | Building the Software | Installing the Emulator | Debugging with MAME | Using SD Cards

Copyright © 2020-2024 The Really Old-School Company Limited. Registered in England and Wales No. 12596175 The Really Old-School Company Ltd, 15 Starthe Bank, GB DE75 7AX Tel: 0330 133 2083