some fixes
[picodrive.git] / platform / base_readme.txt
index 75dde94..a50f80d 100644 (file)
@@ -30,7 +30,7 @@ How to make it run
 ------------------\r
 \r
 #ifdef GP2X\r
-Copy PicoDrive.gpe, pico940.bin and mmuhack.o to any place in your filesystem\r
+Copy PicoDrive.gpe, pico940_v2.bin and mmuhack.o to any place in your filesystem\r
 (all 3 files must be in the same directory) and run PicoDrive.gpe.\r
 Then load a ROM and enjoy! ROMs can be in .smd or .bin format and can be zipped.\r
 \r
@@ -49,9 +49,7 @@ If you are running a custom firmware, just copy the whole PicoDrive directory to
 /PSP/GAME or /PSP/GAMEXXX directory in your memory stick (it shouldn't matter\r
 which one GAME* directory to use).\r
 \r
-If you are on 1.5, you will have to use KXploit tool to create the needed files\r
-and directories, and then copy them to /PSP/GAME. I assume 1.5 users know how to\r
-do this, if not, just google for KXploit.\r
+If you are on 1.5, there is a separate KXploited version for it.\r
 \r
 #endif\r
 Note that this emulator may require some tweaking of configuration settings to run\r
@@ -101,12 +99,14 @@ must be stereo, or else they will play too fast/slow or won't play at all.
 Be sure NOT to use anything but classic mp3 format (don't use things like\r
 mp3pro).\r
 \r
-ISO files can also be zipped (but not mp3 files, as they are already\r
-compressed). Note that this can cause very long loading times, which may\r
-take up to several minutes. File naming is similar as with uncompressed ISOs.\r
+ISO files can also be .cso compressed or zipped (but not mp3 files, as they\r
+are already compressed). CSO will cause slightly longer loading times, and\r
+is not very good for FMV games. Zipping ISOs is not recommened, as it will\r
+cause very long (several minute) loading times, and make some games\r
+unplayable. File naming is similar as with uncompressed ISOs.\r
 Example:\r
 \r
-SonicCD.zip             data track\r
+SonicCD.cso             data track\r
 SonicCD_02.mp3          audio track 1 (CD track 2)\r
 SonicCD_03.mp3\r
 ...\r
@@ -125,11 +125,14 @@ Other important stuff
   Incorrectly named/missing mp3s may also be the cause.\r
 * Sega/Mega CD: If the background music is missing, you might have named your\r
   MP3s incorrectly. Read "How to run Sega/Mega CD games" section again.\r
-* Sega/Mega CD: If the game music plays too fast or too slow, you have encoded\r
-  your MP3s incorrectly. You will have to re-encode and/or resample them.\r
+* Sega/Mega CD: If the game music plays too fast/too slow/out of sync, you have\r
+  encoded your MP3s incorrectly. You will have to re-encode and/or resample them.\r
   PicoDrive is not a mp3 player, so all mp3s MUST be encoded at 44.1kHz stereo.\r
   Badly encoded mp3s can cause various kind of problems, like noises, incorrect\r
   playback speeds, not repeating music or even prevent game from starting.\r
+  Some games (like Snatcher) may hang in certain scenes because of this.\r
+  Some mp3 rippers/encoders remove silence and beginning/end of audio tracks,\r
+  what causes audio desyncs and/or mentioned problems.\r
 * Sega/Mega CD: If your games hangs at the BIOS screen (with planets shown),\r
   you may be using a bad BIOS dump. Try another from a different source.\r
 * Some Sega/Mega CD games don't use Z80 for anything, but they leave it active,\r
@@ -166,12 +169,14 @@ mid-frame image changes (raster effects), so it is useful only with some games.
 \r
 Other two are accurate line-based renderers. The 8bit is faster but does not\r
 run well with some games like Street Racer.\r
+\r
 #endif\r
 #ifdef GIZ\r
 This option allows to switch between 16bit and 8bit renderers. The 8bit one is\r
 a bit faster for some games, but not much, because colors still need to be\r
 converted to 16bit, as this is what Gizmondo requires. It also introduces\r
 graphics problems for some games, so it's best to use 16bit one.\r
+\r
 #endif\r
 #ifdef PSP\r
 This option allows to switch between fast and accurate renderers. The fast one\r
@@ -179,8 +184,8 @@ is much faster, because it draws the whole frame at a time, instead of doing it
 line by line, like the accurate one does. But because of the way it works it\r
 can't render any mid-frame image changes (raster effects), so it is useful only\r
 for some games.\r
-#endif\r
 \r
