An experimental emulator
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
dingusdev f181e721b0 Fixed compilation for Visual Studio 1 week ago
.github Improve Github actions. 10 months ago
benchmark Clean up build scripts. 3 months ago
core pcihost: refactor data access helpers. 2 months ago
cpu/ppc ppcmmu: fix bug in mmu_change_mode(). 1 month ago
debugger Fix compiler warnings: cast loses precision. 3 months ago
devices Fix Cuda response protocol. 2 months ago
machines Standardize PCIDevice slot_id for PCIHost. 2 months ago
thirdparty Manage Windows build dependencies with vcpkg. 3 months ago
utils Fix forgotten include. 2 years ago
zdocs Grackle: Update readme. 2 months ago
.clang-format clang-format everything 3 years ago
.gitignore Ignore Xcode project files. 3 months ago
.gitmodules Add Capstone submodule. 2 years ago
CMakeLists.txt Fixed compilation for Visual Studio 1 week ago
CMakeSettings.json Started config file reading 3 years ago
CONTRIBUTING.md CONTRIBUTING: Use code blocks for code examples. 3 years ago
LICENSE Initial commit 4 years ago
README.md Open Firmware is two words 7 months ago
_config.yml Set theme jekyll-theme-minimal 3 years ago
dppcicon.ico More fixes, plus a temp icon 4 years ago
endianswap.h Clean up previous commit. 4 months ago
icon.rc More fixes, plus a temp icon 4 years ago
main.cpp Refactor MachineBase and MachineFactory classes. 8 months ago
memaccess.h Clean up previous commit. 4 months ago
vcpkg.json Manage Windows build dependencies with vcpkg. 3 months ago

README.md

DingusPPC

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 PPC 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 PowerMac 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, only the Power Macintosh G3 Beige is implemented.

How to Compile

You need to install development tools first.

At least, a C++11 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 module is not included by default. All other components 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.

Future versions may drop SDL 2 as a requirement.

For Raspbian, you may also need the following command:

sudo apt install doxygen graphviz

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