Installation guide[top|sitemap|download|docs]

Installation guide

You need a linux distribution which uses the RedHat package manager (RPM) unless you want to compile and install PSXDEV from the source tarballs (which is only recommended for very experienced users).

A good choice for a distribution is of course RedHat linux or one of its distribution clones like Haloween, Mandrake, Go!Linux, etc. The very well known german linux distribution SuSE has IMHO a very bad RPM support and PSXDEV has not been tested with this distribution.

It is also required that the linux kernel source code is installed in /usr/src/linux and that your currently installed kernel was compiled from that sources. During the installation of PSXDEV-CORE the PSXDEV kernel device driver will be compiled and installed as a loadable kernel module, so you must have your kernel configured with support for that. To check that, start your kernel configuration utiltiy (i.e. make menuconfig) and check these settings:

  • Loadable module support
    • Enable loadable module support: YES
    • Set version information on all symbols for modules: YES
    • Kernel module loader: YES
Again, the kernel source is expected in /usr/src/linux, this is typically a symbolic link to the real location. If the kernel source is not present the installation will fail!

Installing PSXDEV from binary RPMS

Starting with PSXDEV 2.0.0 the installation can be much more customized. First you have to decide what components you need. Choose your packages from the following sets:

Basis

  • psxdev-core - always needed
  • psxdev-libs - shared libraries
  • psxdev-tools - communication tools
If you want to write own applications for PSXDEV, you'll also need the psxdev-libs-devel package. Otherwise it's not needed.

Programming

  • psxdev-gcc - C/C++/Java/Fortran/Chill compiler
  • psxdev-binutils-elf - assembler, linker, etc. for ELF linker format
  • psxdev-binutils-ecoff - assembler, linker, etc. for ECOFF linker format
You don't want ELF unless you know what you're doing. ECOFF and ELF mutually exclude each other, you can't use both together! However, you can uninstall and reinstall them on the fly. ELF is the choice if you want to program for PS2. Hint: you should use the official patches for PS2, not mine

Graphics

  • psxdev-tools-for-images - shell conversion commands
  • psxdev-gimp - GIMP plug-ins
The GIMP plug-ins compile themself during RPM installation and need the psxdev-libs-devel package temporarily installed. After psxdev-gimp installation you can uninstall the psxdev-libs-devel package if you like to.

Audio

  • psxdev-tools-for-audio - shell conversion commands
There's nothing special. Just record, replay and conversion.

Debugging and extras

  • psxdev-curvegen - discrete curve generator
  • psxdev-debugger - visual assembler debugger
  • psxdev-interactor - modify variables in realtime

CD-ROM creation

  • psxdev-cdmaker - CD-ROM mastering and burning frontend
This package still needs CDRDAO being installed. Search the internet for a CDRDAO RPM package and install it or override the installation.

  1. Now download all PSXDEV binary RPMS you need
  2. Open a shell and change to the download directory
  3. Install the RPMS by typing
    shell> rpm -Uvh psxdev-*.rpm

psxdev-binutils-ecoff       ##################################################
psxdev-core                 ##################################################
psxdev-docs                 ##################################################
psxdev-gcc                  ##################################################
psxdev-libs                 ##################################################
psxdev-tools                ##################################################
This is an example output! This has been tested with a plain RedHat 6.0 installation.

Installing PSXDEV from source RPMS

You can install the source RPMS only in this order, because of the dependencies between the packages!
  1. psxdev-core
  2. psxdev-libs
  3. psxdev-binutils (elf or ecoff)
  4. psxdev-tools
  5. psxdev-gcc
  6. psxdev-apps
  7. psxdev-sdk
  8. psxdev-docs
For all packages in that list do (you must be superuser)
  • rpm --rebuild <source package>
    After that the newly created binary RPM can be found in the RPMS/i386/ subtree of your RPM build directory, typically /usr/src/redhat/RPMS/i386.
  • rpm -Uvh <binary package>
    This is necessary because of the package dependencies.
Some source packages will spit out more than one binary RPM, like tools, apps and libs.

Installing PSXDEV from source TARBALLS

CORE

Download the psxdev-core-???.tar.gz archive. Then unpack it to a temporary directory and change into psxdev-core-???. Become root and choose a location for PSXDEV. The recommended location is /opt/psxdev, but you can also use /usr/local or anything else. The location should be owned by root. Run ./install /opt/psxdev to install the core into /opt/psxdev. This also compiles and installs the device driver; you need a linux kernel source version 2.1 or higher and you kernel should be compiled with loadable modules support. Note: You need to modify your $PATH and $LD_LIBRARY_PATH variables to point to $PSXDEV/bin and $PSXDEV/lib. You should use the psxdev.sh script which has been generated by the ./install script. Normally you want to place this script with executable permission in /etc/profile.d/ script directory (i.e. RedHat Linux).

DOCS

Just change to the $PSXDEV base directory and unpack the .tar.gz archive. You will find the documentation files in the doc and public_html subdirectores.

LIBS

Download the psxdev-libs-???.tar.gz archive. Then unpack it to a temporary directory and change into psxdev-libs-???. Check if the $PSXDEV variable points to the correct location. Become root and repeat the following for all sub directories:

    ./configure --with-library-version=?.?.?--prefix=$PSXDEV --exec-prefix=$PSXDEV
    make
    make install
This will build and install all the static and shared libraries and the header files into the $PSXDEV hierarchy. The --with-library-version=?.?.? lets you choose the version number for the shared library. This is a maintainer option! If you omit it, a 1.0.0 version will be generated.

BINUTILS

Next, you need to install the GNU binutils, because the psxdev-tools depends on it. Download and unpack psxdev-binutils-???.tar.gz. You will find a new .tar.gz file and a .patch file. Perform the following steps:

    tar zxvf psxdev-binutils-???.tar.gz
    cd psxdev-binutils-??? patch -p1 < psxdev-binutils-???.patch
    mkdir psx
    cd psx
    ../configure --prefix=$PSXDEV --exec-prefix=$PSXDEV --enable-shared --enable-commonbfdlib --with-mmap --target=psx
    make
    make install

TOOLS

The same as above for psxdev-tools-???.tar.gz. Unpack and

    ./configure --prefix=$PSXDEV --exec-prefix=$PSXDEV
    make
    make install

GCC

Download and unpack psxdev-gcc-???.tar.gz. You will find a new .tar.gz file and a .patch file. Perform the following steps:

    tar zxvf psxdev-gcc-???.tar.gz
    cd psxdev-gcc-???
    patch -p1 < psxdev-gcc-???.patch
    mkdir psx
    cd psx
    ../configure --prefix=$PSXDEV --with-gnu-as --with-gnu-ld --exec-prefix=$PSXDEV --target=psx
    make install

APPS

Download and unpack psxdev-apps-???.tar.gz. For each subdirectory repeat the following:

    ./configure --prefix=$PSXDEV --exec-prefix=$PSXDEV
    make
    make install

Congratulations! Installation complete.

Created with psxdev.pl
Copyright ©2000 by Daniel Balster