mirror of
https://github.com/PSI-Rockin/DobieStation.git
synced 2025-04-02 10:52:46 -04:00
114 lines
4.5 KiB
Markdown
114 lines
4.5 KiB
Markdown
# DobieStation
|
|
[](https://discord.gg/zbEXKfN)
|
|
[](https://github.com/PSI-Rockin/DobieStation/actions)
|
|
[](https://ci.appveyor.com/project/PSI-Rockin/dobiestation)
|
|
|
|
A young PS2 emulator with plans for an optimized Android port, as well as a fast, accurate, and easy-to-use PC port.
|
|
|
|
A large portion of the PS2's library can boot or get to menus. Some titles can even go in-game, including high-profile ones such as Final Fantasy X and Shadow of the Colossus. Not intended for general use.
|
|
|
|
## Compiling
|
|
DobieStation uses Qt 5 and supports qmake and CMake.
|
|
|
|
### Building with qmake
|
|
```
|
|
cd DobieStation/DobieStation
|
|
qmake DobieStation.pro
|
|
make
|
|
```
|
|
|
|
### Building with CMake
|
|
```
|
|
# Linux
|
|
mkdir build && cd build
|
|
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo
|
|
make
|
|
|
|
# MacOS (using Homebrew Qt5)
|
|
mkdir build && cd build
|
|
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_PREFIX_PATH=/usr/local/opt/qt5
|
|
make
|
|
|
|
# Windows (MSVC)
|
|
# - change 'CMAKE_PREFIX_PATH' to point to your Qt installation.
|
|
# - replace 'Visual Studio 16 2017' with your desired VS version (eg: "Visual Studio 16 2019")
|
|
mkdir build && cd build
|
|
cmake -DCMAKE_PREFIX_PATH="C:/Qt/5.13.1/msvc2017_64" \
|
|
-G "Visual Studio 15 2017" -A x64 ..
|
|
start DobieStation.sln
|
|
```
|
|
|
|
### Note for Ubuntu Xenial
|
|
While 16.04 is still officially supported they don't provide a recent enough version of Qt.
|
|
As such if you wish to build Dobie on Xenial you will need to update Qt through a PPA
|
|
```
|
|
add-apt-repository ppa:beineri/opt-qt-5.11.1-xenial
|
|
apt-get update
|
|
apt-get install qt511-meta-minimal qt511multimedia libglu1-mesa-dev
|
|
source /opt/qt511/bin/qt511-env.sh
|
|
```
|
|
Alternatively, you may upgrade to the most recent Ubuntu LTS, 18.04.
|
|
|
|
### Building with Visual Studio
|
|
DobieStation is known to compile on 2017 and 2019.
|
|
|
|
Before opening Visual Studio, you must set the `QTDIR` environment variable to your 64 bit QT install.
|
|
For example on Visual Studio 2017: `C:\path\to\qt\5.12.1\msvc2017_64`
|
|
|
|
Once the variable is set open `DobieStation\DobieStation.sln` in Visual Studio.
|
|
|
|
## Using the Emulator
|
|
DobieStation requires a copy of the PS2 BIOS, which must be dumped from your PS2.
|
|
|
|
The various command line options are as follows:
|
|
```
|
|
-b [BIOS file] - Takes the form of /path/to/bios.bin. Required for booting DobieStation.
|
|
-f [file] (optional) - The ELF or ISO that DobieStation loads. Takes the form of /path/to/game.iso or /path/to/homebrew.elf.
|
|
-s (optional) - Skip the BIOS boot animation when starting DobieStation with an ISO/ELF loaded.
|
|
```
|
|
|
|
The key bindings are as follows:
|
|
|
|
| Keyboard | DualShock 2 |
|
|
| ---------------- | ------------------ |
|
|
| <kbd>S</kbd> | Triangle |
|
|
| <kbd>A</kbd> | Square |
|
|
| <kbd>X</kbd> | Circle |
|
|
| <kbd>Z</kbd> | Cross |
|
|
| <kbd>Enter</kbd> | Start |
|
|
| <kbd>Space</kbd> | Select |
|
|
| <kbd>Q</kbd> | L1 |
|
|
| N/A | L2 |
|
|
| N/A | L3 |
|
|
| <kbd>W</kbd> | R1 |
|
|
| N/A | R2 |
|
|
| N/A | R3 |
|
|
| <kbd>↑</kbd> | D-pad up |
|
|
| <kbd>↓</kbd> | D-pad down |
|
|
| <kbd>←</kbd> | D-pad left |
|
|
| <kbd>→</kbd> | D-pad right |
|
|
| <kbd>R</kbd> | Left Analog up |
|
|
| <kbd>F</kbd> | Left Analog down |
|
|
| <kbd>D</kbd> | Left Analog left |
|
|
| <kbd>G</kbd> | Left Analog right |
|
|
| <kbd>I</kbd> | Right Analog up |
|
|
| <kbd>K</kbd> | Right Analog down |
|
|
| <kbd>J</kbd> | Right Analog left |
|
|
| <kbd>L</kbd> | Right Analog right |
|
|
|
|
| Keyboard | DobieStation |
|
|
| ------------- | -------------------------- |
|
|
| <kbd>F1</kbd> | Dump current frame from GS |
|
|
| <kbd>F8</kbd> | Take a screenshot |
|
|
| <kbd>.</kbd> | Advance a single frame |
|
|
|
|
### PS2 Homebrew
|
|
Want to test DobieStation? Check out this repository: https://github.com/PSI-Rockin/ps2demos
|
|
|
|
Compatibility not guaranteed, but some demos do work.
|
|
|
|
## Contributing
|
|
First, review the [Contribution Guide](../master/.github/CONTRIBUTING.md). Once you have done so, take a look at the issue tracker to look for tasks you may be interested in.
|
|
|
|
## Legal
|
|
DobieStation uses `arg.h` by [Christoph "20h" Lohmann](http://www.r-36.net).
|