1
This is README.SCO Last Modified Thu Oct 18 13:58:28 MDT 2001
2
UnixWare and OpenUNIX related Documentation
4
This document is the release notes From Caldera before the merge see notes.
6
Java Communications API Implementation for Caldera UNIX Operating Systems
10
-------------------------------------------------------------------------------
14
This was Version 2.0 Beta-3 notes. The work is being merged into the rxtx CVS.
15
Some minor changes will happen and will be noted here.
17
Thanks to Jonathan Schilling <jls@caldera.com> and Caldera for the SCO port!
19
1) RXTX does not ship with Sun's comm.jar. It can be obtained from Sun.
20
2) The Lockfile could use some work. It possible to fix it at compile time
21
but a run time solution would allow. The current behavior is to use FHS
22
locks. This should be the same behavior as rxtx-1.4-8 as used in the
24
3) in configure.in you will want to comment out 2 lines and run autoconf in
25
the top rxtx directory before building. The lines are:
27
# Comment these two lines out when compiling on SCO
32
-------------------------------------------------------------------------------
34
These are the Release Notes for the beta release of an implementation of
35
the Java Communications API (also known as javax.comm) for Caldera UNIX
38
The Java Communications API is described at
39
http://java.sun.com/products/javacomm/index.html.
41
This implementation is available for the following Caldera UNIX operating
46
OpenServer 5.0.6 with rs506a supplement
48
A prerequisite is that Java 2 Standard Edition v. 1.3.0 for Caldera UNIX
49
Operating Systems must already have been installed (including any
50
packages or ptfs required by J2SE 1.3.0). This requirement may be met
51
by either the J2SE SDK (package java2sdk3) or the J2SE Runtime Environment
54
While J2SE 1.3.0 for OpenServer does not require the rs506a release
55
supplement be installed, this javax.comm implementation does.
57
This implementation is a port of the open source RXTX implementation of
58
the Java Communications API. Information about RXTX may be found at
59
http://www.rxtx.org. This port has been done off of RXTX version 1.4-8.
61
RXTX includes part of the Sun Java Communications API implementation
62
for Solaris/x86, version 2.0. This part (the comm.jar file) is included
63
in this distribution; you do not need to download it from the Sun web page.
65
To install this beta implementation, place the javaxcomm.ds file somewhere.
66
Go there, become root, and then do:
68
# pkgadd -d 'pwd`/javaxcomm.ds
70
This will install package javaxcomm, which places the following files into
71
the J2SE 1.3.0 directory structure:
73
/usr/java2/jre/lib/ext/comm.jar
74
/usr/java2/jre/lib/ext/jcl.jar
75
/usr/java2/jre/lib/x86at/libSerial.so
76
/usr/java2/jre/lib/x86at/libParallel.so
77
/usr/java2/jre/lib/javax.comm.properties
78
/usr/java2/javax.comm-ReleaseNotes.txt [this file]
80
Alternatively, if you are installing the Java Communications API in
81
conjunction with the J2SE Runtime Environment rather than the J2SE SDK,
82
then use the jrexcomm.ds file instead:
84
# pkgadd -d 'pwd`/jrexcomm.ds
86
which will install the following files as part of package jrexcomm:
88
/usr/jre2/lib/ext/comm.jar
89
/usr/jre2/lib/ext/jcl.jar
90
/usr/jre2/lib/x86at/libSerial.so
91
/usr/jre2/lib/x86at/libParallel.so
92
/usr/jre2/lib/javax.comm.properties
93
/usr/jre2/javax.comm-ReleaseNotes.txt [this file]
95
You can install both the javaxcomm and jrexcomm packages if you desire,
96
as long as you have both java2sdk3 and java2jre3 installed.
98
The installed binaries of either Java Communications API package are used
99
for all three Caldera UNIX platforms. (On OpenServer, the native code
100
libraries are executed via the OSRcompat binary compatibility module,
101
just as the native code layers of J2SE 1.3.0 are.)
103
To use this implementation of Java Communications API, just compile and
104
run Java as you normally would. Because the above files are installed
105
into the standard J2SE 1.3.0 extension space, there is no need to set
106
CLASSPATH or LD_LIBRARY_PATH to access the Java Communications API.
108
A simple test of the serial I/O part of this implementation can be
109
done as follows. Set up a null modem RS-232 cable between two machines.
110
Become root. Run the open source "minicom" tool
111
(see http://www.pp.clinet.fi/~walker/minicom.html) on each machine
112
and verify that the connection is working, by typing characters back
113
and forth between the two machines. Caldera can make available
114
minicom-ou8-uw7 and minicom-osr5, ported versions of minicom for
115
the Caldera UNIX platforms. (Note that you need to first do
116
"minicom -s" to tell it about the names and speeds of your serial ports.
117
When you then run "minicom", use the ctrl-A E and ctrl-A A commands to
118
turn on local echo and linefeed add.)
120
Once working serial communication has been verified, shut down minicom
121
on the machine that Java Communications API is installed on. Untar the
122
Sun SerialDemo demo program, which is SerialDemo.tar and can be made
123
available by Caldera. Change into the SerialDemo directory, and run
125
# /usr/java2/bin/java SerialDemo
127
# /usr/jre2/bin/java SerialDemo
129
This should bring up a GUI. Change the serial device port name and speed
130
in the GUI if necessary, then click "Open Port". (Contact Caldera if the
131
port name you are interested in does not appear in the GUI.) Type into the
132
top pane and text should appear in the minicom window on the other machine.
133
Type into the minicom window on the other machine and text should appear
134
in the middle pane of the SerialDemo GUI. Click "Close Port" to finish.
136
This implementation uses the normal UNIX "lock file" protocol to protect
137
serial ports from concurrent access. This means that javax.comm will
138
not be able to access the port if it is already locked by another
139
serial application (whether javax.comm, non-Java, or a system command),
140
and vice versa. In the case where javax.comm is locked out, you may get
141
a message containing the phrase "Port currently owned by unknown Solaris
142
Application"; for "Solaris" read the Caldera UNIX operating system you
145
Additional sample programs using the Java Communications API are available
146
as part of the Sun Solaris/x86 implementation and can be downloaded from
147
http://java.sun.com/products/javacomm/index.html. (Do not use the
148
SimpleRead and SimpleWrite programs without modification, since they fail
149
to properly close the serial port at program completion.)
153
The lock files in Open UNIX 8 and UnixWare 7 will protect against
154
concurrent port access by multiple javax.comm applications, but will not
155
protect against concurrent access by other applications or system commands
156
that use the SVR4 serial lock file protocol (/var/spool/locks/LK.m.m.m).
157
This will be corrected in the final release. On OpenServer, the lock files
158
protect against all concurrent access, assuming other applications are
159
using the standard protocol there (/usr/spool/uucp/LCK..tty?A).
161
The parallel I/O part of this implementation has not been tested at all
162
on any Caldera UNIX platforms.
164
RXTX is available under the GNU Library General Public License (LGPL).
165
Because this is still just an beta level implementation, the ported
166
source code for RXTX is not included with this distribution. Once this
167
implementation is final, source code will be included. If you would
168
like the source code for this beta implementation, please contact
169
Caldera and it will be sent to you.