Top || Section Contents || Permuted Index
SavaJe OS 1.1.0

upgrade_ipaq(doc)

Upgrading to SavaJe OS 1.1.0 on a Compaq iPAQ

If you already have version 1.0.0 of SavaJe XE installed on an iPAQ, you can upgrade to version 1.1.0 in one of three ways. The fastest and easiest way for upgrading to 1.1.0 from 1.0.0 is by using the third method. By using the third method, no additional steps are necessary to re-install your existing license token. If you have a Windows 2000 PC/laptop, you can use the Windows Setup Utility that comes with the OS download or you can follow the manual upgrade method. Both of these methods require a serial (RS-232) cable (Compaq Part Number 191008-B21). The third method requires you to extract and copy a subset of the files from the XE 1.1.0 distribution to a CF card. Briefly peruse the time, software and hardware requirements of the three methods to see which one is best for you.

The SavaJe OS archive contains several files relating to the Windows Setup Utility and several files that are actually transferred to the iPAQ (e.g., OS files, apps, bootldr.) Download and extract the archive from the Download Center to your PC.

The archive includes

File	Contents
Setup.exe	Windows Setup Utility executable
SavaJe_XE_1.1.upg	A data file that informs the setup utility of OS build specific information for an upgrade.
Setup.log	(Not part of the archive, but will be generated in this location during installation using Setup.exe)
jbitsy.bin.gz	SavaJe OS kernel
rt-bitsy.jar	Java classes
savaJe.romfs	SavaJe OS utilities archive
apps.romfs	3rd party Java applications archive
bootldr-0000-2.14.17-bigkernel-mono-savaJe4	New SavaJe OS bootloader

Backup existing data from /ramfs

During this upgrade, any files in /ramfs will be erased. You can back up data to either a compact flash card or to an SMB file system.

Compact flash card

• Insert a compact flash card in an external sleeve. This will be mounted as /cf0 .
• Use the backup tool (see backup(tools) ) to backup your files to the compact flash.

SMB file system

• Open lsh from the Tools tab.
• Mount the SMB filesystem by typing

  mount smb://user:password@machinename/sharename 
  

  This will be mounted as /smb0 .
• Using cp , you can copy files to /smb0 . See cp(shell) .

Pre-installation procedures

• Make sure your iPAQ is connected to a power supply (THIS IS IMPORTANT. Losing power during the bootloader installation portion of the upgrade could permanently disable your iPAQ.)
• Connect your iPAQ to your PC with your serial cable.

Installation

1. Run Setup.exe
2. If prompted for a COM port, choose the COM port that your iPAQ is connected to. If not prompted, select the menu item 'Options->Change COM Port' and choose the appropriate COM Port.
3. Press the "Upgrade SavaJe OS " button
4. The setup utility will prompt you to select a SavaJe OS upgrade file. Select the SavaJe_XE_1.1.upg file.
5. Next, if you do not have a valid token installed, the setup utility will prompt you for a token file. The token is required to unlock the system and should have been e-mailed to you. Select the SavaJe_XE-lic_....tok file that was e-mailed to you.
6. The setup utility will next display a list of OS files that you can load. Leave all of the check boxes checked and press the "Next" button.
7. Click OK at the next window that appears to begin the file transfer. Be patient. This will take about an hour .
8. At the end of the installation, reset the iPAQ by inserting the stylus into the recessed hole on right side of the bottom of the iPAQ.
9. Congratulations. You have completed the upgrade. See get_started(doc) for further instructions.

• A Terminal Emulator (e.g., The HyperTerminal program bundled with MS Windows)
• md5sum.exe from http://www.etree.org/md5com.html (optional)

The SavaJe OS archive

The SavaJe OS OS is bundled along with a few public domains tools that you will use during SavaJe OS installation as well as files relating to the Windows Setup Utility . Download and extract the archive from http://www.savaje.com/support to your PC. The files relevant to this installation are as follows:

File	Contents
jbitsy.bin.gz	SavaJe OS kernel
rt-bitsy.jar	Java classes
savaJe.romfs	SavaJe OS utilities archive
apps.romfs	3rd party Java applications archive
bootldr-0000-2.14.17-bigkernel-mono-savaJe4	New SavaJe OS Bootloader

Backup existing data from /ramfs

During this upgrade, any files in /ramfs will be erased. You can back up data to either a compact flash card or to an SMB file system.

Compact flash card

• Insert a compact flash card in an external sleeve. This will be mounted as /cf0 .
• Use the backup tool (see backup(tools) ) to backup your files to the compact flash.

SMB file system

• Open lsh from the Tools tab.
• Mount the SMB filesystem by typing

  mount smb://user:password@machinename/sharename 
  

  This will be mounted as /smb0 .
• Using cp , you can copy files to /smb0 . See cp(shell) .

Install and configure serial cable

To communicate with the SavaJe bootloader via a serial cable:

