
                                                       
                
                                 
                        

                     Yet another Spectrum Emulator
                              written by
                          Christian Hackbart
                   portions Copyright by Erik Kunze

------------------------------------------------------------------------------
                                I N D E X
------------------------------------------------------------------------------

    1 - Introduction

      1.1 - Disclaimer
      1.2 - Contents of the distribution
      1.3 - System requirements
      1.4 - How you can help me

    2 - History

    3 - Features

    4 - What's new

    5 - Greetings

------------------------------------------------------------------------------
 1 - Introduction
------------------------------------------------------------------------------

 1.1 - Disclaimer
 ----------------

   USE THIS PROGRAM AT YOUR OWN RISK. I TAKE NO RESPONSABILITY OF
   ANY DAMAGE THIS PROGRAM MAY PRODUCE.

   As you maybe recognized, YaSE is freeware, because
   "emulation wants to be free".
   However, I worked hard, spending my (holy)days and nights, and
   there are still tons of things that must be done.
   If you like to improve YaSE contact me !

 1.2 - Contents of the distribution
 ----------------------------------

  The following files are distributed:

   48.rom           - Spectrum 48k ROM.
   128.rom          - Spectrum 128k ROM 1/2
   plus2.rom        - Spectrum 128k ROM +2
   plus3.rom        - Spectrum 128k ROM +3
   pentagon.rom     - Pentagon 128k ROM 1/2
   scorpion.rom     - Scorpion 256k ROM 1-4
   didaktik.rom     - Didaktik M ROM
   layout.scr       - Keyboard layout image
   yase.cfg         - Config file
   yase.scr         - YaSE startup image
   yase.exe         - YaSE executable
   readme.txt       - This file

   *.pas;*.inc      - Pascal sources

 1.3 - System requirements
 -------------------------

  To use to YaSE you need the following equipment:
    . PC with at least a 386 processor (486 DX4/100 strongly recommended)
    . Some free harddisk space

  YaSE is running under Win9X very well, because the actual version
  was build with Delphi.
  ATTENTION: The current version will not run under WIN 2K / NT !! :((

 1.4 - How you can help me
 -------------------------

  You can help me a lot, if you test all your programs and games with
  YaSE. Suggestions for future versions and constructive critisism
  are also welcome, because that's the onliest way for me to recognize
  how many people are using YaSE.
  Im not going to ask you for money, but the life is hard for a poor
  student, so every donation is welcome !

------------------------------------------------------------------------------
 2 - History
------------------------------------------------------------------------------

   In 1986 I started my first steps in the world of computers with a
   Sinclair ZX Spectrum+ 48K.
   As you maybe know in the GDR it was really hard to get such a machine,
   and this is one of the reasons for my strong feelings about this
   homecomputer.
   In 1992 a powerful PC tooked the place of my Specci, but my enthusiasm
   is not broken till today.
   Nowadays you have to buy nearly each year new hardware to be up-to-date.
   With each new computer game the requirements are raising more and more.
   But most of them arent better than the games on the Spectrum (except Quake,
   lol).
   When I started the work on YaSE (in October 1997), I wanted to create one
   of the best ZX-Emu ever.
   Now a few years later I realised that this aim was a bit exaggerated.
   Only with the help of enthusiastic Spectrum fans it would be possible for
   me to do improvements.

------------------------------------------------------------------------------
 3 - Features
------------------------------------------------------------------------------

    Hardware:

      - Spectrum 48k emulation.
      - Spectrum 128k emulation.
      - Pentagon 128 emulation.
      - Scorpion 256 emulation.
      - Didaktik
      - All official opcodes of the Z80.
      - All documented unofficial opcodes and flags
      - Beeper sound using PC Speaker and Soundblaster.
      - AY-3-8912 sound using Adlib or PC Queeker.
      - Kempston joystick via joystick or keyboard

    Formats:

      - Snapshots:
        * Z80 (all versions): load and save.
        * SNA (48k and 128k): load and save.

      - Tape:
        * TAP: load and save.

      - Screenshots:
        * SCR, PCX: save.

      - Disks:
        * TRD: load and save

------------------------------------------------------------------------------
 4 - What's new
------------------------------------------------------------------------------

   o new feature
   x updated/changed/fixed

  v0.3 [public]

   o Z80-emulation with all documented and undocumented Opcodes
   o TAP,Z80,SNA,SCR - support
   o 48k / 128k Emulation
   o added a nice logo ;)

  v0.4

   o 48k Sound (Speaker, Soundblaster) implemented
   o GUI implemented

  v0.5

   x fixed a bug in the SNA/Z80 loader
   x TAP-loader completely rewritten
   x fixed some bugs in the CPU-Emu
   x made the display routine faster

  V0.6 [public]

   x improved the emulation speed
   o AY sound implemented
   o added Kempston Joystick emulation
   x fixed a really BIG bug in the memory routine
   o implemented a "mighty" ;) debugger

  V0.6a..f

   x ported the whole source into 32bit (DEPLHI+DOS extender)
   o added dozens of small features, like tape browsing
   o added ability to grab pictures in PCX and SCR format
   o figured out that some programs (Fairlight 128) rely on the fact
     that the 128K memory paging port is addressed with A15.
     So Ive changed that (thanks Erik)
   o added a fps-counter (in debug mode) to realize the performance
     50fps=Realtime
   x improved the debugger
   x fixed a big bug in TR-DOS memory mapping (tanks Raul)
   o added Speaker music
   o added Realspeed support
   o fixed incorrect FLAG-functions
   o LFN under Windows

  V0.7

   x added a working BetaDisk emulation
   o restructured and optimized the sourcecode
   x implemented Scorpion, Plus2, Plus3 loader 
     (emulation of these computers will be finished, if I find 
      more information about)

  V0.7a

   x several small bugfixes

  V0.8a

   o 128k/256k Snp-format
   x better frame_skipping on slow machines
   x percentage display
   x new AY8910-Emulation for the Speaker (I guess it sounds better than in
     Warajevo)
   x source restructured
   x added Scorpion, Plus 3 and Didaktik ROM
   x assembler emulation of add,adc,sbc,cp,sub- functions is now optional
   x mf128/mf3 emulation

  to do in the future versions:

   - correct border emulation
   - AY-Player for SB, AWE, GUS  ?
   - Windows version ??
   - implementation of all known snapshot and tape formats (only if there are
     enough people who want this)

