GpSP

m
(Added a note that (un)installation does not need manual intervention in recent versions)
 
(20 intermediate revisions not shown)
Line 1: Line 1:
-
[[Image:Gba_gpSP.png|thumb|alt=Game Boy handheld|Game Boy handheld]]
+
[[Image:Gba gpSP.png|thumb|alt=Game Boy handheld|Game Boy handheld]]
-
gpSP (game play SP) is a Game Boy Advance emulator, made by Exophase, for use with the Sony PlayStation Portable and GP2X video game systems. There have been ports to iPod the iOS, Maemo, Symbian and many others.
+
'''gpSP''' ('''game play SP''') is a Game Boy Advance emulator, made by Exophase, for use with the Sony PlayStation Portable and GP2X video game systems. There have been ports to iPod (iOS), Maemo, Symbian and many others.
-
The PSP version runs most commercial games at full speed, however some still have problems from minor or severe glitches, while others are very slow. The GP2X version is similar to the PSP one, but typically slower. Unlike VisualBoyAdvance, which high-level emulates the GBA BIOS, gpSP requires a GBA BIOS file in order to operate. Due to copyright reasons, this BIOS cannot be included with the emulator by Exophase, and users must dump it on their own using a Game Boy Advance flash cartridge. Some games do not need the BIOS file to play, however most do.
+
The PSP version runs most commercial games at full speed, however some still have problems from minor or severe glitches, while others are very slow. The GP2X version is similar to the PSP one, but typically slower. Unlike VisualBoyAdvance, which high-level emulates the GBA BIOS, gpSP requires a GBA BIOS file in order to operate.<br />
 +
Due to copyright reasons, this BIOS cannot be included with the emulator by Exophase, and users must dump it on their own using a Game Boy Advance flash cartridge. Some games do not need the BIOS file to play, however most do.
To date, gpSP has proven to be the most efficient, compatible and widely used of all GBA emulators for the PSP, GP2X.
To date, gpSP has proven to be the most efficient, compatible and widely used of all GBA emulators for the PSP, GP2X.
Line 9: Line 10:
Exophase has stopped working on the PSP version of GpSP, in favor of the GP2X and Pandora versions of gpSP. Future versions of gpSP will be closed source due to the constant third-party re-release of gpSP against Exophase's wishes.
Exophase has stopped working on the PSP version of GpSP, in favor of the GP2X and Pandora versions of gpSP. Future versions of gpSP will be closed source due to the constant third-party re-release of gpSP against Exophase's wishes.
-
(Copied and edited from [[:wikipedia:GpSP|Wikipedia]])
+
(Copied and edited from [[wikipedia:GpSP|Wikipedia]])
-
== Installation ==
+
==Installation==
 +
If you are installing a recent version for N900 (3.x), no tricks are required. Simply use ''apt-get'' or an app manager and you are good to go. Otherwise follow the instructions in the box below.
-
{{ambox|text=You must first go to the thread on talk.maemo.org and
+
{{ambox|text=gpSP for Maemo is already avaiable on Maemo Repositories,
-
download latest version pack ( links at the end ).
+
What means you can either use your favourite app manager
-
You can use the app-manager to install it, by double-clicking
+
to install it, or go through the following command on
-
on the file, using any file manager.
+
xterminal:
-
Or, alternately, you can
+
<pre>
 +
apt-get update
 +
apt-get install gpspmgui
 +
</pre>
 +
 
 +
After you have installed gpSP, you must set right permissions to keys,
 +
folders, emulator, etc. that is pretty easy, and should be done by following
 +
these commands:
<pre>
<pre>
root
root
-
dpkg -i /home/user/MyDocs/gpspm-1.0.4-0maemo5.deb
+
mkdir -p /home/user/.config/Team16/gpsp/
 +
chmod 777 /opt/maemo/usr/games
 +
chown user /opt/maemo/usr/games
 +
chown -R user:users /home/user/.config/Team16
 +
chmod 666 /opt/gpspm/conf.gpsp
</pre>
</pre>
-
And that should install gpSP on your device
+
Does that seems like a lot to type? Well, it's worth it, you are
 +
getting a premium quality emulator on your hands for free, come on,
 +
don't be lazy =)
 +
 
}}
}}
-
== How to uninstall ==
+
==How to uninstall==
 +
