                     #NNM"""""""Qg
                              _QN'   _gM"""Mg     p!"""Ng
                         _  _pM^     Bg    _N    #      Tg
                         "QNQ_        jNm*NQ_   jf      jQ
                       j@"          jM      TQ  Tg      jM
                    _gF`            Qg     _pF  "Qg    _#'
                   "MNNNNNMMM""""^`  "MN**M"      9N**!^
    _yggQQgg  pggggggggg,jggggggggg    pggg    jggg     pggggggggg,jggg   jggg
   jQQNNNQQQg NNNQQQNNNN_QQQNNNNNNM  _QQQQQ    QQQf     NNNQQQNNNN_QQQf  jQQQ'
  jQQQy__ ""'   jQQN    pQQQ____    jQQNQQQ   jQQM        jQQN    pQQQyyyQQQF
   MQQQQQQg    jQQQ'   jQQQQQQQQF  pQQM QQQ  jQQQ        jQQQ'   jQQQQQQQQQN
 ggg  `"QQQf   QQQF   _QQQf      jQQQQQQQQQ  QQQf        QQQF   _QQQf  jQQQ'
 QQQQgQQQQF   jQQN    pQQQQQQQQQgQQNMMMMQQQ jQQQQQQQQ   jQQN    pQQF   QQQF
 `MNNNNM"     7NN'    NNNNNNNNNMNNM     TNN TNNNNNNNF   7NN'    NNN    NNM

