dolphin/Source/DSPSpy
Pokechu22 51c26d82a5 DSPSpy: Require user to specify a test_main label
This makes the point where execution starts more obvious compared to a start_of_test label at the end of the include, and allows putting other functions at the start of the file.  This change also modifies the existing tests to build with this change.
2021-08-22 10:49:46 -07:00
..
templates tstaxh SR 2009-08-13 16:13:49 +00:00
tests DSPSpy: Require user to specify a test_main label 2021-08-22 10:49:46 -07:00
util dspspy: fix a bug with ConsoleHelper 2009-08-16 00:37:01 +00:00
.gitignore DSPSpy: Create .gitignore 2021-08-21 17:07:14 -07:00
ConsoleHelper.h treewide: convert GPLv2+ license info to SPDX tags 2021-07-05 04:35:56 +02:00
DSPSpy.vcproj DSPSpy: Remove unused stubs 2019-12-30 13:33:43 +01:00
DSPSpy.vcxproj DSPSpy: Remove unused stubs 2019-12-30 13:33:43 +01:00
DSPSpy.vcxproj.filters DSPSpy: Remove unused stubs 2019-12-30 13:33:43 +01:00
Makefile DSPSpy: Remove build.sh and sbuild.sh 2021-08-21 17:07:14 -07:00
README.md DSPSpy: Create README.md 2021-08-21 17:07:14 -07:00
dsp_interface.cpp treewide: convert GPLv2+ license info to SPDX tags 2021-07-05 04:35:56 +02:00
dsp_interface.h treewide: convert GPLv2+ license info to SPDX tags 2021-07-05 04:35:56 +02:00
dspregs.h treewide: convert GPLv2+ license info to SPDX tags 2021-07-05 04:35:56 +02:00
gba.txt DSPSpy: save and restore $sr properly 2020-06-08 04:21:41 +01:00
main_spy.cpp DSPSpy: fix $prod printing 2021-07-25 15:15:15 +01:00
mem_dump.h treewide: convert GPLv2+ license info to SPDX tags 2021-07-05 04:35:56 +02:00
real_dsp.cpp treewide: convert GPLv2+ license info to SPDX tags 2021-07-05 04:35:56 +02:00
real_dsp.h treewide: convert GPLv2+ license info to SPDX tags 2021-07-05 04:35:56 +02:00

README.md

DSPSpy

DSPSpy is a homebrew tool for experimenting with the GameCube/Wii DSP. It can also be used to dump the DSP ROMs.

Building

DSPSpy is built using devkitPPC; see the devkitPro getting started page for more information. DSPSpy also requires DSPTool to be built.

First, run DSPTool to generate dsp_code.h, for instance from tests/dsp_test.ds. The following commands assume an x64 Windows setup running in the DSPSpy directory:

../../Binary/x64/DSPTool.exe -h dsp_code tests/dsp_test.ds

To use the ROM-dumping code, run this:

../../Binary/x64/DSPTool.exe -h dsp_code util/dump_roms.ds

DSPTool can also generate a header for multiple DSP programs at the same time. First, create a file (in this example, it was named file_list.txt) with the following contents:

tests/dsp_test.ds
tests/mul_test.ds
tests/neg_test.ds

Then run:

../../Binary/x64/DSPTool.exe -h dsp_code -m file_list.txt

After dsp_code.h has been generated, simply run make to generate dspspy_wii.dol, which can be loaded by normal means.

Dumping DSP ROMs

Build DSPSpy with util/dump_roms.ds. When launched, DSPSpy will automatically create files dsp_rom.bin and dsp_coef.bin on the SD card (only SD cards are supported); DSPSpy can be exited immediately afterwards.