No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 5bb7ef0 Sep 10, 2018
Permalink
Failed to load latest commit information.
jt12 Turbosound: fix PSG prescaler, some tweaks. Aug 18, 2018
releases Release 20180910. Sep 10, 2018
sys CPU speed switch code refactoring. Sep 10, 2018
t80 T80: update to latest version. Sep 9, 2018
.gitignore Update sys. Support for FullHD, I2S audio, volume control. Feb 18, 2018
README.md Update ReadMe. Sep 10, 2018
clean.bat Update sys. Support for FullHD, I2S audio, volume control. Feb 18, 2018
compressor.sv Revert "Compressor without BRAM." Aug 18, 2018
ddram.sv GS: use DDR for RAM. Aug 19, 2018
dpram.v Add General Sound (352KB). Aug 18, 2018
gs.v Fix General Sound. Limit GS RAM to 2MB. Aug 24, 2018
gs105b.mif Fix General Sound. Limit GS RAM to 2MB. Aug 24, 2018
keyboard.sv Some fixes. Jul 19, 2018
mouse.v Mouse: fix warning. Dec 13, 2017
saa1099.sv Add support for SAA1099 PSG. May 30, 2018
sdram.sv Support for more HDMI resolutions. Integrate QSYS building into compi… Dec 13, 2017
snap_loader.sv Implement Z80 snapshot loading. Sep 10, 2018
tape.sv Back to SDRAM use. Aug 25, 2017
turbosound.sv YM2203 uses less audio bits due to half amount of channels. Jun 2, 2018
u765.sv u765: add timing constraints, better weak sector fuzzing Aug 4, 2018
video.sv T80: update to latest revision. Jul 19, 2018
wd1793.sv WD1793: adjust write protect flag. Aug 26, 2017
ym2149.sv Update YM2149/YM2203. Sep 9, 2018
ym2203.sv Update YM2149/YM2203. Sep 9, 2018
zxspectrum-lite.qsf Implement Z80 snapshot loading. Sep 10, 2018
zxspectrum-lite.srf Add General Sound (352KB). Aug 18, 2018
zxspectrum.qpf Initial commit. Jun 13, 2017
zxspectrum.qsf Implement Z80 snapshot loading. Sep 10, 2018
zxspectrum.sdc u765: add timing constraints, better weak sector fuzzing Aug 4, 2018
zxspectrum.srf Update sys. Support for FullHD, I2S audio, volume control. Feb 18, 2018
zxspectrum.sv Fix Multiface screen copy register. Sep 10, 2018
zxspectrum_Q13.qpf Update sys. Add Q13 Lite project for rapid compilation. Sep 9, 2018
zxspectrum_Q13.qsf Implement Z80 snapshot loading. Sep 10, 2018
zxspectrum_Q13.srf Update sys. Add Q13 Lite project for rapid compilation. Sep 9, 2018

README.md

ZX Spectrum 128K for MiSTer Board

Some verilog models from Till Harbaum Spectrum core were used in this project.

Features:

  • Fully functional ZX Spectrum 48K, 128K, +3 and Pentagon 128 with correct CPU and Video timings.
  • Pentagon 1024K and Profi 1024K memory interfaces.
  • Turbo 7MHz, 14MHz, 28MHz, 56MHz.
  • ULA+ v1.1 programmable palettes with extended Timex control.
  • Timex HiColor, HiRes modes.
  • TAP tape format with turbo (direct byte injection) and normal loading.
  • TZX and CSW tape formats with fast(16x) and normal loading.
  • Z80 snapshot loading.
  • TR-DOS (Beta Disk Interface) - TRD(read/write) and SCL(read-only) images.
  • G+DOS (MGT +D Disk Interface) and IMG, MGT images (only in non +2A/+3 memory modes).
  • +3 Disk drive usable with +3DOS.
  • Multiface 128 and Multiface 3 (in +3 mode) add-on.
  • Memory snapshot save/load in +D and Multiface.
  • Kempston Mouse.
  • Joysticks: Kempston, Sinclair I/II, Cursor
  • General Sound with 512KB-2MB of RAM
  • Turbosound-FM (dual YM2203 incl. dual YM2149)
  • SAA1099

Installation:

Copy the *.rbf and spectrum.rom files to the root of the SD card.

Notes about supported formats:

TRD is TR-DOS image used with Beta Disk Interface (BDI). To use TR-DOS you need to choose TRD image in OSD first. In 128K mode use menu to enter TR-DOS. In 48K mode use command RANDOMIZE USR 15616 to enter TR-DOS. In +3 mode, enter to 48K mode from the +3 BASIC via the USR0 command, then issue RANDOMIZE USR 15616. Use command RETURN to leave TR-DOS.

IMG is G+DOS image used with +D Disk interface. Although it's fully supported, i couldn't find any games on such disks. The main purpose of these images is to use snapshot function of +D and Multiface.

MGT is G+DOS and MasterDOS (SAM Coupe) image. It's similar to IMG but uses different layout. The main purpose is to transfer data to/from SAM Coupe.

DSK +3 disk format. In none- +3 modes, +D tries to mount it, however +3 disk images are not compatible with G+DOS. The original +3 disk drive is a single-sided single-destiny drive, but this core supports double-sided double-destiny images, too. An empty DSDD image is great for saving from Multiface. Note: in +3 mode, both the Beta and the +3 disk drive are supported, but only one image can be mounted, so both cannot be used at the same time.

