[Guide] PSP Development Environment Setup Tutorial

[EvilSeph]

PSP Development Environment Setup Tutorial
v1.5 by EvilSeph and Raphael

Note: Screenshots are currently broken...will work on getting that fixed when I can.

Information
Let me start off by saying I realise there are a few hundred of these guides (written in different languages) but they're incorrect, incomplete or tell you to do things you don't need to do. So, I decided to write my own. Mainly for my own benefit, if I were to have to reinstall the toolchain but I thought I'd post it here anyway.
This tutorial is different, in that it only tells you to do what you need, resulting in a somewhat faster install of cygwin and less disk space wasted on your harddrive.

I've placed screenshots in spoiler tags, for those 56k users out there. Although, I pray for you if you are wanting to use this guide and have 56k, it will take you longer than forever...

Required Download:
Cygwin - http://www.cygwin.com/

Cygwin Installation:
1. Cygwin Setup
a) Run the "setup.exe" that you downloaded from http://www.cygwin.com/ and you should see something similar to what is in the screenshot below.
b) Press Next.

Spoiler for Cygwin Installer - Main:

2. Installation Type
a) Choose the first option, "Install from Internet" as shown in the screenshot below.
b) Press Next.

Spoiler for Cygwin Installer - Installation Type:

3. Installation Directory
a) Choose where you want to install cygwin. I've chosen "D:\cygwin" in the screenshot below, but it can be whatever you want - just make sure that there are NO SPACES in the location you choose or you'll run into problems later on.
b) Choose who you want to install cygwin for (All Users or Just Me - I'd recommend installing cygwin for all users).
c) Make sure that the "Default Text File Type" is set to "Unix / binary" or you'll run into problems.
d) Press Next.

It is recommended that you keep everything here at the default (meaning, don't change anything).

Spoiler for Cygwin Installer - Installation Directory:

4. Local Package Directory
a) Choose where you want the files cygwin downloads to be located. I've chosen D:\cygwininstall" in the screenshot below, but once again, it could be whatever you want. However, the default is usually fine. All the files cygwin downloads can be deleted later.
b) Press Next.

Spoiler for Cygwin Installer - Local Package Directory:

5. Connection Type
a) Choose the type of connection you would like cygwin to use. If you know that you have to change this, then do. If you don't know what this is, the default will work fine. It is recommended you leave this at default.
b) Press Next.

Spoiler for Cygwin Installer - Connection Type:

6. Download Sites
a) Choose the site(s) you wish cygwin to use to download the files from. In this case, it all depends on where you are located. The easiest way to figure out which site is closest to you is to go to http://www.cygwin.com/mirrors.html and look for your country and city or the city closest to you.

I've chosen to add a new mirror:
http://sources-redhat.oc1.mirrors.redwire.net/cygwin/

b) Press Next.

Spoiler for Cygwin Installer - Download Sites:

Ok, so far it's been the same as every other guide. But here's where mine differs. Where other guides just tell you to install EVERY Devel package, I'm going to be specific.
Beware, this is going to get really detailed...here goes:

7. Package Selection

Note: When you do what I've told you to do here, other packages will automatically be marked to be installed, leave them like that.

a) Click the + next to "Base", find the following and click next to it under the "New" column, to tell cygwin to install it:

Spoiler for Base Packages:

Package Size
coreutils 2,327k
diffutils 237k
grep 117k
gzip 54k
sed 139k
tar 696k

b) Click the + next to "Devel", find the following and click next to it under the "New" column, to tell cygwin to install it:

Spoiler for Devel Packages:

Package Size
autoconf 3k
autoconf2.1 203k
autoconf2.5 775k
automake1.9 558k
binutils 4,815k
doxygen 1,780k
expat 165k
gcc 1k
gcc-core 3,618k
gcc-g++ 2,958k
gcc-mingw-core 69k
gcc-mingw-g++ 1,894k
libxml2 637k
make 348k
mingw-runtime 261k
mktemp 11k
patchutils 83k
subversion 1,053k

c) Click the + next to Shells, find the following and click next to it under the "New" column, to tell cygwin to install it:

Spoiler for Shell Packages:

Package Size
ash 47k
bash 516k

d) Click the + next to Utils, find the following and click next to it under the "New" column, to tell cygwin to install it:

Spoiler for Utils Packages:

Package Size
bzip2 407k
cygutils 182k
patch 55k
patchutils 83k

e) Click the + next to Web, find the following and click next to it under the "New" column, to tell cygwin to install it:

Spoiler for Web Packages:

Package Size
wget 470k

Spoiler for All Package Summary:

