Devkitppc setup (Linux)

From WiiBrew
Jump to: navigation, search

Installing through the repositories

It may be possible to install devkitPPC via your linux distro repositories. Try searching for devkitPPC MYDISTRO [1].

If you are using Ubuntu or Debian, there is a repository with .deb files maintained by UCLM university.

1. Add to sources.list file the lines

deb ./
deb ./
deb-src ./

2. Execute sudo apt-get update

3. Execute sudo apt-get install devkitpro-ppc

The files will be installed at /opt/devkitPro with read-only permission. You can do a copy of the examples directory in your user space and then compile and run in the normal way.

cp -r /opt/devkitPro/examples/ .
cd examples/wii/template
make run

Installing devkitPPC from DevkitPro packages

A premade archive of these files (organized according to the directory structure below) is available here

Note: The US mirror for DevkitPPC can be slow, so you might have to switch to a European one.
Note: Extract the files from the devkitPPC tarball using "tar -xvjf <file you downloaded>" to preserve symlinks, etc...
  • Create a folder for devkitpro and extract everything into it such that you have this directory structure:
  libogc (extract the libfat tar under this directory as well)
  • Edit ~/.bashrc and add
export DEVKITPRO=/path/to/devkitpro # replace this by your actual path
  • Optionally, find out your Wii's IP with the homebrew channel and add
export WIILOAD=tcp: # replace this by your Wii's IP
  • Restart your terminal or type
source ~/.bashrc

Compiling a Hello World

  • Enter devkitpro/wii-examples/template and simply type
  • To run the example on your Wii, start the homebrew channel and type
make run

Voilà! You just compiled your first Wii program!

Compiling Insight Debugger

A custom version of the Insight graphical debugger is included as part of the DevkitPro package, however currently there are no linux binaries available. In order to successfully compile the source under linux, you need to run the following sequence of commands from the directory where you unpacked the source:

for f in `find`; do; dos2unix ${f}; done
./configure --target=powerpc-gekko
make install prefix=/directory/to/install/to

Using DDD (GNU Data Display Debugger)

An alternative to Insight is DDD

It has the advantage that you won't have to compile it on linux

For instance to install it on ubuntu just use the following command:

sudo apt-get install ddd

Then you use ddd with powerpc-gecko-gdb with the following:

ddd --debugger path-to-powerpc-gecko-gdb

And finally you can use the console at the bottom to connect to your wii and load the symbols as you would using gdb from the console

For instructions on how to use gdb or insight for remote debugging, see Remote Debugging with GDB

See Also