New User Guide

From OESF

Contents 1 Care and Feeding 1.1 Screen 1.1.1 Cleaning 1.1.2 Screen Protectors 1.2 Battery 2 Hardware 3 Operating System 4 QTopia Environment 4.1 Navigating in QTopia 4.2 Suspend / Resume 5 Software 5.1 IPKG 5.2 Feeds 5.3 Commercial Software 5.4 Dependancies 5.4.1 SDL 6 Network Connectivity 6.1 USB cable 6.2 Wired Ethernet 6.3 Wireless 6.4 Dial Up

Care and Feeding

Screen

Cleaning

Screen Protectors

Many users instal screen protectors to help protect the screen

Battery

There are several different types of rechargable battery technologies. Each type has its own quirks and care procedures. What you've been told to do for one type of rechargable may not apply to others.

The Zaurus's use Lithium ION batteries. To maximize the life of these, the best practice is to not keep it fully charged (especially if stored), and not fully drain it before charging

Hardware

Operating System

Most likely, you purchased a Japanese model, and you will want to convert into another language, usually English. The Sharp ROM can easily be converted to English.

Another popular option is to replace the Sharp Rom with "Cacko". Cacko is based on the Sharp rom, but features:

• 100% English
• Updated versions of the default Apps
• More device drivers
• Compressed filesystem, freeing up more space on the internal flash for your own needs

There are other OS options, like pdaXrom and OpenZaurus, these are more like full linux distributions rather than PDA-like distributions.

QTopia Environment

The operating environment for the Zaurus is QTopia from TrollTech. This is based on the QT library (Which the Linux desktop environment KDE is also based).

It's important to note that QTopia is not based on XWindows (X11), unlike most Linux desktop environments. Some of the ported applications do depend on X, and will not run in plain QTopia. X is available to be installed on QTopia.

Qtopia can run in either portrait (PDA-style) or landscape (desktop-style) modes

Navigating in QTopia

The QTopia desktop (palmtop) is a familiar environment. Applications are represented by icons, and there is a bar across the bottom of the screen with a QT menu button in the bottom left corner, and a system-tray thing on the right. A button to the right of the QT button allows you to bring up an on-screen keyboard or handwriting area on screen.

However, there are some key differences between QTopia and the typical desktop environment:

• Only one window can be displayed at a time, and there's no minimize-like functionality
• There's no obvious way to right (or middle) click

Suspend / Resume

Booting a Zaurus takes several minutes, not convenient for an on-the-go device. Fortunatly it can be instantly suspended or resumed. To suspend, simply select the menu option. On the clamshell models, closing the shell puts it into suspend mode (unless there's a frozen app that doesn't suspend properly, see the section on app recovery)

Software

Once you have your Zaurus, you will want to install various applications on it. Zaurus software can be found in various places. Good places to start are the ELSI Index and the OESF forums.

IPKG

IPKG is the Zaurus Package manager format. Many software packages are distributed in this format. It's similar to RPM on desktop Linux, except that it doesn't warn about dependancies when installing.

Feeds

Feeds are places on the internet where a net-connected Zaurus can automatically install packages from .

Commercial Software

There is commercial software available for Zaurus models.

• Sharp
• theKompany

Dependancies

Many packages require other packages to be installed to run. These are often libraries. Make sure you install all the needed dependancies before running your software.

SDL

SDL is "Simple Directmedia Layer", it's a library that many Zaurus packages, especially Games and Emulators, depend on. There are quite a few SDL ipkgs floating around. But some are more optimized for the Zaurus than others. Some will barely work at all. The best SDL packages to use are:

• (TODO: Add links to known good SDL ipkgs)

Network Connectivity

There are several options to getting your Zaurus connected to a Network/Internet

USB cable

Your Zaurus can piggyback off of your desktop PCs net connection. See Connectivity for instructions on how to set this up. Instructions are given for Windows, Linux and Mac.

Wired Ethernet

Zaurus models can work with various CompactFlash ethernet adaptors, and current models can use USB adaptors as well See Ethernet_Card_Support for CompactFlash and USB_Ethernet_Support for working USB devices

Wireless

Various CF WiFi cards can be used with the Zaurus. See Wireless_Card_Support for details. It's also likely that USB WiFi adaptors can be used, there is a lack of success stories to date. CompactFlash is probably preferable for this, since nothing needs to dangle out of the Zaurus.

Dial Up

If you only have dial up access, see Modem_Card_Support