Package Size
alternatives 77k
ash 47k
base-files 35k
base-passwd 1k
bash 516k
coreutils 2,327k
cygwin 1,362k
cygwin-doc 919k
diffutils 237k
editrights 28k
findutils 424k
gawk 617k
gdbm 48k
grep 117k
gzip 54k
libgdbm 10k
libgdbm-devel 34k
libgdbm3 16k
libgdbm4 13k
libncurses5 178k
libncurses6 187k
libncurses7 140k
libncurses8 171k
libreadline4 55k
libreadline5 77k
libreadline6 81k
login 14k
man 188k
ncurses 404k
run 35k
sed 139k
tar 696k
termcap 20k
terminfo 197k
which 3k
zlib 95k

libdb4.2 632k
libdb4.3 742k

autoconf 3k
autoconf2.1 203k
autoconf2.5 775k
automake1.9 558k
binutils 4,815k
doxygen 1,780k
expat 165k
gcc 1k
gcc-core 3,618k
gcc-g++ 2,958k
gcc-mingw-core 69k
gcc-mingw-g++ 1,894k
libxml2 637k
make 348k
mingw-runtime 261k
mktemp 11k
patchutils 83k
subversion 1,053k

texinfo 680k

libpng12 104k

m4 199k
perl 7,464k

crypt 13k
libapr1 51k
libaprutil1 32k
libbz2_1 27k
libintl 11k
libintl1 11k
libintl2 20k
libintl3 16k
libintl8 17k
libneon25 44k
libpcre0 162k
ligpng12-devel 191k
libpopt0 12k
openssl 964k
openssl097 554k
w32api 1,182k

groff 1,991k
less 79k

bzip2 407k
cygutils 182k
patch 55k

wget 470k

f) Press Next.

8. Create Icons
a) Decide whether you want the cygwin installer to put a shortcut on your desktop.
b) Decide whether you want the cygwin installer to add an icon to your start menu.
c) Press Finish.

Spoiler for Cygwin Installer - Create Icons:

9. Toolchain Setup
a) Open cygwin and type the following and press Enter after each line:

echo "export PSPDEV=/usr/local/pspdev" >> ~/.bashrc
echo "export PATH=\$PATH:\$PSPDEV/bin" >> ~/.bashrc

Replace ~/.bashrc with /etc/bash.bashrc to setup for all user profiles.

b) Close cygwin and reopen it
c) Type the following and press Enter after each line

svn co svn://svn.ps2dev.org/psp/trunk/psptoolchain
cd psptoolchain
./toolchain.sh

d) Once the toolchain script is finished running it will say something like

"make[1]: Leaving directory ..."

OR (more likely)

"make: *** [all] Error 2
../scripts/009-psplinkusb.sh: Failed."

This just means that the PC side remotejoy tool couldn't be compiled because it didn't find the (Linux-specific) headers. This is no problem, because remotejoy is only an optional tool and can be compiled correctly later on. To properly finish compilation of psplink, type the following and press Enter after each line:

cd build/psplinkusb
make && make release

10. Done!
Congratulations, you now have a PSP Development Environment set up. :)

Other tutorials/information on how to setup a PSP Development Environment:
http://tinmanx.com/Windows_PSP_SDK_Guide.html
http://wiki.ps2dev.org/psp:toolchain
http://wiki.ps2dev.org/psp:programming_faq
http://www.psp-programming.com/code/...c:cygwin_in_10
http://www.lan.sh/showthread.php?t=366

[PSPJunkie_]

Nice, hopefully no more damn threads about this.

[EvilSeph]

Yeah. I got sick of those because they were all wrong. :\

About 9b, I couldn't get a screenshot because I already have the toolchain installed and refuse to re-do it just to get a screenshot for this guide. :P

If anyone has a screenshot showing the ending lines of the toolchain script:

make[1]: Leaving directory '/tmp/pspdev/pspsdk

Please upload it or something and I'll add it to this guide.

[Xylem]

Good job. But if i had used this method, it would have taken me 10 hours (no offense). But look at my sig.

[EvilSeph]

OK, I've looked at your sig. I don't see your point?

This doesn't take long. But that really depends on a lot of things. Like how much ram you have, how well configured your OS is, what's the speed of your processor, what's the speed of your internet...

It took me +/- 1 hour to do all of that, using my guide.

Please elaborate.

[MexicanSnake]

Thanx Im going to setup today .

[PSPJunkie_]

< 30 Minutes for me! Anyone want to guess why?

[EvilSeph]

Not cygwin? Cygwin files already downloaded? Too many possibilities.

