Difference between revisions of "Devkitppc setup (Windows)"

From WiiBrew
Jump to navigation Jump to search
(Removing out of date instructions. Please do not reinstate.)
Tag: Replaced
 
(22 intermediate revisions by 16 users not shown)
Line 1: Line 1:
DevkitPPC is the part of the [[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]]
+
Tutorials/guides on other sites get out of date and tend to involve instructions that get people confused and in a mess. Link to https://devkitpro.org/wiki/Getting_Started instead.
 
 
== 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]]
 
 
 
== Installing devkitPPC ==
 
* Goto [http://sourceforge.net/project/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
 
* 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:\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 ==
 
 
 
* 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 ==
 
* Now, browse to the helloworld folder. There should be a helloworld.dol file here now.
 
* Open this file, and when windows asks what program to use, tell it to use C:\devkitpro\emulators\gcube\gcube.exe
 
 
 
The resulting dol should be compatible with the Twilight Hack. Unfortunately dols compiled with CVS libogc and future stable releases will not be compatible with gcube.
 
 
 
== 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.
 
* 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.
 
 
 
== 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==
 
* [http://wiki.devkitpro.org/index.php/Getting_Started devkitPro's 'Getting Started' Wiki]
 
* [[Getting started with DevkitPPC on Mac OS X|Getting started with DevkitPPC on Mac OS X]]
 
* [[Getting started with DevkitPPC on Linux|Getting started with DevkitPPC on Linux]]
 
 
 
 
 
{{Languages|{{BASEPAGENAME}}}}
 
[[Category:Development]]
 

Latest revision as of 12:51, 1 July 2020

Tutorials/guides on other sites get out of date and tend to involve instructions that get people confused and in a mess. Link to https://devkitpro.org/wiki/Getting_Started instead.