Linux installation - with libraries

[foebea]

There are other threads on this site for using the PSP Toolchain on Windows with and also without Cygwin, but there seems to be a lack for true linux.

This is a quick and relatively easy tutorial for installation and configuration of both linux, the psp toolchain, and most of the libraries. Currently bzip2, freetype, jpeg, libbulletml, libmad, libmikmod, libogg, libpng, libpspvram, libTremor, libvorbis, lua, pspgl, pspirkeyb, SDL, SDL_gfx, SDL_image, SDL_mixer, SDL_ttf, sqlite and zlib.

This is accomplished in basically 3 steps. Install linux, install toolchain, install libraries. Here's how it goes.

Grab the latest Xubuntu LiveCD. http://www.xubuntu.org/get
It is under 600 megs and can be burned to a cd. Xubuntu is a lightweight linux distro which has very low default requirements but looks and runs as nicely as any distro I have used. Boot the cd and without any installation or changing your hard drive you have a full blown and active linux. You can play around with it and see if you like it. If you decide to use a different distribution they likely have different installation instructions, but if you decide to go with Xubuntu just double click on the Install icon on the desktop and it does the rest.

Now that linux is installed, download the latest PSP Toolchain at http://ps2dev.org/psp/Tools/Toolchain
Extract the PSP Toolchain archive to its own folder on the Desktop.

Go to a console by clicking on Applications (This menu acts like the Start button in windows, and is typically on the left hand side of the Toolbar) and choose Accessories, then Terminal.

Type in 'sudo su' and then enter your password to get root access. Now enter the following commands to install all the programs required to install the Toolchain. Some of them may already be installed so nothing will be done, but run them all anyway to ensure everything is up to date. Note: In the PSP Toolchain readme it says to install ncurses, but on apt-get ncurses is installed by the name libncurses5-dev so I use that here.

apt-get install autoconf
apt-get install automake
apt-get install bison
apt-get install flex
apt-get install gcc
apt-get install make
apt-get install libncurses5-dev
apt-get install libusb-dev
apt-get install patch
apt-get install subversion
apt-get install texinfo
apt-get install wget


After those have all been installed, updated, or ignored, you need to add these lines to /home/username/.bashrc by running the following commands (in the example, my username is foebea):

vi /home/foebea/.bashrc

This will start the vi editor which is easier to use than people make it out to be.
use your arrow keys to go to the bottom of the file, then go to the end of the last line using your right arrow. Press the 'a' key to tell vi to start 'insert' mode after the current character. Press 'enter' twice and then type:

export PSPDEV=/usr/local/pspdev
export PATH=$PATH:$PSPDEV/bin

Once those two lines are typed, press 'esc' to leave insert mode and then enter ':w' to save changes and ':q' to quit the program. Now your user name is set up so the next time it logs in it will be able to compile psp code. Unfortunately root is not configured as such, so in order to do the next step you need to run those lines again. You don't need to use vi this time, since you will not be using root to compile psp code there is no need to add it to the path. Just enter those two lines as commands in the console.

Now type 'echo $PATH' to make sure your path shows pspdev in the path somewhere. If it does, you are good to go and almost done.

Go into the PSP Toolchain directory that you extracted it to earlier. If you extracted it to the Desktop you can get to it by typing 'cd /home/your-username/Desktop/ps' and then press the tab key to have the system automatically type the rest of the folder name. Now press 'enter'

Run the Toolchain script by entering './toolchain.sh' and then go see 3 movies.

Once that finishes, type 'svn checkout svn://svn.ps2dev.org/psp/trunk/psplibraries'
This downloads a folder into your current directory with a script that automates the process of downloading, configuring, compiling, and installing the following libraries: bzip2, freetype, jpeg, libbulletml, libmad, libmikmod, libogg, libpng, libpspvram, libTremor, libvorbis, lua, pspgl, pspirkeyb, SDL, SDL_gfx, SDL_image, SDL_mixer, SDL_ttf, sqlite and zlib.

Thats a pretty impressive repertoire to have at your disposal.

Use 'apt-get install libtool' to install one last program that we need.
Then run ./libraries.sh

There is only one last thing that needs done to make it all happy. The current version of freetype for the PSP seems to install the include files to the wrong directory.
Enter the command 'cp -R \usr\local\pspdev\psp\include\freetype2\freetype \usr\local\pspdev\psp\include' to put it in the right place.

Now if you want to can 'rm -rf' (delete recursively, don't ask for confirmation) \usr\local\pspdev\psp\include\freetype2 but I recommend keeping it around in case something happened when you tried to copy it, in case its not where it should be or something. If nothing else, you can just reinstall the libraries and it will put it back in the wrong place again.

Now you should have a fully working PSP Development Environment and a pretty stable system.
If there are any programs out there you want or need, you now know how to use apt-get pretty decently. (hint: rather than 'install' you can also 'remove' and 'update')

Any questions?


edit: clarification of 'Application Menu' descriptive language.

[Furypaw]

xubuntu 8.10 wants "mpfr" anyone know what that is so I can type it into apt-get install?

[thehman]

Maybe "sudo apt-get install libmpfr-dev"

[Xitherun]

yeah, libmpfr-dev.

also, you can open up Synaptic Package Manager, and search for what you want.

[pirata nervo]

You will probably need one more library (I don't remember its name now) but I remember I needed to download it

[thehman]

Originally Posted by pirata nervo

You will probably need one more library (I don't remember its name now) but I remember I needed to download it

The other library most likely is libgmp-dev

[pirata nervo]

Yeah that was the one I was talking about

[Blade_punk]

Hey, I've installed Ubuntu 8.10 and I'm trying to get the Toolchain + SDK setup. Everything's gone fine except after a while through running the toolchain script it throws this:

make[3]: *** [libgcc.a] Aborted
make[3]: *** Deleting file `libgcc.a'
make[3]: Leaving directory `/home/lachy/Desktop/psptoolchain/build/gcc-4.1.0/build-psp/gcc'
make[2]: *** [stmp-multilib] Error 2
make[2]: Leaving directory `/home/lachy/Desktop/psptoolchain/build/gcc-4.1.0/build-psp/gcc'
make[1]: *** [all-gcc] Error 2
make[1]: Leaving directory `/home/lachy/Desktop/psptoolchain/build/gcc-4.1.0/build-psp'
make: *** [all] Error 2
../scripts/002-gcc-4.1.0-stage1.sh: Failed.

Anyone know what needs to be done?

[Xitherun]

Originally Posted by Blade_punk

Hey, I've installed Ubuntu 8.10 and I'm trying to get the Toolchain + SDK setup. Everything's gone fine except after a while through running the toolchain script it throws this:

Anyone know what needs to be done?

I had problems with the toolchain install on 8.10 as well.

check out this thread on consoleworld.

http://forums.consoleworld.net/showthread.php?tid=698

[Blade_punk]

Now I'm getting

make: *** [all] Error 2
../scripts/004-newlib-1.15.0.sh: Failed.
ERROR: Could not run the toolchain script.