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

get_started(doc)

This document provides a brief tour of SavaJe OS and provides pointers to more detailed information about its capabilities.

Getting started with SavaJe OS

Once you have downloaded and installed SavaJe OS (see install_ipaq(doc) ), you should be able to run it. Plug in the power supply or the battery to the computer on which you installed SavaJe OS .

Calibration

The first time you use SavaJe OS , you need to calibrate the touchscreen. The calibration program should start automatically. If you need to recalibrate, use the calibration tool (Calib ) from the Tools tab.

Token entry

The first time you use SavaJe OS , the system requires you to enter a license token. License tokens are provided in both electronic form and in text form to be entered manually.

If you installed SavaJe OS using the Windows Setup Utility, you have the option of automatically installing the token.

To install the token from a compact flash (CF) card, transfer the file token.tok to a CF card. Insert the CF card into the iPAQ using either a CF card sleeve or a PC card sleeve and a CF adapter. Touch the Enter token button. Touch Install on the pop-up dialog, select token.tok from the file list and touch the open button. A dialog should appear announcing success. Touch OK to continue.

If you need to enter the token manually, you will enter a series of 128 hex digits (32 digits on each line) which represent the data contained in the token. Once you have completed each 32-digit line, compare the CRC on the screen with those provided with your token. If you have entered all the characters and the CRCs do not match, you have made a mistake. Before tapping OK, check all four CRCs to make sure they match the CRCs provided with your token.

Once a token has been successfully installed, you will not need to install a token again unless your token expires.

Newuser login

The first time you use your iPAQ, a newuser dialog will appear. You should enter a username (alphanumeric, with no spaces), followed by a password and password confirmation. If you choose to have no password (and you don't create any other users), you will not be prompted for your username and password when the iPAQ is rebooted.

The first user you create will be (by default) the master user, with privileges to remove other users. See login(doc) for more information on user management.

The GUI shell

After the image loads and you have logged in, a GUI shell window should appear (see gui_shell(doc) . Touch the screen in the shell window to move the focus there. Touch an application icon to launch the application.

Input using the soft keyboard

If you are running SavaJe OS on a platform (such as the Compaq iPAQ) that does not have a hard keyboard, a soft keyboard is provided for input. To toggle the soft keyboard on the Compaq iPAQ, hold down the button at the lower right on the front of the iPAQ until the keyboard appears (or disappears). For more information about hardware-specific key functions, see the appropriate document for your device:
keys_ipaq(doc)

The command line shell

Launch lsh (a command-line shell in the Tools tab) and try the following commands:

% whoami
% cd
% pwd
% ls -l > test.txt
% cat test.txt

Shell commands are documented in Section (shell) .

Platform-specific controls

Because SavaJe OS runs on different hardware platforms, there are different ways to access common functions (including rotating among active applications, returning to the default shell, and bringing up a soft keyboard). For more information about hardware-specific key functions, see the appropriate document for your device:
keys_ipaq(doc)

Getting connected to the network

SavaJe OS supports a growing number of Ethernet and IEEE 802.11 wireless PC cards.

Once you have installed a network card, you can use the netcfg tool or net(shell) to examine and/or set your network properties. Once your SavaJe OS device is on the network, you should be able to run a command like this from the lsh prompt:

% cat http://www.savaje.com/index.html

Running Java applications

See run(shell) and run_java(doc) for detailed information on packaging and running Java applications on SavaJe OS .

Running scripts

You may often want to execute a sequence of shell commands. If you place these commands in a file, you can run them as a script using the source(shell) or dot (. ) command.

Adding applications to ROM

If you want to add your own applications to the apps partition, which resides in local read-only memory, see romfs(doc) .

System properties

System properties define the process environment for applications. Use the prop(shell) command to view or set system properties. You can also set properties on a per-application basis while running applications with the run(shell) command.

User home directory (`user.home` )

When you run cd(shell) with no arguments, you end up in the directory specified by user.home .

User directory (`user.dir` )

When you execute an application class using run(shell) , the system will look in user.dir for the class.

Using the manual

For more information on using the SavaJe OS online manual, see manual(doc) .