Tosa/Install

From OpenZaurus

This describes how to install OpenZaurus on the Tosa.

NOTE: These instructions are at least partially wrong. For example, there is a hardware reset button. See http://openzaurus.org/wordpress/installation/sl-6000/ for another set of installation instructions.

NOTE2: The above link is now broken. Are there any definitive installation docs or getting started guides?

1 Introduction
2 Download the files
3 Preparations for flashing
4 Flash
5 Troubleshooting

[edit]

Introduction

Three files are required to flash a Tosa. These are a root filesystem image (initrd.bin), a kernel (zImage.bin) and the updater script (updater.sh).

[edit]

Download the files

The initrd.bin contains the root filesystem (including default programs) for OpenZaurus.

There are a number of available initrds:

opie-image contains an Opie based system. This is a QT/Embedded based graphical system (which is most like the original Sharp ROM) (see http://opie.handhelds.org/)
gpe-image contains the a GPE Palmtop Environment based system (see http://gpe.handhelds.org/)
bootstrap-image contains no graphical system
e-image(-core) contains the Enlightenment GUI

If you don’t know which you want then you probably want the opie-image

Download your choice of initrd image (which will be named *-image-*-tosa.initrd.bin or *-*-tosa.rootfs.jffs2) and rename it to “initrd.bin”.

As of 2007 January 25, the latest (experimental) files are in http://ewi546.ewi.utwente.nl/tmp/hrw/3.5.4.2-test/rc2/

The zImage.bin file contains the Linux kernel used in OpenZaurus.

Download the kernel (named zImage.bin) and rename to zImage.bin if necessary.

The filenames are case sensitive. Note the capital I in zImage.bin.
Put files in the root directory of your CF card /mnt/cf (The flasher program asks you if you want to use CF or SD, so it is possible to use an SD instead of a CF card).

[edit]

Preparations for flashing

Backup your files.

Note that the flashing process does not erase your /home directory, therefore settings from other systems may remain there and possibly cause problems. If you are flashing an opie-image, make sure you remove the /home/root/Settings/ directory before you flash to ensure that this does not happen.

Check the md5sums of the initrd.bin, zImage.bin and updater.sh files and compare them with the list (or filenames + .md5) in the download directory to ensure that they have not been corrupted during the download.

[edit]

Flash

The steps to flash the are:

Ensure that your SL-6000 machine has a standard flash partitioning (e.g. as it was originally), flashing may fail if this is not the case
Connect to external power, either by putting in cradle, connecting to the +5V DC power jack, or using a sync/charge cable. The orange battery charge lamp must be on indicating external power, or you will get an error message in japanese later.
Press the reset button on the back (top left) with the stylus; this makes a definite click.
Insert the CF card with the image in the root, as described above.
Press power switch whilst holding down the "OK" key
The Maintenance Screen will display. Choose "Update" this is item 4.
The next screen will ask the source, choose "CF" this is item 2.
The next screen asks for confirmation, choose "Yes" this is the left button

The Zaurus will now erase the root filesystem and write the new image.

If you are not using 3.5.4.2-rc2, when you see the message: "Rebooting"… then remove all your CF and SD cards, just before booting for the first time with an opie-image, otherwise you get stuck in the new-medium-found dialog (as the touch screen will not yet have been calibrated).

If you are using 3.4.2-rc2, you will see a message asking you to reset the machine (instead of "Rebooting"). Press reset and immediately remove the flash memories (things appear to go wrong if you do this in the other order).

The Zaurus will now reboot to your new Operating System. You will be asked various skill-testing questions.

[edit]