1. Make sure your iPAQ is connected to a power supply.
2. Connect your iPAQ to a PC with the serial cable.
3. Use a terminal emulator program (e.g., HyperTerminal comes with MS Windows, Minicom usually comes with Linux) and connect to the COM port at 115200 baud, 8 bits, no parity, 1-Stop bit, No Flow Control.
4. Reboot your iPAQ by inserting the stylus into the reboot hole (bottom of iPAQ on right side.)
5. When the SavaJe splash screen appears, push and release the calendar button quickly to get the boot> prompt on the terminal. You may need to push the calendar button several times before you get the boot> prompt. You are now using the SavaJe bootloader via the terminal emulation program. Save the settings in your terminal emulator.

WARNING: Critical Step!

Update the bootloader

Warning: this step can permanently disable your iPAQ if not completed properly.

There is a new bootloader that you will need to install.

To communicate with the SavaJe bootloader via a serial cable:

1. Make sure your iPAQ is connected to a power supply.
2. Connect your iPAQ to a PC with the serial cable.
3. Use a terminal emulator program (e.g., HyperTerminal comes with MS Windows, Minicom usually comes with Linux) and connect to the COM port at 115200 baud, 8 bits, no parity, 1-Stop bit, No Flow Control.
4. Reboot your iPAQ by inserting the stylus into the reboot hole (bottom of iPAQ on right side.)
5. When the SavaJe splash screen appears, push and release the calendar button quickly to get the boot> prompt on the terminal. You may need to push the calendar button several times before you get the boot> prompt. You are now using the SavaJe bootloader via the terminal emulation program. Save the settings in your terminal emulator.

• Reset your iPAQ. (You can reset the iPAQ by pressing the reset button at the lower right corner of the machine with your stylus.) Read your iPAQ manual if you cannot locate the reset button.
• Your iPAQ will now boot with SavaJe OS .
• Read get_started(doc) for further instructions.

Installing a license token

• Copy the SavaJe OS license token (.tok ) to the CF card and insert the CF card in the sleeve. Click Enter Token -> From File , then select .tok from /cf0 and click OK .
• Enjoy the freedom of running full J2SE applications on your iPAQ.
• Congratulations! See get_started(doc) for further instructions, and refer to our support site for any questions.

For more details on the features and capabilities of the SavaJe Flash Utility , see flash_util(doc) .

Pre-Requisites

Hardware

• CF Card and CF Card Expansion Sleeve OR
• CF Card + CF Adapter and PC Card Expansion Sleeve

Backup existing data from /ramfs

During this upgrade, any files in /ramfs will be erased. You can back up data to either a compact flash card or to an SMB file system.

Compact flash card

• Insert a compact flash card in an external sleeve. This will be mounted as /cf0 .
• Use the backup tool (see backup(tools) ) to backup your files to the compact flash.

SMB file system

• Open lsh from the Tools tab.
• Mount the SMB filesystem by typing

  mount smb://user:password@machinename/sharename 
  

  This will be mounted as /smb0 .
• Using cp , you can copy files to /smb0 . See cp(shell) .

Installation

1. After you download and extract the upgrade ZIP file, do the following:
   • load the following files to the root directory of a blank FAT12 (ordinary PC formatted) CF Card:

     jbitsy.bin.gz 
     rt-bitsy.jar 
     savaJe.romfs
     apps.romfs
     

   • Insert the CF Card into the iPAQ via a CF Card expansion sleeve or a PC Card expansion sleeve with CF adapter.
   • Next, launch the SavaJe Flash Utility (The following steps are purposely convoluted to make it impossible to accidentally get to this utility. Follow the instructions exactly and read the next two steps carefully before proceeding.)
   1. Reboot the device by inserting your stylus into the recessed hole in the bottom right hand side of the iPAQ. As soon as you see the hand screen appear, press and hold the D-PAD in the center and straight down (D-PAD is the large round joystick like button on the bottom front of the iPAQ.)
   2. Continue to hold down the D-PAD until a grey screen appears that says" SavaJe Flash Utility ."
   • Use the D-pad to move up and down the list of options and press right with the D-Pad to select an option. In this case select "Copy from file to flash..."
   • Select jbitsy.bin.gz from the file list and then kernel from the partition list. When you say "Yes" to the "are you sure" prompt, the utility will copy the file to the Flash ROM.
   • Similarly, select rt-bitsy.jar from the file list and then rt.jar from the partition list. When you say "Yes" to the "are you sure" prompt, the utility will copy the file to the Flash ROM.
   • Repeat the above procedure to copy savaJe.romfs to the savaJe partition.
   • Repeat the above procedure to copy apps.romfs to the apps partition.
2. Reboot the machine by selecting the Reboot option
3. Congratulations, You've done it! Now, enjoy the freedom of running full J2SE applications on your iPAQ. See get_started(doc) for further instructions refer to our support site if you have any questions.