Installation Guide

Linux

1. Download and install the Java Development Kit 5.0 from SUN appropriate for your platform. For state-of-the-art distributions for this JDK an automated installation process may be provided.

2. Download the Java Comm API 2.0 for the SPARC platform (javacomm20-sparc.tar.Z) from here. Extract the comm.jar file and place it in the $JAVA_HOME/jre/lib/ext directory. Again: Use the comm.jar from the SPARC version.

3. Create two files:
   javax.comm.properties in $JAVA_HOME/jre/lib
   containing the line
   Driver=gnu.io.RXTXCommDriver
   and
   javax.comm.rxtx.properties in $JAVA_HOME/jre/lib/ext
   with the content:
   javax.comm.rxtx.SerialPorts=/dev/ttyS0:/dev/ttyS1:/dev/ttyUSB0:/dev/ttyUSB1
   or something similar consistent with your hardware.
   

4. Download the rxtx package from here. Do not use version 2.1, it won't work. Unpack the package and install it as usual with ./configure; make; make install. The configure script should run smoothly and has to print these lines:
   [...]
   comm.jar appears to be installed already.
   [...]
   javax.comm.properties appears to be installed
   [...]
   Otherwise there is something wrong with your Java installation.

5. Download JDiveLog from sourceforge.net and install it with the command "java -jar jdivelog-installer-2.0.jar".

6. Be Happy ;-)

Windows

1. Download and install the Java Runtime Environment 5.0 (JRE) from SUN for Windows.

2. Download the Java Comm API 2.0 for the WINDOWS platform (javacomm20-win32.zip) from here.

3. Extract the comm.jar file of javacomm20-win32.zip to the lib\ext directory of the previously installed JRE

4. Extract the javax.comm.properties file of javacomm20-win32.zip to the lib directory of the previously installed JRE

5. Extract the win32com.dll file of javacomm20-win32.zip to the bin directory of the previously installed JRE

6. Download JDiveLog (the jdivelog-installer-X.X.jar!) from sourceforge.net and doubleclick on the downloaded file. If no installer appears try the command "java -jar jdivelog-installer-2.0.jar".

7. Be Happy ;-)

Mac OS X (Thanks go to Marting Polak for the OS X Package and Instructions)

1. Download the OSX-version of JDiveLog from Sourceforge. (jdivelog-macosx-<version>.zip)
2. Unpack it and drag the application to your /Applications folder
3. In order to being able to communicate with your dive-computer you also have to install a serial driver library, so download the OSX-version of the rxtx serial driver library as found on http://users.frii.com/jarvi/rxtx/download.html. you have two options for this:
   1. Automatic Install:
      • Download the source-package (tested with http://rxtx.qbang.org/pub/rxtx/rxtx-2.1-7-r2.zip) and unpack the archive (e.g. to your desktop or home directory).
      • Go to the (MACOSX_IDE/ForPackageMaker folder), try to install RXTX binaries using the Installer by double clicking on MACOSX_IDE/ForPackageMaker/RXTX_Tiger.pkg
      • check existence of the folder "/var/spool/uucp", if you don't have it create it with command

        sudo mkdir /var/spool/uucp

        Permissions should be: drwxrwxr-x, if they are not do command

        sudo chmod 775 /var/spool/uucp

      • YOU (and everyone using the serialport/lib should be a member of the uucp group, you can check it with command

        niutil -readprop / /groups/uucp users

        You should see your name in output of the niutil command. If you don't see it, do following:

        sudo niutil -appendprop / /groups/uucp users <yourname>

        Substitute <yourname> with your user's name
      NOTES: RXTX.pkg should create uucp folder and insert your name in uucp group automatically but you might want to repeat those steps for other users. If everything went without errors, you should be done now. Remember that changing group memberships of users might need a reboot, so please consider doing so.
   2. ALTERNATIVELY (experienced user)
      you can also install the lib manually by, downloading the binary package (http://rxtx.qbang.org/pub/rxtx/rxtx-2.1-7-bins-r2.zip) and copy the files manually:

      • cd <where you unpacked it>/rxtx-2.1-7-bins-r2/
        sudo cp RXTXcomm.jar /Library/Java/Extensions
        sudo cp Mac_OS_X/librxtxSerial.jnilib /Library/Java/Extensions
        

      • In order to being actually able to access the serial port as a normal user, you have to be a member of the uucp-Group (otherwise you'll get an Error: "Port already in use"), which can be accomplished by running

        fixperm.sh

        Which can be found in the /contrib folder of the rxtx SOURCE package subdirectory.
4. Reboot or at least log-off and log-on again (for the group membership to become effictive)
5. Run JDiveLog and Be Happy ;-)
6. If your (USB)-serialport does not appear on the list of available ports in the preferences tab of JDiveLog, make sure that you have a driver from your cable vendor installed on your system.