Tutorial: Setting up the Psy-Q SDK under modern Linux
Posted: January 22nd, 2021, 1:32 am
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:
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.
Step 3: Download the Psy-Q SDK and extract it into your new Wine prefix.
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.
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).
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:
Step 6: Download my example project, extract it and compile it!
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!
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++
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
Code: Select all
cd ~/.psyq/drive_c
unzip ~/Downloads/PSYQ_SDK.zip
Code: Select all
cd ~/.psyq/drive_c/psyq/bin
unzip ~/Downloads/cpe2x.zip
mv cpe2x/cpe2x.exe CPE2X32.EXE
rm -r cpe2x
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/
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/
Code: Select all
cd ~/Downloads
unzip example.zip
cd example
./make.sh
Well, that's it, now you should have a fully-working Psy-Q building environment!