Skip to content

MiSTle-Dev/MiSTeryNano

Repository files navigation

MiSTeryNano

The MiSTeryNano is a port of the MiSTery Atari STE FPGA core to the Tang series of FPGA boards like the Tang Nano 20k FPGA board. Recently support for the Efinix T20 has been added.

MiSTeryNano implements the hardware of an Atari ST allowing it to run the original operating systems as well as the majority of games and productivity software of the Atari ST.

A complete MiSTeryNano setup also requires a supporting MCU acting as the FPGA Companion.

For support and more information please visit the Atari forum.

MiSTeryNano photo

Current state

The MiSTeryNano's current features are:

Videos

These videos primarily document the progress during development:

More ...

Getting started

In order to use the MiSTeryNano the following things are needed:

  • Tang FPGA board like e.g. the Tang Nano 20k to run the MiSTeryNano core itself
  • MCU board like the M0S Dock to run the FPGA Companion to connect USB keyboard and mouse
  • Breadboard to wire everything up and some jumper wires, or
  • a MiSTeryShield
  • a USB-C to USB-A adapter to connect regular USB devices to the M0S Dock

Many other variants can be built using various Tang FPGA boards and different MCUs.

MiSTeryNano breadboard

Installation on e.g. Tang Nano 20k

The installation of MiSTeryNano on the Tang Nano 20k using can be done using a Linux PC or a Windows PC.

See the trouble shooting guide if you run into problems.

Wiring

The properly flashed Tang Nano 20K will boot into the Atari ST desktop even without anything else connected. But in order to use the system you need at least a keyboard and most likely also a mouse. These are usually connected through the M0S Dock.

Additional connections exist for a physical DB9 joystick or Atari ST mouse and MIDI IN and OUT. The usage of these pins is optional. They can just be left unconnected. A joystick may then be connected via USB instead.

MiSTeryNano wiring

Usage

The MiSTeryNano is mainly controlled through an on-screen-display (OSD) overlaying the main Atari ST screen. The OSD is opened using the F12 key. It can then be used to select floppy and harddisk images and to configure the running system.