An experimental emulator
Go to file
dingusdev b16d1c43ef Set theme jekyll-theme-minimal 2020-03-26 23:30:27 -07:00
.github/ISSUE_TEMPLATE Update issue templates 2019-07-07 11:27:39 -07:00
cpu/ppc Initial attempt at fixing SDL2 building for Windows 2020-03-22 20:15:12 -07:00
debugger Initial attempt at fixing SDL2 building for Windows 2020-03-22 20:15:12 -07:00
devices Reduce logging when playing back audio. 2020-03-26 03:02:33 +01:00
machines Initial attempt at fixing SDL2 building for Windows 2020-03-22 20:15:12 -07:00
thirdparty Initial attempt at fixing SDL2 building for Windows 2020-03-22 20:15:12 -07:00
zdocs Documenation Update 3/7/2020 2020-03-07 15:40:46 -07:00
.gitignore Fixed gitignore to recognize directories 2020-01-04 10:07:05 -07:00
CMakeLists.txt Initial attempt at fixing SDL2 building for Windows 2020-03-22 20:15:12 -07:00
CMakeSettings.json Started config file reading 2020-03-26 12:32:24 -07:00
CONTRIBUTING.md CONTRIBUTING: Use code blocks for code examples. 2020-03-05 11:53:28 +01:00
LICENSE Initial commit 2019-07-01 19:13:30 -07:00
README.md Quick correction to the readme 2020-02-28 09:21:21 -07:00
_config.yml Set theme jekyll-theme-minimal 2020-03-26 23:30:27 -07:00
dppcicon.ico More fixes, plus a temp icon 2019-07-19 14:24:39 -07:00
endianswap.h Move endian swapping code to endianswap.h. 2020-01-12 22:51:37 +01:00
icon.rc More fixes, plus a temp icon 2019-07-19 14:24:39 -07:00
main.cpp Slight cleanup 2020-03-26 12:38:00 -07:00
memreadwrite.h ppcmmu: handle unaligned reads and writes. 2020-01-30 00:45:39 +01:00

README.md

DingusPPC by divingkatae

Be warned the program is highly unfinished and could use a lot of testing. Any feedback is welcome.

PHILOSOPHY OF USE

Sheepshaver, while technically impressive, is becoming harder to compile and run. While many other PowerPC emus exist, none of them currently attempt emulation of PPC Macs (except for QEMU).

This program aims to not only improve upon what Sheepshaver has done, but also to provide a better debugging environment. This currently is designed to work best with PowerPC Old World ROMs, including those of the PowerMac G3 Beige.

HOW TO USE

This program currently uses the command prompt to work.

There are a few command line arguments one must enter when starting the program.

-realtime

Run the emulator in runtime.

-debugger

Enter the interactive debugger.

HOW TO COMPILE

You'll need to install development tools first.

At least, a C++ compiler and CMake are required.

For example, to build the project in a Unix-like environment, you'll need to run the following commands in the OS terminal:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make dingusppc

You may specify another build type using the variable CMAKE_BUILD_TYPE.

Due to the incomplete status of the program at this time, only Loguru is needed to compile the program. It is already included in the thirdparty folder and compiled along with the rest of DingusPPC.

Future versions will include SDL 2 as a requirement.

Testing

DingusPPC includes a test suite for verifying the correctness of its PowerPC CPU emulation. To build the tests, use the following terminal commands:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make testppc

Intended Minimum Requirements

  • Windows 7 or newer (64-bit), Linux 4.4 or newer, Mac OS X 10.9 or newer (64-bit)
  • Intel Core 2 Duo or better
  • 2 GB of RAM
  • 2 GB of Hard Disk Space
  • Graphics Card with a minimum resolution of 800*600

Compiler Requirements

  • GCC 4.7 or newer (i.e. CodeBlocks 13.12 or newer)
  • Visual Studio 2013 or newer