Skip to content

README.md

Latest commit

 

History

History
140 lines (95 loc) · 5.92 KB

README.md

File metadata and controls

140 lines (95 loc) · 5.92 KB
Raw

ps2dev

GitHub Workflow StatusGitHub Workflow StatusDocker Pulls

ATTENTION

If you are confused on how to start developing for PS2, see the getting started section on the ps2dev main page.

Overview

Main PS2 Repo for building the whole PS2 Development environment on your local machine.

This program will automatically build and install the whole compiler and other tools used in the creation of homebrew software for the Sony PlayStation® 2 videogame system.

Prebuilt binaries of the environment are also automatically compiled and uploaded using this program.

What these scripts do

These scripts download (git clone) and install:

Requirements

  1. Install gcc/clang, make, cmake, patch, git, texinfo, flex, bison, gettext, wget, gsl, gmp, zlib, mpfr and mpc if you don't have those packages.
  • Ubuntu
sudo apt -y install gcc g++ make cmake patch git texinfo flex bison gettext libgsl-dev libgmp3-dev libmpfr-dev libmpc-dev zlib1g-dev autopoint
  • Fedora/CentOS
sudo dnf -y install gcc make cmake patch git texinfo flex bison gettext gmp-devel mpfr-devel libmpc-devel zlib-devel
  • Alpine
apk add build-base cmake git texinfo flex bison gettext gmp-dev mpfr-dev mpc1-dev zlib-dev
  • Void
sudo xbps-install -Su mpfr libmpc-devel base-devel bison gettext gettext-devel-tools texinfo gmp-devel gsl-devel zlib-devel cmake patch git boost-devel boost
  • Arch
sudo pacman -S mpfr mpc mpd base-devel bison gettext texinfo gmp gsl zlib cmake patch git boost
  1. Optional. If you are upgrading from the previous version of the PS2DEV environment, it is highly recommended to remove the content of the PS2DEV folder before upgrade. This is a necessary step after the major toolchain upgrade.
sudo rm -rf $PS2DEV
  1. Ensure that you have enough permissions for managing PS2DEV location (which defaults to /usr/local/ps2dev, but you can use a different path if not using the precompiled toolchain). PS2DEV location MUST NOT have spaces or special characters in its path! PS2DEV should be an absolute path. On Unix systems, if the command mkdir -p $PS2DEV fails for you, you can set access for the current user by running commands:
export PS2DEV=/usr/local/ps2dev
sudo mkdir -p $PS2DEV
sudo chown -R $USER: $PS2DEV
  1. Add this to your login script (example: ~/.bash_profile) Note: Ensure that you have full access to the PS2DEV path. You can change the PS2DEV path with the following requirements: only use absolute paths, don't use spaces, only use alphanumeric characters.
export PS2DEV=/usr/local/ps2dev
export PS2SDK=$PS2DEV/ps2sdk
export GSKIT=$PS2DEV/gsKit
export PATH=$PATH:$PS2DEV/bin:$PS2DEV/ee/bin:$PS2DEV/iop/bin:$PS2DEV/dvp/bin:$PS2SDK/bin
  1. Optional. To install the precompiled toolchain, perform the following

If your Linux distro or MacOS is up to date, run this:

curl -o ps2dev-latest.tar.gz -LC - https://github.com/ps2dev/ps2dev/releases/download/latest/ps2dev-$(if [[ "$OSTYPE" == "darwin"* ]]; then echo macos; else echo ubuntu; fi)-latest.tar.gz
tar -xf ps2dev-latest.tar.gz --strip-components 1 -C $PS2DEV

If you're on Raspberry Pi OS, run this:

curl -o ps2dev-latest.tar.gz -LC - https://github.com/ps2dev/ps2dev/releases/download/latest/ps2dev-ubuntu-22.04-arm.tar.gz
tar -xf ps2dev-latest.tar.gz --strip-components 1 -C $PS2DEV

There are also precompiled toolchains for Windows (x86), MacOS 13 and Linux 24.04 (ARM, GLIBC 3.28) at https://github.com/ps2dev/ps2dev/releases

  1. Optional. To build and install the toolchain from source, clone the repository, then run build-all.sh
git clone https://github.com/ps2dev/ps2dev.git
cd ps2dev
./build-all.sh
  1. "Optional.* To use mips64r5900el-ps2-elf-pkg-config in your Makefile/CMakeLists.txt if you downloaded PS2DEV from GitHub Actions.
sed -i'' "s|/__w/ps2dev/ps2dev/ps2dev/ps2sdk/ports|${PS2SDK}/ports|g"   "$PS2SDK"/ports/lib/pkgconfig/*.pc
sed -i'' "s|/__w/ps2dev/ps2dev/ps2dev/ps2sdk/ports|${PS2SDK}/ports|g"   "$GSKIT"/lib/pkgconfig/*.pc
sed -i'' "s|/__w/ps2dev/ps2dev/ps2dev/gsKit|${GSKIT}/|g"   "$GSKIT"/lib/pkgconfig/*.pc

Container image generation

This repo also uses CI/CD to create a container image, compatible with Docker and Podman, called ps2dev/ps2dev:latest per change. This is useful if you're a developer that wants to create/port an application to the PS2. You can compile your project using this container image.

Extra steps

If you want, you can JUST install the extra dependencies ps2client and ps2-packer. To achieve this, execute the following:

./build-extra.sh

macOS

If you download the pre-built macOS binaries and get a security error such as "ps2client" cannot be opened because the developer cannot be verified., you can remove the quarantine attribute by running:

xattr -dr com.apple.quarantine path/to/prebuilt/ps2toolchain

Community

Links for discussion and chat are available here.

Thanks