ZXDS 3DS

ZXDS
ZXDS
General
Author	Patrik Rak
Type	Computer
Version	2.2.0
License	Mixed
Last Updated	2021/12/24
Links
	Download
	Website

ZXDS is an emulator of Sinclair ZX Spectrum for Nintendo DS and 3DS, written by Patrik Rak. It accurately emulates Spectrum 48k, 128k, +2/+2A/+3, and Pentagon, and supports SNA/Z80/SZX snapshots, TAP/TZX/PZX tape files, TRD/SCL/DSK disk files and RZX replay files. It has some other noteworthy features, like the ability to download all these files online over WiFi, peer-to-peer WiFi multiplayer, or Kempston mouse emulation.

Features

Solid Z80 core.
Full 128k paging support.
Reasonable Pentagon emulation.
Precise screen emulation.
Primitive border emulation.
Good 48k/128k snapshot support.
Full TAP support.
Reasonable TZX support.
Full PZX support .
Virtual tape deck.
Good TRD/SCL support.
Builtin disk browser.
Good RZX support.
POK files support.
ZIP archives support.
Online WiFi access.
Peer-to-peer WiFi multiplayer.
Save state support.
Screenshot support.
Configurable input support.
Fully customizable keyboard.
Kempston mouse emulation.
Memory viewer and disassembler.
Text and binary file viewer.
Statistics tracking.
Favorite/recent files tracking.
Battery friendly.
Skinning support.
Builtin help system.

Installation

Copy the entire ZXDS directory (not just its content, but the directory itself) to the root of your SD card, making sure that even the empty subdirectories are copied.

Then copy ZXDS.3dsx to the 3ds directory of your SD card and run it with Homebrew Launcher.

Alternatively you can install ZXDS.cia with a CIA manager of your choice.

The other directories in the archive contain various extras (e.g. games, demos, templates for custom menus and keyboards), some of which you may want to put on the SD card as well.

Note: In order to run properly and generate audio, you will also need to have the DSP firmware (dspfirm.cdc) installed.

User guide

Simply run ZXDS the same way you run any other application.

Upon startup, follow the builting online help which shall provide you with all the instructions you will need (remember to turn the help off once you get familiar with individual icons and menus, it would only slow you down otherwise). You will basically need to load some file via Load File screen of I/O menu (pressing Start gets you there quickly by default), then perhaps adjust controls via the Controls screen, and you are all set.

A few Spectrum games and demos are included in the archive itself to try out. See also the list of recommended games by the author.

Software for ZXDS

Below is a list of recommended sites if you are interested in finding more games and other software for use with the emulator:

World of Spectrum Classic Archive and TZX Vault.
Spectrum Computing for newer production.
ZX Spectrum site.
ZX AAA Demo, Demotopia, Pouët.net or Virtual TR-DOS for demos.
RZX Archive for RZX replay files. Best way to check out the games you always liked but never managed to finish.

Key mappings

The control mapping can really make a difference, so make sure customize it the way you like it most for any serious gaming.

For example, in case you have problems pressing the diagonals, it helps to map the up direction to the B button as well. This way you can jump sideways with ease. And mapping the quick save and quick load actions to the shoulder buttons gives you an instant save and load at the touch of the button, priceless feature for the hardest parts of the game you are playing.

Screenshots

Changelog

2.2.0 2021/12/24

RZX recording, including support for rollback and resume. Simply save file with .rzx suffix to start the recording.
RZX recordings can share external snapshot placed in the same directory. Load the snapshot after starting the (preferably paused) recording to use it.
Recording playback of another RZX, both entire or part of, is supported, too. This makes it possible to resume RZX files which were already finalized.
RZX recording can start both before or during a multiplayer session as well. Just remember to use rollback on the recording machine to avoid recording of the rewind actions.
RZX playback was updated to support forced frames introduced in RZX format 0.14.
Saving snapshot files in save requester no longer overwrites the UNDO buffer. This makes UNDO work as expected even in multiplayer, especially after rollback is used.
Local SZX snapshots now support external media in their original location in other directories.
Few minor improvements (confirmation backlight, SZX and Z80 pre-save stepping, help word wrapping).
Few subtle bugfixes (RZX jumbo frames, RZX tape warping, RZX rollback seek, tape parsing, async I/O).
Dedicated to Daren Pearcy. So sad you couldn't try it out.
In memory of Sir Clive Sinclair. Thank you for everything.