Just like with installation, in case of an up-to-date version for N900, all you need to do is to use ''apt-get'' or an app manager. If you want to delete also the save files, you can find them in the same directory as your games. If you are trying to uninstall an older version, read on.
{{ambox|text= If you wish to uninstall gpSP from your phone, simply use
{{ambox|text= If you wish to uninstall gpSP from your phone, simply use
-
app manager. But to unsintall old versions, you need to delete the old
+
app manager.
-
files, and DON'T forget to backup your bios.
+
-
 
+
And that should uninstall gpSP from your device
And that should uninstall gpSP from your device
}}
}}
-
== How to run ==
+
x-term way
 +
<pre>
 +
apt-get remove gpspmgui gpspm
 +
</pre>
-
Simply use the icon !
+
also make sure to remove GBA games (no use without emu) and save states
 +
<pre>
 +
rm /opt/maemo/usr/games/*.sav
 +
</pre>
-
== Key configuration ==
+
==How to run==
 +
Simply use the icon! Enjoy your games!
-
Note that the new gpsp folder is now /opt/gpspm/
+
* Make sure you have a copy of a gba_bios.bin on MyDocs.
 +
Since we can't provide you one due to legal reasons, you can
 +
either dump one from a GBA, or download one through internet.
-
To configure the keys, one should edit the conf.gpsp, localised on the gpSP
+
* Once you've grabbed one, make sure to copy it into the MyDocs directory.
-
game folder. The keys examples are on the file conf_ps.gpsp.
+
Then press the top bar menu of gpSP emulator > General settings >
-
[http://www.ascii.cl/htmlcodes.htm Ascii codes table] for you to know which
+
BIOS file. Then just select the gba_bios.bin file you copied
-
numbers the keys are refered to.  
+
to MyDocs and the GUI will make all the dirty work.
-
For example, if you wish to make the "a" button
+
* Next step is to select a directory where you stored your ROMs,
-
on your keyboard avaible for the game, you will see in the list, that "a" lowercase is 97. Then, write 97 on place of the key you wish.
+
and the gui will automatically find and list all of them for you.
-
It is important to note that it must be the '''lowercase''' code.
+
Top bar menu > GUI config > Rom directory.
-
You might use any text editor you wish, such as leafpad.
+
-
== Some games workarounds ==
+
* After that, the GUI may require reboot, so simply close it
 +
and open again, your roms shall be listed for you.
 +
Notice they may be on .zip or .GBA or .gba roms.
 +
* Select a ROM you wish to play, and push the "Configure" button.
 +
After this, a list of options will be shown to you, and these
 +
options are:
 +
 +
==Options==
 +
- Screen options:
 +
 +
* Unscaled : Native GBA resolution (240 x 160)
 +
 +
* Scaled 2x : Twice GBA screen (480 x 320)
 +
 +
* Scaled 3x : 3 times a GBA original screen (720 x 480)
 +
 +
* Fullscreen : Fills up entire N900 screen (800 x 480)
 +
 +
- Frameskipping.:
 +
 +
*Off : Do not skip any frames.
 +
 +
* Auto : Skip up to N frames (N avaiable as an option), automatically and consecutively.
 +
 +
* Manual : Always render 1 out of N + 1 frames, these frames will always be skipped.
 +
 +
* Random Skipping : May make image in some games smoother, when image flickers, but may also make image quality worse, especially in high motion games.
 +
 +
* Uniform Skipping : May make image on high motion games better, just the opposite of random skip.
 +
 +
- Audio Buffering.:
 +
Set the size (in bytes) of the audio buffer. Larger values may result in slightly better performance at the cost of latency; the lowest value will give the most responsive audio.
 +
 +
* Please, notice that low values are buggy, so please be sure to only choose values above 4096 bytes.
 +
 +
- FF ( Fastforward )
 +
Is supposed to make emulator run faster than normal, what can prove to be useful in some games (Subject to test workability).
 +
 +
==How to play NES games==
 +
What you will need before starting (download links, and reference at the end)
 +
 +
* PocketNES.gba file (available on PocketNES v9.98 package)
 +
* PocketNes menu maker
 +
 +
The PocketNes.gba file you can get from the Pocketness package, once you
 +
have it, as well as the Menu maker, copy it to the menu maker folder,
 +
open pnesmmw.exe > click on options > select the PocketNes.gba file
 +
from the PocketNes Rom option, then select your NES files using the Rom Path
 +
option ( Both first and second options, do it in any order ).
 +
Once you close the options your nes files should be listed, just chose ones,
 +
and click Make Rom, a file called PocketNESMenu.gba will be created, just
 +
rename it anyway you want, put on your device, and play.
 +
 +
* [http://www.summeli.fi/?p=2613 Summeli's Original Post ]
 +
* [http://www.pocketnes.org/downloads.html PocketNES Host site with needed files ]
 +
 +
Instructions were copied and edited from Summeli's official site, NES games
 +
shouldn't be listed on gpSP Working games list.
 +
 +
==Some games workarounds==
On some games, you will need workarounds for now to get them working.
On some games, you will need workarounds for now to get them working.
-
Kingdom Hearts
+
-Kingdom Hearts
-
<pre>
+
 
-
Simply, before the game freezes on intro video, quicksave the
+
 
 +
{{ambox|text= Simply, before the game freezes on intro video, quicksave the
game, then load it back, it should work normally!
game, then load it back, it should work normally!
-
</pre>
+
}}
-
== Links ==
 
-
* [http://talk.maemo.org/showthread.php?t=67038 T.M.O Thread ]
+
-Mario Advanced 4 (And probably many other games)
-
* [[GpSP/Game_Compatibility|gpSP Game Compability List]]
+
 
 +
 
 +
{{ambox|text= Refer to [http://www.summeli.fi/?p=2588 Summeli's post] about patching GBA ROMs.
 +
 
 +
If other games works using the ROM patching solution, please post them on
 +
the game compability list and link them here.
 +
}}
 +
 
 +
==Links==
 +
* [http://talk.maemo.org/showthread.php?p=1131846#post1131846 T.M.O thread]
 +
* [[GpSP/Game Compatibility|gpSP Game Compability List]]
 +
* [https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=8X5V9U64RSWUU Maemo developer (Bonapart) PayPal donate]
[[Category:Software]]
[[Category:Software]]

Latest revision as of 21:24, 4 October 2013

Game Boy handheld
Game Boy handheld

gpSP (game play SP) is a Game Boy Advance emulator, made by Exophase, for use with the Sony PlayStation Portable and GP2X video game systems. There have been ports to iPod (iOS), Maemo, Symbian and many others.

The PSP version runs most commercial games at full speed, however some still have problems from minor or severe glitches, while others are very slow. The GP2X version is similar to the PSP one, but typically slower. Unlike VisualBoyAdvance, which high-level emulates the GBA BIOS, gpSP requires a GBA BIOS file in order to operate.
Due to copyright reasons, this BIOS cannot be included with the emulator by Exophase, and users must dump it on their own using a Game Boy Advance flash cartridge. Some games do not need the BIOS file to play, however most do.

To date, gpSP has proven to be the most efficient, compatible and widely used of all GBA emulators for the PSP, GP2X.

Exophase has stopped working on the PSP version of GpSP, in favor of the GP2X and Pandora versions of gpSP. Future versions of gpSP will be closed source due to the constant third-party re-release of gpSP against Exophase's wishes.

(Copied and edited from Wikipedia)

Contents

[edit] Installation

If you are installing a recent version for N900 (3.x), no tricks are required. Simply use apt-get or an app manager and you are good to go. Otherwise follow the instructions in the box below.

Image:Ambox_notice.png
 gpSP for Maemo is already avaiable on Maemo Repositories,

What means you can either use your favourite app manager to install it, or go through the following command on xterminal: 

apt-get update
apt-get install gpspmgui

After you have installed gpSP, you must set right permissions to keys, folders, emulator, etc. that is pretty easy, and should be done by following these commands: 

root
mkdir -p /home/user/.config/Team16/gpsp/
chmod 777 /opt/maemo/usr/games
chown user /opt/maemo/usr/games
chown -R user:users /home/user/.config/Team16
chmod 666 /opt/gpspm/conf.gpsp

Does that seems like a lot to type? Well, it's worth it, you are getting a premium quality emulator on your hands for free, come on,

don't be lazy =)

[edit] How to uninstall

Just like with installation, in case of an up-to-date version for N900, all you need to do is to use apt-get or an app manager. If you want to delete also the save files, you can find them in the same directory as your games. If you are trying to uninstall an older version, read on.

Image:Ambox_notice.png
 If you wish to uninstall gpSP from your phone, simply use

app manager.

And that should uninstall gpSP from your device

x-term way 

apt-get remove gpspmgui gpspm

also make sure to remove GBA games (no use without emu) and save states 

rm /opt/maemo/usr/games/*.sav

[edit] How to run

Simply use the icon! Enjoy your games!

  • Make sure you have a copy of a gba_bios.bin on MyDocs.

Since we can't provide you one due to legal reasons, you can either dump one from a GBA, or download one through internet.

  • Once you've grabbed one, make sure to copy it into the MyDocs directory.

Then press the top bar menu of gpSP emulator > General settings > BIOS file. Then just select the gba_bios.bin file you copied to MyDocs and the GUI will make all the dirty work.

  • Next step is to select a directory where you stored your ROMs,

and the gui will automatically find and list all of them for you. Top bar menu > GUI config > Rom directory.

  • After that, the GUI may require reboot, so simply close it

and open again, your roms shall be listed for you. Notice they may be on .zip or .GBA or .gba roms.

  • Select a ROM you wish to play, and push the "Configure" button.

After this, a list of options will be shown to you, and these options are:

[edit] Options

- Screen options:

  • Unscaled : Native GBA resolution (240 x 160)
  • Scaled 2x : Twice GBA screen (480 x 320)
  • Scaled 3x : 3 times a GBA original screen (720 x 480)
  • Fullscreen : Fills up entire N900 screen (800 x 480)

- Frameskipping.:

  • Off : Do not skip any frames.
  • Auto : Skip up to N frames (N avaiable as an option), automatically and consecutively.
  • Manual : Always render 1 out of N + 1 frames, these frames will always be skipped.
  • Random Skipping : May make image in some games smoother, when image flickers, but may also make image quality worse, especially in high motion games.
  • Uniform Skipping : May make image on high motion games better, just the opposite of random skip.

- Audio Buffering.: Set the size (in bytes) of the audio buffer. Larger values may result in slightly better performance at the cost of latency; the lowest value will give the most responsive audio.

  • Please, notice that low values are buggy, so please be sure to only choose values above 4096 bytes.

- FF ( Fastforward ) Is supposed to make emulator run faster than normal, what can prove to be useful in some games (Subject to test workability).

[edit] How to play NES games

What you will need before starting (download links, and reference at the end)

  • PocketNES.gba file (available on PocketNES v9.98 package)
  • PocketNes menu maker

The PocketNes.gba file you can get from the Pocketness package, once you have it, as well as the Menu maker, copy it to the menu maker folder, open pnesmmw.exe > click on options > select the PocketNes.gba file from the PocketNes Rom option, then select your NES files using the Rom Path option ( Both first and second options, do it in any order ). Once you close the options your nes files should be listed, just chose ones, and click Make Rom, a file called PocketNESMenu.gba will be created, just rename it anyway you want, put on your device, and play.

Instructions were copied and edited from Summeli's official site, NES games shouldn't be listed on gpSP Working games list.

[edit] Some games workarounds

On some games, you will need workarounds for now to get them working.

-Kingdom Hearts


Image:Ambox_notice.png
 Simply, before the game freezes on intro video, quicksave the game, then load it back, it should work normally!


-Mario Advanced 4 (And probably many other games)


Image:Ambox_notice.png
 Refer to Summeli's post about patching GBA ROMs.

If other games works using the ROM patching solution, please post them on

the game compability list and link them here.

[edit] Links

Retrieved from "http://wiki.maemo.org/GpSP"