|Zaurus Geek @ http://zaurus.kruss.com|
|For the Sharp Zaurus SL-5500 linux-powered personal mobile tool|
|Journal | Hardware | Software | Links | Dev|
IMPORTANT UPDATE: In April 2003 I began using OpenZaurus instead of the stock Sharp ROM. These instructions may not apply to anyone not using Sharp's ROM image. I am now maintaining a separate page for OZ Software Tips.
These instructions worked for me. They were culled from various web pages, forums or irc channels. I use a stock Zaurus SL-5500 with the Sharp ROMs and Qtopia environment. I have a 128 MB SD card (currently formatted as default FAT). I connect my Zaurus to the internet through the cradle with TCP/IP over USB to a Windows XP laptop.
When appropriate I have included screen captures. These will appear either as thumbnails that link to the full-size image, or simply as an image link that serves the same purpose.
Jump Points (newer at bottom)
While the base applications listed below perform fine, these drop-in replacements provide more features. Usually just installing the replacement moves the original file out of the way.
If you're comfortable using the console, then these shell scripts that perform some frequently needed functions will save time and effort.
The fbvncserver is delivered as an .ipk so its easy to install. It will put several icons into your Applications tab. Three to launch various flavors of the server, and one to stop the server. The most useful is called "fancy" and it will appear to the client as a fully-extended Zaurus, with functioning keyboard and application buttons.
After you install VNC you should reboot and as soon as you have control, tap as closely as possible the top left corner and the bottom right corner of your screen. This establishes calibration for remote control purposes. This only works once unless you delete the file /etc/tssim_cal.conf and reboot again.
To use the client, download one appropriate for your platform from the link above. Then run the VNC Viewer and give it the IP address of your Zaurus followed by a :0 to specify display zero. There is no password by default. If all goes well, you should be in.
These are screen captures of connecting to a Windows XP, Mac OS X and Linux desktop, respectively.
While clicking can be accomplished with a 'tap', and dragging seems to work as expected, you might find that double-clicking is difficult to perform on the Zaurus screen. Some operating systems will accept an Enter key to activate an icon. Try using either the keyboard's Enter, or the OK button on your Zaurus.
If you will be spending a lot of time in the terminal, or it what you want to display doesnt fit well on the Zaurus' screen, you might consider running an SSH daemon on your Zaurus to allow you to connect to from your deskto machine's full-size screen. You will need the following skills in order to install successfully: ability to follow directions carefully, basic knowledge of linux command line, a way to get a file onto your Zaurus (desktop sync, FTP, etc), the ability to download and install an ssh client for your desktop machine.
The Zaurus is always (while Qtopia is running) listening on port 4242 for FTP traffic. By default, the login name is 'root' with no password. If you followed directions in step 5, above, you assigned a password to your root account. This same password will now be necessary to access your Zaurus' filesystem with an FTP client. There's nothing you have to install, its already there. Some notes:
Handwriting (a letter at a time) is cute, but you may find yourself wanting more precise control over the characters you enter into your Zaurus. Several add-on input methods are available to assist with particular kinds of entry. Some are designed for specific programs, some are more general purpose.
jumpX: Popular because it manages to fit a lot more keys into a smaller space than is required by the standard 'keyboard' method -- and with larger buttons. The layout requires a bit of re-learning, but the accessibility gained by having more keys available, and in a logical order (FITALY), makes it a winner.
Custom Keyboard: This add-on by Jesper Pedersen allows
you to quickly access your most frequently used special characters (including
Unicode) with a single tap on the character in a new input bar at the
bottom of your screen.
QPlot-Style Math: When you install QPlot (an advanced math calculator by Nikandrov George) you get the added benefit of this additional input method. While its most useful inside the QPlot program, there may be other times when the shortcuts come in handy.
To move a program to a different tab, tap once on the program name, then tap on the tab name where you want it moved.
To create a new tab, tap the 'Folder' icon, name the tab and provide an icon for it. The tabs are displayed in Tab Manager, and on the Zaurus browser in alphabetical order.
To create a new program entry, click the 'Document' icon. An entry named 'New App' appears in the currently selected tab. Select it and tap the 'Pencil' icon to edit its attributes. (You can also use the pencil to edit tab attributes.) After icons are loaded, you can provide a Name, Executable path and Comment for the entry. When you close Tab Manager, the Qtopia environment must refresh, which takes a few seconds, before your changes will appear.
For the curious, this program simply modifies the collection of .document files residing in /home/QtPalmtop/apps/<tab name>/ which is what the browser uses to display icons and launch programs. A typical .desktop file looks like this:
There is a lot more that can go here, such as mime associations and language preferences. If you edit the .desktop files by hand, you must manually restart the Qtopia environment (Using the Shutdown program in the Settings tab) before your changes can be seen.
There may be times you want to run applications that require more memory than your Zaurus has available. Because its Linux, we can easily enable what is called 'swap space' on the storage area that acts as virtual memory for programs to use. You probably don't want to have the swap enabled continuously as that has the potential to slow down operation of your Zaurus.
I use two shell scripts that I run from Terminal when I want to enable or disable swap space in my storage RAM in order to temporarily provide more memory space for programs to run in. Notice that the path where I put my swap file is /home/root/SwapFile. You can change the name, but you shouldn't change the location. The block size (bs) is set as 1024, so as to measure in kilobytes. The count is the number of kilobytes to allocate for the swap, in this case 8192 which is an additional 8 MB which can be used by programs.
Some people leave their swap file intact between uses. I delete mine each time to free up that storage space, in case I need it.
To enable swap, enter this from the command prompt: ./setswap.sh and to disable it: ./unsetswap.sh
You can also download HRAbbey's ChangeSwap program, which has a friendlier user interface for enabling and disabling swap space.
First a note on QPose and emulation in general. Because the Palm uses a different chipset than the Zaurus, there is a significant performance hit when running the Palm OS under emulation. In my experience with QPose, specifically, once you get the software loaded, and if you plan to stay within a single piece of software (not switching back to Home often) then the emulation mode is suitable for productive use of reference materials, or programs that don't require too much input. If you do switch between various programs, you'll see long delays each time you go back Home and then again when launching the application. That having been said, let's proceed to the guide.
Download the QPose packages from Climov's site and install both the -data and the -bin packages in that order. You'll then have an icon that looks like the blue one below in your Applications tab named 'Palm Emulator'. Next, download the PalmM100 ROM image from this site. You'll need to upload the ROM image file into ~/Documents/application/x-rom/.
You can at this time put any Palm applications into ~/Documents/application/x-prc/. Looking at your Documents tab you should see files that look like this representing Palm applications and Palm ROMs.
The following steps will illustrate how to get your Palm emulator running the first time, and how to install your first application.
Just to prove that this works, I loaded a very large and complicated piece of software that is very popular on the Palm platform: The ePocrates medical database. It took about 35 minutes to load all the related files, but then I backed up my posession.psf file so I could restore it easily, anytime. Here are screenshots of ePocrates in action -- and the speed is quite usable.
Once you understand how X11 works, then using qtopia-x to run applications remotely, but view them locally becomes easy. First, look at this diagram to understand what is actually happening when you are running an X server on your Zaurus and connecting to it from the command line.
Create a 24-bit image at 240x320. Rotate it 90-degrees clockwise. Save it as Startup_screen.bmp. Copy it to /opt/QtPalmtop/pics/
The Application Key program in your Settings tab can be used to assign quick-launch actions to the four application keys on the front of your Zaurus. Typically, these are: Datebook, Contacts, Menu, Mail. If you want to assign them to launch other programs, make sure your programs reside in the Applications tab, as that is the only place scanned for items to place into the drop-down menus.
[Thanks to XavierXeon
for this info]
To change mtab from a symlink to an editable file:
Then just edit mtab, comment out /dev/hda1 (CF card) /dev/mmcda1
(SD card) if you want to remove all files on those two sources completely.
Or just append /Documents to the end of each to only show files in the
Documents directory on each inside the Documents tab. NOTE: This might
break things like the ipkg manager.
|Journal | Hardware | Software | Links | Dev
No Style | Small Style
|The maintainer of this site, Darien Kruss, can be reached by email to: darien [at] kruss.com|