Created Installation methods (markdown)
parent
fa9878d4a8
commit
6efe40b661
93
Installation-methods.md
Normal file
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.
|
Loading…
Reference in New Issue
Block a user