Changes

Jump to: navigation, search

Devkitppc setup (Windows)

1,169 bytes added, 23 February
m
Updated emulator information
DevkitPPC devkitPPC is the part of the toolchain provided by [[DevkitPro]] toolchain used 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 [[Getting started with DevkitPPC on Mac OS X|here]] and a guide for Linux [[Getting started with DevkitPPC on Linux|here]]
== Introduction ==
* 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 ==
* Goto Go to [httphttps://sourceforge.net/projectprojects/devkitpro/files/Automated%20Installer/showfiles.php?group_id=114505&package_id=160396 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
* 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:\projects\wii for example. This path should not contain spaces.
* Copy the folder C:\devkitPro\examples\wii\template\ to this new directory and rename it to "helloworld" so that the full path is c:\projects\wii\helloworld\
== Compile the Hello World Example ==
== Run the Hello World Example on the emulator ==
* Now, browse to the helloworld folder. There should be a helloworld.dol file here now.
* Open this fileRun the helloworld.dol in an emulator. As of 23-Feb-2019, emulators for the Wii are mostly compatible and when windows asks what program to usefeature complete. [[Dolphin]] can successfully boot all GameCube games, tell it to use C:\devkitpro\emulators\gcube\gcubemost Wii games and most homebrew.exe The resulting dol should be compatible with See the Twilight Hack[[Dolphin]] page for more information. Unfortunately dols Another emulator is [[Gcube]]. Gcube does not run homebrew compiled in Wii mode, but can run homebrew if compiled with CVS libogc and future stable releases will not be compatible with gcubefor the GameCube mode. See the [[Gcube]] page for more information.
== Run the Hello World Example on the Wii using wiiload ==
* 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 [http://hbc.hackmii.com/download/ Homebrew Channel archive] (should be in wiiload\win32) and copy it to C:\devkitPro\msys\bin.
* 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
 
<source lang="bash">
export CC=powerpc-eabi-gcc
export CXX=powerpc-eabi-g++
export DEVKITPRO=/c/usr/devkitpro
export DEVKITPPC=$DEVKITPRO/devkitPPC
export SDL_CONFIG=$DEVKITPRO/libogc/bin/sdl-config
export WIILOAD="tcp:192.168.1.57"
export PATH="$DEVKITPPC/bin:$DEVKITPPC/powerpc-eabi/bin:$DEVKITPPC\libexec\gcc\powerpc-eabi\4.4.3:$PATH"
export LDFLAGS="-L$DEVKITPRO/libogc/lib/wii"
</source>
 
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 ==
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==
* [http://wiki.devkitpro.org/index.php/Getting_Started devkitPro's 'Getting Started' Wiki]
* [[Getting started with DevkitPPC on Devkitppc setup (Mac OS X)|Getting started with DevkitPPC on Mac OS X]]* [[Getting started with DevkitPPC on Devkitppc setup (Linux)|Getting started with DevkitPPC on Linux]] [[Category:Development]]
1
edit

Navigation menu