Changes

Wii-Linux (view source)

Revision as of 04:40, 22 October 2009

21 bytes added , 04:40, 22 October 2009

cleanup

Line 11: Line 11:

| peripherals = {{Wiimote1}} {{GCNController}} {{USBKeyboard}} {{FrontSD}} {{USBMSD}} {{USBGecko}}

}}

−

~~The~~ Wii-Linux is a small Linux OS for the Wii, based on GC Linux.

+

'''''Wii-Linux''''' is a small Linux distribution for the Wii, based on GC Linux.

−

== Summary ==

−

+

*Creator: GC-Linux Team

−

* Creator: GC-Linux Team

+

*Software type: Operating System

−

* Software type: Operating System

+

*Accessories needed: Computer running Linux, SD card with a FAT16 and an ext3 partition, USB keyboard

−

* Accessories needed: Computer running Linux, SD card with a FAT16 and an ext3 partition, USB keyboard

+

*Optional accessories: GameCube controller, [[USB Gecko]], Wiimote, [[Wii-Linux#Compatible Ethernet adapters|Nintendo Wii LAN Adapter]], [[Wii-Linux#Mount USB Drives|USB drive]]

−

* Optional accessories: GameCube controller, [[USB Gecko]], Wiimote, [[~~Homebrew apps/~~Wii Linux#Compatible ~~ethernet~~ adapters|Nintendo Wii LAN Adapter]], [[~~Homebrew apps/~~Wii Linux#Mount USB Drives|USB drive]]

+

*Best PAL mode: 480i/p

−

* Best PAL mode: 480i/p

+

*Loaders usable: [[Twilight Hack]], [[Homebrew Channel]]

−

* Loaders usable: [[Twilight Hack]], [[Homebrew Channel]]

+

*Button to return to loader: No

−

* Button to return to loader: No

+

*Alternate installation: Setup USB Gecko and load the software on the PC beforehand (see the readme).

−

* Alternate installation: Setup USB ~~gecko~~ and load the software on the PC beforehand (see the readme).

== Getting Started ==

=== The Whiite Installer ===

−

*The GC-Linux~~.org~~ team has released a new installer for certain ~~distros~~ including:

+

*The GC Linux team has released a new installer for certain distributions including:

**Bliight

**XWhiite

**Whiite

*[http://www.tehskeen.com/viewarticle.php?articleid=3101 Download/Discussion]

+

=== Manual Installation ===

Isobel has made some [http://www.gc-linux.org/wiki/WL:whiite-linux Official Instructions].

−

* 1. Make a second partition on your SD card and format as ext3.

+

#Make a second partition on your SD card and format as ext3.

−

** If you are not using Linux and you are encountering problems you can try the [http://gparted.sourceforge.net/livecd.php GParted Live CD] or [http://www.ubuntu.com/getubuntu/download Ubuntu 8.04 Live Desktop] which contains GParted. The [http://www.nacionarcade.net/wp-content/uploads/2007/11/mameonwii.doc Mame on Wii] guide explains how to format an SD card using this CD.

+

#*If you are not using Linux and you are encountering problems you can try the [http://gparted.sourceforge.net/livecd.php GParted Live CD] or [http://www.ubuntu.com/getubuntu/download Ubuntu 8.04 Live Desktop] which contains GParted. The [http://www.nacionarcade.net/wp-content/uploads/2007/11/mameonwii.doc Mame on Wii] guide explains how to format an SD card using this CD.

−

**Linux users can follow the [http://www.gc-linux.org/wiki/WL:whiite-linux#Preparation_of_the_SD_card whiite-linux] instructions to prepare the SD card.

+

#*Linux users can follow the [http://www.gc-linux.org/wiki/WL:whiite-linux#Preparation_of_the_SD_card whiite-linux] instructions to prepare the SD card.

−

* 2. Extract the debian-etch-4.0+whiite-0.1.tar.bz2 package to the ext3 partition of your SD card. You must extract the package as '''root''' or sudoer if you are using Linux or else files under <code>/dev</code> will not appear correctly.

+

#Extract the debian-etch-4.0+whiite-0.1.tar.bz2 package to the ext3 partition of your SD card. You must extract the package as '''root''' or sudoer if you are using Linux or else files under <code>/dev</code> will not appear correctly.

−

* 3. Copy the whiite-linux folder from the whiite-linux-0.1a.tar.bz2 archive to <code>/apps/</code> for HBC or put the boot.elf on the root for bannerbomb.

+

#Copy the whiite-linux folder from the whiite-linux-0.1a.tar.bz2 archive to <code>/apps/</code> for HBC or put the boot.elf on the root for bannerbomb.

−

* 4. Load the file using bannerbomb or HBC.

+

#Load the file using bannerbomb or HBC.

−

* 5. Log in to access the terminal. You can now run commands and navigate directories.

+

#Log in to access the terminal. You can now run commands and navigate directories.

−

* 6. 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.

== 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:

+

*For debian-etch-4.0+whiite-0.1:

Username: root

Password: whiite

−

* For ~~POC~~:

+

*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:

−

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:

=== Edit text files ===

Line 74: Line 71:

mpg321 Synapse-Stealing_Science.mp3 &

−

To play MP3s from a USB drive, mount the drive (see below). Navigate to the directory where they are stored on your USB ~~stick~~, and use the "mp3-decoder" or the "mpg321" tool to play them.

+

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 ~~pendrive to the~~ USB, and type:

+

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 ~~pendrive~~ is compatible, it will show you some debug messages, and a message with the status of the new drive. If it is ~~recogniced~~ as sda, you can mount and navigate to that using these commands:

+

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

Line 87: Line 84:

ls

−

* To show the identifiers of the devices connected to the USB: Type <code>lsusb</code>

+

*To show the identifiers of the devices connected to the USB: Type <code>lsusb</code>

−

* USB hubs work.

+

*USB hubs work.

−

=== Use the internal ~~bluetooth~~ ===

+

=== 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:

+

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>hciconfig</code> : Shows you the Bluetooth configuration.

−

; <code>hcitool scan</code> and press "1&2" on the ~~wiimote~~

+

; <code>hcitool scan</code> and press "1&2" on the Wiimote

−

: This will find the ~~wiimote~~ and show some information.

+

: This will find the Wiimote and show some information.

=== Chat on IRC ===

Line 103: Line 100:

If you find a USB network adapter that works with this kernel such as the Nintendo USB network adapter, you will be able to install new Debian packages directly onto the Wii using apt-get. Or 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/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://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.~~<br />''If you would like the source for pacman with wiimote support check out my website. --[[User:Skibur|Skibur]] 22:53, 21 July 2008 (CEST)''~~

+

*[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.

+

*[http://packages.debian.org/etch/sc sc] is a curses spreadsheet application.

−

=== Install ~~Mplayer~~ ===

+

=== Install MPlayer ===

−

* Download the source to [[~~Homebrew apps/~~Wii MFE Port~~|Wii MFE~~]]

+

*Download the source to [[Wii MFE Port]]

−

* Copy these files to the corresponding places on your SD card:

+

*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:

+

*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):

+

*Log on to whiite and type (you only need to do this once):

mknod /dev/fb0 c 29 0

−

* Type:

+

*Type:

mplayer <file>.avi

+

== Things that Don't Work ==

The latest [http://www.gc-linux.org/wiki/MINI:KernelPreviewFour Mini Kernel Preview Four] does not support the following Wii hardware:

−

+

*Nintendo GameCube memory cards

−

-Nintendo GameCube memory cards

+

*Internal DVD drive

−

-Internal DVD drive

== Hardware Compatibility ==

−

+

=== Compatible Ethernet adapters ===

−

=== Compatible ~~ethernet~~ adapters ===

{|class="wikitable"

! Device

Line 137: Line 132:

! Cost

|-

−

|[http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712&currency=USD&catalogId=10001&categoryId=62707 Nintendo Wii LAN Adapter]

+

| [http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712&currency=USD&catalogId=10001&categoryId=62707 Nintendo Wii LAN Adapter]

−

|

+

|

−

|Official Nintendo Product

+

| Official Nintendo Product

−

|[http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712&currency=USD&catalogId=10001&categoryId=62707 $24.99 US]

+

| [http://store.nintendo.com/webapp/wcs/stores/servlet/ProductDisplay?productId=117712&currency=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]

|-

−

|~~Datel's LAN~~ Adapter

+

| Linksys WUSB54GC USB Wi-Fi Adapter

|

−

|[http://www.~~play-asia~~.com/~~paOS-13-71-10v-49-en-70-1slw~~.~~html~~ $29.90]

+

| [http://www.newegg.com/Product/Product.aspx?Item=N82E16833124350 $24.99]

|-

−

|Linksys ~~WUSB54GC USB Wi-Fi Adapter~~

+

| [http://www.linksysbycisco.com/US/en/products/USB200M Linksys USB200M rev 2]

+

|

−

~~|[http://www.newegg.com/Product/Product.aspx?Item=N82E16833124350 $24.99]~~

−

|-

−

~~|[http://www.linksysbycisco.com/US/en/products/USB200M Linksys USB200M rev 2]~~

−

|.

−

|.

−

|.

−

|-

−

|.

−

|.

−

|.

−

|.

|}

−

=== Incompatible ~~ethernet~~ adapters ===

+

=== Incompatible Ethernet adapters ===

{|class="wikitable"

! Device

Line 169: Line 159:

! Description

|-

−

|[http://www.superclearance.com/shop/image.php?productid=44905 Linksys USB Network Adapter USB10T]

+

| [http://www.superclearance.com/shop/image.php?productid=44905 Linksys USB Network Adapter USB10T]

−

|VID_0x066b & PID_0x2206

+

| VID_0x066b & PID_0x2206

−

|device not supported

+

| device not supported

−

|-

−

~~|[http://www.eminent-online.com/producten_stap2.php?dt=1&ps=01304090&pg=99 Eminent EM4090 USB Network Kit]~~

−

|.

−

|.

|-

−

|.

+

| [http://www.eminent-online.com/producten_stap2.php?dt=1&ps=01304090&pg=99 Eminent EM4090 USB Network Kit]

−

|.

+

|

−

|.

+

|

|}

== Troubleshooting ==

−

; I get a black screen when I load the DOL.

+

;I get a black screen when I load the DOL.

−

: Something is wrong with the filesystem format your SD card and try again.

+

:Something is wrong with the filesystem format your SD card and try again.

−

; It boots up with a lot of errors saying file system read-only then it freezes.

+

;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).

+

:Turn off Wiiconnect24 or load from bannerbomb (please confirm).

== GUI ==

+

A GUI is still needed.

−

*A GUI is still needed.

+

There is a work in progress project to create an X.Org driver for Wii/GameCube. You can download and find more information [http://www.tehskeen.com/forums/showthread.php?p=44124&posted=1#post44124 here].

−

*There is a work in progress project to create an ~~Xorg~~ driver for Wii/~~Gamecube~~. You can download and find more information ~~here:~~

−

**http://www.tehskeen.com/forums/showthread.php?p=44124&posted=1#post44124

=== Note ===

−

*~~XORG~~ is available!

+

*X.Org is available!

**Miight

**XWhiite

**Bliight

**Archii

−

*KDE in the near future?

+

*[http://www.kde.org KDE] in the near future?

−

**No, never will happen. Something light weight like openbox or xmonad is recommended.

+

**No, never will happen. Something light weight like [http://icculus.org/openbox/index.php/Main_Page Openbox] or [http://xmonad.org xmonad] is recommended.

−

**For people who do want a full Desktop Environment, you can use lxde which is simply ~~openbox~~ with a panel, file manager, etc. This is easier for some people and should still be lightweight enough unlike xfce,gnome,~~kde~~.

+

**For people who do want a full Desktop Environment, you can use [http://www.lxde.org LXDE] which is simply Openbox with a panel, file manager, etc. This is easier for some people and should still be lightweight enough unlike [http://www.xfce.org Xfce], [http://www.gnome.org GNOME], KDE.

−

*When ~~e17~~ finally releases a 1.0 it might also be suitable for Linux on Wii as it is also fairly light in comparison to other ~~DEs~~ but still not as light as ~~lxde~~

+

*When [http://www.enlightenment.org Enlightenment] finally releases a 1.0 it might also be suitable for Linux on Wii as it is also fairly light in comparison to other Desktop Environments but still not as light as LXDE.

== Releases ==

==== Note ====

−

No current releases yet support the ~~wii~~'s wireless networking capabilities. This means, that if you want to access the internet or another aspect of your network, you will need a ~~wii usb~~-to-~~ethernet~~ adapter.

+

No current releases yet support the Wii's wireless networking capabilities. This means, that if you want to access the internet or another aspect of your network, you will need a Wii USB-to-Ethernet adapter.

It is also possible to [http://www.gc-linux.org/wiki/Wii_Bluetooth_Network setup a Bluetooth network connection], provided that you have another Linux PC with Bluetooth support nearby.

Line 215: Line 199:

=== Miight ===

*Seems similar to [[Wii Linux#XWhiite|bertjan's]] but was announced first, * It can be installed normally like any other homebrew app (no partitioning needed), and includes many more features. Including the following:

−

** An easy way to switch between TV types (although it does require a restart)

+

**An easy way to switch between TV types (although it does require a restart)

−

** The ability to install a disk image directly onto a normal partition on an SD card or USB drive, meaning absolutely no partitioning or anything.

+

**The ability to install a disk image directly onto a normal partition on an SD card or USB flash drive, meaning absolutely no partitioning or anything.

−

** Many, many more apps

+

**Many, many more apps

−

** An easy-to-use media mounter

+

**An easy-to-use media mounter

−

** Contributions from many users

+

**Contributions from many users

−

** Supertux

+

**Supertux

−

** A pretty screensaver

+

**A pretty screensaver

−

** Probably a lot more that I forgot to list

+

**Probably a lot more that I forgot to list

*It was momentarily leaked but it was soon, for lack of a better term, unleaked.

*<s>A release is expected within the next few weeks.</s> This never happened.

Line 233: Line 217:

=== Bliight ===

−

*A full Gentoo ~~distro~~ for the ~~wii~~.

+

*A full Gentoo distribution for the Wii.

*It uses the whiite method of installation.

*Made by T7g

Line 243: Line 227:

*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 ~~XORG~~ installed along with the OpenBox3 WM and Cwiid for Wiimote input

+

**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

Line 250: Line 234:

=== XWhiite ===

−

*[[Wii Linux#Whiite|Whiite]] but with the ~~XORG~~ environment successfully implemented.

+

*[[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 also includes some applications including Firefox.

−

*It uses the whiite method of ~~instalation~~

+

*It uses the whiite method of installation

*It has now been updated to v0.2

−

* Made by bertjan

+

*Made by bertjan

*[http://www.tehskeen.com/forums/showthread.php?t=9777 Download/Discussion]

=== Kernel 2.6.27 ===

*New drivers with SDHC support, and optimized memory. Updated versions (2.6.27a & 2.6.27b) are also available.

−

*Just replace your current boot.elf/dol with this(for any whiite-linux-method ~~distros~~).

+

*Just replace your current boot.elf/dol with this(for any whiite-linux-method distributions).

*[http://sourceforge.net/project/showfiles.php?group_id=98581&package_id=108737&release_id=640693 Download]

+

=== Whiite ===

*Based on Debian etch 4.0

Line 267: Line 252:

*Currently, only v0.1 is available.

*[http://downloads.sourceforge.net/gc-linux/debian-etch-4.0%2Bwhiite-0.1.tar.bz2 Download].

+

=== PoC ===

−

These are small, stand-alone ~~distros~~ that were merely to demonstrate that ~~linux~~ could run on the ~~wii~~. These ~~distros~~ are very limited in functionality and are not recommended. Instead, use one of the above ~~distros~~ (XWhiite, Bliight are recommended).

+

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.

Line 280: Line 267:

==== 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]

Line 285: Line 273:

== External links ==

* A [http://www.youtube.com/watch?v=8hUSkOLWMZ8 video] showing '''Arch Linux on the Wii''' called, "Archii."

−

* A [http://www.youtube.com/watch?v=aiYbQfDhGKg video] showing a playable '''pacman console game with ~~wiimote~~ support'''

+

* A [http://www.youtube.com/watch?v=aiYbQfDhGKg video] showing a playable '''pacman console game with Wiimote support'''

−

* A [http://www.youtube.com/watch?v=XpDcnaeftsc video] showing '''how ~~wii~~-~~linux debian~~ boots''', with some features and applications

+

* A [http://www.youtube.com/watch?v=XpDcnaeftsc video] showing '''how Wii-Linux Debian boots''', with some features and applications

−

* A [http://www.youtube.com/watch?v=v1UCQEMO8yc video] showing '''T2 SDE 6.0 ~~linux~~ booting from an external HDD using the SD card as pivot root. X runs!'''

+

* A [http://www.youtube.com/watch?v=v1UCQEMO8yc video] showing '''T2 SDE 6.0 Linux booting from an external HDD using the SD card as pivot root. X runs!'''

−

* A [http://www.youtube.com/watch?v=2pvHvcq8qJ8 video] showing T2 SDE 6.0 ~~linux~~ booting from an external HDD using a ramdisk card as pivot root. In this video '''the xserver works with a driver for Wii/~~Gamecube~~ and has correct colours'''

+

* A [http://www.youtube.com/watch?v=2pvHvcq8qJ8 video] showing T2 SDE 6.0 Linux booting from an external HDD using a ramdisk card as pivot root. In this video '''the xserver works with a driver for Wii/GameCube and has correct colours'''

* [http://www.gc-linux.org/ GC-Linux.org]

* [http://downloads.sourceforge.net/gc-linux/ The Official GC-Linux SourceForge Page]

Gu1dry

401

edits