Boot It Wii: Difference between revisions

Boot it
Boot it
General
Author	nuvalo
Type	Operating Systems
Version	2009
License	Apache License 2.0
Last Updated	2009/01/11
Links
	Download
	Website

Latest revision as of 09:35, 7 Mayıs 2024

Boot It is a Linux loader that allows users to run disc images from an SD card or USB device without the need for partitioning. It functions similarly to a Linux live CD, but with the added ability to make changes to the "disc" during the Linux session. In addition, it is also capable of booting normal Linux partitions.

Features

Boot a filesystem installed on any Wii Linux compatible device.
Load from a filesystem image, which should simplify the use of Wii Linux for users who don't want to do partitions on the SD card.
Support for wireless modules, requires udev and wireless tools on xwhiite to use (the only wireless driver tested is Ralink RT2501USB).

Installation

Requirements

1GB SD card (2GB for Bliight), or a similar USB hard disc, formatted on Fat32 (NTFS is not supported by the kernel).
A Wii console with the Homebrew channel or Twilight Hack installed.
Wii Linux disc image, such as xWhiite or Bliight.
USB Keyboard.

(Optional) USB-HUB, USB-mouse, USB-wireless/ethernet adapter (see known issues).

How to install

Copy the "apps" directory to the root of your SD card.

If you want to boot a preinstalled wiilinux filesystem (using whiite or whiite installer), copy the "pivot_root" and "chroot" files inside the "extra" directory to your filesystem "/bin" directory, and create a directory called "/old-root" in the root of your filesystem.

If you want to boot any of the filesystem images (bliight.img or xwhiite.img), copy them to the root of your device (SD card or USB hard disk).

User guide

How to use

Launch "boot-it" using the Homebrew Channel. The first time it will show you a menu:

Boot installed system - Access the boot menu.
Return to Wii menu - Allows you to reboot.

Use the keyboard arrows to move up/down the selected option, ad press "Enter". If you selected "Boot installed system" you will see a new menu:

USB - Boot a filesystem installed on a USB hard disk partition.
SD card - Boot a filesystem installed on a SD card partition.
Disc image - Boot a filesystem image file on a USB or SD card.

If you choose USB or SD card, you will see a menu to select the partition (1,2,3...). Introduce the partition number. and press enter.

If you choose "Disc image", It will ask you the device where it is installed (USB o SD card), and then you will have to introduce the filename (bliight.img, xwhiite.img, etc...).

If it boots successfully, a configuration file called "wiilinux.cfg" will be created in the root of your SD card. You can delete it if you want to reconfigure "boot it".

Creating compatible filesystem images

These steps show how to create a new uncompressed filesystem image under Linux:

Step 1 Create an empty file:

dd if=/dev/zero of=<filename> count=<number of MB> bs=1M

Step 2 Format it in ext2/3:

mkfs.ext2 <filename>

Step 3 Mount the file and copy the filesystem:

mount -o loop,rw <filename> <path_to_mount>

