Tutorial: Setting up the Psy-Q SDK under modern Linux

[prochazkaml]

I haven't been able to find any good tutorial on how to get the Psy-Q SDK running under Linux, so after a bit of trial and error I got it working well enough that this Hello world example now compiles, gets packaged into a disc image and runs all under modern Linux.

Step 1: Make sure you have Wine installed and all of the required dependencies for this project. On Debian-based systems, run:

Code: Select all

sudo apt-get install wine wget libtinyxml2-dev unzip git make cmake gcc g++

EDIT: wget has been added to the list of dependencies, due to the changes in step 5.

Step 2: Create a 32-bit Wine prefix for the Psy-Q SDK. Let's say you want to put it into ".psyq" in your home directory.

Code: Select all

export WINEPREFIX=$HOME/.psyq
export WINEARCH=win32
wine wineboot

Step 3: Download the Psy-Q SDK and extract it into your new Wine prefix.

Code: Select all

cd ~/.psyq/drive_c
unzip ~/Downloads/PSYQ_SDK.zip

Step 4: Download Orion's CPE2X and extract it to the Psy-Q's "bin" folder. This is necessary, because the original CPE2X is a 16-bit tool, which cannot be run under Wine.

Code: Select all

cd ~/.psyq/drive_c/psyq/bin
unzip ~/Downloads/cpe2x.zip
mv cpe2x/cpe2x.exe CPE2X32.EXE
rm -r cpe2x

Step 5: Install LameGuy64's mkpsxiso. This is necessary, because the original tool used for building CDs (BUILDCD) is a 16-bit tool.

EDIT: The following bit of code has been changed to download an earlier version of mkpsxiso, because its creators have made numerous changes to the project (since the time this post was originally written) which break compatibility with our example project (srcdir seems to be broken in the new version).

Code: Select all

cd ~/Downloads
wget https://github.com/Lameguy64/mkpsxiso/archive/refs/tags/v1.26.zip
unzip v1.26.zip
cd mkpsxiso-1.26
mkdir build
cd build
cmake ..
make
sudo cp bin_nix/mkpsxiso /usr/bin/

To instead pull the latest version of mkpsxiso (not recommended for our purposes) and don't mind messing with the newly introduced quirks, run the following:

Code: Select all

cd ~/Downloads
git clone https://github.com/Lameguy64/mkpsxiso
cd mkpsxiso
git submodule update --init --recursive
mkdir build
cd build
cmake ..
make
sudo cp mkpsxiso /usr/bin/

Step 6: Download my example project, extract it and compile it!

Code: Select all

cd ~/Downloads
unzip example.zip
cd example
./make.sh

If it throws an error, it is probably because it's just trying to launch the Mednafen emulator, which you might not have installed. If you are using something else (such as ePSXe or NO$PSX), just edit the run.sh file to launch that instead.

Well, that's it, now you should have a fully-working Psy-Q building environment!

[elatronion]

This is a wonderfully well explained tutorial!
Very helpful indeed, worked first try without any hassle.

[prochazkaml]

Thank you, I''m glad to hear that!