Java(tm) Communications API Solaris Installation Instructions
Version 3.0
License
-
Ensure that the library libSolarisSerialParallel.so
can be loaded.
You can do this
either by adding it to
the environment
LD_LIBRARY_PATH
or
by copying it to /usr/lib.
Example: Assuming your current working directory is where you
extracted
the distribution,
% setenv LD_LIBRARY_PATH
`pwd`:$LD_LIBRARY_PATH
or
$ export LD_LIBRARY_PATH=$PWD:$LD_LIBRARY_PATH
or, if you have
administrative privileges on your machine:
% cp libSolarisSerialParallel.so
/usr/lib
- If you are using JDK (not JRE) Add comm.jar
to your classpath.
Example: If you don't have a CLASSPATH set
currently,
% setenv CLASSPATH `pwd`/comm.jar
or if you have something in your CLASSPATH
already,
% setenv CLASSPATH
`pwd`/comm.jar:$CLASSPATH
- Copy the file javax.comm.properties
into one of the following indicated directories
(If you don't have write permission to <JDK>/lib or
<JRE>/lib, use one of the
directories in the search scheme that you do have access to):
What directories and in which order javax.comm.properties
is searched for:
1. Current directory.
2. Each directory in ${java.classpath} (ie.
$CLASSPATH or -classpath setting).
3.
<java installation dir>/lib.
4.
<java installation dir>/jre/lib
The javax.comm.properties
file must be installed. If it is
not, no ports will be found by the system.
See the portmapping guide for information about configuring
port mapping via the
portmap.conf
file
- You should now be able to run your comm application Example:
% java YourCommAppPkg.YourCommApp
-
Several serial port sample applications are provided with this
release.
One of them is BlackBox.
To run BlackBox, first add BlackBox.jar to your
classpath:
% setenv CLASSPATH BlackBox.jar:$CLASSPATH
then run BlackBox:
% java BlackBox
- One sample driver NullDriver is included in the samples/NullDriver
directory
Running with the JRE (Java Runtime Environment):
Use the -cp option to the JRE to specify
the path to the comm.jar file
and to your application.
% jre -cp
/home/extra/comm.jar:/home/bin/BlackBox.jar
BlackBox
The javax.comm.properties
file must be in the same location
as the comm.jar file or no ports will be found.
API Documentation
The javadocs directory contains the API
documentation generated by javadoc(1)
from comments
in the source code. To view the HTML files, point your browser at the
main documentation page,
javadocs/index.html.
Notes/Known Limitations
-
In the current implementation we do not support the notify methods
listed
below:
-
SerialPort.notifyOnRingIndicator
-
SerialPort.notifyOnOutputEmpty
-
The get...() methods can only return what the Solaris driver believes
the
state to be.
and the following signals are not determined properly as per the
following
notes
-
getRI - Not supported under Solaris
- getDSR - Not supported on SBUS (SPARC) systems because
they use the
zsdriver,
and the zsdriver does not return the state of this pin.
-
In the current implementation we do not support port ownership
contention
resolution across
multiple Java(tm) Virtual Machines. It also does not support uucp style
ownership contention
resolution.
- Both parity errors and framing errors are reported as parity
errors.
- Support for parallel port is very limited.
- On Solaris platforms the handshake
mode needs to be specified for both the
input
and output mode on both the sending and receiving side for it to work
properly.
Copyright (C) 1998 Sun
Microsystems, Inc.
All Rights Reserved.