65
edits
Changes
Complete overhall of the article. Spun distros, usage, troubleshooting and ethernet adapter compatibility into different articles
Line 11:
Line 11:
'''''Wii-Linux''''' is the generic name for GC-Linux based systems that run on the Wii and support Wii-specific hardware (such as wifi, bluetooth etc). Many "distributions" are available -- a pairing of a kernel with a userland -- but most can be considered experimental.+== Summary ==+*Creator: GC-Linux Team
−*Software type: Operating System
−*Accessories needed: Storage for a root filesystem (SD card with a FAT16 and an ext3 partition or a USB drive), USB keyboard
−*Optional accessories: Computer running Linux, GameCube controller, [[USB Gecko]], Wiimote, [[Wii-Linux#Compatible Ethernet adapters|Nintendo Wii LAN Adapter]], [[Wii-Linux#Mount USB Drives|USB drive]]
−*Best PAL mode: 480i/p
−*Loaders usable: [[Twilight Hack]], [[Homebrew Channel]]
−*Button to return to loader: No
−*Alternate installation: Setup USB Gecko and load the software on the PC beforehand (see the readme).
−== Hardware supported ==+The Linux kernel itself can communicate with nearly all peripherals. The only notable exception are GameCube Memory Cards.
−
+
+
+
+Actual hardware support will vary with the software (ie. drivers) installed on the root partition.+In broad strokes, you will create an ext3 filesystem on some removable device (SD card, USB drive) and then boot a kernel image ELF.+=== The Whiite Installer ===+*The GC Linux team has released a new installer for certain distributions including:
−**Bliight
−**XWhiite
−**Whiite
−*[http://www.gc-linux.org/wiki/WL:whiite-linux-installer Download]
== Logging in ==
−After you have booted Linux you will have 60 minutes to log on with the credentials below before it times out.
−*For debian-etch-4.0+whiite-0.1:+ Username: root+ Password: whiite
−*For PoC:
− Username: root
− Password: cube
−== Things that work ==+The Debian release comes with a lot of news, only available if you boot using the kernel that comes with that package. '''You will need a USB keyboard to use this release.''' If you are able to boot with it and login, you will stop in a command line where you can navigate through the filesystem, and execute some applications. There are working drivers for the USB bus and internal Bluetooth, but '''not for the internal wireless adapter.''' Here are some things that you can do:
− nano [text file]+=== Play MP3s ===+ mp3-decoder <mp3 file>
−There is an mp3 sample in the /root directory. You can play it if you type:+ mp3-decoder Synapse-Stealing_Science.mp3
−
−You can also use this:
− mpg321 <mp3 file>
−
−Type & after the command to have the mp3 play in the background:
− mpg321 Synapse-Stealing_Science.mp3 &
−
−To play MP3s from a USB flash drive, mount the drive (see below). Navigate to the directory where they are stored on your USB flash drive, and use the "mp3-decoder" or the "mpg321" tool to play them.
−
−=== Mount USB Drives ===
−* Mount an external USB hard disk
−Not all USB hard disks work, but if they are formatted in FAT or EXT2 they might be recognized. Connect a USB flash drive, and type:
− dmesg
−
−The dmesg command will show you the last kernel message. If the USB flash drive is compatible, it will show you some debug messages, and a message with the status of the new drive. If it is recognized as sda, you can mount and navigate to that using these commands:
− mkdir mnt
− mount /dev/sda1 mnt
− cd mnt
− ls
−
−*To show the identifiers of the devices connected to the USB: Type <code>lsusb</code>
−*USB hubs work.
−
−=== Use the internal Bluetooth ===
−There is a driver that manages the Wii internal Bluetooth. You can connect to the Wiimote, but there isn’t any application to manage it yet. You can type these commands to configure it:
−
−; <code>hciconfig</code> : Shows you the Bluetooth configuration.
−; <code>hcitool scan</code> and press "1&2" on the Wiimote
−: This will find the Wiimote and show some information.
−
−=== Chat on IRC ===
− irssi
−
−=== Install Debian Packages ===
−After setting up an internet connection, you will be able to install new Debian packages directly onto the Wii using apt-get. Alternatively you can download on a PC then use dpkg to install packages manually.
−
−*[http://packages.debian.org/etch/cmatrix cmatrix] is confirmed to run which displays a simple curses screensaver. The font suggested for it has not been tested.
−*[http://packages.debian.org/etch/ninvaders ninvaders] is a simple curses based game played like Space Invaders. Seems to work 100%
−*[http://doctormike.googlepages.com/pacman.html pacman] is a curses pacman game. Currently the Linux console is not large enough to view the lives, levels, and score. The game is compiled from scratch with wiiuse and Bluetooth and ncurses devs.
−*[http://packages.debian.org/etch/sc sc] is a curses spreadsheet application.
−
−=== Install MPlayer ===
−*Download the source to [[Wii MFE Port]]
−*Copy these files to the corresponding places on your SD card:
− /src/native/fs/shipped/'''lib/'''
− /src/native/fs/shipped/'''root/'''
− /src/native/fs/shipped/'''usr/'''
−*Extract the contents of these archives to your SD card:
− /src/native/libsdl/'''mfe-libsdl.tar.gz'''
− /home/zach/Desktop/src/native/mplayer/'''mfe-mplayer.tar.gz'''
−*Log on to whiite and type (you only need to do this once):
− mknod /dev/fb0 c 29 0
−*Type:
− mplayer <file>.avi
−
−== Things that Don't Work ==
−The latest [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive Mini Kernel Preview Five] does not support Nintendo GameCube memory cards.
−
−== Hardware Compatibility ==
−=== Compatible Ethernet adapters ===
−{|class="wikitable"
−! Device
−! Hardware ID String
−! Description
−! Cost
−|-
−| [http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712¤cy=USD&catalogId=10001&categoryId=62707 Nintendo Wii LAN Adapter]
−|
−| Official Nintendo Product
−| [http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712¤cy=USD&catalogId=10001&categoryId=62707 $24.99 US]
−|-
−| Datel's LAN Adapter
−|
−|
−| [http://www.play-asia.com/paOS-13-71-10v-49-en-70-1slw.html $29.90]
−|-
−| Linksys WUSB54GC USB Wi-Fi Adapter
−|
−|
−| [http://www.newegg.com/Product/Product.aspx?Item=N82E16833124350 $24.99]
−|-
−| [http://www.linksysbycisco.com/US/en/products/USB200M Linksys USB200M rev 2]
−|
−|
−|
−|-
−| ASIX AX88172
−| 0b95:1720
−| USB2.0 to 10/100M Fast Ethernet Controller
−|
−|}
−
−=== Incompatible Ethernet adapters ===
−{|class="wikitable"
−! Device
−! Hardware ID String
−! Description
−|-
−| [http://www.superclearance.com/shop/image.php?productid=44905 Linksys USB Network Adapter USB10T]
−| VID_0x066b & PID_0x2206
−| device not supported
−|-
−| [http://www.eminent-online.com/producten_stap2.php?dt=1&ps=01304090&pg=99 Eminent EM4090 USB Network Kit]
−|
−|
−|}
;I get a black screen when I load the DOL.+:Something is wrong with the SD card's filesystem. Format your SD card and try again.
−;It boots up with a lot of errors saying file system read-only then it freezes.+:Turn off Wiiconnect24 or load from bannerbomb (please confirm).
−An X.org server is available for the Wii, but little has been done to create a "Wii-appropriate" user interface with it. A Wiimote may be used as a pointing device, but manual configuration is often needed to set this up.+== Distributions ==+=== Archii ===
−*Arch Linux PPC for the Wii
−*Designed for use with the new MIKE p1 kernel but can be made to work with Boot it or any other kernel release.
−*Made By TheStorm/JonimusPrime and zc00gii
−*Is designed for more advanced users to create from scratch but minimal and X11 file-system tars are available
−**The X11 tar has X.Org installed along with the OpenBox3 WM and Cwiid for Wiimote input
−**It also includes the Opera Browser, X-Chat IRC client and Pidgin IM client
−**The Minimal image is just enough to get you booted and the end user can install any packages they wish using pacman
−*[http://wiki.archlinux.org/index.php/Wii_Tutorial ArchWiki-WiiTutorial]
−*File-system tars can be found [http://thestorm.taricorp.net/archii/tarballs/ here]
−*Last updated: 11 July 2009
−=== Bliight ===
−*A full Gentoo distribution for the Wii.
−*It uses the whiite method of installation.
−*Made by T7g
−*[http://www.tehskeen.com/forums/showthread.php?t=9848 Download/Discussion]
−*Last updated: 8 December 2008
−=== XWhiite ===
−*[[Wii Linux#Whiite|Whiite]] but with the X.Org environment successfully implemented.
−*It currently uses [[Wii Linux#Kernel 2.6.27|kernel 2.6.27b]].
−*It also includes some applications including Firefox.
−*It uses the whiite method of installation
−*It has now been updated to v0.2
−*Made by bertjan
−*[http://www.tehskeen.com/forums/showthread.php?t=9777 Download/Discussion]
−*Last updated: 02 December 2008
−=== PoC ===
−These are small, stand-alone distributions that were merely to demonstrate that Linux could run on the Wii. These distributions are very limited in functionality and are not recommended. Instead, use one of the above distributions (XWhiite, Bliight are recommended).
−==== Proof of Concept 0.4 ====
−*Adds support for USB keyboards through the IOS keyboard interface.
−*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.4.tar.gz Main Download]
−*[http://ostsoft.net/go?to=wiidl&dl=19 Mirrored Download]
−==== Proof of Concept 0.3 ====
−*Adds read and write support for the front SD card slot.
−*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.3.tar.gz Download]
−==== Proof of Concept 0.2 ====
−*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.2.tar.gz Download]
−==== Proof of Concept 0.1 ====
−*[http://downloads.sourceforge.net/gc-linux/wii-linux-PoC-0.1.tgz Download]
| peripherals = {{Wiimote1}} {{GCNController}} {{USBKeyboard}} {{FrontSD}} {{USBMSD}} {{USBGecko}}
| peripherals = {{Wiimote1}} {{GCNController}} {{USBKeyboard}} {{FrontSD}} {{USBMSD}} {{USBGecko}}
}}
}}
−'''Wii-Linux''' is a port of the [http://en.wikipedia.org/wiki/Linux Linux] kernel and related GNU userspace utilities to the Nintendo Wii video game console. Many [http://en.wikipedia.org/wiki/Linux_distribution distributions] of GNU/Linux are available for the Nintendo Wii. All current distributions are based on [http://www.gc-linux.org/wiki/FAQ#What_is_this_project_all_about.3F GC-Linux]. Wii-Linux distributions can be loaded through the [[Twilight Hack]], [[Homebrew Channel]] or [[bootmii]] (for Wi-Fi support).
−The Linux kernel itself can communicate with nearly all Wii peripherals; Wii Remotes, Wi-Fi, USB, Bluetooth, GameCube controllers, USBGeckos and the DVD drive are supported. GameCube Memory Cards are currently unsupported. Actual hardware support depends on the drivers installed on the root partition.
−A GUI (X.org server) is available, but is not optimized for a [http://en.wikipedia.org/wiki/10-foot_user_interface "10-foot user interface"]. A Wii Remote may be used as a pointing device with the X.org server, but manual configuration is likely needed.
−Wii Remotes, Internal WiFi, USB, Bluetooth, GameCube controllers, USBGecko and DVD drive are supported
+The latest [http://www.gc-linux.org/wiki/MINI:KernelPreviewFive Mini Kernel Preview Five] does not support Nintendo GameCube memory cards.
+== Hardware Required ==
+* Nintendo Wii Console
+* SD Card or USB Drive
+* USB Keyboard
+Note: A computer already running Linux is useful for manual installation.
−The SD Card or USB Drive will likely be formatted and repartioned.
−== Getting Started ==
+== Installing ==
−===Whiite-Linux Installer ===
+The GC-Linux team has released a [http://www.gc-linux.org/wiki/WL:whiite-linux-installer Simple GUI-based installer] can be used with Whiite, Bliight and XWhiite distributions. The installer can be loaded via the [[Homebrew Channel]] or [[Twilight Hack]].
−An ext3 filesystem is created on a removable disk (SD card or USB drive). The kernel image ELF can be loaded through [[Homebrew Channel]].
−=== Manual Installation ===
=== Manual Installation ===
+{{Main|Wii-Linux Manual Installation}}
+
+Users may install a Wii-Linux distribution manually.
+
Isobel has made some [http://www.gc-linux.org/wiki/WL:whiite-linux Official Instructions].
Isobel has made some [http://www.gc-linux.org/wiki/WL:whiite-linux Official Instructions].
Line 52:
Line 52:
#Configure Bluetooth with <code>hciconfig</code> then type <code>hcitool scan</code> and press 1+2 on your wiimote to connect it.
#Configure Bluetooth with <code>hciconfig</code> then type <code>hcitool scan</code> and press 1+2 on your wiimote to connect it.
−== Using Wii-Linux ==
−{{Main|Using Wii-Linux}}
−Once a Wii has booted Linux, there are lot's of things for users new to Linux to do.
−=== Edit text files ===
+== Hardware Compatibility ==
−{{Main|Wii-Linux Hardware Compatibility}}
−Before Wii-Linux supported internal Wi-Fi, users were forced to use USB Ethernet Adapters and USB Wi-Fi dongles for an Internet connection. Supported external hardware is listed.
−Note that currently all internal Wii hardware is supported (except GameCube Memory Cards).
−== Troubleshooting ==
== Troubleshooting ==
−{{Main|Troubleshooting Wii-Linux}}
−For frequent problems when installing and setting up Wii-Linux
−== GUI ==
+== Distributions ==
−{{Main|Distributions of Wii-Linux}}
−Many distributions of GNU/Linux are available for the Nintendo Wii.
=== WiiToo! ===
=== WiiToo! ===
Line 209:
Line 92:
*[http://downloads.sourceforge.net/gc-linux/debian-etch-4.0%2Bwhiite-0.1.tar.bz2 Version 0.1 (Debian Etch 4.0) Download]
*[http://downloads.sourceforge.net/gc-linux/debian-etch-4.0%2Bwhiite-0.1.tar.bz2 Version 0.1 (Debian Etch 4.0) Download]
*Last updated: 21 Oct 2009
*Last updated: 21 Oct 2009
+
+=== Archii ===
+*Arch Linux PPC for the Wii
+*Designed for use with the new MIKE p1 kernel but can be made to work with Boot it or any other kernel release.
+*Made By TheStorm/JonimusPrime and zc00gii
+*Is designed for more advanced users to create from scratch but minimal and X11 file-system tars are available
+**The X11 tar has X.Org installed along with the OpenBox3 WM and Cwiid for Wiimote input
+**It also includes the Opera Browser, X-Chat IRC client and Pidgin IM client
+**The Minimal image is just enough to get you booted and the end user can install any packages they wish using pacman
+*[http://wiki.archlinux.org/index.php/Wii_Tutorial ArchWiki-WiiTutorial]
+*File-system tars can be found [http://thestorm.taricorp.net/archii/tarballs/ here]
+*Last updated: 11 July 2009
=== Miight ===
=== Miight ===
Line 230:
Line 125:
*Made by [[User:Muzer|Muzer]]
*Made by [[User:Muzer|Muzer]]
−== External links ==
== External links ==