https://github.com/harbaum/misterynano
Atari STE MiSTery core for the Tang Nano 20k FPGA
https://github.com/harbaum/misterynano
atari-st fpga mist tang-nano
Last synced: about 1 year ago
JSON representation
Atari STE MiSTery core for the Tang Nano 20k FPGA
- Host: GitHub
- URL: https://github.com/harbaum/misterynano
- Owner: harbaum
- Created: 2023-09-25T17:13:21.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-22T12:06:24.000Z (about 2 years ago)
- Last Synced: 2024-04-22T13:25:39.635Z (about 2 years ago)
- Topics: atari-st, fpga, mist, tang-nano
- Language: SystemVerilog
- Homepage:
- Size: 9.33 MB
- Stars: 73
- Watchers: 11
- Forks: 11
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MiSTeryNano
The MiSTeryNano is a port of the
[MiSTery Atari STE FPGA core](https://github.com/gyurco/MiSTery) to the
[Tang Nano 20k FPGA board](https://wiki.sipeed.com/nano20k). It has
also been ported to the [Tang Primer 25K](TANG_PRIMER_25K.md) and the [Tang Mega 138K](TANG_MEGA_138K.md).
For support and more information please visit the [Atari forum](https://www.atari-forum.com/viewtopic.php?p=457209).
## 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](board/misteryshield20k/)
* [Optional case](https://github.com/prcoder-1/MiSTeryNano-Case)
* Runs on various Tang variants
* [Tang Nano 20k](https://wiki.sipeed.com/nano20k)
* [Tang Primer 25k](TANG_PRIMER_25K.md)
* [Tang Mega 138k](TANG_MEGA_138K.md)
## Videos
These videos primarily document the progress during development:
* [MiSTeryNano #21: I built a half sized keyboard for my FPGA Atari ST](https://youtube.com/shorts/clQujxjdr9I)
* [MiSTeryNano #20: Atari STE on Tang Primer 25k FPGA](https://youtube.com/shorts/i-hUT1_UNOY)
* [MiSTeryNano #19: Atari STE Stardust on Tang Mega 138K FPGA](https://youtube.com/shorts/CI1L_LBodlw)
More ...
- MiSTeryNano #18: Cheap RGB LCD for Atari ST in FPGA
- MiSTeryNano #17: C64 on Tang Nano 20K
- MiSTeryNano #16: Atari ST MIDI Space Quest 3 on Roland MT32
- MiSTeryNano #15: Power Without the Price: The Tang Nano 20k is the cheapest Atari ST
- MiSTeryNano #14: Cubase MIDI audio replay with Atari ST FPGA and SAM2695
- MiSTeryNano #13: Atari ST in Tang Nano 20k FPGA running Cubase 3 from Harddisk image
- MiSTeryNano #12: Atari ST first boot from virtual hard disk
- MiSTeryNano #11: Advanced SD card for FPGA Atari ST
- MiSTeryNano #10: New OSD for the FPGA Atari ST
- MiSTeryNano #9: Tang Nano 20k as USB host
- MiSTeryNano #8: Atari ST with USB keyboard and touchpad
- MiSTeryNano #7: Tang Nano 20k running Atari ST Oxyd2
- MiSTeryNano #6: B.I.G. DEMO
- MiSTeryNano #5: Playing Atari ST Frontier
- MiSTeryNano #4: Drives and Blitter
- MiSTeryNano #3: We got a rainbow!
- MiSTeryNano #2: Booting TOS 1.04 for the first time
- MiSTeryNano #1: Is the Tang Nano 20k the cheapest and smallest Atari ST?
## Getting started
In order to use the MiSTeryNano the following things are needed:
* [Tang Nano 20k FPGA board](https://wiki.sipeed.com/nano20k) to run the MiSTeryNano core
* [M0S Dock](https://wiki.sipeed.com/hardware/en/maixzero/m0s/m0s.html) to connect USB keyboard and mouse
* a breadboard to wire everything up and some jumper wires, or
* [a MiSTeryShield](board/misteryshield20k/)
* a USB-C to USB-A adapter to connect regular USB devices to the M0S Dock
## Installation
The installation of MiSTeryNano on the Tang Nano 20k using can be done
using a [Linux PC](INSTALLATION_LINUX.md) or a
[Windows PC](INSTALLATION_WINDOWS.md).
See the [trouble shooting guide](TROUBLESHOOTING.md) 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.
## 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.