cp -r <path_to_filesystem>/* <path_to_mount>

Step 4 Umount it, and detach it from /dev/loop:

umount <path_to_mount>

losetup -d /dev/loop0 (ususally /dev/loop0, might be loop1,2...etc)

Step 5 Copy it to the root of the first partition of the SD card/USB.

Known issues

The USB Keyboard does not work - If you have a USB mouse plugged in, interchange the USB port where they are plugged, or unplug the mouse.

It says that some files are missing (pivot_root, chroot, old-root) - If you are booting a previously installed Wii Linux (xwhiite or bliight installed in the second partition of your SD card), you will have to copy the contents of the "extras" directory to the root of your wiilinux filesystem.

Credits

Thanks to all the wii-linux developers:

The gc-linux team and Isobel, who did this possible.
All the #wii-linux contributors: Muzer, Bertjan, T7g... the list is very long.
Special thanks to t7g and berjan for "bliight" and "xwhiite".
Of course, thanks to the Team Twiizers, for their Homebrew channel and Twilight hack.

External links

GBAtemp - https://gbatemp.net/threads/bootit.129106/
WiiBrew - https://wiibrew.org/wiki/Boot_it

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Wii Homebrew Apps (Operating systems) - GameBrew
-|title_mode=append
-|image=bootitwii.jpg
-|image_alt=Boot it
-}}
 {{Infobox Wii Homebrews
 |title=Boot it
-|image=bootitwii.jpg
+|image=bootitwii2.png
-|description=Linux loader designed for use with disc images
+|description=Linux loader designed for use with disc images.
 |author=nuvalo
 |lastupdated=2009/01/11
-|type=Operating systems
+|type=Operating Systems
 |version=2009
 |license=Apache
 |download=https://dlhb.gamebrew.org/wiihomebrews/bootitwii.7z
-|website=
+|website=https://gbatemp.net/threads/bootit.129106/
-|source=
+}}
-}}0
+Boot It is a Linux loader that allows users to run disc images from an SD card or USB device without the need for partitioning. It functions similarly to a Linux live CD, but with the added ability to make changes to the "disc" during the Linux session. In addition, it is also capable of booting normal Linux partitions.
-'''Boot It''' is a Linux loader that allows users to run disc images from an SD card or USB device without the need for partitioning. It functions similarly to a Linux live CD, but with the added ability to make changes to the "disc" during the Linux session. In addition, it is also capable of booting normal Linux partitions.
-== Minimum Requirements ==
+==Features==
-*1 GB SD card
+*Boot a filesystem installed on any Wii Linux compatible device.
-*USB Keyboard
+*Load from a filesystem image, which should simplify the use of Wii Linux for users who don't want to do partitions on the SD card.
-*Wii with [[Twilight Hack Wii|TPHack]] or [[Homebrew Channel Wii]]
+*Support for wireless modules, requires udev and wireless tools on xwhiite to use (the only wireless driver tested is Ralink RT2501USB).
-*Wii Linux disc image, such as
-**[[Xwhiite Linux Wii]] or
-**Bliight (requires 2GB card)
-== Installation ==
+==Installation==
-# Copy the "apps" directory to the root of your SDCard
+===Requirements===
-# If you want to boot a preinstalled wiilinux filesystem (using whiite or whiite installer), copy the "pivot_root" and "chroot" files into the "extra" directory to your filesystem "/bin" directory, and create a directory called "/old-root" in the root of your filesystem.
+* 1GB SD card (2GB for Bliight), or a similar USB hard disc, formatted on Fat32 (NTFS is not supported by the kernel).
-# If you want to boot any of the filesystem images (bliight.img or xwhiite.img), copy them to the root of your device (SDCard or USB hard disk)
+* A Wii console with the [[Homebrew Channel Wii|Homebrew channel]] or [[Twilight Hack Wii|Twilight Hack]] installed.
+* Wii Linux disc image, such as [[XWhiite Linux Wii|xWhiite]] or Bliight.
+* USB Keyboard.
-== Usage ==
+(Optional) USB-HUB, USB-mouse, USB-wireless/ethernet adapter (see known issues).
-) Launch "boot-it" using the Homebrew Channel. The first time it will show you a menu:
-'''Boot installed system''' lets you access the boot menu
+===How to install===
+Copy the "apps" directory to the root of your SD card.
-'''Return to Wii menu''' lets you reboot
+If you want to boot a preinstalled wiilinux filesystem (using whiite or whiite installer), copy the  "pivot_root" and "chroot" files inside the "extra" directory to your filesystem "/bin" directory, and create a directory called "/old-root" in the root of your filesystem.
-) Use the keyboad arrows to move up/down the selected option, ad press "Enter". If you selected
+If you want to boot any of the filesystem images (bliight.img or xwhiite.img), copy them to the root of your device (SD card or USB hard disk).
-"Boot installed system" you will see a new menu:
+==User guide==
+===How to use===
+Launch "boot-it" using the Homebrew Channel. The first time it will show you a menu:
+* Boot installed system - Access the boot menu.
+* Return to Wii menu - Allows you to reboot.
-Select '''USB''' to boot a filesystem installed on a USB hard disk partition.
+Use the keyboard arrows to move up/down the selected option, ad press "Enter". If you selected "Boot installed system" you will see a new menu:
+* USB - Boot a filesystem installed on a USB hard disk partition.
+* SD card - Boot a filesystem installed on a SD card partition.
+* Disc image - Boot a filesystem image file on a USB or SD card.
-Select '''SDCard''' to boot a filesystem installed on a SDCard partition.
+If you choose USB or SD card, you will see a menu to select the partition (1,2,3...). Introduce the partition number. and press enter.
-Select '''Disc image''' to boot a filesystem image file on a USB or SDCard.
+If you choose "Disc image", It will ask you the device where it is installed (USB o SD card), and then you will have to introduce the filename (bliight.img, xwhiite.img, etc...).
-If you select '''USB''' or '''SDCard''', you will see a menu to select the partition (1,2,3...). Introduce the partition number. and press enter.
+If it boots successfully, a configuration file called "wiilinux.cfg" will be created in the root of your SD card. You can delete it if you want to reconfigure "boot it".
-If everything is OK, it will start to boot that filesystem
+===Creating compatible filesystem images===
+These steps show how to create a new uncompressed filesystem image under Linux:
-If you select "Disc image", It will ask you the device where it is installed (USB o SDCard), and then you will have to introduce
+Step 1 Create an empty file:
-the filename (bliight.img, xwhiite.img, etc...).
+<code>dd if=/dev/zero of=<filename> count=<number of MB> bs=1M</code>
-If everything is OK, a file called "wiilinux.cfg" will be created in the root of your SDCard. There will be saved the configuration. If
+Step 2 Format it in ext2/3:
-you want to reconfigure "boot it", delete that file.
+<code>mkfs.ext2 <filename></code>
-==Screenshot==
+Step 3 Mount the file and copy the filesystem:
-[[Image:bootitwii.jpg]]
-== Creating compatible filesystem images ==
+<code>mount -o loop,rw <filename> <path_to_mount></code>
-These steps show how to create a new uncompressed filesystem image under Linux:
+<code>cp -r <path_to_filesystem>/* <path_to_mount></code>
-'''Step 1:''' Create an empty file: <br/>
+Step 4 Umount it, and detach it from /dev/loop:
-dd if=/dev/zero of=<filename> count=<number of MB> bs=1M
-'''Step 2:''' Format it in ext2/3<br/>
+<code>umount <path_to_mount></code>
-mkfs.ext2 <filename>
-'''Step 3:''' Mount the file and copy the filesystem<br/>
+<code>losetup -d /dev/loop0</code> (ususally /dev/loop0, might be loop1,2...etc)
-mount -o loop,rw <filename> <path_to_mount><br/>
-cp -r <path_to_filesystem>/* <path_to_mount><br/>
-'''Step 4:''' Umount it, and detach it from /dev/loop<br/>
+Step 5 Copy it to the root of the first partition of the SD card/USB.
-umount <path_to_mount><br/>
-losetup -d /dev/loop0 (ususally /dev/loop0, might be loop1,2...etc)<br/>
-'''Step 5:''' Copy it to the root of the first partition of the SDCard/USB <br/>
+==Known issues==
+The USB Keyboard does not work - If you have a USB mouse plugged in, interchange the USB port where they are plugged, or unplug the mouse.
-== Known Problems ==
+It says that some files are missing (pivot_root, chroot, old-root) - If you are booting a previously installed Wii Linux (xwhiite or bliight installed in the second partition of your SD card), you will have to copy the contents of the "extras" directory to the root of your wiilinux filesystem.
-*If you have a USB mouse plugged in, it could interfere with the USB keyboard. If the keyboard doesn't work, then interchange the usb ports where they are plugged, or unplug the mouse.
-*If you are booting a previously installed wiilinux (xwhiite or bliight installed in the second partition of your sdcard) you will have to copy the contents of the "extras" directory to the root of your wiilinux filesystem or it will give you a message that some files are missing (pivot_root, chroot, old-root).
+==Credits==
+Thanks to all the wii-linux developers:
+* The gc-linux team and Isobel, who did this possible.
+* All the #wii-linux contributors: Muzer, Bertjan, T7g... the list is very long.
+* Special thanks to t7g and berjan for "bliight" and "xwhiite".
+* Of course, thanks to the Team Twiizers, for their Homebrew channel and Twilight hack.
 ==External links==
-* Wiibrew - https://wiibrew.org/wiki/Boot_it
+* GBAtemp - https://gbatemp.net/threads/bootit.129106/
+* WiiBrew - https://wiibrew.org/wiki/Boot_it