GpSP

m
(Rewritten wiki to better match new emulator)
Line 13: Line 13:
== Installation ==
== Installation ==
-
{{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 ), on the first post.
+
What means you can eighter use your favourite app manager
 +
to install it, or go through the following command on  
 +
xterminal.:
-
Before going through the install process be sure to have libsdl-haa1.2-dev
+
<pre>
-
installed on your device.
+
apt-get update
 +
apt-get install gpspmgui
 +
</pre>
-
''Javispedro pointed out that installing DrNokSnes
+
}}
-
from extras-devel should install also the  libsdl-haa1.2-dev,
+
-
so if you have his Snes emulator already installed from
+
-
devel repository, you may skip apt-get  libsdl-haa1.2-dev,
+
-
if you don`t have drnoksnes, install libsdl-haa1.2-dev from
+
-
extras devel, or by issuing this command on xterminal.:''
+
 +
== How to uninstall ==
-
<pre>
+
{{ambox|text= If you wish to uninstall gpSP from your phone, simply use
-
root
+
app manager.  
-
apt-get install libsdl-haa1.2-dev
+
And that should uninstall gpSP from your device
-
</pre>
+
}}
-
Now you can use the app-manager to install it, by double-clicking
+
== How to run ==
-
on the file, using any file manager.
+
-
Or, alternately, you can
+
Simply use the icon ! Enjoy your games!
-
<pre>
+
* Make sure you have a copy of a gba_bios.bin on MyDocs.
-
root
+
Since we can't provide you one due to legal reasons, you can
-
dpkg -i /home/user/MyDocs/gpspm-1.23.5-0maemo5.deb
+
eighter dump one from a gba, or download one through internet.
-
</pre>
+
-
And that should install gpSP on your device
+
* Once you've grabbed one, make sure to copy it into MyDocs,
 +
then, press the top bar menu of gpSP emulator > GUI Config >
 +
Copy bios. Then just select the gba_bios.bin file you copied
 +
to MyDocs, the gui will make all the dirty work.
-
Now you must put a copy of a gba bios file in your installation
+
* Next step is to select a Directory where you stored your roms,
-
folder. For many reasons we cannot distribute it within the
+
and the gui will automatically find and list all of them for you.
-
package itself, so google it around.
+
Top bar menu > GUI config > Rom directory.
-
After having the gba bios, put it on /opt/gpsp/ folder,
+
* After that, the GUI may require reboot, so simply close it
-
and the emulator should recognize it automatically, if it's the
+
and open again, your roms shall be listed for you.
-
correct bios.
+
Notice they may be on .zip or .GBA or .gba roms.
-
To put it in this folder you can use x-terminal with the following
+
* Select a rom you wish to play, and push "Configure" button.
-
command.:
+
After this, a list of options will be shown to you, and these
 +
options are.:
-
<pre>
+
== Options ==
-
root
+
-
mv /home/user/MyDocs/gba_bios.bin /opt/gpsp/
+
-
</pre>
+
-
Of course, be sure to put the file on MyDocs before using this
 
-
command, otherwise it will return no such file for you.
 
-
Or copy it using your favourite file manager. ( One that has
 
-
access to system files).
 
-
}}
 
-
== How to uninstall ==
+
- Screen options.:
-
{{ambox|text= If you wish to uninstall gpSP from your phone, simply use
+
* Unscaled : Native gba resolution ( 240 x 160 )
-
app manager.
+
-
But to unsintall old versions, you need to delete the
+
-
old
+
-
files, and DON'T forget to backup your bios.
+
-
And that should uninstall gpSP from your device
+
* Scaled 2x : Twice gba screen ( 480 x 320 )
-
}}
+
-
== How to run ==
+
* Scaled 3x : 3 times a gba original screen ( 720 x 480 )
-
Simply use the icon ! Enjoy your games!
+
* Fullscreen : Fills up entire N900 screen ( 800 x 480 )
 +
 
 +
- Frameskipping.:
-
Maybe the first time you run gpSP, you will need to go
+
*Off : Do not skip any frames.
-
through your system folders to get to MyDocs, where
+
-
you probably put your roms. To do that so, you will press the UP
+
-
button on your keyboard, that will take you to your root system
+
-
directory. From there navigate on this sequence.:
+
-
/home/user/MyDocs/
+
* Auto : Skip up to N frames ( N avaiable as an option ), automatically
 +
and consecutively.
-
The second time you run, it will save your latest directory,
+
* Manual : Always render 1 out of N + 1 frames, these frames will always
-
and you won't need to do it again.
+
be skipped.
-
Some games work better on some configs, mess with the configs,
+
* Random Skipping : May make imagine in some games smoother, when
-
don't worry your emu won't explode, play with it and you will
+
image flickers, but may also make image quality worse, especially in
-
surely find what best suits your game, your phone and your
+
high motion games.
-
fun!
+
-
== Key configuration ==
+
* Uniform Skipping : May make image on high motion games better,
 +
just the opposite of random skip.
-
Note that the new gpsp folder is now /opt/gpspm/
+
- 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. This option requires gpSP to
 +
be restarted before it will take effect.
-
To configure the keys, one should edit the conf.gpsp, localised on the gpSP
+
** Please, notice that low values are buggy, so please be sure to only
-
game folder. The keys examples are on the file conf_ps.gpsp.
+
choose values above 4096 bytes.
-
[http://www.ascii.cl/htmlcodes.htm Ascii codes table] for you to know which
+
-
numbers the keys are refered to.  
+
-
For example, if you wish to make the "a" button
+
- FF ( Fastforward )
-
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.
+
Is supposed to make emulator run faster than normal, what can prove
-
It is important to note that it must be the '''lowercase''' code.
+
to be useful in some games ( Subject to test workability ).
-
You might use any text editor you wish, such as leafpad.
+
== Some games workarounds ==
== Some games workarounds ==

Revision as of 20:06, 1 December 2011

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.

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

Installation

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

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

apt-get update
apt-get install gpspmgui

How to uninstall

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

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 eighter dump one from a gba, or download one through internet.

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

then, press the top bar menu of gpSP emulator > GUI Config > Copy bios. Then just select the gba_bios.bin file you copied to MyDocs, 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 "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 imagine 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. This option requires gpSP to be restarted before it will take effect.

    • 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 ).

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!

Links

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