sizious/dcdis

dcdis is a very simple Sega Dreamcast disassembler.

Sega Dreamcast Disassembler (dcdis)

dcdis is a very simple Sega Dreamcast(tm) disassembler initially made by Lars Olsson (Maiwe).

This tool produces text files which contains all the disassembled code of any Sega Dreamcast binary executable. The Dreamcast's CPU, a Hitachi SH7091, is virtually identical to the Renesas SH7750 series of SH4 CPUs. dcdis will produces a disassembled text file containing SH7091/SH7750 instructions.

Note: This utility only supports the binary format, all others file format are unsupported, including SREC or ELF file formats.

Building & installing

You have 2 modes to build and install dcdis:

1. KallistiOS mode
2. Standalone mode

KallistiOS Mode

Starting from v1.0.0, dcdis is ready to be integrated in a KallistiOS installation, in the utils directory. The Makefile located in the root directory is designed for that use case.

Input the following to install dcdis in your KallistiOS utilities directory:

git clone https://github.com/sizious/dcdis.git ${KOS_BASE}/utils/dcdis
cd ${KOS_BASE}/utils/dcdis
make

The dcdis binary will be installed in the /opt/toolchains/bin/ directory.

Standalone Mode

If you want to use dcdis in a standalone mode, i.e. without KallistiOS, then you may do it by following instructions of this section. You just need a working GCC toolchain in order to do that.

In that case, for most machines and configurations, the following is all you need:

cd src
./configure
make
make install

In standalone, i.e. in manual installation mode, dcdis will be installed in /usr/local/bin by default, but this can be altered by specifying another location to configure using this formula:

./configure --prefix=/installation/directory

Usage & features

The usage of dcdis is very simple, it can be used as the follow:

dcdis [options] <dcprog.bin>

The following options are supported:

-b<address>    binary file, text start (default: 0x8c010000)
-o<filename>   file to write output to (default: stdout)
-s<filename>   use Sega Katana MAP file
-d             standard displacement

<filename>     file to disassemble

Acknowledgments

• Lars Olsson (Maiwe): Initial maker of this tool;
• Moopthehedgehog: Port to modern ANSI C.
• SiZiOUS: Additional improvements and fixes.

License

dcdis is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the LICENSE file for more information.