2.1.1 2020/12/24

Added experimental barebone .cia binary. Use entirely at your own risk.
ZXDS now refuses to run if it can't find its installation directory to prevent incomplete installation.
Fix for proper rollback of media in case the user truncated it afterwards.

2.1.0 2020/12/20

Rollback allows rewinding the time up to 5 minutes back. Bind it to any convenient button like Y or L/R for best experience.
Rollback can be used to rewind the RZX playback as well.
Multiplayer session is now automatically resynced after rollback, quick load, or load slot is used.
Added two options for zooming the main screen. It's blurred, but some people may prefer it nevertheless.
The custom menu can be customized by tapping the menu icon after tapping an action in the controls screen.
Merry Christmas.

2.0.2 2020/04/13

Created lists for ZXDB entry in servers.cfg.
Fixed downloading from HTTPS sites by detecting non-standard EOF properly.
Happy Easter.

2.0.1 2020/02/02

Fixed top screen issues of 2DS and 3DS XL models by slowing the LCD display differently. Thanks Nige.
Disabled turning off of bottom screen backlight on 2DS as for some reason it affects both screens.
The optional ZL and ZR buttons are now bound to quick load and quick save actions, respectively.
Considerably increased speed of scanning directories.
Few more subtle changes (async file flush, display speed adjustment only at normal speed).

2.0.0 21.12.2019/12/21

First native release for Nintendo 3DS.
Proper border emulation.
Floating bus emulation for +2A/+3 models.
Downloads now support the HTTPS scheme.
Increased the number of save slots to sixteen.
Screenshots can be now saved with or without the border area.
Increased some other limits (128MB download cache, 4MB file buffer).
Quit now finally quits to the launcher menu. But you can use the HOME button, too.
Work around for TZX files which use incorrect STOP block size.
Few subtle bugfixes (mouse mode init, inputbox capslock, load registers).
Merry Christmas.

1.3.4 2017/04/23

HALT is now correctly contended by PC+1, not PC.
To give the user a clue, incompatible multiplayer peer is now detected and reported, if possible.
Happy birthday, Speccy.

1.3.3 2014/12/24

Upon startup, let Start show the most recent files only if there are any.
Properly handle save slot medium if all ten medium slots are still being used.
When statistics become full, don't discard entries which might still be part of the recent list.
When global statistics are loaded, pick the latest version under all circumstances.

1.3.2 2014/11/22

Fixed libfat bug which could make corrupt directory entry after the last entry was deleted. You might have experienced this mostly when renaming files or moving them around.
Fixed couple more libfat bugs (really long names, alias creation, whitespace trimming).
Added caseinfo extension to libfat so letter case of 8.3 names is now read properly.
Medium associated with persistent copy of save slot 0 is never deleted prematurely anymore.
Save slot medium removal is now postponed to further improve chance of media reuse.
Few other subtle changes (cache filenames, file name trimming, minor help tweaks).

1.3.1 2014/07/10

Fix the initial main screen palette which could get messed up on some cards.
Make the mouse help window look like all the other help windows.

1.3.0 2014/07/01

