gpsp: mirror from https://github.com/libretro/gpsp
David Guillen Fandos
Get rid of enums (to u32) for better compat
6a59c71
576 次提交
提交
取消
提示:
由于 Git 不支持空文件夾，创建文件夹后会生成空的 .keep 文件
3ds
保存
取消
arm
保存
取消
bios
保存
取消
jni
保存
取消
libretro
保存
取消
psp
保存
取消
tools
保存
取消
x86
保存
取消
.gitignore
保存
取消
.gitlab-ci.yml
保存
取消
.travis.yml
保存
取消
COPYING
保存
取消
Makefile
保存
取消
Makefile.common
保存
取消
bios_data.S
保存
取消
build.txt
保存
取消
cheats.c
保存
取消
cheats.h
保存
取消
common.h
保存
取消
control
保存
取消
cpu.c
保存
取消
cpu.h
保存
取消
cpu_threaded.c
保存
取消
game_config.txt
保存
取消
gba_cc_lut.c
保存
取消
gba_cc_lut.h
保存
取消
gba_memory.c
保存
取消
gba_memory.h
保存
取消
gba_over.h
保存
取消
gpsp_config.h
保存
取消
input.c
保存
取消
input.h
保存
取消
link.T
保存
取消
main.c
保存
取消
main.h
保存
取消
memmap.h
保存
取消
memmap_win32.c
保存
取消
readme.txt
保存
取消
retro_inline.h
保存
取消
savestate.c
保存
取消
savestate.h
保存
取消
sound.c
保存
取消
sound.h
保存
取消
video.c
保存
取消
video.h
保存
取消
Loading...
README
GPL-2.0
-- gameplaySP Gameboy Advance emulator for Playstation Portable --
-- Release log --
v0.91 (minor cleanup release)
NOTE: I don't usually do minor releases but I rewrote a ton of
things in gpSP 0.9, much of it during the last few days, and although
I spent a lot of time debugging a few bugs inevitably crept in.
# Fixed some issues in the new memory handlers that crept up, hopefully
should fix the problems between 0.8 and 0.9.
# Fixed a bug introduced in 0.9 that could cause crashes when selecting
things in the menu (I hope, at least).
# Fixed a bug with a certain invalid opcode causing a jump to be scanned
when there isn't one (fixes Sabre Wulf).
# Removed 2048 option for audio buffer.
v0.9 (yes, it's still beta)
NOTE: As some of you may be aware I'm pretty much tired of these
unofficial releases by people (okay, mostly single person) who
don't wish to follow my wishes. I'm in the process of asking this
person to stop, in his own language. However, I want to make
something clear. Look at the last six new features in this
changelog. I added these TODAY. I could have done them at any
time. But I didn't, because I spent many (dozens, quite possibly
hundreds) hours debugging games that people want to play. I have
always believed that this is far more important than spending time
on new features. Frankly, I'm tired of my emulator being hacked on
by other people, and if it doesn't stop I'm going to make this
project closed source.
Since I know this information is most visible when updated on the
major sites, note that it is the news posters I am especially
talking to. Next time you upload unofficial releases of my
emulator (without even knowing what's changed) bear in mind that
you're only encouraging me to stop working on this. If you want
to pick sides between me and unofficial devs, be my guest. I'll
let you decide by the contents of this release who's doing more
for my emulator.
Oh, and if you downloaded a version of gpSP that has more than
"gpSP" in its name then you're using one of their versions. Shame
on them for not even removing this threatening message, and shame
on you. Unless you're using a port I endorse (GP2X, Dreamcast, etc),
in which case everything's good.
# Fixed stereo output being reversed.
# Fixed a bug causing misaligned errors on 8bit writes to the gbc
audio channel 3 wave data (fixes various Super Robot Wars games)
# Fixed DMA with garbage in their upper 4 bits (fixes a crash in
Zelda: Minish Cap)
# Added double buffering to the rendering, removes line artifacts.
Big thanks to Brunni for the idea.
# Fixed a bug preventing some SRAM based games from saving (fixes
MMBN4-6)
# Fixed a bug causing part of EWRAM to potentially get corrupted if
code segments loaded in EWRAM cross 32KB boundaries (fixes
Phantasy Star 2)
# Fixed a bug causing games using movs pc in user mode (very bad
behavior) to crash. Fixes Colin McRae Rally 2.0.
# Improved timing a bit more. Fixes GTA Advance.
# Fixed a sprite clipping bug (fixes crash in third boss of Zelda:
Minish cap)
# Increased translation buffer size significantly (fixes Donkey Kong:
King of Swing)
# Fixed a dynarec bug causing add pc, reg to not work in Thumb code
(fixes crash in DBZ:LoZ, seems to fix crashes in battle in Golden
Sun, probably fixes other games)
# Made sprites using tiles < 512 not display in modes 3-5 (fixes
a couple minor graphical bugs)
# Removed abort on instruction 0x00000000 hack, was breaking a
certain bugged up game (Scurge)
# Fixed bug in flags generating variable logical shifts (fixes
SD Gundam Force)
# Fixed unaligned 16bit reads (fixes DBZ:LoZ in game)
# Redid contiguous block flag modification checking AGAIN and
hopefully got it right this time (fixes Mario vs. Donkey Kong)
# Redid ldm/stm instructions, fixing some cases (along with the
timing improvements fixes Mario & Luigi)
# Fixed 14bit EEPROM addressing (hopefully fixes saving in a lot
of games)
# Completely redid memory handlers, accurately emulates open and
BIOS reads now. Fixes Zelda: Minish Cap (roll bug, last dungeon),
Rayman, MMBN 1 (last dungeon), probably others.
# Fixed a minor graphical glitch on the edges of the screen
(thanks Brunni and hlide for the help!)
# Fixed crash on loading savestates from files of games not currently
loaded, but be sure you have the exact file you loaded it from or
gpSP will exit.
@ New memory handlers should provide performance boost for games
that access VRAM significantly (ie 3D games)
@ Added dead flag elimination checking for logical shifts, probably
doesn't make a noticeable difference but should have been there
anyway.
+ Added rapidfire to the button mappings.
+ Added auto frameskip. Removed fractional frameskip (don't think
it's very useful with auto anyway). Select auto in the graphics/
sound menu to activate it; frameskip value will act as the
maximum (auto is by default on). Thanks again to Brunni for some
help with this. Frameskip options are game specific.
+ Added vsync to the rendering. Only occurs when frames aren't
skipped. Seems to reduce tearing at least some of the time.
+ Added non-filtered video option.
+ Cheat support (Gameshark/Pro Action Replay v1-v3 only), still
in early stages, doesn't support everything; codes may cause
the game to crash, haven't determined yet if the codes are bad
or the implementation is. See cheat section for more information.
+ Added ability to change audio buffer size. Does not take affect
until you restart the game.
+ Added analog config options.
+ Added ability to set analog sensitivity and turn off analog.
+ Added ability to change the clock speed. This is a game specific
option. Try lower speeds w/auto frameskip to save battery life.
+ Fixed savestate speed on crappy Sony sticks.
(legend: # bug fix, + feature addition, @ optimization)
v0.8 - ("unlocked" beta)
NOTE 1: It has come to my attention that there are actually BIOSes
out there that are being used that cause some games to not work.
The BIOS md5sum listed here is for the BIOS actually in GBAs and
is as accurate as you'll get, (if you have a GBA and a flashcart
you can dump it yourself, see http://wiki.pocketheaven.com/GBA_BIOS)
NOTE 2: Since I know this is as far as a lot of people here I have a
little request. Please, please, (I'd italicize this if I could)
please stop constantly asking me when the next release will be,
what it'll have, etc. And while you're at it, please stop asking me
to implement wi-fi multiplayer, cheat support, or fix all of your
games. Some things will happen in due time, other things might not
ever happen. I devote about as much time as I can to this emulator
and I carefully include as much as I can in releases to try to
minimize the number of people who will nag me next time (erm, I
mean, to make the most people happy), so I don't release every other
day or anything like that. Sorry that I can't release once a week,
but I'm a lot busier now than I was when I was first developing this
emulator. Good thing I got the first version out before that, wasn't
it?
Congratulations, you made it this far! Now read the rest of the this
thing. *_*
# Fixed bug in dead flag elimination, "alt" version no longer needed.
# Fixed EEPROM saves being saved as 32kb instead of 512bytes/8kb
+ 32MB ROM support has been added. ROMS are "demand loaded" as
necessary and page swapped out; there might be a small loading lag,
but I have yet to ever really notice anything.
NOTE: 32MB ROM support only works for unzipped ROMs.
+ Save states have been added. See the save state menu for save/load
options.
+ Support for the real-time clock (RTC) chip in Pokemon cartridegs
and other games. The implementation is based off of VBA's, whatever
notes on gbadev I could find, and some of my own reverse engineering
of what the games do... it might not be totally correct. Also,
setting the time does not work.
+ Per-game configuration. Currently this only saves frameskip and
frameskip variation options.
+ Removed the flash type option from the menu and instead added it
to game_config.txt. Hopefully got everything - let me know if you
find something that isn't there. It's pretty easy to add them if you
have to.
+ Added a display in the upper left-hand corner to indicate when
fast-forward is on.
+ Added button bindings for save/load state.
@ Found a fix of StrmnNrmn proportion: far too much unnecessary mutex
synchronization was going on. Removing the two offending lines of
code gave a massive speed boost for free. Enjoy.
v0.7 - (beta than ever)
# Fixed a dynarec bug involving flags generating functions in
contiguous conditional blocks. Fixes music in Super Mario
Advance 2-4.
# Fixed a dynarec bug where Thumb mov imm instructions wouldn't
set flags. Fixes Zelda: Minish Cap, Megaman Battle Network,
probably others. Comes at a slight speed cost.
# Fixed a MIPS dynarec bug where some delay slots might not
get filled rarely, causing chaos. Don't know if it improves
any games.
# Improved self-modifying code detection. Makes Golden Sun,
Golden Sun 2, and Madden 2007 sorta work but excrutiatingly
slowly. Looking for a game-specific workaround for this - if you
want to play these games you'll have to wait for now :(
# Fixed a bug causing the interrupt disable flag to go down
when SWIs are entered, causing crashes/resets. Fixes
Super Mario Advance 2-4.
# Fixed menu crashing when strings with certain characters are
printed (for instance going to the menu after loading the
BIOS)
# Accidentally forgot to render win0 + win1 + objwin when all
active at the same time, many weeks ago. Added that, should fix
some parts in games that had frozen screens.
# Fixed some issues with gpsp.cfg needing to be present and
corrupting, hopefully. At the very least sanity checks are
performed on the config file.
# Made it so assigning the frameskip button to something besides
triangle actually worked as expected.
# Fixed ability to restart current game if nothing is loaded
(ie, crash)
# Added interrupt on cpsr modification support to the dynarec
(fixes backgrounds in Castlevania: Harmony of Dissonance)
# Added open addressing for ldm/stm instructions (fixes
Super Mario Advance 3)
# Improved cycle accuracy a little. Don't know of anything this
fixes, but games with idle loops will run a little better w/o
idle loop elimination (but should still be added when possible)
# Fixed some bugs causing sound to play sometimes when it shouldn't.
@ Added dead flag elimination for Thumb code. May possibly have
noticeable performance increases (Thumb emited coded size can
have a reduction of 20% or more)
@ Added code generation for divide SWI. May have a small speed
increase in some games.
+ Added analog nub support (special thanks to psp298 for the
code)
+ Added fractional frameskip. Go below 0 to get them. A frameskip
of 1/2 for instance means render 2 out of every 3 frames, 2/3
means render 3 out of every 4 frames, etc. Possibly useful for
games that are not quite fast enough at fs0 but fullspeed at
fs1...
v0.6 - (still beta quality, look out for new bugs)
NOTE: Please include gpsp.cfg with EBOOT.PBP, this shouldn't be
necessary but I think it is right now.
# Fixed a nasty bug that shouldn't have made it into the initial
release; a lot of games that TECM.. erm.. crash won't anymore.
NOTE: This doesn't mean that no game will ever crash, freeze,
otherwise not work.
# Fixed some crashes in the GUI and the ability to "go up" past
ms0:/PSP. Made the "go up" button square like it was supposed to
be (instead of cross).
+ There's now a menu that you can access, by default press right
while holding down triangle for the frameskip bar.
+ Menu option: resize screen aspect ratio, the default is now
"scaled 3:2" which makes it look more like a normal GBA. You
can use "fullscreen" (what it was like before) or "unscaled 3:2"
(tiny but pixel for pixel like a GBA)
+ Menu option: You can now load new games while the current one
is running.
+ Menu option: You can now restart the currently running game.
+ Menu option: Frameskip variation - this defaults to "uniform"
whereas it defaulted to "random" last release. Basically, turn
it on random if you find that frameskip causes flickering
animations to make things disappear. Other than that it will
generally look better on uniform.
+ GUI and file loading now have "auto repeat" on the buttons so
they're not such a pain to navigate.
+ Menu option: Added support for 128KB flash ROM, some games
require it (Pokemon Firered/Leaf Green, Super Mario Advance 4),
turn it on before running the game to make sure it works.
NOTE: There are some versions of these ROMs that have been
hacked to get around their 128KB flash, and may not even work
properly at all. Look out for them, these games should save
128KB save files after you set the setting to it, IF they use
128KB flash.
+ Menu option: Added ability to make the .sav files only update
when you exit the emulator, use with extreme caution (in other
words, it's not a good idea to use something like this in beta
quality software if you care about your saves). Does NOT update
if you exit through the home button, don't use the home button
if you can help it.
+ Zip support thanks to SiberianSTAR. It will load the first file
with the extension .gba or .bin that it finds.
+ Menu options are saved to gpsp.cfg. Note that it does not save
frameskip options or flash ROM options because these are very
per game particular.
+ The emulator will now try to save backup files to something
more matching the backup size than a fixed 64KB.
@ Loading ROMs and the auto save of the .sav files is MUCH faster
now. Thanks for the heads up on how to improve this from pollux!
@ While coding for the screen resize code I found that SDL just
wasn't cutting it and had to code for the GU myself. Turns out
the new code is faster (but because it is render code any
improvement will be diminished to nothing as frameskip is
increased). Special thanks to Zx-81 for the tips on this one
and for his GU code in the PSPVBA source as an example.
@ Added some games to game_config.txt. Note that not all versions
of these ROMs will work with these options, try to use the USA
version if possible.
8-19-2006 v0.5 - Initial release (public beta quality)
-- About --
gameplaySP (gpSP for short) is a GBA emulator written completely from
scratch. It is still pretty young (only having started a 3 months prior
to the first release) and thus rather immature, but it does a decent
job of playing a number of games, and is being improved upon somewhat
regularly. It is currently somewhat minimalistic, in the sourcecode,
presentation, and features. Its number one focus is to deliver a GBA
gaming experience in the most playable way that PSP can manage, with
frills being secondary (although still a consideration, at least for
some of them).
Having said that, optimization was the important way in achieving this
goal, with overall compatability being a near second. Because of this
some games may not run at the favor of running more games significantly
better. Of course, the compatability will improve with time. The
compatability in the current version (0.8) is perhaps around 80%
(assuming the correct BIOS image is used).
Many games will run at their best out of the box, but some games will
run very slowly unless idle loops are taken care of. There is a supplied
ROM database, game_config.txt, that gives idle loop targets and other
settings that may help a game to run better (or at all) on a per-game
basis. Currently (as of version 0.8) a few dozen games are on this list,
mostly only USA versions. This list will continue to be updated; there's
no real telling exactly how many of the ~2500 GBA games will need to
appear here.
gpSP currently requires an authentic GBA BIOS image file to run. It will
make no effort to run without one present; this file is 16kb and should
be called gba_bios.bin and present in the same location as the EBOOT.PBP
file. Please do not ask me where to obtain this, you'll have to look
online or grab it from a GBA. Note that it is not legal to have this file
unless you own a GBA, and even then it's rather gray area.
-- Features --
gpSP mostly emulates the core Gameboy Advance system. As of right now it
does not emulate any special hardware present on various GBA cartridges.
What it emulates:
GBA CPU: All ARM7TDMI ARM and Thumb mode opcodes except block memory w/
s-bit (probably aren't used in GBA games)
Video: Modes 0, 1, 2 almost completely, basic 3-5 support, sprites,
windows/OBJ windows
Interrupts: HBlank, VBlank, all timers, all DMA channels, keypad
DMA: Immediate, HBlank, VBlank, sound timer triggered
Sound: Both DirectSound channels and all 4 GBC audio channels
Input: Basic GBA input delivered through PSP controls
Cartridges: Currently supports ROMs up to 32MB in size (the maximum for
GBA) with the technique of ROM page swapping to fit within PSP's RAM.
Backup: 32/64kb SRAM, 64/128kb flash, 512bit/8kb EEPROM
RTC: The real-time clock present in cartridges such as most of the
Pokemon games and some others.
What it lacks:
Video: No mosaic, bitmap modes lack color effects (alpha, fades),
there might be some minor inaccuracies in blending...
Cycle accuracy: Very cycle innacurate; CPU is effectively somewhat
overclocked, meaning games with rampant idle loops will probably run
rather poorly. DMA transfers effectively happen for free (0 cycle).
Please do NOT use gpSP as a first source for developing GBA homebrew,
try No$GBA instead.
Additional features it has:
- The ability to attempt to run games at faster than GBA speed (sometimes
they can end up a lot faster, other times not so much)
- Savestates: the ability to save a game's state to a file and resume
playing where you left off later.
- Mild cheat support
Features that it doesn't have (please don't ask me to implement these!)
- Wi-fi multiplayer
-- Controls --
The default control scheme is very simple. If you don't like it you can
change it in the configuration menu.
At the ROM selection screen:
Up/down: navigate current selection window.
Left/right: switch between file window and directory window.
Circle/start: select current entry.
Square: go one directory up.
In game:
Up/down/left/right: GBA d-pad
Circle: GBA A button
Cross: GBA B button
Square/start: GBA start button
Select: GBA select button
Left trigger: GBA left trigger
Right trigger: GBA right trigger
Triangle: Adjust frameksip
In frameskip adjustment:
Hold down triangle to keep up, press up/down to increase/decrease
frameskip, respectively. Press down at 0 to change to auto, and up
at auto to change to 0.
In the menu:
Up/down: navigate current menu.
Left/right: change value in current menu selection (if a value is present)
Circle/start: select current entry (see help for entry to see what this means)
Square: exit the current menu.
-- Frameskip --
The purpose behind frameskip is to cause the emulator to not render every
frame of graphics to make the emulation closer to fullspeed. Many games will
run fullspeed without skipping any frames, however, some (particularly more
graphically demanding ones) will require this.
Frameskip can be set to two forms, either auto or manual. Auto will attempt
to skip only as many frames as necessary to make the game full speed, and
will not skip more than 4 in a row no matter what speed the game runs at
(at this point the benefits of frameskip yield diminishing returns).
It is recommended that you keep frameskip on auto, but manual is maintained
as an option if you want it and works as follows:
Manual frameskip will only render one out of every (n + 1) frames, where n
is the current frameskip value (so 0 will render everything). Increasing
the frameskip can improve speed, especially with very graphically
intensive games.
-- Cheats --
Currently, gpSP supports some functionality of Gameshark/Pro Action Replay
cheat codes. To use these, you must first make a file with the same name
as the ROM you want the cheat code to apply to, but with the extension .cht.
Put this file in the same directory as the ROM. To make it use a normal
text editor like notepad or wordpad if you're on Windows.
To write a code, write the type of model it is, gameshark_v1, gameshark_v3,
PAR_v1, or PAR_v3. gameshark_v1/PAR_v1 and gameshark_v3/PAR_v3 respectively
are interchangeable, but v1 and v3 are not! So if you don't know which
version it is, try both to see if it'll work.
Then, after that, put a space and put the name you'd like to give the cheat.
On the next several lines, put each cheat code pair, which should look like
this:
AAAAAAAA BBBBBBBB
Then put a blank line when you're done with that code, and start a new code
immediately after it. Here's an example of what a cheat file should look
like:
gameshark_v3 MarioInfHP
995fa0d9 0c6720d2
gameshark_v3 MarioMaxHP
21d58888 c5d0e432
gameshark_v3 InfHlthBat
6f4feadb 0581b00e
79af5dc6 5ce0d2b1
dbbd5995 44b801c9
65f8924d 2fbcd3c4
gameshark_v3 StopTimer
2b399ca4 ec81f071
After you have written the .cht file, you have to enable the cheats
individually in the game menu. Go to the Cheats/Misc menu, and you will
see the cheats; turn them on here. You may turn them on and off as you
please, but note that some cheats may still hold after you turn them off,
due to the nature of the system. Restart to completely get rid of them.
IMPORTANT NOTES:
This is still very work in progress! I basically added this in only 1.5
or so hours, and I don't have a lot of time right now to work on it
before releasing. So I'll probably improve it later.
Not all of gameshark's features are supported, especially for v3. Only
basic cheats will work, more or less.
Cheats may be unstable and may crash your game. If you're having problems
turn the cheats off.
Really, there's no guarantee that ANY cheats will work; I tried a few and
some seem to work, others are questionable. Try for yourself, but don't
expect anything to actually work right now. Do expect this feature to
improve in future versions.
-- Frequently Asked Questions --
Q) How do I run this on my PSP?
A) Provided is an EBOOT.PBP which will run as is on a 1.0 firmware
PSP or custom firmware that can run unsigned EBOOTs. On 1.5 firmwares
you must use a kxploit tool to run it (try SeiPSPtool). On 2.0
firmwares and higher further exploits must be used - see
http://pspupdates.qj.net/ for more information. Note that I have NOT
tested this emulator on any firmware version besides 1.5, and it's
very possible that it doesn't run well, or at all on higher versions.
Therefore I strongly recommend you downgrade if possible, and use
Devhook to run games that require > 1.5 version firmwares.
Be sure to include in the same directory as the EBOOT.PBP file the
game_config.txt file included and the gba_bios.bin file which you
must provide yourself.
gpSP does not run on PSPs with version 2.71 or higher firmware yet,
nor does any other homebrew executable.
Q) What is a BIOS image file? Why do I need it to run gpSP? Other GBA
emulators don't require this...
A) The GBA BIOS image file is a copy of a ROM on the GBA system that
has code for starting up the GBA (it shows the logo), verifying the
game, and most importantly, providing utility functions for the games
to use. It is the latter that gpSP needs the BIOS present for. It's
possible to replace all of these functions with equivilent code, but
this will take time - in the future gpSP may not require a BIOS image.
Q) I can't find this BIOS image.. please send it to me.
A) Sorry, but you're on your own. I won't send you a BIOS or tell you
where to get one (unless you want to rip it from a GBA yourself, in
which case I'll just give you the same link at the top). I can't do
this because it's not legal to send it around and I don't want to
get a reputation for illegally distributing BIOS images.
Q) How do I know I have the right BIOS?
A) If you have md5sum you can check if it has this hash:
a860e8c0b6d573d191e4ec7db1b1e4f6
That BIOS should work fine. I think that some others work fine too,
although I haven't confirmed this with absolute certainty. It's also
theoretically possible to use custom (and free) BIOS replacements,
but I don't know of any publically availablone ones.
As far as I'm aware there are two BIOSes floating around, I doubt
you'll get one that isn't one of those two. There's a very easy way
to determine which one you have - just look at the very first byte in
a hex editor. The correct BIOS begins with 0x18, the buggy BIOS begins
with 0x14.
Q) My favorite game won't run.
A) There probably isn't anything you can do about this, although a
change to game_config.txt might help. gpSP is still an emulator in
its infancy so the compatability is not superb. I don't have time
to test too many games so I'm releasing it as a public beta to get
a feel for some things that don't work. The next version could
perhaps fix it, or it might never run. There are always other
emulators of course, please try one.
However, before nagging me there is one thing I recommend you try,
and that is to add the option "iwram_stack_optimize = no" for the
game in game_config.txt. See the file itself for more information
on how to do this. If this fixes your game (and it's not already
in the game_config.txt) please tell me about it.
Q) My favorite game is very slow.
A) Emulating GBA takes a number of resources and getting it done well
on PSP is no simple task by any means. Some games are just going to
overwhelm the emulator completely. Of course, there is one special
case of game (a lot of early generation games fall under this
category) that can be made much faster by a simple addition to the
game_config.txt file. Wait for a new version of this file or the
next version of the emulator and the game may be improved.
That aside, there are still numerous optimizations that can be done,
and I sure you future versions will be faster (I just can't tell you
how much)
Also, a lot of games will be sped up considerably by adding an
idle_loop_eliminate_target line for it in game_config.txt. There
are some more obscurer options there that can improve speed too. If
the game is VERY slow there might be something wrong with its
emulation that can be improved. For instance, if you can't get a game
to run fullspeed on any frameskip you should e-mail me about it.
Q) Some games run fullspeed but the sound is messed up. Why?
A) At least 9 out of 10 times it means the game isn't really running
full speed, but just that you can't notice the difference. Increasing
frameskip will almost always improve sound quality in these
situations, to a certain point (after around frameskip 3 you
probably won't be seeing many more returns if it isn't already
fullspeed). The rest of the time it means there's a bug somewhere else
in the emulator, probably in the CPU core. Chances are that all you
can do is wait for it to be fixed in a later release.
Q) The emulator crashed!
A) Most games that don't run will probably take the emulator down with
it, or it could be an emulator bug completely unrelated to the game
(but unlikely). Press home and wait for the next version.
There is some information that comes up when the game crashes. This
information may be slightly useful to me, but chances are it
usually won't be all that interesting.
These days games are more likely to exit with a "bad crash" error.
This number is possibly useful to me, but to debug a game I'll have
to reproduce the crash anyway. When this happens it's probably due to
a bug in the CPU core that hasn't been fixed yet.
Q) Why won't my game save?
A) The game might need 128KB flash turned on and might not be listed in
game_config.txt. See game_config.txt for more information regarding
this. Be sure to include game_config.txt with the EBOOT.PBP file.
Other games might simply have bugs in the save support. For now, use
savestates as an alternative if you can't save.
Q) How do I change sound quality?
A) Right now, you can't. For those wondering, sound is locked at 44.1KHz
(sounds a bit high? It is, but it's currently necessary to play
everything correctly). I don't have any plans to allow changing this
right now, because I don't think there's really much reason to be
able to (it'd be a tiny speed boost at best and I don't think SDL even
allows for anything besides this sampling rate on PSP)
Q) What is this emulator's name?
A) Um.. what? It's gameplaySP, isn't it? You call it gpSP for short.
Somehow the name can't have the acronyms gbSP, gbapSP, or really
just about anything else you feel like giving it. Oh, and if you
really want to make me happy get the capitalization right too.
That's gpSP, not gPSP, GPsp.. you get the idea.
Q) Does gpSP run Gameboy/Gameboy Color games? Will it later?
A) No. Even though GBA can run these games it uses separate hardware
that proper GBA games have no access to (save for the audio chip),
and thus there's no point including it in a GBA emulator (it
doesn't help run GBA games). I recommend using a GB/GBC emulator
like Rin for playing these games. It'll probably give you a lot
more options anyway. gpSP will never actually emulate GB/GBC
games. You'd may as well be waiting for it to emulate PS2 games...
(that was an analogy. gpSP won't ever emulate PS2 games. >_>)
Q) Other emulators use the PSP's graphical hardware to accelerate the
video emulation. Is this possible for gpSP?
A) I'm honestly not too sure at this point. It's definitely a rather
complicated procedure, and I don't think it'll be possible to
accurately accelerate alpha blending. On the other hand, affine
transformations could perhaps receive a speed boost this way. Any
solution would have to be hybrid hardware/software, which might be
possible due to the nature of the PSP's VRAM. Maybe someone will
be willing to help me think of possibilities here?
But don't bother of you're just going to tell me to render a list
of quads...
Q) Other emulators use the PSP's second CPU to offload the sound
emulation. Is this possible for gpSP?
A) Yes, but it wouldn't improve it nearly as much as say, SNES9x TYL.
This is because most of the processing that goes into sound on a GBA
game is done in the CPU, not in dedicated audio hardware. It could
help a little, but probably not a lot. Maybe enough to be worthwhile.
It might also be possible to split the video rendering to the main
CPU and the main emulation to the secondary one, but there are a lot
of coherency issues involved.
Q) I heard gpSP can only load games 16MB or smaller in size. Is this
true? What about zipped games?
A) As of version 0.8 gpSP can play 32MB ROMs. However, they must be
unzipped. The reason for this is that parts of the ROM are constantly
loaded to memory as needed, and for this to be as fast as possible the
ROM has to be present on the memory stick in raw format.
You might be wondering, why not just have gpSP unzip the ROM to a file
then delete the file when it is done? The reason why is because this
would impose a "hidden" requirement of 32MB on the user that very
likely may not be there. Furthermore, there are only a few 32MB games
that anyone actually wants to play. If you only have one 32MB game on
your memstick then it'd actually require signifnicantly more free space
to hold both the ROM and the 32MB raw file. With 2 32MB ROMs you only
gain a around 10-25MB of free space, depending on how effective the
compression is.
Q) Savestates? From other emulators??
A) See the savestates option in main menu. gpSP will probably never
support savestates from other emulators, there's just too much in the
way of emulator specific data in them.
Savestates are currently 506,943 bytes. They would be a little smaller
without the snapshot, but I find that very useful and it wouldn't help
size immensely. Compression would help, but I wanted the size to be
constant so you knew exactly how much you could hold and to improve
save/load speed.
Q) What's with the zip support?
A) I hear stories that some games work unzipped and not zipped, so you
might want to try unzipping them if it gives you problems. You also
might want to try making fresh zips with WinRAR - users have
reported some higher success rates doing this.
Q) What's with the config file? Should I make it read only?
A) There was a bug in version 0.6 that caused the config file to not
get updated or get corrupted sometimes. Hopefully this is fixed now,
but if it DOES get corrupted making it read only can prevent this
from happening in the future.
Q) So when WILL the next version be released?
A) Sorry, but I almost never announce release dates. Furthermore, I'll
probably be pretty hush hush on internal development, just to keep
people from nagging me about it and building too much suspense.
Q) I don't like this emulator. Are there other alternatives?
A) Yes. Try PSPVBA by Zx-81 (http://zx81.dcemu.co.uk/). Overall I doubt
the compatability is significantly higher than gpSP's anymore, but
I'm sure there are some games it runs that gpSP doesn't.
Q) I heard there was a version of gpSP for PCs. Is that true?
A) I developed this emulator internally on PC. It might have a speed
advantage over other PC GBA emulators, although the PSP version has
more sophisticated optimizations. Most people have fast enough
computers to run better GBA emulators for PC and gpSP lacks some
important features (screen resizing) that the PSP version kinda
hides. Even though gpSP spent a majority of its development
gestation as a PC app it was always developed with the PSP in mind,
so the PC version will probably not see the light of the day unless
I get overwhelming demand for it. It is, however, possible to
build it from the source. But I request that you don't distribute
such builds. If you happen to find one, bear in mind that I don't
offer any support for it, and as far as I'm concerned it won't
exist.
Q) I hear there's a version of gpSP for other platforms too, like
Dreamcast. And I hear they're slow! What gives?
These are ports, done by other people (or maybe myself?). This is
possible because gpSP is open source and its base version is fairly
portable, but to run fast enough on anything but platforms quite a
bit faster than PSP it at least needs a CPU specific dynarec backend.
I don't (necessarily) maintain all builds of gpSP, so you'll have to
contact the authors of these ports for more information. That
notwithstanding, I try to get as involved in other ports of gpSP as
I can.
Q) I want to modify gpSP. How can I do this, and am I at liberty to do
so?
A) Yes, you are, under the terms of the GPL (see the included
COPYING.DOC). You can download the sourcecode from whereever you
downloaded this; if you can't find it please e-mail me and I'll give
you a link to it. I would vastly appreciate it if you contacted me first
before forking my project, especially if you're just looking to gain
recognition without adding much to it. It's better to keep all changes
tidy in one branch of development.
I would like to stress this a little more seriously (hopefully those
interested are reading this). Although you are legally entitled to
release your own forks of gpSP it would be much more benficial to me,
to you, and to the users of this program if you instead tried working
with me to get your changes incorporated into the next version. I
really don't feel like competing with other builds of my source
anymore, so please do me a big favor and send me an e-mail if you want
to work with gpSP.
Q) How do I build gpSP?
A) make will build it. You need to have SDL for PSP installed, as well
as the standard PSP toolchain/PSPSDK and zlib. gpSP isn't much of a
"build it yourself" program so please don't bother me much about how to
build it unless you have a good reason for wanting to do so.
Q) What is with the version numbers?
A) Anything less than 1.0 means beta. Beta means that I still have major
plans for working on it, and that I don't fully back it as being
stable or reliable software. Of course, if it does hit 1.0, that doesn't
mean it'll be perfect. It just means I'll have spent a lot of cumulative
time working things out. The closer it gets to 0.9, the happier I am with
it overall.
Q) Donations?
A) Very appreciated. exophase@gmail.com on PayPal. <3
Q) How can I contact you?
A) exophase@gmail.com, Exophase on AIM, exophase@adelphia.net on MSN. I
welcome IMs, but if you nag me a lot you'll make me sad inside. And
don't ask me for ROMs or the GBA BIOS. I figured this was common sense
but apparently not.
-- Credits --
Exophase: main developer
siberianSTAR: zip support
psp298: analog nub code
Beta testers for 0.7:
theohsoawesome1
thisnamesucks837
blackdragonwave9
dagreatpeewee
xsgenji
Beta testers for 0.8:
Runaway_prisoner
theohsoawesome1
tanyareimyoko
spynghotoh2020
Beta testers for 0.9:
RunawayPrisoner (my right hand man)
Veskgar (my left hand man)
qasim
-- Special thanks --
Quasar84: He's helped me in so many ways with this. We both kinda learned
GBA together, he did little demos for me and I got them emulated. It was
great trying out your more advanced code for your own projects once you
got to them, it was equally rewarding to see your work and to be able to
run it at the same time. Least of all I wouldn't have been able to do any
of this without your constant support and presence. I really owe this
release to you.
gladius: You are an amazing GBA coder. I wouldn't have been able to get
through some tough parts without your help. Its been good talking about
ideas with you.. I'm sure you're glad to see that there's finally a GBA
emulator with dynarec ;)
Many, many others of course, probably too many to name, and I don't want
to make anyone feel bad by putting others above them (well, except those
two, heh) so if you think you should be on here, you probably should be!
Just pretend you are for now, and maybe I'll put you here next time.
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Lesser General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
Copyright (C)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.
Ty Coon, President of Vice
This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License.
举报
举报成功
我们将于2个工作日内通过站内信反馈结果给你！
请认真填写举报原因，尽可能描述详细。
举报类型
请选择举报类型
举报原因
取消
发送
误判申诉
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
取消
提交