Difference between revisions of "PlayStation Portable"

From ScummVM :: Wiki
Jump to navigation Jump to search
(Some more work on language/clarity, and added a direct link to the bug tracker)
m (Added the “About” heading for consistency with other wiki platform pages)
 
(63 intermediate revisions by 15 users not shown)
Line 1: Line 1:
Based on [http://svn.sourceforge.net/viewvc/*checkout*/scummvm/scummvm/trunk/backends/platform/psp/README.PSP?revision=23358 README.PSP] and [http://forums.scummvm.org/viewtopic.php?t=2626&highlight= jak66's forum post].
== About ==
{{PortFeatures|
name=PlayStation Portable|
backend=psp|
version={{StableVersion}}|
status=Maintained|
mp3=yes|
ogg=yes|
uncompressed=yes|
zlib=yes|
plugins=yes|
16bits=yes|
buildbot=yes|
firstversion=0.8.0|
maintainer=[[User:rsn8887|rsn8887]], [[User:joostp|joostp]], [[User:bluddy|bluddy]]|
packager=[[User:rsn8887|rsn8887]], [[User:joostp|joostp]]|
pkgend=-psp.zip|
forum=3|
icon=psp|


= Installation =
agi=yes|
First, look up the version/firmware or your PSP. You can do this by going to system settings and then system information.
agos=yes|
cine=yes|
cruise=yes|
draci=yes|
drascula=yes|
gob=yes|
groovie=yes|
kyra=yes|
lure=yes|
made=yes|
parallaction=yes|
queen=yes|
saga=yes|
scumm=yes|
sky=yes|
sword1=yes|
sword2=yes|
teenagent=yes|
tinsel=yes|
touche=yes|
tucker=yes|
}}


You will get 3 lines:
ScummVM has been ported to the [[Sony]] PlayStation Portable.
<pre>MAC Address: (Your PSP's specific MAC address)
Nickname: (The nickname you put onto PSP)
System software version: (Your PSP's firmware version)</pre>


There are 12 different official firmware versions:
For more information, including how to install and use ScummVM, see the [https://docs.scummvm.org/en/latest/other_platforms/playstation_portable.html PlayStation Portable page] in the [https://docs.scummvm.org/ ScummVM user documentation]


*1.00
== Image viewer ==
*1.50
For your convenience, I've included a simple image viewer in the PSP port.  
*1.51
You can view anything you want while playing a game.
*1.52
There are a few simple rules to follow:
*2.00
*2.01
*2.50
*2.60
*2.70
*2.71
*2.80
*2.81


There are also two unofficial versions:
* Images must be of PNG format. If you have images in another format, many graphics utilities will convert them for you.


*1.50 CF (= 1.5 Custom Firmware)
* Images must be named psp_image1.png, psp_image2.png etc. This is to make sure there's no possible conflict between image files and game files.
*2.71 SE-A


== Firmware 1.00 ==
* Images must be placed in the game directories. When using the image viewer,only the images of the particular game being played will be available for viewing.
Put the single eboot file (eboot.pbp) in a folder scummvm-psp on your memory stick in the game folder, which is in the psp folder (so <tt>ms0:/psp/game/scummvm-psp/eboot.pbp</tt>, where <tt>ms0:/</tt> is your memory stick root) then you go into the <tt>__SCE__scummvm-psp</tt> folder and copy all the files EXCEPT the eboot.pbp into the folder that you placed the single eboot.pbp (so <tt>ms0:/psp/game/scummvm-psp/</tt>) run from XMB (cross media bar, which is what you see when you turn the PSP on).


== Firmware 1.50/1.50 CF ==
* Don't place any images in the ScummVM directory, or you won't be able to seethe images in the game directories.
Copy the folders <tt>__SCE__scummvm-psp</tt> and <tt>%__SCE__scummvm-psp</tt> into the game folder in the psp folder on your memory stick (so <tt>ms0:/psp/game/%__SCE__scummvm-psp/</tt> and <tt>ms0:/psp/game/__SCE__scummvm-psp/</tt>). Run from XMB.
1.50 CF can also follow 1.00 instructions, (if you would prefer only having one folder).


== Firmware 1.51/1.52/2.80/2.81 ==
* There's no guarantee that you'll be able to view your image. This is because big images take a lot of memory (more than the size of the image on disk). If there isn't enough memory left to show the image, ScummVM will tell you so. Try to make the image smaller by either shrinking it or reducing the colors to 256 color palette mode.
At the time of this writing, one cannot use any homebrew software (including ScummVM) on these firmwares (except for TIFF homebrew on 2.80). 1.51 and 1.52, however, can be upgraded to 2.0-2.71, allowing the use of homebrew software.


== Firmware 2.00/2.01/2.50/2.60/2.70/2.71 ==
== Developer information ==
Follow the instructions for firmware 1.0 until (but not including) the point where you are supposed to run XMB. Don't actually try to run XMB, as it wont work. You now need to download [http://www.noobz.eu eLoader] (0.99 was the latest eloader version when this text was written). Use the exe if you can, but there should be a readme for installation. Once installed go to "photo viewer" then press start when on the folder called "eloader 099" (or something similar). This will load eMenu. Now just locate scummvm-psp and press X. For firmware 2.71, you also have the option to use HenC.


== Firmware 2.71 SE-A ==
=== Building from source ===
Follow the instructions for firmware 1.0, except that you place the scummvm-psp folder in the game150 folder rather than the game folder (so <tt>ms0:/psp/game150/scummvm-psp/</tt>). Now run from XMB.
To build ScummVM for PSP you need:


== Notes ==
* ScummVM source code (svn co https://scummvm.svn.sourceforge.net/svnroot/scummvm/scummvm/trunk)
* You can degrade your PSP's firmware to 1.50, but doing so can completely break your PSP (a process called "bricking", as afterward your PSP is essentially nothing but a fancy brick). The reason some brick is mainly due to a hardware problem. Some PSP's have a motherboard referred to as TA-082, and any PSP with this motherboard will not allow 1.50 to be run on the PSP, therefore downgrading will irrevocably break such a PSP.


= Controls =
* PSP toolchain (svn co svn://svn.pspdev.org/psp/trunk/psptoolchain)
{| cellpadding="5"
|-
|Left Trigger||ESC
|-
|Right Trigger||Enter
|-
|Analog||Mouse Movement
|-
|D-Pad||Mouse Movement
|-
|Analog + Triangle||Fine Control Mouse
|-
|X||Mouse Button 1
|-
|Circle||Mouse Button 2
|-
|Square||. (Skip dialogue in some games)
|-
|Select||Show/Hide Virtual Keyboard
|-
|Start||F5
|}


= Notes =
* PSPSDK (svn co svn://svn.pspdev.org/psp/trunk/pspsdk)Note: This usually gets installed by the PSP toolchain, so you don't have to do it manually.
* While it is possible to compress certain game resources to reduce their size, this can (and usually will) cause games (especially animations) to be choppy sometimes, as it requires extra CPU power to decode these files. As such, it is recommended to play games in their original, uncompressed, form whenever possible.


* Sleep/Suspend mode currently isn't supported, so don't use it when running ScummVM.
* zlib (svn co svn://svn.pspdev.org/psp/trunk/zlib)


= Frequently Asked Questions =
* libPNG (svn co svn://svn.pspdev.org/psp/trunk/libpng)
'''Q''': What do I need to run the games?<br/>
'''A''': A 1.00 or 1.50 firmware PSP (or an EBOOT loader on firmware 2.00 or higher), and the necessary datafiles for the game you want to play and obviously ScummVM.


'''Q''': Can I run <Game XXX> with this?<br/>
* libmad(x) (svn co svn://svn.pspdev.org/psp/trunk/libmad)
'''A''': See the [http://www.scummvm.org/compatibility_stable.php list of supported games].


'''Q''': My Monkey Island 1 doesn't have any music, what gives?<br/>
* libTremor(x) (svn co svn://svn.pspdev.org/psp/trunk/libTremor)
'''A''': If your version of Monkey Island came on a CD then it has the music as CD Audio tracks. You need to rip those to MP3/Ogg and copy them to the same directory as the game data files for music to work.


'''Q''': <Game XXX> crashes, or <Feature YYY> doesn't work. Can you fix this?<br/>
(x) = optional
'''A''': Possibly.<br/>
Because of the large amount of games ScummVM supports we obviously haven't played them all start-to-finish on the PSP, so it is possible there are bugs or issues that we are not aware of.<br/>
When you encounter such a bug, please use the [http://sourceforge.net/tracker/?group_id=37116&atid=418820 ScummVM bug tracker], and mention all relevant info (i.e. that you're using the PSP version, which ScummVM version it is, if the problem exists in a recent PC SVN version, a detailed description of the problem, and if possible a nearby savegame). This will make it much easier for us to understand, reproduce and hopefully fix the problem.


= External links =
Once you've installed these libraries (read their README.PSP for instructions), create a subdirectory in your ScummVM folder called 'builds/psp'. Then, in this folder, type
* [http://forums.scummvm.org/viewforum.php?f=3 ScummVM PSP forum]
    ../../configure --host=psp --enable-plugins --default-dynamic
If everything is installed correctly, ScummVM will inform you as it finds the right components. Finally type
  make
to build.


[[Category:Platforms]]
== Port Authors ==
 
Joost Peters  (joostp@scummvm.org)
 
Paolo Costabel (paoloc@pacbell.net)
 
Thomas Mayer  (tommybear@internode.on.net)
 
Yotam Barnoy  (yotambarnoy@gmail.com)

Latest revision as of 21:38, 14 January 2021

About

psp.png PlayStation Portable Port
Latest Released Version 2.8.1
Supported Audio Options MP3, OGG, Uncompressed
Additional Webpage(s) None
Maintainer(s) rsn8887, joostp, bluddy
Packager(s) rsn8887, joostp
Forum Port Forum
Status Maintained
First Official Version 0.8.0

ScummVM has been ported to the Sony PlayStation Portable.

For more information, including how to install and use ScummVM, see the PlayStation Portable page in the ScummVM user documentation

Image viewer

For your convenience, I've included a simple image viewer in the PSP port. You can view anything you want while playing a game. There are a few simple rules to follow:

  • Images must be of PNG format. If you have images in another format, many graphics utilities will convert them for you.
  • Images must be named psp_image1.png, psp_image2.png etc. This is to make sure there's no possible conflict between image files and game files.
  • Images must be placed in the game directories. When using the image viewer,only the images of the particular game being played will be available for viewing.
  • Don't place any images in the ScummVM directory, or you won't be able to seethe images in the game directories.
  • There's no guarantee that you'll be able to view your image. This is because big images take a lot of memory (more than the size of the image on disk). If there isn't enough memory left to show the image, ScummVM will tell you so. Try to make the image smaller by either shrinking it or reducing the colors to 256 color palette mode.

Developer information

Building from source

To build ScummVM for PSP you need:

(x) = optional

Once you've installed these libraries (read their README.PSP for instructions), create a subdirectory in your ScummVM folder called 'builds/psp'. Then, in this folder, type

   ../../configure --host=psp --enable-plugins --default-dynamic 

If everything is installed correctly, ScummVM will inform you as it finds the right components. Finally type

  make 

to build.

Port Authors

Joost Peters (joostp@scummvm.org)

Paolo Costabel (paoloc@pacbell.net)

Thomas Mayer (tommybear@internode.on.net)

Yotam Barnoy (yotambarnoy@gmail.com)