readme.txt

PS2Dev Environment for Win32。用于SONY的Psp游戏机的Sdk开发包

PS2Dev Environment for Win32


:: Notes

DO NOT INSTALL INTO A DIRECTORY WITH SPACES IN THE DIRECTORY NAME!
this can result in problems when using the installed tools.

Due to conflicts between the dos commands and cygwin exe versions of
'rmdir', 'mkdir' and 'echo', i have renamed these files to 'cyg-rmdir',
'cyg-mkdir' and 'cyg-echo'. There are defines in the ps2sdk makefiles to
make use of these changed filenames, so please be sure to use $(ECHO), 
$(RMDIR), $(MKDIR) in your makefiles to use the correct versions of these.
You will also need to include 'Defs.make' from the ps2sdk root to use these
defines. (either $(PS2SDK)/Defs.make or $(PS2SDKSRC)/Defs.make depending on
whether you are compiling ps2sdk source or stuff that uses ps2sdk)

This installation does not include the required headers and libs to buid tools
for the pc. So if you make ps2sdk from its source i would suggest you change
the line at the top of the $(PS2SDKSRC)/Makefile to be:
	#SUBDIRS = tools iop ee common samples
	SUBDIRS = iop ee common samples

You should then create 'bin' folders in each of the tools' dirs and copy the
correcsponding exe file there as these files may be used during the build
process.

eg in $(PS2SDKSRC)/tools/bin2s, create the folder $(PS2SDKSRC)/tools/bin2s/bin
then copy bin2s.exe file from $(PS2SDK)/bin to $(PS2SDKSRC)/tools/bin2s/bin


:: Overview

This is an installable version of the PS2Dev compilers and associated tools.
It is based on the GCC v3.2.2 toolchain and patches as found on oopo's site
http://www.oopo.net/consoledev/
There are toolchains for EE, IOP, and DVP as well as ps2sdk libraries for
the EE and IOP projects.

I also added nervus' patch to gcc to enable error and warning output in the
MS VS.NET format. you can get it here: http://nervus.org/

This installer was made using NSIS v2.0, the free installer by nullsoft makers
of winamp. This can be found at http://nsis.sourceforge.net/

Lastly due to some problems with cygwin exe files i used make.exe and test.exe
from here: http://unxutils.sourceforge.net/


:: Installing

Run the installer to install and setup your PS2Dev environment.
To use the dev environment you need to set up some environment variables,
the installer can do this for you in a number of ways. Either by setting
the environment variables for the current user, for all users, or by
preparing a batch file that allows you to set them temporarily when needed.
For users who dont use multiple dev environment, setting the environment
variables for either all users or the current user will mean that the dev
environment is always set up and ready to go. However for those users who
may have conflicts with other cygwin tools or dev environments, a batch
file would be the preferred choice.

If installing in windows 9x/ME there is no difference between the current
user and all users setting. Also a reboot is required after selecting either
of these options.

If installing in windows NT/2K/XP/2K3 there IS a difference between the current
user and all users setting, however a reboot is not required.

If you choose to use a batch file, you need to run the batch file from
your command prompt before using any of the ps2dev tools. If you copy the
batch file to your path somewhere (such as your windows dir) then you can
call it from anywhere. If the batch file is in your path you can simply type:
'ps2dev' and you are ready to go.

When using the batch file, your ps2dev environment will only be valid in the
command prompt window that you typed 'ps2dev' in. Once that window is closed
or another window is opened, you must type 'ps2dev' again to setup your
temporary environment variables. You can safely use the dev tools in multiple
command prompt windows at once by typing 'ps2dev' in each window before using
the tools.

All the above options set up the same environment variables, these are:
PS2DEV=InstallDir
PS2SDK=%PS2DEV%/ps2sdk
PATH=%PATH%;%PS2DEV%/bin;%PS2DEV%/ee/bin;%PS2DEV%/iop/bin;%PS2DEV%/dvp/bin;%PS2SDK%/bin


:: Cygwin1.dll

This installer sets up a 'standalone' PS2Dev environment using compilers built
with cygwin. This means that the cygwin1.dll is needed in order to run the
executable files in this package. If a different version of this dll currently
exists on your computer then it may cause conflicts. If you get error messages
when trying to use these tools i suggest doing a search of your disks to find
all other versions of the cygwin1.dll and either remove them from your path,
rename them to cygwin1.dll.bak (in case you need it in the future) or just
delete it.

NOTE: cygwin compiled executables that use older versions of this dll will not
work with a newer or different version of the dll. You must use the dll from
the same cygwin version as the executables were compiled with.


:: Now get off your asses and dev something :)

any problems or errors either email me at [e-mail],
or ask on #ps2dev on efnet (may be on freenode now!)

thanks to all those in the homebrew ps2dev scene for making it what it is!