Skip to content

harbaum/MiSTeryNano

Repository files navigation

MiSTeryNano

The MiSTeryNano is a port of the MiSTery Atari STE FPGA core to the Tang Nano 20k FPGA board. It has also been ported to the Tang Primer 25K and the Tang Mega 138K.

For support and more information please visit the Atari forum.

MiSTeryNano photo

Current state

The MiSTeryNano is a work in progress. Current features are:

  • Atari ST/STE
    • Complete Atari ST/E chipset
    • ST or STE configurable
    • Cycle exact 8 MHz 68000 CPU
    • 4MB RAM, optional 8MB STRAM
    • color and monochrome video via HDMI
    • YM2149 and STE DMA sound via HDMI
    • Blitter
  • Supports most TOS versions
  • Full IKBD implementation
    • Mapped to USB via BL616 MCU
    • Mouse and keyboard via USB
    • Joystick via USB or dedicated IO pins of Tang Nano 20k
  • Floppy disk images
    • Read and write support for drive A: and drive B:
    • Images stored in .ST format on regular FAT/exFAT formatted SD card
  • ACSI harddisks
    • Read and write support for ACSI 0 and 1
    • Tested with AHDI, PP's driver and HDDriver 12.03
    • Images stored in .HD format
  • MIDI
    • Physical MIDI-IN and OUT
  • Optional custom carrier board
  • Optional case
  • Runs on various Tang variants

Videos

These videos primarily document the progress during development:

Getting started

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

  • Tang Nano 20k FPGA board to run the MiSTeryNano core
  • M0S Dock to connect USB keyboard and mouse
  • a 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

MiSTeryNano breadboard

Installation

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.