
fMSX32 15/11/03 "BCNParty RU MSX 2003 Edition" release (public), (c) 2002-2003 rlyeh


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


------------------
1. What's fMSX32 ?
------------------

 fMSX is a portable MSX computer emulator coded by Marat Fayzullin and others.
 fMSX32 is a fMSX emulator port for the GP32 handheld console by rlyeh.

 It was ported and modified from the original fMSX emulator for UNIX.

 You can download the original fMSX source code for UNIX from http://fms.komkon.org/fMSX

 You can download the latest fMSX32 binary from http://www.retrodev.info
 I will not release the source code since I was explicitly told by Marat to not release it.


----------
2. History   
----------
  
 15/11/03: fMSX32 "RU 2003 Edition" release (public)

    - full working savestates and loadstates
    - full working positionable virtual keyboard
    - fixed a strange bug related to SMC health. No more clusters lost :-)
    - fixed colours in disk loading image
    - fixed some minor bugs related to stability
    - fixed sound issue when resetting computer
    - fixed stability issue when changing ROM Mapper in the fly
    - fixed support for FMPAC through classic Marat's YM2413 sound core (internal slot)
    - new ability at loading bigger roms (up to 8 mbits)
    - new ability at loading two roms at once (konami cheats related)
    - new ability at choosing MSX1, MSX2 or MSX2+ model
    - new ability at choosing JAP or EUR regions
    - new ability at choosing NTSC or PAL screen modes
    - new adjustable autofire for A and B buttons
    - new cool icon (thx Antiriad!)
    - new exprimental RF multiplayer (through Black's RF libs. Thx! :)
    - new fast fileselector (able to scan 1,200 zipped roms per minute)
    - new game database through TOSEC (supporting 5,500 disks/roms/tapes)
    - new hardcoded pause for most games (through SELECT key)
    - new internal database to force using undetected rom mappers (Lupin, Aleste, Xevious Fardraut Saga...)
    - new optimizations done (it stills working at 80 MHz)
    - new preliminary support for tapes (CAS)
    - new preliminary cheats searcher
    - new preliminary support for overscan games like Matra ones (224 scanlines instead of 192/212) 
    - new support for 160, 180, 320, 360, 640, 720, 1280 and 1440 kb disks (DSK,IMG or DDI format)
    - new support for MSX-DOS2 cartridge with original OS disk included
    - new user interface (fSMS32 style)
    - improved speed when grabing snapshots (PNG format)
    - improved support for multiple disks games 
    - increased compatiblity by using universal poke when loading tapes 
    - increased compatiblity by using MSX1 mode when loading tapes 
    - increased compatiblity by disabling second diskdrive at boot sequence 
    - changed MSX2 bios to japanese version (60 Hz)
    - changed keyboard shortcuts where L+{UP,DOWN,LEFT,RIGHT,SELECT} are {f1/1,f2/2,f3/3,f4/4,f5/5} 
    - some cosmetic changes done, and a new intro/credits


 17/03/03: fMSX32 "GBAX.COM 2003 Contest" release (public)

    - full MSX1 and MSX2 support, partial MSX2+ support,
    - full ROM/DSK/DDI/IMG/ZIP/GZ loading, (packed files using ZLib)
    - full AY/SCC/SCC+/YM sound support,   
    - full cursor/joystick/mouse support,
    - preliminary RF multiplayer gaming (slow),
    - crystal sound rendering output, using CHN's library,
    - 99% of compatibility,
    - saving screenshots to PNG format, using my own library,
    - CRC32 ROM naming detection using GoodMSX by Cowering,
    - featuring extras: preliminary GUI, built-in menus. 

 
 18/06/02: fMSX32 "first" release (private)

    - preliminary MSX1/MSX2 support,
    - preliminary ROM loading,
    - preliminary AY sound,
    - preliminary joystick/keyboard support,
    - preliminary sound rendering output, using Groepaz's library,
    - 30% of compatibility.


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

   Check (2)


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

   Not available in txt file.


--------------------
5. Installing fMSX32
--------------------

   Put your fMSX32.FXE into GPMM\
   Put your ROM/DSK/IMG/DDI files uncompressed or zipped into GPMM\MSX

   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 fMSX32
---------------

   PAD is mapped as the MSX joystick and cursor keys.
   A fires the joystick button 1 and Space key.
   B fires the joystick button 2 and M key.

   SELECT is mapped as F1 and STOP. This will pause most games nicely (like KnightMare).
   START shows or hides a virtual keyboard where A/B pushes keys with/without Shift.
   Press L+R to choose options while playing.

   There are keyboard shortcuts for options in most games as well. They are mapped as following:

   L+UP     = F1 and 1 keys
   L+DOWN   = F2 and 2 keys
   L+LEFT   = F3 and 3 keys
   L+RIGHT  = F4 and 4 keys
   L+SELECT = F5 and 5 keys


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

   Q. The emulator freezes and it says there are only 4 games found, why?
   A. The games folder has changed now to GPMM\MSX. Put your games there.

   Q. The screen splits itself into 4 pieces sometimes, why?
   A. It's a bug related to programming double buffering video without the SDK.
      RobBrown is looking for a solution nowadays. Meanwhile press L+R and B to fix it.

   Q. I added/deleted some games and the list is wrong now, why?
   A. You have not forced to re-scan a new list. Press SELECT-SELECT at the file selector.

   Q. I cannot set some of supposedly working options, why?
   A. Check that your option is compatible with your selected game or system atm.
      For example, there is no MSXDOS-2 OS support if you're loading a tape, so
      Only loading disk would show that option in menu.

   Q. I have some ROM/DSK games not working, why?
   A. MSX games have been extensively hacked for years.
      It could be a variant or a hacked version. Please use another one.

   Q. I know my ROM game is not hacked but it's not working, why?
   A. Please force the emulator to use another ROM mapper in the options.
      Autodetection does not always work, but it should in most cases.
      Btw, tell me the TOSEC game name to upgrade the autodetection database.

   Q. Some keyboard keys as \ [ ] ' etc seems wrong when pushed, why?
   A. The keyboard layout changes when using different bioses acording to different countries.
      I'll add support for different keyboard layouts soon.

   Q. The game is too fast/slow sometimes, why?
   A. There is a strange issue with GamePark SDK related to timers when running at 80 MHz.
      I will fix it soon. Meanwhile enable the frame limit option.

   Q. The percentage speed in upper left corner seems wrong, why?
   A. See previous answer.


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

MSX standard at www.old-computers.com - [ http://www.old-computers.com/museum/company.asp?st=1&m=86 ]
MSX news     at www.msx.org           - [ http://www.msx.org                                        ]
MSX stuff    at www.funet.fi          - [ http://www.funet.fi/pub/msx/                              ]
MSX FAQ      at www.faq.msxnet.org    - [ http://www.faq.msxnet.org/                                ]
Some cheats  at Sean Young's page     - [ http://www.msxnet.org/konami/combinations                 ]
MSX-DOS Info at Marat's page          - [ http://fms.komkon.org/MSX/Docs/EasyGuide.txt              ]

                        GP32 news and info at
[ www.gp32spain.com , www.gp32news.com , www.gp32x.com , www.gp32emu.com ]


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

  Marat Fayzullin and others, for the fMSX Unix emulator.

/*Mitsutaka Okazaki, for the YM2413 library.
  Tatsuyuki Satoh, for the FM-OPL library.   
  (Accurate FM and AY sound are disabled for this release :-)*/

  Christian Nowak, for the GP32 soundbuffer library.

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

  TOSEC group, for the MSX DAT files.

  Mr_Spiv, for the B2FXEC tool.

  xns and _Anarchy_, for supporting fMSX32.

  reliant77, for his one hundred snapshots.

  Antiriad, for his cool icon.


------------
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 BCNParty RU MSX 2003 meeting visitors who shown interested in this emu ^__^

  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,JyCet,karter,karthur,Kojote,krb_,
  Linkeado,MikeDX,MikeHunt,mr_spiv,_Mystic_,Nebur2k3,Neo-Gaka,NhuNhu,Nuria[],Pekele,ph0x,
  prophet,rattboi,reliant77,|Rico,rino,Sanosuke,skeezix,tethor,Tetsu,tfc,TheWub,ThunderZ,
  _Toris,TRaNS,Tyke|,_tyrell_,Whitesnake,xns,Xtherm,Yenaphe,ZardozJ, etc! ...
  many c==3s 4 all, thx for supporting or complaining about my emus :-)

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


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





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

