1.01 Zaurus Introduction

The Zaurus is a line of PDAs made by Sharp. The original models from the 1990's and early 2000's ran a proprietary OSes; Synergy OS for the earlier PI and ZR models and Zaurus OS for the later MI and MT models. After the MT series Sharp released the ground breaking SL series in 2001 that ran Linux out of the box.

The scope of this document is to only provide in depth coverage on the SL and SL-C Zaurus models due to the fact that they run Linux natively, and have a wide variety of alternate operating systems available for it.

There is a large amount of open source software available for the SL and SL-C models and more can be fairly easily created for it thanks to the easy availability of native and crosscompilers.

1.02 Zaurus Model Comparison

In general terms the SL series refer to the tablet style models that were mainly marketed outside of Japan with one notable exception and the SL-C series refer to the convertible clamshell models that were marketed within Japan. The notable exception to this rule was the only official clamshell model available outside of Japan that Sharp jointly marketed with CEC in China known as the Sharp CEC SL-7500.

An Zaurus Model comparison needs to be written here.

-SL-5x00
-SL-6000
-SL-7500
-SL-Cxx0
-SL-Cxx00

1.03 Zaurus Distro Comparison

I fairly brief, unbiased Zaurus Distro comparison needs to be written here.

SL-5x00:
Sharp
OpenZaurus
Angstrom
Cacko (?)
Watapon
Crow (?)
Henteges (?)
QTopia
TKCROM

SL-C series (clamshells):

Sharp ROM
-Original ROM
-Stable
-QT interface
-2.4.x kernel

Cacko
-Based on the Sharp ROM
-Added applications
-Full/"Lite" versions
-2.4.x kernel

OpenZaurus
-Built with OE
-No longer maintained
-Succeeded by Angstrom
-Very mature and stable
-GPE and Opie variants
-Runs on all Zaurii (?)

Angstrom
-Built with OE
-Many devs
-RTFM
-Cutting-edge
-Not just for Zaurus
-Not stable
-2.6.x kernel
-GPE and other variants
-runs on all Zaurii (?)

pdaXrom
-Developed by a small team (Sashz, Laze, and InSearchOf)
-No recent release (just betas and revisions)
-Not considered stable
-2.6.16 kernel in the latest version
-Only one version (X11)
-Openbox/Matchbox is the default window manager/desktop manager
-does not run on C3000

pdaXii13
-Based on pdaXrom beta 1/2/3
-2.4.20 kernel
-made by Meanie
-stable
-runs on C3000

SL-C3x00-specific:

Debian/Titchy
-Appeared recently
-Apparently stable
-Run full Debian on your Z
-Use regular Debian ARM repositories
-OABI and EABI varieties

*BSD
-Full BSD
-Stable
-SD support (?)

1.04 Glossery

BT = Bluetooth
Short-range wireless to connect with mice, phones, etc.

CF = compact flash
Largish cards that provide storage or IO functions (Wi-Fi, bluetooth, etc.)

OE = OpenEmbedded
A build system for embedded Linux distributions. Used by OZ/Angstrom

OZ = OpenZaurus
A now-unmaintained ROM made with OE.

ROM = nickname for a distribution for the Zaurus

SD = Secure digital
Small cards about the size of a stamp. Sizes go up to about 4 GB.

SDHC = Secure digital high capacity
SD cards with capacity >4 GB. Not working with many ROMs.

SDIO = Secure Digital Input Output
SD cards that provide some functionality other than storage, eg Wi-Fi, bluetooth.

Wi-Fi = Wireless Fidelity

2.01 SL-5000D (developer edition of SL-5500)

something

2.02 SL-5500 (Collie)

someting

2.03 SL-5600 (Poodle)

something

2.04 SL-C700 (Corgi)

First (?) clamshell model.

2.05 SL-C750 (Shepherd)

Successor to the SL-C700, with twice the RAM, twice the NAND, and a working CPU.

2.06 SL-7500C (Shepherd)

Chinese (?) version of the SL-C750. The only difference between the two models is the coloring.

2.07 SL-C760 (Husky)

Same as the SL-C750, but came standard with a larger battery/battery cover and 128 MB of NAND. This model also has a white bezel instead of black.

2.08 SL-C860 (Boxer)

Essentially the same as the SL-C760, but with a different color scheme and updated software (?).

2.09 SL-6000 (Tosa)