*****************************************************************************
*                                                                           *
*                 Z80Stealth ZX Spectrum emulator v0.503                    *
*    	        Copyright(c) 1999-2001 by 		                    *
*			Kirill Kolpakov ^Power of Sound Web Team^Psycho     *
*                                                                           *
*         AY-3-8910(12)/YM2149F emulation, HLE GS Player,lot of other stuff *  
*		   Copyright(c) 2000-2001 by 				    *
*			     Hacker KAY ^Power of Sound Web Team^Nuclear    *
*****************************************************************************

       PLEASE READ THIS DOC CAREFULLY BEFORE RUNNING EMULATOR
		THANKS FOR YOUR INTEREST IN OUR WORK

	1. Introduction.
	2. Features.
        3. System requirements
	4. Whats new.
	5. Usage.
	6. Debugger howto
	7. Future plans.
	8. Greetings.
	9. Contact me.

        DISCLAIMER
 ----------------------------------------------------------------------------
  USE THIS PROGRAM AT YOUR OWN RISK. I'M NOT RESPONSIBLE FOR ANYTHING YOU DO
   WITH IT. ANYWAY YOU DON'T HAVE TO WORRY BECAUSE IT'S NOT INTENDED TO BE
                                HARMFUL AT ALL.

  	        Z80Stealth IS FREEWARE  AND CAN BE DISTRIBUTED 
    FREELY AS LONG AS CONTENTS OF Z80Stealth DISTRIBUTION IS NOT MODIFIED.
 ----------------------------------------------------------------------------


	1. Introduction.

  Z80Stealth is the Speccy 128,Pentagon 128/512,Scorpion ZS 256, Profi 1024, 
  KAY 1024 emulator for DOS but it works OK under Win95/98/Millenium Edition. 
  Main goal is to emulate Speccy's hardware as close as possible. 
  Main features: very good z80 emulation, 
  _perfect_ AY-3-8910(12)/YM2149F and General Sound emulation,
  beeper, Covox, SounDrive emulation using Sound Blaster,ESS688 or WSS.
  KP1818VG93 (Betadisk/TRDOS) emulation, menus to load/save/browse your 
  collection of Speccy's snaps,tapes,disks.
  Emulation of such hardware as Cache,GIGASCREEN,Flash-color,CMOS,
  Kondratiev's scheme (Hayes modem + Speccy).
  It supports popular file formats:
	Snapshots - Z80 (+ Z80Stealth's enhanced version),
		    SNA,SLT,SP,PRG,ACH,SIT
	Tape - TAP,WAV,VOC
  TR-DOS Disk format supported: TRD, SCL (both are with auto-boot feature!).
  I'm writing & optimizing it almost everyday so future versions will 
  be faster and with more features.

	2. Features.

	- Spectrum 128 emulation.
	- Pentagon 128/512 emulation.
	- Scorpion ZS-256 Turbo+ emulation
	- Profi 1024 emulation (not finished yet)
	- KAY 1024 emulation (not finished yet)
	- Z80 CPU emulation using my own code. All documented and 
	  undocumented flags and opcodes.
	- General Sound emulation (low-level & high-level)
	- 2 Debuggers: for Speccy's Z80 & General Sound board: 
	  Disasm,Assembler,Stack,Memory Dump,Memory map,Ports
	- AY-3-8910(12)/YM2149F emulation 
	  Includes Digital sound feature.
	  ABC/ACB/BAC stereo modes.
	  Excellent noise emulation.
	  Sound is 100% close to the real AY/YM chips!
	- Betadisk (4 drives).
	- KP1818VG93 emulation
	- HDD emulation!
	- Beeper,Covox,SounDrive emulation.
	- Supports SB Pro, SB16, ESS688 and WSS compatible sound cards.
	- Support for 88Khz & 114Khz mode for ESS688 compatible cards!
	- Cache (Shadow RAM) emulation.
	- 16K RAMDISK for Pentagon 
	- GIGASCREEN emulation.
	- FLASH-color emulation.
	- 512x192 B&W
	- Profi hi-res (512x240)
	- Hardware multicolor 
	- Kondratiev's scheme (Hayes modem + Speccy)
	- Compability: almost everything works ok
	- Interrupt modes 0,1,2.
	- Keyboard issues 2 and 3 emulation
	- Register R emulation.
	- Shadow screen support.
	- Joystick : Kempston, Cursor, Sinclair 1, Sinlair 2
	  emulation via arrow keys+CTRL.
	- Kempston mouse emulation.
	- File formats:
		SNA*,Z80**,SLT,SP,PRG,SIT snapshots - Load/Save
		TAP,WAV,VOC - Load
		TRD - Load/Save
		SCL - Load/Save***
	  *   SNA files have TRDOS flag set if Pentagon mode selected
 	     and TRDOS rom is mapped.
	  **  + Z80Stealth's enhanced version, default format for saving
 	  *** SCL are saved to SCL.TRD
	- Menu to Load/Save files (F1)
	- If available MMX is used for fast screen drawing and sound mixing
	- Ability to create PSG or EPSG files. Read about EPSG in z80s.faq
	- Save BMP or SCR screenshots (F8)

	3. System requirements
	
	- CPU:    P133+ is required. P166MMX+ is recommened.
	  P300+ is required for low-level General Sound emulation.
	  MMX is required for GIGASCREEN and Flash-color emulation
	  (except for video modes 0 & 1).
	  Tested with AMD,Intel and Cyrix CPUs.
	- Video:  Any VGA compatible card. But emulator also supports
	  VESA VBE 2.0 or higher so it can work with non-VGA compatible
	  cards too.
	  For VESA modes - VESA VBE 2+ compatible video bios reqiered.
	  Fake VESA VBE 2+ implementations (without linear framebuffer modes)
	  are not suported.
	- Sound:
	  1) Z80Stealth will work without problems even you
	  dont have a sound card (like to play at work;)
	  2) Sound Blaster Pro compatible sound card for 
	  44Khz 8bit mono,22Khz 8bit stereo modes
	  3) Sound Blaster 16,ESS688 or WSS compatible sound card for 
	  44Khz 16bit stereo mode.
          4) ESS688 compatible sound card for 88Khz or 114Khz 16bit stereo mode.
	  5) Sound Blaster clones may work may not. SB Live! is supported.
	  Some PCI audio chips from ESS may be compatible with their ISA
	  based cards.
	  6) You may use real AY/YM chip with Z80Stealth. Switch-on internal
	  digital sound buffer to have real chip working good.
	- Memory: At least 16 megs. Didnt test it with 8 megs.
	  32megs is recommended under Windows.
	- OS:     DOS,Win95,Win98,Win Millenium Edition.
	  Windows is recommended due a to a less buggy DPMI service.
	  Z80Stealth is not designed not tested with OS/2,Win NT,Win2K.
	  Z80Stealth may work under Linux + DOSemus.	


	4. Whats new.


 25/12/2001 v0.503
	- New   : For users of old nonMMX CPUs: Gigascreen & Flascolor
		  work in video modes 0 & 1.
	- New   : Z80 snapshot format enhanced so it now stores all info
		  about Russian clones (Pentagon,Scorpion,KAY,Profi),
		  General Sound cpu&memory info, hi-res video modes.
		  This is now a default snapshot format for saving.
	- New   : Hardware multicolor emulation. Use Ctrl-F7 to activate it.
		  Thanx to Nuts for techinfo.
	- New   : ISA bus overclock for VIA chipsets. May really help if you
		  have troubles with ESS sound modes 32 & 64.
		  in cfg: ISA_TURBO=YES|NO
	- Bugfix: found workaround for ATI Radeon cards 
		  to initialize VESA modes without long pause
	- Bugfix: fixed bug which caused big slowdown on various SB & WSS clones


 03/11/2001 v0.500 'General Sound roxx the emuscene!'
	!WARNING! CURRENT SETTINGS FOR THIS VERSION REQUIRE P300+!
	!P300 IS NEEDED FOR LOW-LEVEL GENERAL SOUND EMULATION    !
	!IF YOU HAVE SLOW PC OR DONT WANT GS - SET GS=NO in cfg	 !
	- New   : low-level emulation of General Sound! General Sound
	  is an add-on board for hardware MOD and sound FXs playing.
	  Powered by Z80 cpu at 12Mhz it has 4 audio channels 
	  (8bit for data + 6bits for volume for each channel), 128 or
	  512Kb of memory,32Kb ROM. Apart from playing audio its cpu can
	  be used for other tasks (code can be uploaded to GS & executed).
		4 switches in cfg:
		GS=YES|NO - YES to allow General Sound emulation
		GSMEM=128|512|1024|2048 - choose how much RAM General Sound has
		GSHLE=YES|NO - choose NO for low-level GS emulation (requires
			       fast CPU - P300+)
		GSRESET=YES|NO - F12 resets GS with Speccy
	- New   : Debugger for General Sound (use End key)
	- New   : Procedures reading&analyzing config files was rewritten.
	  If you have any problems with cfg files - simply try the ones
	  which come with z80s_500.zip 
	- New   : Digital sound buffer for AY-LPT!!! (Doesnt work correctly
		  under Winsuxx at freq>1000 Hz). There are lot of new options
		  in cfg-file, be careful! 
		REAL_AY=YES|NO - use real AY instead of internal emulation;
		AY_DATA=0-FFFF - address of real AY data port
   		AY_RESET_SIGNAL=00000000 - binary form of AY RESET signal
		AY_RESET_MASK=00000100 - binary mask of RESET (bit 2 for LPT AY)
		DIGITAL_SOUND_BUFFER=YES - Enable Digital sound buffer
	           Find more info about the real AY in cfg file!
	- New	:  Added 8 new timing schemes for VMODE=253 (first test)
		M253_TIMING=0..8     Timing| VFREQ |
                                           |  (Hz) |
                                     ------+-------+
                                       0   |   78  |
                                       1   |   99  |
                                       2   |   99  |
                                       3   |   50  |
                                       4   |  150  |
                                       5   |  100  |
                                       6   |  100  |
                                       7   |  150  |
                                       8   |   50  |
                                     ------+-------+
	- New   : Rewrote all procedures working with memory. This version
	  uses memory much more efficiently than previous - as a result
	  emulator loads really fast on 16megs PCs.
	- New   : Ability to step over opcodes in debugger. Use F8.
	- New   : Built-in boot for any TRDOS disk. Use PageUp key.
	- New   : Support for VOC and WAV (with images of tape) files added
	  To start playing them use Home key. 
	- New   : New submenu 'Browse tape' (in F1 menu). Used to browse tape
	  files, choose start point of playback. Currently works for VOC/WAV.
	- New   : Added a little trick to produce PSG files w/o loggin
		  writes to FE/FF AY regs (Stellar Count demo)
	- New   : Rewrote some parts of Z80 core - should be a bit faster now
	- Bugfix: fixed stupid bug in TAP loading routines - a lot of 
	  TAPs are working correctly now.
	- Bugfix: ZASM 3.10 reported that no disk is inserted
	- Bugfix: fixed bug with long file names & browser 


 22/04/2001 v0.452
	- New   : Ability to synch with video (synch with vertical retrace)
	  in no sound mode. Smooth video output but emu's speed depends on
	  vertical retrace frequency.
		SB0SYNC=VIDEO in cfg		
	- New   : General Sound works in dummy mode if no sound mode selected
	- Bugfix: fixed bug in MOD player, now General Sound plays if SB_OUT=1

  6/04/2001 v0.450
	- New   : !Wow! General Sound now plays!
	  Currently MOD playing is emulated. 
	  Big thanx goes to Hacker KAY for MOD player.	
	- New   : Scorpion ProfROM emulation. Support for
	  128K,256K and 512K ProfROM.
	  new switch in cfg:
	  PROF512=1|2 choose which 256K bank to use if 512K ProfROM is used
	  Note that emulator will autodetect which rom is in scorpion.rom
	  file - as a result you can easily use any ROM you want - 
	  non-ProfROM,ProfROM of any size&version.
	- New   : Debugger. Z80,Disasm,Assembler,Stack,Memory Dump,
		  Memory map,Ports
	  Activate by pressing Delete key.
	  Read more about it in *Usage* section
	- New   : Rewrote kempston mouse emulation again ;)
	  updated switches in cfg:
	  M_SENSITX=n	n=0..7 
 	  M_SENSITY=n	n=0..7 
	  n means mouse sensitivity. 7 is max sensitivity
	- Emulation of 512K or 1024K memory expansion for Scorpion	
	  new switch in cfg:
	  SCORPMEM=256|512|1024
	- Emulation of 16K RAMDISK for Pentagon. 
	  RAMDISK is controlled by D6 #EFF7
	  Thnx to Eugene Palenock for info 
	- New   : Ability to turn off multitasking then running 
	  under Windows. This gives more speed and removes sound 
	  glitches if you have slow machine.
	  new switch in cfg:
	  KILLWIN=YES|NO
	- New   : HDD emulation using image file. Very buggy at the moment,
	  but dont worry, this should be fixed in following version.
	  new switches in cfg:
          HDDFILE="dump.hdd" - name of HDD image file
          REALHDD=YES|NO - choose yes if you want to use image file
	  following switches are needed only if using HDD image: 
          HDDCYLS=n
          HDDHEADS=n
          HDDSECS=n
	- New   : Saving GIGASCREEN screenshots to GSC format
	- New   : New 320x200 video mode (VMODE=253 in cfg). It's
	  faster than any other 320x200 mode + has proportions like
	  320x240 mode but may be not compatible with all videocards. 
	  Best choice if you have slow CPU or outdated videocard.
	- Bugfix: Small bugfix in AY/YM emulation by Hacker KAY. 
	- Bugfix: If you have problems with keyboard (it freezes) try
	  this new switch in cfg: SLOWKEYS=YES|NO
	- Bugfix: fixed Ctrl-Break crashes in menus.
	- Bugfix: fixed bug then saving EPSG in turbo mode.
	- Bugfix: fixed few potential problems if running under Win2000
	
 20/02/2001 v0.410
	- New	: KAY1024 emulation improved
	- New	: Support for real HDD from KAY1024 added!
	  Read more about this in z80s_faq
	- Bugfix: Hopefully fixed all problems if 16 megs of ram is present

 14/01/2001 v0.406
	- New	: Emulation of Profi hi-res video mode (512x240)
	- New   : Added CP/M switch for Profi - Ctrl-F11
	- Bugfix: Fixed mouse procedures - now everything is OK with
	  sensetivity hopefully
	- Bugfix: Forced palette initialization after video mode changes
	- Bugfix: No need to change video mode for hi-res emulation
	  if VMODE=13 or 14
	- Bugfix: Fixed minor bug in 512x192 b&w emulation.
	- Bugfix: Fixed minor bug in screenshot saving procedure.

 31/12/2000 v0.402
	- Bugfix: 2 Fixes for 512x192 b&w: it looked dark if MMX was used
	  + BMP now can be saved correctly.
	- Bugfix: Fixed reading hex values from cfg.

 26/12/2000 v0.401 
	- New   : FAQ in russian translated by Hacker KAY
	- Bugfix: Fixed problem with joystick emulation via cursor keys 
	  not working properly if Num Lock was turned on before emu start

 25/12/2000 v0.400	
	- New   : z80s.cfg now redirects to actual config file
		  Dont forget to edit cfg file before using emu!
	- New   : Scorpion ZS 256 emulation! Big thanx goes to Hacker KAY
		  for his help.
		  select it by MODEL=SCORP in cfg
	- New   : KAY1024 emulation (far from perfect for now)
		  select it by MODEL=KAY in cfg
	- New   : New sound mode for ESS688 compatible cards:
	  !!114Khz 16 bit stereo!! 
	  This mode adds HQ AY and Beeper emulation.
	  It can be selected with SB_OUT=64 in cfg
	- New   : Solved problem with ESS cards not working 
	  at 88,114Khz under certain hardware configurations.
	  If you have ESS688 or compatible card and it refuses
 	  to work properly with sound modes 32 & 64 try these switches
	  in cfg:
    	   	DMA_TURBO=YES|NO   - Try YES if you have Intel,VIA,AMD or
			       	     OPTi chipset
   	   	DMA_4XTURBO=YES|NO - Try YES if you have VIA chipset
				     and DMA_TURBO doesnt help
	- New   : Ability to avoid setting volumes (VOL_MAST,VOL_DAC etc)
	  	USE_MIXER=YES|NO switch in cfg
	- New   : Cursor,Sinclair 1,Sinclair 2 joysticks emulation.
		  You can select default type of joystick by JOYTYPE=n
		  in cfg. Later you can change it in snapshot menu by
		  F1. Also type of joystick auto changes after z80 snapshot
		  loading.
	- New   : Keyboard LEDs now used :
	 	Scroll Lock: Turbo on/off 
			     (Z80 clocked at 2x-4x(7-14Mhz) / 1x(3.5Mhz) )
	 	Caps Lock  : Cursor keys+Ctrl are used for joytick emulation 
			     (on) or for keyboard (off)
		Num lock   : Flash-color on/off
	- New   : MAGIC and NMI buttons emulation.
	   Keys:
	   F4 - Magic button, in Scorpion ZS 256 mode - Shadow service monitor
	   F5 - NMI
	   Alt-F5 - map CACHE to ROM & NMI
	- New   : Reset to TRDOS - simply press Ctrl-F12.
	- New   : New video mode (254 - 320x200 VGA) for very old ISA
	  video cards which only support 16bit (word) transfer.
	- New   : Cache (Shadow RAM) emulation. 
	  Currently for Pentagon mode only. 
	  Supported types of cache size: 2,4,8,16,32K
	  2 switches in cfg:
		CACHE=YES|NO
		CACHESIZE=2|4|8|16|32
	- New   : 'dummy' General Sound emulation. Games designed for this
		  device have no sound yet, but they're working!
	- New   : Kondratiev's scheme emulation (Hayes modem with Speccy!).
	  Of couse you need modem in your PC to use this ;)
	  4 switches in cfg:	
		MODEM=YES|NO
		COM_BASE=nnn
		COM_IRQ=n
		UART_BUF=YES|NO - in most cases you should select YES
	- New   : CMOS emulation (Gluck's scheme).CMOS=YES|NO option in cfg
	- New   : 512 x 192 bw screen mode emulation. Available if you use VESA
	  video mode (VMODE=n in cfg)
	- New   : GIGASCREEN emulation. F7 turns it on/off. Available
	  if you use video mode w/o scanlines and requires MMX.
	  Two switches in cfg:
		GIGASCR_GAMMA=n (n=1..100) - adjust color mixing
		EFF7_GIGASCR=YES|NO - enable hardware control of 
			GIGASCREEN by D4 of EFF7 port.
	- New   : FLASH-color emulation. Alt-F7 turns it on/off. Available
	  if you use video mode w/o scanlines and requires MMX.
	- New   : Turbo switch emulation. 
	  Use F6 to turn on/off turbo.
	  TURBO=2|3|4 switch in cfg (selects 2X 3X or 4X turbo)	
	- New   : Beta 128 disk interface emulation. 
	  This means now you can use TRDOS in ZX Spectrum 128 mode. 
	  BETA128=YES|NO in cfg
	- New   : VSYNC for VESA modes. 	
		VSYNC=YES|NO in cfg
	  It doesnt't slow down emu so I recommend set this on.
	  Read about problems with VSYNC & 3dfx cards in FAQ.
	- New	: Emulator now ask if you want to save disk before
	  exit or disk change.
	- New   : Optional exit confirmation.
		CONFIRMEXIT=YES|NO in cfg
	- New   : If runtime error happens emulator can save current state
	  to CRASH.SNA snapshot.
	   	SNAPCRASH=YES|NO in cfg
	- New   : EPSG format updated - read about it in z80s.faq
	- Bugfix: hopefully fixed that 'Page fault in RMCB' under plain DOS.	
	- Bugfix: 'Cant load trdos.rom' bug fixed.
	- Bugfix: various fixes for saving screenshots procedures.
	- Bugfix: a pile of other small bugfixes 

 05/08/2000 v0.305
	- Bugfix: Fixed crash with  ZXZIP and ZXUNZIP.
	- Bugfix: Rewrote emulation of a several Z80 opcodes 
	  to prevent similar problems.
 17/07/2000 v0.300
	- New   : Various improvements in AY-3-8910(12)/YM2149F emulation. 
	- New   : New sound mode for ESS1688/1868 compatible cards:
	  !!88Khz 16 bit stereo!! Yes, it works and sounds great 
	  with these cards. This mode adds HQ AY and Beeper emulation.
	  It can be selected with SB_OUT=32 in z80s.cfg
	  but it requires faster CPU.
	- New	: 3 new switches in z80s.cfg for ESS sound cards:
	    1.  ESSDETECT=YES|NO If YES then emu will try to autodetect
		baseport,irq&dma of your sound card.
 	    2.  ESSDMA=0|1|2 - You may need to change this if
	        sound in ESS sound modes is distorted
	    3.  ESS_FILTER=YES|NO If NO then default values for ESS
	    hardware filter will be set. If YES then next switch will
	    make sense :
	    4.  ESSFILTER=n (n=230..254) With lower values ESS hardware filter
	    will cut off high frequensies.I dont recommend to change this option
	- New   : 'No sound' mode is added. 
	  Select this with SB_OUT=0 in z80s.cfg if you like to play
	  at work ;)
	- New   : WSS driver was rewritten. Also two volume settings
	  now work for these sound card: VOL_DAC and VOL_CD.
	- New   : Support for a bunch of VESA2.0+ video modes are added. 
	  Look in z80s.cfg for their description (it's at the end of z80s.cfg
	  after VMODE switch)
	- New   : Some VESA2.0+ video modes are with faded scanlines. 
	  There's option in z80s.cfg which selects scanlines intensity 
	  in percents:
	  SCAN_INTENS=n (n=0..100)
	- New   : Now you can use any video palette you want. All palettes are
	  stored in palette.cfg. Just uncomment one of the lines to use
	  disired palette. Add you own palette - quick & easy !
	- New   : Now you can change boot (in Hobeta format) which emu adds then 
	  it opens SCL (TRDOS disk image format by Paul Pavlov).
	  In z80s.cfg (examples):
	  SCLBOOT="boot123.!b" this will attach boot123.!b file 
	  for every SCL file.
	  SCLBOOT="" No boot file will be attached.
	- New   : Ability to save SCL file:
	  If SCL diskimage is opened then press F9 in disk menu to save
	  it to SCL.TRD
	- New   : Betadisk/TRDOS emulation with traps. You can turn this
          mode on/off in z80s.cfg(TDOSTRAP=YES|NO) or you can switch
  	  it "on the fly" (in F1 menu press F9). This mode is less 
	  compatible but pretty fast.
	- New   : Partial Profi 1024 emulation added. It can be
	  selected by MODEL=PROF in z80s.cfg
	- New   : File browser now remembers last position in current
	  directory.	  
	- New   : Z84=YES|NO option in z80s.cfg. Set to YES if you have 
	  very strong desire to see that you have Z84 in several test 
	  programs ;)
	- New   : emulation of MIC output (to tape recorder). Useful
	  if you want to save something to real tape (connect your tape
	  recorder to sound card line out). Takes extra CPU time and
          therefore no needed normally & disabled by default.
 	  2 new switches in z80s.cfg:
	  MIC_OUT=YES|NO
	  MIC_VOL=n (n=1..10) This sets volume of MIC output. I dont
	  recommend values >6 until you really need this.
	- New   : Some programs don't work correctly if Pentagon 512
	  emulation is selected. Now Z80Stealth has a little workaround
	  for this apps, it can be enabled/disabled by 512IF7FFD=YES|NO
	  switch in z80s.cfg
	- New   : Now you can rip AY/YM tunes to (E)PSG with 100% accuracy.
          All need is to insert special traps to snapshot which will play 
	  tunes you want rip. Read more about this in z80s.faq
	- New   : MAXSPEED=YES|NO option in z80s.cfg. If YES then emu
	  will work at maximum speed. Useful for example if you want 
	  rip tunes, run special programs like Jpeg->Speccy screen 
	  converter. Sound emulation is off in maxspeed mode.
	- New   : Various optimizations for non-MMX CPUs
	- Bugfix: Betadisk/TRDOS: fixed 'SAVE "A"' bug! 
	- Bugfix: Fixed bug in drawing procedures: writing to address
	  lower than A0000. This caused various errors: crashing then
   	  entering menus or selecting drives in browser and other problems.
	- Bugfix: Emulator freezed until Ctr-Break then it couldn't
	  find some file or cause of other errors (after exit with
          error string)
	- Bugfix: Added missing flags emulation for several opcodes
	- Bugfix: Fixed reading from xxFD ports.
	- Bugfix: length of saved TRD disk images were always 655360 bytes
	- Bugfix: Another small fix in TAP loading routine.

	
 
 27/04/2000 v0.200
	Warning: Please read whats new & docs and edit z80s.cfg carefully 
		 before mailing me about something not working :)
	- New  : Updated AY-3-8910(12)/YM2149F emulation code by Hacker KAY:
	  - Added YM2149F emulation
	    (please note that YM emulation is slower than AY emulation
	     due to the nature of this chip)
	  - Added ABC & BAC stereo modes
	  - Support for new sound modes: 44Khz 16bit stereo & 22Khz 8bit stereo
	    ( AY-3-8910(12) DAC values by V_Soft, YM2149F values by Hacker KAY )	
	  - Now sound is almost 100% close to the real AY/YM chips!
	  - Excellent noise emulation! 
	- New  : Updated sound engine:
	  - new mode: 44Khz 16bit stereo for SB16   (SB_OUT=2 in z80s.cfg)
	  - new mode: 22Khz 8bit  stereo for SB Pro (SB_OUT=3 in z80s.cfg)
	  ! new !   : ESS688 engine by Hacker KAY:
	     supports 44Khz 16bit stereo mode (SB_OUT=4 in z80s.cfg)
	     autodetects BaseIO port,IRQ,DMA for these cards
	  ! new !   : experimental WSS engine by Illuminator:
	     supports 44Khz 16bit stereo mode (SB_OUT=6 in z80s.cfg)
	     you need manually type in BaseIO port,IRQ,DMA values in z80s.cfg
	     for these cards
	     no mixer control for this mode yet
	     so far this mode only tested with Yamaha YMF718/719	
	 - Bugfix: fixed problem with IRQs >7
	- !New!: removed cpu autodetection.
	  You must set USE_MMX=YES|NO switch in z80s.cfg manually!
	- New  : Betadisk/TRDOS: up to 4 floppy drives are now supported
	- New  : SounDrive emulation!
	- New  : Rewrote beeper emulation again.  
	- New  : 4 switches to turn on/off Covox/SounDrive emulation, change
	  stereo mode and music chip type "on the fly"
	  Simply press F1 for snapshot menu and you'll see what I'm 
	  talking about
	- New  : rewrote Z80 engine here and there
	- New  : some modifications to screen drawing procedures
	- New  : you can save AY(YM) output log files in 
	  EPSG format. Read more about EPSG in z80s.faq
	- New  : E(PSG) file output is buffered so you'll
	  get no sound glitches on fast machines 
	- Bugfix: Fixed t_states for several opcodes.
	- Bugfix: 'Ctrl(Alt)-Fn,Esc' bug fixed.
	- Bugfix: Fixed very rare bug with several opcodes
	  overwriting ROM.
	- Bugfix: Small fix in TAP loading routine.
	- Bugfix: Small fix in Z80 snaps loading routine.
	

 15/02/2000 v0.150 'Millennium release'
	- New  : New AY-3-8910(12) emulation code (including AY's digital
	  sound emulation & ACB stereo mode) by Hacker KAY.
	- New  : Wrote my own SB engine which uses auto-init DMA  mode
 	  to produce clean sound. Sampling rate is 44100. Also you can
	  choose between stereo and mono output (SB_OUT= option in z80s.cfg).
	  And there's a lot of new options in z80s.cfg to control SB mixer.
	- New  : Rewrote beeper emulation routines. 
	- New  : Z80Stealth supports AY-LPT. There's 3 new options
	  for AY-LPT in z80s.cfg.
	- New  : Covox emulation! 2 new options in z80s.cfg :
	  COVOX=YES|NO, COV_P=XX
	- New  : Added support for TRD disk images of 2x40,1x80,1x40 disks
	- New  : KP1818VG93: Write Sector(s) command support. Added this
	  hotkeys to the disk menu : 
	    F6 - Toggle write protection	
	    F9 - Save disk to file
	  For safety: you cannot overwrite files with readonly attribute.
	- New  : Border line-by-line rendering.
	- New  : Now you can set default directories for snaps/tapes and
  	  disk images (SNAPDIR= and TRD_DIR= options in z80s.cfg)
	- New  : Hotkey (F11) to turn on/off Kempston joystick emulation via
	  cursor keys+Ctrl
	- New  : Updated FAQ (z80s.faq).
	- New  : Adlib version is discontinued.
	- Bugfix: Port #FDDF is used for Kempston mouse Y-coord.
	- Bugfix: Crash if TRD image file>655360 bytes long	
	- Bugfix: Fixed problem with directories which have r/o,hidden,
	  system attr.

 11/12/99 v0.100 'Betadisk/TR-DOS support release'

	- New  : Betadisk/TR-DOS support using KP1818VG93 emulation
	  (Big thanks to Raul Gomez Sanchez for his help)
	- New  : TRD and SCL TRDOS disk images support.
	- New  : Menu to load disk images (F3).
	- New  : Kempston Mouse emulation. 
	  You can adjust mouse sensitivity in z80s.cfg
	- New  : Pentagon 512Kb emulation.
	  You can switch between 128/512Kb memory by editing 'PENT_512='
	  value in z80s.cfg
	- New  : Port #FF emulation. This fixes problems with Cobra, Arkanoid
	  now works.
	- New  : Added support for SP,PRG,ACH,SIT snapshots (Load/Save).
	- New  : Added support for SCR screenshot format again.
	  Choose screenshot format (BMP or SCR) by editing z80s.cfg	
	- New  : Added TRDOS flag support to SNA snapshots. Now SNA is the
	  default snapshot format if Pentagon emulation selected.
	- New  : Rewrote CB xx, DD CB d xx, FD CB d xx opcodes emulation.
	  About 5% faster.
	- Bugfix: Fixed problems with reading files which
	  have readonly,hidden,system attributes.
	- Bugfix: Fixed 'Runtime error 2' if filename contains ' symbol.
	- Bugfix: LD A,R & LD A,I set P/V flag correctly (Kolobok 2 works).

 10/11/99 v0.079
	- New  : SLT files support (SLT is a special snapshot format for
	  multilevel games). If slt snapshot is opened then slt is the 
	  default format for saving.
	- New  : Now you can change drive to browse you files. 
	  (F1->Load... -> Alt-D to change drive). 
	- Bugfix: Rewrote procedures working with tape images. This fixes
	  crashes caused by custom loaders.
	- Bugfix: file browser fixes ('attr=0' and 'xxx.yyy dir' bugs fixed)

 21/10/99 v0.078
	- New  : SB routines optimizations. Now SB version is 40% faster
	  and requires P133.
	- New  : Improved file browser. Now it remembers last browsed directory
	  and shows files alphabetically

 09/10/99 v0.077 'Sound Blaster support release'
	- New  : Beeper emulation using Sound Blaster! 
	  Note that now Z80Stealth comes in two varieties: 
	  1) Adlib version (z80s_adl.exe). Includes AY-3-8910(12) emulation.
	  This version is faster than SB version but has no Beeper sounds emulation.
          2) SB version (z80s.exe) uses Sound Blaster to emulate Beeper sounds.
	  (If you have problems with SB version  or do not have SB card
	  then use Adlib version. Sound Blaster clones may work may not.
	  Current SB version requires P166.)
	- Bugfix: Crash under Qemm and some emm386 configurations. 

 01/10/99 v0.065 
	- New  : Now my emu draws screens line by line (as real Speccy)
	  instead of simple redrawing every 1/50 sec. This fixes gfx
	  problems (flicker) in some games (for ex. Puzznic,Joe Blade 2).

 27/09/99 v0.060 
	- New  : Rewrote screen drawing procedure.It autodetects MMX-compatible
	  CPUs and uses MMX if available. Much faster than previous one even
	  on non-MMX CPUs. By default there's NO frameskipping now (dont
	  forget to overwrite old z80s.cfg by a newer one from z80s_060.zip)	  
	- Added: Keyboard Issue 2 emulation
	- Added: Menu to create/close PSG files (F2)
	(PSG file is a log of AY-3-8910(12) outs, you can play it with
	your favourite AY-3-8910(12) player)
	- Bugfix: z80 emulation fix (Robocop 2 and Blava demo)
	- Bugfix: Z80 snap loader fix (Technician Ted)
	- Bugfix: TAP loader fix (Turbo Outrun)
	- Bugfix: very rare write to ROM fixed (Joe Blade 2)
	- Bugfix: adjusted speed of virtual Speccy - now it's a bit slower
	  but closer to real one

 19/09/99 v0.050 'Music Support Release'
	- Added: AY-3-8910(12) emulation using Adlib!
	- Added: CPU Speed Autodetection 
        
 16/09/99 v0.040 
	- Added: Support for TAP files (tape image file).
	  You can select them in the menu (F1). After TAP file is opened
 	  you can load it as you did it on real Speccy. But don't forget
	  that some tapes will load only in 128K mode others in 48K.
	- Added: Saving snapshots in Z80 format
	  (this is default saving format but you can save your snaps in SNA
	  format if you enter filename ending with ".sna" or ".SNA" extensions) 
	- Added: Hardware Reset (F12)
	- Added: AY emulation (reading/writing AY regs)
	- Added: Speccy Speaker emulation using PC Speaker 
	  (just for fun :) by default disabled but you can enable it by
	  editing z80s.cfg)
	- Bugfix: pc counter in CPDR/CPIR instructions
	  (Match Day & Match Day 2 are working ok now)

 29/08/99 v0.030
	- First release with  User Interface (F1).  Now  you  can
  	  easily browse/load/save your snapshots ( Long filenames
	  are supported if emu works in Win98 ).
	- Few minor bugfixes.

 16/08/99 v0.024 
	- Save BMP screenshots (F8).
	- Fixed: BRIGHT RED color.
	- Fixed: loading snapshot files with Read-only attribute.
  	- A lot of asm optimisations in the cpu emulation core.
	  You will notice that speed increased if you set
	  MAXSPEED=YES in z80s.cfg.
	- Optimized screen update procedure a bit
	  (removed two instructions from the plot drawing part of 
	  screen update procedure)	
	- Exe linked with dynamic libraries -> size decreased
	- Exe packed with new exe packer 

 19/07/99 v0.023 
	- Bugfix: potential crash with old CPUs not supporting 
	  RDTSC instruction.

 12/07/99 v0.022 
	- Speed adjustment added! Look at z80s.cfg -  there's two new options:
	  CPU_SPEED=xxx (your cpu speed in Mhz) and MAXSPEED=YES|NO.
	  Don't forget to edit these values after reading this.
        - Small bugfix in z80 snapshot loading routine.

 05/07/99 v0.021 
	- Bugfix: several games (for example Chronos 128) now work.
	
 01/07/99 v0.020 This is a big update:
	- 128K and Pentagon emulation.
	- Few cpu core fixes. 
	- CAPS SHIFT and GRAPH keys are emulated. 
	- Kempston at port #DF.
        - More compability - now almost everything works ok.
	- New section in this doc - System requirements.
	- Changes in config file - take a look.

 25/05/99 v0.017 
	- Bugfix: Joe Blade 2 now works.

 21/05/99 v0.016 
	- Fixed some cpu emulation routines - a lot of  games now work 
	  (for example Elite, 3 Weeks in paradise).
  	- Kempston joystick via keyboard(arrows+CTRL) implemented.
 	- Optimized screen routine a little. 
	- Added Know problems section in this doc.

 16/05/99 v0.015 
	- Fixed DAA instruction - now time counter Spy Hunter works.

 14/05/99 v0.014 
	- Fixed crash under real DOS.
	- Fixed big slowdown in Win98 which occasionally happened. 
	- Added config file - z80s.cfg. 

 12/05/99 v0.013 
	- Fixed keyboard emulation - now int9 in protected mode
	  handles everything.
	- Cursor keys now working.
	- S**t happened-this version crashes under DOS but works perfectly 
	  under Win98:)). 

 09/05/99 v0.012 
	- Rewrote screen update procedure - now it's asm only
	- Some cpu emulation speedups.

 07/05/99 v0.011 
	- Everything 'cause it's the first public version.
	
	5. Usage.
	Ok first you must edit z80s.cfg - there's comments for 
	every option so it's not very difficult.
	After that just run z80s.exe to bootup Speccy 128 or Pentagon.
		
	
	About TAP files:
	 After selecting tape file you can load it as it was on real Speccy:
	Tape Loader in the 128K menu or go to 48K Basic and type LOAD "".
	If game doesnt load you should try both methods.
	
         Keys:

	 F1  - Load/Save snapshots menu 
	       In this menu:
	        F4 - Joystick type (Cursor,Kempston,Sinclair 1,Sinclair 2)
	             it will be emulated via cursor keys+Ctrl 
		     (read about F11 below)
		F5 - AY(YM) stereo mode (ABC,ACB,BAC)
		F6 - Music chip type (AY,YM)
		F7 - Covox On/Off
		F8 - SounDrive On/Off
	  	F9 - TRDOS mode with traps on/off
               In 'Load' menu Alt-D to change drive
               In 'Browse tape' menu 
		F4 - Unload VOC/WAV from memory
	 F2  - PSG file create/close menu
	 F3  - Load/Save disk images
	       In this menu:
		F4 - Remove disk
		F6 - Toggle write protection on/off
		F9 - Save disk 
	 F4  - MAGIC button, in Scorpion ZS 256 mode - Shadow service monitor
	 F5  - NMI (Non-maskable interrupt)
	 Alt-F5 - map CACHE to ROM & NMI
	 F6  - Turbo on/off (Z80 clocked at 2x-4x(7-14Mhz) / 1x(3.5Mhz) )
	 F7  - GIGASCREEN emulation on/off
	 Alt-F7  - Flash-color emulation on/off
	 Ctrl-F7 - Hardware multicolor emulation on/off
	 F9  - Pause/Unpause
	 F8  - Save BMP screensot
         F10 - Exit
	 F11 - Hotkey  to turn on/off joystick emulation via
	       cursor keys+Ctrl
	 Ctrl-F11 - CP/M switch (works only in Profi mode)
	 F12 - Reset
	 Ctrl-F12 - Reset to TRDOS
	 Delete - Debugger 
	 End - Debugger for General Sound board
	 PageUp - Built-in boot for TRDOS
	 Home - Start playing tape (VOC/WAV)

	 Keyboard LEDs:

	 Scroll Lock: Turbo on/off (Z80 clocked at 7/3.5Mhz)
	 Caps Lock  : Cursor keys+Ctrl are used for joytick emulation (on)
		      or for keyboard (off)
	 Num lock   : Flash-color on/off
	
	6. Debugger howto
	Press Delete to invoke debugger.
        In debugger:
	F1 - menu to load/save snapshots,disks,open/close PSG file,raise NMI
       	F6,Tab - switch between windows
       	ALT-1,2,3,4 - switch to certain window
       	F4 - Hex/Dec
       	F7 - Trace
	F8 - Step over
	Ctrl-G - jump to certain address (in dump,disasm,stack windows)	
       	ENTER - enter new value (in stack,registers windows,
	in memory dump window you can simply press 0-9,a-f to enter values
	or ' to enter character instead of numeric value)


	Disasm window:
	=============================
	F2 - set/remove breakpoints (in disasm windows)
	Ctrl-R - remove all breakpoints
	+ - disasm 1byte backward
	- - disasm 1byte forward
	Assembler: If disasm window is active you can easily type in
	asm mnemonic. For hex numbers put '#' before number or 'h' after it.
	JR/DJNZ - you can input direct address or +/- offset like this:
		jr nz,+120
		jr nz,-12 
		jr nz,ffffh (or jr nz,#ffff or jr nz,65535)

	7. Future plans.
	
	- Better Profi 1024 emulation.
	- FDI,TD0,FDD disk images support
	- Add more features to debugger
	- Printer emulation
	- Optional onscreen indicators of disk activity,Turbo on/off etc
	- SMUC,GMX,PC keyboard controller,full General Sound emulation
	- ATM and other clones emulation.
	- Support for TZX,low-level TAP support,FDI,TD0 formats
	- Better Z80 timing emulation.
	- Perfect video timing for all models.
	- Saving screenshots in GIF,JPG,PNG, whatever else 
	- Joystick emulation using PC joystick
	- More compability.
	- A lot of other small things and bugfixes.

	8. Greetings/Thanks.

 My Family - thanks for all. I love you.

 Hacker KAY - the author of AY-3-8910(12)/YM2149F emulation for Z80Stealth!
  Also he wrote ESS driver,UART procedures & smth else i forgot ;)
  Thanks for your support,ideas,a lot of bugreports ;) ...
  Also thanks for nice ANSI logo you've made for this doc.

 Sean Young  - thanks a lot for your docs about z80 

 Martin van der Heide - World of Spectrum is the best

 Himik - thanks for bugreports. and reminders about Profi ;)

 Eugene Palenock - thanks for tech info, schemes, bugreports 

 Dmitriy D - thanks a lot for techinfo,schemes and soft!

 Alexander Melkov - thanks for Profi disk dumps

 Illuminator - thanks for writing WSS driver for my emu!

 Paul Pavlov - thanks for creating VT - it rulez
  but plz - drink less vodka ;)

 DJ Psych - Psycho team rulez forever!

 Mac Buster - thanks for tech info about Betadisk

 Dmitry Kozlov - thanks for your FAR plugins and sources of td0->trd converter

 Sergey Vladimirovich Bulba - author of cool AY-3-8910 Emulator/Player.
  Thanks for info about PSG files. 

 Alexandr Ageev - thanks for report about slowdown caused by ISA video card.

 Carl Murray - thanks for bugreport about Num Lock + cursor keys.

 Raul Gomez Sanchez - author of very good speccy emulator

 Rodolfo Edison Guerra - author of SpecBASE. Thanks for supporting my
   emu in SpecBASE and for sending soluting of 'emm386' trouble

 Miodrag Stancevic - thanks for your report about trouble with Blava demo &
   saying that my emu is a bit faster than a real Speccy.

 Thomas Harte - thanks for your letter about Puzznic. It gave me the idea
   to implement line-by-line rendering in my emu.	

 K.Uglekov - wrote best speccy emulator-debugger. 

 Oleg Prokhorov - thanks for 32lite.exe. One of the best dos32 exe packer.

 Eugene Roshal - wrote FAR - best Win32 file manager.

 Harald Thunem - thanks for HTScreen library



	9. Contact me.
	  
	e-mail: Mr.Kirill@mtu-net.ru	
	Feel free to drop me a letter.

	Z80Stealth linx: http://z80stealth.emuunlim.com
			 (redirects: z80.da.ru, z80.tsx.org)
			 http://pos.izhnet.ru		
	