Skip to content
retrofun edited this page Feb 5, 2022 · 5 revisions

Here are some examples how to organize a SD card for MiST.

The SD card has to be FAT or exFAT formatted. exFAT's advantage is it can contain files bigger than 4GB. This can be useful for large hard disk images. If in doubt use a Windows PC or even better a device like a digital camera to format the card.

SD card with one FPGA core

Common use case: FPGA cores with many files e.g. Computer cores with programs, demos, games collections.

This is for users that want several SD cards with only one system on each of them, e.g. one card for C64, one card for Amiga, ...

Copy the following files to the root of the SD card:

  • the FPGA core as core.rbf
  • ROMs and other files

Optionally, add a mist.ini configuration file.

SD card with multiple FPGA cores

Common use case: small FPGA cores e.g. Arcade cores with corresponding ROMs.

This is for users that want multiple systems on one SD card.

To start one of the FPGA cores you need a startup menu:

Copy the following files to the root of the SD card:

  • the startup menu FPGA core as core.rbf
  • the FPGA cores, ROMs and other files

Optionally, add a mist.ini configuration file.

Since firmware 190601 it is possible to put FPGA cores into subdirectories. The subdirectories must have the system attribute set.

Linux terminal:
fatattr +s <directory>

Windows: open a command line window (cmd)
attrib +s <directory>

Make sure to set the system attribute of every directory from the root to the directories that contain the FPGA cores so that the firmware is able to display the directories in OSD and you can descent into them.

Example tree view:
[+s] indicates a directory with system attribute set (= directory contains FPGA core files).

:
|-- Arcade [+s]
|   |-- Arkanoid.rbf
|   |-- BombJack.rbf
|   |-- BOMBJACK.ROM
|   |-- Capcom SonSon Hardware [+s]
|   |   |-- Sonsons_MiST.rbf
|   |   `-- sonson.rom
:   :
:   :
|   |-- Jotego [+s]
|   |   |-- 1942 [+s]
|   |   |   |-- 1942 (Revision B).arc
|   |   |   |-- 1942.rom
|   |   |   `-- jt1942.rbf
|   |   |-- 1943 [+s]
|   |   |   |-- 1943j.rom
|   |   |   |-- 1943 Kai Midway Kaisen (Japan).arc
:   :   :   :-- ...
:   :   :   :
:
|-- C64 [+s]
|   |-- c64gs.arc
|   |-- c64gs.rom
|   |-- c64_jiffydos.rom
|   |-- c64_original.rom
|   |-- c64.rbf
:   :-- ...
:   :

MiST User Guides

User Guides of MiST cores

Cores

Console cores

Arcade cores

Hardware add-ons

For Core Developers

Hardware Development

Clone this wiki locally