+#endif\r
 #ifdef GIZ\r
 @@0. "Scanline mode"\r
 This option was designed to work around slow framebuffer access (the Gizmondo's\r
@@ -196,14 +201,15 @@ averaging and may look a bit nicer, but blurry. Horizontal scaling is only for
 games which use so called "32 column mode" (256x224 or 256x240), and scales\r
 image width to 320 pixels. Vertical scales height to 240 for games which use\r
 height 224 (most of them).\r
+\r
 #endif\r
 #ifdef GIZ\r
 @@0. "Scale low res mode"\r
 The Genesis/Megadrive had several graphics modes, some of which were only 256\r
 pixels wide. This option scales their width to 320 by using simple\r
 pixel averaging scaling. Works only when 16bit renderer is enabled.\r
-#endif\r
 \r
+#endif\r
 @@0. "Accurate timing"\r
 This adds some more emulation precision, but slows the emulation down. Without\r
 this option some games do not boot (Red Zone for example), others have sound\r
@@ -532,17 +538,19 @@ bram (internal backup RAM): yes
 Problems / limitations\r
 ----------------------\r
 \r
-* 32x and SVP are not emulated.\r
+* 32x is not emulated.\r
+#ifdef PSP\r
+* SVP is not emulated.\r
+#endif\r
 * Various VDP quirks (window bug, scroll size 2, etc.) are not emulated,\r
   as very few games use this (if any at all).\r
-* Some games don't work or have glitches because of inaccurate timing and sync\r
-  between the emulated chips.\r
+* The emulator is not 100% accurate, so some things may not work as expected.\r
 \r
 \r
 Credits\r
 -------\r
 \r
-This emulator uses code from these people/projects:\r
+This emulator is made of the code from following people/projects:\r
 \r
 notaz\r
 GP2X, UIQ, PSP, Gizmondo ports, CPU core hacks,\r
@@ -594,6 +602,7 @@ Additional thanks
 * Charles MacDonald (http://cgfm2.emuviews.com/) for old but still very useful\r
   info about genesis hardware.\r
 * Steve Snake for all that he has done for Genesis emulation scene.\r
+* Tasco Deluxe for his reverse engineering work on SVP and some mappers.\r
 * Bart Trzynadlowski for his SSFII and 68000 docs.\r
 * Haze for his research (http://haze.mameworld.info).\r
 * Mark and Jean-loup for zlib library.\r
@@ -627,6 +636,39 @@ Additional thanks
 \r
 Changelog\r
 ---------\r
+1.40\r
+  + Added support for SVP (Sega Virtua Processor) to emulate Virtua Racing,\r
+    wrote ARM recompiler and some HLE code for VR.\r
+  * Changed config file format, files are now human-readable. Game specific\r
+    configs are now held in single file (but old game config files are still\r
+    read).\r
+  * Fixed a bug where some key combos didn't work as expected.\r
+  * Fixed a regression in renderer (some graphic glitches in rare cases).\r
+  * Adjusted fast rernderer to work with more games, including VR.\r
+  * Fixed a problem where SegaCD RAM cart data was getting lost on reset.\r
+\r
+1.35b\r
+  * PSP: mp3 code should no longer fail on 1.5 firmware.\r
+  + PSP: added gamma adjustment option.\r
+  + Added .cso ISO format support. Useful for non-FMV games.\r
+  * It is now possile to force a region after the ROM is loaded.\r
+  * Fixed a sram bug in memhandlers (fixes Shining in the Darkness saves).\r
+  * PSP: fixed another bug in memhanlers, which crashed the emu for some games\r
+    (like NBA Jam and NHL 9x).\r
+  + PSP: added suspend/resume handling for Sega CD games.\r
+  + GP2X: added additional low volume levels for my late-night gaming sessions\r
+    (in stereo mode only).\r
+  + GP2X: added "fast forward" action in key config. Not recommended to use for\r
+    Sega CD, may case problems there.\r
+  * Some other small tweaks I forgot about.\r
+\r
+1.35a\r
+  * PSP: fixed a bug which prevented to load any ROMs after testing the BIOS.\r
+  * PSP: fixed incorrect CZ80 memory map setup, which caused Z80 crashes and\r
+    graphics corruption in EU Mega CD model1 BIOS menus.\r
+  + PSP: added additional "set to 4:3 scaled" display option for convenience.\r
+  + PSP: Added an option to disable frame limitter (works only with non-auto frameskip).\r
+\r
 1.35\r
   + PSP port added. Lots of new code for it. Integrated modified FAME/C, CZ80 cores.\r
   + Some minor generic optimizations.\r