Gentoox Loader v6.03c
---------------------

  Copyright (C) Thomas "ShALLaX" Pedley (gentoox@shallax.com)

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

------------------------------------------------------------------------------

-0.5 - DISCLAIMER
 0.0 - Preamble
       0.1 - Changelog
 1.0 - Installation
 2.0 - Notes

-----------------

-0.5 DISCLAIMER

This Linux distribution contains no copyrighted Microsoft code, no hacked
executables, no illegally compiled executables and no other illegal 
material to the best of my knowledge.  If anything is later discovered
to be illegal, when given reasonable proof, this distribution will be
taken out of circulation and destroyed and you must do the same.

This software comes with absolutely no warranty and I will not be held 
liable for anything bad that comes of using it.  I will not be held
responsible for any losses incurred from using this software.

This software has the potential of ruining all the data stored on your
Xbox including your TSOP or modchip.  You use this software and any 
subsequent software downloaded by this tool at your own risk.

Gentoox is distributed under the GNU General Public License.

-----------------

0.0 - Preamble

This is the Gentoox loader.

0.1 - Changelog

v6.03c
-----
* I'll get there eventually.  Skipping the initrd now works correctly.

v6.03b
-----
* Maybe this time I'll remember to regenerate the webpages correctly so that
  the typo actually goes away!

v6.03a
-----
* Fixed a typo on the first Net Boot page.
* Remembered to include the updated manual this time!
* Fixed a typo in the manual.

v6.03
-----
+ Added "Net Boot".  This allows you to upload a kernel, initrd and append 
  line to your Xbox via your web browser.

v6.02
-----
+ Reboot while network client/ server active:
   If you have selected Net Flash, Net Boot, Web Boot or Web Update and want to
   cancel the operation, you can now press "X" on your Xpad 3 (long) times 
   (approx)  and the Xbox will reboot.  The reason I say "approximately" is 
   because sometimes Gentoox Loader doesn't register button presses due to the 
   way the TCP timer functions - if it doesn't reboot first time, just keep 
   pressing.
+ You can now select the URL where your packlet is located (see Net Boot notes
  below)
* IP selection much nicer:
   You can press left/right on the D-Pad now to scroll up and down through the
   numbers.  The "A" button will skip upwards by 10.
* Timeout on text menus and timeouts shown when active:
   Selected text menus can now have timeouts (currently only the IP menu does).
   When a timeout is active in any part of Gentoox Loader, the seconds remaining
   are shown in small brackets on the screen.
* Greatly lowered the menu timer latency (10ms now instead of 75ms).  This
  provides for a much more responsive GUI.
   

v6.01
-----
+ Web Update:
   Get the latest Gentoox Loader automatically from the internet.

v6.00
-----
+ Net Boot:
   This is a new option which can be selected from the icon menu.  Once selected
   a text menu will prompt you for an IP address in the format A.B.C.D with a
   port number P.  The default is for SourceForge's HEAnet mirror.  You can 
   substitute this IP for any of the other SourceForge IPs.  For now, all NetBoot
   does is download and run Resctoox.  No information is written to the hard
   drive - everything is done in memory so it should be possible for anybody
   to run this.

v5.11
-----
* Cosmetic changes:
  * v1.6 support (everything is closer to the centre of the screen)
  * The "Gentoox Loader" banner always shows on root screens but is
    hidden on menu screens.  (Previously once a menu was shown, the 
    banner was lost forever).
  * Various colour tweaks.
  * Changed "MB" to "MiB" on the RAM text.
  * Renamed "Stardust" references to "CD/DVD".
  - Removed "Net Flash" caption.
* Xbox temperature information error now displayed for v1.6 instead
  of a blank screen.
* Fixed the LED sequences at some stages.

v5.10
-----
* Broken video EEPROM settings can now be fixed.

v5.9
----
* Changed the way Left/ Right icons work (they only show if needed).
* Added "Net Flash" caption.
+ Added "Info Menu" which displays temperatures/ EEPROM info etc...

v5.8
----
* Changed LED code.
* Speed up the "..." dots.
+ Added Left/ Right icons to the icon menu which highlight
  when more choices are available off screen.
* Changed "Advanced" icon.
* Cleaned up icons.

v5.7
----
- Can no longer abort Net Flash - introduced a networking bug.

v5.6
----
* Cleaned up text layout of various menu functions.
* Reordered menus.
* Fixed HDD Flash menu caption.
+ Net Flash abort (via 'B' button).
+ LED Menu.
+ CD Menu.

v5.5
----
+ HDD Flash.

v5.4
----
+ Added a load of flash types.

v5.3
----
+ CD Flash (image.bin)
* Moved Net Flash to text menu.
* Net Flash no longer takes over Etherboot.
* Documentation tweaks.

v5.2
----
+ Net Flash.

v5.1a
-----
+ Bug fixes
+ Display boot status for native installations.

v5.1
----
+ Changed disc checking logic
+ Native partition support

v5.0
----
+ Text menus.
+ New background.
+ Separate binaries for Xbox v1.0-1.6 and v1.6b.
+ Multiple kernel support.
+ TV format selection.
+ HDD Lock/ Unlock.

v4.7
----
+ Xbox v1.6b (Hynix RAM) support.

v4.6
----
+ Focus S-Video support.