------------------------------------------------------------------------------
 5 - Greetings
------------------------------------------------------------------------------

      * Radovan Garabik, (for sending me the source of his emu)
        he created one of the faastest Spectrum-Emulators

      * Erik Kunze, (for helping me to fix some bugs)
        I used some parts of his XZX-Emulator

      * Raul Gomez Sanchez for bugfixing

      * James McCay, (for one of the best DOS based Spectrum emulator -
        at the moment) his source showed me one way how to create a
        Z80-emulator.

      * Nicolay Shalayev for his superb SPEC305, with his source
        I was able to finish my BetaDisk emulation 

      * Random for his FAQ concerning informations about russian
        Spectrum models
     
      * Philip Kendall for his Spectrum FAQ

      * Michael Tippach for his excellent 32BIT extender WDOSX
        you can download the latest version at following adresses:

           http://www.wdosx.home.ml.org
           http://www.geocities.com/SiliconValley/Park/4493
           http://www.wuschel.demon.co.uk (europe)

      * You (for showing interest in this program)


------------------------------------------------------------------------------
 6 - Contact me
------------------------------------------------------------------------------

  Under the following adresses, you will find always the newest versions:

  e-mail: christian.hackbart@et.stud.tu-ilmenau.de
          chackbart@web.de

  YaSE homepage: http://www.tu-ilmenau.de/~hackbart

