7eed09b3 |
1 | #ifdef GP2X\r |
01bc6b19 |
2 | For help / comments / questions visit GP32X boards at:\r |
3 | http://www.gp32x.com/board/\r |
4 | \r |
7eed09b3 |
5 | #endif\r |
cc68a136 |
6 | \r |
7 | About\r |
8 | -----\r |
9 | \r |
81fda4e8 |
10 | #ifdef PSP\r |
11 | This is yet another Megadrive / Genesis emulator for PSP, but with\r |
12 | Sega CD / Mega CD support. Although it has been originally written having\r |
13 | ARM CPU based devices in mind, it has now been ported to PSP too, by\r |
14 | replacing ARM specific parts with portable C code.\r |
15 | The base code originates from Dave's (fdave, finalburn) PicoDrive 0.30 for\r |
16 | Pocket PC. The Sega/Mega CD code is roughly based on Stephane Dallongeville's\r |
17 | Gens.\r |
18 | #else\r |
01bc6b19 |
19 | This is yet another Megadrive / Genesis / Sega CD / Mega CD emulator, which\r |
20 | was written having ARM-based handheld devices in mind (such as PDAs,\r |
7eed09b3 |
21 | smartphones and handheld consoles like GP2X and Gizmondo of course).\r |
22 | The critical parts (renderer, 68K and Z80 cpu interpreters) and some other\r |
23 | random code is written in ARM asm, other code is C. The base code originates\r |
24 | from Dave's (fdave, finalburn) PicoDrive 0.30 for Pocket PC. The Sega/Mega CD\r |
25 | code is roughly based on Stephane Dallongeville's Gens.\r |
81fda4e8 |
26 | #endif\r |
cc68a136 |
27 | \r |
a39b7867 |
28 | PicoDrive is the first emulator ever to properly emulate Virtua Racing and\r |
29 | it's SVP chip.\r |
30 | \r |
cc68a136 |
31 | \r |
32 | How to make it run\r |
33 | ------------------\r |
34 | \r |
7eed09b3 |
35 | #ifdef GP2X\r |
75e77902 |
36 | Copy PicoDrive.gpe, pico940_v3.bin and mmuhack.o to any place in your filesystem\r |
cc68a136 |
37 | (all 3 files must be in the same directory) and run PicoDrive.gpe.\r |
0a051f55 |
38 | Then load a ROM and enjoy! ROMs can be in .smd or .bin format and can be zipped.\r |
cc68a136 |
39 | \r |
7eed09b3 |
40 | #endif\r |
41 | #ifdef GIZ\r |
42 | First make sure you have homebrew-enabled Service Pack installed. Then copy\r |
43 | PicoDrive.exe and KGSDK.dll to any place in your filesystem (both files must\r |
44 | be in the same directory) and run PicoDrive.exe using the launcher of your choice\r |
45 | (some of them might require renaming PicoDrive.exe to Autorun.exe, placing it in\r |
46 | the root of SD, etc). Then load a ROM and enjoy! ROMs can be placed anywhere, can\r |
47 | be in .smd or .bin format and can be zipped (one ROM per zip).\r |
48 | \r |
49 | #endif\r |
81fda4e8 |
50 | #ifdef PSP\r |
51 | If you are running a custom firmware, just copy the whole PicoDrive directory to\r |
52 | /PSP/GAME or /PSP/GAMEXXX directory in your memory stick (it shouldn't matter\r |
53 | which one GAME* directory to use).\r |
54 | \r |
c6196c0f |
55 | If you are on 1.5, there is a separate KXploited version for it.\r |
81fda4e8 |
56 | \r |
57 | #endif\r |
58 | Note that this emulator may require some tweaking of configuration settings to run\r |
59 | some games well. For Genesis/MegaDrive, if you have any problems (game does not\r |
60 | boot, sound is glitchy, broken graphics), try to:\r |
81fda4e8 |
61 | #ifdef PSP\r |
62 | * enable "accurate renderer"\r |
63 | #else\r |
64 | * enable "16bit accurate renderer"\r |
65 | #endif\r |
66 | * make sure Z80 is not disabled (in "advanced options" submenu in options).\r |
67 | Some games may need to be reset after adjusting settings.\r |
68 | \r |
8ab3e3c1 |
69 | For possible Sega/Mega CD problems, see "Other important stuff" section below.\r |
cc68a136 |
70 | \r |
71 | \r |
0a051f55 |
72 | How to run Sega/Mega CD games\r |
73 | -----------------------------\r |
74 | \r |
75 | To play any game, you need BIOS files. These files must be copied to the same\r |
0ffa8947 |
76 | directory as mentioned PicoDrive files. Files can be named as follows:\r |
7eed09b3 |
77 | \r |
0a051f55 |
78 | US: us_scd1_9210.bin us_scd2_9306.bin SegaCDBIOS9303.bin\r |
79 | EU: eu_mcd1_9210.bin eu_mcd2_9303.bin eu_mcd2_9306.bin\r |
80 | JP: jp_mcd1_9112.bin jp_mcd1_9111.bin\r |
81 | these files can also be zipped.\r |
82 | \r |
0bccafeb |
83 | The game must be dumped to ISO format, but CUE/BIN can be used too. When using\r |
84 | CUE/BIN, you must load .cue file from the menu, or else the emu will not find\r |
85 | audio tracks.\r |
86 | CUE/BIN usually takes a lot of space, so it can be converted to cue/cso/mp3 by\r |
87 | using bin_to_cso_mp3 tool, which is included with the emulator. See readme in\r |
88 | the bin_to_cso_mp3/ directory for details.\r |
89 | \r |
90 | ISO+mp3 files can be named similarly as for other emus.\r |
0a051f55 |
91 | Here are some examples:\r |
92 | \r |
93 | SonicCD.iso data track\r |
94 | SonicCD_02.mp3 audio track 1 (CD track 2)\r |
95 | SonicCD_03.mp3\r |
96 | ...\r |
97 | \r |
98 | Sonic the Hedgehog CD (US) - Track 01.iso\r |
99 | Sonic the Hedgehog CD (US) - Track 02.mp3\r |
100 | Sonic the Hedgehog CD (US) - Track 03.mp3\r |
101 | ...\r |
102 | \r |
81fda4e8 |
103 | It is very important to have the MP3s encoded at 44kHz sample rate and they\r |
104 | must be stereo, or else they will play too fast/slow or won't play at all.\r |
105 | Be sure NOT to use anything but classic mp3 format (don't use things like\r |
106 | mp3pro).\r |
107 | \r |
71de3cd9 |
108 | ISO files can also be .cso compressed or zipped (but not mp3 files, as they\r |
109 | are already compressed). CSO will cause slightly longer loading times, and\r |
75e77902 |
110 | is not very good for FMV games. Zipping ISOs is not recommended, as it will\r |
71de3cd9 |
111 | cause very long (several minute) loading times, and make some games\r |
112 | unplayable. File naming is similar as with uncompressed ISOs.\r |
0a051f55 |
113 | Example:\r |
114 | \r |
71de3cd9 |
115 | SonicCD.cso data track\r |
0a051f55 |
116 | SonicCD_02.mp3 audio track 1 (CD track 2)\r |
117 | SonicCD_03.mp3\r |
118 | ...\r |
119 | \r |
cc68a136 |
120 | \r |
0a051f55 |
121 | Other important stuff\r |
122 | ---------------------\r |
123 | \r |
1850d43f |
124 | * If your Genesis/MD game has graphical glitches, this is most likely because\r |
125 | "accurate renderer" is not enabled (see options).\r |
7eed09b3 |
126 | * Sega/Mega CD: If the game hangs after Sega logo, you may need to enable\r |
127 | "better sync" and/or "Scale/Rot. fx" options, found in "Sega/Mega CD options"\r |
128 | submenu, and then reset the game. Some other games may also require\r |
81fda4e8 |
129 | "CDDA audio" and "PCM audio" to be enabled to work (enabled by default).\r |
130 | Incorrectly named/missing mp3s may also be the cause.\r |
131 | * Sega/Mega CD: If the background music is missing, you might have named your\r |
132 | MP3s incorrectly. Read "How to run Sega/Mega CD games" section again.\r |
71de3cd9 |
133 | * Sega/Mega CD: If the game music plays too fast/too slow/out of sync, you have\r |
134 | encoded your MP3s incorrectly. You will have to re-encode and/or resample them.\r |
81fda4e8 |
135 | PicoDrive is not a mp3 player, so all mp3s MUST be encoded at 44.1kHz stereo.\r |
136 | Badly encoded mp3s can cause various kind of problems, like noises, incorrect\r |
137 | playback speeds, not repeating music or even prevent game from starting.\r |
71de3cd9 |
138 | Some games (like Snatcher) may hang in certain scenes because of this.\r |
139 | Some mp3 rippers/encoders remove silence and beginning/end of audio tracks,\r |
140 | what causes audio desyncs and/or mentioned problems.\r |
1850d43f |
141 | If you have cue/bin rip, you can use the bin_to_cso_mp3 tool (included with\r |
142 | the emulator) to make a proper iso/mp3 rip.\r |
81fda4e8 |
143 | * Sega/Mega CD: If your games hangs at the BIOS screen (with planets shown),\r |
144 | you may be using a bad BIOS dump. Try another from a different source.\r |
145 | * Some Sega/Mega CD games don't use Z80 for anything, but they leave it active,\r |
146 | so disabling Z80 manually (in advanced options) improves performance.\r |
7eed09b3 |
147 | #ifdef GP2X\r |
0a051f55 |
148 | * When you use both GP2X CPUs, keep in mind that you can't overclock as high as\r |
149 | when using ARM920 only. For example my GP2X when run singlecore can reach\r |
150 | 280MHz, but with both cores it's about 250MHz. When overclocked too much,\r |
6cadc2da |
151 | it may start hanging and producing random noise, or causing ARM940 crashes\r |
152 | ("940 crashed" message displayed).\r |
7eed09b3 |
153 | #endif\r |
6cadc2da |
154 | * Use lower bitrate for better performance (96 or 128kbps CBRs recommended).\r |
7eed09b3 |
155 | #ifdef GP2X\r |
e362c573 |
156 | * Due to internal implementation mp3s must not be larger that 12MB\r |
157 | (12582912 bytes). Larger mp3s will not be fully loaded.\r |
0a051f55 |
158 | * RAM timings option is good for dualcore operation (it is disabled by\r |
159 | default because it doesn't work on every GP2X, so enable it in advanced\r |
160 | options).\r |
7eed09b3 |
161 | #endif\r |
162 | \r |
163 | \r |
164 | Configuration\r |
165 | -------------\r |
166 | \r |
167 | @@0. "Renderer"\r |
168 | #ifdef GP2X\r |
169 | 8bit fast:\r |
170 | This enables alternative heavily optimized tile-based renderer, which renders\r |
171 | pixels not line-by-line (this is what accurate renderers do), but in 8x8 tiles,\r |
172 | which is much faster. But because of the way it works it can't render any\r |
173 | mid-frame image changes (raster effects), so it is useful only with some games.\r |
174 | \r |
175 | Other two are accurate line-based renderers. The 8bit is faster but does not\r |
176 | run well with some games like Street Racer.\r |
aefb65bc |
177 | \r |
7eed09b3 |
178 | #endif\r |
179 | #ifdef GIZ\r |
180 | This option allows to switch between 16bit and 8bit renderers. The 8bit one is\r |
181 | a bit faster for some games, but not much, because colors still need to be\r |
182 | converted to 16bit, as this is what Gizmondo requires. It also introduces\r |
183 | graphics problems for some games, so it's best to use 16bit one.\r |
aefb65bc |
184 | \r |
7eed09b3 |
185 | #endif\r |
81fda4e8 |
186 | #ifdef PSP\r |
187 | This option allows to switch between fast and accurate renderers. The fast one\r |
188 | is much faster, because it draws the whole frame at a time, instead of doing it\r |
189 | line by line, like the accurate one does. But because of the way it works it\r |
190 | can't render any mid-frame image changes (raster effects), so it is useful only\r |
191 | for some games.\r |
7eed09b3 |
192 | \r |
aefb65bc |
193 | #endif\r |
7eed09b3 |
194 | #ifdef GIZ\r |
c77ca79e |
195 | @@0. "Scanline mode"\r |
7eed09b3 |
196 | This option was designed to work around slow framebuffer access (the Gizmondo's\r |
81fda4e8 |
197 | main bottleneck) by drawing every other line (even numbered lines only).\r |
c77ca79e |
198 | This improves performance greatly, but looses detail.\r |
7eed09b3 |
199 | \r |
200 | #endif\r |
201 | #ifdef GP2X\r |
202 | @@0. "Scaling"\r |
203 | "hw" means GP2X hardware scaler, which causes no performance loss, but scaled\r |
204 | image looks a bit blocky. "sw" means software scaling, which uses pixel\r |
205 | averaging and may look a bit nicer, but blurry. Horizontal scaling is only for\r |
206 | games which use so called "32 column mode" (256x224 or 256x240), and scales\r |
207 | image width to 320 pixels. Vertical scales height to 240 for games which use\r |
208 | height 224 (most of them).\r |
aefb65bc |
209 | \r |
7eed09b3 |
210 | #endif\r |
211 | #ifdef GIZ\r |
212 | @@0. "Scale low res mode"\r |
213 | The Genesis/Megadrive had several graphics modes, some of which were only 256\r |
214 | pixels wide. This option scales their width to 320 by using simple\r |
215 | pixel averaging scaling. Works only when 16bit renderer is enabled.\r |
7eed09b3 |
216 | \r |
aefb65bc |
217 | #endif\r |
7eed09b3 |
218 | @@0. "Show FPS"\r |
219 | Self-explanatory. Format is XX/YY, where XX is the number of rendered frames and\r |
220 | YY is the number of emulated frames per second.\r |
221 | \r |
222 | @@0. "Frameskip"\r |
223 | How many frames to skip rendering before displaying another.\r |
224 | "Auto" is recommended.\r |
225 | \r |
226 | @@0. "Enable sound"\r |
227 | Does what it says. You must enable at least YM2612 or SN76496 (in advanced options,\r |
228 | see below) for this to make sense (already done by default).\r |
229 | \r |
230 | @@0. "Sound Quality"\r |
81fda4e8 |
231 | #ifdef PSP\r |
232 | Sound sample rate, affects sound quality and emulation performance.\r |
233 | 22050Hz setting is the recommended one.\r |
234 | #else\r |
235 | Sound sample rate and stereo mode. Mono is not available in Sega/Mega CD mode.\r |
236 | #endif\r |
7eed09b3 |
237 | #ifdef GP2X\r |
238 | If you want 44100Hz sound, it is recommended to enable the second core (next option).\r |
239 | \r |
240 | @@0. "Use ARM940 core for sound"\r |
241 | This option causes PicoDrive to use ARM940T core (GP2X's second CPU) for sound \r |
242 | (i.e. to generate YM2612 samples) to improve performance noticeably.\r |
243 | #endif\r |
244 | \r |
245 | @@0. "6 button pad"\r |
246 | If you enable this, games will think that 6 button gamepad is connected. If you\r |
247 | go and reconfigure your keys, you will be able to bind X,Y,Z and mode actions.\r |
248 | \r |
249 | @@0. "Region"\r |
250 | This option lets you force the game to think it is running on machine from the\r |
251 | specified region, or just to set autodetection order. Also affects Sega/Mega CD.\r |
252 | \r |
253 | @@0. "Use SRAM/BRAM savestates"\r |
254 | This will automatically read/write SRAM (or BRAM for Sega/Mega CD) savestates for\r |
81fda4e8 |
255 | games which are using them. SRAM is saved whenever you enter the menu or exit the\r |
7eed09b3 |
256 | emulator.\r |
257 | \r |
258 | @@0. "Confirm savestate"\r |
259 | Allows to enable confirmation on savestate saving (to prevent savestate overwrites),\r |
260 | on loading (to prevent destroying current game progress), and on both or none, when\r |
261 | using shortcut buttons (not menu) for saving/loading.\r |
262 | \r |
263 | @@0. "Save slot"\r |
264 | This is a slot number to use for savestates. This can also be configured to be\r |
265 | changed with a button (see "key configuration").\r |
266 | \r |
267 | #ifdef GP2X\r |
268 | @@0. "GP2X CPU clocks"\r |
269 | Here you can change clocks of both GP2X's CPUs. Larger values increase performance.\r |
270 | There is no separate option for the second CPU because both CPUs use the same clock\r |
271 | source. Setting this option to 200 will cause PicoDrive NOT to change GP2X's clocks\r |
272 | at all (this is if you use external program to set clock).\r |
273 | \r |
81fda4e8 |
274 | #endif\r |
275 | #ifdef PSP\r |
276 | @@0. "CPU/bus clock"\r |
277 | This allows to change CPU and bus clocks for PSP. 333MHz is recommended.\r |
278 | \r |
279 | @@0. "[Display options]"\r |
280 | Enters Display options menu (see below).\r |
281 | \r |
7eed09b3 |
282 | #endif\r |
283 | @@0. "[Sega/Mega CD options]"\r |
284 | Enters Sega/Mega CD options menu (see below).\r |
285 | \r |
286 | @@0. "[advanced options]"\r |
287 | Enters advanced options menu (see below).\r |
288 | \r |
289 | @@0. "Save cfg as default"\r |
290 | If you save your config here it will be loaded on next ROM load, but only if there\r |
291 | is no game specific config saved (which will be loaded in that case).\r |
292 | You can press left/right to switch to a different config profile.\r |
293 | \r |
294 | @@0. "Save cfg for current game only"\r |
295 | Whenever you load current ROM again these settings will be loaded\r |
296 | #ifdef GP2X\r |
297 | (squidgehack and RAM settings will not take effect until emulator is restarted).\r |
298 | #endif\r |
299 | \r |
300 | \r |
301 | Advanced configuration\r |
302 | ----------------------\r |
303 | \r |
304 | Enter [advanced options] in config menu to see these options.\r |
305 | \r |
306 | #ifdef GP2X\r |
307 | @@1. "Gamma correction"\r |
308 | Alters image gamma through GP2X hardware. Larger values make image to look brighter,\r |
309 | lower - darker (default is 1.0).\r |
310 | \r |
311 | @@1. "A_SN's gamma curve"\r |
312 | If this is enabled, different gamma adjustment method will be used (suggested by A_SN\r |
313 | from gp32x boards). Basically it makes difference for dark and bright colors.\r |
314 | \r |
315 | @@1. "Perfect vsync"\r |
316 | This one adjusts the LCD refresh rate to better match game's refresh rate and starts\r |
317 | synchronizing rendering with it. Should make scrolling smoother and eliminate tearing.\r |
318 | \r |
319 | #endif\r |
651b1a25 |
320 | @@1. "Disable sprite limit"\r |
321 | The MegaDrive/Genesis had a limit on how many sprites (usually smaller moving\r |
322 | objects) can be displayed on single line. This option allows to disable that\r |
323 | limit. Note that some games used this to hide unwanted things, so it is not\r |
324 | always good to enable this option.\r |
325 | \r |
7eed09b3 |
326 | @@1. "Emulate Z80"\r |
327 | Enables emulation of Z80 chip, which was mostly used to drive the other sound chips.\r |
328 | Some games do complex sync with it, so you must enable it even if you don't use\r |
329 | sound to be able to play them.\r |
330 | \r |
331 | @@1. "Emulate YM2612 (FM)"\r |
332 | This enables emulation of six-channel FM sound synthesizer chip, which was used to\r |
333 | produce sound effects and music.\r |
334 | \r |
335 | @@1. "Emulate SN76496 (PSG)"\r |
336 | This enables emulation of additional sound chip for additional effects.\r |
337 | \r |
338 | Note: if you change sound settings AFTER loading a ROM, you may need to reset\r |
339 | game to get sound. This is because most games initialize sound chips on\r |
340 | startup, and this data is lost when sound chips are being enabled/disabled.\r |
341 | \r |
342 | #ifdef GIZ\r |
c77ca79e |
343 | @@1. "Double buffering"\r |
344 | Draws the display to offscreen buffer, and flips it with visible one when done.\r |
345 | Unfortunately this causes serious tearing, unless v-sync is used (next option).\r |
346 | \r |
7eed09b3 |
347 | @@1. "Wait for V-sync"\r |
c77ca79e |
348 | Waits for vertical sync before drawing (or flipping buffers, if previous option\r |
349 | is enabled). Emulation is stopped while waiting, so this causes large performance\r |
350 | hit.\r |
7eed09b3 |
351 | \r |
352 | #endif\r |
353 | @@1. "gzip savestates"\r |
354 | This will always apply gzip compression on your savestates, allowing you to\r |
355 | save some space and load/save time.\r |
356 | \r |
357 | @@1. "Don't save last used ROM"\r |
358 | This will disable writing last used ROM to config on exit (what might cause SD\r |
359 | card corruption according to DaveC).\r |
360 | \r |
361 | #ifdef GP2X\r |
362 | @@1. "craigix's RAM timings"\r |
363 | This overclocks the GP2X RAM chips, but may cause instability. Recommended if you\r |
364 | use the second core for sound. Needs emulator restart to take effect.\r |
365 | See this thread:\r |
366 | http://www.gp32x.com/board/index.php?showtopic=32319\r |
367 | \r |
368 | @@1. "squidgehack"\r |
369 | Well known way to improve the GP2X performance. You must restart the emulator\r |
370 | for the change of this option to take effect.\r |
371 | \r |
372 | #endif\r |
373 | \r |
374 | Sega/Mega CD options \r |
375 | --------------------\r |
376 | \r |
377 | @@2,@@2,@@2. "USA/EUR/JAP BIOS"\r |
378 | These options just show if your BIOS files were correctly detected by the\r |
379 | emulator (it shows the filename it is using). If so, you can press Start to\r |
380 | test your BIOS.\r |
381 | \r |
382 | @@2. "CD LEDs"\r |
383 | The Sega/Mega CD unit had two blinking LEDs (red and green) on it. This option\r |
384 | will display them on top-left corner of the screen.\r |
385 | \r |
386 | @@2. "CDDA audio (using mp3s)"\r |
387 | This option enables CD audio playback.\r |
388 | \r |
389 | @@2. "PCM audio"\r |
390 | This enables 8 channel PCM sound source. It is required for some games to run,\r |
391 | because they monitor state of this audio chip.\r |
392 | \r |
393 | @@2. "ReadAhead buffer"\r |
2d2247c2 |
394 | This option can prefetch more data from the CD image then requested by game\r |
395 | (to avoid accessing card later), what can improve performance in some cases.\r |
396 | #ifndef PSP\r |
397 | "OFF" is the recommended setting.\r |
7eed09b3 |
398 | #endif\r |
399 | \r |
400 | @@2. "Save RAM cart"\r |
401 | Here you can enable 64K RAM cart. Format it in BIOS if you do.\r |
402 | \r |
403 | @@2. "Scale/Rot. fx"\r |
404 | The Sega/Mega CD had scaling/rotation chip, which allows effects similar to\r |
405 | "Mode 7" effects in SNES. Unfortunately emulating it is slow, and very few games\r |
406 | used it, so it's better to disable this option, unless game really needs it.\r |
407 | \r |
408 | @@2. "Better sync"\r |
409 | This option is similar to "Perfect synchro" in Gens. Some games require it to run,\r |
410 | for example most (all?) Wolfteam games, and some other ones. Don't use it for\r |
411 | games which don't need it, it will just slow them down.\r |
412 | \r |
413 | \r |
81fda4e8 |
414 | #ifdef PSP\r |
415 | Display options\r |
416 | ---------------\r |
417 | \r |
418 | @@3. "Scale factor"\r |
419 | This allows to resize the displayed image by using the PSP's hardware. The number is\r |
420 | used to multiply width and height of the game image to get the size of image to be\r |
421 | displayed. If you just want to make it fullscreen, just use "Set to fullscreen"\r |
422 | setting below.\r |
423 | \r |
424 | @@3. "Hor. scale (for low res. games)"\r |
425 | This one works similarly as the previous setting, but can be used to apply additional\r |
426 | scaling horizontally, and is used for games which use lower (256 pixel wide) Gen/MD\r |
427 | resolution.\r |
428 | \r |
429 | @@3. "Hor. scale (for hi res. games)"\r |
430 | Same as above, only for higher (320 pixel wide) resolution using games.\r |
431 | \r |
432 | @@3. "Bilinear filtering"\r |
433 | If this is enabled, PSP hardware will apply bilinear filtering on the resulting image,\r |
434 | making it smoother, but blurry.\r |
435 | \r |
651b1a25 |
436 | @@3. "Gamma adjustment"\r |
437 | Color gamma can be adjusted with this.\r |
438 | \r |
439 | @@3. "Black level"\r |
440 | This can be used to reduce unwanted "ghosting" effect for dark games, by making\r |
441 | black pixels brighter. Use in conjunction with "gamma adjustment" for more effect.\r |
442 | \r |
81fda4e8 |
443 | @@3. "Wait for vsync"\r |
444 | Wait for the screen to finish updating before switching to next frame, to avoid tearing.\r |
445 | There are 3 options:\r |
446 | * never: don't wait for vsync.\r |
447 | * sometimes: wait only if emulator is running fast enough.\r |
448 | * always: always wait (causes emulation slowdown).\r |
449 | \r |
450 | @@3. "Set to unscaled centered"\r |
451 | Adjust the resizing options to set game image to it's original size.\r |
452 | \r |
453 | @@3. "Set to fullscreen"\r |
454 | Adjust the resizing options to make the game image fullscreen.\r |
455 | \r |
456 | \r |
457 | #endif\r |
7eed09b3 |
458 | Key configuration\r |
459 | -----------------\r |
460 | \r |
461 | Select "Configure controls" from the main menu. Then select "Player 1" and you will\r |
462 | see two columns. The left column lists names of Genesis/MD controller buttons, and\r |
0ffa8947 |
463 | #ifdef GP2X\r |
7eed09b3 |
464 | the right GP2X ones, which are assigned to them. If you bind 2 different GP2X buttons\r |
0ffa8947 |
465 | #endif\r |
466 | #ifdef GIZ\r |
467 | the right Giz ones, which are assigned to them. If you bind 2 different Giz buttons\r |
468 | #endif\r |
81fda4e8 |
469 | #ifdef PSP\r |
470 | the right PSP ones, which are assigned to them. If you bind 2 different PSP buttons\r |
471 | #endif\r |
7eed09b3 |
472 | to the same action, you will get a combo (which means that you will have to press\r |
473 | both buttons for that action to happen.\r |
0a051f55 |
474 | \r |
475 | \r |
476 | Cheat support\r |
477 | -------------\r |
478 | \r |
479 | To use GG/patch codes, you must type them into your favorite text editor, one\r |
480 | per line. Comments may follow code after a whitespace. Only GameGenie and\r |
481 | Genecyst patch formats are supported.\r |
482 | Examples:\r |
483 | \r |
484 | Genecyst patch (this example is for Sonic):\r |
485 | \r |
486 | 00334A:0005 Start with five lives\r |
487 | 012D24:0001 Keep invincibility until end of stage\r |
488 | 009C76:5478 each ring worth 2\r |
489 | 009C76:5678 each ring worth 3\r |
490 | ...\r |
491 | \r |
492 | Game Genie patch (for Sonic 2):\r |
493 | \r |
494 | ACLA-ATD4 Hidden palace instead of death egg in level select\r |
495 | ...\r |
496 | \r |
497 | Both GG and patch codes can be mixed in one file.\r |
498 | \r |
499 | When the file is ready, name it just like your ROM file, but with additional\r |
500 | .pat extension, making sure that case matches.\r |
501 | \r |
502 | Examples:\r |
503 | \r |
504 | ROM: Sonic.zip\r |
505 | PATCH FILE: Sonic.zip.pat\r |
506 | \r |
507 | ROM: Sonic 2.bin\r |
508 | PATCH FILE: Sonic 2.bin.pat\r |
509 | \r |
510 | Put the file into your ROMs directory. Then load the .pat file as you would\r |
511 | a ROM. Then Cheat Menu Option should appear in main menu.\r |
512 | \r |
513 | \r |
514 | What is emulated?\r |
515 | -----------------\r |
516 | \r |
517 | Genesis/MegaDrive:\r |
81fda4e8 |
518 | #ifdef PSP\r |
519 | main 68k @ 7.6MHz: yes, FAME/C core\r |
520 | z80 @ 3.6MHz: yes, CZ80 core\r |
521 | #else\r |
0a051f55 |
522 | main 68k @ 7.6MHz: yes, Cyclone core\r |
523 | z80 @ 3.6MHz: yes, DrZ80 core\r |
81fda4e8 |
524 | #endif\r |
0a051f55 |
525 | VDP: yes, except some quirks not used by games\r |
526 | YM2612 FM: yes, optimized MAME core\r |
527 | SN76489 PSG: yes, MAME core\r |
a39b7867 |
528 | SVP chip: yes! This is first emu to ever do this.\r |
529 | Some in-cart mappers are supported too.\r |
0a051f55 |
530 | \r |
531 | Sega/Mega CD:\r |
81fda4e8 |
532 | #ifdef PSP\r |
533 | another 68k @ 12.5MHz: yes, FAME/C too\r |
534 | #else\r |
0a051f55 |
535 | another 68k @ 12.5MHz: yes, Cyclone too\r |
81fda4e8 |
536 | #endif\r |
6cadc2da |
537 | gfx scaling/rotation chip (custom ASIC): yes\r |
0a051f55 |
538 | PCM sound source: yes\r |
539 | CD-ROM controller: yes (mostly)\r |
540 | bram (internal backup RAM): yes\r |
541 | \r |
542 | \r |
cc68a136 |
543 | Problems / limitations\r |
544 | ----------------------\r |
545 | \r |
bdec53c9 |
546 | * 32x is not emulated.\r |
547 | #ifdef PSP\r |
a39b7867 |
548 | * SVP emulation is terribly slow.\r |
bdec53c9 |
549 | #endif\r |
cc68a136 |
550 | * Various VDP quirks (window bug, scroll size 2, etc.) are not emulated,\r |
0a051f55 |
551 | as very few games use this (if any at all).\r |
bdec53c9 |
552 | * The emulator is not 100% accurate, so some things may not work as expected.\r |
cc68a136 |
553 | \r |
554 | \r |
555 | Credits\r |
556 | -------\r |
557 | \r |
110df09c |
558 | This emulator is made of the code from following people/projects:\r |
cc68a136 |
559 | \r |
7eed09b3 |
560 | notaz\r |
81fda4e8 |
561 | GP2X, UIQ, PSP, Gizmondo ports, CPU core hacks,\r |
7eed09b3 |
562 | lots of additional coding (see changelog).\r |
563 | Homepage: http://notaz.gp2x.de/\r |
564 | \r |
cc68a136 |
565 | Dave\r |
566 | Cyclone 68000 core, Pico emulation library\r |
567 | Homepage: http://www.finalburn.com/\r |
568 | \r |
81fda4e8 |
569 | #ifdef PSP\r |
570 | Chui\r |
571 | FAME/C 68k interpreter core\r |
572 | (based on C68K by Stephane Dallongeville)\r |
573 | \r |
574 | Stephane Dallongeville (written), NJ (optimized)\r |
575 | CZ80 Z80 interpreter core\r |
576 | \r |
577 | #else\r |
cc68a136 |
578 | Reesy & FluBBa\r |
81fda4e8 |
579 | DrZ80, the Z80 interpreter written in ARM assembly.\r |
cc68a136 |
580 | Homepage: http://reesy.gp32x.de/\r |
581 | \r |
81fda4e8 |
582 | #endif\r |
583 | Tatsuyuki Satoh, Jarek Burczynski, MAME development\r |
cc68a136 |
584 | software implementation of Yamaha FM sound generator\r |
585 | \r |
81fda4e8 |
586 | MAME development\r |
587 | Texas Instruments SN76489 / SN76496 programmable tone/noise generator\r |
cc68a136 |
588 | Homepage: http://www.mame.net/\r |
589 | \r |
0a051f55 |
590 | Stephane Dallongeville\r |
591 | Gens, MD/Mega CD/32X emulator. Most Sega CD code is based on this emu.\r |
81fda4e8 |
592 | #ifdef PSP\r |
593 | \r |
594 | people @ ps2dev.org forums / PSPSDK crew\r |
595 | libaudiocodec code (by cooleyes)\r |
596 | other sample code\r |
597 | #else\r |
0a051f55 |
598 | \r |
599 | Helix community\r |
600 | Helix mp3 decoder\r |
81fda4e8 |
601 | #endif\r |
0a051f55 |
602 | \r |
cc68a136 |
603 | \r |
604 | Additional thanks\r |
605 | -----------------\r |
606 | \r |
607 | * Charles MacDonald (http://cgfm2.emuviews.com/) for old but still very useful\r |
608 | info about genesis hardware.\r |
cc68a136 |
609 | * Steve Snake for all that he has done for Genesis emulation scene.\r |
bdec53c9 |
610 | * Tasco Deluxe for his reverse engineering work on SVP and some mappers.\r |
cc68a136 |
611 | * Bart Trzynadlowski for his SSFII and 68000 docs.\r |
612 | * Haze for his research (http://haze.mameworld.info).\r |
053fd9b4 |
613 | * Lordus, Exophase and Rokas for various ideas.\r |
614 | * Nemesis for his YM2612 research.\r |
cc68a136 |
615 | * Mark and Jean-loup for zlib library.\r |
7eed09b3 |
616 | * ketchupgun for the skin.\r |
617 | #ifdef GP2X\r |
cc68a136 |
618 | * rlyeh and all the other people behind the minimal library.\r |
619 | * Squidge for his famous squidgehack(tm).\r |
620 | * Dzz for his ARM940 sample code.\r |
621 | * GnoStiC & Puck2099 for USB joystick support.\r |
622 | * Hermes PS2R, god_at_hell for the CpuCtrl library.\r |
a4f0cc86 |
623 | * A_SN for his gamma code.\r |
cc68a136 |
624 | * craigix for supplying the GP2X hardware and making this port possible.\r |
6cadc2da |
625 | * Alex for the icon.\r |
a4f0cc86 |
626 | * All the people from gp32x boards for their support.\r |
7eed09b3 |
627 | #endif\r |
628 | #ifdef GIZ\r |
629 | * Kingcdr's for the SDK and Reesy for the DLL and sound code.\r |
630 | * jens.l for supplying the Gizmondo hardware and making this port possible.\r |
631 | #endif\r |
632 | #ifdef UIQ\r |
cc68a136 |
633 | * Peter van Sebille for his various open-source Symbian projects to learn from.\r |
634 | * Steve Fischer for his open-source Motorola projects.\r |
635 | * The development team behind "Symbian GCC Improvement Project"\r |
636 | (http://www.inf.u-szeged.hu/symbian-gcc/) for their updated pre-SymbianOS9\r |
637 | compile tools.\r |
638 | * AnotherGuest for all his Symbian stuff and support.\r |
639 | * Inder for the icons.\r |
7eed09b3 |
640 | #endif\r |
641 | * Anyone else I forgot. You know who you are.\r |
cc68a136 |
642 | \r |
643 | \r |
644 | Changelog\r |
645 | ---------\r |
1850d43f |
646 | 1.50\r |
647 | + Added some basic support for Sega Pico, a MegaDrive-based toy.\r |
0bccafeb |
648 | + Added proper support for cue/bin images, including cdda playback.\r |
1850d43f |
649 | .cue sheets with iso/cso/mp3/wav files listed in them are now\r |
650 | supported too (but 44kHz restriction still applies).\r |
651 | + Added bin_to_cso_mp3 tool, based on Exophase's bin_to_iso_ogg.\r |
652 | The tool can convert .cue/.bin Sega CD images to .cso/.mp3.\r |
75e77902 |
653 | * Greatly improved Sega CD load times.\r |
1850d43f |
654 | * Changed how scheduling between 68k and z80 is handled. Improves\r |
655 | performance for some games. Credits to Lordus for the idea.\r |
656 | * YM2612 state was not 100% saved, this should be better now.\r |
657 | * Improved renderer performance for shadow/hilight mode.\r |
658 | * Added a hack for YM2612 frequency overflow issue (bleep noises\r |
659 | in Shaq Fu, Spider-Man - The Animated Series (intro music), etc.)\r |
052c0f86 |
660 | Credits to Nemesis @ spritesmind forum. Works only if sound rate\r |
1850d43f |
661 | is set to 44kHz.\r |
662 | + Implemented some sprite rendering improvements, as suggested by\r |
663 | Exophase. Games with lots of sprites now perform better.\r |
664 | + Added better idle loop detection, based on Lordus' idea again.\r |
75e77902 |
665 | - "accurate timing" option removed, as disabling it no longer\r |
1850d43f |
666 | improves performance.\r |
75e77902 |
667 | - "accurate sprites" was removed too, the new sprite code can\r |
1850d43f |
668 | properly handle sprite priorities in all cases.\r |
669 | * Timers adjusted again.\r |
670 | * Improved .smd detection code.\r |
671 | * ARM: fixed a bug in DrZ80 core, which could cause problems in\r |
672 | some rare cases.\r |
673 | * ARM: fixed a problem of occasional clicks on MP3 music start.\r |
674 | * Minor general optimizations and menu improvements.\r |
675 | * Fixed a bug in Sega CD savestate loader, where the game would\r |
676 | sometimes crash after load.\r |
0bccafeb |
677 | * Fixed a crash of games using eeprom (introduced in 1.40b).\r |
052c0f86 |
678 | * PSP: fixed suspend/resume (hopefully for real).\r |
0bccafeb |
679 | \r |
e91e5120 |
680 | 1.40c\r |
681 | * Fixed a problem with sound in Marble Madness.\r |
682 | * GP2X: Fixed minor problem with key config.\r |
683 | \r |
6fc57144 |
684 | 1.40b\r |
685 | * Fixed sprite masking code. Thanks to Lordus for explaining how it works.\r |
686 | + Added "disable sprite limit" option.\r |
687 | + PSP: added black level adjustment to display options.\r |
688 | * Changed reset to act as 'soft' reset.\r |
689 | + Added detection for Puggsy (it doesn't really have sram).\r |
690 | * Some small timing adjustments.\r |
691 | \r |
a39b7867 |
692 | 1.40a\r |
6fc57144 |
693 | * GP2X: Fixed a binding problem with up and down keys.\r |
a39b7867 |
694 | * Default game config no longer overrides global user config.\r |
695 | \r |
bdec53c9 |
696 | 1.40\r |
697 | + Added support for SVP (Sega Virtua Processor) to emulate Virtua Racing,\r |
2d2247c2 |
698 | wrote ARM recompiler and some HLE code for VR. Credits to Exophase and\r |
699 | Rokas for various ideas.\r |
bdec53c9 |
700 | * Changed config file format, files are now human-readable. Game specific\r |
701 | configs are now held in single file (but old game config files are still\r |
2d2247c2 |
702 | read when new one is missing).\r |
d6114368 |
703 | * Fixed a bug where some key combos didn't work as expected.\r |
6fc57144 |
704 | * Fixed a regression in renderer (ARM ports only, some graphic glitches in\r |
705 | rare cases).\r |
2d2247c2 |
706 | * Adjusted fast renderer to work with more games, including VR.\r |
d6114368 |
707 | * Fixed a problem where SegaCD RAM cart data was getting lost on reset.\r |
6fc57144 |
708 | * GP2X: Greatly reduced SegaCD FMV game slowdowns by disabling read-ahead\r |
709 | in the Linux kernel and C library (thanks to Rokas and Exophase for ideas\r |
710 | again). Be sure to keep "ReadAhead buffer" OFF to avoid slowdowns.\r |
2d2247c2 |
711 | + PicoDrive now comes with a game config file for some games which need\r |
712 | special settings, so they should now work out-of-the-box. More games will\r |
713 | be added with later updates.\r |
6fc57144 |
714 | + GP2X: Files now can be deleted by pressing A+SELECT in the file browser.\r |
bdec53c9 |
715 | \r |
2445b7cb |
716 | 1.35b\r |
717 | * PSP: mp3 code should no longer fail on 1.5 firmware.\r |
718 | + PSP: added gamma adjustment option.\r |
7d0143a2 |
719 | + Added .cso ISO format support. Useful for non-FMV games.\r |
720 | * It is now possile to force a region after the ROM is loaded.\r |
2445b7cb |
721 | * Fixed a sram bug in memhandlers (fixes Shining in the Darkness saves).\r |
722 | * PSP: fixed another bug in memhanlers, which crashed the emu for some games\r |
7d0143a2 |
723 | (like NBA Jam and NHL 9x).\r |
4a32f01f |
724 | + PSP: added suspend/resume handling for Sega CD games.\r |
725 | + GP2X: added additional low volume levels for my late-night gaming sessions\r |
726 | (in stereo mode only).\r |
727 | + GP2X: added "fast forward" action in key config. Not recommended to use for\r |
728 | Sega CD, may case problems there.\r |
7d0143a2 |
729 | * Some other small tweaks I forgot about.\r |
2445b7cb |
730 | \r |
c6196c0f |
731 | 1.35a\r |
732 | * PSP: fixed a bug which prevented to load any ROMs after testing the BIOS.\r |
733 | * PSP: fixed incorrect CZ80 memory map setup, which caused Z80 crashes and\r |
734 | graphics corruption in EU Mega CD model1 BIOS menus.\r |
735 | + PSP: added additional "set to 4:3 scaled" display option for convenience.\r |
4a32f01f |
736 | + PSP: Added an option to disable frame limitter (works only with non-auto frameskip).\r |
c6196c0f |
737 | \r |
81fda4e8 |
738 | 1.35\r |
739 | + PSP port added. Lots of new code for it. Integrated modified FAME/C, CZ80 cores.\r |
740 | + Some minor generic optimizations.\r |
741 | * Patched some code which was crashing under PSP, but was working in GP2X/Giz\r |
742 | (although it should have crashed there too).\r |
743 | * Readme updated.\r |
744 | \r |
1dceadae |
745 | 1.34\r |
7eed09b3 |
746 | + Gizmondo port added.\r |
e849512f |
747 | + Some new optimizations in memory handlers, and for shadow/hilight mode.\r |
748 | + Added some hacks to make more games work without enabling "accurate timing".\r |
e849512f |
749 | * Adjusted timing for "accurate timing" mode and added preliminary VDP FIFO\r |
750 | emulation. Fixes Double Dragon 2, tearing in Chaos Engine and some other games.\r |
5f8c85be |
751 | * Fixed a few games not having sound at startup.\r |
1dceadae |
752 | * Updated serial EEPROM code to support more games. Thanks to EkeEke for\r |
753 | providing info about additional EEPROM types and game mappers.\r |
754 | * The above change fixed hang of NBA Jam.\r |
45499284 |
755 | * Minor adjustments to control configurator.\r |
e849512f |
756 | \r |
4e8a534c |
757 | 1.33\r |
758 | * Updated Cyclone core to 0.0088.\r |
759 | + Added A r k's usbjoy fix.\r |
760 | + Added "perfect vsync" option, which adjusts GP2X LCD refresh rate and syncs\r |
761 | emulation to it to eliminate tearing and ensure smoothest scrolling possible.\r |
762 | + Added an option to use A_SN's camma curve for gamma correction (improves dark\r |
763 | and bright color display for mk2s).\r |
e362c573 |
764 | * Sometimes stray sounds were played after loading a savestate. Fixed.\r |
765 | * Fixed a problem where >6MB mp3s were corrupted in memory (sound glitches in\r |
766 | Snatcher).\r |
767 | * PD no longer overwrites video player code in memory, video player now can be\r |
767bf1ad |
768 | used after exiting PicoDrive.\r |
4e8a534c |
769 | * Fixed a bug which was causing Sonic 3 code to deadlock in some rare conditions\r |
770 | if "accurate timing" was not enabled.\r |
771 | * Fixed support for large hacked ROMs like "Ultimate Mortal Kombat Trilogy".\r |
772 | Upto 10MB hacked ROMs are supported now.\r |
d524c827 |
773 | + Config profiles added (press left/right when saving config).\r |
767bf1ad |
774 | * Changed key configuration behavior to the one from gpfce (should be more\r |
d524c827 |
775 | intuitive).\r |
a12e0116 |
776 | + Added some skinning capabilities to the menu system with default skin by\r |
a4f0cc86 |
777 | ketchupgun. Delete skin directory if you want old behaviour.\r |
767bf1ad |
778 | * Some other little tweaks I forgot about.\r |
e362c573 |
779 | \r |
2433f409 |
780 | 1.32\r |
781 | + Added some new scaling options.\r |
6cadc2da |
782 | + Added ability to reload CD images while game is running (needed for games\r |
721cd396 |
783 | with multiple CDs, like Night Trap).\r |
6cadc2da |
784 | + Added RAM cart emulation.\r |
2433f409 |
785 | * Fixed DMA timing emulation (caused lock-ups for some genesis games).\r |
786 | * Idle loop detection was picking up wrong code and causing glitches, fixed.\r |
787 | * The ym2612 code on 940 now can handle multiple updates per frame\r |
788 | (fixes Thunger Force III "seiren" level drums for example).\r |
789 | * Memory handlers were ignoring some writes to PSG chip, fixed (missing sounds in\r |
790 | Popful Mail, Silpheed).\r |
721cd396 |
791 | * Improved z80 timing, should fix some sound problems.\r |
792 | * Fixed a bug with sram register (fixes Phantasy Star 4).\r |
6cadc2da |
793 | * ROM loader was incorrectly identifying some ROMs as invalid. Fixed.\r |
721cd396 |
794 | * Added code for PRG ram write protection register (Dungeon Explorer).\r |
46969540 |
795 | * The memory mode register change in 1.31 was unsafe and caused some glitches in\r |
796 | AH-3 Thunderstrike. Fixed.\r |
797 | * Fixed a file descriptor leak.\r |
6cadc2da |
798 | * Updated documentation, added Gmenu2x manual.\r |
2433f409 |
799 | \r |
c008977e |
800 | 1.31\r |
801 | * Changed the way memory mode register is read (fixes Lunar 2, broken in 1.30).\r |
802 | * Fixed TAS opcode on sub-68k side (fixes Batman games).\r |
803 | * File browser now filters out mp3s, saves and some other files, which are not ROMS.\r |
804 | \r |
782f8f22 |
805 | 1.30\r |
0a051f55 |
806 | + ISO files now can be zipped. Note that this causes VERY long loading times.\r |
807 | + Added data pre-buffering support, this allows to reduce frequency of short pauses\r |
4ff2d527 |
808 | in FMV games (caused by SD access), but makes those pauses longer.\r |
0a051f55 |
809 | * Fixed PCM DMA transfers (intro FMV in Popful Mail).\r |
7336a99a |
810 | + Properly implemented "decode" data transformation (Jaguar XJ220).\r |
811 | * Integrated "better sync" code into cyclone code, what made this mode much faster.\r |
812 | * Fixed a bug related to game specific config saving.\r |
4ff2d527 |
813 | * Frameskipper was skipping sound processing, what caused some audio desyncs. Fixed.\r |
48e8482f |
814 | * Fixed reset not working for some games.\r |
a4030801 |
815 | + New assembly optimized memory handlers for CD (gives at least a few fps).\r |
782f8f22 |
816 | Also re-enabled all optimizations from 0.964 release.\r |
817 | + New idle-loop detection code for sub-68k. Speeds up at least a few games.\r |
0a051f55 |
818 | \r |
819 | 1.201\r |
820 | + Added basic cheat support (GameGenie and Genecyst patches).\r |
821 | \r |
822 | 1.20\r |
823 | * Fixed a long-standing problem in audio mixing code which caused slight distortions\r |
824 | at lower sample rates.\r |
825 | * Changed the way 920 and 940 communicates (again), should be more reliable and give\r |
826 | slight performance increase.\r |
827 | * Some optimizations in audio mixing code.\r |
828 | * Some menu changes (background added, smaller font in ROM browser, savestate loader\r |
829 | now can select slots).\r |
830 | + 1M mode DMA transfers implemented (used by FMV games like Night Trap and Sewer Shark).\r |
831 | + Games now can run code from WORD RAM in 1M mode (fixes Adventures of Willy Beamish).\r |
832 | + "Cell arrange" address mapping is now emulated (Heart of the alien).\r |
833 | + "Color numeric operation" is now emulated (text in Lunar 2, Silpheed intro graphics).\r |
834 | + "Better sync" option added (prevents some games from hanging).\r |
835 | \r |
836 | 1.14\r |
837 | + Region autodetection now can be customized.\r |
838 | * When CDDA music tracks changed, old buffer contents were incorrectly played. Fixed.\r |
839 | * BRAM is now automatically formatted (no need to enter BIOS menu and format any more).\r |
840 | * Games now can be reset, CDDA music no longer breaks after loading another ISO.\r |
841 | * Fixed a race condition between 920 and 940 which sometimes caused CDDA music not to play.\r |
842 | + Savestates implemented for Sega/Mega CD.\r |
843 | + PCM sound added.\r |
844 | * Some mixer code rewritten in asm. 22kHz and 11kHz sound rates are now supported in\r |
845 | Mega CD mode (but mp3s must still be 44kHz stereo).\r |
846 | + Timer emulation added.\r |
847 | * CDC DMA tansfers fixed. Snatcher and probably some more games now boot.\r |
848 | * 2M word RAM -> VDP transfers fixed, no more corruption in Ecco and some other games.\r |
849 | \r |
850 | 1.10\r |
851 | + GP2X: Added experimental Sega CD support.\r |
852 | + GP2X: Added partial gmv movie playback support.\r |
853 | \r |
cc68a136 |
854 | 0.964\r |
855 | * GP2X: Fixed a sound buffer underflow issue on lower sample rate modes, which was\r |
856 | happening for NTSC games and causing sound clicks.\r |
857 | * GP2X: Redone key config to better support USB joysticks (now multiple joysticks\r |
858 | should be useable and configurable).\r |
859 | + GP2X: Added save confirmation option.\r |
860 | + GP2X: Added 940 CPU crash detection.\r |
861 | + ALL: UIQ3 port added.\r |
862 | \r |
863 | 0.963\r |
864 | * GP2X: Gamma-reset-on-entering-menu bug fixed.\r |
865 | * GP2X: Recompiled PicoDrive with gcc profiling option set as described here:\r |
866 | http://www.gp32x.com/board/index.php?showtopic=28490\r |
867 | \r |
868 | 0.962\r |
869 | * GP2X: Fixed an issue with incorrect sounds in some games when dualcore operation\r |
870 | was enabled (for example punch sound in SOR).\r |
871 | * GP2X: Limited max volume to 90, because higher values often cause distortions.\r |
872 | * GP2X: Fixed a bug with lower res scaling.\r |
873 | * GP2X: Gamma is now reset on exit.\r |
874 | \r |
875 | 0.96\r |
876 | * ALL: Severely optimized MAME's YM2612 core, part of it is now rewritten in asm.\r |
877 | + GP2X: The YM2612's code now can be run in GP2X's ARM940T CPU, what causes large\r |
878 | performance increase.\r |
879 | * ALL: Accurate renderers are slightly faster now.\r |
880 | + GP2X: Using quadruple buffering instead of doublebuffer now, also updated\r |
881 | framelimitter, this should eliminate some scrolling and tearing problems.\r |
882 | * GP2X: Fixed some flickering issues of 8bit accurate renderer.\r |
883 | + GP2X: craigix's RAM timings now can be enabled in the menu (see advanced options).\r |
884 | + GP2X: Added ability to save config for specific games only.\r |
885 | + GP2X: Gamma control added (using GP2X's hardware capabilities for this).\r |
886 | * GP2X: Volume keys are now configurable.\r |
887 | + GP2X: GnoStiC added USB joystick support, I made it possible to use it for\r |
888 | player 2 control (currently untested).\r |
889 | * GP2X: squidgehack is now applied through kernel module (cleaner way).\r |
890 | \r |
891 | 0.95\r |
892 | * ALL: Fixed a bug in sprite renderer which was causing slowdowns for some games.\r |
893 | + GP2X: Added command line support\r |
894 | + GP2X: Added optional hardware scaling for lower-res games like Shining Force.\r |
895 | * ALL: Sound chips are now sampled 2 times per frame. This fixed some games which\r |
896 | had missing sounds (Vectorman 2 1st level, Thunder Force 3 water level,\r |
897 | etc.).\r |
898 | + ALL: Added another accurate 8-bit renderer which is slightly faster and made it\r |
899 | default.\r |
900 | \r |
901 | 0.945\r |
902 | + GP2X: Added frame limiter for frameskipped modes.\r |
903 | * GP2X: Increased brightness a bit (unused pixel bits now also contain data).\r |
904 | * GP2X: Suidgehack was not applied correctly (was applied before allocating some\r |
905 | high memory and had no effect).\r |
906 | \r |
907 | 0.94\r |
908 | + Added GP2X port.\r |
909 | * Improved interrupt timing, Mazin Saga and Burning Force now works.\r |
910 | * Rewritten renderer code to better suit GP2X, should be faster on other\r |
911 | ports too.\r |
912 | + Added support for banking used by 12-in-1 and 4-in-1 ROMs (thanks Haze).\r |
913 | + Added some protection device faking, used by some unlicensed games like\r |
914 | Super Bubble Bobble, King of Fighters, Elf Wor, ... (thanks to Haze again)\r |
915 | + Added primitive Virtua Racing SVP faking, so menus can be seen now.\r |
916 | \r |
917 | 0.93\r |
918 | * Fixed a problem with P900/P910 key configuration in FC mode.\r |
919 | * Improved shadow/hilight mode emulation. Still not perfect, but should be\r |
920 | enough for most games.\r |
921 | + Save state slots added.\r |
922 | + Region selector added.\r |
923 | \r |
924 | 0.92\r |
925 | VDP changes:\r |
926 | * VDP emulation is now more accurate (fixes flickering in Chase HQ II,\r |
927 | Super Hang-On and some other problems in other games).\r |
928 | * HV counter emulation is now much more accurate. Fixes the Asterix games,\r |
929 | line in Road Rash 3, etc.\r |
930 | * Minor sprite and layer scroll masking bugs fixed.\r |
931 | + Added partial interlace mode renderer (Sonic 2 vs mode)\r |
932 | * Fixed a crash in both renderers when certain size window layers were used.\r |
933 | + Added emulation of shadow/hilight operator sprites. Other shadow/hilight\r |
934 | effects are still unemulated.\r |
935 | + Sprite emulation is more accurate, sprite limit is emulated.\r |
936 | + Added "accurate sprites" option, which always draws sprites in correct\r |
937 | order and emulates sprite collision bit, but is significantly slower.\r |
938 | \r |
939 | Emulation changes:\r |
940 | * Improved interrupt handling, added deferred interrupt emulation\r |
941 | (Lemmings, etc).\r |
942 | + Added serial EEPROM SRAM support (Wonder Boy in Monster World,\r |
943 | Megaman - The Wily Wars and many EA sports games like NBA Jam).\r |
944 | + Implemented ROM banking for Super Street Fighter II - The New Challengers\r |
945 | * Updated to the latest version of DrZ80 core, integrated memory handlers\r |
946 | in it for better performance. A noticeable performance increase, but save\r |
947 | states may not work from the previous version (you can only use them with\r |
948 | sound disabled in that case).\r |
949 | + SRAM word read handler was using incorrect byte order, fixed.\r |
950 | \r |
951 | Changes in Cyclone 0.0086:\r |
952 | + Added missing CHK opcode handler (used by SeaQuest DSV).\r |
953 | + Added missing TAS opcode handler (Gargoyles,Bubba N Stix,...). As in real genesis,\r |
954 | memory write-back phase is ignored (but can be enabled in config.h if needed).\r |
955 | + Added missing NBCD and TRAPV opcode handlers.\r |
956 | + Added missing addressing mode for CMP/EOR.\r |
957 | + Added some minor optimizations.\r |
958 | - Removed 216 handlers for 2927 opcodes which were generated for invalid addressing modes.\r |
959 | + Fixed flags for ASL, NEG, NEGX, DIVU, ADDX, SUBX, ROXR.\r |
960 | + Bugs fixed in MOVEP, LINK, ADDQ, DIVS handlers.\r |
961 | * Undocumented flags for CHK, ABCD, SBCD and NBCD are now emulated the same way as in Musashi.\r |
962 | + Added Uninitialized Interrupt emulation.\r |
963 | + Altered timing for about half of opcodes to match Musashi's.\r |
964 | \r |
965 | 0.80\r |
966 | * Nearly all VDP code was rewritten in ARM asm. Gives ~10-25% performance\r |
967 | increase (depends on game).\r |
968 | * Optimized 32-column renderer not to render tiles offscreen, games which\r |
969 | use 32-column display (like Shining Force) run ~50% faster.\r |
970 | + Added new "Alternative renderer", which gives another ~30-45% performance\r |
971 | increase (in addition to mentioned above), but works only with some games,\r |
972 | because it is missing some features (it uses tile-based renderering\r |
973 | instead of default line-based and disables H-ints).\r |
974 | + Added "fit2" display mode for all FC gamers. It always uses 208x146 for\r |
975 | P800 and 208x208 for all other phones.\r |
976 | + Added volume control for Motorolas (experimental).\r |
977 | \r |
978 | VDP changes:\r |
979 | + Added support for vertical window (used by Vapor Trail, Mercs, GRIND\r |
980 | Stormer and others).\r |
981 | + Added sprite masking (hiding), adds some speed.\r |
982 | + Added preliminary H counter emulation. Comix Zone and Sonic 3D Blast\r |
983 | special stage are now playable.\r |
984 | + Added column based vertical scrolling (Gunstar Heroes battleship level,\r |
985 | Sonic and Knuckles lava boss, etc).\r |
986 | \r |
987 | Emulation changes:\r |
988 | + Re-added and improved Z80 faking when Z80 is disabled. Many games now can\r |
989 | be played without enabling Z80 (Lost Vikings, Syndicate, etc), but some\r |
990 | still need it (International Superstar Soccer Deluxe).\r |
991 | * Improved ym2612 timers, Outrun music plays at correct speed, voices in\r |
992 | Earthworm Jim play better, more games play sound.\r |
993 | * I/O registers now remember their values (needed for Pirates! Gold)\r |
994 | + Added support for 6 button pad.\r |
995 | \r |
996 | Changes in Cyclone 0.0083wip:\r |
997 | + Added missing CHK opcode (used by SeaQuest DSV).\r |
998 | + Added missing TAS opcode (Gargoyles). As in real genesis, write-back phase\r |
999 | is ignored (but is enabled for other systems).\r |
1000 | \r |
1001 | Backported stuff from Snes9x:\r |
1002 | * Fixed Pxxx jog up/down which were not working in game.\r |
1003 | + Added an option to gzip save states to save space.\r |
1004 | + The emulator now pauses whenever it is loosing focus, so it will now pause\r |
1005 | when alarm/ponecall/battery low/... windows come up.\r |
1006 | - Removed 'pause on phonecall' feature, as it is no longer needed.\r |
1007 | + Video fix for asian A1000s.\r |
1008 | \r |
1009 | 0.70\r |
1010 | * Started using tools from "Symbian GCC Improvement Project", which give\r |
1011 | considerable speed increase (~4fps in "center 90" mode).\r |
1012 | * Rewrote some drawing routines in ARM assembly (gives ~6 more fps in\r |
1013 | "center 90" mode).\r |
1014 | * Minor improvement to 0 and 180 "fit" modes. Now they look slightly better\r |
1015 | and are faster.\r |
1016 | * Minor stability improvements (emulator is less likely to crash).\r |
1017 | + Added some background for OSD text for better readability.\r |
1018 | + Added Pal/NTSC detection. This is needed for proper sound speed.\r |
1019 | + Implemented Reesy's DrZ80 Z80 emu. Made some changes to it with hope to make\r |
1020 | it faster.\r |
1021 | + Implemented ym2612 emu from the MAME project. Runs well but sometimes sounds\r |
1022 | a bit weird. Could be a little faster, so made some changes too.\r |
1023 | + Implemented SN76489 emu from the MAME project.\r |
1024 | + Added two separate sound output methods (mediaserver and cmaudiofb) with\r |
1025 | autodetection (needs testing).\r |
1026 | * Fixed VDP DMA fill emulation (as described in Charles MacDonald's docs),\r |
1027 | fixes Contra and some other games.\r |
1028 | \r |
1029 | 0.301\r |
1030 | Launcher:\r |
1031 | * Launcher now starts emulation process from current directory,\r |
1032 | not from hardcoded paths.\r |
1033 | * Improved 'pause on call' feature, should hopefully work with Motorola phones.\r |
1034 | \r |
1035 | 0.30\r |
1036 | Initial release.\r |
1037 | \r |
1038 | \r |
1039 | Disclaimer\r |
1040 | ----------\r |
1041 | \r |
1042 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" \r |
1043 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE \r |
1044 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE \r |
1045 | ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE \r |
1046 | LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR \r |
1047 | CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF \r |
1048 | SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS \r |
1049 | INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN \r |
1050 | CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) \r |
1051 | ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE \r |
1052 | POSSIBILITY OF SUCH DAMAGE. \r |
0a051f55 |
1053 | \r |
1054 | SEGA/Genesis/MegaDrive/SEGA-CD/Mega-CD/32X are trademarks of\r |
1055 | Sega Enterprises Ltd.\r |
1056 | \r |