Barry's Universal Gronkulator

Here's all the stuff that isn't essential to BUG's role as a communications device, but is essential to BUG's role as a PDA and desktop extention. This is a matter of taste. You might leave some or all of these off, or perhaps install them on an Applications Card.

Desktop Synchronization

UPDATE: We updated our desktop system to Debian Sarge (KDE 3.3.2), but couldn't get Kitchensync to work. Instead, we've switched to Pi-Sync. See the next section, instead. You don't need both Kitchensync and Pi-Sync.

Set up Kitchensync

We use Kitchensync to sync the Z's PIM stuff with our Linux apps (KOrganizer and the phone book). It works great for us. If you're using something else, though, then we can't help you. Kitchensync had a couple of oddities involved in getting it working right, and the first sync will cause you to lose any ToDo items you have in KOrganizer. Sorry about that.

1. Even though it shows as the default, you have to go to the security app and select Opie 1.0 anyhow.
   
2. Be sure the you've set your proper location in KOrganizer (Settings... Configure KOrganizer... Time & Date), or all of your events will get mysteriously timeshifted.
3. Run Kitchensync. The first time you connect to the Z with Kitchensyc, a confirmation dialog will appear on the Z. Tap "Allow".
4. Sync
5. Create a dummy todo item on the Z
6. Sync
7. Delete the dummy todo item using Korganizer
8. Sync

Pi-Sync

Pi-Sync unfortunately requires a couple of sizeable packages on the Zaurus as well as on the desktop. The primary benefit you get, though, is that there's a Pi-Sync for Windows as well, so you can sync freely between Windows, Linux, and/or the Zaurus!

1. Execute: ipkg install -d root kopi
2. Execute: ipkg install -d root kopi-applet
3. Execute: ipkg install -d root kapi
4. On the desktop, install Pi-Sync. If you're using Debian Sarge, here's a package for you.

Be sure that the profile name is the same on the Z and the desktop(s).

GnuPG

We use GnuPG both on BUG and on the dekstop. BUG is a central component of our gpg existence. The .gnupg subdirectory (where our private keyring is) is kept on BUG's SD card, where it can be used in the field. When we want to use our keys on the desktop, we put the Z into its dock and start the NFS mount. A symbolic link from ~/.gnupg points to the .gnupg directory on the Z (through the mountpoint).

This means that the user(s) who run(s) GnuPG must exist both on the Z and on the desktop, so they have proper permissions to access the keyrings. Use "adduser" to create users on the Z.

1. Execute: ipkg install -d root /mnt/cf/pkgs/gnupg_1.2.1_arm.ipk
2. Move the ~username/.gnupg directory from the desktop to the Z
3. Execute: chown -R username.users /home/username/.gnupg
4. Execute: chmod -R 600 /home/username/.gnupg
5. On the dekstop, create a symbolic link to replace the now-missing .gnupg directory. If the Z is mounted at /mnt/bug, then you'd do something like: ln -s /mnt/bug/home/username/.gnupg /home/username/.gnupg

CUPS Client

Yes, we like to print stuff from BUG, and use CUPS as our printserver.

It's not documented, but the TMPDIR environment variable must be set for certain functions to work. If you used our profile, then this is already done.

1. Execute: ipkg install -d root /mnt/cf/pkgs/cupsclient_1.1.20_arm.ipk
2. change ServerName in /etc/cups/client.conf to 192.168.129.1
3. add "cupsenable" to end of /etc/init.d/finish
4. Remember to adjust your CUPS server on the desktop. You'll probably have to allow access from 192.168.129.201 at a couple of point in /etc/cups/cupsd.conf

ESD Streamer

So we can stream audio from the desktop to the Z. Handy to use the Z as a wireless audio player with XMMS.

1. Activate the opie-feed-351 feed, either by uncommenting the src line in /etc/ipkg.conf or by using the package manager in the GUI.
2. Execute: ipkg update
3. Execute: ipkg install -d root esd
4. Execute: ipkg install -d root esd-utils
5. Execute: ipkg install -d root esddsp
6. Deactivate the opie-feed-351 feed
7. Execute: rm /usr/lib/ipkg/lists/opie-feed-351
8. Execute: ipkg update
9. Execute: cp /mnt/cf/pkgs/esdstreamer/esdstreamer.sh /opt/QtPalmtop/bin/
10. Execute: cp /mnt/cf/pkgs/esdstreamer/esdstreamer.desktop /opt/QtPalmtop/apps/Opie-SH/

To stream audio to Z with XMMS on desktop: Set the desktop's XMMS output driver to use eSound. Configure it to "use remote host" and enter the Z's IP address (probably 192.168.129.201 if Z is docked. use "ifconfig" to find out what it is).

On Z, run "esd -public -tcp -terminate&". Start playing through desktop XMMS. The Z's esd will terminate automatically when XMMS stops broadcasting. For convenience, we've installed an Opie-SH script to start the listener. Just tap on it and go.

In practice, it can sometimes be tricky to get XMMS to actually route over the lan. If it didn't work, set XMMS output driver options again (even if you are setting them to the same thing), run the Z's listener, hit "stop" then "start" on XMMS. If you fiddle with it, it'll start.

Miscellanous Apps

1. Execute: ipkg install -d root opie-zsafe
   A note about zsafe: if you don't want it to bug you to create a new data file each time you run it, name the data file "passwords.zsf"
2. Execute: ipkg install -d root opie-checkbook
3. Execute: ipkg install -d root opie-calculator

1. Introduction
2. Installing OpenZaurus
3. Basic Configuration
4. PDA Configuration
   • Set up Kitchensync
   • GnuPG
   • CUPS Client
   • ESD Streamer
   • Miscellaneous Apps
5. Internet Clients
6. Daemons
7. Internet Servers
8. Infrared Subsystem
9. 802.11 Subsystem
10. Bluetooth Subsystem
11. Other Networking
12. Other Software
13. Multimedia Cards
14. Application Cards