SerialPort for Java

Installing binaries

Download and unpack the latest envj_bin.zip archive. Install the JAR files it contains somewhere on the Java CLASSPATH search list.

Download latest SerialPort_bin.zip and unzip it. This will create the serialport directory. Become root and cd into serialport. As delivered, the following items will be installed as shown:

Item Installed in
spc, spd, sptarget /usr/local/bin
spc.1, spd.1, sptarget.1 /usr/local/man/1
SerialPort.jar /usr/java/sdk/jre/lib/ext
spd.conf /usr/local/etc
init.d/serialport /etc/init.d

If these locations don't suit your installation, edit Makefile before doing the install. When you're ready, run make install, which installs various items.

Complete documentation is left in serialport/docs. Pointing a web browser at serialport/docs/index.html gives easy access to the documentation set.

Building from source

Download the latest environ_bin.tgz and envj_bin.zip libraries and unpack them. Install the JAR files somewhere on the Java CLASSPATH search list and libenviron.a on the linker's search path.

If you want to build these from source:

Download and install Cdoc as described on that site.

Download SerialPort_srce.zip and unzip it. This will create and populate the serialport directory. Change directory into it and run make all docs, which will set up symlinks and empty directories that are not saved in the archive, build all executables and generate the documentation set.

You can test the result by running the spd_regress and Java_regress scripts.

Install the executables and documentation as described above in Installing binaries.

You can now use the JTerm test application, found in the jterm subdirectory, to experiment with the SerialPort package once spd is installed and the configuration file, /usr/local/etc/spd.conf, has been edited to match your installation.