v4.5
----
+ Preliminary Xbox v1.6 (Xcalibur) support.
+ Fixed DOS formatted linuxboot.cfg parsing.

v4.1
----
WITHDRAWN - bugged, do not use!

v4.0
----
+ Sparkle integration.
+ Focus support.
+ HDTV support.
+ useful LED feedback.

-----------------

1.0 - Installation

+ Copy 'loader.xbe' to E:\gentooxx.xbe (/mnt/fatx/e/gentooxx.xbe)

+ Flash 'loader.bin' to your TSOP/ Modchip (raincoat -p loader.bin)

-----------------

2.0 - Notes

Net Boot
--------

With this option you can upload any kernel, initrd and append combination to
your Xbox that you wish via your web browser.  This is especially useful for
systems that cannot be booted via CD/DVD or HDD.

Web Boot
--------
* Use Left and Right on the D-Pad to scroll through possible characters for the
  current selected character.
* Select "->" to add a new character.
* Select "<-" to delete the last character.
* Select "Uppercase" to either switch your current lowercase character to
  uppercase, or to go straight to "A".
* Select "Lowercase" to either switch your current uppercase character to
  lowercase, or to go straight to "a".
* Select "Numbers" to go straight to "0".
* Select "Fullstop (.)" to enter a fullstop (period).
* Select "Forward slash (/)" to enter a forward slash.
* Select "Dash (-)" to enter a dash.
* Select "Underscore (_)" to enter an underscore.
   
Note that you are limited to the ASCII character range of 0x21 to 0x7E - this
includes all human readable characters.  You can scroll through ALL of these
characters using the left and right buttons on the D-pad.  The above 
"shortcuts" are only added for convenience - they do not have to be used.
Obviously allowing all of these characters to be used means the user can
form invalid URLs - this is your lookout!

When the line gets longer than 21 characters, it will insert a linebreak, 
this linebreak is NOT a character in your text, it is merely screen 
formatting.  The new line will NOT appear in your URL.

The default server is:
 192.1.193.66:80 (HEAnet - Sourceforge)

The default URL is:
 /sourceforge/xbox-linux/resctoox.t00x

Your URLs are limited in the following ways:
 1) Must start with a '/' (you cannot delete the initial '/').
 2) Can be no longer than 120 characters (the screen will stop you from
    entering URLs longer than this).

Net Flash
---------

Net Flash enables you to flash a new BIOS from within Cromwell over an HTTP
connection (via a web browser, for instance).  Utilisation is very simple -
select the "Advanced" icon, then select "Flash Menu", finally select 
"Net Flash".

Once selected, Gentoox Loader will attempt to initialise the Xbox's network 
card and find an IP address via DHCP.  If you do not have a DHCP server setup,
don't worry, Gentoox Loader will fall back to 192.168.1.13 after 30-60 seconds.

After an IP has been selected, simply go to "http://the.ip.shown.onscreen" in
any web browser (tested with IE6) and follow the instructions on screen.


CD Flash
--------

Access this from the same menu as "Flash Menu".

You need a CD with a single "image.bin" file on it which is divisible by 256 
in size (e.g. 256K, 512K, 768K, 1024K...).


HDD Flash
----------

Access this from the same menu as "Flash Menu".

BIOS files will be read from C:\BIOS (case insensitive).  ONLY valid BIOS
files will be shown (i.e. subdirectories will not be listed, neither will
files which are not the correct size).  Correct sized BIOS files should be
divisible by 256 in size (e.g. 256K, 512K, 768L, 1024K...).

If you dont have a C:\BIOS path, you cannot use this feature.


FLASHING YOUR BIOS
------------------

WARNING: This will overwrite anything contained on either a modchip or TSOP
         (depending on which you booted from).  Make sure you select the right
         BIOS bank to flash on your modchip and make sure you flash the correct
         size of BIOS.  If you do not pay attention to this, you could render
         your modchip, or worse... your TSOP useless.  

         !!!!CHECK WHAT SIZE YOUR MODCHIP/ TSOP IS BEFORE FLASHING A BIOS!!!!
         
         I will not accept any responsibility for any corrupt flashes that may
         occur from using this software.  You have been warned.


General Notes
-------------

LED feedback:
	rgog = Busy.
	oxox = User input available.
	gxgx = Boot successful.
	rxrx = Error.

The menu does not repeat, so if you want to boot from the CD, just keep hitting
left on your Xpad/ keyboard, then press 'A' or enter to confirm.  If you want 
to boot from FatX, keep hitting left, then press right once and then press 'A'.
The advanced menu is the far right Icon.

With no OS installed, Gentoox loader will boot from the DVD drive by default,
once Gentoox has been installed, the loader will automatically boot it.

If you move your pad at all while the menu is being shown, the timeout will be
cancelled and the menu will wait for you to make a selection.

To boot Gentoox manually, select the "FatX" icon, then select "Gentoox"
from the text menu.

There is a separate binary for Xbox v1.6b owners.  This is only needed if you
are flashing to a modchip.  If you boot via loader.xbe, the same should work
for all Xbox versions.  If you know you have a v1.6 and the standard
"loader.bin" does not work, try using "loader-v1.6b.bin".

	
		- Thomas "ShALLaX" Pedley (gentoox@shallax.com)

[eof]