ULA+ emulation for all Sinclair and Amstrad models.
Support for all types of 3.5" double sided +3DOS disks.
Raw screenshots now support the ULA+ extension for both saving and loading.
Current ULA+ palette can be changed simply by loading the appropriate ULA+ palette tape files.
Other ULA+ related changes (BMP screenshots, thumbnails, SZX support).
The selected ULA mode as well as the display mode are now part of the config file.
You can now keep your desired custom configuration persistent separately in custom.cfg.
Sector viewer now displays bottom side track addressing info in inverse colors.
Reverted special treatment of full size TR-DOS disks, so padded images work again.
Minor +3DOS fixes (gap3 reading, EDSK track padding, SZX disk side selection, motor bit disabling)
Loading a POK file now automatically shows the poke screen. Pressing Y switches back, as usual.
Reading attributes from unmapped ports on Pentagon now mimics the real hardware mod behavior.
Other subtle emulation accuracy improvements (+2A/+3/Pentagon screen timing, 128K/+2 INT duration).
Many internal changes (optimized screen sampling, optimized contention, async palette switching).
Other subtle changes (UNDO media keeping, CPU stepping prior snapshot save, volume mode order).
Minor bugfixes (media slot release, paths set to root dir, filter in root dir, allowed filter chars).
Happy birthday, and thanks for all the fish.

1.2.0 2014/02/19

Proper Spectrum +2/+2A/+3 emulation, including contention and everything.
Support for +3DOS 3" DSK/EDSK disks, including formatting, autoboot and disk browser.
TR-DOS formatting now also works for all possible disk format types.
File and directory name filtering is now available in file requester.
All keyboard keys are now sticky whenever the emulation is paused.
In load requester, L/R+Y now shows the other medium than Y does.
Button input in file viewer can be now toggled with icon or L/R+X and Pause.
Full size TR-DOS disks are now always treated as double track and double sided.
Alternate save/load directories now work better and even with filter enabled.
Various internal changes (ROM deltas, SZX +3DOS support, plus model stats, media icon).
Minor bugfixes (FTP files caching, hex decoding, TR-DOS BASIC start line).
Dedicated to my beloved parents. Thanks for getting me my first Speccy.

1.1.1 2012/12/24

Spectrum +2A/+3 snapshots are not rejected right away anymore. Instead, they are executed in 128K mode with extended paging enabled. This makes some +2A/+3 RZXs and exclusive software work quite fine.
Added a bit of color coding to the controls screen.

1.1.0 2012/12/20

