{"id":20477339,"url":"https://github.com/harbaum/misterynano","last_synced_at":"2025-03-05T14:47:48.936Z","repository":{"id":196568479,"uuid":"696403831","full_name":"harbaum/MiSTeryNano","owner":"harbaum","description":"Atari STE MiSTery core for the Tang Nano 20k FPGA","archived":false,"fork":false,"pushed_at":"2024-04-22T12:06:24.000Z","size":9786,"stargazers_count":73,"open_issues_count":5,"forks_count":11,"subscribers_count":11,"default_branch":"main","last_synced_at":"2024-04-22T13:25:39.635Z","etag":null,"topics":["atari-st","fpga","mist","tang-nano"],"latest_commit_sha":null,"homepage":"","language":"SystemVerilog","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/harbaum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-09-25T17:13:21.000Z","updated_at":"2024-04-22T13:25:42.168Z","dependencies_parsed_at":null,"dependency_job_id":"580db638-6b9f-4f74-9639-832b22c58acd","html_url":"https://github.com/harbaum/MiSTeryNano","commit_stats":null,"previous_names":["harbaum/misterynano"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harbaum%2FMiSTeryNano","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harbaum%2FMiSTeryNano/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harbaum%2FMiSTeryNano/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harbaum%2FMiSTeryNano/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harbaum","download_url":"https://codeload.github.com/harbaum/MiSTeryNano/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242048384,"owners_count":20063400,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atari-st","fpga","mist","tang-nano"],"created_at":"2024-11-15T15:27:37.925Z","updated_at":"2025-03-05T14:47:48.915Z","avatar_url":"https://github.com/harbaum.png","language":"SystemVerilog","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MiSTeryNano\n\nThe MiSTeryNano is a port of the\n[MiSTery Atari STE FPGA core](https://github.com/gyurco/MiSTery) to the\n[Tang Nano 20k FPGA board](https://wiki.sipeed.com/nano20k). It has\nalso been ported to the [Tang Primer 25K](TANG_PRIMER_25K.md) and the [Tang Mega 138K](TANG_MEGA_138K.md).\n\nFor support and more information please visit the [Atari forum](https://www.atari-forum.com/viewtopic.php?p=457209).\n\n![MiSTeryNano photo](images/misterynano.jpeg)\n\n## Current state\n\nThe MiSTeryNano is a work in progress. Current features are:\n\n  * Atari ST/STE\n    * Complete Atari ST/E chipset\n    * ST or STE configurable\n    * Cycle exact 8 MHz 68000 CPU\n    * 4MB RAM, optional 8MB STRAM\n    * color and monochrome video via HDMI\n    * YM2149 and STE DMA sound via HDMI\n    * Blitter\n  * Supports most TOS versions\n  * Full IKBD implementation\n    * Mapped to USB via BL616 MCU\n    * Mouse and keyboard via USB\n    * Joystick via USB or dedicated IO pins of Tang Nano 20k\n  * Floppy disk images\n    * Read and write support for drive A: and drive B:\n    * Images stored in .ST format on regular FAT/exFAT formatted SD card\n  * ACSI harddisks\n    * Read and write support for ACSI 0 and 1\n    * Tested with AHDI, PP's driver and HDDriver 12.03\n    * Images stored in .HD format\n  * MIDI\n    * Physical MIDI-IN and OUT\n  * [Optional custom carrier board](board/misteryshield20k/)\n  * [Optional case](https://github.com/prcoder-1/MiSTeryNano-Case)\n  * Runs on various Tang variants\n    * [Tang Nano 20k](https://wiki.sipeed.com/nano20k)\n    * [Tang Primer 25k](TANG_PRIMER_25K.md)\n    * [Tang Mega 138k](TANG_MEGA_138K.md)\n\n## Videos\n\nThese videos primarily document the progress during development:\n\n  * [MiSTeryNano #21: I built a half sized keyboard for my FPGA Atari ST](https://youtube.com/shorts/clQujxjdr9I)\n  * [MiSTeryNano #20: Atari STE on Tang Primer 25k FPGA](https://youtube.com/shorts/i-hUT1_UNOY)\n  * [MiSTeryNano #19: Atari STE Stardust on Tang Mega 138K FPGA](https://youtube.com/shorts/CI1L_LBodlw)\n\n\u003cdetails\u003e\u003csummary\u003eMore ...\u003c/summary\u003e\n\u003cul\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/_D7Gc8IL2GA\"\u003eMiSTeryNano #18: Cheap RGB LCD for Atari ST in FPGA\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/qh_TCCgo1xY\"\u003eMiSTeryNano #17: C64 on Tang Nano 20K\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/IOfeoJvnrmE\"\u003eMiSTeryNano #16: Atari ST MIDI Space Quest 3 on Roland MT32\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/-kPpSlpkzvA\"\u003eMiSTeryNano #15: Power Without the Price: The Tang Nano 20k is the cheapest Atari ST\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/w8RZCzeMpiw\"\u003eMiSTeryNano #14: Cubase MIDI audio replay with Atari ST FPGA and SAM2695\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/o6ABtje7zZ8\"\u003eMiSTeryNano #13: Atari ST in Tang Nano 20k FPGA running Cubase 3 from Harddisk image\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/UPiLkYA_o0o\"\u003eMiSTeryNano #12: Atari ST first boot from virtual hard disk\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/NP1EnRj4Fk0\"\u003eMiSTeryNano #11: Advanced SD card for FPGA Atari ST\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/zsHYcolqtpc\"\u003eMiSTeryNano #10: New OSD for the FPGA Atari ST\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/bP5gK3nmv-o\"\u003eMiSTeryNano #9: Tang Nano 20k as USB host\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/jjps1x1NjhE\"\u003eMiSTeryNano #8: Atari ST with USB keyboard and touchpad\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/Ud1P1vE5j84\"\u003eMiSTeryNano #7: Tang Nano 20k running Atari ST Oxyd2\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/EXPfdhlpuFI\"\u003eMiSTeryNano #6: B.I.G. DEMO\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/xJHF-LlaHFo\"\u003eMiSTeryNano #5: Playing Atari ST Frontier\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/FfL01D0Zg0o\"\u003eMiSTeryNano #4: Drives and Blitter\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/9wFxQvKtOY8\"\u003eMiSTeryNano #3: We got a rainbow!\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/yLxXRR_04UE\"\u003eMiSTeryNano #2: Booting TOS 1.04 for the first time\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"https://youtube.com/shorts/qndojsbH9jw\"\u003eMiSTeryNano #1: Is the Tang Nano 20k the cheapest and smallest Atari ST?\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\n## Getting started\n\nIn order to use the MiSTeryNano the following things are needed:\n\n  * [Tang Nano 20k FPGA board](https://wiki.sipeed.com/nano20k) to run the MiSTeryNano core\n  * [M0S Dock](https://wiki.sipeed.com/hardware/en/maixzero/m0s/m0s.html) to connect USB keyboard and mouse\n  * a breadboard to wire everything up and some jumper wires, or\n  * [a MiSTeryShield](board/misteryshield20k/)\n  * a USB-C to USB-A adapter to connect regular USB devices to the M0S Dock\n\n![MiSTeryNano breadboard](images/misterynano_bb.jpeg)\n\n## Installation\n\nThe installation of MiSTeryNano on the Tang Nano 20k using can be done\nusing a [Linux PC](INSTALLATION_LINUX.md) or a\n[Windows PC](INSTALLATION_WINDOWS.md).\n\nSee the [trouble shooting guide](TROUBLESHOOTING.md) if you run into problems.\n\n## Wiring\n\nThe properly flashed Tang Nano 20K will boot into the Atari ST desktop\neven without anything else connected. But in order to use the system\nyou need at least a keyboard and most likely also a mouse. These are\nusually connected through the M0S Dock.\n\nAdditional connections exist for a physical DB9 joystick or\nAtari ST mouse and MIDI IN and OUT. The usage of these pins\nis optional. They can just be left unconnected. A joystick may\nthen be connected via USB instead.\n\n![MiSTeryNano wiring](images/wiring_spi_midi.png)\n\n## Usage\n\nThe MiSTeryNano is mainly controlled through an on-screen-display (OSD)\noverlaying the main Atari ST screen. The OSD is opened using the F12\nkey. It can then be used to select floppy and harddisk images and to\nconfigure the running system.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharbaum%2Fmisterynano","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharbaum%2Fmisterynano","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharbaum%2Fmisterynano/lists"}