devkitPPC is the toolchain provided by DevkitPro for Wii and Gamecube development. This guide describes setting up such a system under Windows. A guide for Mac OS X 10.5.x users can be found here and a guide for Linux here
DevKitARM (This is part of DevKitPro) Luma3DS (Starting with Luma3DS 5.0 the firm.bin files aren’t needed anymore) 1. Preparation 1. If you have a version of Python 2.7.x 32bit installed remove this first 2. Install Python 2.7 and make sure to tick the “Add Python.exe to Path” Setting so that you can use python by typing python in your CMD 3. To compile homebrew for the Wii U, you need the devkitPro Toolchain, the offical “getting started” can be found here. On Windows you can use the graphical installer to install devkitpro. After installing you can open MSYS (Start - devkitPro - MSYS) and check if the needed packages are installed and on the newest version.
Introduction
This tutorial aims to:
- Show you how to setup the devkitPPC development environment on a Windows computer
- Run a hello world example on the included Gcube emulator
- Run a hello world example on the Wii using wiiload
- Set you on the road to creating your own homebrew software to be loaded with the Twilight Hack or Homebrew Channel
Installing devkitPPC
- Go to this page and download the latest Windows installer.
- Let it install to the C:devkitPro to make it easier to follow the tutorial for now.
- When installing it, you can deselect devkitARM and devkitPSP
- Click next until it finishes installing
Setup your project folder
- Under no circumstances should you place projects within the devkitPro folder. The windows updater can and will overwrite/delete your files.
- Create a new folder outside the devkitPro folder, c:projectswii for example. This path should not contain spaces.
- Copy the folder C:devkitProexampleswiitemplate to this new directory and rename it to 'helloworld' so that the full path is c:projectswiihelloworld
Compile the Hello World Example
- Assuming you installed Programmer's Notepad through the installer, double click the .pnproj file in your new project.
- Click on Tools->make or use the ALT+1 key combination
- The output window at the bottom will show the build progress
Note: If you are having trouble compiling some programs under Windows Vista (eg. libogc cvs), try unsetting PLATFORM variable. (in msys shell, 'unset PLATFORM')
Run the Hello World Example on the emulator
![Devkitpro Devkitpro](/uploads/1/2/6/4/126409703/527540272.png)
- Now, browse to the helloworld folder. There should be a helloworld.dol file here now.
- Run the helloworld.dol in an emulator. As of 23-Feb-2019, emulators for the Wii are mostly compatible and feature complete. Dolphin can successfully boot all GameCube games, most Wii games and most homebrew. See the Dolphin page for more information. Another emulator is Gcube. Gcube does not run homebrew compiled in Wii mode, but can run homebrew if compiled for the GameCube mode. See the Gcube page for more information.
Run the Hello World Example on the Wii using wiiload
![Installing Installing](/uploads/1/2/6/4/126409703/478986714.png)
- For this to work, you need to have the Homebrew Channel installed on your Wii and a way to access the Wii via TCP.
- Get wiiload.exe from the Homebrew Channel archive (should be in wiiloadwin32) and copy it to C:devkitPromsysbin.
- Set the environment variable WIILOAD to something like 'tcp:192.168.0.30' (replace the IP with your Wii's IP). This can be done via Control Panel -> System -> Advanced -> Environment Variables. Then restart windows.
- Start the Homebrew Channel on your Wii.
- Click on Tools -> run or use the ALT+R key combination.
- The output window at the bottom will show the upload progress (so does the Homebrew Channel) and the example will be started on your Wii when it's done.
Edit the msys etc/profile file
The etc/profile file loads some settings at each launch of the msys shell. It can be used to set some environement variable for the compiler/linker
Set the $DEVKITPRO variable to the devkitpro directory and the WIILOAD with the Wii IP.
CC: C Compiler to use
CXX: C++ compiler to use (note: CPP stand for C preprocessor)
DEVKITPRO: Needed by the Devkitpro Makefiles
WIILOAD: Needed by the wiiload program
PATH: Search in bin and libexec in order to perform a gcc or g++ command without a makefile, followed by your Windows existing variables.
Some Code snippets
- See also: Developer Tips
libogc provides a jump back to the loader through the standard libc exit function. exit(0) will immediately return, all other values will display a console screen with the exit code.
Links
Retrieved from 'https://wiibrew.org/w/index.php?title=Devkitppc_setup_(Windows)&oldid=107951'