TAP is simple tape dump format. It is possible to use normal and turbo loading (only if application uses standard loading routines from ROM). To load in turbo mode, you need to choose TAP file in OSD first and then start to load app through menu (128K) or by command LOAD "" (48K, 128K). To load TAP file in normal mode through internal AUDIO IN loop, you need to start loading through menu or command first and then choose TAP file though OSD. If application uses non-standard loader, then TAP file will be played in normal mode automatically. Thus it's safe to always choose the turbo mode. Some applications are split into several parts inside one TAP file. For example DEMO apps where each part is loaded after finish of previous part, or games loading levels by requests. The core pauses the TAP playback after each code part (flag=#255). If application uses standard loader from ROM, then everything will be handled automatically and unnoticeable. If app uses non-standard loader, then there is no way to detect the loading. In this case you need to press F1 key to continue/pause TAP playback. Do not press F1 key while data is loading (or you will have to reset and start from beginning). To help operate with TAP (for non-standard loaders) there is special yellow LED signaling:

  • LED is ON: more data is available in TAP file.
  • LED is flashing: loading is in process.
  • LED is OFF: no more data left in TAP file.

In normal mode, while TAP loading, the following keys can be used:

  • F1 - pause/continue
  • F2 - jump to previous part (if pressed while pilot tone), or beginning of current part (if pressed while code is transferring).
  • F3 - skip to next part

If game uses non-standard loader, then loading usually paused after loading of first part. Press F1 to continue loading.

OSD option Fast tape load increases CPU frequency to 56MHz while tape loading.

Use F10 key to switch into 48K basic (won't lock 48K mode) and automatically enter LOAD "" if game/app doesn't load from 128K menu.

Turbo modes

You can control CPU speed by following keys:

  • F4 - normal speed (3.5MHz)
  • F5 - 7MHz
  • F6 - 14MHz
  • F7 - 28MHz
  • F8 - 56MHz
  • F9 - pause/continue Speed can be controlled from OSD as well.

Due to SDRAM speed limitation 28MHz and 56MHz speeds include wait states, so effective CPU speed is lower than nominal.

Memory Configurations with extra RAM:

  • Pentagon 512K uses bits 6 and 7 in port 7FFD to access additional memory.
  • Profi 1024K uses bits 0-2 in port DFFD to access additional memory.

Mouse and Joystick:

Kempston mouse has no strict convention which bit (D0 or D1) reflects a main button. After each reset, the first button pressed on mouse (left or right buttons only) will be represented by bit D0 (other button will be represented by bit D1). So, if you are not satisfied by mouse button map, then simply press reset and then press other button first. Due to port conflict with Kempston joystick, core uses autodetection. Any mouse activity will switch port to mouse control. Any joystick activity will switch port to joystick control. Some games/apps autodetect the mouse. So, move the mouse or click its button before use such games/apps.

Snapshots:

Core supports snapshot functionality of +D. In order to use it, you need to mount IMG or MGT image. ROM includes preloaded G+DOS image, thus you can mount IMG/MGT at any time (even while playing the game). Note #1: preloaded G+DOS has been patched to allow disk change on-the-fly. So, if you will load G+DOS from disk, then be careful - it may corrupt previous saves if you will change the disk! Note #2: only one disk image can be mounted at any time. Thus make sure if you use game from TRD image, the game won't save anything later to its disk.

To save snapshot using +D (preferred way), press F11 key. You will see stripes on border and game will freeze. You can press following keys:

  • 3 - to save the screen.
  • 4 - to save 48K snapshot.
  • 5 - to save 128K snapshot. Original +D ROM requires to press additional Y/N keys in 128K mode to choose the correct screen buffer. Included ROM has been pre-patched to automatically detect the screen. So, just press 5 for 128K snapshot.

To load snapshot, just mount IMG/MGT and go to basic prompt where type CAT 1 to list its content. Note the number of snapshot file. Then type LOAD pX where X is the number of shapshot file. For other disk commands please find and read G+DOS (MGT +D) manual.

Multiface 128 and Multiface 3:

You can enter Multiface ROM using RShift+F11. Multiface 128 includes preloaded debugger (Genie) where you can trace or modify the game. If you prefer to use bare Multiface 128 ROM then do following procedure: Press and hold ESC, then press RShift+F11. You will be able to use bare Multiface ROM by simple subsequent presses of RShift+F11 till core reload. Multiface provides snapshot functionality by saving to IMG/MGT disks. Please find and read Multiface 128 manual. Note: Multiface 128 expose its port, thus if game has protection against Multiface, it won't work, unless you press (o)ff before you exit from the Multiface menu. Thus using +D snapshot is prefered. When using the Spectrum +2A/3 mode, the Multiface 3 is supported. There's no Genie for the +3, but there are useful toolkit routines in the stock ROM.

Special Keys:

  • Ctrl+F11 - warm reset
  • Alt+F11 - cold reset will disk unload
  • Ctrl+Alt+F11 - reset to ROM0 menu
  • F10 - switch to Basic 48 (without 48K lock) and issue LOAD""
  • RShift+F10 - same as F10 with 48K lock
  • F11 - enter +D snapshot menu (or ROM0 menu if IMG/MGT not mounted)
  • RShift+F11 - enter Multiface 128 menu
  • F12 - OSD menu

Quick switch between models:

  • Alt+F1 - ZX Spectrum 48K (48KB, ULA-48)
  • Alt+F2 - ZX Spectrum 128K (128KB/+2, ULA-128)
  • Alt+F3 - ZX Spectrum +3 (128KB +3, ULA-128)
  • Alt+F4 - Pentagon 48K (48KB, Pentagon)
  • Alt+F5 - Pentagon 128K (128KB, Pentagon)
  • Alt+F6 - Pentagon 1024K (1024KB, Pentagon) CPU speed will reset to original.

Download precompiled binaries and system ROMs:

Go to releases folder.