CoreDocArcade - mist-devel/mist-board GitHub Wiki

Overview

This page documents how to setup the Arcade cores. They are all quite similar, just vary slightly in supported features.

Many new Arcade cores have been ported by Gehstock https://github.com/Gehstock/Mist_FPGA/tree/master/Arcade_MiST. Follow the Discussions.. These support VGA & 15kHz modes.

Also Jotego's Arcade core collection https://github.com/jotego/jtbin

Installation

Download the MRA tool

The Arcade cores are normally self-contained in their own *.rbf file, so it is enough to copy them and a ROM file (if needed) to the root of an SD card.

MRA and ARC files

Newer updates contains the so-called MRA files (invented in the MiSTer project), which greatly simplifies the creation of the ROM files. Just get a collection of zipped MAME ROM files (e.g. archive.org) and use the MRA tool to process the MRA files which creates ARC files. An example how to use it:

mra -A -z /path/to/mame/roms Defender.mra

This will create DEFENDER.ROM and "Defender (Red label).arc" files. Copy both of them next to the core's RBF (Defender.rbf in this case). Why do you need an ARC file? Some cores support more than one arcade machine, and the ARC file contains information about the hardware variant, and the ROM file to load. So instead of having 4 RBFs for the Defender-like hardware, there's only one RBF, and 4 ARC files.

You can specify a number of mra files to process in a batch:

In Linux/MacOS shell, you can create ROMs and ARCs from several MRAs easily:

mra -A -z /path/to/mame/roms *.mra

The same in Windows shell:

for %f in (*.mra) do (mra -A -z /path/to/mame/roms "%f")

If a core supports only one machine variant, you can omit the ARC file creation (-A switch), and create the ROM only. Although some games require DIP switch information present only in the ARC file so in case of malfunction when using the RBF directly, try generating the ARC and running from it.

If you don't want to see the RBF file in the core list, you can set the hidden attribute on it (very handy if you created a separate Arcade directory:

fatattr +h Defender.rbf

on Linux

attrib +h Defender.rbf

on Windows.

Or simply hide all RBFs in one directory:

fatattr +h *rbf

or

attrib +h *.RBF

MRA tool usage

Usage:
        mra [-vlzoOaA] [my_file.mra]...

Convert a number of MRA files to ROM files for use on MiST arcade cores.
Optionally creates the associated ARC file.
For more informations, visit https://www.atari-forum.com/viewtopic.php?t=38224

Options:
        -h              this help.
        -v              when it is the only parameter, display version information and exit. Otherwise, set Verbose on (default: off).
        -l              list MRA content instead of creating the ROM file.
        -z directory    add directory to include zip files. Directories added with -z have priority over the current dir.
        -o filename     set the output ROM file name. Overrides the internal generation of the filename.
        -O directory    set the output directory. By default, ROM and ARC files are created in the current directory.
        -a filename     set the output ARC file name. Overrides the internal generation of the filename.
        -A              create ARC file. This is done in addition to creating the ROM file.
        -s              skip ROM creation. This is useful if only the ARC file is required.