206
edits
Changes
Jump to navigation
Jump to search
no edit summary
Line 16:
Line 16:
<!-- == Install additional software using emerge == -->+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
| hbb =
| hbb =
}}
}}
+== News ==
+There is a new version available and this page needs to be updated now!!! Hint: the kernel is in the /boot directory of the downloaded tarball now. It is set to NTSC and needs to be patched for the correct video mode.
+
+== Introduction ==
+
'''''WiiToo!''''' is a minimal precompiled [http://en.gentoo-wiki.com/wiki/Custom_Stage4 stage4] made to let you run [http://www.gentoo.org/ Gentoo] on your Wii using [http://www.gc-linux.org/wiki/MINI:KernelPreviewFour MIKE] and [[Mini]]. A stage4 archive is an image of the entire root partition of a Gentoo system. It provides all the basic software required to compile and install new programs on it, and some other software ready to be used. The kernel used is plain vanilla-sources & [[Wii-Linux]] patches, so expect WiFi working out of the box after just editing some configuration files.
'''''WiiToo!''''' is a minimal precompiled [http://en.gentoo-wiki.com/wiki/Custom_Stage4 stage4] made to let you run [http://www.gentoo.org/ Gentoo] on your Wii using [http://www.gc-linux.org/wiki/MINI:KernelPreviewFour MIKE] and [[Mini]]. A stage4 archive is an image of the entire root partition of a Gentoo system. It provides all the basic software required to compile and install new programs on it, and some other software ready to be used. The kernel used is plain vanilla-sources & [[Wii-Linux]] patches, so expect WiFi working out of the box after just editing some configuration files.
Line 227:
Line 232:
==== MAC address ====
==== MAC address ====
−The distribution comes with the wrong MAC address of the WLAN card in a configuration file. Erase the file /etc/udev/rules.d/70-persistent-net.rules. Then boot the system again and WiiToo! will write a new file with the correct MAC address. After that continue with the settings below.
+The previous 28oct2009 distribution comes with the wrong MAC address of the WLAN card in a configuration file. Erase the file /etc/udev/rules.d/70-persistent-net.rules. Then boot the system again and WiiToo! will write a new file with the correct MAC address. After that continue with the settings below.
You could also read the MAC address from your Wii system menu/console and enter it into the 70-persistent-net.rules file using the Nano editor.
You could also read the MAC address from your Wii system menu/console and enter it into the 70-persistent-net.rules file using the Nano editor.
Line 429:
Line 434:
This and additional software is also described [http://wiitoo.sourceforge.net/#s.12 here] at the WiiToo! site at Sourceforge.
This and additional software is also described [http://wiitoo.sourceforge.net/#s.12 here] at the WiiToo! site at Sourceforge.
−== Installing further applications==
+=== Making a swap file ===
+If you want to compile bigger applications on your Wii you will soon run out of memory. To avoid this you can generate a swap file so WiiToo! can use that if it runs out of memory. This is how you do that:
+a) Make sure you are logged in as the root user
+b) Type following command to create a 128MB swap file (1024 * 128MB = block size):
+ # dd if=/dev/zero of=/swapfile1 bs=1024 count=131072
+Depending on the size of your SD card you can also make a bigger swapfile, e.g. set count=327680 to get a 320MB file.
+c) Set up the swap area:
+ # mkswap /swapfile1
+d) Activate /swapfile1 swap space now:
+ # swapon /swapfile1
+e) See how much memory is available:
+ # free -m
+f) To activate /swapfile1 each time WiiToo! is booted, add a swapfile entry to the /etc/fstab file. Open /etc/fstab with Nano and append this line:
+ /swapfile1 swap swap defaults 0 0
+=== Classic method ===
+The prefered method for installing software is using the Portage package manager, however, there are files which are not available on the Gentoo servers. For example software which is developed for the Wii such as the x86f-video-cube driver.
+For a test lets try to install the games ascii-invaders. Since we have no graphics installed yet, we have to stick with ASCII games.
+To install this you have to download the software from this link: [http://ip9.org/munro/invaders/invaders0.1b.tgz ASCII invaders]. Put this file on the FAT partition of the SD-Card.
+Now log into WiiToo!, and go into the src directory: "cd ~/src". Extract the downloaded archive there with the command:
+ # tar -xjvf invaders0.1b.tgz
+This will make a new subdirectory called "invaders0.1b" and put all the files from the archive into that. Then use e.g. "cd ~/src/invaders0.1b" to go into this directory.
+At this stage you can compile and install the game. First enter ./configure from the command line, then make, then make install. You can do that in one line if you do not expect that anything goes wrong: "./configure && make && make install".
+"Configure" is a script which e.g. checks that your system has the proper dependencies in order to compile the program or driver from source. Some of these scripts allow you to specify options to compile with or without support for certain modules. Make executes the Make program which runs the makefile in the directory. make install causes make to run the makefile again, this time with the target "install" copying the compiled files to the proper location. If every step succeeded, you can run the program now.
+=== Using the Portage package manager ===
+To add further applications to WiiToo!, you can use Gentoo's package manager [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Portage] or [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3] or [http://wiki.sabayonlinux.org/index.php?title=En:HOWTO:_The_Complete_Portage_Guide#.2Fetc.2Fmake.conf]. Portage provides "ebuilds" for each software package which contain all the necessay information to compile the package on the hardware platform in use. A complete set of these ebuilds has to be available on the local PC in form of a Portage tree in the directory /usr/portage . If this is the case e.g. the command
+ emerge xz-utils
+will download the source for the xz compression utilities from the Gentoo servers and compile and install them on your PC.
+The Portage tree usually needs over 1000 MB of disk space. Since we operate on a SD card, we will usually have not that much space available. So the latest release of WiiToo! holds this portage tree in a SQUASH file system, so it will fit on the SD card.
+Lets try if this works now. As a simple emerge download and install the automake utility. For this enter the command:
+ emerge -v automake
+The -v option selects verbose mode.
+== Credits ==
== Credits ==
Thanks to all the people that have contributed in any way to this project, special thanks to Gentoo, [[Team Twiizers]], and isobel without them this wouldn't be possible.
Thanks to all the people that have contributed in any way to this project, special thanks to Gentoo, [[Team Twiizers]], and isobel without them this wouldn't be possible.