2019-07-02 02:19:08 +00:00
# DingusPPC by divingkatae
Be warned the program is highly unfinished and could use a lot of testing. Any feedback is welcome.
## PHILOSOPHY OF USE
2019-12-26 22:56:53 +00:00
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,
2019-07-02 02:19:08 +00:00
including those of the PowerMac G3 Beige.
2019-12-26 22:56:53 +00:00
2019-07-02 02:19:08 +00:00
## HOW TO USE
This program uses the command prompt to work.
There are a few command line arguments one can enter when starting the program.
-fuzzer
2019-07-19 06:31:16 +00:00
Processor fuzzer, very unfinished.
2019-07-02 02:19:08 +00:00
-realtime
2019-07-19 06:31:16 +00:00
Run the emulator in runtime.
2019-07-02 02:19:08 +00:00
-loadelf
2019-07-19 06:31:16 +00:00
Load an ELF file into memory.
2019-07-02 02:19:08 +00:00
2019-07-19 06:31:16 +00:00
-debugger
2019-07-02 02:19:08 +00:00
2019-07-19 06:31:16 +00:00
Enter the interactive debugger.
2019-07-02 02:19:08 +00:00
2019-07-07 06:10:32 +00:00
-stepp
2019-07-02 02:19:08 +00:00
2019-07-19 06:31:16 +00:00
Execute a page of opcodes (256 instructions at a time).
2019-07-02 02:19:08 +00:00
-playground
2019-12-26 22:56:53 +00:00
allows users to enter 32-bit hex opcodes to mess with the PPC processor.
## HOW TO COMPILE
You'll need to install development tools first.
At least, a C++ compiler and [CMake ](https://cmake.org ) 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
```
You may specify another build type using the variable CMAKE_BUILD_TYPE.
2019-07-02 02:19:08 +00:00
Due to the incomplete status of the program at this time, no additional libraries are required.
2019-12-26 22:56:53 +00:00
2019-07-02 02:19:08 +00:00
Future versions will include SDL 2 as a requirement.
2019-12-26 22:56:53 +00:00
2019-07-02 02:19:08 +00:00
## Intended Minimum Requirements
2019-12-26 22:56:53 +00:00
2019-07-02 02:19:08 +00:00
- 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
2019-07-15 00:05:10 +00:00
- 2 GB of RAM
- 2 GB of Hard Disk Space
2019-07-02 02:19:08 +00:00
- Graphics Card with a minimum resolution of 800*600
2019-12-26 22:56:53 +00:00
2019-07-02 02:19:08 +00:00
## Compiler Requirements
2019-12-26 22:56:53 +00:00
2019-07-02 02:19:08 +00:00
- GCC 4.7 or newer (i.e. CodeBlocks 13.12 or newer)
- Visual Studio 2013 or newer
