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

from Michal's blog

← Go back to the homepage


PlayStation development | Published 2021-01-21 14:32:23 UTC

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:

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

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.

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

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

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.

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. The following bit of code will pull an earlier version of mkpsxiso, because its creators have made numerous changes to the project (since the time this post was originally written on PSXDEV.net) which break compatibility with our example project (srcdir seems to be broken in the new version).

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/

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

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! 😁


In order to post a comment or reply to one, please log in or create a new account:



1 comment total, 1 shown | Page 1


elatronion (Archived from PSXDEV.net) | Posted on 2021-07-07 04:41:11 UTC

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

1 reply to this comment


1 comment total, 1 shown | Page 1 | Go back to the top