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