48
edits
Changes
Jump to navigation
Jump to search
added section about debugging with dolphin
Line 52:
Line 52:
Graphical debugger options for Linux can be found on [[Devkitppc setup (Linux)|the linux set-up page]]
Graphical debugger options for Linux can be found on [[Devkitppc setup (Linux)|the linux set-up page]]
+
+==Debugging with Dolphin emulator==
+It is often easier to test out a homebrew app using dolphin emulator than using an actual Wii console. This is because for an actual wii, you have to put the sd card in, turn it on, and so on (especially if your wii is not next to your computer). Luckily the most recent version of the homebrew channel is dolphin compatible. It is best ran on the most recent version on dolphin (currently 5.0-13178), so update your emulator.
+
+To set up the homebrew channel, first get a WAD of the homebrew channel. Get it here: https://wiidatabase.de/downloads/kanaele/homebrewkanal-open-source-edition/, then extract the zip to the Dolphin game directory.
+
+(Setting the game directory: go to options -> configuration -> paths -> add, then choose a directory)
+
+It is optional to install a wii menu. To do that, either install the NUS downloader (click download on here: https://wiibrew.org/wiki/NUS_Downloader), or scroll down to RVL downloader here: http://wehackwii.pbworks.com/w/page/8844411/IOS%20and%20RVL%20Downloads.
+
+--To use the NUS downloader: go to Database -> System -> System menu and choose any version/any region. Check "pack WAD" then click "start download".
+--To use the website: just click download on the desired version, then unzip the zip file to your game directory (see above).
+
+On dolphin you will now see either just the Homebrew channel or the homebrew channel and system menu depending on whether or not you downloaded the system menu. Go to tools -> system update -> current region. After that go right click on the Homebrew channel and click "install to the NAND". The homebrew channel should work now, but we need the actual app to be openable. You need to set up a virtual SD card. This guide works really well to set it up: https://wiki.dolphin-emu.org/index.php?title=Virtual_SD_Card_Guide.
+
+To edit the sd card go to wherever sd.raw is loacated. Right click on the file, then click mount with ImDisk. Check "removable media" then click OK. A new drive should be visible in file explorer. Similar to an actual wii sd card, create a folder called "apps" on the root.
+
+When you have compiled your app, just move the new boot.dol into a folder for your app. Put a meta.xml file in that subfolder also, so the homebrew channel can read it properly. Then to test on dolphin just go into the Homebrew channel and open the app. This process should be much faster than just loading it on the wii.
==Experimental: Remote Debugging with GDB over Network==
==Experimental: Remote Debugging with GDB over Network==