Created Installation methods (markdown)

Schnappy 2021-07-10 12:38:11 +02:00
parent fa9878d4a8
commit 6efe40b661

93
Installation-methods.md Normal file

@ -0,0 +1,93 @@
#### MacOS
* On MacOs, a brew installation script can be found [here.](https://github.com/grumpycoders/pcsx-redux#macos)
#### Windows 10
* Native build :
Follow the [instructions here](https://github.com/grumpycoders/pcsx-redux#windows) to build pcsx-redux or download a pre-compiled [pcsx-redux binary here](https://github.com/grumpycoders/pcsx-redux/#where).
* Win 10 + WSL2 (needs GUI support):
Install WSL2 with GUI support and [Ubuntu 20.04](https://www.microsoft.com/en-gb/p/ubuntu-2004-lts/9n6svws3rx71?activetab=pivot:overviewtab) then launch a GNU/Linux terminal, then proceed with the following instructions.
* Alternatively on Windows, if you don't care about getting/compiling pcsx-redux, you can skip steps 1, 3 and 4, get the latest precompiled toolchain from here : [http://static.grumpycoder.net/pixel/mips/](http://static.grumpycoder.net/pixel/mips/), unzip it somewhere and [add the `bin` folder to your PATH](https://stackoverflow.com/questions/44272416/how-to-add-a-folder-to-path-environment-variable-in-windows-10-with-screensho#44272417). Then go on with steps 5 and 6.
#### GNU/Linux
1. Install the needed software packages ( aka dependencies in Linux world ) :
* To be able to build PsyQ code, you only need the MIPS toolchain :
```bash
sudo apt-get install gcc-mipsel-linux-gnu g++-mipsel-linux-gnu binutils-mipsel-linux-gnu
```
* If you want to compile pcsx-redux, you need a few more packages :
```bash
sudo apt-get install -y git make pkg-config clang g++ libfreetype6-dev libavcodec-dev libavformat-dev libavutil-dev libglfw3-dev libsdl2-dev libswresample-dev libuv1-dev zlib1g-dev
```
See [here](https://github.com/grumpycoders/pcsx-redux#gnulinux-dependencies) if you're using an Arch derivative.
2. Clone the pcsx-redux repo :
```bash
git clone https://github.com/grumpycoders/pcsx-redux.git --recursive
```
3. Enter pcsx-redux folder:
```bash
cd pcsx-redux
```
4. Compile pcsx-redux :
```bash
make
```
If you encounter an error due to an old version of GCC (< 10) like something about `-fcoroutines`, then you can use **clang** ( min version 9) to compile `pcsx-redux` :
```bash
CC=clang CXX=clang++ LD=clang++ make
```
5. Get the converted [PsyQ 4.7 libs](http://psx.arthus.net/sdk/Psy-Q/psyq-4.7-converted-full.7z) :
```bash
wget http://psx.arthus.net/sdk/Psy-Q/psyq-4.7-converted-full.7z
```
6. Extract this archive to `[...]pcsx-redux/src/mips/psyq/`, adapting the path ( the part after `-o`) in the command below to the folder you cloned pcsx-redux in :
```bash
7z x -o./src/mips/psyq/ psyq-4.7-converted-full.7z
```
Your `pcsx-redux/src/mips/psyq/` directory should now contain an `include` and a `lib` folder with a bunch of files in each of them :
```bash
$tree ~/pcsx-redux/src/mips/psyq/
.
├── include
│   ├── abs.h
│   ├── ...
│   ├── strings.h
│   └── sys
│   ├── errno.h
│   ├── ...
│   └── types.h
├── lib
│   ├── libapi.a
│   ├── ...
│   └── libtap.a
└── tree
3 directories, 82 files
```
7. That's it ! After that you can check everything's working by trying to compile some example code :
```bash
cd src/mips/psyq/cube
make
```
You should know have a 'cube.ps-exe' file in the folder. This is a PSX executable you can load with most emulators.