Otherware

home *** CD-ROM | disk | FTP | other *** search

/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / emulator / spectru.lzh / Spectrum.doc < prev next >

Wrap

Text File | 1992-03-18 | 33.8 KB | 940 lines

Sinclair ZX Spectrum Emulator V1.4 17 Mar 1992 ----------------------------------- This program emulates a Sinclair ZX Spectrum 48-kbyte z80-based computer on any Amiga computer. +-------------------------------------------------------------------+ | IMPORTANT: You need to already own a Spectrum to be able to use | | this program. This is because I am not taking the risk of | | distributing the Spectrum ROM code. I think that would probably | | be illegal. Therefore this archive does not include the Spectrum | | ROM code. --- You should supply it independently. | +-------------------------------------------------------------------+ The files in this archive may be distributed anywhere provided they are unmodified and are not sold for profit. Ownership remains with the author, Peter McGavin, 86 Totara Crescent, Lower Hutt, New Zealand. e-mail: srwmpnm@wnv.dsir.govt.nz . I assume you have enough knowledge to manipulate binary files and to transfer data over a serial line without help. If you don't know what I'm talking about, don't try this program. Spectrum-00 is an executable for 68000-based Amigas only. Spectrum-10 is for 68010-based Amigas, but also works on higher processors. Spectrum-20 is optimised for 68020/30/40...-based Amigas with fast memory. Spectrum-00-special is for 68000-based Amigas. It is faster and dangerous. The Spectrum-00-special version takes some shortcuts to get some extra speed. Some games will run 2 or 3 times faster than before, but because of the shortcuts, not all programs will work. In the special version: o Self-modifying z80 code does not work at all. This affects some games. It also means that you will only be able to run one program and then quit. If you try to load a second Spectrum program, without quitting Spectrum-00-special and re-running it first, it very probably won't work. o Code is optimised for faster animated graphics and scrolling, at the expense of speed when the display is static, so you will get faster animated games and slower ray-tracing :-) o The ROM is unprotected. Note that the standard Spectrum ROM corrupts itself. In particular, location 0 usually gets overwritten very quickly, so that NEW does not work any more. Do not try to develop or write Spectrum programs with Spectrum-00-special, because you will probably lose your work. It is provided only because it is significantly faster for running some animated Spectrum games. All the programs require the file "spectrum.rom" (not supplied) in the current directory, or they will not load. The emulator uses the dreaded move-sr instruction after almost every z80 instruction emulated. It ran 30-40% slower when I tried replacing the move-sr instruction with a call to GetCC()! This is quite exceptional --- with most programs you wouldn't notice the difference. Therefore I have supplied a 68010 version which uses move-ccr instead of move-sr. The Spectrum-20 version uses 68020 addressing modes which are not available on lower processors. The program has been tested on a 3.5 Mbyte Amiga 500 and on a 2 Mbyte Amiga 3000 (but it uses only about 300 kbytes). I developed the code, entirely in assembler, in my spare time using z80 emulation code based (originally) on Ulf Nordquist's CP/M emulator (Fred Fish disk 165). I have fixed several bugs in the z80 emulation code, and made it more than twice as fast, but there are still some (very hard to find) bugs. Features: --------- The following Spectrum features are implemented: screen output in the same resolution and colours as a real Spectrum --- includes bright, reverse and flash attributes (looks much better than the old TV!) keyboard implemented at the z80 "in" instruction level. Note that like a real Spectrum you have to hold the key down until it registers. Because the emulator is running slower, you might have to hold keys down longer. More often, you might have to hold your fingers off the keyboard for longer. Make sure the Spectrum window is active when you start to type. See Appendix 1 for key map. kempston joystick implemented at the Z80 "in" instruction level. This uses the rear Amiga gameport. Note that the joystick is active only when the Spectrum window is active. If another Amiga program is currently using the joystick, you will get a retry/no-joystick requester. sound implemented by trapping calls to the "beeper" routine at $03b5 in the Spectrum rom. Sound works with all Basic programs and some machine code programs, but it won't work with machine code programs that bang on the hardware to make sounds. cassette tape loading, if you have a sound sampler capable of at least 20 kHz sampling rate attached to your parallel port. This is implemented by trapping calls to the "ld-bytes" routine at $056b in the Spectrum rom. Note that copy-protected games with custom loaders cannot always be loaded this way. It is possible to save to and load from amiga disk files. That Missing File: ------------------ As already mentioned, a vital file is missing. You must supply an image of the Spectrum's ROM in the file "spectrum.rom". The file must be exactly 16384 bytes long and must contain exactly the same byte sequence as memory locations 0..16383 in the Spectrum. There are several ways to get this across to your Amiga, including: Use the Sinclair Interface 1 serial port connected to the Amiga's serial port. The data can be transferred using a small BASIC program on the Spectrum, then captured on the Amiga with either another small program or a terminal emulation program. Use a Spectrum disk drive system that writes IBM-format sectors, then read the diskettes on your Amiga using MSH (Fred Fish disk 382) or CrossDOS (commercial) and a sector editor like DiskX (Fred Fish disk 158). An MGT PLUS D disk drive will work for this. Find a program that will read Spectrum cassette tapes through an Amiga sound sampler, writing the data to a disk file as it goes. Kristian Nielson (e-mail bombadil@freja.diku.dk) has written a program that will do this. Try looking for specload.lzh at your local PD site. I'll leave it up to you to figure out how to get the data across. You could always type it in :-) There are several third-party books that list the code, e.g, "The Complete Spectrum ROM Disassembly" by Dr Ian Logan and Dr Frank O'Hara, Melbourne House Software Ltd, ISBN 0 86161 116 0, or ISBN 0 86759 117 X, 1983; "The Spectrum Machine Code Reference Guide" by Richard Ross-Langley, Interface Publications, ISBN 0 907563 51 1, September 1983. In fact you can supply any 16384-byte file containing valid z80 code and called spectrum.rom. The emulator will transfer z80 control to location 0. Screen and keyboard hardware is programmed the same as a real Spectrum. (Once loaded, the first 16384 memory locations are readonly.) Please don't ask me to e-mail spectrum.rom to you, because I won't. Operation: ---------- You can start the emulator from either the Workbench or SHELL (or CLI). There are no command-line parameters. If you use the SHELL (or CLI), spectrum.rom must be in the current directory. From the workbench, spectrum.rom should be in the same directory as the program. If the emulator can't find spectrum.rom, then it will display a requester saying so, and it will not run. To use the ARP file requester, you must have arp.library installed in your LIBS: directory. The emulator runs in its own custom screen and window. The emulator does not disable multitasking, and it does not interfere with other tasks (except when loading from a sound sampler). You can drag the screen down or click it to the back with the mouse, in the usual way. (Grab the screen bar to the left of the window to pull it down.) The emulator lowers its own priority to -5, otherwise it would significantly slow down other tasks. Raising the priority back to 0 (e.g, with xoper or artm) does not significantly speed up the emulator on a standard system. Raising it higher will prevent most other tasks from running at all. To exit the emulator, do any of the following: o click the close box with the left mouse button; o select "Quit..." from the Project menu, or o press the ESC key. Menus: ------ Project menu Load snapshot... F1 Loads a disk file that has been created with "Save snapshot", restoring the state of the system to what it was when the snapshot was made. Any currently loaded Spectrum program is lost. Uses the ARP file requester. You can use "Load snapshot..." even if the Spectrum has "crashed", or if you are running a Spectrum program which does not have a "quit" option. The format of a snapshot file is listed in Appendix 2. Save snapshot... F2 Saves the current state of the emulator to a disk file. The entire state of the system is saved, including all 48 kbytes of Spectrum ram and the state of the z80 processor. Uses the ARP file requester. Help... HELP Displays the "Spectrum.help" file, which is a diagram of a real Spectrum keyboard. You need about 70 kb of CHIP ram free for this. Quit... ESC Quits the emulator. (You get a chance to change your mind.) Settings menu LOAD/MERGE/VERIFY... Selects what happens when the emulator executes a Spectrum BASIC LOAD, MERGE or VERIFY command. Note that this has nothing at all to do with "Load snapshot", which always loads from disk. What it does do, is to change the behaviour of the standard Spectrum BASIC tape loading commands, which are normally used to load, merge and verify BASIC programs, array data and binary code, from cassette tape. In fact, this selects what happens when any program (including any machine code program) calls the cassette tape loading routine in the Spectrum rom. You have a choice of: Disk files Select a disk file using the ARP file requester. The data in the file is interpreted as if it is being read from cassette tape. The first byte in the file is the "header" byte, then the raw data, then the checksum byte. The Spectrum normally reads 2 blocks of data from cassette tape, a "header" file followed by the "data" file. These should be stored in 2 separate disk files. The emulator will request both files. I implemented it this way to allow support for "headerless" files which are used by many Spectrum machine code programs. Note that the Spectrum still thinks it is reading from cassette tape, so you might see messages like "Start tape now", even though it is reading from disk. If the file you select is not in the correct format, or if the checksum is wrong, the Spectrum will usually just request the same file again, without any messages, as if it read garbage noise from cassette tape. ProSound Read data from a ProSound sound sampler connected to the parallel port. Other sampler Read data from any other kind of sound sampler connected to the parallel port. The sampler must be capable of at least 20 kHz sampling rate and it must be connected to the parallel port (not the game port). You should be able to feed standard Spectrum cassette tapes in. Some copy-protected programs have custom loaders that will not work in the emulator. It is possible to connect the Spectrum EAR output to the sound sampler to transfer data directly from your Spectrum. (Use a SAVE command at one end, and a LOAD at the other.) Important: Interrupts on the amiga are disabled while you are loading from a sound sampler. This will interfere with other tasks. For example, a file transfer running in the background will probably fail. It seems as if the whole amiga has frozen while interrupts are disabled. To restore control, click the left mouse button. SAVE... Selects what happens when the emulator executes a Spectrum BASIC SAVE command. Note that this has nothing at all to do with "Save snapshot", which always saves to disk. What it does do, is to change the behaviour of the standard Spectrum BASIC SAVE commands, which are normally used to save BASIC programs, array data and binary code, to cassette tape. In fact, this selects what happens when any program (including any machine code program) calls the cassette tape saving routine in the Spectrum rom. You have a choice of: Disk files Select a disk file using the ARP file requester. The data that would normally be written to cassette tape is written to the selected file instead. The first byte in the file is the "header" byte, then the raw data, then a checksum byte. The Spectrum normally writes 2 blocks of data to cassette tape, a "header" file followed by the "data" file. These should be stored in 2 separate disk files. The emulator will request both files. I implemented it this way to allow support for "headerless" files which are used by many Spectrum machine code programs. Note that the Spectrum still thinks it is writing to cassette tape, so you might see messages like "Start tape, then press any key". Audio Not implemented in V1.4. More on Reading Cassette Tapes: ------------------------------- To load a cassette tape through your sound sampler, enter LOAD "" (that is, J followed by ALT/P twice, then RETURN). Now start the cassette tape playing into your sound sampler. If it is working, the screen should flash colours, very much like your Spectrum, and the mouse pointer will be frozen. If you got a file requester instead, then you forgot to select your sound sampler type for "LOAD/MERGE/VERIFY..." in the "Settings" menu. The MERGE and VERIFY commands should also work, as should things like LOAD "" CODE, etc. If the screen is mostly yellow and blue, the load is working. If it is flashing mostly red, it is either synchronising or not working. If it is not flashing at all, it is not working at all. If it doesn't work, try adjusting the volume and tone controls on the tape recorder. If you have trouble, try adjusting the controls while sampling with software that came with your sampler. Ideally, the input should be a square wave which fills the graphic display. If it still doesn't work, tell me about it. You should be able to save directly from your Spectrum to the Amiga with a direct connection --- i.e, no cassette tape or recorder at all. Use a SAVE command on the Spectrum and a corresponding LOAD command in the emulator. Loading works by intercepting calls to the LD-BYTES routine at location $056b in the Spectrum ROM. If a Spectrum program has its own loading routine, then it won't work. Some copy-protected games and fast-loaders are like that, and they will not work. On the other hand, some Spectrum programs call LD-BYTES to load headerless tape files. Those programs should work fine. The following sound samplers should be suitable, but I have not had the opportunity to test any except the first: o ProSound o Perfect Sound o Datel DSS o Future Sound Note that the tape-loading routine disables interrupts for the whole time it takes to load a tape. That greatly exceeds Commodore's recommended limit of 250 microseconds. While interrupts are disabled, the mouse pointer freezes, the keyboard is locked out, all other tasks stop, and any data arriving at the serial port is lost. If I knew another way to make it work, I'd do it that way. As far as I am aware, all sound sampling software on the Amiga disables interrupts for excessive periods. The Spectrum loader has to interpret the incoming data in real time, which is quite a lot more than just saving it to a buffer in memory. To break out of the load routine without actually loading anything, press the left mouse button. The Spectrum BREAK key (SHIFT/SPACE) won't work in this situation. If the keyboard doesn't work after you break out with the left mouse button, it's probably because you accidently deselected the window (by clicking outside it). Just click anywhere inside the Spectrum window and the keyboard will work again. The load routine is based on code kindly provided by Kristian Nielson. It has been tested on both standard and accelerated amigas. General Notes: -------------- o The emulator runs about 2 to 8 times slower than a real Spectrum, on a standard 68000-based A500. If you are the lucky owner of an Amiga 3000, the emulator runs faster than a real Spectrum, but make certain it's running out of FAST ram. If you run it out of CHIP ram, then it's more than twice as slow. I'm afraid the 68000 doesn't have a built-in z80 emulation mode, and a 3.5 MHz z80 is much harder to emulate than a 6502 as used in the Commodore 64 and BBC microcomputers. The Spectrum NEW command takes 9.7 seconds on an A500, compared with about 2.0 seconds on a real Spectrum, 1.8 seconds on an A3000 (in FAST static-column ram), and 1.6 seconds on a 33MHz Mega-Midget-Racer with 32-bit ram. o This version of Spectrum uses the blitter to refresh the screen in parallel with the emulator. That is, it uses multi-processing. Thus, the overhead of a z80 instruction writing to the Spectrum's display file is minimised. Before you A3000 owners complain that the 68030 is faster than the blitter for blitting, remember that while the blitter is refreshing the screen, the 68030 is busy emulating the z80. The program uses QBlit() for concurrency, not OwnBlitter() which would block the z80 emulator. o I've just about run out of ideas on how to significantly speed up the code from what it is now. One thought is to code some common ROM routines in pure 68000. Obvious candidates are the text output, scrolling, and maskable interrupt routines. Of course this would only speed up programs that call the ROM, which excludes most games. Also, It would probably be illegal. The major speed bottleneck used to be the z80 instruction decode. I've pretty well eliminated that by going to threaded code. The display routines are about as fast as I can get them. Taking over the machine and doing everything at the hardware level would probably give only a slight speed improvement, and the program would become much less friendly and less portable. o In version 1.4, the following Spectrum features are NOT implemented yet: border colour (except during cassette tape loading); saving to cassette tape; bank roms (e.g, Interface 1); o The following z80 features are NOT properly implemented: the z80 h processor flag; the z80 daa instruction (decimal adjust a) --- daa works properly only immediately after add, sub, adc or sbc; the timer interrupt occurs after every 1500 branch, jump, call and return z80 machine instructions, instead of every 20 ms. On accelerated amigas, interrupts will not occur any faster than every 20 ms. updating of the flash attribute occurs every 24000 branch, jump, call and return z80 instructions, instead of every 320 ms. On accelerated amigas, the flash speed will never be faster than every 320 ms. interrupts and screen updates can occur only immediately after branch, jump, call, return and halt z80 machine instructions. because the emulator is not real-time, the real interval between timer interrupts and flash attribute updates depends on the nature of the Spectrum program being run. there might still be rare problems executing certain long, self-modifying z80 instructions located at exactly 32763..32766 in z80 memory, because of the 68000 addressing modes used to load instruction operands; there is at least one other bug I haven't been able to track down yet. o Because it's running slower, maybe now you can get past that "impossible" level in your favourite game. o Now you can print Spectrum graphics by transferring to your Amiga. o If you're cross-developing Spectrum software, now you can see which parts need speeding up. o I've tested it with several Sinclair Basic programs and all ran perfectly. o I've tried lots machine-code programs and most work ok. The following programs seem to work ok in the emulator: Zeus Assembler and Monitor Scrabble Jetset Willy no sound Atic Atac no sound Jetpac no sound Tron full sound The Train Game no sound Backgammon PSSST some sound Horace and the Spiders Sam Spade full sound effects Draughts Sam Stoat some sound 3D Deathchase no sound Technician Ted no sound Kosmic Kanga Monty Mole Talk Chess no speech, sorry Horace Goes Skiing some sound Hungry Horace some sound Star Raid no sound Cyclone some sound Wheelie no sound Full Throttle no sound Mugsy Dynamite Dan no sound Dynamite Dan II full sound effects Heathrow beeps IS Chess 48 Matchpoint Max Headroom no joystick Spy vs Spy Kong The Alchemist Daley Decathlon Automania Penetrator Gyron Alien8 Cyberun KnightLore Batman Tomahawk Fighter Pilot Athena Basil the Detective Pacland Orbix Meteor Manic Miner Madmix Kokotoni Wilf Ikari Warriers Gauntlet Dustin Ant Attack St Bernard resets the Spectrum at the end of the first level. SabreWulf runs, except sometimes the rhino runs backwards (very amusing). (If you know why either of these programs don't work, please tell me.) Note: The Amiga doesn't crash. If a Spectrum program crashes, you can either: Quit the emulator and continue working on the Amiga, or: Press F1 and load another snapshot. Note: Some of the above have not been tested since Spectrum v0.7 or v0.8. Another note: Some of the above programs won't load from tape, but they will run if you can create a snapshot file somehow (e.g, Mirage Microdriver and serial port). o One problem I have had with snapshotting games by transferring a snapshot file from the real Spectrum to the amiga, is as follows: If there is non-standard hardware in your real Spectrum (like a non-standard joystick or disk drive), and the program knows about the special hardware, then the program might have already done a hardware test (before you made the snapshot) that makes it believe the special hardware exists permanently. Then, when run under the emulator, the program tries to access the non-existent hardware and behaves erratically. What is wrong is that the program was started in one environment (the real Spectrum with add-ons) and is now running in another (the plain Spectrum emulator). For example, if your program behaves as if the joystick button is continuously pressed (when run in the emulator), maybe it is because you made the original snapshot from a Spectrum which has non-standard joystick hardware. See if you can disconnect the joystick interface and reload the original program from tape before you make a snapshot. o I am not supplying the source of the emulator yet. o Please report bugs to srwmpnm@windy.dsir.govt.nz. I'd much prefer bug reports like "the `or' instruction doesn't zero the carry flag" to "Dan Dare doesn't work". Appendix 1: The keyboard: The Spectrum has a weird way of mapping functions to keys that doesn't translate nicely to the Amiga. To get a "[" on a real Spectrum, for example, you press CAPS-SHIFT and SYMBOL-SHIFT together followed by SYMBOL-SHIFT and F. In the emulator, you do the same thing except CAPS-SHIFT is either of the SHIFT keys and SYMBOL-SHIFT is either of the ALT keys. Pressing "[" on the Amiga keyboard won't work. The following table lists the Amiga key(s) corresponding to each Spectrum key: Spectrum key Amiga key 0..9 0..9 (main keyboard or keypad) A..Z A..Z SPACE SPACE ENTER RETURN or ENTER CAPS-SHIFT either SHIFT key SYMBOL-SHIFT either ALT key The following special Amiga keys correspond to Spectrum key combinations. Amiga key Spectrum key combination . SYMBOL-SHIFT/M , SYMBOL-SHIFT/N ; SYMBOL-SHIFT/O - SYMBOL-SHIFT/J = SYMBOL-SHIFT/L keypad ( SYMBOL-SHIFT/8 keypad ) SYMBOL-SHIFT/9 keypad / SYMBOL-SHIFT/V keypad * SYMBOL-SHIFT/B keypad - SYMBOL-SHIFT/J keypad + SYMBOL-SHIFT/K keypad ENTER ENTER keypad . SYMBOL-SHIFT/M left arrow SHIFT/5 down arrow SHIFT/6 up arrow SHIFT/7 right arrow SHIFT/8 ESC quits the emulator (unless you cancel the requester that comes up). HELP displays the Spectrum.help file, which is a diagram of the real Spectrum keyboard. (You need about 70 kb of CHIP ram free for this.) F1 brings up the load snapshot requester (provided arp.library is installed). F2 brings up the save snapshot requester (provided arp.library is installed). F3 changes the sampler type for cassette tape loading. All the other Amiga keys do nothing. Appendix 2: Snapshot file format: This format is based on the format used by the Mirage Microdriver "Dump" command. Snapshot files are always 49179 bytes long. Note that in the table, the byte offset starts from 0, not 1. Byte offset into file Value 0 i register 1 l' register 2 h' register 3 e' register 4 d' register 5 c' register 6 b' register 7 f' register 8 a' register 9 l register 10 h register 11 e register 12 d register 13 c register 14 b register 15 iy low register 16 iy high register 17 ix low register 18 ix high register 19 bit 2 is set if interrupts are enabled 20 r register 21 flags register 22 a register 23 sp low register 24 sp high register 25 interrupt mode (0, 1 or 2) 26 filler (not used) 27..49178 48 kbytes ram dump Appendix 3: Other Spectrum Emulators: When I started this project I did not know of any other Spectrum emulators. Now I know of at least 8 (eight), including this one, in various stages of development. 1: This one. 2: The public domain K.G.B. emulator advertised in "Amiga Format". I have seen only version 1.2 which does not multitask and does not work properly on my A3000. 3: An Italian emulator was released (possibly commercially) about 2 years ago. The version I saw was very bug free and worked on accelerated amigas, but it did not multitask and was slightly slower than mine. 4: An emulator is under development in Sweden. 5: Another emulator, intended to be commercial, was written in Holland, but it was never released as far as I know. From what I have heard about it, it is much faster than mine. 6: The Whitby Software Spectrum Simulator is a Spectrum ROM rewrite for the C64. It runs just fine under TheA64Package and is surprisingly fast. Because it is a ROM rewrite and not a z80 emulator, you cannot run z80 machine code programs (i.e, most games). 7: VGASPEC is a Spectrum emulator for the IBM-PC and clones (not for the amiga). A VGA graphics adaptor is required. I think it was developed in Spain or Portugal (I don't recognise the language that all the messages are written in). 8: JPP is another Spectrum emulator for the IBM-PC and clones, developed very recently in Denmark. An 80386 and VGA are required. It is faster than VGASPEC, and it still has a few obvious bugs, but the author is currently working hard to fix them. The name JPP is derived from the keys you press to get LOAD "". Appendix 4: Update Notes: v0.0 22 Oct 1990 First release. v0.1 15 Nov 1990 Sped up display code slightly. Also sped up main instruction decode slightly. Display flash attribute as reverse. v0.2 30 Dec 1990 Now use double buffered display and implemented flash attribute properly. Added error requesters. Used pc-relative jump tables in z80 emulator --- slightly faster, and much, much smaller. v0.3 20 Jan 1991 Changed display routines to update screen periodically instead of after every z80 instruction that pokes the Spectrum's display file. Used the blitter for this, running in parallel with the z80 emulator. (Only character rows that have changed since the last screen update are redrawn.) Reverted to single buffer display and used blitter to implement flash. (It's smaller and faster this way.) Fixed bug where couldn't use path string in arp file requester. v0.4 Changed the z80 emulator to use threaded code. Now all that is executed between each pair of z80 instructions is "move.w (a3)+,d6; jmp table(pc,d6.w)" instead of about ten 68000 instructions to decode the next z80 opcode byte. Overheads introduced are a new 128 kbyte table giving the routine offset for every byte in z80 ram, and the necessity to write a zero word into this table every time the emulator writes to z80 ram. The overall speed increase is about 20%. Expanded some subroutines to macros and expanded $dd and $fd prefix instructions to independent code for a slight speed increase. A side-effect is that the executable increased in size from 27k to over 40k. Introduced some bugs during the systematic changes that are proving hard to track down. v0.5 7 Apr 1991 Fixed bug in "sra a" instruction. Fixed bugs in rotate and shift (ix+d) and (iy+d) instructions. Fixed bugs where used "offset(a4,rr.w)" to address z80 memory space where offset is -2, -1, 1 or 2. (Can't use that mode because of the unlikely event of rr.w being near $8000.) Implemented mode 2 interrupts. Low byte of interrupt vector (normally provided by an external peripheral device) is assumed to be 0. Increased the interrupt interval from 2500 instructions to every 5000 instructions, because otherwise some programs with their own (mode 2) interrupt routines overflowed the stack. v0.6 23 Apr 1991 Fixed bugs in the following z80 instructions: ld ixh,b ld ixh,d rl (ix+dd) rr (ix+dd) sla (ix+dd) cpdr and iy equivalents of the above instructions. Implemented ini, outi, ind, outd, inir, otir, indr, otdr. (Out instructions do nothing). Now preserve (otherwise) unused flag bits in push af, pop af and ex af,af' (instead of setting them all to 0). Changed layout of vector table for threaded code (origin now in middle). Fixed bug in vector table wraparound code (when pc incremented from 32767 to 32768). Sped up ram writes by optimising macro for writing a byte to ram. Added processor type check. Now you get a requester when you try to run the wrong version for your processor type, instead of "Software Error, Task Held". Implemented sound by opening audio.device and trapping calls to the "beeper" subroutine at $03b5 in Spectrum ROM. v0.7 Optimised blits to update flash attributes by keeping track of which parts of the display are flashing and updating only those parts. That saves a lot of blits. No blits are needed at all when there are no flashing characters displayed. It used to redraw the entire display for every blink. v0.8 13 May 1991 Further optimised the display routines by adding a 6144-byte lookup table. v0.9 22 Jul 1991 Lower task priority to -5 at startup. This is friendlier to other tasks because Spectrum is highly CPU intensive. If Spectrum is running at a higher priority than another task, then that other task is completely blocked. Sped up the emulator by 5% by checking for interrupts only after branch, jump, call and return instructions, instead of after all instructions. Open gameport.device and emulate Kempston joystick (at Z80 "in" instruction level) using the rear Amiga gameport. v0.9b 1 Sep 1991 Implemented all the undocumented z80 sls instructions. Fixed bug in ld (nn),sp instruction. (It didn't work at all!) Implemented the z80 n flag --- all instructions now set/reset the n flag. Fixed bugs in inc/dec (hl), inc/dec (ix+dd) & inc/dec (iy+dd) (never set v). The daa instruction now works correctly after add and sub (not just adc & sbc). Incorporated Kristian Nielson's tape load routine. Allocate/free misc.resource. Added "File already exists! Overwrite?" requester (in save snapshot). Fixed keypad 0 key. Rationalised keyboard. Arrow keys are now equivalent to SHIFT+5/6/7/8 instead of 5/6/7/8 (without the SHIFT). ESC key quits. The halt instruction now calls WaitTOF(). (Was too fast.) The Spectrum Basic PAUSE function now works correctly. Added a separate timer task to prevent interrupts occurring too quickly. The "flash" rate and keyboard interrupt rates are now more constant. The HELP key now displays Spectrum.help IFF/ILBM file from current directory. Reorganised register usage in z80 emulator to try to speed it up (lots of work but not much success). v1.0 9 Nov 1991 Implemented menus. Added noise correction code to cassette tape loader. Added support for 2 kinds of sound samplers. Screen to front after error requester in IFF loader. Use an interrupt server instead of extra task for timer. Further optimised blitter routines. Put z80 parity byte in a register (slight speedup). Implemented ld-bytes and sa-bytes to/from disk. v1.1 Dec 1991 Created 68020 version (uses 68020/30/40-only addressing modes for extra speed) Moved z80 address space to FAST RAM with a copy of 16384..22527 in CHIP RAM (instead of having the whole Z80 address space in CHIP RAM). Added more undocumented z80 instructions. Sped up display routines by changing update algorithm. Animated graphics and scrolling are now faster by a factor of 2 or 3. v1.2 7 Jan 1992 Rewrote joystick handling routines to avoid continuous polling. v1.3 Feb 1992 Implemented a much faster algorithm for handling z80 prefix instructions that was suggested to me by Richard Carlsson. Preserve high bit of R register between LD R,A and LD A,R, and also in snapshot files. Tomahawk works now. GetCC() is now documented to preserve d0/d1/a0/a1. Fixed movesr macro. Mode 2 interrupts assume $ff is on the external bus, not $00. This change fixed quite a few games. Fixed glaring bug in "set 4,l" instruction. Sabre Wulf, Fighter Pilot, Basil the Detective, Athena and lots of other programs work now. Changed implementation of daa instruction to speed up add/adc/sub/sbc instrs. Use blitter to do comparisons as well as copies in display updater. Sped up CPU computation of blitter attribute masks in display updater. Display updater now translates black to bright black on the fly. This leaves a colour register free for the border colour (one day). Fixed bug in display updater that caused flashing to fail sometimes. v1.4 17 Mar 1992 Changed ld-bytes ROM patch entry point from $0556 to $056b to be compatible with more programs.