Java(tm) Communications API Solaris Installation Instructions

Version 3.0

License


  1. Ensure that the library libSolarisSerialParallel.so can be loaded.   You can do this
  2. 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
     
     

  3. If you are using JDK (not JRE) Add comm.jar to your classpath.

  4.  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

     

  5. 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



  6. You should now be able to run your comm application Example:

      % java YourCommAppPkg.YourCommApp


  7. 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



  8. 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
  1. In the current implementation we do not support the notify methods listed below:

  2.  
  3. The get...() methods can only return what the Solaris driver believes the state to be.
  4. and the following signals are not determined properly as per the following notes
     
  5. In the current implementation we do not support port ownership contention resolution across
  6. multiple Java(tm) Virtual Machines. It also does not support uucp style ownership contention
    resolution.
     
  7. Both parity errors and framing errors are reported as parity errors.
  8.  
  9. Support for parallel port is very limited.
  10.   
  11. 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.