---------------------
msxDS v.0.86 Manual
---------------------

Présentation:

msxDS is an emulator of MSX/MSX2/MSX2+ computers for Nintendo DS/DS Lite.
Requires a flash card adapter with DLDI support to work.

msxDS est basé sur fmsxDS v.0.07 de Nyagosu. Since then, several bugs fix and improvements have been added.

---------------------------------------------------------------

Download:

Please download msxDS on the official website at the following address.

http://www.alternate-fmsxds.webs.com/index-fr.html

---------------------------------------------------------------

Setup:

    * Unzip the archive and copy fmsxDS.nds on your flash card.
    * Copy the /msxds folder that contains 'CMOS.ROM' and 'Carts.crc' files into root of your flash card.
    * Copy MSX/MSX2/MSX2+ japanese BIOS, FM-PAC BIOS and Kanji ROM into this folder. That is the following files.

      - MSX.ROM = MSX BIOS and BASIC (CRC32: EE229390 or 071135E0)
      - MSX2.ROM = MSX2 BIOS and BASIC (CRC32: 9B3E7B97)
      - MSX2EXT.ROM = MSX2 ExtROM (CRC32: 43E7A7FC)
      - DISK.ROM = DiskROM and BDOS (CRC32: 697EAF4E)
      - FMPAC.ROM = FMPAC BIOS (CRC32: 0E84505D)
      - KANJI.ROM = JIS 1st+2nd Class kanjis ROM from FS-A1WSX (CRC32: 1F6406FB) (256KB)
      - MSX2P.ROM = MSX2+ BIOS and BASIC from FS-A1WSX (CRC32: 19771608)
      - MSX2PEXT.ROM = MSX2+ ExtROM from FS-A1WSX (CRC32: B8BA44D3)
      - A1WXKDR.ROM = Kanji Basic from FS-A1WSX or FS-A1WX (CRC32: B4FC574D or A068CBA9)
      - CMOS.ROM = To save parameters of the MSX.

Please verify the checksuns of BIOS. Need DLDI patch to work.

Note: 
For the Supercard SD/miniSD, please use the following DLDI driver.

http://www.alternate-fmsxds.webs.com/msxds/dldi.scp-neoDS.7z

Decompress the archive and copy the 'dldi.scp' file into micro SD root directory. The DLDI patch will be applied automatically at launch. NeoDS works fine with this driver also.

---------------------------------------------------------------

Instructions:

At launch msxDS, a menu with icons is displayed. Here's their description.

- ON/OFF button can turn ON or OFF the MSX.
- The icons representing a cartridge can launch your ROM image files. Only '.rom' files are displayed.
- The icons representing a floppy disk can launch your floppy disk image files. Only '.dsk' files are displayed.
- The icon representing a tape can launch your tape image files. Only '.cas' files are displayed.
- The icon representing a DS can fit to screen or shift the MSX display. It's useful only in mode MSX2/2+.
- The Load state icon can load the last saved MSX state. (Previously You must select the corresponding ROM, floppy(s) and/or tape.)
- The Save state icon can save the MSX state. (Need a double-tap to save.)
- MSX logo icon can choose the MSX type (MSX/MSX2/MSX2+).
- The icon representing a speaker can select the sound mode. (PSG, PSG+SCC/SCC+ or FM.)
- Icon with the cross closes the menu.

You can place your image files into any folder into your flash card.

Buttons Description:

A = OK / Button 1 of MSX joypad 1
B = Back to previous folder / Button 2 of MSX joypad 1
Y = Floppy/Cartridge ejection
Start = Menu Display
Pad = MSX Joypad 1

---------------------------------------------------------------

Versions history:

Version 0.86 (2010-09-18)

- Added scrolling file names with the stylus.
- Now we must do a double-tap on the save-state icon.
- Modified the routine of collision of MSX1 sprites for Pitfall II.
- Small improvement of the UI.
- MSX2 mode by default (because it is faster than the MSX2+ mode).
- Fixed some bugs in the patch the ROM disk. (Improved DSK images support.)
- SCC+ emulation (for SD Snatcher, Konami Game collections, etc...).
- Fixed of the screen12 color contour which was managed like the screen8.
- Removal of some useless display conditions. (msxDS is still a bit faster!)

Version 0.85 (2010-08-22)

- Added many crc32 of megarom from Korea.
- Fixed 32KB ROM mirrors.
- Rewrote sprites routines. (full emulation)
- Super Pierrot mapper support.
- Some small fix in the megaroms mappers routines.
- Fixed status register 0 of VDP in MSX1 mode. (Zaxxon published by Electric Software works.)
- Added Kanji BASIC support. (The a1wxkdr.rom file is now required.)
- MSX2+ logo is displayed.
- Use of TCM memory for several graphics routines. (msxDS is a bit faster!)
- Double-tap on a file name to select it (and close the window).
- Use of L and R triggers for 'Fire Ball' and 'Roller Ball' pinballs. (ROM versions only)