[PSPJunkie_]

MAC!!!!!!!!!!!

hehe. I thought you knew that from IRC.

[EvilSeph]

Oh...well really it doesn't make too much of a difference. It still depends on your system specifications.

[JLTate]

Well, after I run ./toolchain.sh it ends with

mkdir -p -- ./libiberty
Configuring in libiberty
configure: error: invalid feature name: install-libbfd
make: *** [configure-libiberty] Error 1
ERROR BUILDING BINUTILS

Administrator@hydra ~/psptoolchain
$

[andyauff]

Thanks for the great guide, but I have a question. Where exactly do we click to install the packages? It seems like they are already set to install because when I click they either go to what seems like another version or to 'skip'. Thanks.

[Mr305]

Is it possible to update the toolchain [It's already installed and runs fine] without running ./toolchain.sh ?

I heard about some recent fixes in svn!

I expect a prompt reply!

[eldiablov]

i think to update it you do svn update

[Mr305]

Originally Posted by eldiablov

i think to update it you do svn update

I know, Do we need to resetup the toolchain?

[cloudpjff7]

I formatted my hard drive with cygwin running perfectly. Now when I install using this guide it doesn't work. I get:
ERROR: Please make sure you have 'automake' installed.
after I type in ./toolchain.sh

[k0ud]

i only got that error on pspdev

[eldiablov]

that automake thing is the biggest problem with alot of people. Luckily i've never had it.

[EvilSeph]

Originally Posted by Mr305

Is it possible to update the toolchain [It's already installed and runs fine] without running ./toolchain.sh ?

I heard about some recent fixes in svn!

I expect a prompt reply!

svn update within the psptoolchain directory, then ./toolchain.sh -p

This will download and build the latest version of PSPSDK for you.

still takes long, but not as long as it would running the whole script.

[Merick]

I just tried to install, and I'm also getting

ERROR: Please make sure you have 'automake' installed.

when I try to run the ./toolchain.sh

[yaustar]

For all people with the automake problem.

Read step 7b of this tutorial or step 7 of 0x89's tutorial:
http://insomniac.0x89.org/index.php?id=56

[eldiablov]

evilseph my cygwin is just not working. I installed it on D drive and i changed my cywgin.bat to this


@echo off

D:
chdir D:\cygwin\bin

set path=%path%;D:\cygwin\usr \local\pspdev\bin
set PSPSDK=D:\cygwin\usr\loca l\pspdev

bash --login -i


But it just doesnt work at all when im trying to compile zlib or any other lib

[Merick]

Originally Posted by yaustar

For all people with the automake problem.

Read step 7b of this tutorial or step 7 of 0x89's tutorial:
http://insomniac.0x89.org/index.php?id=56

Still doesn't work. I even tried setting the installer to install every single package, and even then it wouldn't work

[eldiablov]

Oh well i guess ill try and make space on C drive and do it again.

[yaustar]

Originally Posted by Merick

Still doesn't work. I even tried setting the installer to install every single package, and even then it wouldn't work

I refuse to believe that it didn't work. I followed 0x89's tutorial to the T and everything worked first time.

[EvilSeph]

No yaustar, it doesn't always work and I'm trying to determine why...the problem is, I have never encountered this problem and like being unable to reproduce a bug in a program, I can't really fix it.

[yaustar]

The 'other' solution is to host the automake tools for download.

[covandy01]

my cygwin is also on my D drive and i have edited the bat file as said still doesnt work... i keep reciveing the error:

make: psp-config: command not found
makefile:10: /lib/build.mak: no such file or directory
make: *** non rule to make target 'lib/build.mak'. Stop.

ive tried changing the make file to go straight to the director where build.mak is held buti keep recieving errors can anyone help?

[Merick]

I've tried re-doing this several times, installing, uninstalling, reinstalling sometime the whole thing, and sometimes just the make/automake packages, but when I get to the part to runt the toolchain.sh script, it always tells me that I don't have automake installed

[JLTate]

This error:

Originally Posted by JLTate

Well, after I run ./toolchain.sh it ends with

mkdir -p -- ./libiberty
Configuring in libiberty
configure: error: invalid feature name: install-libbfd
make: *** [configure-libiberty] Error 1
ERROR BUILDING BINUTILS

Administrator@hydra ~/psptoolchain
$

seems to be caused by a lack of disk space! I changed the BUILDDIR variable in the script so that it would go on a different partition than where Cygwin set my /usr/tmp to and it suddenly started working. Who knew.
Anyway, I got my tool chain compiled and functional after only uhh... 72 hours, probably. Hooray!