Introduction
FAQ
Download
Getting started
Call for contributions
Contacting the author
Disclaimer
Back to the Main Menu

All contents on this page are copyright (c) 1998 by Tilo Christ. All rights reserved.
This page was last rebuilt on Wed Dec 9 11:46:03 CET 1998 .

These instructions have been tested on an Intel Linux box, running RedHat 5.0, as well as the JDK 1.1.6v1, JDK 1.1.6v4a, and JDK 1.1.6v5 from http://www.blackdown.org. A similar installation procedure should work on most other Unices too. You are welcome to contribute more specific instructions for other Unix platforms!

Installation of the pure Java code only

Unpack the download archive into a place of your liking. Include the file Java/SyncBuilder.jar into your CLASSPATH environment variable. Then check for successful installation.

Installation of both Java and native code

Personally, I use IBMīs blindingly fast jikes compiler for Linux . It works great for compiling SyncBuilder . The configuration procedure during the source code installation will try to detect jikes in your PATH and will use it for building the package if it is available.
The Jikes compiler may be downloaded for free at http://www.alphaworks.ibm.com/formula.

Of course, you will also be fine if you use the javac compiler.

Please tell me, if these instructions donīt work for you.

Unpack pilot-link 0.9.0 first. Choose a directory and say tar -zxvf pilot-link.0.9.0.tar.gz . Make sure you have the proper permissions to overwrite the pilot-link.0.9.0 directory and all of its sub-directories.

Change to the pilot-link.0.9.0 directory. Say rm -rf Java. Copy Java.tar.gz to the pilot-link.0.9.0 directory. Say tar -zxvf Java.tar.gz. This will unpack the new binding and the updated configure.in and configure files. It will also DOWNGRADE the libtool-files from libtool 1.2 to libtool 1.0c. Using the libtool 1.2 that comes with pilot-link 0.9.0 breaks both the pilot-link 0.9.0 Java -binding as well as SyncBuilder .

Say configure --with-java=xxx where xxx is the directory which contains your JDK 1.1. Make sure configure locates your JDK properly. Run make. Watch the make-process. Run make install. Make sure, the software and shared-libraries end up in places which are in your path and your library-path respectively (typically, they will install to /usr/local/bin and /usr/local/lib). The installation step will most likely require root-status.

Now change to the Java-subdirectory. Run make. The SyncBuilder packages will be compiled.

Checking for successful installation

Make sure the current directory (.) is included in your CLASSPATH environment variable! Then change to the Java/samplecode directory. Execute java dlptest. This will run the Palm device through a short series of tests.

Checking Serial HotSync

This will only work if you did the installation of the native code. When asked for the port on which your Palm device is connected, choose the UNIX device-name of the serial port to which the cradle is connected (e.g. /dev/ttyS0, or /dev/pilot).
While the instructions and explanations are being displayed, be sure not to wait too long to press <RETURN>, otherwise the connection will time out!

Checking Network HotSync

This will work for both the pure Java installation as well as the native installation. You will have to install the Network HotSync software on your Palm device though, and run the pppd (both is described
here).
When asked for the port to which your Palm device is connected choose . (dot). You will then be asked to instantiate the Network HotSync. You do this by tapping on the "Modem HotSync" symbol on your Palm device . The pppd should already be running before you start the Java application.

Troubleshooting

java.lang.UnsatisfiedLinkError: no JavaPisock in shared library path
The native code for the Java-binding could not be located. If you have only done the binary installation this will happen anytime you try to access functionality that requires native support code (e.g. synchronization through the serial cable).
If you have successfully installed the source version though then you should try to manually add pilot-link.0.9.0 /Java/_libs to your LD_LIBRARY_PATH. You might also have to run ldconfig as root, to make the new library known to the system. This will be fixed at a later time by an install-target in the Makefile.
java.lang.UnknownError
        at Pdapilot.ServerSocket.bind(ServerSocket.java:xx)
        at Pdapilot.ServerSocket.(ServerSocket.java:xx)
        at pltests.fulldemo.main(fulldemo.java:xx)
The specified port for the Palm device could not be found. The default is /dev/pilot, which is probably not present on your system. You might wish to create /dev/pilot by typing ln -s /dev/ttyS0 /dev/pilot.