Version 0.84 (2010-06-25)

- Fixed a small bug in the keyboard.
- Added Kanji ROM support. You can also input Kanjis in BASIC by loading the kanji driver ROM (CRC32: B4FC574D/32KB) into SLOT 1 or 2. 
- Added emulation clock (RTC).
- Improved ROM support. The 'Carts.crc' file is required for some megaroms.

Version 0.83 (2010-05-26)

- Fixed a bug in the management of background color for screen 0.
- Added tape emulation. Support files CAS with fMSX-DOS format.
  Usually, to load a game tape, select a file CAS with the tape icon and turn on the MSX with SHIFT pressed until the sound "Beep" and then enter 'RUN"CAS:' or 'BLOAD"CAS:",R' or 'CLOAD' in Basic. 
- Improved keyboard.
- Improved folders management.

Version 0.82 (2010-05-10)

- Compiled with devkitARM r30 and Libnds 1.4.3+.
- Fixed a bug in the management of color 0 for screen 6 mode.
- Added a filter to improve the display quality of high resolution modes.
- There are now three sound modes (PSG at 40Khz, PSG+SCC at 22Khz, PSG+FM at 8Khz).
- Fixed the path of instant save file that was saved by mistake at the root.
- The selection of cartridges, MSX type and sound mode is blocked when the MSX is ON.
- Improved change of display mode.

Version 0.81 (2010-03-20)

- MsxDS no longer crashes after MSX reboots.
- Scrolling of file name selected when it exceeds the frame.
- Memorization of location of last opened folder.

Version 0.8 (2010-03-03)

Already 3 years that I had not coded it. This year I am pleased to finally offer an update with many changes which are not all visible to the user but necessary. This is main changes.

- Compiled with devkitARM r27 and libnds 1.4.0.
- Using of the libfifo optimized by Cooper.
- New sound routine (It's more clean & faster).
- Loader window is bigger and more convenient.

Version 0.7+ (2007-09-19)

- Add MSX2+ scrolling.
- Loader rewritted.
- Improved sprites.
- New icons.
- Add screens modes.

---------------------------------------------------------------

Known issues:

- The sleep mode is stable only when the menu of msxDS is displayed.
- The keyboard support a japanese Bios only.
- The keyboard is malfunctioning when a software doesn't pass through the bios to access to keyboard.

---------------------------------------------------------------

Tip & Tricks:

To run a European game on tape at 50Hz, enter the following instruction before in MSX2 mode.

VDP(10) = VDP(10) OR 2

---------------------------------------------------------------

FAQ:

Q. How to Saving in Metal Gear 1 ?

 A. Metal Gear has 3 ways of saving games:

 1. The usual way. This is the save option from the game itself.

   - the first time you need create un empty file filename.cas (or use Empty.cas file of /msxDS folder).
   - copy this file on your flash card and select if with msxDS.
   - in game, press F1 to do a pause and then F5 to open save menu.
   - input a name and you can save on tape.
   - skip the verification step because no need to verify it.

  Note: saving in this way is only useful after reaching the elevator. You will continue in the last elevator you where in.

  Loading method:

   - start Metal Gear and select the file filename.cas.
   - press F1 to do a pause and then F4 to open load menu.
   - input a name and you can load from tape.

  Note: A bug (of Metal gear?) that crashes the game when the save is not found at the end of tape. To avoid this, do not input a wrong name and eject the tape before reload the same save.

 2. The second way. This is done with the Game Master 2 cartridge into SLOT 1.

   - after booting, select "GAME" to start Metal Gear.
   - at any time during the game, tap the STOP key then Tap CTRL key to open the save menu. (Tap CTRL again to unpress it)
   - insert a user disk (a blank disk in first time) in the msxDS disk drive.
   - choose "DISK SAVE" from the menu.
   - choose "GAME DATA" in the "DISK-SAVE" menu.
   - input a filename for your save game. The game will now be saved to disk image. After saving, choose "END" and press the STOP key again. The game will resume.

  Loading method:

   - Start Metal Gear as described upper.
   - in the save menu, choose "DISK LOAD".
   - insert the disk image on which your save game was saved.
   - choose "GAME DATA".
   - The game will list the files on the disk that are savegame files. Select the one you want to load and it will be loaded.
   - Choose "END" and press the STOP key to resume the game.

  3. There is a save-state mechanism yet in msxDS. This is the easiest method. (Need two taps on save state icon to save.)

---------------------------------------------------------------

Popolon

---------------------------------------------------------------

Thanks to Copper, Marat Fayzullin, Nyagosu and ProgDS.