Changes

a client tool to transfer such files is included.

a client tool to transfer such files is included.

==Requirements==

== Requirements ==

:*a usbgecko adapter

:*a usbgecko adapter

:*a way to boot Wii homebrew

:*a way to boot Wii homebrew

==Features==

== Features ==

:*100% native Wii mode

:*100% native Wii mode

:*no medium ejecting, rewriting and inserting required whatsoever

:*no medium ejecting, rewriting and inserting required whatsoever

:*as always, this is open source ;)

:*as always, this is open source ;)

==Architecture==

== Architecture ==

:geckoloader consists of 3 parts

:geckoloader consists of 3 parts

::*stub

::*stub

:the chosen architecture has the advantage that the tiny stub is the only component which has to stay intact in memory. while the usage of the usbgecko onboard flash might seem unnecessary at first, its purpose is the reloading feature. you will upload and run Wii applications. these in return will allocate memory and write to it. if the loader code would stay somewhere in memory, any executed application might overwrite it this way, but since it sits on the onboard usbgecko flash, no application can corrupt it.

:the chosen architecture has the advantage that the tiny stub is the only component which has to stay intact in memory. while the usage of the usbgecko onboard flash might seem unnecessary at first, its purpose is the reloading feature. you will upload and run Wii applications. these in return will allocate memory and write to it. if the loader code would stay somewhere in memory, any executed application might overwrite it this way, but since it sits on the onboard usbgecko flash, no application can corrupt it.

==Build==

== Build ==

:'''hint:''' a precompiled binary is included

:'''hint:''' a precompiled binary is included

:run <code>make install</code> to copy <code>geckoupload</code> (the client) to <code>$DEVKITPPC/bin</code>

:run <code>make install</code> to copy <code>geckoupload</code> (the client) to <code>$DEVKITPPC/bin</code>

==Usage==

== Usage ==

===Wii-side===

=== Wii-side ===

:*use the [[Twilight_Hack|Twilight hack]] in combination with the included geckoloader.elf to get this running

:*use the [[Twilight Hack|Twilight hack]] in combination with the included geckoloader.elf to get this running

:*the boot code will show up

:*the boot code will show up

::*you have to write the loader code to the onboard usbgecko flash once, press the Wii RESET button when asked to

::*you have to write the loader code to the onboard usbgecko flash once, press the Wii RESET button when asked to

:'''hint:''' try to upload the included <code>test.elf</code> first. it just prints a string to screen and has an option to jump back to the loader

:'''hint:''' try to upload the included <code>test.elf</code> first. it just prints a string to screen and has an option to jump back to the loader

===Client-side===

=== Client-side ===

:*the client uses a default tty device (except on windows), you can overwrite it using the environment variable <code>USBGECKODEVICE</code>

:*the client uses a default tty device (except on windows), you can overwrite it using the environment variable <code>USBGECKODEVICE</code>

:*Set USBGECKODEVICE too the com your device uses (example, COM4)

:*Set USBGECKODEVICE too the com your device uses (example, COM4)

:*gamecube .dol's to the official usbgecko boot dvd

:*gamecube .dol's to the official usbgecko boot dvd

==Windows Driver Setup==

== Windows Driver Setup ==

If your USBGecko install didn't provide you with a COM port then try the following:

If your USBGecko install didn't provide you with a COM port then try the following:

# Go to device manager and select the device 'USB Serial Converter' which is the USB Gecko device.  

# Go to device manager and select the device 'USB Serial Converter' which is the USB Gecko device.  

This should now give you a COM port, which you will need for geckoupload.

This should now give you a COM port, which you will need for geckoupload.

==Notes==

== Notes ==

:*you can not run GameCube binaries with this loader since we're working in Wii mode here (that's a good thing)

:*you can not run GameCube binaries with this loader since we're working in Wii mode here (that's a good thing)

:*the default libogc base address for Wii homebrew is at 0x80003f00. this gives a PSO compatible stub 0x1900 bytes of memory for code. hence, the stub's main() functions were written in c so that it's easy to improve/fix

:*the default libogc base address for Wii homebrew is at 0x80003f00. this gives a PSO compatible stub 0x1900 bytes of memory for code. hence, the stub's main() functions were written in c so that it's easy to improve/fix

:*you can use the trucha signer to boot this app straight from dvd

:*you can use the trucha signer to boot this app straight from dvd

==Thanks==

== Thanks ==

:*shagkur, for helping me getting the stub working and providing the linkerscript

:*shagkur, for helping me getting the stub working and providing the linkerscript

:*the [[DevkitPro|devkitpro]] team

:*the [[DevkitPro|devkitpro]] team

:*nuke for sharing code for his adapter

:*nuke for sharing code for his adapter

==Download==

== Download ==

===v0.0.4 - gamecube edition===

=== v0.0.4 - gamecube edition ===

:[http://forum.wiibrew.org/read.php?17,1239 release thread]

:[http://forum.wiibrew.org/read.php?17,1239 release thread]

===v0.0.3===

=== v0.0.3 ===

:[[media:Geckoloader-0.0.3.tgz|geckoloader-0.0.3.tgz]]

:[[Media:Geckoloader-0.0.3.tgz|geckoloader-0.0.3.tgz]]

===v0.0.2b===

=== v0.0.2b ===

:[[media:Geckoloader-0.0.2b.tgz|geckoloader-0.0.2b.tgz]]

:[[Media:Geckoloader-0.0.2b.tgz|geckoloader-0.0.2b.tgz]]

===v0.0.2===

=== v0.0.2 ===

:[[media:Geckoloader-0.0.2.tgz|geckoloader-0.0.2.tgz]]

:[[Media:Geckoloader-0.0.2.tgz|geckoloader-0.0.2.tgz]]

==Changelog==

== Changelog ==

:*v0.0.4

:*v0.0.4

:*v0.0.2

:*v0.0.2

::*first public release

::*first public release

[[Category:Homebrew applications]]

[[Category:Homebrew applications]]

[[Category:Loaders|Gecko]]

[[Category:Loaders|Gecko]]