Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Boot It Wii: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 15: Line 15:
|license=Apache
|license=Apache
|download=https://dlhb.gamebrew.org/wiihomebrews/bootitwii.7z
|download=https://dlhb.gamebrew.org/wiihomebrews/bootitwii.7z
|website=
|website=https://gbatemp.net/threads/bootit.129106/
|source=
|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).
1) 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.


2) 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==
==External links==
* Wiibrew - https://wiibrew.org/wiki/Boot_it
* GBAtemp - https://gbatemp.net/threads/bootit.129106/
* WiiBrew - https://wiibrew.org/wiki/Boot_it

Revision as of 13:25, 12 February 2023

Boot it
File:Bootitwii.jpg
General
Authornuvalo
TypeOperating systems
Version2009
LicenseApache License 2.0
Last Updated2009/01/11
Links
Download
Website

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

Advertising: