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

install_ipaq(doc)

Installing SavaJe OS 1.1.0 on a Compaq iPAQ (3600s, 3700s, and 3800s)

This page gives instructions for installing SavaJe OS onto a Compaq iPAQ device. Please direct any questions regarding installation to support@savaje.com . The instructions for installing SavaJe OS on 3600s/3700s are same as the instructions for the 3800 series. However, the binary images are different. A file name with "bitsy" in its name is used to represent files related to the 3600s and 3700s. The name "nomad" is used for files related to the 3800 series. There are three methods for installation. Read the description and hardware requirements of each method to choose the method that best suits you.

NOTE:

---

Installation using the USB cradle is not yet supported.

---

The first method is to use the Windows Setup Utility that is included with your SavaJe OS download. The Windows Setup Utility requires Microsoft Windows NT/2000 and largely automates the process of preparing the iPAQ, backing up Windows CE and copying the various OS files to the iPAQ.

NOTE:

---

Windows Millennium Edition is currently unsupported by the Windows Setup Utility .

---

The second method is the manual installation method. This method is provided for users who don't have a Windows 2000 machine. Both of these methods transfer the SavaJe OS files from a desktop PC to the iPAQ via a serial cable and take about one hour for the files to transfer due to the slow throughput of the serial connection. If you back up Windows CE, plan on taking an additional hour.

The third method uses the manual installation method to load the bootloader and the OS kernel and it then uses the SavaJe Flash Utility , which resides in the kernel to load the rest of the SavaJe OS files onto the the iPAQ from a CF Card. This method takes about 15 minutes (10 minutes to load the kernel and then 5 minutes to load everything else from the CF Card).

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

The SavaJe OS archive contains several files relating to the 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
RemoteSetup.exe	Windows Setup Utility module with bootloader
SavaJe_XE_1.1.sxe	A data file that informs the setup utility of OS build specific information for a virgin install.
Setup.log	(Not part of the archive, but will be generated in this location during installation using Setup.exe. Send this file if you contact support for any installation issues.)
jbitsy.bin.gz	SavaJe OS Kernel (jnomad.bin.gz for 3800s distribution)
rt-bitsy.jar	Java Classes (rt-nomad.jar for 3800s)
savaJe.romfs	SavaJe OS Utilities archive
apps.romfs	3rd party Java Applications archive
bootldr-0000-2.14.17-bigkernel-mono-savaJe4	SavaJe OS bootloader file
md5sums/*.md5sum	md5 sum values used to verify a correct download

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 install could cause harm to your iPAQ.)
• Connect your iPAQ to your PC with a serial cable.
• Configure your iPAQ to use a serial connection by tapping Start->Settings->Connections->PC. Then select 115200 Default from the drop down menu.
• Install Microsoft Active Sync. (Follow the instructions in your Compaq iPAQ manual to install Microsoft Active Sync. ActiveSync should be configured to work with serial cable on the COM port your iPAQ is connected to (typically COM1.) You can do this from within ActiveSync by clicking File -> Connection Settings . Then, click on the check box next to "Allow serial cable or serial connection to this COM port."
• All your files should be at the same directory level as the Setup.exe file.

Installation

1. Run Setup.exe .
2. If prompted, 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 "Install SavaJe OS " button.
4. A pop-up window will prompt you for the location of your token. The token unlocks the system and should have been sent to you by e-mail. Navigate to the SavaJe_XE-lic_....tok file and select it.
5. The setup utility will give you the option of backing up Windows CE. To backup Windows CE, leave the check box selected and click the Next button.
6. Click OK at the next dialog box to begin the file transfer. Be patient: this will take about one hour .
7. At the end of the installation, reset the machine by inserting the stylus into the recessed hole on right side of the bottom of the iPAQ. See get_started(doc) for further instructions. Refer to our support site if you have any questions.

• Microsoft Active Sync (Shipped with iPAQ) (Not required if you have a CF Card and expansion sleeve)
• A terminal emulator (e.g., MS Windows comes with HyperTerminal, RedHat Linux distributions usually come with minicom, etc.)
• md5sum.exe from http://www.etree.org/md5com.html (optional)

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 the Download Center to your PC. The files relevant to this installation are as follows:

file	contents
jbitsy.bin.gz	SavaJe OS Kernel (jnomad.bin.gz for 3800s distribution)
rt-bitsy.jar	Java Classes ( rt-nomad.jar for 3800s distribution)
savaJe.romfs	SavaJe OS Utilities archive
apps.romfs	3rd party Java Applications archive
RemoteSetup.exe	Windows Setup Utility module with bootloader
bootldr-0000-2.14.17-bigkernel-mono-savaJe4	SavaJe OS bootloader file

Pre-installation procedures

• Fully charge your iPAQ battery and make sure it is connected to an external power source.
• Install Microsoft Active Sync. (Follow the instructions in your Compaq iPAQ manual to install Microsoft Active Sync and to connect your Windows machine to your iPAQ).
• You should also know how to transfer files to and from your PC to the iPAQ.

Step 1: Prepare to install bootloader; backup Windows CE

• Install and Configure Serial Cable
  • On your iPAQ select Start -> Settings and then select the Connections tab. Click on PC and select 115200 Default from the pull down menu. Also, make sure that the Automatically synchronize check box is selected.
  • Connect the serial cable (RS-232, not the USB cable) to the iPAQ.
  • Verify Connectivity to iPAQ

    Use a terminal emulator program (e.g., HyperTerminal) and connect to the COM port at 115200 baud, 8 bits, no parity, 1-Stop bit, and NO Flow Control. You may need to disconnect/connect a few times. If you see CLIENT in your terminal emulator program, then your connection is okay. Save your settings.

  • Disconnect your terminal emulator and start ActiveSync.
• Installing RemoteSetup to iPAQ
• Using ActiveSync, copy RemoteSetup.exe to your iPAQ.
• The RemoteSetup program allows you to take a snapshot of the Windows CE image (OS only) from the internal flash. RemoteSetup partitions the Windows CE image into four files and allows you to save each file. The following process outlines how to capture and save Windows CE on to your PC.
  • Run RemoteSetup.exe
  • Uncheck the box next to Run Bootloader — this will be used later. Click OK to select the default options which will save all four Windows CE partition files. RemoteSetup will create one of four files for 3600s/3700s (and one of eight files for 3800s) at a time and will prompt you to move the file to your PC. Using ActiveSync, move the file to a safe location on your PC. Click OK to continue after you have successfully moved the file. This process will be repeated for the remaining files. If you are using a 3600 series iPAQ you will have three more files. If you are using a 3700 or a 3800 series iPAQ, you will have seven more files. By this time, you should have the following files on your PC:

    flash_00000000.bin - (Flash 1/4) (Flash 1/8 for 3700s and 3800s)
    flash_00400000.bin - (Flash 2/4) (Flash 2/8 for 3700s and 3800s)
    flash_00800000.bin - (Flash 3/4) (Flash 3/8 for 3700s and 3800s)
    flash_00c00000.bin - (Flash 4/4) (Flash 4/8 for 3700s and 3800s)
    flash_01000000.bin - (Flash 5/8 for 3700s and 3800s ONLY)
    flash_01400000.bin - (Flash 6/8 for 3700s and 3800s ONLY)
    flash_01800000.bin - (Flash 7/8 for 3700s and 3800s ONLY)
    flash_01c00000.bin - (Flash 8/8 for 3700s and 3800s ONLY)
    

  • It is recommended that you verify and validate the MD5 sums of the above files. If they are not correct, you may not be able to restore WinCE from these images. Detailed instructions on verifying the MD5 sums are available at http://www.handhelds.org/projects/wincerestoration.html . If any of the four files are invalid, you will need to copy them again. See wince_restore(doc) for instructions on restoring Windows CE.
• Disable ActiveSync on COM1
  • Go to File -> Connection Settings . Uncheck Allow serial cable. Click OK .
• Erase Windows CE
  • Run RemoteSetup.exe on your iPAQ.
  • Uncheck the first four check boxes for saving the flash. (Eight check boxes for the 3700s and 3800s
  • Check the box next to Run Bootloader and click OK .
  • Read the warning and click OK .
  • The screen will briefly go blank, and the SavaJe hand logo will appear.
  • If the screen remains blank, you can safely reset your iPAQ and Windows CE will return.
• Open your terminal emulator and connect to the COM port again.
• Press <ENTER> on your terminal emulator and you will see a boot> prompt.

WARNING: Critical Step!

Step 2: Installing SavaJe OS bootloader into internal flash

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

• Make sure that external power is connected to your iPAQ. The yellow LED on the top right should either be blinking (iPAQ is charging) or continuously on (iPAQ is charged and power is connected.)
• From the boot> prompt on your terminal emulator type the following command:

  load bootldr 
  

  and press <ENTER> Then, from the terminal emulator, select Transfer->Send File. . This will open a file dialog box. Select bootldr-0000-2.14.17-bigkernel-mono-savaJe4 (not the .md5sum file). Caution: be sure to check that the entire file name matches before you send the file. Select XMODEM from the protocol drop down menu and click on the Send button.
• When the transfer is completed successfully, RESET your iPAQ.

Step 3 (Partitioning your internal flash)

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.

To create partitions on the internal flash type the following commands at the prompt:

boot> partition reset
boot> partition define kernel 0x00080000 0x00180000 0
boot> partition define rt.jar 0x00200000 0x00600000 1
boot> partition define savaJe 0x00800000 0x00280000 0
boot> partition define apps   0x00a80000 0 8 
boot> partition save

NOTE:

---

The apps partition is defined with the flag set to 8 , meaning that the apps partition should extend from its starting address to the end of the flash.

---

To verify that the partition table is set up properly, enter the following command:

boot> partition show 

Step 4 Install kernel

Loading the kernel partition takes time, so please be patient.

From the boot> prompt on your terminal emulator, type load kernel and press <ENTER> , then, click on Transfer->Send File. This will open a file dialog box, in which you should select jbitsy.bin.gz . (select jnomad.bin.gz . for 3800s) Select XMODEM from the protocol drop down menu and click on the Send button.

Step 5 Install Java libraries and applications

Loading each partition may take up to 40 minutes, so please be patient.

• From the boot> prompt on your terminal emulator type load rt.jar and press <ENTER> Then click on Transfer->Send File.. This will open a file dialog box, in which you should select rt-bitsy.jar . (select rt-nomad.jar . for 3800s) Select XMODEM from the protocol drop down menu and click on the Send button.
• Repeat the above process using the command load savaJe and select the file savaJe.romfs .
• Repeat the above process using the command load apps and select the file apps.romfs .

Reboot 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 .

Step 6: Install License Token

Copy the SavaJe OS license token (.tok ) file to the CF card and attach the CF card to the expansion pack. Click Enter Token -> From File , then select the token file from /cf0 , then click OK .

Step 7: 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.

The SavaJe OS kernel contains a program called SavaJe Flash Utility that will let you copy files from a CF Card to the iPAQ's Flash ROM. Therefore, once you are able to use method 2 to copy the kernel to the iPAQ with a serial cable you can use the SavaJe Flash Utility to copy the rest of the OS files from a CF Card.

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

Pre-Requisites

Hardware

• A PC/Laptop (Windows machine with USB is useful but not mandatory)
• Serial (RS-232) Auto-Sync Cable (Sold Separately) (Compaq Part Number 191008-B21 for the 3600s and 3700s). Or the 3800s Cradle with a serial connection.
• [CF Card + CF Card Sleeve] OR [CF Card + CF Card Adapter + PC Card Expansion Sleeve]

Software

• Microsoft Active Sync (Shipped with iPAQ) (Optional)
• A terminal emulator (e.g., MS Windows comes with HyperTerminal)
• md5sum.exe from http://www.etree.org/md5com.html (Optional)

Installation

1. Follow the Method 2 (Manual Installation) instructions up through Step 4 (loading the kernel).
2. After you load the kernel do the following:
   • Load the following files to the root directory of a blank FAT 12 (ordinary PC formatted) CF Card:

     rt-bitsy.jar (rt-nomad.jar for 3800s)
     savaJe.romfs 
     apps.romfs 
     
     
     SavaJe_XE-lic_....tok
     
      
     

   • Insert the CF Card into the iPAQ via a CF Card expansion sleeve or a PC Card expansion sleeve with CF adapter.
   • The following steps will launch the SavaJe Flash Utility (They 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 (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 rt-bitsy.jar (rt-nomad.jar for 3800s) 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.
3. Reboot the machine by pressing the recessed button on the bottom right hand side of the iPAQ.
4. After the reboot, click Enter Token -> From File . Select the token file (.tok ) from /cf0 , then click OK to install the license.
5. Congratulations, You've done it! Now, enjoy the freedom of running full J2SE applications on your iPAQ. See get_started(doc) for further instructions, and refer to our support site if you have any questions.

TROUBLESHOOTING

If you have trouble after installing SavaJe OS refer to one of the following sections. If none of these are appropriate (or if nothing seems to work), contact our support team at support@savaje.com .

SavaJe OS fails to boot

If you have installed SavaJe OS , but it does not boot properly, the bootloader may be installed properly and you can use the upgrade procedure to continue the installation.

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.

Continue the installation procedure by configuring the partitions as described in the Configure Partitions section of upgrade_ipaq(doc) .

SavaJe OS fails to boot on soft reset

If you cannot reboot SavaJe OS via a soft reset (recessed button on lower right of iPAQ), you should try a complete shutdown and hard reset.

For the 3600 and 3700 series iPAQs: Use the slide switch on the lower left of the iPAQ to completely shut it down. Wait for a couple of minutes for the RAM to clear and then restart your iPAQ using the slide switch.

For the 3800 series iPAQs: Press and hold down the calendar button, the arrow button, and the power button, and then press the reset button for several seconds until the screen fades. Wait for a few minutes, and then press reset. You should be able to boot into SavaJe OS , however, anything that was stored in RAM will be gone.

SavaJe OS Red screens

See the Red screens section of tips(doc) for information about crashes (red screens).

SEE ALSO

upgrade_ipaq(doc)
wince_restore(doc)