ref: 20b785907dc9b7221818da0e23b46360c55e8358
dir: /README.md/
# psx A simple and portable Sony PlayStation emulator and emulation library written in C ## Running To run the emulator, you will need a BIOS file, `SCPH1001.bin` specifically, you can either get it from the internet or [dump it from your own console](https://www.youtube.com/watch?v=u8eHp0COcBo). Just put it in the same directory where the executable is located in. I will write a CLI parser really soon though, you will be able to just specify the location of the BIOS or a search folder. Other BIOSes aren't currently supported, though I've only tested `SCPH1000.bin` so far. ## Progress Here's a list of what's currently implemented: - All CPU instructions, excluding GTE - CPU quirks (Branch, Load delay slots) - Bus structure - OTC DMA (Burst), GPU DMA (Request, Linked) - Several GPU registers - GPU commands used by the BIOS - Some CDROM commands (`Test`, `Getstat`) ## Screenshots | Windows | Ubuntu | | ------------- | ------------- | |  |  | ## Building Building the emulator should be easy, just use the scripts provided in this repo. On Windows, the `build-deps.ps1` script downloads SDL2, unzips it, and copies `SDL2.dll` to the root folder, if you want to run the emulator standalone, you'll have to move the SDL2 DLL to the same folder where the executable is located. **If you already have SDL2 on your system**, you can skip running the `build-deps.ps1` script. Though you will have to edit the `build-win.ps1` script to point the `SDL2_DIR` variable to your installation path. On Ubuntu, you'll also need to install SDL2 development package, you can get it from `apt` like so: ``` sudo apt update sudo apt upgrade sudo apt install libsdl2-dev ``` Assuming you did everything described above, you should be able to build the emulator running the following commands. ### Windows ``` git clone https://github.com/allkern/psx cd psx ./build-deps ./build-win.ps1 ``` If the `build-win.ps1` script fails for whatever reason (*cough* Microsoft *cough*), you can try using the `build-win.bat` (notice the extension) script instead. If this also doesn't work for you, please open an issue on the Issues tab ### Ubuntu ```c git clone https://github.com/allkern/psx cd psx make clean && make ```