Custom ROMs support. See roms/readme.txt for more info.
IF2 ROMs and 48k/128k ROMs can be loaded directly in load requester.
Both SZX and Z80 snapshots now support custom ROMs as well.
TR-DOS/Beta Disk support for all models, not only Pentagon. Simply choose the model or reset the machine while a disk is loaded. You can also autoboot any disk with current model by using R+A.
Beta 128 in 48k mode responds even to the standard Beta 48 entry points. This makes both Beta 128 and many Beta 48 programs work at the same time.
True Beta 48 mode can be enabled with proper beta48.rom (such as TK90X's CBI95 ROM).
Added NMI aka Magic button - becomes useful with some custom ROMs.
Added custom keyboards for more games as well as one for more comfortable text typing.
Added Virtual TR-DOS games and ZX AAA demos sites to servers.cfg.
Pressing Start twice upon startup now takes you to the last used files view.
Few subtle changes (save slot media loading, ROM launch stats).
Little optimizations (Z80 core, sound generation, normal speed load mode).
Subtle emulation improvements (authentic SCF/CCF, MEMPTR and AY white noise).
Minor bugfixes (grayscale border, step direction bit).
Merry Christmas.

1.0.0 2012/07/01

Custom keyboard support. See custom/readme.txt for more info.
Favorite/recent files lists showing up to 500 most/last used files.
TR-DOS disk browser for viewing both disk directory and sector data. It can be used to insert empty disk images as well.
TR-DOS disk images can be now saved in SCL format, too.
Keep the file viewer visible while enabling button input by pressing R.
Little UI graphics improvements (nicer icons, empty requesters).
Added skins/light/style.cfg for those who prefer black text on white.
Few subtle TR-DOS changes (density check, zero files SCL).
Few subtle tape related changes (tape block flush, PZX fast loading test).
Other subtle changes (widget help tracking, virtual files stats).
Minor bugfixes (IN[ID](R) postdecrement, libfat lseek).

0.9.9 beta 2 2012/04/24

The paused time is now not counted towards the current file times.
The sleep time is now not counted towards any times but sleep time.
Fixed the stats date display.

0.9.9 beta 1 2012/04/23

Kempston mouse emulation, including dual mouse in multiplayer. See docs/mouse.txt for more detailed info.
Tape deck now supports tape recording and tape block deletion. TAP and TZX tapes can record standard blocks, PZX anything. The recorded tapes can be then saved in save requester like other files.
Track statistics about overall usage as well as games and apps launched. The statistics are additionally automatically saved every minute by default. If your card is too slow to deal with this and you keep noticing slowdowns, you can increase stats_write_timeout or set it to 0 to disable the autosave. You can also remove the ZXDS/stats directory to disable statistics entirely.
Builtin viewer for viewing both text and binary files.
The World of Spectrum online server listings now include text instructions.
The emulation speed can be slowed up to 8 times.
The data dump view now allows poking whole 2byte words at once.
More thorough DLDI startup to work around misbehaving drivers.
Fixed loading of files from the root directory.
Fixed playback of RZXs containing multiple snapshots.
Properly mark SCL disks as such when saving SZX.
Few minor enhancements (improved PZX fast loading, AY register masks).
Other subtle changes (file type recognition, avoid snapshot single step).
Minor bugfixes (delayed IME handling, proper user settings slot).

0.9.3 beta 1 2012/03/17

Proper save requester, including support for basic file management operations.
Alternate between two different directories by tapping the save/load file icon again.
Quickly switch models in load requester with various L/R+X combinations.
Risky operations now use confirmation requesters.
It is now possible to step the emulation frame by frame.
Added pouet.net and Tipshop pokes library to servers.cfg.
Implemented HTTP redirects, required by some pouet.net sites.
Directly poke decimal, hexadecimal, or binary values in the data dump view.
Switched to PNG for background and icon graphics. The BMP support remains, but note that some names have changed - check skins/readme.txt for details.
Augmented the 128k keyboard graphics with symbol characters. Thanks, Paddy.
The selected keyboard is now saved to the config file.
Distinguish the load and save slot screens with colored slot frames.
Disable the keyboard matrix effect during multiplayer session. It is often difficult enough to configure the controls even without it.
Switching to maximum speed while loading tapes in fast mode now disables the display updates entirely. Handy for slight speed boost if you feel desperate.
Other subtle changes (nicer boot message, increased cheat poke limit).
Fixed loading of Pentagon SZX files (ROM paging, step direction).
Minor bugfixes (libfat mkdir and aliasing, skipping of long names in ZIP).

0.9.2 beta 1 2010/11/09

Peer-to-peer WiFi multiplayer for 2 players.
SZX snapshots support.
RZX playback now supports external snapshots.
Save slots now use SZX instead of Z80. Existing Z80 slot files are still loaded, though, and you can delete them manually once you don't need/want to keep them.
Save slots now save the associated tape/disk into a separate file if needed as well. Disk is saved once and then only whenever it is modified, tape is saved only once and only if it is not positioned at the beginning or the very end.
Lot of internal changes (save states cache, icon buffering, bigger file buffer).
Few subtle TRDOS fixes (eject during sector write, access to high tracks of SD disks).
Subtle changes (2x faster change to parent directory, no cd to zip in zip, WiFi IPC sync).
Changed grayscale palette to match the luminance of the real Spectrum.

0.9.1 beta 1 2010/08/13

Memory viewer and disassembler.
Tape sound is now audible in normal speed load mode (conveniently forced with R+A).
The system log can be saved to a file now, helpful when troubleshooting.
Cleaned up the virtual directory code, greatly reducing the amount of required IO accesses.
Changed the confusing bouncing logic of previous displays' history to simple LRU.
Fixed the annoying sound clicks when sound is temporarily paused (e.g., scrolling in requesters).
Minor bugfixes in download code (HTTP continuation lines, last line EOL in listings).

0.9.0 beta 2 2009/03/20

Added proper initial FIFO sync which shall make WiFi init work on all cards.
Reenabled automatic loading of .cfg and .pok files which was accidentally disabled before.
Added early boot message so people can see something is going on if boot takes a bit longer.
The r4tf.dldi driver is not patched in, as these cards now support autopatching. Also note that for the same reason and to avoid excess garbage the latest libfat library doesn't include any builtin DLDI drivers anymore, so if you have some older card, you may need to DLDI patch ZXDS yourself even if you hadn't to do that before.

0.9.0 beta 1 2009/03/12

Support for download of files from HTTP and FTP servers over WiFi.
Virtual directory system for creating arbitrary listings of both local and remote files. Config for World of Spectrum, RZX Archive and Demotopia data feeds included. See docs/online.txt for how to create the listings and setup your own servers.
The data_path, saves_path and screens_path are now configurable.
Help now finally uses the variable width font as I always intended.
Stick to the Zilog behavior regarding SCF/CCF undocumented flags.
Built with the latest devkitPro release, should solve most libfat/DLDI issues.

0.8.1 beta 2 2008/12/03

Tweaked RZX code to work with more nonconformant but commonly available recordings.
Worked around sound clamping while keeping the sound loud by throwing dummy sample into the mix.

0.8.1 beta 1 2008/11/27

RZX playback (no SZX snapshot support yet, though).
Files stored in ZIP archives can be browsed and loaded directly.
Support for poke cheats in POK file format, including autoload.
Added log screen for better problem diagnostics, especially those RZX related.
Turn off the bottom screen backlight after configurable timeout.
Automatically save state and enter sleep mode when the lid is closed.
Alternatively boot from saves/boot.z80 instead of last session state.
Skip loading of either state upon startup when L/R buttons are held.
Replaced few busy loops with inactive waits to further improve battery life.
Improved the last menu action to cycle through all recently used views.
Extended the range of both AY and speaker samples to make the sound louder.
Tweaked the Z80 snapshot loading code to support some less conformant files.
The HALT instruction now updates the R register properly.

0.8.0 beta 1 2008/06/19

TR-DOS emulation, allowing loading of TRD/SCL disks (including autoboot).
For/next loops in TZX files are now supported.
Screenshot support, for SCR/BMP saving and SCR loading.
Color/grayscale palette toggle for more nostalgic look.
Mode for black and white display of ink/paper only, without attributes.
AY ACB and ABC stereo modes and narrow/wide stereo separation.
Choice of three relative AY and speaker volume levels.
Changed AY volume tables to match the real machine more closely.
Implemented fake low-pass AY filter to avoid aliasing issues in some tunes.
Fixed setting of AY envelope register even if it doesn't change, fixes few sound effects.
Fixed sound clamping when all AY channels played at full volume and speaker was off.
Few other subtle changes (initial config autosave, even more safe shutdown).

0.7.0 beta 2 2007/12/24

Implemented normal speed loading, to make loader minigames playable.
Quick fix for launchers which don't set the initial display state properly.
Should make the bottom screen properly visible for DS Extreme users.

0.7.0 beta 1 2007/12/21

Finally added keyboard graphics, for both 48k and 128k keyboard.
Replaced the ad-hoc file requester with proper touch screen version.
Configurable button to key/action binding, with 9 predefined customizable settings.
Tape browser and manual tape control.
Autoload feature, with both tape-loader and USR0 mode support.
Skinning support for changing graphics and color of each UI element.
Builtin online help.
Pentagon emulation (no TR-DOS yet, though).
Z80 snapshots are now compressed.
Added 1 forgotten T state to EX (SP),* instructions.
Fixed #7FFD paging decoding (A15+A1 instead of A14-15+A1), more demos now work.
Changed #1F kempston joystick decoding (loose A5 instead of strict A5-A7), more games should work.
Disable autoplay when tape end is reached, more flawed tape files should now load.
Few other subtle fixes (triple buffering race, halt timing upon requester).

0.6.0 beta 1 2007/10/10

Full memory and IO contention emulation.
Proper floating bus emulation.
T-state accurate screen sampling.
About everything should now work like on real machines, including multicolor effects.
Accurate speaker synthesis instead of discrete sampling.
Screen is now triple buffered and the LCD refresh rate is synced to 50Hz. This results in extremely smooth and tearing-free display.
Fixed opening of files from directories of varying depth. It sometimes failed before due broken chdir(), so full names are used now instead.
Few subtle fixes regarding snapshots (#7FFD, IFF2, T counter, tape eject).
Dropped the .ds.gba version, as people need to DLDI patch it themselves * before* the loader is appended anyway.

0.5.1 beta 1 2007/08/14

Support for the new PZX tape file format.
File requester finally supports directory browsing.
Fixed on-screen save slot numbers to match the snapshot names.
Included .ds.gba version for people who need it (owners of some Slot-2 based cards, like EZFlash IV and SuperCard) yet don't know how to make one.

0.5.0 beta 1 2007/04/23

Both TAP and TZX tape files are now loaded at high speeds whenever possible.
Z80 snapshots are now supported.
Save state support via in-memory/on-card write-through save slots for 10 Z80 snapshots.

0.0.4 alpha 1 2007/04/13

Sound support, both speaker and AY-3-8912.

0.0.3 alpha 1 2007/04/03

Basic TAP support (no fastloading yet, though).
Basic TZX support (no fastloading, missing support for flow control blocks).
Primitive border support.

0.0.2 alpha 3 2007/03/25

BIT instructions now set the undocumented flags 5 and 3 properly, with the sole exception of BIT n,(HL), as MEMPTR is intentionally not emulated. These flags were always set before, due to lack of documentation.
Instructions IN[ID](R) and OUT[ID](R) now also set the PV flag.
Instructions OUT[ID](R) now set the CY and HC flags correctly. They used the IN[ID](R) behavior before, due to lack of documentation. So ZXDS now passes both ZEXDOC and ZEXALL (sans BIT n,(HL) in the latter).

0.0.2 alpha 2 2007/03/24

Fixed silly typo in the macro testing the Half Carry flag, which grossly broke the DAA instruction and affected flags 5 and 3 after CP[ID](R) instructions. Bit 4 of H register instead of HC was tested by mistake before.

0.0.2 alpha 1 2007/03/21

Primitive file requester, root dir only.
Loads 128k snapshots as well, with interrupts now being enabled properly.
Touch screen now shows at least some minimalistic keyboard layout.

0.0.1 alpha 1 2007/03/20

First release.
Still pretty incomplete, but boots 128k.
Can only load 48k snapshots, though.

Credits

ZXDS itself is written by Patrik Rak, however credit is due as it would not have happened without the following people and their software:

devkitProARM toolchain maintained by Dave Murphy et al.
libnds by Michael Noland, Jason Rogers, Dave Murphy, et al.
libfat by Michael Chisholm.
dswifi by Stephen Stair.
libctru by Jordan Rabet.
citro3d and citro2d by fincs.
zlib by Jean-loup Gailly and Mark Adler.

Furthermore, ZXDS comes with several copyrighted ROM images built in:

ZX Spectrum 48k Basic ROM by Steve Vickers and John Grant, owned by Amstrad. Note that Amstrad have kindly given their permission for the redistribution of their copyrighted material but retain that copyright.
ZX Spectrum 128k Editor ROM by Martin Brennan, Steve Berry, Andrew Cummins, Rupert Goodwins and Kevin Males, also owned by Amstrad.
ZX Spectrum 128k +3 ROM by Rupert Goodwins, Cliff Lawson, and Vik Olliver, owned by Amstrad.
TR-DOS ROM by Technology Research.

Finally, the following software was also helpful during the development:

no$gba by Martin Korth.
Citra by Citra team.
Pro Motion by Jan Zimmermann.

External links

Official website - http://zxds.raxoft.cz