

fZX32 25/12/04 first public release (x-mas edition), (c) 2004 rlyeh


1. What's fZX32 ?
2. History
3. Features
4. Screenshots
5. Installing fZX32
6. Using fZX32
7. FAQ
8. Resources
9. Credits
A. Greetings


-----------------
1. What's fZX32 ?
-----------------

 fZX32 is a portable Spectrum emulator based on ASpectrum,FUSE,X128 and Caprice.
 fZX32 uses portions of code from the following emulators:

 - ASpectrum is a portable Spectrum computer emulator coded by Santiago Romero and others.
 - FUSE is a Spectrum computer emulator for UNIX coded by Philip Kendall and others.
 - X128 is a Spectrum computer emulator for DOS coded by James McKay and others.
 - Caprice is a portable CPC computer emulator coded by Ulrich Doewich.

 fZX32 uses the following portions of code:

 - ASpectrum : Z80 emulation, spectrum palette, beeper, and keyboard emulation
               .sna48, .sp and preliminar .tzx fileformat support

 - FUSE      : AY-3-8912 and beeper emulation.

 - Caprice   : NEC pd765A floppy disk controller emulation.

 - X128      : .z80 decompression routine

 everything else was coded from scratch by rlyeh. However, fZX32 would not exist
 without the talented efforts of Santiago, Philip, James and Ulrich. Thanks you very much!

 You can download the latest fZX32 binary from http://www.retrodev.info/
 I will release the source code as soon as I clean it a bit.


----------
2. History
----------

  
 25/12/04: fZX32 first release (public)

    - Amazing speed! All games play frameskip 0 @ 133 mhz with contended memory and sound emulation,
    - No compatibility bugs found (tested more than 800 games),
    - Emulation of ZX 16, ZX 48, ZX 128, ZX +2, ZX +2A and ZX +3 spectrum models.
    - Full working animated savestates and loadstates,
    - Full SCR/ROM/BIN/TAP/DSK/SNA48/SNA128/SP/Z80(any)/ZIP loading, (packed files using ZLib)
    - Full kempston, cursor, fuller, sinclair1, sinclair 2 joystick emulation.
    - Fuller audio box emulation,
    - Accurate border emulation,
    - AY-3-8912 and beeper sound emulation,
    - NEC PD765A floppy disk controller emulation,
    - Interface II cartidge emulation,
    - Mikro-plus cartridge emulation (Shadow of the Unicorn),
    - Gray monitor emulation,
    - Instant tape loading,
    - Tone pilot generation and real tape noise when real mode tape loading,
    - Preliminary TZX tape support (only block #10 tapes),
    - Preliminary contended memory emulation (multicolor effects),
    - Preliminary floating bus emulation,
    - Virtual Keyboard suppoprt,
    - Ericcson chatboard support,
    - Crystal AY sound rendering output, using CHN's library (thx dude),
    - Saving screenshots to PNG format, using my own library,
    - CRC32 ROM naming detection using TOSEC DB by TOSEC team (thx guys!),
    - Improved fileselector (slower scrolling, ability to delete roms, no-roms/only-4-roms bug fixed)
    - Fast fileselector (able to scan some hundred zipped roms per minute),


    What's lacking:

    - crystal 48k beeper sound emulation (wait for the next release),
    - adding betadisk interface and some russian spectrum models,
    - adding gunstick
    - adding kempston amx
    - adding more missing options
    - adding RF multiplayer
    - fixing known bugs as usual :-)


