An experimental emulator
Go to file
joevt 8d7ca7fb03 scsibus: Use bus name in log messages. 2024-04-22 07:50:01 -07:00
.github CI 2024-04-09 12:56:06 +03:00
benchmark Clean up build scripts. 2023-01-08 23:29:25 +01:00
cmake Make Emscripten build not depend on SDL2 or cubeb 2023-10-25 22:25:53 -07:00
core Continued build fixing 2024-03-16 19:24:40 -07:00
cpu/ppc ppcmmu: Remove last_dma_area. 2024-04-21 09:13:42 -07:00
debugger debugger: Auto increment after disassemble. 2024-03-11 07:13:40 -07:00
devices scsibus: Use bus name in log messages. 2024-04-22 07:50:01 -07:00
machines machinepippin: connect Taos. 2024-04-22 00:15:29 +02:00
thirdparty Update loguru from the master branch 2023-12-11 07:45:51 -07:00
utils Move disk image reading to be behind an ImgFile class 2023-11-09 21:49:28 -08:00
zdocs Added a note for the 603 2024-04-21 11:11:56 -07:00
.clang-format clang-format everything 2020-05-12 23:55:45 +05:00
.gitignore Update gitignore for CodeLite project files 2023-12-01 16:11:32 -07:00
.gitmodules Add Capstone submodule. 2020-12-03 00:53:28 +01:00
CMakeLists.txt Updating CMakeLists file 2024-02-21 06:32:24 -07:00 CONTRIBUTING: Use code blocks for code examples. 2020-03-05 11:53:28 +01:00 Initial expansion of documentation 2024-04-21 08:44:03 -07:00
LICENSE Initial commit 2019-07-01 19:13:30 -07:00 README: Grammar. 2024-04-01 18:23:39 -07:00
dppcicon.ico More fixes, plus a temp icon 2019-07-19 14:24:39 -07:00
endianswap.h endianswap: Add parenthesis around macros. 2024-02-11 07:40:42 -07:00
icon.png Initial preparation for a release 2024-04-15 07:01:51 -07:00
icon.rc More fixes, plus a temp icon 2019-07-19 14:24:39 -07:00
main.cpp Initial preparation for a release 2024-04-15 07:01:51 -07:00
main.h Make Emscripten build not depend on SDL2 or cubeb 2023-10-25 22:25:53 -07:00
main_sdl.cpp Remap Cocoa/macOS menu item key modifiers 2023-10-29 12:16:01 -07:00
main_sdl.m Revert "Add a basic mouse grab mode when running on macOS" 2023-12-19 13:15:10 +01:00
memaccess.h memaccess: Add addr type cast. 2024-04-09 21:19:04 -07:00
vcpkg.json Manage Windows build dependencies with vcpkg. 2023-01-08 22:27:13 +01:00


Written by divingkatae and maximumspatium

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

Philosophy of Use

While many other PowerPC emus exist (PearPC, Sheepshaver), none of them currently attempt emulation of PowerPC Macs accurately (except for QEMU).

This program aims to not only improve upon what Sheepshaver, PearPC, and other PowerPC Mac emulators have 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 Power Mac 6100, 7200, and G3 Beige.

Implemented Features

This emulator has a debugging environment, complete with a disassembler. We also have implemented enough to allow Open Firmware to boot, going so far as to allow audio playback of the boot-up jingles.

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.

-r, --realtime

Run the emulator in runtime.

-d, --debugger

Enter the interactive debugger.

-b, --bootrom TEXT:FILE

Specifies the Boot ROM path (optional; looks for bootrom.bin by default)

-m, --machine TEXT

Specify machine ID (optional; will attempt to determine machine ID from the boot rom otherwise)

As of now, the most complete machines are the Power Mac 6100 (SCSI emulation in progress) and the Power Mac G3 Beige (SCSI + ATA emulation in progress, No ATI Rage acceleration).

How to Compile

You need to install development tools first.

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

You will also have to recursive clone or run

git submodule update --init --recursive

This is because the CubeB, Capstone, and SDL2 modules are not included by default.

For SDL2, Linux users may also have to run:

sudo apt install libsdl2-dev

CLI11 and loguru are already included in the thirdparty folder and compiled along with the rest of DingusPPC.

For example, to build the project in a Unix-like environment, you will 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.

For Raspbian, you may also need the following command:

sudo apt install doxygen graphviz


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
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

  • Any C++20 compatible compiler