Information here should be mostly correct (I'm pretty sure there are 3 models, the suffixes may be mixed up, however):

-Comes in 3 (?) varieties: SL-6000N, SL-6000L, and SL-6000W

SL-6000N- No Wi-Fi or bluetooth
SL-6000L- With Wi-Fi, no bluetooth
SL-6000W- Wi-Fi and bluetooth

-Released in the US

2.10 SL-C3000 (Spitz)

The SL-C3000 is on of the stranger Zaurii, as it runs off of the internal MicroDrive. This limits its choice of ROMs, as many run only from flash.

2.11 SL-C1000 (Akita)

The SL-C1000 is basically a small update to the SL-C860. It gains a newer CPU (PXA270 416MHz) and USB host capabilities.

Since it has the same form factor as the SL-C3x00 series, but lacks the internal MicroDrive, it is likely the most hackable Zaurus. At least one person has fitted USB Wi-Fi and Bluetooth sticks inside of the casing (and overrode the resistor limiting the USB output to 200mA(?)).

2.12 SL-C3100 (Borzoi)

The SL-C3100 is basically a C1000 with an internal 4 GB MicroDrive.

2.13 SL-C3200 (Terrier)

The SL-C3200 is basically an SL-C3100 with a larger MicroDrive. There have also been reports that its CPU is more difficult to overclock.

The >1GB SD driver was taken from an update to this Zaurus's OS.

3.01 CF Flash Memory and Micro Drives

-No known size limit
-Works in all Z models

3.02 CF Ethernet

something

3.03 CF Modems

something

3.04 CF VGA

-Very limited
-Works only with Sharp ROM/Cacko (?)
-Only can be used for slideshows (?)
-2 versions with similar abilities/limitations
--IODATA something
--some other one I can't remember

3.05 CF WiFi

-Probably the best way to get Wi-Fi on the Z
-HostAP or Orinoco drivers
-802.11G cards haven't been made to work yet (?), only 802.11B
-No cards are flush with the Z; all stick out some

Cards known to work:
Ambicom WL-1100C

3.06 CF GPS

something

3.07 CF Mobile Telecommunications

something

3.08 CF Cameras

something

3.09 SD Flash

-SD supported on all models
-1 GB limit on some/all models/ROMs without updated driver
-SDHC support in most distros using a 2.6.x kernel

3.10 SD WiFi

Does not work, there is not currently (or will likely be in the near future) SDIO support for the Zaurus, and thus no SD Wi-Fi

3.11 SD Bluetooth

something

3.12 SD GPS

something

3.13 USB Flash

Works on all ROMs. Tweaking /etc/fstab may be necessary to get it to automount.

3.14 USB External Hard Drives

Works like USB flash, but needs a powered USB hub or power to the hard drive itself.

3.15 USB Ethernet

-Works with most distros (with external modules, used to be found at OESF)
-Pegasus and DM9601 are the common drivers

3.16 USB VGA

something

3.17 USB WiFi

-Needs a powered USB hub to work (unless you mod your Z)

3.18 USB GPS

Models with SirfStar II/III chipsets should work "out of the box" on most distros (verified on pdaXrom r198, IIRC). The module that needed to be loaded was "pl2303"

3.19 USB Optical Drives

Works like USB hard drives.

3.20 USB Keyboards

-Work on all ROMs (?) [only those with USB drivers on board or available]
-Keymap will be messed up (letters are probably OK, outside of that is chaos).

3.21 USB Mice

Works out of the box with:
pdaXrom
pdaXii13
Cacko
Angstrom(?)
OZ(?)

3.22 USB Hubs

powered vs. non-powered

Powered hubs have an adapter that plugs into them, allowing the Zaurus to use USB devices that draw more than the 200mA(?) that that Zaurus can put out. These can likely work without the adapter as normal USB hubs.

Non-powered USB hubs simply allow you to connect more devices to the Zaurus's USB port. This works so long as they don't collectively draw more than 200mA(?).

3.23 USB Host Cables

-Available from the likes of TriSoft and Conics
-One can be created out of a standard Mini-USB cable and a USB extension cable by simply stripping and connecting the corresponding wires, with the exception of the ground wire, which is attached to the black wire (I can't remember which pin that is).
--Note that this FORCES the Z into host mode, so you CANNOT use this as a client cable

3.24 USB Client Cables

something

3.25 IRDA keyboards

something

3.26 Serial JTAG cable

somethig

3.27 Internal Batteries

-EA-BL06 is for SL-C700 and SL-C750
-EA-BL08/EA-BL11 is for all of the other clamshell models, and the above with large battery cover (C700?)
-3.7v
-Official EA-BL06 capacity is 950mAh
-third-party batteries often need some plastic sanded or carved away from the contacts before they will function properly.
-third-party batteries may need tape on the side opposite the contacts to make them connect to the terminals and work OK (I used some 6-10 layers of Scotch)

-Good place to get batteries:
http://www.batteryupgrade.com/

3.28 External Batteries

something

3.29 Styluses

something

3.30 Misc cables

something

3.31 Zaurus Cases

something

3.32 Accessories Cases

something

3.33 Screen Protectors

something

4.01 Sharp

something

4.02 Cacko

something

4.03 OE-OZ

-Predecessor to Angstrom
-Stable/mature
-Supports all (?) Z models
-GPE and OPIE variants

4.04 OE-Angstrom

-Builds for devices other than the Zaurus (Pandora, iPAQs, Simpads, etc.)
-Quite up-to-date
-Optimized on a per-device basis
-Large number of pre-built packages
-2.6.x kernel

sudo mkdir /OE<br />
sudo chown yourusername:users /OE

cd /OE<br />
wget http://download.berlios.de/bitbake/bitbake-1.8.10.tar.gz

git clone git://git.openembedded.net/openembedded.git org.openembedded.stable<br />
cd org.openembedded.stable<br />
git checkout -b org.openembedded.stable origin/org.openembedded.stable<br />
cd /OE/org.openembedded.stable<br />
git pull

cd /OE<br />
wget http://www.angstrom-distribution.org/files/source-me.txt

mkdir -p /OE/build/conf/<br />
yourfavoriteeditor /OE/build/conf/local.conf

# Where to store sources<br />
DL_DIR = "/OE/downloads"</p>
<p># Which files do we want to parse<br />
 BBFILES := "/OE/org.openembedded.stable/packages/*/*.bb"<br />
BBMASK = ""</p>
<p># ccache always overfill $HOME....<br />
CCACHE=""</p>
<p># What kind of images do we want?<br />
IMAGE_FSTYPES = "jffs2 tar.gz "</p>
<p># Set TMPDIR instead of defaulting it to $pwd/tmp<br />
TMPDIR = "/OE/${DISTRO}-stable/"</p>
<p># For multicore CPU boxes:<br />
#PARALLEL_MAKE="-j4"<br />
#BB_NUMBER_THREADS = "2"<br />
#for single-core boxes:<br />
PARALLEL_MAKE="-j2"<br />
BB_NUMBER_THREADS = "1"</p>
<p># Set the Distro<br />
DISTRO = "angstrom-2007.1"</p>
<p># 'uclibc' or 'glibc' or 'eglibc'<br />
ANGSTROM_MODE = "glibc"</p>
<p>MACHINE = "akita"

source /OE/source-me.txt<br />
cd /OE/org.openembedded.stable<br />
./update.sh<br />
bitbake whatever

mkdir /OE && cd /OE<br />
tar zxf /path/to/bitbake-1.8.8.tar.gz<br />
bunzip2 /path/to/OE.mtn.bz2<br />
mtn --db=/path/to/OE.mtn pull monotone.openembedded.org org.openembedded.{angstrom-2007.12-stable,dev}<br />
mtn --db=/path/to/OE.mtn checkout --branch=org.openembedded.angstrom-2007.12-stable<br />
cd /path/to/org.openembedded.angstrom-2007.12-stable ; mtn pull monotone.openembedded.org org.openembedded.angstrom-2007.12-stable ; mtn update

BBPATH=/OE/:/OE/build/:/OE/org.openembedded.angstrom-2007.12-stable/<br />
PKGDIR=/OE/build/<br />
DL_DIR=/OE/downloads<br />
echo Setting up dev env for Ångström</p>
<p>if [ -z ${ORG_PATH} ]<br />
then<br />
 ORG_PATH=${PATH}<br />
  export ORG_PATH<br />
 fi</p>
<p> if [ -z ${ORG_LD_LIBRARY_PATH} ]<br />
  then<br />
   ORG_LD_LIBRARY_PATH=${LD_LIBRARY_PATH}<br />
    export ORG_LD_LIBRARY_PATH<br />
        fi<br />
        PATH=/OE/bitbake-1.8.8/bin:${ORG_PATH}<br />
        cd $PKGDIR<br />
        LD_LIBRARY_PATH=<br />
        export PATH LD_LIBRARY_PATH BBPATH<br />
        export LANG=C<br />
        echo "Altered environment for OE Development"

# Where to store sources<br />
DL_DIR = "/OE/downloads"</p>
<p># Which files do we want to parse:<br />
BBFILES := "/OE/org.openembedded.angstrom-2007.12-stable/packages/*/*.bb"<br />
BBMASK = ""</p>
<p># ccache always overfill $HOME....<br />
CCACHE=""</p>
<p># What kind of images do we want?<br />
IMAGE_FSTYPES = "jffs2 tar.gz "</p>
<p># Set TMPDIR instead of defaulting it to $pwd/tmp<br />
TMPDIR = "/OE/build/tmp/${DISTRO}"</p>
<p># Uncomment the following two lines if you have a multi-core CPU<br />
#PARALLEL_MAKE="-j4"<br />
#BB_NUMBER_THREADS = "2"</p>
<p># Set the Distro<br />
DISTRO = "angstrom-2007.1"</p>
<p># 'uclibc' or 'glibc' or 'eglibc'<br />
#ANGSTROM_MODE = "glibc"</p>
<p>MACHINE =  "YOURMACHINE" 

4.05 pdaXrom

something

4.06 Open BSD

something

4.07 Net BSD

something

4.08 Gentoo

something

4.09 Debian

-Huge number or available packages (all of the Debian armel packages)
-Very up-to-date (as up-to-date as Debian)
-Not optimized for the Zaurus
-Fairly bug-free/supports most hardware
-Runs Angstrom or custom (yonggun/other) kernels

5.01 Linux Primer

The following pages go through the basic Linux stuff to get you up to speed on things and terms that people may throw about.

5.02 Command Reference

something

6.1 Userlinks from tyrannozaurus.com

something

6.2 ScummVM for the Zaurus

Welcome to the homepage of ScummVM@tyrannozaurus

-------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------

Table of Contents

Introduction
Acknowledgements
Downloads
What Games are Supported?
Configuration Tips
What files are needed?
Audio File Compression How-To
Video File Compression How-To
Adding a Game to the ScummVM Main Screen
In Game Controls
Available Themes
Hints and Walkthroughs
Useful Links

-------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------

Introduction

This is a joint project between HoloVector and Antikx that strives to provide the fullest and best ScummVM experience for clamshell (CXX0 and CXX00) Zaurus users under the pdaXrom distro. One the main goals of project is to provide an accelerated ScummVM that could run Broken Sword MPEG2 cut scenes smoothly. Most of the previous builds for the Sharp-based and pdaxrom-based ROMs out there could not run the MPEG2 cut scenes from the Broken Sword games. The OE-based ports could only run jerky reencoded cut scenes at 320x240 because they lacked bvdd support. This version can run these cut scenes at 480x304 with minimal dropped frames.

Please comment below or PM us if you have comments or suggestions.
Please go to the project page and submit bugs and feature requests for the IPK.
-------------------------------------------------------------------------------------

Acknowledgements

Like all open source projects this port became a reality thanks to the work of many diverse people. We would like to take this opportunity to thank them. They are:

The ScummVM Team for making a great and highly portable interpreter for many of our favorite games and then creating the infamous ScummVM Tools that allows us to compress the data files to a more suitable Zaurus size.

Antikx for taking the time to build this port and host not only the ipk but all the associate files in the Downloads section and this home page.

Meanie for building his native GCC environment for the Zaurus and helping Antikx with the build details.

The pdaXrom Team for building the best Zaurus distro to run ScummVM on, IMHO .

Alex/Alez for creating the run script, desktop shortcut, keyboard remap and the original 0.9.0 Modern theme ipk.

kkazakov13 for creating the updated 0.9.1 theme ipks for Modern, Modern Ice, Modern Blue and Modern Dark.

Arisme for hosting the Broken Sword cutscene re-encoding package and creating the mini how-to for it.

bgbennyboy for creating the graphical ScummVM ToolBox for Windows.
-------------------------------------------------------------------------------------

Downloads

Here's the goodies...
Project page: get ipk here
Broken Sword 1 videos in English: bs1video
Broken Sword 1 videos in French/en Francais: bs1videofr
Broken Sword 2 videos in English: bs2video
Broken Sword 2 videos in French/en Francais: bs2videofr
Modern Theme: Modern
Modern Ice Theme: Modern Ice
Modern Blue Theme: Modern Blue
Modern Dark Theme: Modern Dark
-------------------------------------------------------------------------------------

What Games are Supported

The original scope of the main ScummVM project (not the Zaurus off-shoot) was to support all the Graphic Adventure games from LucasFilm Games/LucasArts that were written for the Scripting Creation Utility for Maniac Mansion (AKA SCUMM) engine so that the games could run on more modern computers and platforms that the original interpreters were never ported to (like the Zaurus). Later on it was decided to increase the scope of the project to include many other game engines.

Here is the basic list of supported games in this version:

LucasArts/Lucasfilm Games

Maniac Mansion
Zak McKracken and the Alien Mindbenders
Indiana Jones and the Last Crusade (A Graphic Adventure)
LOOM
The Secret of Monkey Island
Monkey Island 2: LeChuck's Revenge
Indiana Jones and the Fate of Atlantis (A Graphic Adventure)
Maniac Mansion 2: Day of the Tentacle
Sam & Max Hit the Road
Full Throttle
The Dig
The Curse of Monkey Island

Revolution Software

Beneath a Steel Sky*
Broken Sword 1: The Shadow of the Templars (AKA The Circle of Blood)
Broken Sword 2: The Smoking Mirror

Interactive Binary Illusions

Flight of Amazon Queen*

Coktel Vision

Gobliiins

The Dreamer's Guild/Wyrmkeep Entertainment Company

Inherit the Earth: Quest for the Orb

Adventure Soft Publishing Limited

Simon the Sorceror 1
Simon the Sorceror 2
The Feeble Files

Westwood Studios

The Legend of Kyrandia 1*

and a whole lot of Humongous Entertainment Games

A more complete compatibility list can be found here. Not all versions of the games are supported or are not completely supported so please check the above link for more detailed information. A general rule of thumb for support in ScummVM is that if you have the DOS or Windows version of a game it is highly likely that it will be completely supported.

Games marked with a * are either freely available for download or require additional files which you can get by clicking on the *. You do not need to download the Broken Sword cut scenes that are linked on the above page because they are unsuitable for use with the Zaurus. Please use the cut scenes above in our Downloads section.

The publishers of Beneath a Steel Sky and Flight of the Amazon Queen have graciously donated the source code for these games to the ScummVM team and have released these games as freeware so you can freely download them and play them in ScummVM. Many thanks to Revolution Software, John Passfield and Steve Stamatiadis for their wonderful donations.
-------------------------------------------------------------------------------------

Configuration Tips

To get the full ScummVM experience we recommend that you run ScummVM in Fullscreen mode with the Aspect ratio correction turned on and the AdvMAME2x graphics filter turned on. ScummVM will run slightly faster when you enable Fullscreen mode and use the optimized AdvMAME2x filter. The main purpose of the AdvMAME2x is to smoothly scale the graphics up to 640x480 without the nasty looking jaggies but, as an added benefit this filter is bvdd or ati accerelated thanks to it's dependency on SDL to do it's magic. We recommend AdvMAME2x because is well suited to the Zaurus due to it's low system requirements compared to the similar hq2x filter which was designed for a desktop environment. Aspect ratio correction is needed to fix the mouse cursor positioning in the scaled up games and prevent graphics distortion that would make a circle look like an oval.

You can turn on the Fullscreen mode and Aspect ratio correction by tapping on the Options button on the main GUI screen and then tapping on the checkboxes for both of those options. Both boxes should then have x's in them. Don't tap the OK button yet because we still need to turn on the graphics filter.

To turn on the AdvMAME 2x graphics filter tap and hold on the double headed arrows for the Graphics mode. A large list of the graphics filters will appear. Keeping your pen pressed to the screen, slide the tip to highlight the AdvMAME2x entry and release the pen tip from the screen. The Graphics mode box should then say AdvMAME2x.

After that tap the OK button to save and close the Options screen and then tap on the Quit button to exit ScummVM. You need to quit to enable the changes you just made.
-------------------------------------------------------------------------------------

What files are needed?

Because ScummVM is replacing the original interpreter you will only need the core data files in order play the game. This is a good thing since it will cut down on the amount of space you will need on your Zaurus. The following link lists the main files required in order to play the supported games. If you follow its guidance closely you will have a working game under ScummVM on Zaurus that will take the least amount of space. Audio and Video compression is covered in the next section

http://wiki.scummvm.org/index.php/Datafiles

Once you have determined what files you require you need to copy it over to your Zaurus. If you are copying it to a 3x00, we highly recommend copying under the /data/ folder (which links to hdc3)on those units. For the other clamshells we recommend copying the files over to /mnt/card/. Make sure that each game has its own subfolder. Here are a couple example layouts for you to consider:

/data/Documents/Game_Files/indy4/
or
/mnt/card/scummvm/zakfm/
-------------------------------------------------------------------------------------

Audio File Compression How-To

There are many types of audio used in the supported games such as sound effects, dialog, and music. The one thing that these audio types have in common is that the audio, in most cases, is stored in low or uncompressed formats. Uncompressed audio takes a significant amount of space so, it is in your best interest to compress the audio of these games.

ScummVM offers many choices for alternate audio formats, these include MP3, Ogg Vorbis, and FLAC. FLAC is not recommended for the Zaurus since this lossless format will actually create larger files than the original uncompressed files. Ogg Vorbis on the Zaurus has performance issues and therefore can lead to gameplay degradation. Therefore, MP3 should be your target format for the Zaurus since MP3 will give you the best performance/compression ratio of these choices.

You will require a copy of the lame encoder in order to perform these compression steps. Here is a link to a DOS based one that I have used. Depending on which type of compression you need to perform; it is possible to do some of this encoding on your Zaurus if you have a significant amount of disk space. However, since you will need a CD-ROM drive or in some cases a floppy drive to extract the raw audio files I recommend using a desktop platform of your choice instead.

Some of the games will require that you use something called the ScummVM Tools in addition to the lame encoder because of the way the audio was stored. The command line based ScummVM Tools are precompiled for the following platforms: Windows, Fedora Core 2 and 4, Mac OS X Universal, Solaris 8 and 10 and Atari/FreeMint. Since ScummVM is a LGPL licensed project, the source to the tools is available for your compiling pleasure. Please note that there are no plans at this time to compile these tools for the Zaurus but, you never know... Also note that there is a GUI front-end for Windows available for some of the ScummVM Tools tools called the ScummVM ToolBox. You can find it here.

Instead of reinventing wheel explaining the steps required to compress the audio for some of the supported games I will merely point you to the ScummVM 0.9.1 Read Me file which is located here. The section you require is 7.7.

I will spell out which subsection instructions you need to use for which game though so, here we go:

7.7.0 - Zak McKracken and the Alien Mindbenders (FM Towns only), Indiana Jones and the Last Crusade (FM Towns only), LOOM (PC CD and FM Towns), and The Secret of Monkey Island (PC CD and FM Towns)

7.7.8 - Broken Sword 2 (note this is for in game audio not the video cut scenes mentioned above)

* = The Mac CD monster.sou audio is stored in a single file called Game Name Data that also contains the rest of the game files. In order to compress the monster.sou file you will need to split up the Data file into it's component parts first (effectively turning it into the PC version) and then running the SOU compression utility. The ScummVM tool you would use to break up the Data file is called

extract_scumm_mac

The following games do not have their compression instructions included in the above linked ScummVM 0.9.1 ReadMe so, I will quote the ScummVM Tools ReadMe file included in the ScummVm Tools download instead.

For Full Throttle, The Dig and The Curse of Monkey Island follow these directions and compress the audio to MP3.

"compress_scumm_bun [inputfile] [inputdir] [outputdir] [--ogg] Compresses '.bun' music/voice files.

Example of usage: compress_scumm.bun digmusic.bun uncomp comp
For the Ogg or Mad compression feature, your ScummVM binary naturally must have been built with Ogg or Mad support enabled."

For The Legend of Kyrandia 1 follow these directions and compress the audio to MP3

"compress_kyra Used to compress The Legend of Kyrandia's speech files with MP3, Vorbis or FLAC.

The flag you want to use in this case is --mp3
-------------------------------------------------------------------------------------

Video File Compression How-To

Several of the supported games use complex animated cut scenes to help move their stories along. Due the age of some of these games the cut scenes are using non-compressed video and audio formats. In order minimize the disk footprint of these games on your Zaurus it is in your best interest to compress these cut scenes using the tools mentioned below.

The following LucasArts Games make use of SMUSH formatted animation, Full Throttle, The Dig and The Curse of Monkey Island. You can one again use the ScummVM Tools or the ScummVM ToolBox for Windows previously mentioned in the Audio File Compression How-To above. Here is a quote from the ScummVM Tools readme on SMUSH compression tools usage.

"compress_scumm_san [inputfile] [inputdir] [outputdir] [--ogg]
Compresses '.san' smush animation files. It uses lossless
zlib for compressing FOBJ gfx chunks inside a san file.
It also can create a separate Ogg file with the audio track.

NOTE: For some '.san' files there is a corresponding '.flu' file, which contains offsets into the '.san' file. Hence, the compress_scumm_san has to modify the '.flu' file. This happens automatically, if the '.san' and '.flu' files are in the same directory (which is normally the case). If you want to move the '.san' files before compressing them, make sure to
move the '.flu' files, too!"

The Revolution games Broken Sword 1 and 2 also use an unsuitable, for the Zaurus, animation format called Smacker. The owners of the format, RADTools, have specifically requested that the ScummVM team does not reverse engineer the format. Luckily, Revolution Games have allowed the cut scenes to be reencoded into MPEG2 and Ogg Vorbis. Those cut scenes are currently posted on the Main ScummVM download page but, as I mentioned above those cut scenes are not appropriate for the Zaurus. Which is why we have included downloads to the reencoded cut scenes on this page.

However, some of you may want to play the games in a different language then what we have included in our downloads so, therefore this section will detail the tools and steps needed to roll your own cut scenes.

This process will require a Windows PC because the RADTools Smacker decoder only runs under Windows. In theory you might be able to do this through WINE but, it is not something we have tested.

You can find the conversion files (bsvideo.rar) required and the basic instructions to perform this in post #2 on the following link. In addition you will need a copy of the LAME encoder which you can find here.
-------------------------------------------------------------------------------------

Adding a Game to the ScummVM Main Screen

By this point you will have grabbed the files you need to run games, compressed the audio and video as needed and copied it all over to your Zaurus. Now you want to start playing them. This section walks you through adding a game to the ScummVM GUI mainscreen for quick startups so, let's get to it.

After starting ScummVM, tap the Add game button.

The Selection Window will open. Navigate to the location on your Zaurus where your individual game sublfolders are located. Tap once on the subfolder you want to add to the main screen to highlight it and then tap the Choose button.

The Game Details window will open. If you wish you can make any changes to entries like perhaps setting the platform, etc.... This is optional because the majority of the time the defaults are just fine.

Tap the OK button and you will return the ScummVM mainscreen with your new entry listed. Repeat these steps as needed to add the remainder of the games to the mainscreen list.

-------------------------------------------------------------------------------------

In Game Controls

Because there are multiple game engines supported by the ScummVM interpreter (some of which the original source code was provided to the team) there are multiple control keys and combinations (referred to as hot keys) included in ScummVM in order to execute certain actions. To make matters more interesting some of these hot keys (eg. Save and Load) are mapped to the function keys on most other platforms. The Zaurus typically does not have function keys so, a keymap was developed to provide this functionality. Listed below are the key hot keys that one will need to know in order to complete a game in ScummVM. There are many more than these but in the interest of brevity we are only going to include the essentials. Please note that the following game engine short cut keys could not be tested at this time due to a lack ownership of these supported titles. They are the AdventureSoft Publishing (Feeble Files, Simon the Sorceror 1 and 2), Westwood Games (The Legend of Kyrandia 1), Coktel Vision (Gobliiins), WyrmKeep Entertainment (Inherit the Earth) and the Humongous Entertainment games. For the sake of completeness we will include the known hot keys that should work but, please bear in mind that they have not been tested on a Zaurus.

Common Hot Keys

Ctrl-q - Quits the game you are running and exits the ScummVM without saving your progress

Alt-Enter - Toggles full screen/windowed . Alt is the Kanji key to the right of the Ctrl key

LucasArts (SCUMM) Hot Keys

Menu or Right Rocker - Displays a save/load box with in game options, help and quit

Space - Pauses the game

Cancel - Skips the active cutscene

Fn-Tap - Simulates right click

Beneath a Steel Sky Hot Keys

Menu or Right Rocker - Displays a save/load box with in game options, and quit

Cancel - skips the game intro

Fn-Tap - Simulates right click

Broken Sword 1

Menu or Right Rocker or Cancel - Displays save/load box with in game options and quit

Cancel - skips the active cutscene

Taping the upper black bar of the screen - Displays your inventory

Fn-Tap - Simulates right click

Broken Sword 2

Tapping the the upper black bar of the screen - Displays save/load box with in game options and quit

Fn-Tap - Simulates right click

P - Pauses the game

Cancel - skips the active cutscene

Flight of the Amazon Queen

Menu or Right Rocker - Displays the Journal a save/load box with in game options, and quit

Fn-Tap - Simulates right click

Cancel - skips the active cutscene

Simon the Sorceror 1 and 2

Ctrl 0-9 and Alt 0-9 - Load and save game state. Alt is the Kanji key to the right of the Ctrl key

p - Pauses the game

The Feeble Files

F7 - Switch characters

p - Pauses the game

The Legend of Kyrandia

Ctrl 0-9 and Alt 0-9 - Load and save game state. Alt is the Kanji key to the right of the Ctrl key

Tap on the blue gem on the lower left of the screen - Displays save/load box with in game options and quit

We have not found out what the default hot keys are for Gobliiins, Inherit the Earth and the Humongous Entertainment games.

-------------------------------------------------------------------------------------

Available Themes

Starting with ScummVM 0.9.0, GUI Themes were incorporated. This allows you to replace the default retro black and green GUI with a more "modern" look.

Default Classic Theme

There are currently four themes ported over to the Zaurus and they are available in IPKG format. They are:

Modern

Modern Ice

Modern Blue

Modern Dark

Unfortunately, since this is a new feature; the GUI selector is not working properly so it only works by manually specifying the path and renaming the theme to modern.ini and modern.zip (if you want to use one the other themes besides the Modern one) since that theme name is hard coded in theme engine.

To activate a theme you must follow the steps outlined below:

Install the ipk of your choice (or install them all if you want to). This can be done via the GUI installer or from the console.

If you have chosen the Modern Ice, Blue or Dark themes follow the next three steps. If you chose the Modern theme skip the next three steps and continue on to the end of this section. Start up a the file manager of your choice or use the command line to navigate to /usr/share/scummvm/themes.

Rename the modern.ini and modern.zip to modern-orange.ini and modern-orange.zip if you chose to install that one as well your preferred theme.

Rename your preferred theme to modern.ini and modern.zip

If you started a file manager or console session close it and start ScummVM.

Tap on the Options button then tap on the Paths tab and you should see this.

Tap on the Theme Path: button and navigate to the themes directory which is located under /usr/share/scummvm/themes/ and then tap the Choose button.

Exit and restart ScummVM and it should now load with the theme of your choice.
-------------------------------------------------------------------------------------

Hints and Walkthroughs

There are many resources on the internet that provide hints and walkthroughs. In this section we will highlight some of our favorite hints and walkthroughs:

LucasArts/Lucasfilm Games

Maniac Mansion | hints | walkthrough |

Zak McKracken and the Alien Mindbenders | hints | walkthrough |

Indiana Jones and the Last Crusade (A Graphic Adventure) | hints | walkthrough |

LOOM | hints | walkthrough |

The Secret of Monkey Island | hints | walkthrough |

Monkey Island 2: LeChuck's Revenge | hints | walkthrough |

Indiana Jones and the Fate of Atlantis (A Graphic Adventure) | hints | walkthrough |

Maniac Mansion 2: Day of the Tentacle | hints | walkthrough |

Sam & Max Hit the Road | hints | walkthrough |

Full Throttle | hints | walkthrough |

The Dig | hints | walkthrough |

The Curse of Monkey Island | hints | walkthrough |

Revolution Software

Beneath a Steel Sky | hints | walkthrough |

Broken Sword 1: The Shadow of the Templars (AKA The Circle of Blood) | hints | walkthrough |

Broken Sword 2: The Smoking Mirror | hints | walkthrough |

Interactive Binary Illusions

Flight of Amazon Queen | hints | walkthrough |

Coktel Vision

Gobliiins | hints | walkthrough |

The Dreamer's Guild/Wyrmkeep Entertainment Company

Inherit the Earth: Quest for the Orb | hints | walkthrough |

Adventure Soft Publishing Limited

Simon the Sorceror 1 | hints | walkthrough |

Simon the Sorceror 2 | hints | walkthrough |

The Feeble Files | hints | walkthrough |

Westwood Studios

The Legend of Kyrandia 1 | hints | walkthrough |

-------------------------------------------------------------------------------------

Useful Links

Here are some links that you may find useful and interesting. Links to Abandonware and Pirated games are not permitted.

Where to acquire these games

eBay for LucasArts, Westwood, Coktel Vision and Humongous Games

AdventureSoft for Feeble Files, Simon the Sorcerer 1 and 2

Wyrmkeep for Inherit the Earth

Sold Out! for the Broken Sword Double Pack or 1 and 2 individually

ScummVM for Beneath a Steel Sky and Flight of the Amazon Queen

Background Information on the Games

Moby Games

Adventure Gamers

LucasFilm Games and LucasArts

The International House of Mojo

LucasArts Museum

The Zak McKracken Archive

Revolution Software

Broken Sword Planet

Beneath a Steel Sky Installer

Interactive Binary Illusions

Flight of the Amazon Queen Installer

Coktel Vision

Gobliiins at Vintage Sierra

The Dreamer's Guild/Wyrmkeep Entertainment Company

Inherit the Earth Web Comic

AdventureSoft Publishing

The Best Simon the Sorcerer fanpage

Westwood Studios

None at this time

6.3 psx4all the Playstation emulator

Info about psx4all here.