-----------
3. Features
-----------


    - Amazing speed! All games play frameskip 0 @ 133 mhz with contended memory and sound emulation,
    - No compatibility bugs found (tested more than 800 games),
    - Emulation of ZX 16, ZX 48, ZX 128, ZX +2, ZX +2A and ZX +3 spectrum models.
    - Full working animated savestates and loadstates,
    - Full SCR/ROM/BIN/TAP/DSK/SNA48/SNA128/SP/Z80(any)/ZIP loading, (packed files using ZLib)
    - Full kempston, cursor, fuller, sinclair1, sinclair 2 joystick emulation.
    - Fuller audio box emulation,
    - Accurate border emulation,
    - AY-3-8912 and beeper sound emulation,
    - NEC PD765A floppy disk controller emulation,
    - Interface II cartidge emulation,
    - Mikro-plus cartridge emulation (Shadow of the Unicorn),
    - Gray monitor emulation,
    - Instant tape loading,
    - Tone pilot generation and real tape noise when real mode tape loading,
    - Preliminary TZX tape support (only block #10 tapes),
    - Preliminary contended memory emulation (multicolor effects),
    - Preliminary floating bus emulation,
    - Virtual Keyboard suppoprt,
    - Ericcson chatboard support,
    - Crystal AY sound rendering output, using CHN's library (thx dude),
    - Saving screenshots to PNG format, using my own library,
    - CRC32 ROM naming detection using TOSEC DB by TOSEC team (thx guys!),
    - Improved fileselector (slower scrolling, ability to delete roms, no-roms/only-4-roms bug fixed)
    - Fast fileselector (able to scan some hundred zipped roms per minute),


--------------
4. Screenshots
--------------

   Not available in txt file.


-------------------
5. Installing fZX32
-------------------

   Put your fZX32.FXE into GPMM\
   Put your files uncompressed or preferredly zipped into GPMM\ZX

   Note: Only first file from ZIP will be used at the moment. It will be fixed soon.
   Note: I suggest using *ONLY* zipped files. It improves speed at loading and
         minimizes SMC space usage.


--------------
6. Using fZX32
--------------

   PAD is mapped as first player's gamepad.
   A fires the joystick button.
   B fires the joystick button and SPACE (secondary fire in many games).
   START does nothing yet (auto-start game feature disabled atm).
   SELECT launches the virtual keyboard.

   Press L+R to choose options while playing.


------
7. FAQ
------

   Q. 48k beeper has crackling noises but AY is crystal. Any idea?
   A. Yes, i'm working on that beeper. Stay tuned.

   Q. When I pop up the virtual keyboard there are some crackling noises. Is it ok?
   A. Yes, i'm working on that too. Stay tuned.

   Q. Some tapes refuse to work. How do I fix it?
   A. Try to load it in 48k mode. That's a common Spectrum issue (not my fault).

   Q. How do I enable Ericcson chatboard?
   A. Plug it before running fZX32.


------------
8. Resources
------------

Everything about Spectrum at          - [ http://www.worldofspectrum.org/                           ]
PD roms     at Kojote's site          - [ http://www.pdroms.com/                                    ]


----------
9. Credits
----------

I'd like to shake energically my hands to...

  Javier Chocano and kotah: for some contended memory help. thx! :)

  Mirko: for the chatboard & gp_setframebuffer source code. thx! :)

  Reesy: for the 4-split bug fix and some triple buffering ideas.
         Also for the DrZ80 source codes which I will use in fMAME32.
         And for the good and friendly mails :)

  enkonsierto, Pelayo, DSkywalk, ref__, antiriad, hexdump, vnomis
  Dj_syto, K-teto, Vimacs, Mr_spiv : for testing the previous betas.

  Nigelibro, for donating me a Ericcson chatboard. thanks man :)

  Santiago, Philip, James and Ulrich, for your Spectrum emulators.

  Antiriad, for his cool icon and his marvellous splash screen :-)

  Jean-loup Gailly and Mark Adler, for the ZLIB library.

  TOSEC Team, for the DAT file.

  Mr_Spiv, for the B2FXEC tool.

  _Anarchy_, hando, Guywfakes, EvilDragon and the whole boards staff,
    for supporting my emus so much at gp32 sites.

  Everyone I'm forgetting, sorry for that :)


------------
A. Greetings
------------

  all the gp32 scene staff, for keeping GP32 spirit alive. 

  zardozj,spiv,Toris,DJWillis,RobBrown,Skeezix and black--, for cool dev chats :-)

  mr_spiv,darkfader,pacman,for some dev tools. Good work! :)

  all the ppl who sent irc/mails msgs encouraging the emulator! ^__^

  A600,_Anarchy_,Antiriad,APL-3,AR3NA,atrkid,Badxil,betisweb,black--,CHN,Costis,_cr4sh_,
  craigix,DarkFader,DarkWolf9,Desther_1,dev,DICEASE,DJ_Syto,DrWh0,Ecthegion,esoteric_,
  eXcess,FagEmul,[FireFly],Flavor,FoxRage,fx-man,galaDky,giffel,groepaz,Guyfawkes,hando,
  HaunteR,Hokutoy,_Hybrid,IcemanGP,Intelecto,Intruder,jegHegy,JyCet,karter,karthur,Kojote,
  krb_,Linkeado,MikeDX,MikeHunt,mr_spiv,_Mystic_,Nebur2k3,Neo-Gaka,NhuNhu,Nuria[],Pekele,
  ph0x,prophet,rattboi,reliant77,|Rico,rino,Robster,Sanosuke,skeezix,tethor,Tetsu,tfc,TheWub,
  ThunderZ,_Toris,TRaNS,Tyke|,_tyrell_,vimacs,Whitesnake,xns,Xtherm,Yenaphe,ZardozJ,etc!..
  many c==3s 4 all, thx for supporting/complaining all time about my emus :-)

  And to my lovely girlfriend cariii who's dedicated this emulator to :-)

                                       
               _______   _______   ___  ___    _______  _____
              / _____/\ /____  /\ /__ \/__/\  /____  /\/____ \
             / /\____\/ \___/ / / \_/ / __\/ _\___/ / /\___/ /\
            /  ____/\  / ____/ /   / / /    /____  / // ____/ /
           / /\____\/ / /____\/ __/ /_/_   _\___/ / // /____\/
          /_/ /      /______/\ /___/___/\ /_____ / //______/\ 
          \_\/       \______\/ \___\___\/ \______\/ \______\/ !rlyeh




----
 God bless bits.
  ----
